升级 Portal for ArcGIS

在本主题中

升级 Portal for ArcGIS 前的注意事项
执行门户部署升级的步骤
升级 Portal for ArcGIS 后的注意事项

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

本主题介绍：

Considerations before upgrading Portal for ArcGIS
执行门户部署升级到 10.3.1 的步骤
升级 Portal for ArcGIS 后的注意事项

升级 Portal for ArcGIS 前的注意事项

升级之前，应仔细考虑下列问题。

我可以直接升级到 Portal for ArcGIS 10.3.1 吗？

可以。例如，如果您已安装了 10.2.1 版本，运行 10.3.1 安装程序会自动升级 10.3.1。无需获取并安装每个发行版本来升级至 10.3.1 。

在安装 Portal for ArcGIS 10.3.1 前是否需要卸载先前版本的 Portal for ArcGIS？

不需要，但您可以卸载。如果您安装了先前版本的 Portal for ArcGIS，安装程序会自动将其升级至 10.3.1。安装程序结束运行后，您可以创建初始管理员帐户来完成升级。如果您先卸载之前的版本，然后安装 10.3.1，则上述行为同样适用。

将我的 Portal for ArcGIS 部署升级到 10.3.1 版本的顺序是什么？

将您的部署升级到 10.3.1 时不必遵循特定顺序，除非部署包括 ArcGIS Data Store。在这种情况下，必须在升级数据存储之前升级 ArcGIS Server。

需要考虑的重要一点是：在升级过程中您的门户将处于离线状态。如果您的部署中包括一个已联合的 ArcGIS Server 站点，则在升级过程中，您的门户与联合站点均处于离线状态。

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

升级到 10.3.1 后是否需要重新授权？

不需要。系统将保留先前的授权并重新配置以供 10.3.1 版本使用。

完成升级需要多长时间？

完成升级所需的时间取决于门户所包含的内容以及注册帐户的数量。例如，在含有 8 个内核的计算机上运行 Portal for ArcGIS 的小型组织（包含数百个用户及内容项目）可能需要花费 50 分钟来升级。而在含有 8 个内核的计算机上运行 Portal for ArcGIS 的大型组织（包含数万个用户及内容项目）可能需要花费 3 个小时来升级。

完成升级所需的时间还取决于您所部署的组件和自定义设置的数量。例如，如果您使用组织配置 ArcGIS Pro 许可，并具有多个联合的 ArcGIS Server 站点和 ArcGIS Data Store，或者您的门户是高度自定义的门户，则升级所需的时间要长于部署 Portal for ArcGIS 和一个联合 ArcGIS Server 的时间。

执行升级前是否需要备份信息？

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

您还需要备份为门户配置的自定义设置（例如在 config.js 中修改的属性）以及包含已导入门户的证书的证书 keystore (C:\Program Files\ArcGIS\Portal\etc\ssl\portal.ks)。如果已为先前版本的门户设置了大量自定义内容，则建议在另一台计算机上安装 10.3.1 版本并创建门户升级原型。

而升级时会自动备份和保留您的内容、服务、站点信息和安全设置。进行升级时，会保留通过门户网站编辑的常规设置（例如向网站添加组织徽标和名称）。升级前不需要手动备份此信息。

为确保有足够的磁盘空间以便在升级期间支持自动备份，请确定分配给门户的 content、index、db、和 temp 目录的空间量。确保磁盘上的可用空间量至少为该数量的 2.5 倍。如果未达到，请向磁盘分配至少 2.5 倍的空间。门户升级需要这一可用空间来成功备份和升级您的门户内容、站点信息和安全设置。这些目录的默认位置是 C:\arcgisportal。如果内容目录位于另一计算机上，该建议同样适用。

升级完成后，备份信息会保留在磁盘上。例如，您可以通过附加到目录结尾的 _10.<version number> 来了解此信息。建议您将此信息移至另一位置，以便节约磁盘空间。

ArcGIS Web Adaptor 和 Portal for ArcGIS 产品版本需要保持同步吗？

需要。您无法将先前版本的 ArcGIS Web Adaptor 配置为与 Portal for ArcGIS 10.3.1 一起使用。Web Adaptor 的版本必须始终匹配 Portal for ArcGIS 的安装版本。

如果无法更新当前 Web Adaptor，也可以在安装了先前版本的同一台计算机上安装 10.3.1 版本的 ArcGIS Web Adaptor。例如，您可以保留 10.1 SP1 版本的 ArcGIS Web Adaptor，并在同一 web 服务器上安装 10.3.1 版本。

有关完整的说明，请参阅以下主题：

如果已联合 ArcGIS Server 和门户，在升级门户时是否需要升级 ArcGIS Server？

