ArcGIS Data Store 命令实用程序参考—ArcGIS Enterprise

命令实用程序随 ArcGIS Data Store 一同安装，可为数据存储管理员提供管理数据存储的工具。此页面描述实用程序并提供语法和示例。

所有实用程序均必须运行于 ArcGIS Data Store 计算机上。您可在 <ArcGIS Data Store installation directory>/datastore/tools 目录中找到这些实用程序。

您可输入实用程序名称并在其后加 --help 以获得语法协助。

allowconnection

该实用程序适用于关系数据存储。

出于安全方面的原因，默认通过 GIS Server 站点建立到数据存储的所有连接。如果您要打开从其他计算机连接的关系数据存储，可使用 allowconnection 命令实用程序。

只能在主关系数据存储计算机上运行 allowconnection 实用程序。

语法

allowconnection <host name> <user name> [<database>]

指定要连接到关系数据存储的计算机的名称（主机名）和数据存储使用的一个数据库帐户（用户名）：数据存储管理员、复本所有者、地理数据库管理员或托管用户（发布要素图层数据的用户），您可以使用 listadminusers 实用程序或 listmanageduser 实用程序获取它们。您还可以指定主关系数据存储数据库的名称，但是，因为只有一个数据存储数据库，所以该值可选。

示例

在此示例中，当以 hqo.n_1E7 托管用户身份进行连接时，允许从 workcom 计算机连接到关系数据存储。

./allowconnection.sh workcom hqo.n_1E7

backupdatastore

该实用程序适用于关系、切片缓存和时空大数据存储。

如果您需要在计划的备份期间创建关系数据存储备份，请使用 backupdatastore 实用程序。升级数据存储前或对数据存储进行大量更改前，请使用此实用程序手动创建完整备份。

设置备份位置后，首次运行 backupdatastore 实用程序进行切片缓存数据存储时，备份副本由所有现有的切片缓存数据存储数据库构成。后续使用 backupdatastore 实用程序时，可创建自上次运行该实用程序起创建的任何切片缓存数据存储数据库的备份复本。

设置备份位置后，首次运行 backupdatastore 实用程序进行时空大数据存储时，系统将创建完整备份。因为时空大数据存储可能非常大，所以随后使用 backupdatastore 实用程序创建的备份文件仅包含自初始完整备份起的更改。

可以在主关系数据存储计算机上运行 backupdatastore 实用程序。此实用程序可在任何切片缓存或时空大数据存储成员计算机上运行。

在任何情况下，都请确保备份空间位置足以容纳备份内容。要更改数据存储备份位置，请使用 configurebackuplocation 实用程序。

语法

backupdatastore [<backup file name>] [--store {relational | tileCache | spatiotemporal}] [--location <backup_arguments>] [--prompt {yes | no}]

--location 参数的参数如下且必须用分号 (;) 隔开：

type= - 有效类型为 fs（文件共享）、s3（Amazon Simple Storage Service (S3) 存储段）或 azure（Microsoft Azure Blob 存储容器）。
name= - 如果已向为数据存储配置的备份位置分配名称，则可使用该位置名称来指定在运行 backupdatastore 实用程序时创建备份文件的位置。
location= - 如果没有指定备份位置名称，则必须指定备份 type 和 location。如需共享文件，请提供文件路径。如存储在 S3 存储段，请提供存储段名称。如存储在 Azure Blob 存储容器，请提供容器名称。

示例

在本例中，使用 configurebackuplocation 实用程序在为数据存储指定的备份位置处创建名为 project1bu 的完整备份文件。默认情况下，进行关系数据存储时将创建备份；因此，在以下示例中，系统将创建关系数据存储备份。

./backupdatastore.sh project1bu

You are going to back up the data store. This could take some time, depending on the size of your data store.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在此示例中，在文件共享位置为时空大数据存储创建了名称为 localbu5 的备份文件，在配置备份位置时您已将该共享位置命名为 gadbu。

./backupdatastore.sh localbu5 --store spatiotemporal --location 'name=gadbu'

You are going to back up the data store. This could take some time, depending on the size of your data store.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在此示例中，在名称为 blob4backups 的 Azure Blob 存储容器中创建了时空大数据存储的备份，所创建备份文件的名称为 spds311016：

./backupdatastore.sh spds311016 --store spatiotemporal --location 'type=azure;location=blob4backups'

You are going to back up the data store. This could take some time, depending on the size of your data store.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

changebackuplocation

旧版本：

Esri 已弃用 changebackuplocation 实用程序。它仍然存在以允许现有脚本继续运行。否则，请使用 configurebackuplocation 实用程序。

changedatastoremode

该实用程序适用于关系和时空大数据存储。

changedatastoremode 实用程序可用于将关系数据存储置于只读模式，同时对数据存储执行维护。例如，如果您需要执行会导致数据存储重启的维护任务（例如，将备份位置从一个驱动器更改为另一个驱动器或更改数据库属性），则您可以将关系数据存储置于只读模式，以便数据存储重启时，无任何用户会处于发布或编辑数据的过程中。

changedatastoremode 实用程序也可在完成维护或为主数据存储计算机增加足够磁盘空间后将关系数据存储转换回读写模式，从而使数据存储在读写模式下可以正常工作。

您必须在主关系数据存储计算机上而非备用计算机上运行 changedatastoremode 实用程序。

注：

如果 ArcGIS Data Store 由于磁盘空间不足而将关系数据存储置于只读模式，则系统也会禁用自动备份以避免进一步填满磁盘。因此，您必须在将关系数据存储转换回读写模式后使用 updatebackupschedule 实用程序重置自动备份计划。

当您的时空大数据存储即将用完磁盘空间时，ArcGIS Data Store 会将其置于只读模式，以避免数据损坏。您可以在为时空大数据存储计算机添加足够的磁盘空间之后，使用 changedatastoremode 实用程序将时空大数据存储返回到读写模式。

语法

changedatastoremode {readonly | readwrite} [--prompt {yes | no}] --store {relational | spatiotemporal}

示例

在此示例中，将关系数据存储恢复为读写模式，意味着客户端可在进行以下操作时恢复此类活动：向 ArcGIS Enterprise 发布托管要素图层、通过托管要素图层编辑数据或将 CSV 文件添加到 Map Viewer。

./changedatastoremode.sh readwrite --store relational --prompt no

要将时空大数据存储设置为读写模式，请使用 --store 选项指定 spatiotemporal，如以下示例所示：

./changedatastoremode.sh readwrite --prompt no --store spatiotemporal

changedbproperties

该实用程序适用于关系、切片缓存和时空大数据存储。

changedbproperties 实用程序允许您根据运行的数据存储类型更改不同的属性。

语法

changedbproperties --store {relational | tileCache | spatiotemporal} [configuration options]

以下是支持的配置选项：

