升级 Portal for ArcGIS—ArcGIS Enterprise

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

准备升级

升级之前，请仔细查看以下信息：

升级概念

完成升级所需的时间取决于门户所包含的内容、注册帐户的数量以及您部署的组件和自定义内容数量。
所有基础 ArcGIS Enterprise 组件的版本必须相同。
您无需同时升级 ArcGIS Pro 和 ArcGIS Enterprise。
如果与门户联合的 ArcGIS Server 站点包括多台计算机，则将按顺序升级您的 GIS 服务器。
如果您的门户当前处于只读模式，请在运行升级前关闭此模式。
如果无法更新当前 Web Adaptor，也可以在安装了先前版本的同一台计算机上安装 11.1 版本的 ArcGIS Web Adaptor (IIS)。例如，您可以保留 10.5 版本的 ArcGIS Web Adaptor (IIS)，并在同一 web 服务器上安装 11.1 版本。升级时，必须保留相同的 Web Adaptor 上下文。为此，请卸载当前使用门户配置的 Web Adaptor，然后安装具有以前使用的相同名称的 11.1 Web Adaptor。请注意，无法在同一计算机上安装具有相同上下文的两个 Web Adaptor。

许可

如果要升级到 11.1，您需要从 My Esri 获取新的门户许可文件，并重新授权软件。

注：

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

版本详细信息

不支持从 10.6.1 版本或较早版本直接升级到 Portal for ArcGIS 11.1。要升级 Portal for ArcGIS 10.6.1 或更低版本，首先将其升级到过渡版本 (10.7.x - 10.9.x)，然后将该版本升级到 11.1。阅读有关临时版本的升级文档，以确认您开始使用的 Portal for ArcGIS 版本支持直接升级。
如果您正在使用 10.7 或更高版本，运行 Portal for ArcGIS 11.1 安装程序会自动将门户升级到 11.1。无需按序获取和安装先前发布的各版本，也无需卸载 Portal for ArcGIS 的先前版本。
从低于 11.1 的 ArcGIS Enterprise 版本升级的组织可能仍可以使用旧版本主页设置。但是，作为升级过程的一部分，主页会自动更新为现代、移动友好型主页体验，其中包括项目库、链接以及自定义颜色和字体。如果您需要更多时间来设置组织的现代化主页，可以切换回使用原有主页或参考原有主页来定制现代化主页。请注意，在此版本后将不再提供对旧版本主页和设置的支持。
将 10.7 之前的 Portal for ArcGIS 版本升级到过渡版本 (10.7.x - 10.9.x) 后，将禁用自动帐户创建。要允许新用户创建自己的内置帐户，您必须为新成员设置默认的用户类型和角色并启用自动帐户创建。这些设置将保留在以后的升级中。
从安装了 Map Viewer Beta 的 10.8.1 或 10.9 部署升级到 Portal for ArcGIS 11.1 时，Map Viewer Beta 将在升级过程中自动卸载。新的 Map Viewer（之前称为 Map Viewer Beta）与 Map Viewer 经典版一起包含在 11.1 中。
自 10.8.1 版本起，管理联系人列表用于发送自动电子邮件通知，前提是已为您的组织配置电子邮件设置。如果未设置任何管理联系人，则组织中最早的管理员帐户或“初始管理员帐户”会收到相关的电子邮件通知。
如果要从 10.8 版本升级到 10.8.1 或更高版本，并且已配置了信息通栏，则必须通过高级站点设置启用通栏，以让您的信息标题显示在使用 ArcGIS Enterprise Sites 创建的站点上。从 10.8 版本升级并启用此设置后，它将保留以供将来升级。

内容

如果在非联合 ArcGIS Server 站点中将项目注册到门户，则无需将此 ArcGIS Server 站点升级到 11.1 版本也可将站点服务与您的门户结合使用。 ArcGIS Server 先前版本中的服务可供 Portal for ArcGIS 11.1 使用。
如果您创建了自定义底图或者可配置应用程序群组，并将 Esri 底图或 ArcGIS Configurable Apps 共享至该群组，则在进行升级之后，必须再次将这些项目共享至该群组。
如果使用地图或应用程序中的 ArcGIS Living Atlas of the World 内容，请在升级前确认您使用的项目未处于成熟支持或已弃用状态。在每个版本中，一些 ArcGIS Living Atlas 内容已停用并且不再可用。如果您使用其中一个项目，则升级后该项目将无法正常运行。有关此版本停用的 ArcGIS Living Atlas 内容列表，请参阅 ArcGIS Living Atlas 内容生命周期和更新。

应用程序

