关于升级 Portal for ArcGIS

注注:

本主题仅适用于 10.2.1 和更高版本。

本主题探讨了有关将 Portal for ArcGIS 部署升级到 10.2.2 的注意事项并解答了所遇到常见问题。在升级前,您应当仔细查看以下信息。

注注:

将 Portal for ArcGIS 10.2.1 升级到 10.2.2 时,不会保留启用或禁用自动创建帐户的设置;升级后将禁用自动创建帐户。这是不希望出现的行为,所以在今后的软件版本中将会得到解决。如果已在 10.2.1 版本中启用自动创建帐户,则您可在升级到 10.2.2 后立即重新启用此设置来解决此问题。有关完整说明,请参阅企业帐户的自动注册

常见注意事项

10.2 之前版本的 Portal for ArcGIS 用户

只能借助 Esri Professional Services 从 10.2 之前的版本迁移至 Portal for ArcGIS 10.2.2。

Portal for ArcGIS 10.2 用户

Portal for ArcGIS 10.2.2 安装程序可用于检测和升级 Portal for ArcGIS 的现有安装。有关完整说明,请参阅升级 Portal for ArcGIS。本部分的其余内容将解答关于升级到 Portal for ArcGIS 10.2.2 的常见问题。

常见问题

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

您的 Portal for ArcGIS 和 ArcGIS Web Adaptor 部署中可能还包括带有一个或多个 Web Adaptor 的联合 ArcGIS Server 站点。升级各软件组件的顺序取决于该软件是安装在单个计算机还是分散安装在多台计算机上。要了解联合 ArcGIS Server 站点如何使用 Portal for ArcGIS 的详细信息,请参阅有关将服务器与 Portal for ArcGIS 结合使用。

如果在非联合 ArcGIS Server 站点中将项目注册到门户,则不必将站点升级到 10.2.2 版本以将站点服务与您的门户结合使用。ArcGIS Server 先前版本中的服务可供 Portal for ArcGIS 10.2.2 使用。

如果所有的 ArcGIS 组件都安装在一台计算机上

如果您的部署安装在一台计算机上,则建议使用以下升级过程:

步骤:
  1. 停止您的门户和 GIS 服务器,方法为:访问 Windows 服务面板,然后手动停止 Portal for ArcGIS 和 ArcGIS Server 服务
  2. 备份您为门户配置的所有自定义设置(例如在 config.js 中修改的属性)以在门户网站中显示社交媒体链接、移除门户网站中的帐户登录页面或者禁止对门户内容使用 Web 搜索。如果已为先前版本的门户设置了大量自定义内容,则建议在另一台计算机上安装 10.2.2 版本并创建门户升级原型。
    注注:

    进行升级时,将保留您的服务、站点信息和安全设置,无需进行备份。进行升级时,也会保留通过门户网站编辑的常规设置(例如向网站添加组织徽标和名称)。

  3. 卸载 ArcGIS Web Adaptor。如果您的门户和服务器各具有一个 Web Adaptor,则将两者的 Web Adaptor 都卸载。有关详细说明,请参阅以下主题:
  4. 通过运行 Portal for ArcGIS 10.2.2 安装程序将 Portal for ArcGIS 升级到 10.2.2。不需要卸载和重新安装。安装程序会将现有门户升级到 10.2.2 版本,然后重新启动 Portal for ArcGIS 服务。完成升级可能会花费一些时间,具体取决于门户中的用户数量和内容体积。不要中断升级过程。有关完整说明,请参阅升级先前版本的 Portal for ArcGIS
    注注:

    如果门户的内容目录位于共享网络目录中,您需要执行一些额外的步骤才能升级并重新使用先前版本中的内容。有关完整说明,请参阅重新使用现有内容目录。在升级门户并将其配置为重新使用现有内容之后,继续执行以下步骤。

  5. 门户升级完成后,门户网站将在浏览器窗口中打开。此时,需清除浏览器缓存(包括 cookie)。保留在缓存中的先前版本网站的信息可能会导致网站无法正常显示并可导致您无法登录。建议您对所有将用于查看升级后的门户网站的浏览器执行清除缓存(包括 cookie)操作。
  6. 验证是否可使用具有管理员权限的帐户登录到门户网站。网站 URL 地址格式为 https://portal.domain.com:7443/arcgis/home。不要试图对您的门户使用 Web Adaptor URL;由于 Web Adaptor 已卸载,您将无法访问门户。
    注注:

    您可能会注意到联合站点的某些门户项目出现不可用或丢失元数据的情况。这是因为 ArcGIS Server 当前已停用。按以下步骤升级 ArcGIS Server 后,这些项目将可用。

  7. 安装将与门户结合使用的 Web Adaptor。有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的安装主题。
  8. 在门户中配置 Web Adaptor。有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的配置主题。
  9. 打开 ArcGIS Portal 目录,然后使用具有管理员权限的帐户登录。URL 地址格式为 https://portal.domain.com:7443/arcgis/portaladmin
  10. 单击系统 > 索引器 > 重新构建索引
  11. 单击模式下拉列表,然后选择完整
  12. 单击重新构建索引。完成索引的重新构建可能会花费一些时间,具体取决于门户中的用户数量和内容体积。不要中断索引的重新构建过程。您可以通过导航至系统 > 索引器 > 获取索引状态,然后刷新此页面来监控索引状态。当存储值与索引值相等时,即完成索引的重新构建。
  13. 验证是否可使用具有管理员权限的帐户通过 Web Adaptor URL 登录到门户网站。URL 地址格式为 https://webadaptor.domain.com/arcgis/home
  14. 将 ArcGIS for Server 升级到 10.2.2。不需要卸载和重新安装。安装程序会将现有服务器升级到 10.2.2 版本,然后重新启动 ArcGIS Server 服务。有关完整说明,请参阅升级先前版本的 ArcGIS for Server
  15. 服务器升级完成后,验证是否能够使用具有管理员权限的帐户登录到 ArcGIS Server 管理器。管理器 URL 地址格式为 http://gisserver.domain.com:6080/arcgis/manager
  16. 如果您之前将 Web Adaptor 与 ArcGIS Server 结合使用,则需重新安装 Web Adaptor。有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的安装主题。
  17. 在服务器中配置 Web Adaptor。有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的配置主题。
  18. 验证是否可通过 Web Adaptor URL 访问 ArcGIS Server 服务目录。URL 地址格式为 http://webadaptor.domain.com/arcgis/rest/services
  19. 恢复您之前为门户配置的所有自定义设置。在 10.2.2 版本中恢复自定义设置时,建议不要在 10.2.2 中替换您在先前版本中修改过的文件。这可能会对 10.2.2 的部署产生不利影响。你需要在 10.2.2 版本中打开每个文件,然后手动重新添加先前版本中的自定义行为。

如果 ArcGIS 组件安装在多台计算机上

如果您的部署安装在多台计算机上,则建议使用以下升级过程:

步骤:
  1. 登录到托管 Portal for ArcGIS 的计算机,然后停止门户,方法为:访问 Windows 服务面板并手动停止 Portal for ArcGIS 服务
  2. 备份您为门户配置的所有自定义设置(例如在 config.js 中修改的属性)以在门户网站中显示社交媒体链接、移除门户网站中的帐户登录页面或者禁止对门户内容使用 Web 搜索。如果已为先前版本的门户设置了大量自定义内容,则建议在另一台计算机上安装 10.2.2 版本并创建门户升级原型。
    注注:

    进行升级时,将保留您的服务、站点信息和安全设置,无需进行备份。进行升级时,也会保留通过门户网站编辑的常规设置(例如向网站添加组织徽标和名称)。

  3. 登录到托管与门户结合使用的 Web Adaptor 的计算机并卸载 Web Adaptor。有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的卸载主题。
  4. 通过运行 Portal for ArcGIS 10.2.2 安装程序将 Portal for ArcGIS 升级到 10.2.2。不需要卸载和重新安装。安装程序会将现有门户升级到 10.2.2 版本,然后重新启动 Portal for ArcGIS 服务。完成升级可能会花费一些时间,具体取决于门户中的用户数量和内容体积。不要中断升级过程。有关完整说明,请参阅升级先前版本的 Portal for ArcGIS
    注注:

    如果门户的内容目录位于共享网络目录中,您需要执行一些额外的步骤才能升级并重新使用先前版本中的内容。有关完整说明,请参阅重新使用现有内容目录。在升级门户并将其配置为重新使用现有内容之后,继续执行以下步骤。

  5. 门户升级完成后,门户网站将在浏览器窗口中打开。此时,需清除浏览器缓存(包括 cookie)。保留在缓存中的先前版本网站的信息可能会导致网站无法正常显示并可导致您无法登录。建议您对所有将用于查看升级后的门户网站的浏览器执行清除缓存(包括 cookie)操作。
  6. 验证是否可使用具有管理员权限的帐户登录到门户网站。网站 URL 地址格式为 https://portal.domain.com:7443/arcgis/home。不要试图对您的门户使用 Web Adaptor URL;由于 Web Adaptor 已卸载,您将无法访问门户。
    注注:

    您可能会注意到联合站点的某些门户项目出现不可用或丢失元数据的情况。这是因为 ArcGIS Server 当前已停用。按以下步骤升级 ArcGIS Server 后,这些项目将可用。

  7. 安装将与门户结合使用的 Web Adaptor。有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的安装主题。
  8. 在门户中配置 Web Adaptor。有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的配置主题。
  9. 打开 ArcGIS Portal 目录,然后使用具有管理员权限的帐户登录。URL 地址格式为 https://portal.domain.com:7443/arcgis/portaladmin
  10. 单击系统 > 索引器 > 重新构建索引
  11. 单击模式下拉列表,然后选择完整
  12. 单击重新构建索引。完成索引的重新构建可能会花费一些时间,具体取决于门户中的用户数量和内容体积。不要中断索引的重新构建过程。您可以通过导航至系统 > 索引器 > 获取索引状态,然后刷新此页面来监控索引状态。当存储值与索引值相等时,即完成索引的重新构建。
  13. 验证是否可使用具有管理员权限的帐户通过 Web Adaptor URL 登录到门户网站。URL 地址格式为 https://webadaptor.domain.com/arcgis/home
  14. 登录到托管 ArcGIS Server 的计算机,然后停止服务器,方法为:访问 Windows 服务面板并手动停止 ArcGIS Server 服务
  15. 如果将 Web Adaptor 与服务器结合使用,则登录到托管 Web Adaptor 的计算机,然后卸载 Web Adaptor。有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的卸载主题。
  16. 将 ArcGIS for Server 升级到 10.2.2。不需要卸载和重新安装。安装程序会将现有服务器升级到 10.2.2 版本,然后重新启动 ArcGIS Server 服务。有关完整说明,请参阅升级先前版本的 ArcGIS for Server
  17. 服务器升级完成后,验证是否能够使用具有管理员权限的帐户登录到 ArcGIS Server 管理器。管理器 URL 地址格式为 http://gisserver.domain.com:6080/arcgis/manager
  18. 如果您之前将 Web Adaptor 与 ArcGIS Server 结合使用,则需重新安装 Web Adaptor。有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的安装主题。
  19. 在服务器中配置 Web Adaptor。有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的配置主题。
  20. 验证是否可通过 Web Adaptor URL 访问 ArcGIS Server 服务目录。URL 地址格式为 http://webadaptor.domain.com/arcgis/rest/services
  21. 恢复您之前为门户配置的所有自定义设置。在 10.2.2 版本中恢复自定义设置时,建议不要在 10.2.2 中替换您在先前版本中修改过的文件。这可能会对 10.2.2 的部署产生不利影响。你需要在 10.2.2 版本中打开每个文件,然后手动重新添加先前版本中的自定义行为。

升级到 10.2.2 之后,门户网站无法正确显示或者显示一条错误消息。这是怎么回事?

升级到 10.2.2 之后,如果发现门户网站无法正确显示或者在浏览器中显示一条错误消息,您可能需要清除浏览器缓存(包括 cookie)。如果清除浏览器缓存无法解决此问题,请查看本主题中的其他常见问题。

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

升级到 10.2.2 之后,如果发现门户中所有的项目、组和用户均不可用,您可能需要为门户重新构建索引。有关完整说明,请参阅关于将我的 Portal for ArcGIS 部署升级到 10.2.2 版本的顺序是什么?的问题解答

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

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

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

不需要。如果您已经安装了先前版本的 Portal for ArcGIS,安装程序会自动将其升级到 10.2.2 版本。如果未在计算机上安装先前版本的 Portal for ArcGIS,也可以直接安装 Portal for ArcGIS 10.2.2。

升级到 10.2.2 时是否需要重新授权?

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

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

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

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

有关完整的说明,请参阅以下主题:

如果已将 ArcGIS Server 与门户联合,是否可以继续结合使用联合的 ArcGIS 10.2 for Server 或 ArcGIS 10.2.1 for Server 站点和 Portal for ArcGIS 10.2.2?

