升级方法取决于您以何种方式以及何时在 Amazon Web Services (AWS) 上创建 ArcGIS Enterprise 部署。
- AWS 上的任何 ArcGIS Enterprise 部署都可以使用手动升级过程升级。 如果您在 10.8 版本之前创建了站点,则必须使用手动过程进行升级。
- 如果您使用高可用性 ArcGIS Enterprise 10.8 或 10.8.1 版本 Esri Amazon Web Services CloudFormation 模板 (arcgis-enterprise-ha.template.json) 创建了基础 ArcGIS Enterprise 部署,则可以使用 Chef 脚本进行升级。
- 如果您使用高可用性 ArcGIS Enterprise 10.9 或 10.9.1 版本 Esri CloudFormation 模板 (arcgis-enterprise-ha.template.json) 创建了基础 ArcGIS Enterprise 部署,则可以使用 11.0 CloudFormation 模板进行升级。
- 如果您使用多个 10.9 或 10.9.1 版本 CloudFormation 模板在独立的计算机上创建了各个基础 ArcGIS Enterprise 组件,则可以使用多个 11.0 CloudFormation 模板升级各个组件。
- 如果使用 10.9 或 10.9.1 版本 ArcGIS Enterprise Cloud Builder for Amazon Web Services 创建了 ArcGIS Enterprise 部署,则可以使用 11.0 ArcGIS Enterprise Cloud Builder for AWS 进行升级。
在升级之前
无论您使用哪种升级方法,请在升级部署之前查看以下信息:
- 获取当前软件版本所需的 ArcGIS 许可。 可以从 My Esri 进行下载。
- 创建部署的备份,以便在升级程序出现任何问题时能够进行还原。
您可以使用 Portal for ArcGIS 随附的 webgisdr 实用程序在 ArcGIS Enterprise 部署中创建大多数组件的备份。 但是,此备份中不包含时空大数据存储。 如果您的部署包含时空大数据存储,则可以使用 ArcGIS Data Store backupdatastore 实用程序为其创建单独的备份。
使用手动升级过程进行升级
使用手动过程升级 Amazon Web Services 上的多机 ArcGIS Enterprise 部署与本地软件更新类似。 从 My Esri 中将软件更新下载到 Amazon Elastic Compute Cloud (EC2) 实例并将其直接应用于现有部署。 每台计算机上的所有 ArcGIS Enterprise 组件必须运行同一软件版本。
注:
您无法将 ArcGIS Enterprise 10.6.1 或较早版本的组件直接升级到 11.0。 必须先升级到中间版本,然后再升级到 11.0。 在按照说明升级到 11.0 之前,请按照中间版本的说明操作。
准备更新组件
完成以下步骤来准备更新组件:
- 从 My Esri 下载 Portal for ArcGIS、ArcGIS Web Adaptor、ArcGIS Server 和 ArcGIS Data Store 的新版本。 然后从 Esri 获取新许可
- 确保您的防火墙允许端口 5701-5703、7005、7099、7199、7654、7120、7220、29079-29090 和 4369,且当前没有被其他应用程序占用。
高可用性部署使用这些端口用于计算机间的通信和同步。
- 确认已为切片缓存数据存储备份配置了共享目录。 如果您没有共享目录,则升级之前需要配置一个共享目录。
目前,AWS 上仅支持文件共享。
- 确保没有人连接至您的 ArcGIS Enterprise 门户或 ArcGIS Server 站点。
警告:
请勿停止 Portal for ArcGIS、ArcGIS Server 或 ArcGIS Data Store 服务。 如果您停止了这些服务,webgisdr 实用程序将无法为您的部署创建备份。
- 使用 webgisdr 实用程序为部署创建完整备份,该实用程序随 Portal for ArcGIS 一同安装。
如果升级过程中出现任何问题,您可以使用此备份来重新部署之前的软件版本。
注:
如果部署中存在时空大数据存储,请使用 ArcGIS Data Store backupdatastore 实用程序创建其备份,因为这并未包含在 webgisdr 工具所创建的备份中。
升级 Portal for ArcGIS
首先,升级 Portal for ArcGIS。
- 与 AWS 上的 Portal for ArcGIS 计算机建立远程桌面连接 (Microsoft Windows) 或 SSH (Linux) 连接。 如果门户具有高可用性,请连接到 AWS 上的其中一台 Portal for ArcGIS 计算机。 以 ArcGIS 用户的身份进行连接。
如果这是您第一次在 AWS 上对 Windows 版的 Portal for ArcGIS 进行升级,请更改 ArcGIS 用户密码。 必须对部署中的所有计算机均进行此操作,且所有计算机的密码必须相同。
如果已使用 AWS Management Console 部署 ArcGIS Enterprise,由于 Portal for ArcGIS 升级过程会为内容目录的临时存储创建 S3 存储段,请确保允许此计算机在 AWS 帐户中创建 Amazon Simple Storage Service (S3) 存储段。 如果使用 Esri 提供的 CloudFormation 模板进行了部署,则该模板已经完成此配置。
- 将新的 Portal for ArcGIS 和 ArcGIS Web Adaptor 安装程序(如果可用)以及新的 Portal for ArcGIS 许可文件置于该计算机上。
- 如果门户仅包含一台 Portal for ArcGIS 计算机,请按照以下步骤升级 Portal for ArcGIS 以更新门户计算机及其 web 适配器,然后根据需要使用新的许可文件对 Portal for ArcGIS 进行授权。
- 如果您的门户具有高可用性,请针对第二台 Portal for ArcGIS 计算机重复步骤 1 和 2。 然后,按照以下步骤升级高可用性门户以更新软件,然后根据需要使用新的许可文件对每台计算机上的 Portal for ArcGIS 进行授权。
升级 ArcGIS Server
升级门户的托管服务器以及与您的门户联合的所有其他 ArcGIS Server 站点。
在升级门户的托管服务器时提供 ArcGIS GIS Server 许可。 在升级联合服务器时所提供的许可取决于 ArcGIS Server 填充到部署中的角色。
注:
在升级 ArcGIS Data Store 前,您必须先升级 ArcGIS Server 站点。
- 以 arcgis 用户身份与门户托管服务器的 ArcGIS Server SITEHOST 计算机建立远程桌面连接 (Windows) 或 SSH (Linux) 连接。
- 将新的 ArcGIS Server 和 ArcGIS Web Adaptor 安装程序以及 ArcGIS GIS Server 许可文件置于该计算机上。
- 如果您的 ArcGIS Server 站点仅包含一台计算机,请按照升级 ArcGIS Server 中的说明对单机站点进行升级。
- 如果您的 ArcGIS Server 站点包含多台计算机,请在每台计算机上重复步骤 1 和 2。 然后,按照升级 ArcGIS Server 中的说明对多机站点进行升级。
- 如果将其他 ArcGIS Server 站点与您的门户手动进行了联合,则请连接到这些计算机,并升级这些站点的软件和许可。
升级 ArcGIS Data Store
如果您拥有通过门户托管服务器配置的多种数据存储,则请对每一种进行升级。
升级高可用性关系或切片缓存数据存储时,请先升级主计算机,然后再升级备用计算机。
- 以 arcgis 用户身份与安装了 ArcGIS Data Store 的每台计算机建立远程桌面连接 (Windows) 或 SSH (Linux) 连接。
- 将 ArcGIS Data Store 安装文件置于每台计算机上。
- 如果部署正在 AWS 的 Windows 中运行,请按照升级 ArcGIS Data Store 中的步骤对每种类型的数据存储进行更新。
测试升级后的部署
测试升级后的 ArcGIS Enterprise 部署,以确保所有服务均在运行且均可访问,并且常规工作流仍处于运行状态。
测试成功完成后,由于升级前创建的备份无法用于恢复至升级后的计算机,因此可以将其删除。
提示:
使用 webgisdr 实用程序为成功升级后的部署创建完整备份,以便拥有此版本部署的基础备份。
使用 Chef 脚本升级
如果您使用高可用性 ArcGIS Enterprise 10.8 或 10.8.1 版本 Esri Amazon Web Services CloudFormation 模板 (arcgis-enterprise-ha.template.json) 创建了基础 ArcGIS Enterprise 部署,则可以使用 Chef 脚本进行升级。
Microsoft Windows 和 Ubuntu 上的部署的升级步骤不同。 请遵循适用于您的部署操作系统的说明。
升级 Windows 的高度可用的 ArcGIS Enterprise 部署
请遵循这些步骤来使用 Chef 在两个 EC2 实例(主实例和备用实例)上升级 ArcGIS Enterprise。
升级备用实例
首先升级备用实例上的组件。
- 与 EC2 备用实例进行远程桌面连接。
- 下载并安装 Chef 或 Cinc 客户端 16.16.13。 如果您安装的是 Chef 的旧版本,请将其更新到版本 16.16.13。
- 从 My Esri 内的您的帐户中下载 11.0 安装文件,并将文件上传到 EC2 实例上的文件夹中:
- ArcGIS_Web_Adaptor_for_Microsoft_IIS_110_182888.exe
- Portal_for_ArcGIS_Windows_110_182885.exe
- ArcGIS_Server_Windows_110_182874.exe
- ArcGIS_DataStore_Windows_110_182887.exe
- Portal_for_ArcGIS_Web_Styles_Windows_110_182886.exe
- 获取 Portal for ArcGIS 11.0 授权文件 (.json) 和获得 ArcGIS GIS Server 许可的 ArcGIS Server 授权(.epc 或 .prvc),然后将其置于 EC2 实例上。
- 将 ArcGIS Cookbook 版本 4.0.0 (arcgis-4.0.0-cookbooks.zip) 下载到 EC2 实例中,解压缩文件,然后将解压缩后的文件内容放置在 C:\chef 文件夹中。
- 删除以下文件夹:
- C:\chef\nodes
- C:\Users\Administrator\.chef\local-mode-cache
- 创建 C:\chef\node.json 文件的副本,然后将其重命名为 upgrade_base_enterprise_ha_windows_standby_step1.json。
- 在文本编辑器中打开 upgrade_base_enterprise_ha_windows_standby_step1.json 文件并修改以下参数:
- 将 ArcGIS 版本设置为 11.0。
"arcgis" : { "version": "11.0",
- 将 ArcGIS 存档存储库设置为您在 EC2 实例上放置软件文件的文件夹。
"arcgis" : { "repository": { "archives": "<drive>\\<folder>"
- 将服务器授权设置为 ArcGIS Server 11.0 授权文件的位置。
"server" : { "authorization_file" : "<drive>:\\<folder path>\\My_New_Server.prvc"
- 将门户授权设置为 Portal for ArcGIS 11.0 授权文件的位置。
"portal" : { "authorization_file" : "<drive>:\\<folder path>\\my_new_portal.json",
- 修改运行列表以使用以下资源:
"recipe[arcgis-enterprise::install_portal]", "recipe[arcgis-enterprise::webstyles]", "recipe[arcgis-enterprise::install_portal_wa]", "recipe[arcgis-enterprise::server]", "recipe[arcgis-enterprise::server_wa]", "recipe[arcgis-enterprise::install_datastore]"
- 将 ArcGIS 版本设置为 11.0。
- 保存并关闭 upgrade_base_enterprise_ha_windows_standby_step1.json 文件。
- 以管理员身份打开一个命令行窗口、将目录更改为 C:\chef,并运行以下命令:chef-client -z -j c:\chef\upgrade_base_enterprise_ha_windows_standby_step1.json。
脚本将运行以升级备用实例上的组件。
备用升级成功完成后,可以继续升级主实例。
升级主实例
备用 Chef 师运行成功完成后,可以继续升级主实例。
- 与 EC2 主实例进行远程桌面连接。
- 下载并安装 Chef 或 Cinc 客户端 16.16.13。 如果您安装的是 Chef 的旧版本,请将其更新到版本 16.16.13。
- 从 My Esri 内的您的帐户中下载 11.0 安装文件,并将文件上传到 EC2 实例上的文件夹中:
- ArcGIS_Web_Adaptor_for_Microsoft_IIS_110_182888.exe
- Portal_for_ArcGIS_Windows_110_182885.exe
- ArcGIS_Server_Windows_110_182874.exe
- ArcGIS_DataStore_Windows_110_182887.exe
- Portal_for_ArcGIS_Web_Styles_Windows_110_182886.exe
- 获取 Portal for ArcGIS 11.0 授权文件 (.json) 和获得 ArcGIS GIS Server 许可的 ArcGIS Server 授权(.epc 或 .prvc),然后将其置于 EC2 实例上。
- 将 ArcGIS Cookbook 版本 4.0.0 (arcgis-4.0.0-cookbooks.zip) 下载到 EC2 实例中,解压缩文件,然后将解压缩后的文件内容放置在 C:\chef 文件夹中。
- 删除以下文件夹:
- C:\chef\nodes
- C:\Users\Administrator\.chef\local-mode-cache
- 创建 C:\chef\node.json 文件的副本,然后将其重命名为 upgrade_base_enterprise_ha_windows_primary_step2.json。
- 在文本编辑器中打开 upgrade_base_enterprise_ha_windows_primary_step2.json 文件并修改以下参数:
- 将 ArcGIS 版本设置为 11.0。
"arcgis" : { "version": "11.0",
- 将 ArcGIS 存档存储库设置为您在 EC2 实例上放置软件文件的文件夹。
"arcgis" : { "repository": { "archives": "<drive>\\<folder>"
- 将服务器授权设置为 ArcGIS Server 11.0 授权文件的位置。
"server" : { "authorization_file" : "<drive>:\\<folder path>\\My_New_Server.prvc"
- 将门户授权设置为 Portal for ArcGIS 11.0 授权文件的位置。
"portal" : { "authorization_file" : "<drive>:\\<folder path>\\my_new_portal.json",
- 修改运行列表以使用以下资源:
"recipe[arcgis-enterprise::install_portal]", "recipe[arcgis-enterprise::webstyles]", "recipe[arcgis-enterprise::portal]", "recipe[arcgis-enterprise::portal_wa]", "recipe[arcgis-enterprise::server]", "recipe[arcgis-enterprise::server_wa]", "recipe[arcgis-enterprise::datastore]"
- 将 ArcGIS 版本设置为 11.0。
- 保存并关闭 upgrade_base_enterprise_ha_windows_primary_step2.json 文件。
- 以管理员身份打开一个命令行窗口、将目录更改为 C:\chef,并运行以下命令:chef-client -z -j c:\chef\upgrade_base_enterprise_ha_windows_primary_step2.json。
脚本将运行以升级主实例上的组件。
主升级成功完成后,可以继续在主实例上配置 Web 适配器。
在备用实例上升级 Web 适配器
主 Chef 师运行完成后,再次登录到备用实例以升级门户的 Web 适配器。
- 与 EC2 备用实例进行远程桌面连接并登录到该实例。
- 复制 upgrade_base_enterprise_ha_windows_standby_step1.json 文件并将其重命名为 upgrade_base_enterprise_ha_windows_standby_step3.json。
- 在文本编辑器中打开 upgrade_base_enterprise_ha_windows_standby_step3.json,然后更改运行列表以仅运行 portal_wa 资源。
"run_list" : [ "recipe[arcgis-enterprise::portal_wa]" ]
- 以管理员身份打开一个命令行窗口、将目录更改为 C:\chef,并运行以下命令:chef-client -z -j c:\chef\upgrade_base_enterprise_ha_windows_standby_step3.json。
该脚本为门户配置 ArcGIS Web Adaptor。
升级 Ubuntu 的高度可用的 ArcGIS Enterprise 部署
请遵循这些步骤来使用 Chef 在两个 EC2 实例(主实例和备用实例)上升级 ArcGIS Enterprise。
升级备用实例
首先升级备用 EC2 实例上的组件。
- 以 ubuntu 用户身份建立与备用 EC2 实例的 SSH 连接。
- 使用以下命令之一下载并安装 Chef 或 Cinc 客户端 16.16.13。 如果您安装的是 Chef 的旧版本,请将其更新到版本 16.16.13。
- Chef 客户端:sudo curl -L https://omnitruck.chef.io/install.sh | sudo bash -s -- -v 16.16.13
- Cinc 客户端:sudo curl -L https://omnitruck.cinc.sh/install.sh | sudo bash -s -- -v 16.16.13
- 从 My Esri 内的您的帐户中下载 11.0 安装文件,并将文件上传到 EC2 实例上的文件夹中:
- ArcGIS_Web_Adaptor_Java_Linux_110_182987.tar.gz
- Portal_for_ArcGIS_Linux_110_182984.tar.gz
- ArcGIS_Server_Linux_110_182973.tar.gz
- ArcGIS_DataStore_Linux_110_182986.tar.gz
- Portal_for_ArcGIS_Web_Styles_Linux_110_182985.tar.gz
- 获取 Portal for ArcGIS 11.0 授权文件 (.json) 和获得 ArcGIS GIS Server 许可的 ArcGIS Server 授权(.epc 或 .prvc),然后将其置于 EC2 实例上。
- 将 ArcGIS Cookbook 版本 4.0.0 (arcgis-4.0.0-cookbooks.tar.gz) 下载到 EC2 实例中,解包并解压缩文件,然后将文件内容放置在 /var/chef 目录中。
- 删除 /var/chef/nodes 目录。
- 创建 /etc/chef/node.json 文件的副本,然后将其重命名为 upgrade_base_enterprise_ha_ubuntu_standby_step1.json。
- 在文本编辑器中打开 upgrade_base_enterprise_ha_ubuntu_standby_step1.json 文件并修改以下参数:
- 将 ArcGIS 版本设置为 11.0。
"arcgis" : { "version": "11.0",
- 将 ArcGIS 存档存储库设置为您在 EC2 实例上放置软件文件的文件夹。
"arcgis" : { "repository": { "archives": "/<path and folder>"
- 将服务器授权设置为 ArcGIS Server 11.0 授权文件的位置。
"server" : { "authorization_file" : "/<path>/my_new_server.prvc"
- 将门户授权设置为 Portal for ArcGIS 11.0 授权文件的位置。
"portal" : { "authorization_file" : "/<path>/my_new_portal.json",
- 修改运行列表以使用以下资源:
"recipe[arcgis-enterprise::install_portal]", "recipe[arcgis-enterprise::start_portal]", "recipe[arcgis-enterprise::webstyles]", "recipe[arcgis-enterprise::install_portal_wa]", "recipe[arcgis-enterprise::unregister_server_wa]", "recipe[arcgis-enterprise::server]", "recipe[arcgis-enterprise::server_wa]", "recipe[arcgis-enterprise::install_datastore]", "recipe[arcgis-enterprise::start_datastore]"
- 将 ArcGIS 版本设置为 11.0。
- 保存并关闭 upgrade_base_enterprise_ha_ubuntu_standby_step1.json 文件。
- 以 ubuntu 用户身份将目录更改为 /var/chef,并运行以下命令:sudo chef-client -z -j /etc/chef/upgrade_base_enterprise_ha_ubuntu_standby_step1.json
脚本将运行以升级备用实例上的组件。
备用升级成功完成后,可以继续升级主实例。
升级主实例
备用 Chef 师运行成功完成后,可以继续升级主实例。
- 以 ubuntu 用户身份建立与 EC2 主实例的 SSH 连接。
- 使用以下命令之一下载并安装 Chef 或 Cinc 客户端 16.16.13。 如果您安装的是 Chef 的旧版本,请将其更新到版本 16.16.13。
- Chef 客户端:sudo curl -L https://omnitruck.chef.io/install.sh | sudo bash -s -- -v 16.16.13
- Cinc 客户端:sudo curl -L https://omnitruck.cinc.sh/install.sh | sudo bash -s -- -v 16.16.13
- 从 My Esri 内的您的帐户中下载 11.0 安装文件,并将文件上传到 EC2 实例上的文件夹中:
- ArcGIS_Web_Adaptor_Java_Linux_110_182987.tar.gz
- Portal_for_ArcGIS_Linux_110_182984.tar.gz
- ArcGIS_Server_Linux_110_182973.tar.gz
- ArcGIS_DataStore_Linux_110_182986.tar.gz
- Portal_for_ArcGIS_Web_Styles_Linux_110_182985.tar.gz
- 获取 Portal for ArcGIS 11.0 授权文件 (.json) 和获得 ArcGIS GIS Server 许可的 ArcGIS Server 授权(.epc 或 .prvc),然后将其置于 EC2 实例上。
- 将 ArcGIS Cookbook 版本 4.0.0 (arcgis-4.0.0-cookbooks.tar.gz) 下载到 EC2 实例中,解包并解压缩文件,然后将文件内容放置在 /var/chef 目录中。
- 删除 /var/chef/nodes 目录。
- 创建 /etc/chef/node.json 文件的副本,然后将其重命名为 upgrade_base_enterprise_ha_ubuntu_primary_step2.json。
- 在文本编辑器中打开 upgrade_base_enterprise_ha_ubuntu_primary_step2.json 文件并修改以下参数:
- 将 ArcGIS 版本设置为 11.0。
"arcgis" : { "version": "11.0",
- 将 ArcGIS 存档存储库设置为您在 EC2 实例上放置软件文件的文件夹。
"arcgis" : { "repository": { "archives": "/<path and folder>"
- 将服务器授权设置为 ArcGIS Server 11.0 授权文件的位置。
"server" : { "authorization_file" : "/<path>/my_new_server.prvc"
- 将门户授权设置为 Portal for ArcGIS 11.0 授权文件的位置。
"portal" : { "authorization_file" : "/<path>/my_new_portal.json",
- 修改运行列表以使用以下资源:
"recipe[arcgis-enterprise::install_portal]", "recipe[arcgis-enterprise::webstyles]", "recipe[arcgis-enterprise::portal]", "recipe[arcgis-enterprise::portal_wa]", "recipe[arcgis-enterprise::server]", "recipe[arcgis-enterprise::server_wa]", "recipe[arcgis-enterprise::datastore]"
- 将 ArcGIS 版本设置为 11.0。
- 保存并关闭 upgrade_base_enterprise_ha_ubuntu_primary_step2.json 文件。
- 以 ubuntu 用户身份将目录更改为 /var/chef,并运行以下命令:sudo chef-client -z -j /etc/chef/upgrade_base_enterprise_ha_ubuntu_primary_step2.json
脚本将运行以升级主实例上的组件。
主升级成功完成后,可以继续在主实例上配置 Web 适配器。
在备用实例上升级 Web 适配器
主 Chef 师运行完成后,再次登录到备用实例以配置门户的 Web 适配器。
- 以 ubuntu 用户身份建立与备用 EC2 实例的 SSH 连接。
- 复制 /etc/chef/upgrade_base_enterprise_ha_ubuntu_standby_step1.json 文件并将其重命名为 upgrade_base_enterprise_ha_ubuntu_standby_step3.json。
- 在文本编辑器中打开 upgrade_base_enterprise_ha_ubuntu_standby_step3.json,然后更改运行列表以仅运行 portal_wa 资源。
"run_list" : [ "recipe[arcgis-enterprise::portal_wa]" ]
- 以 ubuntu 用户身份将目录更改为 /var/chef,并运行以下命令:sudo chef-client -z -j /etc/chef/upgrade_base_enterprise_ha_ubuntu_standby_step3.json
该脚本为门户配置 ArcGIS Web Adaptor。
使用 CloudFormation 模板升级
如果您使用 10.9 或 10.9.1 版本 arcgis-enterprise-ha.template.json CloudFormation 模板创建高可用性基础 ArcGIS Enterprise 部署,则可以使用 11.0 arcgis-enterprise-ha-upgrade.template.json 文件进行升级。 有关说明,请参阅使用 CloudFormation 升级高可用性 ArcGIS Enterprise 部署。
如果您使用 10.9 或 10.9.1 版本 CloudFormation 模板创建了位于独立 EC2 实例上的分布式高可用性 ArcGIS Enterprise 组件,请使用相应模板进行升级。 下表列出了等效部署和升级模板,并提供了升级模板使用说明的链接。
10.9 或 10.9.1 版本部署模板 | 11.0 升级模板 | CloudFormation 升级模板说明 |
---|---|---|
arcgis-portal-ha.template.json | arcgis-portal-ha-upgrade.template.json | |
arcgis-server-ha.template.json | arcgis-server-ha-upgrade.template.json | |
arcgis-datastore-primarystandby.template.json | arcgis-datastore-primarystandby-upgrade.template.json | |
arcgis-datastore-cluster.template.json | arcgis-datastore-cluster-upgrade.template.json |