升级 ArcGIS Notebook Server

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

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

如果您从 10.7.1 或较早版本进行升级，必须在升级过程中对 10.8.1 版本的 ArcGIS Notebook Server 软件进行授权。 如果要从 10.8 升级到 10.8.1，则无需重新授权软件。

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

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

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

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

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

准备升级

升级之前，请仔细查看以下信息：

• 可以在升级之前访问 My Esri 中的所有必需文件，包括 10.8.1 容器映像。
• 要使 ArcGIS Notebook Server 正常运行，其版本必须和与之联合门户的版本一致。
• 要升级 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。
• 请勿卸载现有 ArcGIS Notebook Server。ArcGIS Notebook Server 安装程序和命令行安装程序可用于检测和升级 ArcGIS Notebook Server 组件的现有安装。
• 在升级过程中的任何时间点，请勿从门户取消联合 ArcGIS Notebook Server 站点，或取消将其指定为门户的 Notebook Server。 否则。将严重影响门户托管的现有 ArcGIS Notebooks。
• 可以使用安装程序或命令行安装程序升级 ArcGIS Notebook Server。 选择其中一种方法进行升级。
• 在升级之前，清除在 ArcGIS Notebook Server 计算机上使用的所有 Web 浏览器的缓存。

备份部署

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

旧版本：

在 10.7 中，您必须手动备份站点的配置存储和服务器目录。

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 升级至 10.8.1。 如果组织的限制导致您无法使用设置文件，您可以从 ArcGIS Notebook Server Administrator Directory 使用脚本调用升级站点操作。

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

1. 安装过程中，请阅读并接受主协议，如果不同意许可协议中的条款，请退出。

   安装程序将显示要安装的功能及其要求的硬盘可用磁盘空间。

2. 在下一个对话框上，指定帐户登录凭据或提供配置文件。

   在 ArcGIS Server 帐户框中会预填充现有安装使用的 ArcGIS Notebook Server 帐户。 提供 ArcGIS Notebook Server 帐户密码。 通常，此密码是您在安装软件时所定义的密码。

   如果密码验证未成功，则会显示表明该密码无效的错误消息。 如果您不确定 ArcGIS Notebook Server 帐户的密码，请联系系统管理员或使用 ArcGIS Notebook Server Administrator Directory 重置密码。

   如果您提供了配置文件，则服务器配置文件中的凭据必须与现有 ArcGIS Notebook Server 站点所使用的凭据相同。

3. 如果您选择了指定账户名和密码并手动输入了 ArcGIS Notebook Server 帐户信息，则可以在显示的下一个对话框上导出服务器配置文件。 如果您不想导出配置文件，请单击下一步，接受默认的请勿导出配置文件选项。 如果想要导出服务器配置文件以供将来安装使用，单击导出配置文件，浏览至安全的文件夹并提供配置文件的名称。

   注：

   如果要执行以下任意操作，您可能想要导出服务器配置文件：

   • 在多台计算机上安装时要创建相同的 ArcGIS Notebook Server 帐户。
   • 存储帐户以备升级到更新版本时使用。
   • 执行用户名和密码都已加密的静默安装。

   警告：

   将服务器配置文件导出至网络共享时，计算机上安装 ArcGIS Notebook Server 的本地系统帐户必须具有对网络共享的写入权限。 如果未设置该权限，服务器配置文件可能不会成功导出。 如果您不确定如何正确设置网络共享的权限，请联系系统管理员，或本地导出服务器配置文件，然后将其复制到网络共享。

4. 要完成安装，请按照屏幕上的说明执行后续操作。
5. 安装完成后，配置向导将在浏览器中打开。 按照配置向导中的说明完成升级过程。
6. 如果您拥有多机站点，对其余的站点计算机继续执行步骤 1 到 5。 如果您拥有单机站点并打算升级为多机站点，则现在可以将附加计算机加入站点。 您还必须修改服务器目录和配置存储的路径，以使用所有计算机都可以访问的共享位置。 。

通过命令行升级

从 10.8 开始，您可以使用 upgradesite 实用程序通过命令行升级 ArcGIS Notebook Server。

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

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

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

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

> ./upgradesite.sh -s

实用程序将显示进程报告并在完成升级时停止。 如果您的站点中有多台计算机，对每台计算机执行此命令，然后继续下一节中的步骤。

静默授权

如果您从 10.7.1 或较早版本进行升级，实用程序升级完成后，您必须对 ArcGIS Notebook Server 软件的 10.8.1 进行授权。 如果要从 10.8 升级到 10.8.1，则无需重新授权软件。

要静默授权 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 客户服务中心网站 https://service.esri.com/drm。 按照屏幕中的指示上传您的授权信息文件并下载您的 .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 实例以匹配新版本。

2. 通过指定文件路径安装您的 Docker 图像。 镜像应压缩为 .tar.gz 格式。 如果您拥有 Advanced 许可，将此命令运行两次以同时安装您从 My Esri 下载的“标准”和“高级”容器图像。> ./PostInstallUtility.sh -l <path of .tar.gz Docker image>

   注：

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

3. 从站点取消注册之前的 ArcGIS Web Adaptor 实例并卸载。
   1. 登录到您的 ArcGIS Notebook Server Administrator Directory。
   2. 浏览到 系统 > Web Adaptor > 已注册计算机。
   3. 单击取消注册 Web Adaptor。
4. 安装新的 ArcGIS Web Adaptor 10.8.1 实例并通过 ArcGIS Notebook Server 进行注册。
5. 部署升级完成后，您可以利用 10.8.1 的功能。 要在门户中启用 notebook 计划，请执行以下操作：

   • 如果需要，更新所有包括笔记本权限的自定义角色以添加新的计划笔记本。
   • 如果您的笔记本创作者想要使用计划功能，请指示其更新每个笔记本运行时。 仅可以计划使用 10.8.1 运行时（版本 4.0）的 notebook。

您的 ArcGIS Notebook Server 10.8.1 站点现在即可托管 ArcGIS Notebooks。