disk-threshold-readonly - 此设置用于控制何时将关系数据存储置于只读模式，以避免由于磁盘空间不足导致的数据丢失。默认磁盘空间值为 1024 MB。指定大小（以 MB 为单位）。
max-connections - 使用该参数指定关系数据存储所允许的最大连接数。在默认情况下，关系数据存储可最多接受 150 个连接。您可以结合使用 --max-connections 属性和 changedbproperties 实用程序来更改允许的连接数。当确定数据存储需要的连接数时，请考虑到 ArcGIS Data Store 内部过程最多需要五个连接。另考虑 ArcGIS Data Store 计算机可以接受且仍可以保持性能的并发连接数。如果计算机运行 ArcGIS Data Store 时内存不足，您可能需要减少允许的连接数。
指定的数量不得小于 10。当您更改允许的最大连接数时，将同时更改主数据存储计算机和备用数据存储计算机上的这一数量。该参数不支持时空大数据存储或切片缓存数据存储。
pitr - 该设置指示 ArcGIS Data Store 是否会创建关系数据存储的增量备份，从而将关系数据恢复至一个时间点。此选项可能的输入为 enable 或 disable。默认情况下，时间点恢复被禁用。
注：
如您将使用 webgisdr 实用程序创建 ArcGIS Enterprise 部署的增量备份，则必须启用时间点恢复。
enablessl - 此参数可控制在填充切片缓存数据存储时以及针对关系数据存储与托管服务器之间的通信使用传输层安全性 (TLS) 协议。
enablessl 参数支持的选项如下：
- true - 这是默认选项。这意味着，当您指定 --store tileCache，将场景图层数据写入切片缓存数据存储时，以及指定 --store relational，在关系数据存储与托管服务器之间进行通信时，将使用传输层安全协议。
- false - 指定 false 和 --store tileCache 在写入切片缓存数据存储时，通过托管服务器进行 HTTP 通信。指定 false 和 --store relational 在托管服务器与关系数据存储之间使用 HTTP 通信。
heap-size - 使用该参数更改用于时空大数据存储的堆内存数（以 MB 为单位）。默认情况下，启动此类型的数据存储将使用一半的可用 RAM。该参数不支持关系或切片缓存数据存储。
rebalance - 默认情况下，该参数设置为 true，这意味着如果任何一台计算机不可用，则时空大数据存储中的数据将数据分发到其他计算机。如果需要在一个时空大数据存储计算机上执行维护（例如对其进行升级），则可以通过将此参数设置为 false 来临时关闭重新均衡。重新均衡操作将在为 max-rebalance-off 参数设置的时间内暂停。该参数只适用于时空大数据存储。
旧版本：
在 ArcGIS 10.4.x 中，此选项为 reallocation。
max-rebalance-off - 当 rebalance 参数设置为 false 时，使用此参数的设置。默认情况下，max-rebalance-off 设置为 60 分钟。这意味着，如果您临时关闭重新均衡，它将在 60 分钟后再次启动。如果您需要的时间多于或少于执行暂停重新平衡维护任务的时间，请更改 max-rebalance-off 的时间设置。该参数只适用于时空大数据存储。
旧版本：
在 ArcGIS 10.4.x 中，此选项为 max-allocation-off。
prompt - 您运行该实用程序时，系统将提示您确认指定的操作。如果您自动使用此实用程序，则将提示参数设置为 false；否则必须回答提示问题，脚本才会继续。

示例

在此示例中，关系数据存储允许的最大连接数设置为 100：

./changedbproperties.sh --store relational --max-connections 100

You are changing the following database properties:
         max number of connections to 100 (on all relational data store machines)

Changing database configurations could cause the database to restart. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在此示例中，使用 max-rebalance-off 选项将分钟数设置为 15，在此之后，时空大数据存储会自动将 rebalance 更改为 true。

./changedbproperties.sh --store spatiotemporal --max-rebalance-off 15

在此示例中，enablessl 参数用于在创建容器和将数据写入切片缓存数据存储时，将切片缓存数据存储配置为使用传输层安全性。

./changedbproperties.sh --store tileCache --enablessl admin,data

changeloglocation

该实用程序可用于所有数据存储类型。

如果不希望数据存储使用 <ArcGIS Data Store installation directory>\arcgisdatastore\logs 的默认错误日志文件位置，则可以运行 changeloglocation 实用程序在其他目录中创建错误日志文件。

语法

changeloglocation <directory path>

示例

在本示例中，将在本地目录 ../datastorefiles/logs 中创建日志文件。

./changeloglocation.sh '../datastorefiles/logs'

changenosqldslocation

该实用程序适用于切片缓存数据存储。

如果您在切片数据存储中存储了大量高分辨率切片，则切片缓存数据存储可能会变大。在这种情况下，您可能需要将数据移动到同一服务器的另一驱动器中，或者移动到另一服务器的共享位置处。

如果您将数据移动到共享目录，必须向运行 ArcGIS Data Store 进程 (Linux) 或服务 (Microsoft Windows) 的用户授予目录的读写权限。

语法

changenosqldslocation <path> [--prompt {yes | no}]

示例

在本示例中，将在计算机 server2 上名为 dstorecache 的共享目录下创建存储场景图层缓存的数据库。

./changenosqldslocation.sh /net/server2/dstorecache

changepassword

该实用程序适用于关系数据存储。

ArcGIS Data Store 将为关系数据存储使用的数据库帐户随机生成用户名和密码。如果您的站点要求设置您自己的密码，则获取数据存储帐户的密码，然后运行 changepassword 来重置密码。

使用 listadminusers 实用程序获取管理员用户的用户名和密码；使用 listmanageduser 实用程序获取要素数据所有者的用户名和密码。

只能在主关系数据存储计算机上运行 changepassword 实用程序。

语法

changepassword <user name> <new password> [--prompt {yes | no}]

提示：

如果需要编写密码更改脚本（包括禁用确认提示符的标记），则请按以下示例操作：

changepassword gwi_n2Te0 Phfl4mp --prompt no

示例

在本示例中，用户 gwi_n2Te0 的密码被更改为 Phfl4mp!。

./changepassword.sh gwi_n2Te0 Phfl4mp

You are going to change the password for user gwi_n2Te0.
Do you want to continue (Yes or No)?Yes

changestaginglocation

该实用程序适用于关系和切片缓存数据存储。

恢复关系或切片缓存数据存储后，ArcGIS Data Store 会在过渡位置提取压缩的备份文件。这表示您必须具有可兼容此未压缩数据的过渡位置。如果关系或切片缓存数据存储中存在大量数据，请设置单独过渡位置并为恢复操作指定单独过渡位置。

语法

changestaginglocation <directory path>

示例

本例中指定的过渡位置是 /net/sanmarcos/rbustage。

./changestaginglocation.sh /net/sanmarcos/rbustage

configurebackuplocation

该实用程序适用于关系、切片缓存和时空大数据存储。

使用 configurebackuplocation 实用程序可以指定 ArcGIS Data Store 为计划备份以及使用 backupdatastore 实用程序创建的备份写入备份文件的位置。您还可以通过此命令更改备份位置的属性和移除备份位置。

使用默认的本地备份位置创建关系数据存储。可通过使用 change 选项注册远程共享目录，以配置更安全的默认备份位置。

以主-备用模式创建的切片缓存数据存储将具有默认备份位置；而以聚类模式创建的切片缓存数据存储则没有该位置。无论哪种情况，都可使用 register 选项运行 configurebackuplocation 实用程序，以指定共享网络位置、Amazon Simple Storage Service (S3) 存储段或 Microsoft Azure Blob 存储容器，从而安全地存储切片缓存数据存储备份。如果数据存储正在聚类模式下运行，则不能将本地驱动器用于切片缓存备份文件。

不使用默认备份位置创建时空大数据存储。开始创建备份前，必须使用 register 选项运行 configurebackuplocation 实用程序，以为这些备份指定共享网络位置、Amazon Simple Storage Service (S3) 存储段或 Microsoft Azure Blob 存储容器。时空大数据存储备份文件不能使用本地驱动器。

您可以注册第二个备份位置，以存储使用 backupdatastore 实用程序创建的备份。可以使用共享文件目录、S3 存储段或 Azure Blob 存储容器作为辅助备份位置。

语法

configurebackuplocation --location '<backup_location_arguments>' [options]

