Skip to main content

configuredatastore

该实用程序可用于所有 ArcGIS Data Store 类型。

安装 ArcGIS Data Store 后，您可运行 configuredatastore 实用程序（而不是 Data Store 配置应用程序）创建数据存储并将其注册到 GIS Server 站点。 您可使用此实用程序创建以下数据存储类型：

configuredatastore 实用程序的其他用途如下所述：

  • 对数据存储中所有计算机上的 ArcGIS Data Store 软件进行更新后，升级数据存储。

  • 指定时空大数据存储中计算机的角色。

  • 更改现有单实例图存储或对象存储的部署模式。

语法

configuredatastore <ArcGIS Server host name> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data store content directory> [--stores {relational | spatiotemporal | graph | object}] [--mode {singleInstance | cluster}] [--roles {coord | data}]

选项

描述

<ArcGIS Server host name>

这是 GIS Server 站点，目前或未来会用作 ArcGIS Enterprise 托管服务器。 提供以下类型之一：

  • 托管服务器站点中其中一台计算机的完全限定域名，格式为 gisserver.example.com

  • 托管服务器站点的 URL，格式为 https://gisserver.example.com:6443

    注:

    即使 GIS Server 站点使用 Web 适配器或负载均衡器，您也必须提供上述格式 URL。

  • 托管服务器站点中其中一台计算机的 IP 地址

<ArcGIS Server administrator>

为在托管 GIS Server 站点中具有管理员权限的内置（非组织特定）用户提供用户名。

<ArcGIS Server administrator password>

提供上述所用账户的密码。

<data store content directory>

数据存储内容目录是本地计算机上将创建数据存储文件的位置。

注:

第一次在计算机上运行 configuredatastore 实用程序创建数据存储时需要此选项。 指定数据存储内容目录后，如果您在同一台计算机上运行 configuredatastore 实用程序创建其他类型的数据存储或升级数据存储，则会忽略此选项。

--stores

此选项表示要配置的 ArcGIS Data Store 类型。

有效值如下：

  • relational

  • spatiotemporal

  • graph

  • object

如果未指定 --stores 选项，则会假定 relational 值。

--mode

创建数据存储时，此可选选项适用于图存储和对象存储。 您还可以使用此选项来更改现有图存储或对象存储的模式。

有效值为 singleInstance 或 cluster。

如果您未指定模式，则对象存储和图存储将以单实例模式创建。

--roles

此可选选项仅适用于多机时空大数据存储。

受支持的值为 coord、data 或 coord,data。

创建的时空大数据存储计算机可以作为一个角色或两个角色。 要部署作为两个角色的计算机，请使用逗号分隔两个角色，例如在计算机上运行 configuredatastore 实用程序创建时空大数据存储时，指定 --roles coord,data。

有关协调器角色和数据角色的说明，请参阅将计算机添加到数据存储。

也可以使用 --roles 选项运行 configuredatastore 实用程序，更改现有的时空大数据存储计算机的角色。

注:

当运行 configuredatastore 实用程序以完成时空大数据存储的升级时，请勿包含 --roles 选项。 将基于每台计算机应用 --roles 选项，而升级会影响整个时空大数据存储。

配置数据存储的特定类型

如上所述，使用 --stores 选项指定要创建的数据存储类型。 请使用以下链接以获取各类型数据存储的说明：

要在同一计算机上配置多个数据存储类型，请使用逗号（无空格）来分隔各个类型。 例如，要在同一台计算机上配置关系存储和图存储，请指定 --stores relational,graph。

注意：

在同一计算机上配置的数据存储将争抢内存和其他资源，这对性能有消极影响，并可能会造成数据存储停止工作。 对于时空大数据存储、图存储和对象存储则更是如此；不要在同一计算机上将时空大数据存储、图存储或对象存储配置为其他数据存储或其他 ArcGIS 组件。

如果您编写脚本在时空大数据存储、图存储或对象存储中创建多台计算机，则必须先手动使用 GIS Server 站点配置第一台计算机，然后才能编写脚本在集群中创建其他计算机。 在您的脚本中包括等待时间，以确保不会同时添加其他计算机。

每个数据存储类型在创建时均有一个默认模式。 在创建图存储或对象存储时，可以指定其他模式。

有关说明，请参阅创建数据存储。

在升级 ArcGIS Data Store 安装文件后配置数据存储

作为升级 ArcGIS Data Store 的一部分，您必须对现有数据存储计算机重新进行配置。 在每台数据存储计算机上安装新版 ArcGIS Data Store 取代现有 ArcGIS Data Store 后，可以运行 configuredatastore 实用程序以完成对特定数据存储类型的升级。 在何处运行以及运行多少次 configuredatastore 实用程序以升级变化取决于您的数据存储类型。

