常见问题及解决方案

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

安装

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

访问笔记本

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

Notebooks

• 在通过 Windows 容器使用 ArcGIS Notebook Server 的情况下，当我在笔记本编辑器中运行的两个或更多笔记本导入 torch 库或使用 Torch 作为依赖项的 Python 库时，除了运行的第一个笔记本之外的导入语句均运行失败并提示 [WinError 1455] The paging file is too small for this operation to complete. Error loading "C:\ArcGIS_Server\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3\lib\site-packages\torch\lib\caffe2_detectron_ops_gpu.dll" or one of its dependencies。
• 在通过 Windows 容器使用 ArcGIS Notebook Server 的情况下，当我运行导入 mljar-supervised 库的笔记本时，导入语句花费很长时间运行或导致 Kernel died 错误。
• 当我运行的笔记本单元格包含使用 ArcGIS Enterprise 门户项目的 Python 代码时，请求超时。 当我运行包含远程 URL 的单元格时可能出现此错误。

• 当我运行默认的首个笔记本单元格（包括字符串 gis = GIS("home")）时，收到 URL 错误消息，提示暂时无法进行名称解析。
• 当我运行默认的首个笔记本单元格（包括字符串 gis = GIS("home")）时，我收到了一条错误消息，指明：ConnectionError: A connection error has occurred: HTTPSConnectionPool(host=,port=443): Max retires exceeded with url: /portal/sharing/rest/info=fjson (caused by NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))

安装

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

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

访问笔记本

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

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

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

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

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

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

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

• 为 ArcGIS Notebook Server 安装 Docker
• 安装后配置 ArcGIS Notebook Server

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

docker version
docker run hello-world

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

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

Notebooks

在通过 Windows 容器使用 ArcGIS Notebook Server 的情况下，当我在笔记本编辑器中运行的两个或更多笔记本导入 torch 库或使用 Torch 作为依赖项的 Python 库时，除了运行的第一个笔记本之外的导入语句均运行失败并提示 [WinError 1455] The paging file is too small for this operation to complete. Error loading "C:\ArcGIS_Server\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3\lib\site-packages\torch\lib\caffe2_detectron_ops_gpu.dll" or one of its dependencies。

此行为由 Notebook Server 计算机上为虚拟内存配置的默认最大分页文件大小导致。 请按照以下步骤增加默认分页文件大小，以及分配给笔记本的最大 CPU 和内存。

注：

执行这些更改之前，请向您的系统管理员咨询以了解适用的分页文件大小。

1. 在每台 ArcGIS Notebook Server 计算机上单击开始 > 设置 > 系统 > 关于 > 高级系统设置。
2. 在“系统属性”对话框的高级选项卡中，单击“性能”部分中的设置。
3. 在“性能选项”对话框中，单击高级选项卡。
4. 单击“虚拟内存”部分中的更改。
5. 在“虚拟内存”对话框中，取消选中自动管理所有驱动器的分页文件大小。
6. 选择自定义大小。
7. 输入您的 Initial size (MB) 和 Maximum size (MB)。
8. 单击确定并重新启动计算机。

计算机重新启动后，在 ArcGIS Notebook Server Manager 中按照以下步骤操作。

1. 单击设置 > 运行时。
2. 选择运行导入 torch 的笔记本时要使用的运行时，然后单击编辑。
3. 将最大 CPU 更新为 4 核，将最大内存更新为 12 GB。
4. 单击保存以确认更新。
5. 退出 ArcGIS Notebook Server Manager。

在通过 Windows 容器使用 ArcGIS Notebook Server 的情况下，当我运行导入 mljar-supervised 库的笔记本时，导入语句花费很长时间运行或导致 Kernel died 错误。

此行为的原因是 mljar-supervised 库具有许多依赖项。 在 ArcGIS Notebook Server Manager 中按照以下步骤操作以增加分配给笔记本的最大 CPU。

1. 单击设置 > 运行时。
2. 选择运行导入 mljar-supervised 的笔记本时要使用的运行时，然后单击编辑。
3. 将最大 CPU 更新为 4 核。
4. 单击保存以确认更新。
5. 退出 ArcGIS Notebook Server Manager。

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

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

当我运行默认的首个笔记本单元格（包括字符串 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" }

当我运行默认的首个笔记本单元格（包括字符串 gis = GIS("home")）时，我收到了一条错误消息，指明：ConnectionError: A connection error has occurred: HTTPSConnectionPool(host=,port=443): Max retires exceeded with url: /portal/sharing/rest/info=fjson (caused by NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))

部署 Docker 容器时，将从主机的 resolv.conf 文件复制名称服务器。 这可能导致将公共 DNS 服务器用于计算机的安装程序上出现错误，因为 Docker 容器需要能够解析内部 DNS 名称。

要解决此问题，需要在 ArcGIS Notebook Server 系统属性中配置 dockerExtraHosts：

1. 打开 ArcGIS Notebook Server Administrator Directory 的 URL。
2. 单击系统 > 属性 > 更新属性
3. 在“更新系统属性”对话框中，插入采用以下格式的主机名和 IP 地址 JSON 字符串：
   { "dockerExtraHosts": [ { "hostname" : "<host name>", "ip" : "12.34.56.78" } ] }