可以使用 --location 选项来指定 ArcGIS Data Store 存储备份文件的位置。对于切片缓存数据存储或时空大数据存储，或要注册关系数据存储的辅助备份位置，请指定以分号 (;) 分隔的以下参数，并将整个参数字符串括在单引号 (') 中：--location 'type=fs|s3|azure;location=<backup_location>;[name=<backup_location_name>];[username=<AWS_access_key_ID_or_Azure_account>];[password=<AWS_secret_access_key_or_Azure_account_key>]'。下表中给出了对每个参数的解释：

type= - 指定备份所使用的位置类型。可指定 s3 在 Amazon S3 存储段中存储备份，指定 azure 以在 Azure Blob 存储容器中存储备份，或指定 fs 以在文件共享中存储备份（此为默认设置）。
location= - 如需共享文件，请指定文件路径。如存储在 Amazon S3 存储段中，请指定存储段名称。如存储在 Blob 存储容器中，请指定容器名称。
name= - 可为备份位置分配一个名称。例如，如果备份位置是文件路径，如 \\sharedserver_sharedfolders_datastorebackups，则可为该位置指定一个名称，如 dsbackups。在运行 backupdatastore、listbackups 或 restoredatastore 实用程序时，请提供该名称，而不必提供整个路径。
如果在配置数据存储备份位置时没有提供名称，则 ArcGIS Data Store 会分配一个默认名称。
username= - 如果备份位置是 S3 存储段或 Blob 存储容器，则为必填。 S3 存储段需要您提供 Amazon Web Services (AWS) 帐户访问密钥 ID。 Azure Blob 存储容器需要您提供能访问该 Blob 存储容器的 Microsoft Azure 存储帐户名称。
password= - 如果备份位置是 S3 存储段或 Blob 存储容器，则为必填。 S3 存储段需要您提供 AWS 帐户保密密钥。 Azure Blob 存储容器需要您提供使用 username 参数指定的 Azure 帐户的密钥。
endpointsuffix= - 该选项允许您指示 Azure Blob 存储容器所在位置。默认情况下，endpointsuffix 假定为 core.windows.net。如果容器在 Microsoft Azure Government 云端环境中，请设置 endpointsuffix=core.usgovcloudapi.net。如果容器在私有云中，请将 endpointsuffix 设置为 Azure 私有云的 EndpointSuffix。该选项仅在将备份存储在 Azure Blob 存储容器中时使用。

您必须为 configurebackuplocation 实用程序提供的其他选项如下：

--store {relational | tileCache | spatiotemporal} - 指定您要配置备份位置的 ArcGIS Data Store 的类型。默认值为 relational。
--operation {change | register | unregister | list | setdefault} - 默认值是 change。以下是对各选项的解释：
- change - 使用此选项可更改以下任意内容：
  - 为计划关系数据存储备份指定其他的共享文件位置。使用 change 选项设置的位置将始终作为关系数据存储的默认备份位置。
  - 更改您分配到备份位置的名称。
  - 更新您在 Azure 或 S3 上为备份位置设置的身份验证信息。对于 S3，您可以使用 username 和 password 选项更改您之前指定的信息。对于 Azure，您可以更改 password 值。
- register - 用于注册备份位置。您为时空大数据存储定义的首个备份位置将被设置为默认备份位置。当您为切片缓存或时空大数据存储注册另一个备份位置时，将注册辅助备份位置。使用关系数据存储指定 register 选项时，将始终注册一个辅助备份位置。该辅助备份位置将存储使用 backupdatastore 实用程序生成的手动备份。
  注：
  使用 register 选项时，必须为 --location 选项提供信息。
- unregister - 用于从数据存储中移除辅助备份位置。只要注册了一个备份位置，您就可以使用取消注册选项完全移除切片缓存或时空大数据存储的备份位置。
- list - 列出为数据存储所注册的所有备份位置。
- setdefault - 如果切片缓存或时空大数据存储有多个备份位置，可使用 setdefault 指定其中一个备份位置作为默认位置。该位置是计划备份的写入位置，如果在不指定备份位置的情况下运行 backupdatastore、listbackups 或 restoredatastore实用程序，则该位置也会用作默认位置。
--force {true | false} - 此选项仅配合关系数据存储使用，可用于更改默认备份位置，即使现有默认备份位置不可用时也是如此。
更改关系数据存储的默认备份位置时，ArcGIS Data Store 会将现有备份文件从旧位置复制到新位置。如果 ArcGIS Data Store 无法访问旧位置，则无法复制文件。在之前版本中，这可能会造成 configurebackuplocation 工具运行失败。如果您希望继续更改默认备份位置，而不复制现有备份文件，请指定 --force true。
此选项的默认值为 false，这意味着如果 ArcGIS Data Store 无法访问现有默认位置，则您无法更改默认备份位置。
--prompt {yes | no} - 默认值是 yes。

示例

在第一个示例中，关系数据存储的备份位置设置为计算机 myshare 上名为 fsdata_bu 的目录。

./configurebackuplocation.sh --operation change --store relational --location /net/myshare/fsdata_bu

You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)? Yes

在此示例中，将在 Azure 上为同一个相关数据存储注册第二个备份位置。

./configurebackuplocation.sh --operation register --store relational --location type=azure;location=mybackups;name=secondrelloc;username=myazureaccountlogin;password=zpw4myazureaccount

You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)? Yes

在本例中，已为时空大数据存储注册网络共享的备份位置。 fshare 名称会分配到备份位置。

./configurebackuplocation.sh --operation register --store spatiotemporal 
--location 'type=fs;location=/net/sharedmachine/ge_bu;name=fshare'

在此示例中，将在 AWS 上为同一个时空大数据存储指定第二个备份位置。 awsloc 名称会分配到备份位置。

./configurebackuplocation.sh --operation register --store spatiotemporal 
--location 'type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0'

在此示例中，将在 Azure 上为该时空大数据存储指定第三个备份位置。

./configurebackuplocation.sh --operation register --store spatiotemporal --location 'type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount'

在此示例中，将 S3 存储段设置为时空大数据存储的默认备份位置。

./configurebackuplocation.sh --operation setdefault --store spatiotemporal --location 'name=awsloc'

在此示例中，列出了时空大数据存储的所有备份位置。

./configurebackuplocation.sh --operation list --store spatiotemporal
Backup locations for spatiotemporal big data store:
================================================================
Name             Type     Location                     isDefault
================================================================
fsshare          fs       /net/sharedmachine/ge_bu     false
awsloc           s3       mybucket                     true
mazloc           azure    myblobs                      false

configuredatastore

该实用程序可用于所有数据存储类型。

安装 ArcGIS Data Store 后，您可运行 configuredatastore 实用程序创建数据存储并将其注册到 GIS Server 站点。您可使用该命令创建以下数据存储类型：

更新数据存储中所有计算机上的 ArcGIS Data Store 软件后，您还可以运行 configuredatastore 实用程序来升级数据存储。

语法

