Skip to main content

升级 Portal for ArcGIS

Portal for ArcGIS 安装程序旨在检测并升级 Portal for ArcGIS 的现有安装。 您可以选择使用安装程序以交互方式进行升级，或者进行静默升级。

重要信息：

在进行升级之前，请仔细查看有关升级 ArcGIS Enterprise 的通用信息以及特定于 Portal for ArcGIS 的以下信息。

注意：

升级期间，您的基础部署、其联合服务器站点和 ArcGIS Pro（如果已通过门户进行许可）均处于离线状态。

准备升级

为了确保升级顺利完成，在开始升级过程之前，请先阅读以下部分以做好准备。

备份您的内容

在升级 Portal for ArcGIS 之前，请备份 ArcGIS Enterprise 部署中的数据和配置。 为了确保您已拥有必要的备份，请完成以下步骤：

  1. 请确认您已创建以下内容的备份：

    提示：

    可以按照以下步骤来备份站点，也可以使用 WebGISDR 工具来创建 ArcGIS Enterprise 部署的备份。 为此，请按照以下步骤导出 ArcGIS Enterprise。

    • 通过 ArcGIS Data Store 部署的所有数据存储。 有关运行备份的详细信息，请参阅升级 ArcGIS Data Store。

    • 所有联合 ArcGIS Server 站点。 如果您需要将站点恢复为之前的版本，则可以导入并恢复该站点。 有关详细信息，请参阅备份和恢复 ArcGIS Server 站点配置。

  2. 确定分配给门户的 content、index、db 和 temp 目录的磁盘空间量。 确保磁盘上的可用空间量至少为该数量的 2.5 倍。 如果未达到，请向磁盘分配至少 2.5 倍的空间。

    Portal for ArcGIS 升级需要这一可用空间来成功备份和升级您的门户内容、站点信息和安全性设置。 这些目录的默认位置为 <Portal for ArcGIS installation directory>/arcgisportal。 如果内容目录位于另一计算机上，该建议同样适用。

    Portal for ArcGIS 升级需要这一可用空间来成功备份和升级您的门户内容、站点信息和安全性设置。 这些目录的默认位置为 C:\arcgisportal。 如果内容目录位于另一计算机上，该建议同样适用。

升级概念

当进行升级时，请记住以下几点：

  • 完成升级所需的时间取决于门户所包含的内容、注册账户的数量以及您部署的组件和自定义内容数量。

  • 确保组织成员意识到升级需要停机，并为新版本中将引入的新功能和更改做好准备。

  • 如果您的门户当前处于 只读模式，请在运行升级前关闭此模式。

  • 如果无法更新当前 Web Adaptor，也可以在安装了先前版本的同一台计算机上安装已更新版本的 ArcGIS Web Adaptor (IIS)。 升级时，必须保留相同的 Web Adaptor 上下文。 为此，请卸载当前使用门户配置的 Web Adaptor，然后安装具有以前使用的相同名称的新版本 Web Adaptor。 请注意，无法在同一计算机上安装具有相同上下文的两个 Web Adaptor。

注:

Portal for ArcGIS 安装程序要求使用运行 Windows 服务的账户。 您可以升级共享网络目录位置上的现有内容，但前提条件是运行 Windows 服务的账户对目录位置具有完全访问权限。

如果 Windows 服务当前正以没有密码的 LocalSystem 账户运行，您必须首先将该账户更改为带有密码的本地账户，然后才能继续升级。

许可