只有在 ArcGIS Enterprise 部署中的所有计算机上安装新版本 ArcGIS Data Store 之后，才能继续配置。

有关详细信息和说明，请参阅升级 ArcGIS Data Store。

更改对象存储模式

要将对象存储模式从单实例更改为集群模式，运行 configuredatastore 实用程序，向对象存储中添加至少两台计算机，并在添加时将 --mode 选项设置为 cluster。 这会将整个对象存储的模式重置为集群模式。

注:

  • 在将模式从单实例更改为集群之前，必须为对象存储配置默认备份位置。 您添加到对象存储的计算机必须具有此位置的访问权限。

  • 您无法将对象存储模式从集群更改为单实例。

更改图存储模式

如果图存储包含一台计算机，则以单实例模式运行。 如果包含三台计算机，则以集群模式运行。

要将图存储模式从单实例更改为集群模式，请运行 configuredatastore 实用程序并将 --mode 选项设置为 cluster。

注:

  • 您可以在创建图存储或升级单实例图存储时使用 --mode 选项指定图存储模式。 您还可以运行 configuredatastore 实用程序将现有图存储的模式由单实例模式更改为集群模式。

  • 在将模式从单实例更改为集群之前，必须为图存储配置默认备份位置。 您添加到图存储的计算机必须具有此位置的访问权限。

  • 您无法将图存储模式从集群更改为单实例。

更改时空大数据存储计算机角色

每个时空大数据存储集群都必须有一台计算机作为协调器角色，该计算机充当集群中所有其他计算机的当前协调器。 在时空大数据存储中创建的第一台计算机必须包含协调器角色，这第一台计算机即为当前的活动协调器。 为了确保在当前协调器计算机发生故障时仍能继续工作，集群必须至少有两台其他分配了协调器角色的计算机。

时空大数据存储集群还必须至少有一台计算机作为数据角色。

如将计算机添加到数据存储中所述，将计算机添加到集群时，会为其分配角色。 符合协调器条件的计算机可以更改为仅存储数据。 当前仅作为数据角色的计算机也可以添加协调器角色。

支持的角色更改如下所示：

  • 指定 --roles data 可将协调器更改为数据计算机。 如果集群中有其他符合协调器条件的机器，则可以执行此操作。 如果集群中至少还有三台符合协调器条件的计算机，则可以将一个协调器计算机更改为数据角色。

  • 指定 --roles data 可为部署为两个角色的计算机移除协调器角色。 此操作会保留计算机的数据角色。 如果集群中至少还有三台符合协调器条件的计算机，则可以移除计算机的协调器角色。

  • 指定 --roles coord,data 可为最初部署为仅填充数据角色的计算机添加协调器角色。 最多可以有五台计算机具备协调器角色。 如果集群中已有五台协调器计算机，则无法将协调器角色添加到集群中的数据计算机。

提示：

在更改计算机角色之前，可在其中一台计算机上运行 describedatastore 实用程序以识别时空大数据存储集群中的各个计算机分配有哪种角色。

示例

在该示例中，创建了托管要素图层数据的数据存储（关系存储）。 将使用数据存储的 GIS Server 站点中其中一台计算机的名称为 gisserver.example.com:6443，站点管理员用户名和密码分别为 admin 和 Iph33l$ik，数据存储的内容目录是 /dstore/data。

./configuredatastore.sh gisserver.example.com admin Iph33l$ik /dstore/data --stores relational --prompt no

在该示例中，创建了托管要素图层数据的数据存储（关系存储）。 将使用数据存储的 GIS Server 站点中其中一台计算机的名称为 gisserver.example.com，站点管理员用户名和密码分别为 admin 和 Iph33l$ik，数据存储的内容目录是 C:\datastore\data\。

configuredatastore gisserver.example.com admin Iph33l$ik c:\datastore\data\ --stores relational --prompt no

以下示例向现有对象存储（单实例）中添加了一台计算机：

./configuredatastore.sh gisserver.example.com admin Iph33l$ik dsstore/cache3 --stores object --mode cluster --prompt no

configuredatastore gisserver.example.com admin Iph33l$ik c:\datastore\cache3\ --stores object --mode cluster --prompt no

在下一个示例中，为时空大数据存储集群中的一个仅作为数据角色的计算机添加了协调器角色，使其可以在当前协调器计算机发生故障时作为协调器运行。

./configuredatastore.sh gisserver.example.com admin Iph33l$ik dsstore/cache3 --stores spatiotemporal --roles coord,data --prompt no

configuredatastore gisserver.example.com admin Iph33l$ik c:\datastore\cache3\ --stores spatiotemporal --roles coord,data --prompt no