configuredatastore <ArcGIS Server admin URL> <ArcGIS Server administrator> <ArcGIS Server administrator password> <data directory> [--stores {relational | tileCache | spatiotemporal | object}] [--mode {primaryStandby | cluster}] [--machines <machine names> [--data-loc <object data location>]

<ArcGIS Server admin URL> - 此为已用作或将用作 ArcGIS Enterprise 托管服务器的 GIS Server 站点。 ArcGIS Server 管理 URL 的格式为 https://gisserver.domain.com:6443。请注意，即使您的 GIS Server 站点使用的是 Web Adaptor，也必须提供前面所提及格式的 URL。
<ArcGIS Server administrator> - 为在 GIS Server 站点中具有管理员权限的内置（非企业级）用户提供用户名。
<ArcGIS Server administrator password> - 为内置 ArcGIS Server 管理员用户提供密码。
<data directory> - 数据目录是在本地计算机上您要创建数据存储文件的位置。
{relational | tileCache | spatiotemporal | object} - 指定要创建的数据存储的类型。虽然您可以指定由逗号分隔（不含空格）的每种存储类型以在同一台计算机上配置多个类型的数据存储，但不建议您这样操作。例如，要在同一台计算机的共享数据存储目录下配置关系和切片缓存数据存储，请指定 --stores relational,tileCache。Esri 强烈建议您在独立于其他数据存储或软件的计算机上运行时空大数据存储。如果不这样做，则可能导致性能下降，甚至导致数据存储不可用。
--mode - 此可选操作仅适用于切片缓存数据存储和对象存储。默认情况下，新切片缓存数据存储和对象存储将以 primaryStandby 模式创建。
以 primaryStandby 模式创建的切片缓存数据存储可包含两台计算机。备用切片缓存数据存储中包含的数据与主数据存储相同。如果主数据存储运行失败，则备用数据存储将成为主切片缓存数据存储。如果您需要存储大量的场景图层缓存，并因此需要切片缓存数据存储进行扩展以包括三台或更多台计算机，请在 cluster 模式创建切片缓存数据存储。您也可以使用模式操作将切片缓存数据存储从一种模式切换到另一种模式。
以 primaryStandby 模式创建的对象存储当前仅可包含一台计算机。如果在对象存储中需要多个计算机以提供高可用性，可以以聚类模式部署对象存储。使用聚类模式时，对象存储必须包含具有相同规格和类似名称的四台计算机。有关详细信息，请参阅向您的数据存储添加计算机。
--machines - 此选项仅适用于对象存储。提供单机部署的对象存储计算机名称或聚类部署的计算机名称的逗号分隔列表。在聚类部署中，必须有四台计算机并且计算机的名称（或别名）除了追加的编号外必须相同；例如 machine1、machine2、machine3 和 machine4。
--data-loc - 此选项仅适用于对象存储。提供存储缓存数据的目录路径。如果以聚类模式部署，请提供以相同顺序列出的计算机的目录的逗号分隔列表。集群中计算机上的目录必须在相同的位置，并且除了数字外具有相同的名称；例如 directory1、directory2、directory3 和 directory4。

配置数据存储的特定类型

您可以使用 --stores 选项的以下设置来指定要创建的数据存储类型：

relational
tileCache
spatiotemporal
object

要在同一计算机上配置多个数据存储类型，请使用逗号来分隔各个类型。例如，要在同一台计算机上配置关系和切片缓存数据存储，请指定 --stores relational,tileCache。

注：

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

如果要编写创建多个时空大数据存储计算机的脚本，则必须通过 GIS Server 手动配置一台时空大数据存储计算机，然后才可编写创建其他时空大数据存储计算机的脚本。在您的脚本中包括等待时间，以确保不会同时添加其他时空大数据存储计算机。

有关详细信息，请参阅创建数据存储。

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

作为升级 ArcGIS Data Store 的一部分，您必须对现有数据存储计算机进行配置。在每台数据存储计算机上安装完成新版 ArcGIS Data Store 并取代现有 ArcGIS Data Store 后，可登录任何数据存储计算机，并运行 configuredatastore 实用程序以结束特定数据存储的升级。例如，您可以在主关系数据存储计算机上运行 configureatastore，而备用计算机也会升级。

如果计算机同时包含关系和切片缓存数据存储，则在运行 configuredatastore 实用程序时指定 --stores relational,tileCache，这将升级两个数据存储中的全部计算机。

要重新配置升级后的时空大数据存储计算机，请登录到时空大数据存储中的任何一台计算机，然后运行 configuredatastore 实用程序。这将对时空大数据存储中的所有计算机进行升级。

请注意，如果尚未在所有计算机上安装新版本 ArcGIS Data Store，则配置无法进行。

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

更改切片缓存数据存储的模式

如果从 10.7.1 或更早版本进行升级，则切片缓存数据存储将自动处于主-备用模式。如果由于您拥有大量场景图层而需要在切片缓存数据存储中设置更多计算机，则可以将切片缓存数据存储模式更改为聚类模式，并将更多计算机添加到切片缓存数据存储中。添加更多计算机后，新场景图层的缓存将存储在（一台或多台）新计算机上。除非您创建一个切片缓存数据存储的完整备份并在添加（一台或多台）新计算机后将其还原，否则现有缓存将不会存储在新计算机上。

同样，如果您在 10.8 中创建了切片缓存数据存储，或在创建时为切片缓存数据存储模式选择了聚类，但后来发现聚类模式对您而言运行太慢，则如果您确实不需要由多台计算机提供存储，可以将切片缓存数据存储切换到主备用模式。但是，在切换到主-备用模式之前，切片缓存数据存储不能包含两台以上的计算机。

注：

您可以使用 --mode 操作在创建数据存储时指定切片缓存数据存储模式或更改切片缓存数据存储模式，但在升级切片缓存数据存储时您将无法更改此模式。

示例

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

./configuredatastore.sh https://gisserver.domain.com:6443 admin Iph33l$ik /dstore/data --stores relational

在以下示例中，现有切片缓存数据存储被更改为聚类模式：

./configuredatastore https://gisserver.mydomain.com:6443 portaladmin S00perSecret dsstore/scenedata --stores tileCache --mode cluster

deletebackup

该实用程序适用于关系数据存储。

deletebackup 实用程序用于删除为关系数据存储创建的备份文件。首先，运行 listbackups 实用程序以查看手动备份的名称和创建时间。然后，您可以运行 deletebackup 实用程序以删除不再需要的手动备份。

请注意，您只能删除不需要恢复备份。例如，您不能删除关系数据存储的最近完整备份。

语法

deletebackup <backup name> [--prompt {yes | no}]

示例

./deletebackup.sh featuresMarchbu
You are attempting to delete backup 'featuresMarchbu'. This operation is irreversible.

Do you wish to continue (Yes or No)?yes

Operation completed successfully

describedatastore

该实用程序可用于所有数据存储类型。

通过 describedatastore 实用程序，您可以查看有关 ArcGIS Data Store 安装的以下信息：

ArcGIS Data Store 安装的软件版本号
用于恢复数据的数据存储所使用的过渡位置
数据存储的日志文件位置
已安装 ArcGIS Data Store 的计算机上的剩余可用磁盘空间量
关系数据存储将置于只读模式且时空大数据存储将停止的可用磁盘空间阈值
每类数据存储所使用的备份位置
关系或切片缓存数据存储的备份位置是否已在网络上共享
数据存储创建备份的频率（备份计划）
保留关系数据存储备份文件的天数和是否可以将关系数据存储恢复至特定时间点。
数据存储是否正在运行（数据存储状态）
是否在关系数据存储上启用 SSL 通信。
备用关系数据存储成为主数据存储的日期和时间（上次故障转移）；如果从未发生故障转移则不显示
参与关系或切片缓存数据存储的计算机的名称（成员计算机）
关系数据存储允许的最大连接
数据存储注册到 GIS Server 站点的 URL（所属系统 URL）
使用 GIS Server 站点作为其托管服务器的门户 URL（门户 URL）
连接到关系数据存储的当前要素图层数
当前参与时空大数据存储的所有计算机的列表（时空集群中的计算机）
当前指定为协调计算机的时空大数据存储内部的计算机（集群内的当前协调计算机）
时空大数据存储集群中所有计算机的列表或切片缓存数据存储集群（分别为已注册的时空计算机和已注册的切片缓存计算机）；显示集群中的所有计算机（无论其处于何种状态）
为切片缓存数据存储或对象存储配置的模式，可以为集群或主-备用模式。
关系或时空大数据存储是否为 READWRITE 或 READONLY 模式（数据存储模式）

语法

describedatastore

示例

describedatastore 实用程序将返回适用于计算机上所有数据存储的常规信息并返回包含特定于每种类型数据存储信息的单独部分。

您应该将不同的数据存储放置在不同的计算机上，但是要允许查看每种类型返回的信息，以下输出显示了在同一台计算机具有所有 ArcGIS Data Store 类型的计算机上。第一部分（常规信息）始终返回。 describeatastore 返回的数据存储部分取决于计算机上存在的数据存储类型。

./describedatastore.sh

General Information of ArcGIS Data Store on machine.domain.com
==============================================================
ArcGIS Data Store release....10.9.0.1234
Staging location............./arcgis/datastore/staging
Log location................./arcgis/datastore/logs
Free disk space..............174.00GB
Threshold for READONLY mode..2048MB

Information for relational data store ds_sthiu0_5T
==============================================================
Backup location.........../net/nwshare/dsbackups
Is backup folder shared...true
Backup schedule...........{"schedule-starttime":"00:00:00","schedule-frequency":"Every 7 DAYS"}
Days backup retained......31
Data store status.........Started
SSL enabled...............true
Last failover.............20150130190334005
Member machines...........MACHINE1.DOMAIN.COM, MACHINE4.DOMAIN.COM
Maximum connections.......150
Owning system URL.........https://gisserver.domain.com:6443/server/admin
Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portal
Number of connections.....8 connection(s) to managed database
Data Store mode.....................READWRITE
Is Point-in-time recovery enabled...No
Query optimizer enabled.............Yes

Information for tile cache data store ds_wztxj7um
==============================================================
Data location............./home/ags/arcgis/datastore/usr/arcgisdatastore/nosqldata
Data store status.........Started
Last failover.............20200130190334005
Backup location.........../net/sharedir/datastore/backup
Is backup folder shared...true
Mode......................primary-standby
Member tile cache machines.......MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM
Owning system URL.........https://gisserver.domain.com:6443/server/admin
Portal for ArcGIS URL.....https://portal_webadaptor.domain.com/portal

Information for spatiotemporal big data store ds_qpko99Cl
==============================================================
Max rebalance off time..............60 minutes
Automatic rebalance ................On
Machines in spatiotemporal cluster..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Current coordinator in cluster...MACHINE1.DOMAIN.COM
Registered spatiotemporal machines..MACHINE1.DOMAIN.COM, MACHINE2.DOMAIN.COM, MACHINE3.DOMAIN.COM
Owning system URL...................https://gisserver.domain.com:6443/arcgis/admin
Portal for ArcGIS URL...............https://portal_webadaptor.domain.com/portal
Data Store mode.....................READWRITE

Information for object store w1tiknx
==============================================================
Deployment mode................................primaryStandby
Access endpoint................................MACHINE1:9900
Registered object store machines...............MACHINE1.DOMAIN.COM
Owning system URL...................https://gisserver.domain.com:6443/server/admin
Portal for ArcGIS URL...............https://portal_webadaptor.domain.com/portal

exportmanageddb

旧版本：

Esri 已在 10.5.1 上弃用了 exportmanageddb 实用程序。此功能已整合到 backupdatastore 实用程序中。为使现有脚本继续运行，exportmanageddb 实用程序仍存在，但您应使用 backupdatastore 实用程序创建备份文件，然后使用 restoredatastore 实用程序从备份文件中恢复数据存储。

importmanageddb

该实用程序适用于关系和切片缓存数据存储。

如果您导出的 ArcGIS Data Store 包含托管要素图层或托管场景图层缓存数据库（或两者），则可使用 importmanageddb 实用程序恢复数据存储。您可以恢复到升级后的 ArcGIS Data Store 计算机，或者与源 ArcGIS Data Store 使用不同操作系统的计算机上的 ArcGIS Data Store 安装。

如果您希望如之前一样通过同一个 ArcGIS Data Store 站点注册 GIS Server，则指定 --bound 为 true 且不指定 --server-url。请注意，默认情况下 --bound 设置为 true。请确保恢复前重新启动 GIS Server 站点。

如果您进行恢复且希望将数据存储注册到新 GIS Server 站点，则请在导入数据存储时指定 --server-url。

默认情况下，导入导出文件中组成切片缓存数据存储的关系数据存储和所有托管场景图层缓存数据库。如果您不想将托管场景图层缓存数据库包括在内，请指定 --include-tilecache 选项设置为 false。

importmanageddb 实用程序不能导入时空大数据存储。

语法

importmanageddb <source backup location> <backup name> [options]

支持的选项如下：

[--server-url <ArcGIS Server URL registered with data store>] - 如果指定 --bound true 且已将服务移动至新的 GIS Server 站点，则使用 --server-url 选项指定新 GIS Server 站点的 URL。但是请注意，除非您已将服务移动至该新服务器，否则将无法访问数据存储中的数据。
[--server-admin <user name of ArcGIS Server admin>] - 如果指定 --bound true 或者未指定 --bound 选项，则需要此选项。提供 ArcGIS Server 管理员的用户名。
[--server-password <password of ArcGIS Server admin>] - 如果指定 --bound true 或者未指定 --bound 选项，则需要此选项。提供 ArcGIS Server 管理员的密码。
[--data-dir <data store data directory>] - ArcGIS Data Store 目录。默认情况下，此为当前注册数据存储的 ArcGIS Data Store 目录。
[--stores {relational | tileCache}] - 指示要导入的数据存储类型。如果关系和切片缓存数据存储在同一台计算机上运行并且您希望导入这两种数据存储，则指定用逗号分隔的两种数据存储；例如，输入 --stores relational,tileCache。如果未指定 --stores 选项，则将假设为关系存储。
[--include-tilecache {true | false}] - 此选项是为了实现向后兼容性。如果未指定 --stores 选项或指定 --stores relational，则可以控制是否使用此选项恢复切片缓存数据存储。
[--bound {true | false}]
- 如果指定 --bound true 或者未指定 --bound 选项，则必须使用 --server-url 选项指定 GIS Server 站点的 URL，并使用 --server-admin 和 --server-password 选项指定 ArcGIS Server 管理员凭据。如果您导入的 GIS Server 站点与 ArcGIS Data Store 导出数据存储时已注册的站点相同，则请指定 GIS Server 站点的 URL 并提供 ArcGIS Server 管理员的用户名和密码。要将数据存储绑定至新 GIS Server 站点，请提供新站点的 URL 和管理员凭据。
  注：
  仅在将 web 服务移至该新的 GIS Server 站点后为此新 GIS Server 站点指定信息。
- 如果您的数据存储不再使用之前的 GIS Server 站点且您尚未将所有服务移至新的 GIS Server 站点，则指定 --bound false。然后必须运行 registerdatastore 实用程序，以便在将服务移动至新站点后使用新的 GIS Server 站点配置数据存储。
[--prompt {yes | no}] - 确定您是否必须回答提示问题才能运行实用程序。

示例

在下面的示例中，数据存储恢复到版本较新的 ArcGIS Data Store 安装。新的 ArcGIS Data Store 数据目录已指定。数据存储仍与现有 GIS Server 站点绑定，因此数据存储和现有托管要素和场景图层仍然可用。重新启动 GIS Server 站点以允许托管要素和场景图层发布到新计算机上。

./importmanageddb.sh /net/backupserver/expdir preupgradeexp --source-loc  --data-dir /usr/arcgis/datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s --bound true

在本例中，GIS Server 站点和关系数据存储均已移动至新的计算机上。 Web 服务已移动至新的 GIS Server 站点中，因此新站点的 URL 通过 --server-url 选项进行指定。备份名称是 movedbexp，且备份存储在 /net/backupserver/expdir 下。

./importmanageddb.sh /net/backupserver/expdir movedbexp --data-dir /usr/arcgis/datastore --server-admin siteadmin --server-password Aup.4s --stores relational --bound true --server-url https:\\newgisserver.domain.com:6443

在本例中，Web 服务尚未移动至新的 GIS Server 站点中。如果未移动服务并随后将数据存储注册到新的 GIS Server 站点中，则切片缓存和关系数据存储将无法使用。备份名称是 movedsfirstexp，且备份存储在 /net/backupserver/expdir/movingexp2 下。

./importmanageddb.sh /net/backupserver/dbdump/movingexp2 movedsfirstexp --data-dir /usr/arcgis/datastore --stores relational,tileCache --bound false

listadminusers

该实用程序可用于所有数据存储类型。

Listadminusers 实用程序针对关系数据存储的管理员、复本所有者和地理数据库管理员返回用户名和密码。该实用程序返回切片缓存和时空大数据存储的管理员。

语法

listadminusers

示例

在此示例中，listadminusers 在仅安装了关系数据存储的计算机上运行。

./listadminusers.sh

Admin users for relational data store ds_abcd1234
=================================================
Database Admin User.... adm_11zyx / tT30sbYk22jF
Database Repl User..... dsrepuser / uWn/MV0678h4
GDB Admin User......... sde / iO=Qst751epb

在此示例中，listadminusers 在仅安装了时空大数据存储的计算机上运行。

./listadminusers.sh

Admin users for spatiotemporal big data store bds_abcd1234
=================================================
Store admin user.... els_321ret / B1as70fF1

在此示例中，listadminusers 在仅安装了对象存储的计算机上运行。

./listadminusers.sh

Admin users for object store w1tiknx
=================================================
Store admin user....n6o96nl53vzkm36d / bpvifyjz73xwhot4

listbackups

该实用程序适用于关系、切片缓存和时空大数据存储。当关系数据存储运行时，listbackups 实用程序将仅在主数据存储计算机中运行。

listbackups 实用程序返回备份文件的名称及其写入的位置。 Listbackups 实用程序也返回备份状态（无论是否完成），开始备份的时间，以及备份是通过手动使用 backupdatastore 实用程序创建还是由 ArcGIS Data Store 自动创建。

运行 listbackups 实用程序时，请为备份文件列表指定备份位置。如果未指定位置，listbackups 实用程序会为默认备份位置返回备份。

您可以运行 listbackups 以查看备份已完成还是仍在运行、确定您的手动备份数量或在运行 deletebackup 实用程序之前确认文件名称。

语法

listbackups [--store {relational | tileCache | spatiotemporal}] [--location '<location_arguments>']

如果您没有指定数据存储类型，实用程序会默认选择 relational，并返回此计算机上运行的关系数据存储的备份。

此 location 参数用于时空大数据存储和关系数据存储。参数如下：

name=：备份位置名称。在配置备份位置时指定该名称，或如果未指定名称，ArcGIS Data Store 会分配一个默认名称。
location=：可以是共享文件目录的路径、S3 存储段名称或 Blob 存储容器名称。

示例

在本例中，为名称为 sbdsbu 的备份位置列出了时空大数据存储备份：

./listbackups.sh --store spatiotemporal --location 'name=sbdsbu'

Backup_Name                 Status           Backup_Time         Mode
=======================================================================
backup1						               BackupComplete   2016-07-11 09:47    manual

Backups located at: '/net/myserver.ntw.com/spatiotemporal'

listmanageduser

该实用程序可用于所有数据存储类型。

listmanageduser 实用程序将返回关系和时空大数据存储中托管要素图层数据所有者帐户的用户名和密码。此实用程序还将返回切片缓存数据存储数据所有者的用户名和密码。

语法

listmanageduser

示例

在以下示例中，listmanageduser 在包含关系和切片缓存数据存储的计算机上运行。此计算机为主关系数据存储。

./listmanageduser.sh

Managed user for relational data store ds_abcd1234
===================================================
UserName     Password       Database
gwi_n2Te0    4cXddhZhve=Y   db_qv5e1

Managed user for tile cache data store tcs_e41f0rj2
===================================================
UserName     Password
usr_n8778    y47ccno913

在本例中，listmanageduser 在时空大数据存储计算机上运行。

./listmanageduser.sh

Managed user for spatiotemporal big data store bds_6udbx4321
=============================================================
UserName     Password
fmr_o1He3    5vZggkPbaw+T

在以下示例中，listmanageduser 在对象存储计算机上运行。

./listmanageduser.sh

Managed user for object store w1tiknx
=============================================================
Store credential........n6o96nl53vzkm36d / bpvifyjz73xwhot4

listobjectstorage

该实用程序适用于对象存储。

要提高绘制性能，ArcGIS 在托管要素图层上创建了从查询返回的要素缓存，并将其存储在对象存储中。

缓存在每个要素图层的基础上创建，根据图层的大小，会占用许多磁盘空间。如果对象存储计算机上的磁盘空间不足，可以通过运行 listobjectstorage 实用程序检查当前要素图层缓存大小和当前缓存保留策略。该实用程序返回每个缓存托管要素图层（要素服务）的名称、启用缓存的图层的 ID、图层缓存的大小和为该图层缓存查询设置的当前保留政策。默认情况下，不会删除缓存。要更改何时缓存删除，托管服务器的 ArcGIS Server 管理员必须在 ArcGIS Server 管理员目录中设置过期日期。要删除托管要素图层的缓存，管理员可以禁用图层的缓存。可在 ArcGIS Server Administrator 目录中使用 updateDefinition 操作完成此操作。

语法

listobjectstorage

示例

在以下示例中，listobjectstorage 实用程序将运行以确定所有当前存储在对象存储中具有查询缓存的图层的当前缓存大小，并查看缓存过期并从对象存储中删除前将保留多少天。当前共有三个图层（两个位于 Cities 托管要素图层，另一个在 Facilities 托管要素图层），在对象存储中具有已缓存的查询。

./listobjectstorage.sh

Total cache size.......... 71.192 GB

Feature tiles for object store 
ServiceName    LayerId     CacheSize     ExpirePolicy(Days)
====================================================================
Cities          0           181 MB       7
Cities          3           71 GB        None
Facilities      0           11 MB        1

提示：

托管服务器的 ArcGIS Server 管理员可以登录到 ArcGIS Server Administrator 目录以根据图层 ID 确定每个图层的名称。

registerdatastore

该实用程序可用于所有数据存储类型。

数据存储保留有关 GIS Server 站点计算机名称的信息。如果您将 GIS Server 站点移动到新的计算机上（例如，如果您获得新的硬件或者现有的 GIS Server 计算机出现故障），您必须从 GIS Server 站点中取消注册数据存储才能移除该信息。在一台或多台新计算机上配置 GIS Server 后，您可以使用 registerdatastore 命令实用程序将数据存储注册到 GIS Server 站点。

请注意，此次数据存储与之前一样注册到同一 GIS Server 站点。数据存储包含现有 GIS Server 站点上的托管图层的数据。将其注册到其他 GIS Server 站点不会重新创建托管要素图层、场景图层缓存或流服务数据存档。

可以在主关系数据存储计算机上运行 registerdatastore 实用程序。该实用程序可在任何对象、切片缓存或时空大数据存储计算机上运行。

语法

registerdatastore <ArcGIS Server URL> <ArcGIS Server site administrator user name> <ArcGIS Server site administrator password> --stores {relational | tileCache | spatiotemporal | object}

如果您在同一台计算机上安装了多个不同类型的数据存储，则您可通过指定用逗号分隔（不含空格）的数据存储类型同时注册这些数据存储；例如，输入 --stores relational,tileCache。

示例

在本示例中，关系数据存储使用 URL https://gisserver.domain.com:6443 重新注册到 GIS Server 站点。 ArcGIS Server 主站点管理员用户名为 agsadmin，密码为 Tan$p0n。

./registerdatastore.sh https://gisserver.domain.com:6443 agsadmin Tan$p0n --stores relational

removemachine

该实用程序适用于关系、切片缓存和时空大数据存储。

使用 removemachine 实用程序从包含多台计算机的数据存储中移除计算机。可将 removemachine 实用程序用于以下场景：

从关系数据存储中移除备用计算机。可在备用计算机上运行此实用程序；如果备用计算机不可用，也可在主计算机上运行。
从切片缓存数据存储中移除计算机。可以在切片缓存数据存储中的任何计算机上运行此实用程序，但是不能在仅由一台计算机组成的切片缓存数据存储上运行 removemachine。
从时空大数据存储中移除计算机。可以在时空大数据存储中的任何计算机上运行此实用程序，但是不能在仅由一台计算机组成的时空大数据存储上运行 removemachine。

语法

removemachine <machine name> --store {relational | tileCache | spatiotemporal} [--force {true | false}] [--prompt {yes | no}]

--force - 默认情况下，此选项被设置为 false。只有在已注册的 ArcGIS Server 站点可用时，才能将此选项指定为 true。

--prompt - 默认情况下，此选项被设置为 yes。如果不想确认操作，则将此选项指定为 no。

示例

在此示例中，时空大数据存储计算机 gefour 已从数据存储中移除。

./removemachine.sh gefour --store spatiotemporal

在此示例中，托管服务器站点不可用，并从数据存储中移除了名为 fsdata 的关系数据存储计算机。

./removemachine.sh fsdata --store relational --force true

removestandbymachine

旧版本：

Esri 已弃用 removestandbymachine 实用程序。它仍然存在以允许现有脚本继续运行，但您应开始改用 removemachine 实用程序。

restoredatastore

该实用程序适用于关系、切片缓存和时空大数据存储。

如果您无法访问托管要素图层和托管场景图层使用的数据或存档实时数据，请使用备用文件和 restoredatastore 命令实用程序来恢复数据存储。

如果无法恢复数据存储，请在新计算机上安装 ArcGIS Data Store，不要配置数据存储，然后将备份恢复到新计算机。

如果您使用关系数据存储且要将托管要素图层数据回滚到过去的某个特定时间，请在现有关系数据存储的上方进行恢复。请注意，您只能恢复到备份文件可用时的先前关系数据存储状态。例如，如果您只保留了五天的备份，则只能将数据存储恢复到这五天以内的某个时间点。

如果您需要替换多机切片缓存数据存储中的其中一台计算机，您很可能需要在切片缓存数据存储中重新平衡场景图层缓存。在该过程中您需要恢复切片缓存数据存储，将 replicatedata 选项设置为 true。有关说明，请参阅恢复数据存储。

可以在主关系数据存储计算机上运行 restoredatastore 实用程序。该实用程序可在任何切片缓存或时空大数据存储计算机上运行。

语法

restoredatastore [options]

支持的选项如下：

[--store {relational | tileCache | spatiotemporal}] - 指示要恢复的数据存储类型。
[--target {most-recent | <yyy-mm-dd-hh:mm:ss> | <name of backup file>}] - 所有数据存储类型均支持具有 target 选项的备份文件名称。时间戳和 most-recent 仅适用于关系数据存储。
[--source-loc <parent directory of the source backup file location>] - 这是您要用于恢复数据存储的备份文件所在的顶级目录。这将是文件共享位置的路径、备份位置名称或 Amazon S3 或 Azure Blob 的存储备份位置。
[--bound {true | false}] - --bound 选项仅支持关系数据存储。
[--data-dir <new data store directory>] - 这是要恢复数据库的计算机上的 ArcGIS Data Store 目录。如果要将数据存储恢复到新计算机，则需要使用 --data-dir。恢复到新计算机时，还须指定 --source-loc 选项。
[--server-url <ArcGIS Server URL registered with data store>] - 如果指定 --bound true 以使此数据存储与创建备份时的数据存储注册在同一 GIS Server 站点，请指定 GIS Server 站点的 URL。如果指定 --bound true 且已将服务移动至新的 GIS Server 站点，则使用 --server-url 选项指定新 GIS Server 站点的 URL。请注意，如果您指定了新站点 URL，但并未将服务移动至该新服务器，则无法访问数据存储中的数据。
[--server-admin <user name of ArcGIS Server admin>] - 如果指定 --bound true 或者未指定 --bound 选项，则需要此选项。提供 ArcGIS Server 管理员的用户名。
[--server-password <password of ArcGIS Server admin>] - 如果指定 --bound true 或者未指定 --bound 选项，则需要此选项。提供 ArcGIS Server 管理员的密码。
[--loaddata {true | false}] - 支持切片缓存和时空大数据存储。当您需要将数据存储恢复到一组新的计算机时，请将此选项设置为 false，但数据将不适用于第一台计算机。这样可以恢复数据存储的方案，将更多的计算机添加至数据存储以容纳所有数据，然后再次运行 restoredatastore 实用程序并将 --loaddata 设置为 true 以恢复数据。默认情况下，此选项设置为 true。
[--replicatedata {true | false}] - 支持切片缓存数据存储。当您需要在将计算机添加到切片缓存数据存储后重新平衡场景缓存数据时，请将此选项设置为 true。
[--mode {primaryStandby | cluster}] - 当您将切片缓存数据存储恢复到新计算机时，请指定是要使用两台计算机的切片缓存数据存储来实现高可用性 (primaryStandby) 还是使用多机切片缓存数据存储来实现可扩展性 (cluster)。
[--prompt {yes | no}]

在发生故障后恢复关系数据存储或移动关系数据存储，请指定 --target most-recent。如果将关系数据存储恢复到某个时间点，请指定您要将数据存储恢复到的日期和时间（UTC 格式）。如果您想要恢复某个特定的备份文件，请指定备份文件名称。如果您没有指定目标，系统会恢复最近的备份。

默认情况下，恢复的数据存储与其 GIS Server 站点相关联（绑定）。如果您要恢复数据存储而不保持数据存储与 GIS Server 站点关联，请只指定 --bound false。除非之前的 GIS Server 站点丢失且不可恢复，否则尽量不要这样做；您可以恢复未绑定的数据存储，并使用新的联合 GIS Server 站点对其进行配置。但是，使用数据存储中的数据的图层将不会存在。您必须连接到数据存储数据库才能将数据提取为其他格式，并将其重新发布到 ArcGIS Enterprise。

示例

在本示例中，最新备份来自默认关系数据存储备份位置，并将恢复到现有数据存储中。由于默认存储类型为关系存储，且在默认情况下该数据存储仍会受到所注册的 GIS Server 站点的限制，因此您无需指定 --store relational 或 --bound true。但是，必须指定 GIS Server URL 和管理员凭据。

./restoredatastore.sh --target most-recent --server-url https://gisserver.domain.com:6443 
--server-admin siteadmin --server-password SAup.4s

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在本示例中，已启用时间点恢复的关系数据存储将从默认关系数据存储备份位置恢复至 2014 年 7 月 17 日下午 2：30 (UTC) 时的状态。

./restoredatastore.sh --target 2014-07-17-14:30:00 --server-url https://gisserver.domain.com:6443 
--server-admin siteadmin --server-password SAup.4s

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在本示例中，可以使用名为 movedatastore 的备份文件将关系数据存储恢复到新计算机。恢复到新计算机时，必须指定备份文件的位置和新 ArcGIS Data Store 数据目录的位置。由于托管要素服务仍运行在关系数据存储所注册的同一 GIS Server 站点，因此不需要 --bound true，但是需要 GIS Server URL 和管理员凭据。

./restoredatastore.sh --target movedatastore --source-loc /net/buserver/data/backups --data-dir /usr/datastore 
--server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在以下示例中，可将切片缓存数据存储恢复到新计算机。恢复到新计算机时，必须指定备份文件的位置和新 ArcGIS Data Store 数据目录的位置。由于场景服务仍运行在切片数据存储所注册的同一 GIS Server 站点，因此不需要 --bound true，但是需要 GIS Server URL 和管理员凭据。

./restoredatastore.sh --store tilecache --source-loc /net/buserver/scenedata/backups --data-dir /usr/datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在本示例中，切片缓存数据存储将从名为 mybackupfilename 的文件中恢复，以在向切片缓存数据存储中添加新计算机后重新平衡场景缓存数据。

./restoredatastore.sh --store tilecache --target mybackupfilename --serverurl https://gisserver.domain.com:6443 --server-admin siteadmin --server-password myAdminPWd! --replicatedata true

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

在以下示例中，将时空大数据存储备份文件 (bds1) 从指定名称 (awsloc) 的备份位置中恢复。

./restoredatastore.sh --target bds1 --store spatiotemporal --source-loc 'name=awsloc' --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password SAup.4s

You are attempting to restore the data store from a data store backup. This process could take a long time, 
depending on the size of your data. Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)?Yes

