升级您的 ArcGIS Enterprise 门户

Portal for ArcGIS 10.6.1 安装程序可用于检测和升级 Portal for ArcGIS 的现有安装。

准备升级 Portal for ArcGIS

升级之前，请仔细阅读下列信息。

• 如果要从 10.5.1 版本或更早版本升级到 10.6.1，则需要使用 10.6.1 的新授权文件对您的软件重新授权。您可以在 My Esri 中访问新的授权文件。如果要从 10.6 版本进行升级，则无需重新授权。
• 运行 Portal for ArcGIS 10.6.1 安装程序会自动将门户升级到 10.6.1。无需按序获取和安装先前发布的各版本，也无需卸载 Portal for ArcGIS 的先前版本。
• 如果您已配置高可用性门户，则需要遵循具体的步骤来完成升级。配置高可用性门户主题中对这些步骤进行概述。

  注：

  在 10.6 版本中，高可用性部署使用可用端口 5701、7005、7099、7654、7120 和 7220 进行计算机间通信。必须确保防火墙允许在这些端口上进行本地通信，并且其当前未被其他应用程序使用。

• 如果您已将企业级地理数据库配置为托管服务器的托管数据库并打算升级至 10.6.1，则需要完成一些额外的步骤。升级服务器后，您需要将企业级地理数据库注册为数据库（而不是托管数据库）。然后，安装 ArcGIS Data Store 并将其注册为关系数据存储。这会将 ArcGIS Data Store 配置为托管服务器的托管数据库。
• 完成升级所需的时间取决于门户所包含的内容、注册帐户的数量以及您部署的组件和自定义内容数量。
• 如果您发布了基于可配置应用程序模板的应用程序，则需检查应用程序模板是否已停用。您对门户进行了升级后，停用的可配置应用程序模板无法正常运行或显示。您将需要使用新的应用程序模板重新创建这些应用程序。请注意，如果您使用的是几个版本之前的门户，则需要检查每个版本中的停用模板。例如，如果您从 Portal for ArcGIS 10.5 升级，则需要检查 10.5 版本到当前版本之间所有版本的已停用模板列表。
• 如果您的门户配置了 Esri 应用程序，则需要确保升级前您的版本与 10.6.1 门户兼容。
• 如果已配置 Insights for ArcGIS，则必须在升级 ArcGIS Enterprise 之前先卸载 Insights for ArcGIS。升级完成后，您需要安装 Insights for ArcGIS 的兼容版本。
• 如果您已经对门户配置了 Navigator for ArcGIS 移动地图包，则需要在将门户升级到 10.6.1 后重新配置它们。

注：

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

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

ArcGIS Enterprise 升级顺序

为了让 ArcGIS Enterprise 门户正常运行，它必须与托管服务器、Web Adaptor 和数据存储为相同版本。升级 ArcGIS Enterprise 部署的推荐顺序如下：

1. 升级 Portal for ArcGIS
2. 升级 ArcGIS Web Adaptor（针对门户）
3. 升级 ArcGIS Server（先升级托管服务器，再升级其他服务器）
4. 升级 ArcGIS Web Adaptor（针对服务器）
5. ArcGIS Data Store（先升级主要存储，再升级备用存储）

• 您的 ArcGIS Enterprise 门户版本必须与托管服务器、任何 GeoAnalytics Server、任何 GeoEvent Server 以及与之联合的所有栅格分析服务器的版本相匹配。但是，10.6 版本的门户能够与任何 10.5 或更高版本的其他联合服务器一起使用。例如，只要托管服务器版本为 10.6，一个 10.5 版本的 GIS Server（不能是托管服务器）和一个 10.5.1 版本的 Business Analyst Server 也能与 10.6 版本的门户联合。
• 如果在非联合 ArcGIS Server 站点中将项目注册到门户，则无需将服务器升级到 10.6.1 版本也可将站点服务与您的门户结合使用。ArcGIS Server 先前版本中的服务可供 Portal for ArcGIS 10.6.1 使用。
• 如果与门户联合的 ArcGIS Server 站点包括多台计算机，则按顺序升级您的 GIS 服务器。 如果已使用 ArcGIS Server 站点配置 ArcGIS Web Adaptor（一个或多个），则还需要将 Web Adaptor 更新至与 ArcGIS Server 相同的版本。
• 如果无法更新当前 Web Adaptor，也可以在安装了先前版本的同一台计算机上安装 10.6.1 版本的 ArcGIS Web Adaptor (IIS)。例如，您可以保留 10.5 版本的 ArcGIS Web Adaptor (IIS)，并在同一 web 服务器上安装 10.6.1 版本。升级时，必须保留相同的 Web Adaptor 上下文。要执行此操作，将需要卸载当前使用门户配置的 Web Adaptor。然后，将通过之前使用的相同名称安装 10.6.1 Web Adaptor。请注意，无法在同一计算机上安装具有相同上下文的两个 Web Adaptor。

