升级 ArcGIS Data Store

ArcGIS Data Store 已注册到您设置为 ArcGIS Enterprise 部署的托管服务器的 GIS Server 站点。 必须将此部署中的所有组件升级到同一版本。

准备升级 ArcGIS Data Store

在升级 ArcGIS Data Store 之前，请仔细查看以下信息，并完成所有必需操作：

• 阅读 ArcGIS Data Store 11.5 系统要求以确保您的硬件满足当前要求。
• 有关支持和功能变更的信息，请阅读 ArcGIS Data Store 11.5 中的新特性。
• 不支持从 10.7 或 10.7.1 版本直接升级到 ArcGIS Data Store 11.5。 要升级 ArcGIS Data Store 10.7 或 10.7.1，请首先升级至过渡版本 (10.8.x - 11.3)，然后将该版本升级至 11.5。 阅读有关临时版本的升级文档，以确认您开始使用的 ArcGIS Data Store 版本支持直接升级。
• 不支持从 10.6.1 版本或更低版本直接升级到 ArcGIS Data Store 11.5。 要升级 ArcGIS Data Store 10.6.1 或更低版本，请首先升级至过渡版本 (10.8.x 或 10.9.x)，然后将该版本升级至 11.5。 阅读有关临时版本的升级文档，以确认您开始使用的 ArcGIS Data Store 版本支持直接升级。
• 在升级关系数据存储或切片缓存数据存储之前，请检查每台计算机上 ArcGIS Data Store 目录的大小。 请确保计算机的磁盘空间足够容纳 ArcGIS Data Store 目录的两倍大小。
• 在升级之前，请确认所有必需端口均可用。

  注：

  不同版本之间的端口要求可能会有所不同。 如果您未打开必需端口，则 web 图层可能无法访问数据。

• 如果切片缓存数据存储在主备用模式下运行，请确保备用计算机在升级之前有权访问默认备份位置。 如果无权访问，则在升级后，切片缓存数据存储不会拥有默认备份位置，而您将需要配置一个位置。
• 如果要升级 10.8.1 时空大数据存储，请检查 ArcGIS Enterprise 部署是否包含使用正方形或六边形聚合的 ArcGIS GeoEvent Server 地图服务。 如果包含，您必须在升级时空大数据存储后完成其他步骤以修正渲染问题。
• 以集群模式部署的 ArcGIS Data Store 11.5 对象存储必须至少包含三台计算机。 当您将集群式 10.9 对象存储升级到 11.5 时，可能需要在升级后向对象存储中添加一台计算机。
• 创建部署中所有数据存储的备份，然后将备份文件存储在远程安全位置。
• 下载最新的 ArcGIS Data Store、Portal for ArcGIS、ArcGIS Server 和 ArcGIS Web Adaptor 软件安装文件，请访问 My Esri。 您还可以从 My Esri 下载 Portal for ArcGIS 和 ArcGIS Server 的 11.5 授权文件。

  基本 ArcGIS Enterprise 部署的所有组件必须为相同的软件版本。

• ArcGIS Data Store 始终用作 ArcGIS Enterprise 部署的一部分，因此在升级 ArcGIS Data Store 之前，您必须升级该部署的某些组件。 在升级 ArcGIS Data Store 之前，请阅读下一部分，并对必需的 ArcGIS Enterprise 组件进行升级。

ArcGIS Enterprise 升级顺序

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

1. 升级 Portal for ArcGIS。
2. 针对 IIS 或 Java (Windows) 升级 ArcGIS Web Adaptor（适用于 Portal for ArcGIS）。
3. 升级作为门户托管服务器的 ArcGIS Server 站点。
4. 针对 IIS 或 Java (Windows) 升级 ArcGIS Web Adaptor（适用于 ArcGIS Server）。
5. 升级 ArcGIS Data Store。
6. 如果您的 ArcGIS Enterprise 部署中包括这些组件，请升级联合站点。

   大多数联合服务器必须与基础 ArcGIS Enterprise 部署的版本相匹配。 有关联合服务器支持版本的信息，请参阅将 ArcGIS Server 与门户联合。

   有关升级所需的联合服务器类型，请参阅升级信息。

   • ArcGIS GIS Server 或 ArcGIS Image Server 站点
   • ArcGIS GeoEvent Server
   • ArcGIS Notebook Server
   • ArcGIS Mission Server
   • ArcGIS Workflow Manager
   • ArcGIS Knowledge Server