如果您发布了基于 ArcGIS Configurable Apps 模板的应用程序，则需检查应用程序模板是否已停用。将门户升级到 11.0 后，停用的可配置应用程序模板将无法运行。您将需要使用 ArcGIS Instant Apps、ArcGIS StoryMaps、ArcGIS Experience Builder、ArcGIS Web AppBuilder 或 ArcGIS Dashboards 重新创建这些应用程序。请注意，如果您使用的是几个版本之前的门户，则需要分别在Portal 中的新特性中检查每个版本中的停用模板。例如，如果您从 Portal for ArcGIS 10.7 升级，则需要检查 10.7 版本到当前版本之间所有版本的已停用模板列表。
如果您的门户配置了 Esri 应用程序，请确保升级后您的版本与 11.1 门户兼容。
如果您配置了 ArcGIS Insights，则无需在升级 ArcGIS Enterprise 之前将其卸载。如果要升级 ArcGIS Enterprise 和 ArcGIS Insights，建议先完成 ArcGIS Enterprise 升级，包括升级后步骤，然后再升级 ArcGIS Insights。
如果您对门户配置了 ArcGIS Navigator 移动地图包，则需要在将门户升级到 11.1 后重新配置它们。

高可用性门户

如果您配置了高可用性门户，则需要遵循具体的步骤来完成升级。这些步骤将在配置高可用性门户中进行概述。

注：

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

备份您的内容

在升级之前，创建使用门户的托管服务器配置的每种类型的 ArcGIS Data Store 的完整备份。

如果通过修改 config.js 文件中的属性配置了高级门户选项，则还需要创建文件的备份。在升级到 11.0 后，您可以使用备份文件作为参考，通过 ArcGIS Portal Directory（Sharing API）自定义门户的行为。

旧版本：

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

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

ArcGIS Enterprise 升级顺序

升级 ArcGIS Enterprise 部署中的组件的推荐顺序如下：

升级 Portal for ArcGIS。
升级 ArcGIS Web Adaptor（针对 Portal for ArcGIS）。
升级作为门户托管服务器的 ArcGIS Server 站点。
升级 ArcGIS Web Adaptor（针对 ArcGIS Server）。
升级 ArcGIS Data Store。
如果您的 ArcGIS Enterprise 部署中包括这些组件，请升级联合站点。
大多数联合服务器必须与基础 ArcGIS Enterprise 部署的版本相匹配。有关联合服务器支持版本的信息，请参阅将 ArcGIS Server 与门户联合。
有关升级所需的联合服务器类型，请参阅升级信息。

执行门户部署升级

警告：

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

备份以下信息：
提示：
您可以按照以下步骤备份站点，也可使用 webgisdr 实用程序来创建 ArcGIS Enterprise 部署的备份。为此，请按照以下步骤导出 ArcGIS Enterprise。
- 如果通过修改文件中的属性配置了高级门户选项，请导出 config.js 文件。您可以使用备份文件作为参考，在升级后通过 ArcGIS Portal Directory（Sharing API）自定义门户的行为。如果已为先前版本的门户设置了大量自定义内容，则建议在另一台计算机上安装 11.1 版本并创建门户升级原型。
- 通过 ArcGIS Data Store 部署的所有数据存储。有关运行备份的详细信息，请参阅升级 ArcGIS Data Store。
- 您已为 Dashboards 或 Web AppBuilder 部署的任何扩展模块。升级时将不会保留这些内容，且在升级完成后必须重新对其进行部署。
- 备份 ArcGIS Server 站点，以便在需要将该站点恢复为之前的版本时，可以导入和恢复该站点。
确定分配给门户的 content、index、db 和 temp 目录的磁盘空间量。确保磁盘上的可用空间量至少为该数量的 2.5 倍。如果未达到，请向磁盘分配至少 2.5 倍的空间。门户升级需要这一可用空间来成功备份和升级您的门户内容、站点信息和安全性设置。这些目录的默认位置是 <Portal for ArcGIS installation directory>/arcgisportal。如果内容目录位于另一计算机上，该建议同样适用。
注：
升级完成后，备份信息会保留在磁盘上。例如，系统创建名为 upgrade-backup 的新文件夹，且新文件夹包含特定版本的、具有备份内容的文件夹。建议您将此信息移至另一位置，以便节约磁盘空间。
登录到托管与门户结合使用的 ArcGIS Web Adaptor 的计算机并卸载 ArcGIS Web Adaptor。有关完整说明，请参阅 Java (Linux) 的卸载主题。请确保在卸载 Web Adaptor 之前记下其上下文。
在命令提示符中，以安装现有门户所用的用户身份来启动 Portal for ArcGIS 安装脚本（例如 <CD ROOT or untar directory>/Setup）。在启动此脚本之前，您无需停止 Portal for ArcGIS。
提示：
要从 Portal for ArcGIS 安装介质启动安装脚本，请单击安装脚本，然后选择在终端中运行按钮。

