升级 ArcGIS Notebook Server（Linux 容器）

升级 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 升级至 23.0 或更高版本。
• 要升级 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 浏览器的缓存。

移动工作空间目录

对于工作空间目录位于 Notebook Server 安装目录的 Linux 上的 ArcGIS Notebook Server 单机部署，此过程为必需项。

1. 以管理员身份登录到您的 ArcGIS Enterprise 门户，然后打开 ArcGIS Notebook Server Manager。
2. 单击设置选项卡。
3. 单击目录。
4. 确定 arcgisworkspace 目录的当前路径是否位于 ArcGIS Notebook Server 安装目录内。

   <installdir>/arcgis/notebook/directories/arcgisworkspace

   如果 arcgisworkspace 目录位于 ArcGIS Notebook Server 安装目录内，则您必须将工作空间目录移至安装目录外部的位置，然后才能进行升级。

   如果 arcgisworkspace 目录不在 ArcGIS Notebook Server 安装目录内，则无需执行本部分中的剩余步骤。

5. 针对 arcgisworkspace 目录单击编辑。
6. 将现有目录路径值替换为位于安装目录外部的 arcgisworkspace 目录的新路径。

   <installdir>/arcgis/arcgisnotebookserver/directories/arcgisworkspace

7. 单击保存。
8. 手动将先前 arcgisworkspace 目录内的所有内容复制到新 arcgisworkspace 目录。

备份部署

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

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 提取位置中的 ./Setup，然后按照提示完成升级。

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

   <untar directory>/Setup -l yes -m silent

2. 实用程序升级完成后，对 11.3 的 ArcGIS Notebook Server 软件进行重新授权。 要静默授权 ArcGIS Notebook Server，请使用以下语法运行软件授权：

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware

   运行以下命令以查看所有授权选项：

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

   注：

   有关在离线环境中授权 ArcGIS Notebook Server 安装的信息，请参阅在离线环境中授权部分。

3. 可以使用 upgradesite 命令行实用程序升级站点。

   此实用程序具有两个参数：

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

   默认情况下，upgradesite 实用程序可在 ${HOME}/arcgis/notebookserver/tools/upgradesiteutility/upgradesite.sh 位置找到。

   升级之前，查看本主题开头的准备信息。 当您准备就绪以进行升级时，在要升级的计算机上打开命令终端。 浏览到实用程序所在的目录然后运行以下命令：

   > ./upgradesite.sh -s

   实用程序将显示进程报告并在完成升级时停止。

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

静默授权

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

要静默授权 ArcGIS Notebook Server，请使用以下语法运行软件授权：

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware

运行以下命令以查看所有授权选项：

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

在离线环境中授权

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

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

   <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .prvc file> -o <full path to authorization file output>

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

   <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>

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

升级后的步骤

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

运行安装后实用程序

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

1. 使用 ArcGIS Notebook Server 安装帐户打开终端。
2. 将目录更改为 ArcGIS Notebook Server 工具文件夹。 默认情况下，此路径为 ${HOME}/arcgis/notebookserver/tools/postInstallUtility。
3. 或者，通过运行以下命令参阅实用程序的帮助：./PostInstallUtility.sh -h
4. ArcGIS Notebook Server 需要您的计算机上已安装 Docker 引擎。 要确定 Docker 在您的计算机上是否处于活动状态，请运行以下命令：./PostInstallUtility.sh -d
5. 如果尚未安装 Docker Desktop，请立即安装。
6. 通过指定文件路径安装您的 Notebooks 镜像。 镜像应压缩为 .tar.gz 格式。 如果您拥有 Advanced 许可和 Docker Desktop，将此命令运行两次以同时安装您从 My Esri 下载的“标准”和“高级”容器镜像。

   注：

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

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

   注：

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

注：

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

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

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

要安装 ArcGIS Notebook Server 示例数据，请完成以下步骤：

1. 以将要运行 ArcGIS Notebook Server 的用户身份打开 shell 命令。 浏览至从 My Esri 下载 ArcGIS Notebook Server 示例数据 tar.gz 文件的目录。
2. 使用以下命令解压 tar.gz 文件：

   tar -xvzf ArcGIS_Notebook_Server_Samples_Data_Linux_.tar.gz

3. 浏览到 <install directory>/notebookserver/License，阅读许可协议。
4. 从目录中运行脚本。

   ./ArcGISNotebookServerSamplesData-Setup.sh

5. 将目录更改为 ArcGIS Notebook Server 工具文件夹。

   默认情况下，路径为 ${HOME}/arcgis/notebookserver/tools/postInstallUtility。

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

   > ./PostInstallUtility.sh -h

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

   > ./PostInstallUtility.sh -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。