Skip to main content

使用 ArcGIS Enterprise Builder 升级基础部署

ArcGIS Enterprise Builder 能够升级之前由构建器安装的基础部署。 使用其他方法设置的部署无法使用该构建器进行升级。 与安装相同的限制也适用于升级。

升级摘要

以下是使用 ArcGIS Enterprise Builder 升级基础部署所必须采取的步骤的摘要：

  1. 查看并完成先决条件步骤。

  2. 升级 ArcGIS Web Adaptor 实例。

  3. 运行 ArcGIS Enterprise Builder 安装程序以安装 ArcGIS Enterprise 组件。

  4. 使用配置向导或 upgradebasedeployment 命令行实用程序来执行升级。

  5. 完成升级后步骤。

先决条件

在使用 ArcGIS Enterprise Builder 升级之前，请仔细查看以下信息，并完成所有必需操作：

  • 请阅读 ArcGIS Enterprise Builder 系统要求确保您的硬件满足当前要求。

  • 确认现有 ArcGIS Enterprise 版本是否支持直接升级到此版本。

    注:

    已停用 10.7.1 及更低版本。 要从这些版本升级，需要两个过渡版本。 有关信息，请参阅 11.5 升级文档。

  • 必须针对 12.1 重新授权软件。 您可以在 My Esri 中访问新的授权文件以及 ArcGIS Enterprise Builder 文件。

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

升级 ArcGIS Web Adaptor 实例

ArcGIS Enterprise Builder 无法升级 ArcGIS Web Adaptor (Java Platform)，因为需要执行一个额外步骤从 Java Web 服务器取消部署 Web Adaptor。 在运行 ArcGIS Enterprise Builder 之前，请执行以下步骤。

  1. 以管理员身份将目录更改为 ArcGIS Web Adaptor 安装文件夹。

  2. 从计算机卸载 ArcGIS Web Adaptor 实例文件。

    这会从 Java Web 服务器中移除 ArcGIS Web Adaptor 实例。

  3. 从应用程序服务器卸载 ArcGIS Web Adaptor 的两个实例。

  4. 安装 ArcGIS Web Adaptor 12.1。

  5. 使用 arcgis.war 文件向应用程序服务器部署 ArcGIS Web Adaptor 的两个实例：一个针对 ArcGIS Server，一个针对 Portal for ArcGIS。

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

运行 ArcGIS Enterprise 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 Builder 安装更新的基础 ArcGIS Enterprise 组件。

  1. 使用 Builder.exe 文件启动安装程序。

  2. 阅读并接受主协议，如果不同意主协议的条款，请退出。

    将提供您之前安装 ArcGIS Enterprise Builder 组件的目标文件夹。 升级过程中不能更改此目标文件夹。

  3. 单击下一步以继续安装程序。

  4. 为指定账户提供密码。

    这是所有 ArcGIS Enterprise 组件的运行方式账户。 您必须为此用户使用正确的密码，否则安装程序将返回错误消息。 如果不知道指定用户账户的密码，请联系系统管理员。

    升级现有部署时，您将无法更改托管服务器或门户的 ArcGIS Web Adaptor (IIS) 名称。 安装程序将基于以前的配置来配置 ArcGIS Web Adaptor (IIS) 名称。

  5. 在软件授权对话框中，将提供 Portal for ArcGIS 和 ArcGIS Server 授权文件的位置。

    这些授权文件必须适用于您正在安装的版本。

在更新安装后，配置向导将在您的默认 Web 浏览器中自动启动。

升级 ArcGIS Enterprise 部署

安装完成后，您可以使用配置向导升级 ArcGIS Enterprise，或者关闭浏览器并使用 upgradebasedeployment 命令行实用程序升级基础部署。

使用配置向导进行升级

要使用配置向导升级，请完成以下步骤：

  1. 如果尚未打开，请浏览到配置向导的 URL，其格式为 http://mymachine.myexample.com:6080/arcgis/enterprise。

    或者，可以在计算机中搜索 ArcGIS Enterprise 配置向导并使用快捷方式启动它。

    注意：

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

  2. 阅读初始登陆页面上的信息，其中说明了向导需要使用安全连接，然后单击下一步。

    向导重定向到安全端口 6443。 浏览器将返回安全警告；首次访问安全向导时将显示此警告。 继续跳过警告。 如何继续取决于您的 web 浏览器。

  3. 在向导的许可和升级 ArcGIS Enterprise 页面上，浏览到包含授权用户类型和应用程序的门户 .json 文件。

    此文件可从 My Esri 中获取。

  4. 单击升级。

    这将触发升级过程并打开进度页面（配置部署）。 升级过程需要几分钟才能完成。

升级向导完成后，最后一页将确认升级完成。 关闭此页面以遵循升级后步骤。

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

使用 ArcGIS Enterprise Builder 安装软件后，您可以使用 upgradebasedeployment 命令行实用程序升级基础部署。

使用安装该软件的账户运行命令行实用程序。

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

您必须以 Windows 管理员身份运行命令行实用程序。

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

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

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

  • -lf - 指定门户 .json 许可文件的路径。 如果要升级到同一版本系列中的某个版本，则会忽略此属性，并且可以根据需要在升级后导入新的许可文件。 门户 .json 许可文件将从 My Esri 获取。

  • -s - 以静默方式升级基础 ArcGIS Enterprise 部署，系统不会提示您继续。

  • -h - 显示帮助并退出程序。

请按照以下步骤使用 upgradebasedeployment 实用程序升级 ArcGIS Enterprise：

  1. 打开命令提示符。

  2. 在命令提示符中，将工作目录更改为 upgradebasedeployment 实用程序的位置，例如 <ArcGIS Server installation directory>/tools/upgradebasedeployment。

  3. 在命令提示符中，将工作目录更改为 upgradebasedeployment 实用程序的位置，例如 <ArcGIS Server installation directory>\tools\upgradebasedeployment。

  4. 直接在命令提示符中输入 upgradebasedeployment 命令和参数。

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

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

升级完成后，您将获得门户和托管服务器站点的链接。

继续升级后步骤。

升级后步骤

在使用 ArcGIS Enterprise Builder 升级 ArcGIS Enterprise 部署后，确认部署是否可以正常运行。 您可能还需要完成其他可选步骤。

  1. 验证您是否能够以管理员身份通过 ArcGIS Web Adaptor URL 登录组织。 URL 地址格式为 https://webadaptorhost.example.com/webadaptorname/home。

    注:

    请使用 ArcGIS Portal Administrator Directory 检查索引。 如果其不同步，请重新创建 Portal for ArcGIS 的索引。

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