是的。为使门户部署能够正常运行，门户与 ArcGIS Server 的版本必须相同。如果与门户联合的 ArcGIS Server 站点包括多台计算机，则连续升级您的 GIS 服务器。如果已使用 ArcGIS Server 站点配置 ArcGIS Web Adaptor（一个或多个），则还需要将 Web Adaptor 更新至与 ArcGIS Server 相同的版本。

如果已联合 ArcGIS Server 和门户，升级前是否需要取消联合?

不需要。强烈推荐您在升级门户部署时不要取消联合。执行此操作将对门户部署产生不利影响。例如，取消联合时虽然所有托管服务项仍保留在门户中，但将会断开与 ArcGIS Server 中的服务的连接。这就意味着各成员将无法访问、共享、或使用门户中的服务。此外，联合过程导入的所有现有 ArcGIS Server 服务将从门户中移除，并且不再可用。

如果托管服务器使用 ArcGIS Data Store，升级门户时是否需要升级数据存储？

是的。您的门户、ArcGIS Server 和 ArcGIS Data Store 版本必须相同。在升级过程中，始终先升级 ArcGIS Server，然后升级配置时使用的 ArcGIS Data Store。

如上所述，如果与门户联合的 ArcGIS Server 站点包括多台计算机，则连续升级您的 GIS 服务器。如果已使用 ArcGIS Server 站点配置 ArcGIS Web Adaptor（一个或多个），则还需要将 Web Adaptor 更新至与 ArcGIS Server 相同的版本。

如果已经使用组织配置 ArcGIS Pro 许可，升级门户时是否需要升级 ArcGIS Pro 或 ArcGIS License Server Administrator？

不需要。较早版本的 ArcGIS Pro 和 ArcGIS License Server Administrator 与 10.3.1 兼容。但是，为了能够利用新功能和修复缺陷，强烈建议您升级 ArcGIS Pro 和 ArcGIS License Server Administrator。升级 Portal for ArcGIS、ArcGIS License Server Administrator 或 ArcGIS Pro 后无需重新配置 ArcGIS Pro 许可。

升级 Portal for ArcGIS 或 ArcGIS License Server Administrator 时，每次升级期间，具有 ArcGIS Pro 许可的成员均无法访问 ArcGIS Pro。如果成员当前登录到 ArcGIS Pro，将看到一则消息，提示由于 ArcGIS Pro 无法连接到许可门户，程序将在二十四小时后关闭。成员可在这段时间中完成或保存其工作。

我已配置高可用性门户，如何升级我的配置？

如果您已配置高可用性门户，则需要遵循非常具体的步骤来完成升级。配置高可用性门户主题中对这些步骤进行概述。升级门户配置之后，可按如下所述继续升级组织中其余的 ArcGIS 组件。

升级门户前还需要考虑哪些事项？

如果已更改 Portal for ArcGIS 帐户，则需要在升级时执行一些额外步骤。这是因为 Portal for ArcGIS 服务已配置为升级完成后在 Windows 本地的“本地系统”帐户下运行。以下升级步骤包括配置已升级门户以使用现有帐户的完整说明。
如果您移动门户内容目录至一个共享的网络目录，则需要在升级时执行一些额外步骤。以下升级步骤包括配置已升级门户以使用现有内容目录的完整说明。
如果已将门户索引、db 或临时目录移动至一个共享的网络目录，则需要在执行升级之前将其移回本地目录。Portal for ArcGIS 不支持这些位于网络共享中的目录；它们必须存储在门户计算机本地。以下升级步骤包括将这些目录移回本地目录的完整说明。
如果您发布了基于可配置应用程序模板的应用程序，则需检查应用程序模板是否已停用。您对门户进行了升级后，停用的可配置应用程序模板无法正常运行或显示。您将需要使用新的应用程序模板重新创建这些应用程序。请注意，如果您使用的是几个版本之前的门户，则需要检查每个版本中的停用模板。例如，如果您从 Portal for ArcGIS 10.2 升级，则需要检查 10.2 版本到当前版本之间所有版本的已停用模板列表。

执行门户部署升级的步骤

警告：

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