有关硬件故障后恢复时空大数据存储的步骤和示例，请参阅恢复数据存储。

revokeconnection

该实用程序适用于关系数据存储。

如果您使用 allowconnection 实用程序暂时允许另一客户端直接连接到关系数据存储，您可以通过运行 revokeconnection 实用程序撤销连接功能。

只能在主关系数据存储计算机上运行 revokeconnection 实用程序。

语法

revokeconnection <host name> <user name> [<database>]

示例

在本示例中，当以用户 hqo.n_1E7 的身份登录时，数据存储数据库不会再接受 workcom 计算机的连接。

./revokeconnection.sh workcom bn0_3Wa.m hqo.n_1E7

unregisterdatastore

该实用程序可用于所有数据存储类型。

您可以使用 unregisterdatastore 命令实用程序执行下列操作：

取消注册 GIS Server 站点中的主关系数据存储计算机。
请注意，如果您有备用计算机，在您取消注册主机之前，必须首先将其从数据存储中移除。
取消注册单机切片缓存或时空大数据存储。
注销对象存储。注销对象存储后，必须重新启动托管服务器。

注：

要取消注册，必须先删除使用关系、切片缓存或时空大数据存储中的数据的托管图层。如果不执行此操作，门户中将留有不可用的图层项目，且托管服务器中将运行不可用的服务。