备份您的内容

如果您的门户托管服务器正在使用 ArcGIS Data Store，则在升级前对数据存储创建完整备份。

您还需针对为门户配置的任何自定义设置进行备份（例如在 config.js 中修改的属性）。

旧版本：

您需要事先备份证书 keystore (portal.ks)，其中包含您要导入至门户的证书。从 10.4.1 版本开始，不再需要进行此操作，门户 keystore 会在您更新时自动迁移。

• 如果已为先前版本的门户设置了大量自定义内容，则建议在另一台计算机上安装 10.6.1 版本并创建门户升级原型。
• 同时，必须对 Operations Dashboard 或 Web AppBuilder 的扩展模块进行备份。升级时不会保留您为这些客户端部署的任何扩展模块。一旦升级完成，您必须重新部署扩展模块。
• 而升级时会自动备份和保留您的内容、服务、站点信息和安全设置。进行升级时，会保留通过门户网站编辑的常规设置（例如向网站添加组织徽标和名称）。升级前不需要手动备份此信息。
• 为确保有足够的磁盘空间以便在升级期间支持自动备份，请确定分配给门户的 content、index、db、和 temp 目录的空间量。确保磁盘上的可用空间量至少为该数量的 2.5 倍。如果未达到，请向磁盘分配至少 2.5 倍的空间。门户升级需要这一可用空间来成功备份和升级您的门户内容、站点信息和安全设置。这些目录的默认位置是 C:\arcgisportal。
• 升级完成后，备份信息会保留在磁盘上。例如，您可以通过附加到目录结尾的 _10.<version number> 来了解此信息。建议您将此信息移至另一位置，以便节约磁盘空间。
• 此外，还建议您备份 arcgisportal 内容目录文件夹。如果升级时遇到问题且之后需要恢复成之前安装的版本，则可以应用此文件夹来恢复门户内容。

执行门户部署升级

警告：

升级期间，您的门户部署、任意已经与门户联合的 ArcGIS Server 站点、ArcGIS Data Store（如果使用）和 ArcGIS Pro（如果使用）均处于离线状态。

1. 备份以下信息：

   提示：

   您可以按照以下步骤手动备份站点，或者使用 webgisdr 实用工具来创建 ArcGIS Enterprise 部署的备份。为此，请按照以下步骤进行导出ArcGIS Enterprise。

   • 为门户配置的任何自定义信息，例如在 config.js 中修改的属性。如果已为先前版本的门户设置了大量自定义内容，则建议在另一台计算机上安装 10.6.1 版本并创建门户升级原型。
   • ArcGIS Data Store 托管数据库。有关运行备份的详细信息，请参阅升级 ArcGIS Data Store。
   • 您为 Operations Dashboard 或 Web AppBuilder 部署的任何扩展模块。升级时将不会保留这些内容，且在升级完成后必须重新对其进行部署。
   • 备份 ArcGIS Server 站点，以便在需要将该站点恢复为之前的版本时，可以导入和恢复该站点。
2. 确定分配给门户的 content、index、db 和 temp 目录的磁盘空间量。确保磁盘上的可用空间量至少为该数量的 2.5 倍。如果未达到，请向磁盘分配至少 2.5 倍的空间。门户升级需要这一可用空间来成功备份和升级您的门户内容、站点信息和安全设置。这些目录的默认位置是 C:\arcgisportal。 如果内容目录位于另一计算机上，该建议同样适用。

   注：

   升级完成后，备份信息会保留在磁盘上。例如，系统创建名为 upgrade-backup 的新文件夹，且新文件夹包含特定版本的，具有备份内容的文件夹。建议您将此信息移至另一位置，以便节约磁盘空间。

3. 登录到托管与门户结合使用的 Web Adaptor 的计算机并卸载 ArcGIS Web Adaptor。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的卸载主题。请确保在卸载 Web Adaptor 之前记下其上下文。
4. 启动 Portal for ArcGIS 安装程序 Setup.exe，并阅读欢迎界面及条款。准备就绪后请单击下一步继续。您还可以使用以下命令行参数来静默升级 Portal for ArcGIS：

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