当进行许可时，请记住以下几点：

  • 您必须从 My Esri 获取新的门户许可文件，并重新授权软件。

    注:

    您在升级过程中输入的许可文件将用于许可门户的用户和应用程序。 请确保新许可文件适用于您的当前用户和应用程序配置。

  • 升级 Portal for ArcGIS 之前，您必须确保组织成员已检入所有离线 ArcGIS Pro 许可。 可以查看许可活动以了解已检出其 ArcGIS Pro 许可以供离线使用的成员。 有关如何检入离线许可的信息，请参阅检入离线许可。

  • 某些较低版本中使用的 Editor、GIS Professional Standard 和 GIS Professional Advanced 用户类型名称已分别更改为 Contributor、Professional 和 Professional Plus。 当导入新的 Portal for ArcGIS 许可文件时，您可能会注意到此更新。

  • 如果成员的用户类型在升级后不再可用，则必须为其分配不同的用户类型。 有关可用用户类型的列表，请参阅用户类型。

  • 升级后，一些用户类型可能包括以前仅作为附加许可提供的附加应用程序。 如果成员分配的用户类型包括某一应用程序的许可，您无需为该成员分配该应用程序附加许可。请参阅许可应用程序简介，了解有关应用程序及其包含的用户类型的详细信息。

  • 升级后，当分配给成员的一个或多个附加许可包含在其用户类型中时，您将在组织页面的概览选项卡上看到通知，指出某些成员的许可被分配了两次。 您可以取消分配所有适用成员的重复附加许可，释放这些许可。

  • 自 11.4 版本起，为 ArcGIS Pro、ArcGIS Pro 扩展模块、ArcGIS Drone2Map 以及 ArcGIS AllSource 启用授权用户许可时，不再需要 ArcGIS License Manager。

内容

使用内容时，请谨记以下信息：

  • 如果您在门户中注册了来自非联合 ArcGIS Server 站点的项目，则无需升级此 ArcGIS Server 站点，即可将站点的服务与您的门户结合使用。 先前版本 ArcGIS Server 中的服务可供 Portal for ArcGIS 使用。

  • 如果您创建了自定义底图或者可配置应用程序群组，并将 Esri 底图或 ArcGIS Configurable Apps 共享至该群组，则在进行升级之后，必须再次将这些项目共享至该群组。

  • 如果使用地图或应用程序中的 ArcGIS Living Atlas of the World 内容，请在升级前确认您使用的项目未处于成熟支持或已弃用状态。 在每个版本中，一些 ArcGIS Living Atlas 内容已停用并且不再可用。 如果您使用其中一个项目，则升级后该项目将无法正常运行。 有关此版本中已停用的 ArcGIS Living Atlas 内容的列表，请参阅 ArcGIS Living Atlas 内容生命周期和更新。

应用程序

使用应用程序时，请谨记以下信息：

  • 如果您的门户配置了 Esri 应用程序，请确保升级后您的版本与 Portal for ArcGIS 的版本兼容。

  • 如果您的门户配置了 ArcGIS Navigator 移动地图包，则必须在升级 Portal for ArcGIS 后对其进行重新配置。

高可用性和复制环境

为了最大限度地减少升级期间的停机时间，可以在升级主环境之前设置一个复制环境并将内容复制到该环境。 有关此升级策略以及如何升级高可用性或者复制环境的详细信息，请参阅升级高可用性和复制环境。

使用安装程序升级

  1. 在命令提示符中，以安装现有门户所用的用户身份来启动 Portal for ArcGIS 安装脚本（例如 <CD ROOT or untar directory>/Setup）。

    在启动此脚本之前，您无需停止 Portal for ArcGIS。

    提示：

    要从 Portal for ArcGIS 安装介质启动安装脚本，请单击安装脚本，然后选择在终端中运行按钮。

  2. 安装程序在目标计算机上检测到现有版本的 Portal for ArcGIS 后，选择继续或退出升级。 请参阅以下示例：

    =========================================================================
Portal for ArcGIS <New Version> (Linux)
=========================================================================
Your Portal for ArcGIS <Previous Version> is installed at:
/home/ags/arcgis/portal
Confirm Settings
=========================================================================
Product to upgrade:             Portal for ArcGIS <Previous Version> (Linux)
Location to upgrade:            /home/ags/arcgis/portal
Your Portal for ArcGIS <Previous Version> will be stopped when performing the
upgrade and Portal for ArcGIS <New Version>
will be started after the upgrade completes.
  'y' to continue with these settings
  'q' to exit without upgrading this product
