使用 ArcGIS Enterprise Builder 升级基础部署

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

注：

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

升级步骤

1. 查看并完成先决条件步骤。
2. 运行 ArcGIS Enterprise 10.8.1 Builder 安装程序以安装 10.8.1 组件。
3. 使用配置向导或 upgradebasedeployment 命令行实用程序来执行升级。
4. 完成升级后步骤。

先决条件

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

查看 ArcGIS Enterprise Builder 的系统要求。

警告：

Windows 7 不支持使用构建器升级现有的 ArcGIS Enterprise 部署。

所有 ArcGIS Enterprise 软件组件的运行方式帐户必须相同。

运行 ArcGIS Enterprise 10.8.1 Builder 安装程序

1. 使用 Builder.exe 启动安装程序。
2. 安装过程中，请阅读并接受主协议，如果不同意许可协议中的条款，请退出。
3. 将提供您之前安装 ArcGIS Enterprise Builder 组件的目标文件夹。 升级过程中不能更改此目标文件夹。 选择下一步以继续安装程序。
4. 为指定帐户提供密码。 这是所有 ArcGIS Enterprise 组件的运行方式帐户。 您必须为此用户使用正确的密码，否则安装程序将返回错误消息。 如果不知道指定用户帐户的密码，请联系系统管理员。
5. 升级现有部署时，您将无法更改托管服务器和 Enterprise 门户的 ArcGIS Web Adaptor (IIS) 名称。 安装程序将基于以前的配置来配置 ArcGIS Web Adaptor (IIS) 名称。
6. 在软件授权对话框中，将提供 Portal for ArcGIS 和 ArcGIS Server 当前授权文件的位置。 这些授权文件应该适用于您正在安装的版本。
7. 安装程序成功升级后，将自动启动安装后配置向导。

使用配置向导进行升级

您可使用配置向导升级 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。

默认位置是 C:\Program Files\ArcGIS\Server\tools\upgradebasedeployment。

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

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

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

upgradebasedeployment.bat -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.8.1 中恢复门户自定义设置时，建议不要在 10.8.1 中替换您在先前版本中修改过的文件。 这可能会对 10.8.1 的部署产生不利影响。 您需要在 10.8.1 中打开每个文件，然后手动重新添加先前版本中的自定义行为。

提示：

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