ArcGIS Notebook Server 包含诊断工具,可用于确认您的计算机是否符合最低系统要求,并确认该软件是否按预期正常运行。 如果在运行诊断工具时遇到任何问题,该工具将列出问题的可能原因和解决办法。
当您开始安装软件时,该工具会自动运行以确认您的机器是否符合最低的系统要求。 在继续安装前,首先解决诊断工具所列出的所有问题。 如果安装后遇到问题,可运行该工具以帮助您识别和诊断问题。
运行此工具
您可以从托管 ArcGIS Notebook Server 的计算机的命令行运行诊断工具。
- 以 ArcGIS Notebook Server 安装目录所有者身份打开终端。
注:
要运行该工具,安装程序所有者对托管 ArcGIS Notebook Server 的计算机的 /tmp 目录至少要有读写权限。
- 浏览到位于 <ArcGIS Notebook Server installation directory>/arcgis/notebookserver/tools/ 的目录。
- 运行 notebookserverdiag。
解释诊断结果
在运行该工具后,将会生成一份包含所执行的所有服务器诊断检查摘要的报告。 同时指示检查是否显示警告以及检查是通过、未通过还是不适用于系统。
每次检查通过代码格式化的 DIAG<number> 后接所执行检查的状态进行标识。 有关每次诊断检查的说明,请参阅下表。 您可以使用此信息分析托管 ArcGIS Notebook Server 的计算机的当前状态。
检查编号 | 检查标题 | 描述 |
---|---|---|
DIAG000 | 检查以根用户身份进行的安装 | 以根用户身份运行 ArcGIS Notebook Server 存在安全风险,且不受支持。 如果检测到将 ArcGIS Notebook Server 作为根进行安装,则此检查将返回一个错误。 |
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 用于存储容器镜像的默认目录,请参阅安装指南中的此工作流。 |