Enter choice [y,q] (y):

  3. 键入 y 并按 Enter 键以接受检测到的设置，并继续升级操作。

    您必须使用一个新的 .json 授权文件来为软件授权。 Portal for ArcGIS 升级完成后，门户网站会在浏览器窗口中打开。

  4. 启动 Portal for ArcGIS 安装程序 Setup.exe，并阅读欢迎界面及条款。 准备就绪后请单击下一步继续。

  5. 请阅读并接受许可协议，如果您不同意许可协议的条款，请退出。

    随即显示将要安装的功能。

  6. 单击安装以开始升级。 不要中断安装过程。

    注:

    此过程可能需要一些时间才能完成。

  7. 单击完成关闭安装向导。

    门户网站会在浏览器窗口中打开。

  8. 清除您的浏览器缓存（包括 cookie）。

    保留在缓存中的先前版本网站的信息可能会导致升级后的网站无法正常显示，并可导致您无法登录。 建议您对所有将用于查看升级后的门户网站的浏览器执行清除缓存（包括 cookies）操作。

  9. 在导入许可文件页面上，浏览至您从 My Esri 获取的包含已授权用户类型和应用程序的许可 .json 文件。 单击继续门户升级。

    这会触发升级，并创建门户内容、站点信息和安全设置的备份。 完成此步骤需要花费几分钟的时间。

    注:

    您在升级过程中输入的许可文件将用于许可门户的用户和应用程序。 请确保新许可文件适用于您的当前用户和应用程序配置。

  10. 登录到托管您正在与门户配合使用的 ArcGIS Web Adaptor 的计算机，然后将其卸载。 有关完整说明，请参阅 Java (Linux) 的卸载主题。 请确保在卸载 Web Adaptor 之前记下其名称。

  11. 安装将与门户配合使用的 Web Adaptor。 有关完整说明，请参阅 Java (Linux) 的安装主题。 确保使用的 Web Adaptor 名称与之前版本中使用的相同。

  12. 在门户中配置 ArcGIS Web Adaptor。 有关完整说明，请参阅 Java (Linux) 的配置主题。

    注:

    如果存在并且系统属性中未设置 WebContextURL，则在重新注册到门户时，应使用 DNS 别名来访问 WA。

  13. 登录到托管您正在与门户配合使用的 ArcGIS Web Adaptor 的计算机，然后将其卸载。 有关完整说明，请参阅 IIS 或 Java (Windows) 的卸载主题。 请确保在卸载 Web Adaptor 之前记下其名称。

  14. 安装将与门户配合使用的 Web Adaptor。 有关完整说明，请参阅 IIS 或 Java (Windows) 的安装主题。 确保使用的 Web Adaptor 名称与之前版本中使用的相同。

  15. 在门户中配置 ArcGIS Web Adaptor。 有关完整说明，请参阅 IIS 或 Java (Windows) 的配置主题。

    注:

    如果存在并且系统属性中未设置 WebContextURL，则在重新注册到门户时，应使用 DNS 别名来访问 WA。

  16. 验证您是否能够以组织管理员的身份通过 ArcGIS Web Adaptor URL 登录到门户。

    URL 地址格式为 https://webadaptorhost.example.com/webadaptorname/home。

    注:

    • 如果您收到需要完成升级后步骤的通知，则必须在消息对话框中单击确定以完成所需的升级后步骤。 其中包括升级重新索引内容（如果内容位于 Amazon S3 存储段或 Azure Blob 存储中，则每次升级后都需要手动重新索引）以及更新高可用性门户中 Portal for ArcGIS 计算机之间的关联。

    • 升级后，如果在登录到门户时收到有关许可的通知，则您可能未导入符合当前许可配置的许可文件，或者可能为您的用户分配了临时用户类型。 有关详细信息，请参阅升级 Portal for ArcGIS 后的注意事项。

  17. 升级其余 ArcGIS Enterprise 组件。

静默升级

