常见问题及解决方案

以下为您在使用 ArcGIS Notebook Server 时可能遇到的问题以及解决方案。 如果未能在本主题中找到您要查找的问题，也可以访问 Esri 技术支持中心网站以搜索相关文章。

安装

• 加载 Notebook 运行时图像时，尽管安装 ArcGIS Notebook Server 和 Docker 的驱动器上仍有空间，但我仍收到设备上剩余空间不足的错误。

访问 notebook

• 当我尝试打开 notebook 时，收到以下错误消息：连接失败。 无法建立与 Notebook Server 的连接。 Notebook 将继续尝试重新连接。 检查您的网络连接或 Notebook Server 配置。
• 当我尝试打开 notebook 时，收到以下错误消息：无法加载。
• 当我尝试打开 notebook 时，收到以下错误消息：无法打开 notebook。 在 Notebook Server 上无法连接至 Docker 环境。 请确保已满足运行 Docker 的 Notebook Server 先决条件。
• 当我尝试打开 notebook 时，收到错误信息提示容器未运行。

Notebooks

• 当我通过使用 ArcGIS Enterprise 门户项目的 Python 代码运行 notebook 单元格时，请求超时。 当我运行包含远程 URL 的单元格时可能出现此错误。

• 当我运行默认的首个 notebook 单元格（包括字符串 gis = GIS("home")）时，收到 URL 错误消息，提示暂时无法进行名称解析。

安装

加载 Notebook 运行时图像时，尽管安装 ArcGIS Notebook Server 和 Docker 的驱动器上仍有空间，但我仍收到设备上剩余空间不足的错误。

检查高级资源分配的 Docker 桌面设置，并验证是否为磁盘图像位置分配足够的磁盘图像大小。 增加分配的磁盘空间并尝试重新加载 Notebook 运行时图像。

访问 notebook

当我尝试打开 notebook 时，收到以下错误消息：连接失败。 无法建立与 Notebook Server 的连接。 Notebook 将继续尝试重新连接。 检查您的网络连接或 Notebook Server 配置。

如果您的 ArcGIS Web Adaptor 运行于 IIS web 服务器上，当计算机禁用 WebSocket 协议时，将发生此错误。 从 10.8 开始，ArcGIS Web Adaptor 在 IIS web 服务器上自动启用 WebSocket 协议，禁止禁用此协议。

当我尝试打开 notebook 时，收到以下错误消息：无法加载。

您的 web 浏览器不信任通过 ArcGIS Notebook Server 站点的 Web Adaptor 配置的 SSL 证书。 确保您已配置 CA 签名证书且站点已启用 HTTPS。

如果您正在开发环境或过渡环境中使用自签名证书，打开 ArcGIS Notebook Server Administrator Directory 的 URL 并在 web 浏览器中添加例外以信任自签名证书。

当我尝试打开 notebook 时，收到以下错误消息：无法打开 notebook。 在 Notebook Server 上无法连接至 Docker 环境。 请确保已满足运行 Docker 的 Notebook Server 先决条件。

一个或多个允许 Docker 引擎组件与 ArcGIS Notebook Server 配合使用的先决条件设置尚未配置。 有关详细信息，请参阅安装指南中的以下主题：

• 安装用于 ArcGIS Notebook Server 的 Docker
• 安装后配置 ArcGIS Notebook Server

当您验证所有必要设置均配置完成后，在命令提示符中运行以下内容以确认 ArcGIS Notebook Server 计算机上已运行 Docker：

docker version
docker run hello-world

当我尝试打开 notebook 时，收到错误信息提示容器未运行。

如果显示此错误消息，容器已可用但是当前未处于运行或可用状态。 要实现此目的，您必须使用 Administrator Directory 终止容器。 确保终止错误消息中指定的容器。 终止完成后，请 notebook 所有者重新打开该 notebook，从而重新启动容器。

Notebooks

当我通过使用 ArcGIS Enterprise 门户项目的 Python 代码运行 notebook 单元格时，请求超时。 当我运行包含远程 URL 的单元格时可能出现此错误。

您的站点中 Docker 容器使用的网络与您的 ArcGIS Enterprise 发生冲突，阻止了 Python 代码连接到服务器。 请参阅关于配置网络的 Docker 文档。 为 Docker 完成网络配置后，再次运行 notebook。

当我运行默认的首个 notebook 单元格（包括字符串 gis = GIS("home")）时，收到 URL 错误消息，提示暂时无法进行名称解析。

当 ArcGIS Notebook Server 及其 Docker 组件与其他 ArcGIS Enterprise 组件安装在同一台计算机上时，可能发生此错误。 这可能由于存储在 ArcGIS Notebook Server 中的默认 privatePortalUrl 属性是完全限定域名的缩短版本。 尝试连接门户时将导致失败。

解决方案是将 privatePortalUrl 属性修改为 ArcGIS Notebook Server 站点的完全限定域名：

1. 以门户中默认管理员角色成员的身份登录到 ArcGIS Portal Directory。 URL 格式为 https://portal.domain.com:7443/arcgis/portaladmin。
2. 单击系统 > 属性 > 更新属性。
3. 在更新系统属性对话框中，插入包含门户完全限定域名的 JSON 字符串，其格式如下所示：
   {
   "privatePortalUrl": "https://portal.domain.com:7443/arcgis"