不可以。为使门户部署能够正常运行,门户与 ArcGIS Server 的版本必须相同。如果与门户联合的 ArcGIS Server 站点包含多台计算机,则可以同时升级或依次升级您的 GIS 服务器。如果已使用 ArcGIS Server 站点配置 ArcGIS Web Adaptor,则还需要将 Web Adaptor 更新至与 ArcGIS Server 相同的版本。

在安装 Portal for ArcGIS 10.2.2 后,我无法登录到门户网站。我该怎样做?

如果您在安装最新软件更新后登录门户网站时遇到此问题,则可能需要清理浏览器缓存(包括 cookie)才能登录。这通常是由于浏览器中存在先前版本网站的信息所导致的。在清理浏览器缓存(包括 cookie)前,确保使用具有门户管理权限的帐户登录。

如果我的内容目录位于共享网络目录中,如何升级 Portal for ArcGIS

如果门户的内容目录位于共享网络目录中,您将无法在升级时对其进行指定。这是因为 Portal for ArcGIS 服务默认配置为在 Windows 本地的“本地系统”帐户下运行。“本地系统”帐户不能访问网络位置。

但是您可以在完成升级后将门户配置为使用现有内容目录。有关完整说明,请参阅重新使用现有内容目录

如果已升级 Portal for ArcGIS 并创建了初始管理员帐户,您需要执行以下步骤以重新使用先前版本中的内容。

步骤:
  1. 在 Windows 中,转至控制面板 > 管理工具并打开服务
  2. 在服务列表中,右键单击 Portal for ArcGIS 并选择属性
  3. 常规选项卡中,单击停止
  4. 单击登录选项卡,然后选择该帐户:在登录帐户中作为选项。
  5. 输入您想使用的帐户名和密码。可以单击浏览,从选择用户对话框中指定想要使用的帐户。您所选择的帐户必须对存储现有内容的共享网络目录具有完全控制权限。指定帐户名和密码后,单击应用
  6. 授予 Portal for ArcGIS 帐户对门户安装目录的完全控制权限。默认位置为 C:\Program Files\ArcGIS\Portal
  7. 在文本编辑器中打开文件 <Portal for ArcGIS installation directory>\framework\etc\portal-config.properties
  8. dir.data 属性设置为先前版本内容所属共享网络目录的路径。使用正斜线 (/) 作为目录分隔符(例如:data.dir=//portaldev/arcgisportal).
  9. 从文件中移除以下属性:
    dir.content = C:\\arcgisportal\\content
    dir.index = C:\\arcgisportal\\index
    dir.db = C:\\arcgisportal\\db
    dir.tmp = C:\\arcgisportal\\temp
    dir.logs = C:\\arcgisportal\\logs
    
  10. 保存文件并关闭文本编辑器。
  11. 浏览至 <Portal for ArcGIS installation directory>\framework\etc 目录,然后删除 config-store-connection.json 文件。
  12. 在 Windows 服务控制台中,单击常规选项卡,然后启动 Portal for ArcGIS 服务。
  13. 打开浏览器窗口,然后清除浏览器缓存(包括 cookie)。
  14. 停留在浏览器窗口中,输入门户网站的 URL,然后单击登录。URL 地址格式为 https://portal.domain.com:7443/arcgis/home
  15. 指定初始管理员帐户的用户名、密码、电子邮件以及身份验证问题与答案,然后单击创建。创建帐户可能会花费一些时间,具体取决于门户中的用户数量和内容体积。不要中断帐户创建过程。
  16. 打开 ArcGIS Portal 目录,然后使用具有管理员权限的帐户登录。URL 地址格式为 https://portal.domain.com:7443/arcgis/portaladmin
  17. 单击系统 > 索引器 > 重新构建索引
  18. 单击模式下拉列表,然后选择完整
  19. 单击重新构建索引。完成索引的重新构建可能会花费一些时间,具体取决于门户中的用户数量和内容体积。不要中断索引的重新构建过程。您可以通过导航至系统 > 索引器 > 获取索引状态,然后刷新此页面来监控索引状态。当存储值与索引值相等时,即完成索引的重新构建。

您的门户现在正在使用共享网络目录中的现有内容。如果您尚未执行此操作,建议在门户中安装并配置 ArcGIS Web Adaptor。有关详细说明,请参阅 IISJava (Windows)Java (Linux) 的安装主题。

5/10/2014