要静默升级，请完成以下步骤：

  1. 在命令提示符中，以安装现有门户所用的用户身份来启动 Portal for ArcGIS 安装脚本

    以下示例提供了静默升级 Portal for ArcGIS 所需的脚本及参数。

    <CD ROOT or untar directory>/Setup -l yes -m silent

    有关可与安装脚本中配合使用的参数的完整说明，请参阅在 Linux 上静默安装 Portal for ArcGIS

  2. 在命令提示符下，启动 Portal for ArcGIS 安装脚本。

    在以下示例中，软件所使用的 Portal for ArcGIS 账户为 admin，密码为 itsasecret。

    <path to Portal for ArcGIS setup download>\setup.exe /qb USER_NAME=admin PASSWORD=itsasecret ACCEPTEULA=yes

    有关可与安装脚本中配合使用的参数的完整说明，请参阅静默安装 Portal for ArcGIS

  3. 可以使用 upgradeportal 命令行实用程序以静默方式完成升级和升级后操作。

    1. 在命令行中，浏览至 <Portal install directory>/tools/upgradeportal 文件夹。

    2. 在命令行中，浏览至 <Portal install directory>\tools\upgradeportal 文件夹。

    3. 运行以下命令：

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

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

      要获得帮助，请使用 -h 或 --help 运行命令。 您也可以使用 ArcGIS Portal Administrator API 中的升级操作升级 Portal for ArcGIS。 有关升级操作的详细信息，请参阅 ArcGIS Portal Admin API 帮助中的升级文档。

升级后任务

升级 Portal for ArcGIS 后，您可能需要完成以下升级后任务，以确保部署按预期运行。

更新升级前创建的 WebGISDR 属性文件

如果您计划使用在升级 ArcGIS Enterprise 之前创建的 WebGISDR 属性文件，请在运行备份或还原操作之前查看该文件。 仅包含加密值的属性文件才需要更新。

如果属性文件包含加密值，请将其替换为其未加密值，并将指示属性是否加密的相应布尔值设置为 false。

有关详细信息，请参阅 WebGISDR 工具属性文件。

手动更新实用程序服务

如果您使用 OfflinePackaging、RasterUtilities 或 GeocodingTools 实用程序服务，则必须在升级后手动对其进行更新。

  1. 升级完成后，请以拥有实用程序服务的用户身份登录到 ArcGIS Server Manager。

  2. 在服务选项卡的管理服务部分中，单击实用程序文件夹。

  3. 单击共享属性 按钮。

  4. 在随即显示的对话框中，单击保存。

    由此将更新门户中的服务。

  5. 以管理员身份登录到门户。 在内容选项卡中，找到已更新的服务。 单击共享。 根据需要更新共享设置，然后单击确定。

    随即更新服务以及共享该服务的各个群组。

  6. 针对每个适用服务重复上述步骤。

配置路径服务

如果您通过使用网络数据集发布路径服务来配置路径服务，建议您在服务器升级后重新配置路径服务以使用最新功能。 对于基于地理处理的路径服务，新服务参数和新服务功能仅在升级服务器后重新发布路径服务时可用。

要使用网络数据集重新发布路径服务，请完成以下步骤：

  1. 以默认管理员身份或者具有正确管理门户设置权限的自定义角色身份登录。

  2. 在站点顶部，单击组织，然后单击设置。

  3. 单击页面左侧的实用程序服务。

  4. 单击页面右侧的方向和路径。

  5. 单击更新路径服务按钮并选择我要发布的网络数据集。

  6. 按照配置路径服务中的步骤，使用网络数据集配置路径服务。

成功运行后，您可以使用 ArcGIS Server Manager 删除之前发布的包含路径服务的文件夹。

升级后问题的疑难解答

如果您在升级过程中遇到任何问题，请仔细查看以下信息以及常见问题的解决方案。

注:

请记住，升级后遇到的问题并不一定指示升级失败。

门户无法正确显示或者阻止登录

清除您的浏览器缓存（包括 cookie）。 这些错误通常是由于浏览器中存在先前版本网站的缓存信息所导致的。 如果仍无法登录，请确认您使用的是初始管理员账户或具有门户管理权限的账户。 如果未加载组织概览选项卡上的卡片，请导入您的门户许可文件 (.json)。 您可以使用 URL https://portal.example.com:7443/arcgis/portaladmin/license/importLicense 通过 Portal Administrator Directory 导入许可文件。 请确保这是门户的正确许可文件。 导入新的许可文件时，组织中的所有用户类型和应用程序许可都将被新许可文件覆盖。