升级 ArcGIS Data Store

具有安装文件和备份文件，并已升级托管服务器后，请完成针对每种类型数据存储的升级步骤。 注册到同一 ArcGIS Server 站点的所有数据存储必须运行相同的 ArcGIS Data Store 版本。 在升级 ArcGIS Data Store 时，请记住以下几点：

• 在重新配置数据存储之前，务必在数据存储类型的所有计算机上安装 ArcGIS Data Store。
• 开始安装新版本之前，不要卸载 ArcGIS Data Store。

  运行 11.5 ArcGIS Data Store 安装程序会自动将 ArcGIS Data Store 10.8 或更高版本的部署升级到 11.5。 无需按序获取并安装之前的每个发行版本。

• 如果关系数据存储或切片缓存数据存储中具有主计算机和备用计算机，请在主计算机和备用计算机上安装新版本 ArcGIS Data Store，然后通过其中一台计算机重新配置数据存储。
• 自 11.5 版本起，不再支持图谱存储的主备用模式。 从 11.2、11.3 或 11.4 升级在主备用模式下运行的图谱存储会将其置于单实例模式。 如果图谱数据存储中具有主计算机和备用计算机，请在主计算机和备用计算机上安装新版本 ArcGIS Data Store，然后重新配置其中一台计算机。 确保为图谱存储配置了默认备份位置，然后可以使用 configuredatastore 实用程序重新添加第二台计算机，并在升级后向图谱存储添加第三台计算机。

  注：

  当从 10.9.1、11.0 或 11.1 升级图谱存储时，其已经处于单实例模式。

• 如果已使用托管服务器站点配置多个切片缓存数据存储、时空大数据存储或对象存储计算机，请在集群中的每台数据存储计算机上安装新版本的 ArcGIS Data Store。 在集群中的所有计算机上安装新版本后，您可以重新配置数据存储。
• 如果成员已发布托管场景图层，但您尚未在 ArcGIS Enterprise 部署中包含对象存储，则需要配置对象存储。 现在，发布托管场景图层需要对象存储。 同时需要发布托管 3D 切片图层。

  虽然切片缓存数据存储中具有缓存的现有托管场景图层将继续正常运行，但在此版本中，必须将托管场景图层缓存迁移至对象存储。 在托管服务器的管理员开始迁移现有托管场景图层的缓存之前，需要创建已升级切片缓存数据存储的备份。

  迁移并测试所有托管场景图层缓存后，可以运行 disabledatastore 实用程序以取消注册切片缓存数据存储并删除其内容。

您可以通过运行 Setup.exe 程序使用交互式向导驱动体验升级，还可以通过命令提示符或脚本运行 Setup.exe 和 configuredatastore 实用程序来静默升级 ArcGIS Data Store。 无论使用哪种方法，Setup.exe 安装文件都会检测并更新 ArcGIS Data Store 的现有安装。

注：

升级 ArcGIS Data Store 时，将重新启动 ArcGIS Data Store 服务。

使用交互式向导驱动的体验升级

完成以上准备升级 ArcGIS Data Store 部分中概述的步骤，并且在升级 ArcGIS Data Store 之前对必须升级的 ArcGIS Enterprise 组件进行升级后，请按照以下步骤使用交互式向导升级数据存储： 要改为使用命令进行升级，请继续下一部分。

注：

数据存储配置向导可用于升级图谱存储的一台计算机，但要配置另外两台图谱存储机器以集群模式部署，则必须使用 configuredatastore 实用程序。

