Skip To Content

检查 ArcGIS Notebook Server 诊断

ArcGIS Notebook Server 包含诊断工具,可用于确认您的计算机是否符合最低系统要求,并确认该软件是否按预期正常运行。如果在运行诊断工具时遇到任何问题,该工具将列出问题的可能原因和解决办法。

当您开始安装软件时,该工具会自动运行以确认您的机器是否符合最低的系统要求。在继续安装前,首先解决诊断工具所列出的所有问题。如果安装后遇到问题,可运行该工具以帮助您识别和诊断问题。

运行此工具

您可以从托管 ArcGIS Notebook Server 的计算机的命令行运行诊断工具。

  1. ArcGIS Notebook Server 安装目录所有者身份打开终端。
    注:

    为了执行该工具,安装程序所有者对托管 ArcGIS Notebook Server 的计算机的 /tmp 目录至少要有读写权限。

  2. 浏览到位于 <ArcGIS Notebook Server installation directory>/arcgis/notebookserver/tools/ 的目录。
  3. 执行 notebookserverdiag

解释诊断结果

在运行该工具后,将会生成一份包含所执行的所有服务器诊断检查摘要的报告。此外,该报告还表明检查是否显示警告,或检查是否通过或失败,或检查不适用于系统。

每次检查通过代码格式的 DIAG<number> 后接所执行检查的状态进行确定。有关每次诊断检查的说明,请参阅下表。您可以使用此信息分析托管 ArcGIS Notebook Server 的计算机的当前状态。

检查编号检查标题描述
DIAG000

检查以根用户身份进行的安装

以根用户身份运行 ArcGIS Notebook Server 存在安全风险,且不受支持。如果检测到将 ArcGIS Notebook Server 作为 root 进行安装,则此检查将返回一个错误。

DIAG001

检查 64 位架构

仅 64 位架构支持 ArcGIS Notebook Server。如果计算机为 32 位架构,则此检查将失败。有关受支持的操作系统,请查阅系统要求。

DIAG002

检查操作系统版本

如果操作系统不是受支持的 Linux 发行版或版本,将会显示警告。有关受支持的 Linux 平台和操作系统版本,请查阅系统要求。如果操作系统不是受支持的 Linux 发行版,将不会执行其他检查。

DIAG003

检查主机名的无效字符

ArcGIS Notebook Server 计算机的主机名有效字符包括字母数字 a-z、0-9、减号 (-) 和点 (.) 字符,如 RFC 952 规范中所列。如果主机名包含一个或多个无效的字符,则检查将失败。

DIAG004

检查已安装的软件包

根据所使用的 Linux 发行版,此检查将确定是否已安装为适当支持 ArcGIS Notebook Server 所需的操作系统软件包。如果检查失败,将会返回警告,提示缺少的计算机所需的软件包。有关详细信息,请查阅系统要求。

DIAG005

检查系统限制

为了 ArcGIS Notebook Server 能够正常运行,安装用户需要将最小文件句柄限制设置为 65535,并将最小进程数限制设置为 25059。此检查将确认是否已在 /etc/security/limits.conf 文件中正确设置这些限制。如果限制的设置过低,则此检查失败。要进行验证,请运行:

ulimit -Hn -Hu

ulimit -Sn -Su

DIAG009

检查 HTTPS 端口

默认情况下,ArcGIS Notebook Server 使用端口 11443。此检查将验证 HTTPS 端口 11443 是否正在被其他用户或进程使用。如果此检查返回一则警告,ArcGIS Notebook Server 将无法正常运行。要更正此问题,打开端口 11443,然后重新启动 ArcGIS Notebook Server

DIAG020

检查主机名 IP 地址不匹配

如果在 /etc/hosts 文件中计算机的主机名条目与计算机的 IP 地址不匹配,则此检查将返回一则警告。这将导致 ArcGIS Notebook Server 无法正常运行。要修复此问题,请更正主机名条目,然后重新启动 ArcGIS Notebook Server

DIAG024

检查 /etc/hosts 以查看主机名条目

/etc/hosts 文件中计算机的主机名条目的格式必须为 <IP> <FQDN> <Machine_name>。在创建 ArcGIS Notebook Server 站点前更新主机名条目。

DIAG026

检查 ArcGIS Notebook Server 核心服务的进程

检查将验证是否在启动 ArcGIS Notebook Server 后启动所有核心服务。如果一项或多项核心服务未启动,则此检查将返回一则警告。要修复此问题,可通过运行 startnotebookserver.sh 脚本启动 ArcGIS Notebook Server,或者如果该脚本已在运行,则重新启动 ArcGIS Notebook Server

DIAG028

检查 Docker 安装是否有效

该检查将验证机器上安装的 Docker 版本是否符合 ArcGIS Notebook Server 系统要求。还会验证 ArcGIS Notebook Server 安装用户帐户是否添加到 Docker 组以执行 Docker 命令。如果此检查失败,请确保在配置 ArcGIS Notebook Server 站点之前,在计算机上已安装受支持的 Docker 版本,且 ArcGIS Notebook Server 安装用户帐户已添加到 Docker 组。

DIAG029

(在 10.7.1 版本中引入)

检查 /var 的磁盘空间

此检查将验证计算机上的 /var 目录是否至少具有 50 GB 磁盘空间。Docker 使用 /var 目录作为容器映像的本地注册表。在后续版本的升级过程中,新映像也将复制到 /var 目录。要求至少具有 50 GB 可用磁盘空间可确保这些操作运行流畅。要更改 Docker 用于存储容器映像的默认目录,请参阅安装指南中的此工作流