备份以下信息：
- 为门户配置的任何自定义信息，例如在 config.js 中修改的属性。如果已为先前版本的门户设置了大量自定义内容，则建议在另一台计算机上安装 10.3.1 版本并创建门户升级原型。
- 包括已导入到门户中的证书的证书 keystore。keystore (portal.ks) 位于安装目录中（例如 C:\Program Files\ArcGIS\Portal\etc\ssl）。记下分配给证书的别名。升级完成后，门户将使用其默认的自签名证书；您需要重新配置门户才能使用现有证书。
- ArcGIS Data Store 托管数据库。使用 backupdatastore 为包含托管要素图层数据的数据库创建完整备份，并将备份文件放在远程安全计算机或介质中。
如果门户的 index、db 和 temp 目录均位于共享的网络目录上，请将其复制到本地目录并配置门户，以便使用更新后的目录位置。如果这些目录已位于门户本地，则跳过此步骤。
1. 在 Windows 中，转至控制面板 > 管理工具并打开服务。
2. 在服务列表中，右键单击 Portal for ArcGIS 并选择属性。
3. 在常规选项卡中，单击停止。
4. 将 index、db 和 temp 复制到门户计算机的本地目录（例如，C:\portaldirectories\）。
5. 授予 Portal for ArcGIS 帐户对目录的完全控制级别权限。
6. 在常规选项卡中，单击启动。
7. 以组织管理员的身份登录到 ArcGIS Portal Directory。URL 格式为 https://webadaptor.domain.com/arcgis/portaladmin。
8. 单击系统 > 目录。
9. 单击 index、db 和 temp 目录链接，然后单击编辑目录分别对其进行更新，以使用本地目录位置。每次编辑目录位置均会重新启动门户。
10. 在系统 > 目录下分别单击 index、db 和 temp 目录链接，以验证新的文件路径是否正在使用中。
  现在，您的门户可以使用新的位置。此外，您还可以删除旧目录或重新命名旧目录。
