常见问题及解决方案

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

安装

• 从 My Esri 接收到的 Docker 容器映像加载失败，并提示设备上剩余空间不足。

访问 notebook

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

Notebooks

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

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

• 我的 ArcGIS Enterprise 10.7 门户处于离线环境中，且我的 notebook 无法绘制地图。

安装

从 My Esri 接收到的 Docker 容器映像加载失败，并提示设备上剩余空间不足。

Docker 使用 /var 驱动器加载容器映像。 安装 ArcGIS Notebook Server 或移动 Docker 本地注册表时，请确保 /var 驱动器至少有 50 GB 的空间。

访问 notebook

当我尝试打开 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 目录 登录至 ArcGIS Portal Directory。 URL 格式为 https://portal.domain.com:7443/arcgis/portaladmin。
2. 单击系统 > 属性 > 更新属性。
3. 在更新系统属性对话框中，插入包含门户完全限定域名的 JSON 字符串，其格式如下所示：
   {
   "privatePortalUrl": "https://portal.domain.com:7443/arcgis"

我的 ArcGIS Enterprise 10.7 门户处于离线环境中，且我的 notebook 无法绘制地图。

旧版本：

此问题及解决方案仅适用于 10.7；其根本问题已在 10.7.1 中得到解决。

ArcGIS Notebook 每次绘制地图时，将从内容传送网络 (CDN) 请求 ArcGIS API for JavaScript 4.10。 对于断开连接的环境，可以使用 URL 格式 https://portal.domain.com/portal/jsapi/jsapi4 从门户访问此 CDN。 在门户使用集成的 Windows 身份验证 (IWA) 的断开连接的环境中，一个已知问题是 IWA 会阻止此访问。 因此，无法在 notebook 中绘制地图。

要解决此问题，可以使用 privatePortalURL 值指定 CDN 路径，如以下步骤中所示：

1. 如果您不知道门户的 privatePortalURL，请以门户组织中默认管理员角色成员的身份登录到 ArcGIS Portal Directory。 URL 地址格式为 https://portal.domain.com:7443/arcgis/portaladmin。 单击系统 > 属性。 找到并记录 privatePortalURL 值。
2. 指导 notebook 创作者在其各个 notebook 中运行以下单元格：
   from arcgis.widgets import MapView
   MapView.set_js_cdn("https://<privatePortalURL>:7443/arcgis/jsapi/jsapi4")

设置此 CDN 路径后，创作者的 notebook 在绘制地图时将使用 privatePortalURL 来访问 ArcGIS API for JavaScript。