安装程序会检测目标计算机中 Portal for ArcGIS 的现有版本，然后提示您继续还是退出升级。请参阅以下示例：

=========================================================================
Portal for ArcGIS 11.1 (Linux)
=========================================================================

Your Portal for ArcGIS 10.7 is installed at:

/home/ags/arcgis/portal

Confirm Settings
=========================================================================
Product to upgrade:             Portal for ArcGIS 10.7 (Linux)
Location to upgrade:            /home/ags/arcgis/portal

Your Portal for ArcGIS 10.7 will be stopped when performing the 
upgrade and Portal for ArcGIS 11.1 
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):

键入 y 并按 Enter 键以接受检测到的设置，并继续升级操作。您必须使用一个新的 .json 授权文件来为软件授权。门户升级完成后，门户网站会在浏览器窗口中打开。
清除您的浏览器缓存（包括 cookie）。保留在缓存中的先前版本网站的信息可能会导致升级后的网站无法正常显示，并可导致您无法登录。建议您对所有将用于查看升级后的门户网站的浏览器执行清除缓存（包括 cookies）操作。
在导入许可文件页面中，浏览至您的门户许可文件 (.json)。此文件可从 My Esri 获取并包含门户的用户和应用程序许可信息。单击继续门户升级。这会触发升级，并创建门户内容、站点信息和安全设置的备份。完成此步骤需要花费几分钟的时间。
注：
您在升级过程中输入的许可文件将用于许可门户的用户和应用程序。请确保新许可文件适用于您的当前用户和应用程序配置。
如果您正在相同版本中进行升级，系统将不会提示您导入新的许可文件。升级完成后，您可以随时导入新的许可文件。

注：

您也可以使用 upgradeportal 命令行实用程序以静默方式完成升级和升级后操作。在命令行中，导航到您的 <Portal install directory>/tools/upgradeportal 文件夹并运行以下命令：upgradeportal.sh -lf <path to portal json file> -s。要获得帮助，请使用 -h 或 --help 运行命令。您也可以使用 ArcGIS Portal Administrator API 中的升级操作升级 Portal for ArcGIS。有关升级操作的详细信息，请参阅 ArcGIS Portal Admin API 帮助中的升级文档。

安装将与门户结合使用的 Web Adaptor。有关完整说明，请参阅 Java (Linux) 的安装主题。确保使用的 Web Adaptor 上下文与之前版本中使用的相同。
通过门户配置 ArcGIS Web Adaptor。有关完整说明，请参阅 Java (Linux) 的配置主题。
注：
如果存在，如果系统属性中没有设置 WebContextURL，则在重新注册到门户时应使用 DNS 别名来访问 WA。
验证您是否能以组织管理员的身份通过 ArcGIS Web Adaptor URL 登录到门户。 URL 地址格式为 https://webadaptorhost.domain.com/webadaptorname/home。
注：
- 如果您收到需要完成升级后步骤的通知，则必须在消息对话框中单击确定以完成所需的升级后步骤。其中包括升级 ArcGIS Living Atlas of the World 内容、重新索引内容以及更新高可用性门户中门户计算机之间的关联。
- 升级后，如果在登录到门户时收到有关许可的通知，则您可能未导入符合当前许可配置的许可文件，或者可能为您的用户分配了临时用户类型。有关详细信息，请参阅升级 Portal for ArcGIS 后的注意事项。
如果您已联合 ArcGIS Server 站点和门户，并且正在通过站点使用 ArcGIS Web Adaptor，则需登录正在托管 Web Adaptor 的计算机，然后卸载 Web Adaptor。记住 Web Adaptor 名称；重新安装时需要使用同一名称。有关完整说明，请参阅 Java (Linux) 的卸载主题。
如果您已联合 ArcGIS Server 站点和门户，则需将各站点升级到 11.1。不需要卸载和重新安装。需要在各个站点的每台 ArcGIS Server 计算机上运行安装程序。顺序（一个接一个）升级您的 ArcGIS Server 站点。有关完整说明，请参阅升级先前版本的 ArcGIS Server。
如果您的门户联合了多个站点，请先升级门户的托管服务器，它位于部署中其他服务器站点之前。
服务器升级完成后，检查您是否可以访问 ArcGIS REST 服务目录的本地 URL。本地 URL 地址格式为 https://gisserver.domain.com:6443/arcgis/rest/services。
如果您之前将 ArcGIS Web Adaptor 和 ArcGIS Server 配合使用，请重新安装 ArcGIS Web Adaptor。使用在之前安装过程中为 Web Adaptor 指定的名称。有关完整说明，请参阅 JavaLinux) 安装主题。
通过服务器配置 ArcGIS Web Adaptor。有关完整说明，请参阅 Java (Linux) 配置主题。如果您之前通过 Web Adaptor 启用了 ArcGIS Server 的管理权限，请确保再次将其启用。当联合门户与 ArcGIS Server 站点时，如果将 Web Adaptor URL 用于管理 URL，则这一点尤其重要。
验证是否可以通过 ArcGIS Web Adaptor URL 访问 ArcGIS REST 服务目录。 URL 地址格式为 https://webadaptorhost.domain.com/webadaptorname/rest/services。
如果门户托管服务器使用 ArcGIS Data Store，则创建数据存储的备份，升级 ArcGIS Data Store，并重新配置数据存储以使用 ArcGIS Server。有关具体说明，请参阅升级 ArcGIS Data Store。
如果您为组织配置了 ArcGIS Pro 或 Drone2Map 许可，则可以选择升级 ArcGIS License Server Administrator。升级 ArcGIS License Server Administrator 时，具有 ArcGIS Pro 许可的成员无法访问 ArcGIS Pro。如果成员当前登录到 ArcGIS Pro，将看到一则消息，提示程序将在 24 小时后关闭。成员可在这段时间中完成或保存其工作。您必须将已导入到门户的相同许可文件 (.json) 导入到 ArcGIS License Server Administrator。
恢复您之前为门户配置的所有自定义设置。在 11.1 版本中恢复门户自定义设置时，不要在 11.1 版本中替换您在先前版本中修改过的文件。这可能会对 11.1 的部署产生不利影响。您必须在 11.1 版本中打开每个文件，然后手动重新添加先前版本中的自定义行为。
提示：
Esri 建议使用 portalScan.py 脚本来检查升级后的 ArcGIS Enterprise 门户的安全性最佳做法。
如果您要在 Scene Viewer 中使用完整的 3D 符号系统集，还必须安装 Web 样式安装程序。有关其他信息，请参阅 Scene Viewer 要求。