如果您决定不再使用数据存储或基于数据存储的服务，则应从 GIS Server 站点取消注册数据存储。取消注册数据存储的计算机时，GIS Server 站点不能再连接到该计算机，并且所有包含取消注册数据存储数据的服务都将不再运行。但是，此命令并不会删除数据；如果您仍然决定需要关系、切片缓存或时空大数据存储，则可使用 registerdatastore 或 configuredatastore 实用程序重新添加数据。

运行 removemachine 移除备用计算机后，unregisterdatastore 实用程序仅可在主关系或切片缓存（主-备用模式）数据存储计算机上运行。运行 removemachine 实用程序移除数据存储的所有其他计算机后如果剩余一台计算机，则仅可运行切片缓存（聚类模式）或时空大数据存储的 unregisterdatastore。

语法

unregisterdatastore --stores {relational | tileCache | spatiotemporal | object} [--prompt {yes | no}]

如果您在同一台计算机上安装有多个类型的数据存储并希望一次取消注册多个数据存储，则指定用逗号分隔（不含空格）的每个数据存储类型。例如，要取消注册关系和切片缓存数据存储，则输入 --stores relational,tileCache。

示例

在此处运行 unregisterdatastore 实用程序以取消注册 GIS Server 站点中的关系和切片缓存数据存储。系统将返回提示信息（此为默认行为）。要禁止提示符，指定 --prompt No。