1. 如果您正在将时空大数据存储与 ArcGIS GeoEvent Server 一起使用，请登录 ArcGIS GeoEvent Manager 并停止用于归档数据的要素服务。
2. 在每台数据存储计算机上更新 ArcGIS Data Store 安装。

   要更新安装，请在数据存储中包含的配置了相同托管服务器的每台计算机上运行 ArcGIS Data Store Setup.exe 程序。

   注：

   不要卸载现有 ArcGIS Data Store 安装。

   当您安装 ArcGIS Data Store 以从 10.9.1 或更早版本升级时，将安装所有数据存储类型（关系、切片缓存、对象、图谱和时空大数据存储）。如果已在 Microsoft Windows 上安装了 ArcGIS Data Store，则升级后，即可移除从未配置且不需要的数据存储类型。

3. 安装过程中，请阅读并接受许可协议，如果不同意许可协议中的条款，请退出。

   如果您接受许可协议，ArcGIS Data Store 安装程序将显示要安装的功能。

在 ArcGIS Data Store 输入框中会预填充现有安装使用的账户。
4. 提供账户密码。

   通常，此密码是您在安装软件时所定义的密码。 如果密码在安装软件之后进行过更改，则必须提供在更改账户时所设置的密码。 如果密码无效，则会显示表明该密码无效的错误消息。 如果不确定账户密码，请与系统管理员联系。

警告：

安装程序完成后，它将在默认浏览器中自动打开数据存储配置向导。 在每台数据存储计算机上安装相同版本的 ArcGIS Data Store 之前，不要继续进行配置。

5. 在所有数据存储计算机上更新 ArcGIS Data Store 安装之后，请打开支持的 Web 浏览器并清除浏览器缓存（包括 cookie）。
6. 运行数据存储配置向导配置每种类型的数据存储以完成升级。

   数据存储配置向导 URL 的格式为 https://datastoremachine.example.com:2443/arcgis/datastore。

   运行数据存储配置向导的次数取决于您的配置。

   • 对于在主备用模式下运行的关系数据存储或切片缓存数据存储，请从数据存储配置向导连接至主计算机或备用计算机。 完成向导中的步骤会同时升级两台计算机上的数据存储。
   • 对于在主备用模式下运行的图谱存储，请从数据存储配置向导连接其中一台计算机并对其进行升级。 由此将升级该计算机上的图谱存储并将其设置为单实例模式。 此外，还将取消注册其他计算机上的图谱存储并从该计算机上删除重复的图谱数据。 为了保持高可用性，请按照本页底部附近的升级后任务中的向已升级图谱存储添加计算机部分所述来配置图谱存储集群。
   • 如果一台计算机上存在多种数据存储，仅需运行一次数据存储配置向导即可升级该计算机上的所有数据存储。
   • 对于切片存储（集群模式）和时空大数据存储，请从数据存储配置向导连接至任意集群切片缓存或时空大数据存储计算机。 完成向导中的步骤升级该数据存储中的所有计算机。

步骤 7 到 10 将引导您完成数据存储配置向导。
7. 在向导的第一页上，提供托管服务器的 URL 和托管服务器的 ArcGIS Server 管理员的用户名和密码，然后单击下一步。
   ArcGIS Data Store 会检查注册到此托管服务器的每个数据存储的每台计算机，验证它们是否满足以下先决条件：

   • 与此托管服务器关联的数据存储中的所有计算机均已安装相同版本的 ArcGIS Data Store。
   • 与此托管服务器关联的数据存储中的所有计算机均可访问。
   • 托管服务器可访问。

   如果未满足上述任意先决条件，则这些条件会显示在每种数据存储类型的状态内的先决条件检查页面中。 继续进行升级之前，必须修正所有问题。

   满足所有先决条件后，先决条件检查页面会显示要升级的每个数据存储。

8. 单击下一步重新配置具有此托管服务器的那些数据存储，然后完成升级。

   配置完成时，将显示升级状态页面。

   对于成功升级的每个数据存储，都会在状态字段中显示成功。 对于高可用性关系或切片缓存（主备模式）数据存储，系统会同时显示两台计算机的状态。

9. 成功升级所有数据存储计算机后，单击下一步继续转至配置状态页面。

   可以关闭数据存储配置向导。

   如果其中任一升级未成功，该数据存储或计算机即会显示失败状态，并会显示相关消息帮您解决问题。

