使用 ArcGIS Enterprise Builder 升级基础部署

从 10.6 版本开始，ArcGIS Enterprise Builder 能够升级之前由构建器安装的基础部署。与安装相同的限制也适用于升级。

注：

使用其他方法设置的部署无法使用 ArcGIS Enterprise Builder 进行升级。

升级步骤

1. 查看并完成先决条件步骤。
2. 取消部署并卸载以前的 ArcGIS Web Adaptor 实例，然后安装和部署 10.7.1 Web Adaptor 实例。
3. 运行 ArcGIS Enterprise 10.7.1 Builder 安装程序以安装 10.7.1 组件。
4. 使用配置向导或 upgradebasedeployment 命令行实用程序来执行升级。
5. 完成升级后步骤。

先决条件

如果您即将升级到 10.7.1，则您可能需要针对 10.7.1 重新授权软件。如果要从同一版本系列中的某个版本进行升级（例如，从 10.7 升级到 10.7.1），则无需获取新的授权文件。如果要从先前版本系列中的某个版本进行升级，则需要重新授权软件。您可以在 My Esri 中访问新的授权文件和 ArcGIS Enterprise Builder 文件。

查看 ArcGIS Enterprise Builder 的系统要求。

升级您的 ArcGIS Web Adaptor 实例

ArcGIS Enterprise Builder 无法升级 ArcGIS Web Adaptor，原因是需要执行从 Java Web 服务器取消部署 Web Adaptor 的附加步骤。在运行 ArcGIS Enterprise Builder 之前执行这些步骤。

1. 以管理员身份浏览至您的 ArcGIS Web Adaptor 安装文件夹。
2. 从计算机卸载 ArcGIS Web Adaptor 文件实例。这将从 Web 服务器取消部署 Web Adaptor 实例。
3. 从您的应用程序服务器取消部署两个 ArcGIS Web Adaptor 实例。
4. 安装 ArcGIS Web Adaptor 10.7.1。
5. 使用 arcgis.war 文件为您的应用程序服务器部署两个 ArcGIS Web Adaptor 实例；一个用于 ArcGIS Server，另一个用于 ArcGIS Enterprise 门户。

   您现在可以继续执行 ArcGIS Enterprise Builder 升级过程。

运行 ArcGIS Enterprise 10.7.1 Builder 安装程序

ArcGIS Enterprise Builder 可用于检测和升级 ArcGIS Enterprise Builder 组件的现有安装。要开始升级，请运行 ArcGIS Enterprise Builder 提取位置中的 ./Setup，并按照提示完成 ArcGIS Enterprise Builder 组件的升级。安装程序必须以安装现有 ArcGIS Enterprise Builder 组件的用户帐户的方式运行。

运行安装程序时，ArcGIS Server 授权文件可以使用以静默方式安装 ArcGIS Enterprise Builder 中记录的相同方法进行传递，或在安装程序完成后使用 ArcGIS Server 工具文件夹中的软件授权工具。这将安装到 <EnterpriseBuilderInstallPath>/arcgis/server/tools/authorizeSoftware。请注意，升级过程中不能更改安装路径。

使用配置向导进行升级

您可使用配置向导升级 ArcGIS Enterprise，或关闭浏览器并使用 upgradebasedeployment 命令行实用程序完成基础部署升级。要使用配置向导，请完成以下步骤：

安装程序运行完成后，如果尚未打开，请浏览至配置向导的 URL (http://mymachine.mydomain.com:6080/arcgis/enterprise)。您也可以在计算机中搜索 ArcGIS Enterprise 配置向导，然后使用快捷方式将其启动。

警告：

升级过程中，请勿关闭或刷新浏览器。

1. 随即显示初始登陆页面，并说明向导需要使用安全连接。单击下一步。
2. 然后将您重定向到安全端口 6443，浏览器会显示安全警告；当您第一次访问安全向导时，这属于预期的行为。继续跳过警告（这因浏览器而异）。

该 ArcGIS Enterprise Builder 升级向导包括三个页面：

1. 在导入许可文件页面上，浏览到包含授权用户类型和应用程序包的门户 .JSON 文件。此文件可从 My Esri 中获取。
2. 在第二页上，单击升级。这会触发升级，并创建门户内容、站点信息和安全设置的备份。完成此步骤需要花费几分钟的时间。
3. 第三页显示升级进度。
4. 升级向导完成后，最后一页将确认升级完成。退出此页面以遵循下一部分中的升级后步骤。

使用命令行实用程序进行升级

使用 ArcGIS Enterprise Builder 安装软件后，使用命令行实用程序完成基础部署的升级。要运行命令行实用程序，您必须选择以管理员身份来运行。

upgradebasedeployment 命令行实用程序位于 <ArcGIS Server installation directory>\tools\upgradebasedeployment。

默认位置是 /home/linux/arcgis/server/tools/configurebasedeployment。

以下介绍了命令行实用程序中使用的参数：

• -lf - 指定门户 .JSON 许可文件的路径。如果要升级到同一版本系列中的某个版本，则会忽略此属性，并且可以根据需要在升级后导入新的许可文件。门户 .JSON 许可文件从 My Esri 获取。
• -s - 以静默方式升级基础 ArcGIS Enterprise 部署，无提示。
• -h - 显示帮助和退出程序。

1. 打开命令提示符。
2. 在命令提示符中，将工作目录更改为 upgradebasedeployment 实用程序的位置。例如：<ArcGIS Server installation directory>\tools\upgradebasedeployment。
3. 直接在命令提示符内输入 upgradebasedeployment 命令和参数。

./upgradebasedeployment.sh -lf <path to portal json file> -s

升级后步骤

完成升级向导步骤后，您将获得指向门户和服务器的链接。

1. 验证您是否能以组织管理员的身份通过 ArcGIS Web Adaptor URL 登录到 ArcGIS Enterprise 门户网站。URL 地址格式为 https://webadaptorhost.domain.com/webadaptorname/home。
2. 如果您已使用组织配置 ArcGIS Pro 许可，则可以选择升级 ArcGIS License Server Administrator。升级 ArcGIS License Server Administrator 时，具有 ArcGIS Pro 许可的成员无法访问 ArcGIS Pro。如果成员当前登录到 ArcGIS Pro，将看到一则消息，提示程序将在 24 小时后关闭。成员可在这段时间中完成或保存其工作。升级 ArcGIS License Server Administrator 后无需重新配置 ArcGIS Pro 许可。
3. 恢复您之前为 ArcGIS Enterprise 门户配置的所有自定义设置。在 10.7.1 中恢复门户自定义设置时，建议不要在 10.7.1 中替换您在先前版本中修改过的文件。这可能会对 10.7.1 的部署产生不利影响。您需要在 10.7.1 中打开每个文件，然后手动重新添加先前版本中的自定义行为。

提示：

Esri 建议使用 serverScan.py 和 portalScan.py 脚本来检查升级后的 ArcGIS Server 和 ArcGIS Enterprise 门户的安全性最佳做法。