升级 Windows Server 2019（Linux 容器）上的 ArcGIS Notebook Server

升级 ArcGIS Notebook Server 可为组织提供软件的最新功能和改进功能，同时保留您的用户的现有 notebook。 如果您要将 ArcGIS Enterprise 部署升级至 11.3，您必须同时升级 ArcGIS Notebook Server。

ArcGIS Notebook Server 11.3 安装程序包可检测计算机上是否已安装 ArcGIS Notebook Server 的先前版本。 如果存在，可将该软件升级为 11.3。

如果您已从 10.8.1 或更低版本进行升级，则必须在升级过程中对 11.3 版本的 ArcGIS Notebook Server 软件进行重新授权。

您必须从 Esri 安装新的容器镜像，从而为您的用户提供 11.3 notebook 运行时。 上一版本的 notebook 运行时将保留在站点中，用户仍可以使用这些运行时运行 notebook。 但是，如果您的用户想要使用 11.3 中的新功能，他们必须更新其 notebook 运行时。 对应于 11.3 的笔记本运行时处于 10.0 版本（ArcGIS Notebook Server Standard 10.0 和 ArcGIS Notebook Server Advanced 10.0 选项）。

注：

如果任何 notebook 正在使用自定义运行时，则必须在 Windows Notebook Server 上重新构建和重新注册自定义运行时，并更新相关 notebook 项目的运行时设置。

注：

Notebook 运行时将在 ArcGIS Enterprise 生命周期后停用。 Notebook 运行时将与关联的 ArcGIS Enterprise 版本同时停用。 Notebook 不应使用已停用运行时，并且应更新为受支持的运行时。

升级 ArcGIS Enterprise 门户还将升级站点库中提供的示例 notebook。

10.7.1 及更高版本支持多机 ArcGIS Notebook Server 站点。 如果您具有单机站点并希望在升级后将 ArcGIS Notebook Server 站点扩展为多机站点，则在升级到 11.3 后，请按照步骤将附加计算机加入站点。

ArcGIS Notebook Server 的升级过程为就地升级，无需卸载并重新安装软件。 站点将在升级过程中关闭，在升级完成之前，用户无法进行访问或运行 notebook。

按照以下步骤将 ArcGIS Notebook Server 升级到 11.3。

准备升级

升级之前，请查看以下信息。

• 可以在升级之前访问 My Esri 中的所有必需文件，包括 11.3 容器镜像。
• 要使 ArcGIS Notebook Server 正常运行，其版本必须和与之联合门户的版本一致。
• 如果您的 Notebook Server 当前处于只读模式，请在开始升级过程前关闭此模式。
• 将 Docker Desktop for Windows 升级至 4.24.2 版本
• 要升级 ArcGIS Enterprise 部署，请执行以下操作：
  1. 升级 Portal for ArcGIS。
  2. 升级 ArcGIS Web Adaptor（针对门户）。
  3. 升级作为门户托管服务器的 ArcGIS Server 站点。
  4. 升级 ArcGIS Web Adaptor（针对服务器）。
  5. 升级 ArcGIS Data Store（先升级主要存储，再升级备用存储）
  6. 升级任何其他服务器，包括 ArcGIS Notebook Server。
  7. 安装 ArcGIS Notebook Server 示例数据
• 不要卸载现有 ArcGIS Notebook Server。 ArcGIS Notebook Server 安装程序和命令行安装程序可用于检测和升级 ArcGIS Notebook Server 组件的现有安装。
• 在升级过程中的任何时间点，请勿从门户取消联合 ArcGIS Notebook Server 站点，或取消将其指定为门户的 Notebook Server。 将严重影响门户托管的现有 notebook。
• 可以使用安装程序或命令行安装程序升级 ArcGIS Notebook Server。 选择其中一种方法进行升级。
• 在升级之前，清除在 ArcGIS Notebook Server 计算机上使用的所有 Web 浏览器的缓存。
• 升级时，ArcGIS Notebook Server 站点的 Windows 服务账户（其运行方式账户）必须保持不变。

备份部署

在升级之前，建议对部署进行备份。

Notebook 将包括在使用 webgisdr 实用程序的门户备份中。

您可以在 ArcGIS Notebook Server Administrator Directory 中使用 exportSite 操作来备份站点的配置存储，具体按如下所述。 除了站点配置备份之外，考虑手动创建文件系统的备份。

要运行备份操作，请完成以下步骤：

1. 打开 ArcGIS Notebook Server Administrator Directory，然后以具有管理权限的用户身份登录。

   URL 通常是 https://notebookserver.domain.com:11443/arcgis/admin。