门户中的项目、群组和用户不可见

安装软件并指定初始管理员账户后，将对您的门户的重新索引进行初始化。 最初可能无法显示所有项目、群组以及用户，这是因为索引重新构建尚未完成。 完成索引的重新构建可能会花费一些时间，具体取决于组织中的用户数量和内容体积。 例如，在 8 核计算机上运行 Portal for ArcGIS 的小型组织（包含数百个用户及内容项目）可能需要花费 15 分钟来重新构建索引。 而在含有 8 个内核的计算机上运行 Portal for ArcGIS 的大型组织（包含数万个用户及内容项目）可能需要花费超过 3 个小时来重新构建索引。

检查索引重建状态

通过以下步骤可检查重新构建索引的状态。 当存储与索引计数相等时，即完成索引的重新构建以及升级。

  1. 打开 Portal Administrator API 并使用初始管理员账户进行登录。

    URL 地址格式为 https://portal.example.com:7443/arcgis/portaladmin。

  2. 单击系统 > 索引器 > 索引状态。

  3. 刷新页面获取最新状态。

ArcGIS Living Atlas 内容不再可访问

升级后，如果在您的组织中无法访问 ArcGIS Living Atlas 图层，则该项目可能在此版本中已停用。 有关已停用项目的更新列表，请参阅 ArcGIS Living Atlas 内容生命周期和更新。

如果升级后无法打开订阅者或高级内容项目，请验证在配置门户以访问此内容时所使用的 ArcGIS Online 账户仍然有效。 如果无效，则必须完成更新此账户和 ArcGIS Living Atlas 内容的附加步骤。

所分配的许可数量超过可用的许可数量

**所分配的许可数量超过可用的许可数量。 分配了这些许可的成员可能无法访问该门户。 有关详细信息，请转至“许可”选项卡。**当管理员登录到门户并且门户的许可处于透支状态时，将向管理员显示此通知。 已分配用户类型或加载项许可的用户数量超过可用许可数量。

管理员可以浏览至许可选项卡以查看处于透支状态的许可。 处于透支状态的已分配许可的数量大于可用数量。 根据您组织的需要，您可以通过正确分配许可来重新分配许可或获取新的门户许可文件。

成员的许可被分配过两次

**某些成员的许可被分配过两次。 这些成员可以通过其用户类型和附加许可访问相同的许可。**对门户进行升级后，当分配给成员的一个或多个附加许可包含在其用户类型中时，将向管理员显示此通知。 管理员可以取消分配所有适用成员的重复附加许可。

创建初始管理员账户时出错

如果在创建初始管理员账户时收到此错误，则门户日志中的信息可帮助您解决这一问题。 通常，如果创建账户时网络连接暂时丢失，则可能会发生此错误。 要访问日志，请浏览至日志目录并打开最近的日志文件（例如 <Portal for ArcGIS installation directory>/arcgisportal/logs/<machine name>/portal/portal-20141201.095803-8596-0.0.log）。 如有必要，可以将此信息共享给 Esri 支持。

如果您要恢复为之前的部署，请在恢复之前复制所有日志文件，以帮助排除支持事件故障。 要访问日志，请浏览至日志目录（例如 <Portal for ArcGIS installation directory>/arcgisportal/logs/）。

如果在创建初始管理员账户时收到此错误，则门户日志中的信息可帮助您解决这一问题。 通常，如果创建账户时网络连接暂时丢失，则可能会发生此错误。 要访问日志，请浏览至日志目录并打开最近的日志文件（例如 C:\arcgisportal\logs\<machine name>\portal\portal-20141201.095803-8596-0.0.log）。 如有必要，可以将此信息共享给 Esri 支持。

如果您要恢复为之前的部署，请在恢复之前复制所有日志文件，以帮助排除支持事件故障。 要访问日志，请浏览至日志目录（例如 C:\arcgisportal\logs\）。