./unregisterdatastore.sh --stores relational,tileCache

You are going to unregister the data store.
Do you want to continue (Yes or No)?Yes

updatebackupretaindays

该实用程序适用于关系数据存储。

默认情况下，ArcGIS Data Store 将保留关系数据存储备份文件 7 天。通过运行 updatebackupretaindays 实用程序，您可以更改从备份目录中清除备份文件的频率。

只能在主关系数据存储计算机上运行 updatebackupretaindays 实用程序。

语法

updatebackupretaindays <number of days>

示例

在接下来的示例中会将备份文件保留时间更改为 10 天：

./updatebackupretaindays.sh 10

updatebackupschedule

该实用程序适用于关系、切片缓存和时空大数据存储。

默认情况下，ArcGIS Data Store 每四天创建一次关系数据存储的完整备份。您可以通过运行 updatebackupschedule 实用程序更改创建完整备份的频率。

切片缓存或时空大数据存储没有默认的自动备份。要为时空大数据存储设置自动备份计划，首先必须设置有效的备份位置。

使用 24 小时时钟表示法指定开始时间，例如，00:00:00 表示午夜以及 13:00:00 表示下午 1 点。使用频率选项指定备份间隔的天数。要禁用自动备份，将频率设置为 0。如果禁用自动备份，请确保运行 backupdatastore 实用程序以手动创建备份。