2. 浏览至站点 > 导出站点。
3. 提供要将文件导出到的计算机上目标位置的完整路径。

   该站点必须具有访问此目录的权限。

4. 单击导出。

   导出操作完成后，该目录将提供指向服务器上备份文件位置的链接。

5. 尽快下载该文件（文件扩展名为 .agssite）。

使用安装程序升级

注：

使用安装程序文件将 ArcGIS Notebook Server 升级至 11.3。 升级安装程序后，必须使用配置向导或升级站点实用程序来升级 ArcGIS Notebook Server 站点。

如果您拥有多机站点，请针对一台计算机执行步骤 1 到 3，然后针对站点中的每台计算机重复这些步骤。

ArcGIS Notebook Server 可用于检测和升级 ArcGIS Notebook Server 组件的现有安装。

要使用安装程序进行升级，请完成以下步骤：

1. 请运行 ./Setup 提取位置中的 ArcGIS Notebook Server，然后按照提示完成升级。

   必须以安装了现有 ArcGIS Notebook Server 的用户账户运行安装程序。 在安装过程中，安装程序将识别现有安装，并提示您确认升级。 输入选项 y 以继续安装。

   这将卸载先前版本的 ArcGIS Notebook Server 并安装 ArcGIS Notebook Server 的升级版本。

2. 实用程序升级完成后，对 11.3 的 ArcGIS Notebook Server 软件进行重新授权。 请使用软件授权向导完成授权。
3. 可以使用升级安装结束时列出的 URL 打开配置向导，然后按照屏幕上的说明来升级站点。
4. 对于多机站点，请针对站点中的每台计算机执行步骤 1 到 3。

通过命令行升级

要通过命令行升级，请完成以下步骤：

1. 使用下例中所示的参数运行 ArcGIS Notebook Server 安装命令。 确保使用与现有安装已使用的相同 ArcGIS Notebook Server 账户。

   这将卸载先前版本的 ArcGIS Notebook Server 并安装 ArcGIS Notebook Server 的升级版本。

   setup.exe /qn USER_NAME=<ArcGIS Notebook Server account username> PASSWORD=<password> ACCEPTEULA=yes

2. 可以使用 upgradesite 实用程序，并通过运行以下命令完成升级。 默认情况下，upgradesite 实用程序可在 C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat 位置找到。

   upgradesite.bat -s

   实用程序将显示进程报告并在完成升级时停止。 此实用程序具有两个参数：

   • -s - 当包含于命令行中时，将提示实用程序运行升级。 如果不使用 -s，则升级不会运行。 这可以作为安全保证以确保在您准备就绪时运行升级。
   • -h - 显示工具的帮助。 如果命令在不使用 -s 的情况下运行，则同样也会显示帮助。

3. 对于多机站点，请针对站点中的每台计算机重复步骤 1 和 2，然后继续执行下一部分中的步骤。

静默授权

实用程序升级完成后，您必须对 11.3 版本的 ArcGIS Notebook Server 软件进行重新授权。

可以使用以下语法运行 SoftwareAuthorization.exe 以静默授权 ArcGIS Notebook Server。 在运行文件之前，您必须在授权或配置文件中完整填写所有用户信息。

如果您拥有授权文件且计算机已连接至 Internet，请运行以下内容：

<System disk drive>\Program Files\ArcGIS\NotebookServer\framework\bin /S /Ver <version number> /LIF <full path and name of authorization file>

在离线环境中授权

您可以在离线环境中使用配置 (.prvc) 文件对 ArcGIS Notebook Server 进行授权。 在此过程中将生成文件，供您发送至 Esri 以完成过程。

1. ArcGIS Notebook Server 升级完成后，在提示符处运行以下提供的命令：

   <ArcGIS Notebook Server install directory>\tools\SoftwareAuthorization\SoftwareAuthorization.exe /F <full path to the .prvc file> /O <full path to authorization file output>

2. 创建输出信息文件后，请执行以下其中一项操作：
   • 浏览至 Esri 自助服务站点。 按照屏幕中的指示上传您的授权信息文件并下载您的 .ecp 授权文件。
   • 以电子邮件形式将您的授权信息发送到 [e-mail]。Esri 将以电子邮件形式返回您的 .ecp 授权文件。
3. 通过以上任何一种方式获得 .ecp 授权文件后，请再次运行 authorizeSoftware 脚本以对其进行处理，然后完成服务器授权过程：

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /F <full path to the .ecp file>