5. 阅读并接受许可协议，如果不同意许可协议的条款，请退出。随即显示将要安装的功能。
6. 单击安装开始升级。不要中断安装过程。
7. 单击完成关闭安装向导。您需要使用一个新授权文件来为软件授权。门户网站会在浏览器窗口中打开。
8. 清除您的浏览器缓存（包括 cookie）。保留在缓存中的先前版本网站的信息可能会导致升级后的网站无法正常显示，并可导致您无法登录。建议您对所有将用于查看升级后的门户网站的浏览器执行清除缓存（包括 cookies）操作。
9. 单击继续门户升级按钮。这会触发升级，并创建门户内容、站点信息和安全设置的备份。完成此步骤需要花费几分钟的时间。
10. 打开 ArcGIS Portal Directory，并以初始管理员帐户进行登录。URL 地址格式为 https://portal.domain.com:7443/arcgis/portaladmin。
11. 目录页面将显示一条警告消息，表明您的计算机未完成升级。单击 Post Upgrade 操作。

注：

从 10.6 版本开始，您也可以使用 upgradeportal 命令行实用程序以静默方式完成升级和升级后操作。在命令行中，导航到您的 <Portal install directory>/tools/upgradeportal 文件夹并运行以下命令：upgradeportal.bat -s。要获得帮助，请使用 -h 或 --help 运行命令。
12. 单击 System > Indexer > Reindex。
13. 单击 Mode 下拉列表，然后选择 Full。
14. 单击 Reindex。完成此步骤后，门户即升级完毕。完成索引的重新构建可能会花费一些时间，具体取决于门户中的用户数量和内容体积。不要中断索引的重新构建过程。您可以打开新的浏览器窗口（或选项卡），导航至 System > Indexer > Index Status，然后刷新页面，以此来监控索引状态。当 store 与 index 计数相等时，即完成索引的重新构建以及升级。
15. 安装将与门户结合使用的 Web Adaptor。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的安装主题。确保使用的 Web Adaptor 上下文与之前版本中使用的相同。
16. 使用门户配置 ArcGIS Web Adaptor。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的配置主题。
17. 验证您是否能以组织管理员的身份通过 ArcGIS Web Adaptor URL 登录到门户网站。URL 地址格式为 https://webadaptorhost.domain.com/webadaptorname/home。
18. 以组织管理员的身份登录后，您就可以升级您的 ArcGIS Living Atlas of the World 内容。转至组织 > 编辑设置 > ArcGIS Online 在配置 Living Atlas 内容部分中，单击升级内容。在门户完成对 ArcGIS Online 内容的升级前，请勿关闭 ArcGIS Online 页面。单击保存返回到组织页面。如果您的门户没有配置访问 Living Atlas 内容，则无需进行此步骤。
19. 如果您已联合 ArcGIS Server 站点和门户，并且正在通过站点使用 ArcGIS Web Adaptor，则需登录正在托管 Web Adaptor 的计算机，然后卸载 Web Adaptor。记住 Web Adaptor 名称；重新安装时需要使用同一名称。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的卸载主题。
20. 如果您已联合 ArcGIS Server 站点和门户，则需将各站点升级到 10.6.1。不需要卸载和重新安装。需要在各个站点的每台 GIS 服务器计算机上运行安装程序。顺序（一个接一个）升级您的 GIS 服务器。有关完整说明，请参阅升级先前版本的 ArcGIS Server。
21. 服务器升级完成后，检查您是否可以访问 ArcGIS Server 服务目录的本地 URL。本地 URL 地址格式为 https://gisserver.domain.com:6443/arcgis/rest/services。
22. 如果您之前将 ArcGIS Web Adaptor 与 ArcGIS Server 结合使用，则需重新安装 ArcGIS Web Adaptor。使用在之前安装过程中为 Web Adaptor 指定的名称。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的安装主题。
23. 使用服务器配置 ArcGIS Web Adaptor。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的配置主题。如果您之前通过 Web Adaptor 启用了 ArcGIS Server 的管理权限，请确保再次将其启用。当联合门户与 ArcGIS Server 站点时，如果将 Web Adaptor URL 用于管理 URL，这一点尤其重要。
24. 验证是否可通过 ArcGIS Web Adaptor URL 访问 ArcGIS Server Services Directory。URL 地址格式为 https://webadaptorhost.domain.com/webadaptorname/rest/services。
25. 如果门户托管服务器使用 ArcGIS Data Store，则创建数据存储的备份，升级 ArcGIS Data Store，并重新配置数据存储以使用 ArcGIS Server。有关详细说明，请参阅升级 ArcGIS Data Store。
26. 如果您已使用组织配置 ArcGIS Pro 许可，则可以选择升级 ArcGIS License Server Administrator。升级 ArcGIS License Server Administrator 时，具有 ArcGIS Pro 许可的成员无法访问 ArcGIS Pro。如果成员当前登录到 ArcGIS Pro，将看到一则消息，提示程序将在二十四小时后关闭。成员可在这段时间中完成或保存其工作。升级 ArcGIS License Server Administrator 后无需重新配置 ArcGIS Pro 许可。
27. 恢复您之前为门户配置的所有自定义设置。在 10.6.1 版本中恢复门户自定义设置时，不要在 10.6.1 版本中替换您在先前版本中修改过的文件。这会对 10.6.1 的部署产生不利影响。您必须在 10.6.1 版本中打开每个文件，然后手动重新添加先前版本中的自定义行为。

    提示：

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

