ArcGIS Enterprise Builder 可以升级构建者先前安装的基础部署。 与安装相同的限制也适用于升级。
注：
使用其他方法设置的部署无法使用 ArcGIS Enterprise Builder 进行升级。
升级摘要
以下是使用 ArcGIS Enterprise Builder 升级基础部署所必须采取的步骤的摘要：
- 查看并完成先决条件步骤。
- 升级您的 ArcGIS Web Adaptor 实例
- 运行 ArcGIS Enterprise 11.4 版本的构建器安装程序以安装 11.4 版本的组件。
- 使用配置向导或 upgradebasedeployment 命令行实用程序来执行升级。
- 完成升级后步骤。
先决条件
在使用 ArcGIS Enterprise Builder 升级之前，请仔细查看以下信息，并完成所有必需操作：
- 阅读 ArcGIS Enterprise Builder 系统要求以确保您的硬件满足当前要求。
- 不支持从 10.7 或 10.7.1 版本直接升级到 11.4。 要使用 ArcGIS Enterprise Builder 升级 ArcGIS Enterprise 10.7 或 10.7.1，请首先升级到过渡版本 (10.8.x - 11.3)，然后将该版本升级到 11.4。 阅读有关临时版本的升级文档，以确认您开始使用的 ArcGIS Enterprise Builder 版本支持直接升级。
- 不支持从 10.6.1 版本或更低版本直接升级到 11.4。 要使用 ArcGIS Enterprise Builder 升级 ArcGIS Enterprise 10.6.1 或更低版本，请首先升级到过渡版本 (10.8.x 或 10.9.x)，然后将该版本升级到 11.4。 阅读有关临时版本的升级文档，以确认您开始使用的 ArcGIS Enterprise Builder 版本支持直接升级。
- 则必须重新授权 11.4 软件。 您可以在 My Esri 中访问新的授权文件和 ArcGIS Enterprise Builder 文件。
升级您的 ArcGIS Web Adaptor 实例
ArcGIS Enterprise Builder 无法升级 ArcGIS Web Adaptor (Java Platform)，原因是需要执行从 Java Web 服务器取消部署 Web Adaptor 的附加步骤。 在运行 ArcGIS Enterprise Builder 之前执行这些步骤。
- 以管理员身份将目录更改为 ArcGIS Web Adaptor 安装文件夹。
- 从计算机卸载 ArcGIS Web Adaptor 文件实例。
这将从 Java Web 服务器中删除 ArcGIS Web Adaptor 实例。
- 从您的应用程序服务器取消部署两个 ArcGIS Web Adaptor 实例。
- 安装 ArcGIS Web Adaptor 11.4。
- 使用 arcgis.war 文件为您的应用程序服务器部署两个 ArcGIS Web Adaptor 实例；一个用于 ArcGIS Server，另一个用于 ArcGIS Enterprise 门户。
您现在可以继续执行 ArcGIS Enterprise Builder 升级过程。
运行 ArcGIS Enterprise 11.4 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 部署
安装完成后，您可以使用配置向导升级 ArcGIS Enterprise，或者关闭浏览器并使用 upgradebasedeployment命令行实用程序升级基础部署。
使用配置向导进行升级
要使用配置向导升级，请完成以下步骤：
- 如果尚未打开，请浏览到配置向导的 URL，其格式为 http://mymachine.mydomain.com:6080/arcgis/enterprise。
或者，您也可以在计算机中搜索 ArcGIS Enterprise 配置向导并使用快捷方式启动它。
警告：
升级过程中，请勿关闭或刷新浏览器。
- 阅读初始登陆页面上的信息，其中说明了向导需要使用安全连接，然后单击下一步。
向导重定向到安全端口 6443。 浏览器将返回安全警告；首次访问安全向导时将显示此警告。 继续跳过警告。 如何继续取决于您的 web 浏览器。
- 在向导的许可和升级 ArcGIS Enterprise 页面上，浏览到包含授权用户类型和应用程序的门户 .json 文件。
此文件可从 My Esri 中获取。
- 单击升级。
这将触发升级过程并打开进度页面（配置部署）。 升级过程需要几分钟才能完成。
升级向导完成后，最后一页将确认升级完成。 关闭此页面以遵循升级后步骤。
使用命令行实用程序进行升级
使用 ArcGIS Enterprise Builder 安装软件后，您可以使用 upgradebasedeployment 命令行实用程序升级基础部署。
使用安装该软件的帐户运行命令行实用程序。
upgradebasedeployment 命令行实用程序位于 <ArcGIS Server installation directory>/tools/upgradebasedeployment。
以下介绍了命令行实用程序中使用的参数：
- -lf - 指定门户 .json 许可文件的路径。 如果要升级到同一版本系列中的某个版本，则会忽略此属性，并且可以根据需要在升级后导入新的许可文件。 门户 .json 许可文件将从 My Esri 获取。
- -s - 以静默方式升级基础 ArcGIS Enterprise 部署，系统不会提示您继续。
- -h - 显示帮助并退出程序。
请按照以下步骤使用 upgradebasedeployment 实用程序升级 ArcGIS Enterprise：
- 打开命令提示符。
- 在命令提示符中，将工作目录更改为 upgradebasedeployment 实用程序的位置，例如 <ArcGIS Server installation directory>/tools/upgradebasedeployment。
- 直接在命令提示符中输入 upgradebasedeployment 命令和参数。
./upgradebasedeployment.sh -lf <path to portal json file> -s升级完成后，您将获得门户和托管服务器站点的链接。
继续升级后步骤。
升级后步骤
使用 ArcGIS Enterprise Builder 升级 ArcGIS Enterprise 部署后，确认部署可以正常运行。 您可能还需要完成其他可选步骤。
- 验证您是否可以以组织管理员的身份通过 ArcGIS Web Adaptor URL 登录 ArcGIS Enterprise 门户网站。 URL 地址格式为 https://webadaptorhost.example.com/webadaptorname/home。
注：
请使用 ArcGIS Portal Administrator Directory 检查索引。 如果其不同步，请重新创建 Portal for ArcGIS 的索引。
- 恢复您之前为 ArcGIS Enterprise 门户配置的所有自定义设置。
在 11.4 中恢复门户自定义设置时，建议不要替换您在先前版本中修改过的文件。 这可能会对 11.4 的部署产生不利影响。 相反，在 11.4 中打开每个文件并重新创建自定义以确保您使用的是当前支持的功能。
- 或者，使用 serverScan.py 和 portalScan.py 脚本来检查升级后的 ArcGIS Server 和 ArcGIS Enterprise 门户的安全性最佳做法。