10. 如果适用，请修正问题并再次运行数据存储配置向导以升级之前失败的计算机。
11. 如果您拥有时空大数据存储，请确认其显示的状态为正常运行。

    要确定数据存储的状态，请登录到托管服务器的 ArcGIS Server Administrator Directory，然后运行 validate REST 命令。

使用命令进行升级

除了运行安装程序之外，您也可以在命令提示符处或在批处理脚本中运行 Setup.exe 文件以更新 ArcGIS Data Store。 为避免收到继续升级的提示，请在静默模式下运行该命令。 为此，请在脚本中包含 /qb 参数。

完成以上准备升级 ArcGIS Data Store 部分中概述的步骤，并且在升级 ArcGIS Data Store 之前对必须升级的 ArcGIS Enterprise 组件进行升级后，请在数据存储中的每台计算机上运行 ArcGIS Data Store 安装程序文件以安装新的软件版本。 接下来，在每个要升级的数据存储计算机上运行 configuredatastore 实用程序。

1. 如果您正在将时空大数据存储与 ArcGIS GeoEvent Server 一起使用，请登录 ArcGIS GeoEvent Manager 并停止用于归档数据的要素服务。
2. 在每台数据存储计算机上更新 ArcGIS Data Store 安装。

   从数据存储中每台计算机的命令提示符或脚本中运行 Setup.exe 文件。 例如，如果您有一个高可用性关系数据存储（两台计算机）和一个包括三台计算机的高可用性时空大数据存储，请在继续进行配置前在全部五台计算机上运行 Setup.exe 文件。

   注：

   不要卸载现有 ArcGIS Data Store 安装。

   当您安装 ArcGIS Data Store 以从 10.9.1 或更早版本升级时，将安装所有数据存储类型（关系、切片缓存、对象、图谱和时空大数据存储）。如果已在 Microsoft Windows 上安装了 ArcGIS Data Store，则升级后，即可移除从未配置且不需要的数据存储类型。

   在静默模式下使用 Setup.exe 进行升级时，必须指定 ArcGIS Data Store 账户。 通常，此账户是您在安装软件时所定义的账户。 如果账户在安装软件之后进行过更改，则需要输入在修改 ArcGIS Data Store 账户时指定的用户名和密码。

   如果您未指定 ArcGIS Data Store 账户，或者指定的账户与您当前安装使用的账户不匹配，则安装过程将显示一条消息，提示无法验证凭据，并且安装将关闭。

   在以下以静默模式运行命令的示例中，软件所使用的账户是 myaccount：

   <path to ArcGIS Data Store setup download folder>\Setup.exe /qb USER_NAME=myaccount PASSWORD=mypassword ACCEPTEULA=yes

   例如，要使用域账户（如 mydomain\myaccount）和密码 4myI.s0nly 运行命令，请输入以下信息：

   \\machinename\mydownloadfolder\Setup.exe /qb USER_NAME=mydomain\myaccount PASSWORD=4myI.s0nly ACCEPTEULA=yes

   警告：

   命令行参数区分大小写。 确认大小写与示例中显示的属性相匹配。