确定分配给门户的 content、index、db 和 temp 目录的磁盘空间量。确保磁盘上的可用空间量至少为该数量的 2.5 倍。如果未达到，请向磁盘分配至少 2.5 倍的空间。门户升级需要这一可用空间来成功备份和升级您的门户内容、站点信息和安全设置。这些目录的默认位置是 C:\arcgisportal。如果内容目录位于另一计算机上，该建议同样适用。
注:
升级完成后，备份信息会保留在磁盘上。例如，您可以通过附加到目录结尾的 _10.<version number> 来了解此信息。建议您将此信息移至另一位置，以便节约磁盘空间。
登录到托管与门户结合使用的 Web Adaptor 的计算机并卸载 ArcGIS Web Adaptor。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的卸载主题。
启动 Portal for ArcGIS 安装程序 Setup.exe，并阅读欢迎界面及条款。准备就绪后请单击下一步继续。您还可以使用以下命令行参数来静默升级 Portal for ArcGIS：
<path to Portal for ArcGIS setup download>\setup.exe /qb
阅读并接受许可协议，如果不同意许可协议的条款，请退出。随即显示将要安装的功能。
单击安装开始升级。不要中断安装过程。
单击完成关闭安装向导。随即在浏览器窗口中打开门户网站。
在先前版本的 Portal for ArcGIS 中，如果在安装软件后更改 Portal for ArcGIS 帐户或将门户内容移至共享的网络目录，则需执行下列步骤：
1. 在门户计算机上，转至控制面板 > 管理工具并打开服务。
2. 在服务列表中，右键单击 Portal for ArcGIS 并选择属性。
3. 在常规选项卡中，单击停止。
4. 单击登录选项卡并从登录选项中选择此帐户。
5. 输入您想使用的帐户名和密码。在大多数情况下，该帐户是您更改之前安装的内容目录时指定的帐户。可以单击浏览，从选择用户对话框中指定想要使用的帐户。您所选择的帐户必须对存储现有内容的共享网络目录具有完全控制权限。指定帐户名和密码后，单击应用。
6. 授予帐户对门户安装目录的完全控制权限（目录默认位置为 C:\Program Files\ArcGIS\Portal）。
7. 在 Windows 服务控制台中，单击常规选项卡，然后启动 Portal for ArcGIS 服务。
清除您的浏览器缓存（包括 cookie）。保留在缓存中的先前版本网站的信息可能会导致升级后的网站无法正常显示，并可导致您无法登录。建议您对所有将用于查看升级后的门户网站的浏览器执行清除缓存（包括 cookies）操作。
指定初始管理员帐户的用户名、密码、电子邮件以及身份验证问题与答案，然后单击创建。这会触发升级，并创建门户内容、站点信息和安全设置的备份。完成此步骤需要花费几分钟的时间。
注:
您为初始管理员帐户输入的信息无须与您在门户的先前版本中指定的帐户信息相匹配。如果输入了新的信息，此步骤会创建一个新帐户，而且现有的初始管理员帐户也会被保留。如果您输入的帐户信息与先前版本中的帐户信息相同，则现有帐户将被用作初始管理员。
打开 ArcGIS Portal Directory，以初始管理员帐户登录。URL 地址格式为 https://portal.domain.com:7443/arcgis/portaladmin。
单击系统 > 索引器 > 重新构建索引。
单击模式下拉列表，然后选择完整。
单击重新构建索引。完成此步骤后，门户即升级完毕。完成索引的重新构建可能会花费一些时间，具体取决于门户中的用户数量和内容体积。不要中断索引的重新构建过程。您可以打开新的浏览器窗口（或选项卡），导航至系统 > 索引器 > 索引状态，然后刷新页面，以此来监控索引状态。当存储与索引计数相等时，即完成索引的重新构建以及升级。
安装将与门户结合使用的 Web Adaptor。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的安装主题。
在门户中配置 ArcGIS Web Adaptor。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的配置主题。
验证您是否能以组织管理员的身份通过 ArcGIS Web Adaptor URL 登录到门户网站。URL 地址格式为 https://webadaptor.domain.com/arcgis/home。
如果您已联合 ArcGIS Server 站点和门户，并且正在通过站点使用 ArcGIS Web Adaptor，则需登录正在托管 Web Adaptor 的计算机，然后卸载 Web Adaptor。记住 Web Adaptor 名称；重新安装时需要使用同一名称。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的卸载主题。
如果您已联合 ArcGIS Server 站点和门户，则需将各站点升级到 10.3.1。不需要卸载和重新安装。需要在各个站点的每台 GIS 服务器计算机上运行安装程序。连续升级您的 GIS 服务器（背对背）。有关完整说明，请参阅升级先前版本的 ArcGIS for Server。
服务器升级完成后，检查您是否可以访问 ArcGIS Server 服务目录的本地 URL。本地 URL 地址格式为 https://gisserver.domain.com:6443/arcgis/rest/services。
如果您之前将 ArcGIS Web Adaptor 与 ArcGIS Server 结合使用，则需重新安装 ArcGIS Web Adaptor。使用在之前安装过程中为 Web Adaptor 指定的名称。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的安装主题。
在服务器中配置 ArcGIS Web Adaptor。有关详细说明，请参阅 IIS、Java (Windows) 或 Java (Linux) 的配置主题。
验证是否可通过 ArcGIS Web Adaptor URL 访问 ArcGIS Server 服务目录。URL 地址格式为 https://webadaptor.domain.com/arcgis/rest/services。
如果门户托管服务器使用 ArcGIS Data Store，则创建数据存储的备份，升级 ArcGIS Data Store，并重新配置数据存储以使用 ArcGIS Server。有关详细说明，请参阅升级 ArcGIS Data Store。
如果您已使用组织配置 ArcGIS Pro 许可，则可以选择升级 ArcGIS License Server Administrator。升级 ArcGIS License Server Administrator 时，具有 ArcGIS Pro 许可的成员无法访问 ArcGIS Pro。如果成员当前登录到 ArcGIS Pro，将看到一则消息，提示程序将在二十四小时后关闭。成员可在这段时间中完成或保存其工作。升级 ArcGIS License Server Administrator 后无需重新配置 ArcGIS Pro 许可。
恢复您之前为门户配置的所有自定义设置。在 10.3.1 版本中恢复门户自定义设置时，建议不要在 10.3.1 中替换您在先前版本中修改过的文件。这可能会对 10.3.1 的部署产生不利影响。你需要在 10.3.1 版本中打开每个文件，然后手动重新添加先前版本中的自定义行为。
恢复包括先前导入门户的证书在内的证书 keystore (portal.ks)。
1. 复制已备份的 portal.ks，浏览到 <Portal for ArcGIS installation directory>\etc\ssl，然后用已备份的副本替换文件。
2. 还可通过组织管理员的身份登录到 ArcGIS Portal Directory来配置门户，以便使用现有 keystore 中的证书。URL 格式为 https://webadaptor.domain.com/arcgis/portaladmin。
3. 单击安全性 > SSLCertificates > 更新。
4. 输入分配给证书的别名，然后单击更新。

升级 Portal for ArcGIS 后的注意事项

升级完成后，应仔细考虑下列问题。

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

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

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

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

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

打开 ArcGIS Portal Directory，以初始管理员帐户登录。URL 地址格式为 https://portal.domain.com:7443/arcgis/portaladmin。
单击系统 > 索引器 > 索引状态。
刷新页面获取最新状态。

安装 10.3.1 版本后，在访问门户网站时看到软件授权错误，提示门户中已注册成员的数量超出门户被许可的最大数量。如何解决这一问题？

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

升级门户并尝试创建初始管理员帐户时，收到消息创建初始管理员帐户时出错。如何解决这一问题才能完成升级？

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

通过门户启用了 Operations Dashboard；升级之后是否需要进行更新？

是的。如果您之前创建了引用 Operations Dashboard 的项目，或是您已将应用程序部署到门户，则需要在升级门户后更新该项目并重新部署该应用程序。有关完整说明，请参阅升级 Operations Dashboard for ArcGIS。

有关此主题的反馈?