您可在主关系数据存储计算机上运行 updatebackupschedule 实用程序。该工具可在任何切片缓存或时空大数据存储计算机上运行。

语法

updatebackupschedule [--store {relational | tileCache | spatiotemporal}] [--starttime <local server time>] --frequency <number of days>

如果未指定新开始时间，则不会更改现有开始时间设置。如果未指定数据存储类型，则将假设为关系数据存储。

示例

在本示例中，将以每 10 天的频率在下午 11 点（本地服务器时间）对关系数据存储进行完整备份。

./updatebackupschedule.sh --starttime 23:00:00 --frequency 10

在本示例中，将为切片缓存数据存储设置备份计划。对所有切片缓存数据存储数据库的副本进行初始备份后，ArcGIS Data Store 每 14 天使用 configurebackuplocation 将新创建的数据存储数据库复制到指定位置一次。

./updatebackupschedule.sh --store tileCache --frequency 14

updatelicense

该实用程序适用于关系数据存储。

ArcGIS Server 许可到期后，必须更新 ArcGIS Server 站点的许可。许可信息也存储在 ArcGIS Data Store 关系数据存储中；因此，更新用于配置数据存储的 ArcGIS Server 站点的许可后，必须更新数据存储中的许可。为此，需在安装有主 ArcGIS Data Store 的计算机上运行 updatelicense 实用程序。如果您有备用 ArcGIS Data Store，则更新后的许可将复制到此处。

语法

updatelicense

示例

更新 ArcGIS Server 许可后，运行 updatelicense 实用程序将新许可移动至数据存储。

./updatelicense.sh

updatesslcertificate

该实用程序可用于所有数据存储类型。

您可以将用于验证托管服务器与数据存储之间的通信以及数据存储计算机间通信的自签名证书替换为由认证机构 (CA) 验证和签名的证书或域名证书。

语法

updatesslcertificate <source certificate file name with path> <password for the source certificate file> <alias for the certificate>

示例

收到 CA 签名证书文件后，运行 updatesslcertificate 以替换 ArcGIS Data Store 自签名证书。

./updatesslcertificate.sh /usr/files/mysignedcert.pfx ps4mycert dsmachinename

有关此主题的反馈?