在数据存储中的每台计算机上安装 ArcGIS Data Store 的新版本后，重新配置每种类型的数据存储来完成升级。
3. 使用 configuredatastore 实用程序，利用升级之前的同一个 GIS Server 站点重新配置数据存储。

   您必须以管理员的身份在安装有 ArcGIS Data Store 的计算机上运行命令提示符。

   configuredatastore 实用程序的运行位置和次数取决于您的配置。

   • 对于在主备用模式下运行的关系数据存储和切片缓存数据存储，请以安装 ArcGIS Data Store 的用户身份登录到主计算机或备用计算机，然后运行 configuredatastore 实用程序。 这会同时升级主计算机和备用计算机上的数据存储。
   • 对于以主-备用模式运行的图谱存储，请以安装 ArcGIS Data Store 的用户身份登录到其中一台图谱存储计算机，然后运行 configuredatastore 实用程序。 由此将升级该计算机上的图谱存储并将其设置为单实例模式。 此外，还将取消注册其他计算机上的图谱存储并从该计算机上删除重复的图谱数据。 为了保持高可用性，请按照本页底部附近的升级后任务中的向已升级图谱存储添加计算机部分所述来配置图谱存储集群。
   • 当一台计算机上存在多种数据存储类型时，您可以在运行 configuredatastore 实用程序时使用 --stores 参数来指定要升级的数据存储。
   • 对于在集群模式下运行的数据存储，请以安装 ArcGIS Data Store 的用户身份登录到任何计算机，然后运行 configuredatastore 实用程序。 这会升级该集群数据存储中的所有计算机。

   在本例中，configuredatastore 实用程序在同时运行关系和切片缓存数据存储的主计算机上运行。 两个数据存储均配置有 GIS Server 站点 https://myserver.example.com:6443/arcgis：

   configuredatastore https://myserver.example.com:6443/arcgis serveradmin MyAdminPassword C:\arcgisdatastore --stores relational,tilecache

   在本例中，configuredatastore 实用程序在配置有 GIS Server 站点 https://gisserver.example.com:6443/arcgis 的时空大数据存储中的其中一台计算机上运行：

   configuredatastore https://gisserver.example.com:6443/arcgis serveradmin MyAdminPassword C:\arcgisdatastore --stores spatiotemporal

   运行 configuredatastore 实用程序将会重新启动数据存储中所有计算机上的 ArcGIS Data Store。

   升级之前，ArcGIS Data Store 会确认数据存储中的所有计算机是否均已安装相同版本的 ArcGIS Data Store，以及是否所有计算机均可访问。 任何一台计算机没有更新或不可访问时，ArcGIS Data Store 都无法继续升级程序。 修正安装或网络问题，然后再次运行 configuredatastore 实用程序。

4. 如果您拥有时空大数据存储，请确认其显示的状态为 healthy。

   要确定数据存储的状态，请登录到托管服务器的 ArcGIS Server Administrator Directory，然后运行 validate REST 命令。

5. 如果 ArcGIS Enterprise 门户已联合 ArcGIS GeoEvent Server、ArcGIS Mission Server 或 ArcGIS Knowledge Server 站点，请升级这些站点。

   升级联合站点后，请确认站点上运行的服务正常运行。

升级后任务

升级部署中的所有 ArcGIS Data Store 类型后，请执行以下操作：

• 验证所有数据存储是否均可访问。
• 检查托管 web 图层以确保其正在运行。
• 如果从 10.8.1 升级了时空大数据存储，并且 ArcGIS Enterprise 部署包含使用正方形或六边形聚合的 ArcGIS GeoEvent Server 地图服务，请按照说明更正地图服务渲染问题。
• 如果从 11.4 或更低版本升级了主备用图谱存储并且需要图谱存储集群，请按照说明向升级后的图谱存储添加计算机。
• 创建所有数据存储的备份。
• 移除不再需要的临时文件。

下方的最后一部分包括从 10.8.1 升级时空大数据存储后必须完成的步骤，如果 ArcGIS Enterprise 部署包括使用正方形或六边形聚合的 ArcGIS GeoEvent Server 地图服务。

验证数据存储

您可登录到 ArcGIS Server Manager 来验证您的 GIS Server 站点是否仍可与每个数据存储进行通信。

按照以下步骤通过 ArcGIS Server Manager 验证数据存储：

1. 登录到 ArcGIS Server Manager。

   您用于登录的账户必须为发布者或管理员角色的成员。

2. 转至站点 > 数据存储。
3. 选中欲验证数据存储旁的复选框。 (ArcGIS_Data_Store)。
4. 单击验证。

如果数据存储正在运行并且 GIS Server 站点可以与其通信，则状态列中将显示一个绿色复选标记。

检查托管 web 图层状态

确保托管 web 服务在升级后仍能正常运行。

1. 登录到 ArcGIS Server Manager。

   您用于登录的账户必须为发布者或管理员角色的成员。