升级后的注意事项

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

升级之后，门户无法正确显示或无法登录。这是什么原因？

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

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

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

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

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

升级至 11.1 后，在我的门户中不能再访问 ArcGIS Living Atlas 内容。

升级后，如果在您的门户中不能访问 ArcGIS Living Atlas 图层，则在此版本中，该项目可能已停用。请检查 ArcGIS Living Atlas 内容生命周期并进行更新以获取停用项目的更新列表。

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

升级后，自动帐户创建失败，并提示软件授权错误。

如果将 10.7 之前的版本升级到过渡版本 (10.7.x - 10.9.x)，将禁用自动帐户创建。升级完成后，您需要为新成员分配默认用户类型和角色，然后在 ArcGIS Portal Administrator Directory 中启用自动帐户创建。自 10.8 起，新成员的默认用户类型和角色可以在门户的组织设置中设置，也可以在 ArcGIS Portal Directory 中使用门户自助资源中的 setUserDefaultSettings 操作进行设置。

当我登录到门户时，我会收到一条通知，指示“分配的许可数量超过可用许可数量。分配了这些许可的成员可能无法访问该门户。有关详细信息，请转到“许可”选项卡”。如何解决这一问题？

当管理员登录到门户并且门户的许可处于透支状态时，将向管理员显示此通知。已分配用户类型或加载项许可的用户数量超过可用许可数量。

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

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

如果在创建初始管理员帐户时收到此错误，则门户日志中的信息可帮助您解决这一问题。通常，如果创建帐户时网络连接暂时丢失，则可能会发生此错误。要访问日志，请浏览至日志目录并打开最近的日志文件（例如，<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/）。

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

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

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

我的门户配置有 ArcGIS World Geocoding Service。升级后是否需要重新配置？

如果从 10.2.x 版本进行升级，则需要在 ArcGIS World Geocoding Service 门户中重新创建代理项目。然后，将该项目配置为门户的地理编码器。自 10.3.1 版本起，您无需将代理项目更新为 ArcGIS World Geocoding Service。

我的 ArcGIS Enterprise 门户配置有路径服务。升级后是否需要重新配置？

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

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

以默认管理员身份或者具有正确管理门户设置权限的自定义角色身份登录。
在站点顶部，单击组织，然后单击设置。
单击页面左侧的实用程序服务。
单击页面右侧的方向和路径。
单击更新路径服务按钮并选择我要发布的网络数据集。
根据此处的步骤，使用网络数据集配置路径服务。

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

有关此主题的反馈?