对每台运行 ArcGIS Notebook Server 的计算机重复此工作流。

升级后的步骤

在使用已升级并重新授权的 ArcGIS Notebook Server 站点之前，您必须运行安装后配置实用程序，以将新 Docker 容器镜像添加到站点。 您还必须替换注册到站点的 ArcGIS Web Adaptor 实例以匹配新版本。

运行安装后实用程序

要运行安装后实用程序，请完成以下步骤：

1. 以管理员身份打开命令提示符窗口。
2. 将目录更改为 ArcGIS Notebook Server 工具文件夹。 默认情况下，此路径为 C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility。
3. 或者，通过运行以下命令参阅实用程序的帮助：PostInstallUtility.bat -h
4. ArcGIS Notebook Server 需要您的计算机上已安装 Docker 引擎社区版。 要确定 Docker 在您的计算机上是否处于活动状态，请运行以下命令：PostInstallUtility.bat -d
5. 如果尚未安装 Docker Desktop，请立即安装。

   ArcGIS Notebook Server 使用 Docker Desktop 中的 Linux 容器。 当您安装 Docker Desktop 时，请确保指定 Linux 容器，不要单击切换至 Windows 容器选项。

6. 使用 Docker Desktop 时，请修改以下各项设置：
   1. 右键单击系统托盘中的 Docker 按钮并选择设置。 在常规下，选中在不使用 TLS 的 tcp://localhost:2375 上显示后台程序。

      您将使用 Docker 远程 API，此操作需要使用端口 2375。

   2. 右键单击系统托盘中的 Docker 按钮并选择设置。 在设置菜单中，单击资源 > 文件共享 并添加将用于 ArcGIS Notebook Server 配置存储的驱动器目录。

      注：

      用于 Windows 的 Docker 仅支持 Windows 上的本地目录，这些目录将与 Linux 容器共享。

7. 通过指定文件路径安装您的 Notebooks 镜像。 镜像应压缩为 .tar.gz 格式。 如果您拥有 Advanced 许可和 Docker Desktop，将此命令运行两次以同时安装您从 My Esri 下载的“标准”和“高级”容器镜像。

   注：

   确保您的计算机至少有 75 GB 的可用磁盘空间。

   运行以下命令：PostInstallUtility.bat -l <path of .tar.gz Docker image>

   注：

   确保您安装了两个容器镜像。 尽管您拥有 Advance 许可，您的用户可能仍需使用标准运行时。

注：

不会自动移除旧镜像。 您必须在删除先前的运行环境镜像前，将每个 notebook 的运行环境手动更新至新版本。

安装和配置 ArcGIS Notebook Server 示例数据

设置多机 ArcGIS Notebook Server 站点时，您必须仅在安装 Notebook Server 并创建站点的第一台计算机上安装并配置示例数据。

要安装和配置示例数据，请完成以下步骤：

1. 运行从 My Esri 下载的 ArcGIS Notebook Server 示例数据安装向导。

   示例数据将安装到 ArcGIS Notebook Server 的安装目录中。

2. 以管理员身份打开命令提示符窗口。
3. 将目录更改为 ArcGIS Notebook Server 工具文件夹。

   默认情况下，路径为 C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility。

4. 或者，通过运行以下命令参阅实用程序的帮助：

    > PostInstallUtility.bat -h

5. 运行安装后配置实用程序以将示例数据提取至 Notebook Server 站点的 arcgisworkspace 目录：

    PostInstallUtility.bat -x

替换 ArcGIS Web Adaptor 实例

要替换 ArcGIS Web Adaptor 实例，请完成以下步骤：

1. 从站点取消注册之前的 ArcGIS Web Adaptor 实例并卸载。
   1. 登录到 ArcGIS Notebook Server Administrator Directory。
   2. 浏览至系统 > Web Adaptor > 已注册计算机。
   3. 单击取消注册 Web Adaptor。
2. 安装 ArcGIS Web Adaptor 11.3 的新实例并使用 ArcGIS Notebook Server 对其进行配置。
部署升级完成后，您可以利用 11.3 功能。
3. 如果从 10.8 或更低版本进行升级，则要在门户中启用 notebook 计划，请执行以下操作：
   1. （可选）更新所有包括 notebook 权限的自定义角色以添加新的计划 notebook 权限。
   2. 如果 notebook 创作者想要使用计划功能，请指示其更新每个 notebook 运行时。

      只能计划使用 10.8.1 运行时（版本 4.0）或更高版本的 notebook。

ArcGIS Notebook Server 11.3 站点现已能够托管 ArcGIS Notebooks。