2. 转至服务 > 托管。
3. 确认所有服务正在运行。

修正 ArcGIS GeoEvent Server 地图服务渲染问题

要修正由 BUG-000139639 引起的渲染问题，如果您的 ArcGIS GeoEvent Server 地图服务配置为使用正方形或六边形聚合，则必须在从 10.8.1 升级后在时空大数据存储上运行 upgradedatasource 实用程序。

1. 在命令行窗口中，打开时空大数据存储中任意计算机上的 ArcGIS Data Store 工具目录。

   您必须以 Windows 管理员身份打开窗口。

2. 运行 listdatasources 实用程序以列出 GeoEvent Server 地图服务。

   listdatasources.bat

3. 运行 upgradedatasource 实用程序。

   地图服务的源正在升级时，地图服务无法访问。 您可以在运行 upgradedatasource 实用程序时指定地图服务的名称，以便一次只影响一个服务。 或者，您可以不使用任何名称的情况下运行 upgradedatasource 实用程序，所有服务都将升级。 然而，这意味着在所有服务升级完成之前，所有服务均无法访问。

   在此示例中，所有 GeoEvent Server 地图服务都已升级：

   upgradedatasource.bat

   在本示例中，仅升级一个服务，即 deliveryroutes：

   upgradedatasource.bat deliveryroutes

完成这些步骤后，验证时空大数据存储。

向已升级图谱存储添加计算机

当将图谱存储从 11.4 或更低版本升级至 11.5 时，升级后的图谱存储将处于单实例模式。 如果升级在主备用模式下运行的 11.2、11.3 或 11.4 图谱存储，则升级会将模式更改为单实例模式，并且仅一台计算机仍然可用。 要维持高可用性，请配置图谱存储集群。

一个集群必须包含三台计算机。 可以使用现有（虽然未注册的）第二台计算机作为集群中的第二台计算机，因为您已经在其上安装了最新版本 ArcGIS Data Store。 可以使用与升级后的图谱存储计算机相同的托管服务器对其进行配置。 接下来，在第三台计算机上安装 ArcGIS Data Store 并将其配置为与其他两台图谱存储计算机在同一托管服务器上注册的图谱存储。

警告：

如果您使用 ArcGIS Enterprise Cloud Builder for Microsoft Azure 或任何 Amazon Web Services 部署工具上的 ArcGIS Enterprise 创建了部署，请勿使用这些说明。 相反，请按照 Microsoft Azure 上的 ArcGIS Enterprise 和 Amazon Web Services 上的 ArcGIS Enterprise 帮助中提供的升级说明进行操作。

升级后，请按照以下步骤创建图谱存储集群。

1. 确保为图谱存储配置默认备份位置。
2. 向部署中添加第二台图谱存储计算机。
   1. 可以使用原来的第二台计算机或者在新计算机上安装 ArcGIS Data Store（图谱存储）。
   2. 在第二台计算机上运行 configuredatastore 实用程序以配置图谱存储并将其注册到与已升级的图谱存储计算机相同的托管服务器。

      configuredatastore https://myserver.example.com:6443/arcgis serveradmin MyAdminPassword C:\arcgisdatastore --stores graph --mode cluster

      在集群模式下配置第二台图谱存储计算机后，图谱存储将处于集群模式。 但是，直到添加第三台计算机后，它才会成为一个起作用的集群。

3. 在第三台计算机上安装 ArcGIS Data Store（图谱存储）。

   图谱存储集群必须包含三台计算机，既不能多，也不能少。

4. 在第三台计算机上运行 configuredatastore 实用程序以创建图谱存储并将其注册到与另外两台计算机相同的托管服务器。

图谱存储集群准备就绪后，ArcGIS Data Store 将在整个集群中分发图谱数据。

创建所有数据存储的完整备份

确认升级有效后，即可使用 backupdatastore 实用程序为部署中的每个数据存储创建备份。 这样，可以为您提供可使用的完整备份，以免在下一次计划备份之前发生意外。

移除不需要的临时文件

完成上述升级后步骤后，可以运行 diskcleanup 实用程序以移除不再需要的临时文件。