升级 Portal for ArcGIS 后的注意事项

升级完成后，您应当仔细阅读下列信息。

• 升级之后，门户网站无法正确显示、显示错误消息或无法登录。这是什么原因？
• 升级之后，没有显示我的门户中的所有项目、群组和用户。应该怎么办？
• 升级至 10.6.1 后，我的门户将不能再访问 Living Atlas 内容。
• 升级到 10.6.1 之后，系统显示我的所有成员均属于 2 级成员。我可以将其中一些成员更新为 1 级成员吗？
• 安装 10.6.1 版本后，在访问门户网站时看到软件授权错误，提示门户中已注册成员的数量超出门户被许可的最大数量。如何解决这一问题？
• 创建初始管理员帐户时出错。如何解决这一问题以完成升级？
• 升级后，我是否需要对实用程序服务执行相应操作？
• 我的门户是使用 ArcGIS Online 世界地理编码服务配置的。升级后是否需要重新配置？

升级之后，门户网站无法正确显示、显示错误消息或无法登录。这是怎么回事？

清除您的浏览器缓存（包括 cookie）。这些错误通常是由于浏览器中存在先前版本网站的缓存信息所导致的。如果仍无法登录，请确认您使用的是初始管理员帐户或具有门户管理权限的帐户。

升级之后，没有显示我的门户中的所有项目、群组和用户。应该怎么办？

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

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

1. 打开 ArcGIS Portal Directory，并以初始管理员帐户进行登录。URL 地址格式为 https://portal.domain.com:7443/arcgis/portaladmin。
2. 单击 System > Indexer > Index Status。
3. 刷新页面获取最新状态。

升级至 10.6.1 后，“我的门户”将不能再访问 Living Atlas 内容。

升级后，如果在您的门户中不能访问 Living Atlas 图层，则在此版本中，该项目可能已停用。选中停用项目更新列表的门户新特性主题。

如果订阅者或高级内容项目在升级后无法打开，请验证您是否已完成升级 Living Atlas 内容所需的步骤。

升级到 10.6.1 之后，显示我的所有成员均属于 2 级成员。我可以将其中一些成员更新为 1 级成员吗？

默认情况下，会将所有升级成员分配到成员级别 2 中的角色。门户管理员可以将成员（只要这些成员不拥有内容）更新为成员级别 1 中的角色，从而获得足够的成员资格。如果成员拥有内容，则门户管理员必须重新分配其内容，之后才能更改其成员级别。

我收到软件授权错误，提示门户中已注册成员的数量超出门户被许可的最大数量。如何解决这一问题？

在 Portal for ArcGIS 10.2.1 及更高版本中，门户的指定用户许可模式是强制的。您向门户中添加的成员数量将不能再多于当前许可的数量。使用版本 10.6.1 时，如果门户成员数量超出许可的最大数量，当具有管理权限的帐户访问门户网站时会显示软件授权错误消息。此外，用户将无法创建新的帐户，不具备管理权限的成员也将无法登录到门户。要了解关于如何解决这些问题的详细信息，请参阅指定用户许可的实施。

创建初始管理员帐户时出错。如何解决这一问题才能完成升级？

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

如果要从 10.3.1 进行升级且已使用门户配置 Survey123 for ArcGIS 或 Collector for ArcGIS，则需要联系 Esri 支持才能继续升级。

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

升级后，我是否需要对实用程序服务执行相应操作？

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

1. 升级完成后，请以拥有实用程序服务的用户身份登录到 ArcGIS Server Manager。
2. 在服务选项卡的管理服务部分中，单击实用程序文件夹。
3. 单击共享属性 图标。
4. 在随即打开的对话框中，单击保存。由此将更新 ArcGIS Enterprise 门户中的服务。
5. 以管理员身份登录到门户。在内容选项卡中，找到已更新的服务。单击共享。根据需要更新共享设置，然后单击确定。随即更新服务以及共享该服务的各个群组。
6. 针对每个适用服务重复上述步骤。

我的门户是使用 ArcGIS Online 世界地理编码服务配置的。升级后是否需要重新配置？

如果从版本 10.2.x 进行升级，将需要在门户中重新创建 ArcGIS Online 世界地理编码服务的代理项目。然后，将该项目配置为门户的地理编码器。从 10.3.1 开始，无需更新 ArcGIS Online 世界地理编码服务的代理项目。