命令实用程序随 ArcGIS Data Store 一同安装,可为数据存储管理员提供管理数据存储的工具。此页面描述实用程序并提供语法和示例。
所有实用程序均必须运行于 ArcGIS Data Store 计算机上。您可在 <ArcGIS Data Store installation directory>\datastore\tools 目录中找到实用程序。
您可输入实用程序名称并在其后加 --help 以获得语法协助。
注:
您的登录帐户必须是 Windows 管理员组的成员并且您必须使用以管理员身份运行选项打开“命令提示符”以使用 ArcGIS Data Store 实用程序。
allowconnection
适用于关系数据存储。
出于安全方面的原因,默认通过 GIS Server 站点建立到数据存储的所有连接。如果您要打开从其他计算机连接的关系数据存储,可使用 allowconnection 命令实用程序。
只能在主关系数据存储计算机上运行 allowconnection 实用程序。
语法
allowconnection <host name> <user name> [<database>]
指定要连接到关系数据存储的计算机的名称(主机名)和数据存储使用的一个数据库帐户(用户名):数据存储管理员、复本所有者、地理数据库管理员或托管用户(发布要素图层数据的用户),您可以使用 listadminusers 实用程序或 listmanageduser 实用程序获取它们。您还可以指定主关系数据存储数据库的名称,但是,因为只有一个数据存储数据库,所以该值可选。
示例
在此示例中,当以 hqo.n_1E7 托管用户身份进行连接时,允许从 workcom 计算机连接到关系数据存储。
allowconnection 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 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 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 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 实用程序。
在默认情况下,关系数据存储备份文件存储在与数据存储相同的计算机上。如果无法访问安装有 ArcGIS Data Store 的计算机,您应该将备份文件移到另一台计算机上以确保可以访问。
使用域帐户设置要运行的 ArcGIS Data Store 服务,授予该帐户对共享网络目录的读写权限,并使用 changebackuplocation 实用工具将您的数据存储备份文件移动到其他计算机上的共享目录中。
changebackuplocation 实用程序仅适用于为关系数据存储创建的备份。
语法
changebackuplocation <new directory path> [--is-shared-folder {true | false}] [--keep-old-backups {true | false}]
如果备份位置在共享网络计算机上,请指定 --is-shared-folder true。如果您要将现有备份文件移动到新的位置,请指定 --keep-old-backups true。
changedatastoremode
适用于关系和时空大数据存储。
changedatastoremode 实用程序可用于将关系数据存储置于只读模式,同时对数据存储执行维护。例如,如果您需要执行会导致数据存储重启的维护任务(例如,将备份位置从一个驱动器更改为另一个驱动器或更改数据库属性),则您可以将关系数据存储置于只读模式,以便数据存储重启时,无任何用户会处于发布或编辑数据的过程中。
changedatastoremode 实用程序也可在完成维护或为主数据存储计算机增加足够磁盘空间后将关系数据存储转换回读写模式,从而使数据存储在读写模式下可以正常工作。
您必须在主关系数据存储计算机上而非备用计算机上运行 changedatastoremode 实用程序。
注:
如果 ArcGIS Data Store 由于磁盘空间不足而将关系数据存储置于只读模式,则系统也会禁用自动备份以避免进一步填满磁盘。因此,您需要在将关系数据存储转换回读写模式后使用 updatebackupschedule 实用程序重置自动备份计划。
当您的时空大数据存储即将用完磁盘空间时,ArcGIS Data Store 会将其置于只读模式,以避免数据损坏。从 10.8.1 开始,您可以在为时空大数据存储计算机添加足够的磁盘空间之后,使用 changedatastoremode 实用程序将时空大数据存储返回到读写模式。
语法
changedatastoremode {readonly | readwrite} [--prompt {yes | no}] --store {relational | spatiotemporal}
示例
在此示例中,将关系数据存储恢复为读写模式,意味着客户端可在进行以下操作时恢复此类活动:向门户发布托管要素图层、通过托管要素图层编辑数据或将 CSV 文件添加到 Map Viewer。
changedatastoremode readwrite --store relational --prompt no
要将时空大数据存储设置为读写模式,请使用 --store 选项指定 spatiotemporal,如以下示例所示:
changedatastoremode 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 参数支持的选项如下:
- admin:此为默认选项。指定 admin 在为切片缓存数据存储创建容器时,使用传输层安全性。
- data:指定 data 在将场景图层数据写入切片缓存数据存储时,使用传输层安全性。
- admin,data:指定 admin,data 在创建数据并将其写入切片缓存数据存储时,使用传输层安全性。
- none:指定 none 在创建和写入切片缓存数据存储时,通过托管服务器进行 HTTP 通信。
- heap-size:使用该参数更改用于时空大数据存储的堆内存数(以 MB 为单位)。默认情况下,启动此类型的数据存储将使用一半的可用 RAM。该参数不支持关系或切片缓存数据存储。
- rebalance:默认情况下,该参数设置为 true,这意味着如果任何一台计算机不可用,则时空大数据存储中的数据将数据分发到其他计算机。如果需要在一个时空大数据存储计算机上执行维护(例如对其进行升级),则可以通过将此参数设置为 false 来临时关闭重新均衡。rebalance 操作将在为 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 --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 --store spatiotemporal --max-rebalance-off 15
在此示例中,enablessl 参数用于在创建容器和将数据写入切片缓存数据存储时,将切片缓存数据存储配置为使用传输层安全性。
changedbproperties --store tileCache --enablessl admin,data
changeloglocation
适用于关系、切片缓存和时空大数据存储。
如果不希望数据存储使用 <ArcGIS Data Store installation directory>\arcgisdatastore\logs 的默认错误日志文件位置,则可以运行 changeloglocation 实用程序在其他目录中创建错误日志文件。
ArcGIS Data Store 帐户必须具有您指定的文件夹的写入权限。
语法
changeloglocation <directory path>
示例
在本示例中,将在本地目录 d:\datastorefiles\logs 中创建日志文件。
changeloglocation 'd:\datastorefiles\logs'
changenosqldslocation
适用于切片缓存数据存储。
如果您在切片数据存储中存储了大量高分辨率切片,则切片缓存数据存储可能会变大。在这种情况下,您可能需要将数据移动到同一服务器的另一驱动器中,或者移动到另一服务器的共享位置处。
如果您将数据移动到共享目录,必须向运行 ArcGIS Data Store 进程 (Linux) 或服务 (Microsoft Windows) 的用户授予目录的读写权限。
语法
changenosqldslocation <path> [--prompt {yes | no}]
示例
在本示例中,将在计算机 server2 上名为 dstorecache 的共享目录下创建存储场景图层缓存的数据库。
changenosqldslocation \\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 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 会在过渡位置提取压缩的备份文件。这表示您需要具有可兼容此未压缩数据的过渡位置。如果关系或切片缓存数据存储中存在大量数据,则您应该设置单独过渡位置并为恢复操作指定单独过渡位置。
设置包含切片缓存数据存储的过渡位置是 10.8.1 的新增功能。
语法
changestaginglocation <directory path>
示例
本例中指定的过渡位置是 \\netserver\rbustage。
changestaginglocation \\netserver\rbustage
configurebackuplocation
适用于关系、切片缓存和时空大数据存储。
使用 configurebackuplocation 实用程序可以指定 ArcGIS Data Store 为计划备份以及使用 backupdatastore 实用程序创建的备份写入备份文件的位置。您还可以通过此命令更改备份位置的属性和移除备份位置。
使用默认的本地备份位置创建关系数据存储。可通过使用 change 选项注册远程共享目录,以配置更安全的默认备份位置。
从 10.8.1 开始,以主-备用模式创建的切片缓存数据存储将具有默认备份位置;而在聚类模式下创建的 10.8 切片缓存数据存储和 10.8.1 切片缓存数据存储则没有该位置。无论哪种情况,都可使用 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 帐户的密钥。
您需要为 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:用于注册备份位置。您为切片缓存 (10.8) 或时空大数据存储定义的首个备份位置将被设置为默认备份位置。当您为切片缓存或时空大数据存储注册另一个备份位置时,将注册辅助备份位置。使用关系数据存储指定 register 选项时,将始终注册一个辅助备份位置。该辅助备份位置将存储使用 backupdatastore 实用程序生成的手动备份。
注:
使用 register 选项时,必须为 --location 选项提供信息。
- unregister:用于从数据存储中删除辅助备份位置。只要注册了一个备份位置,您就可以使用取消注册选项完全移除切片缓存或时空大数据存储的备份位置。
- list:列出为数据存储所注册的所有备份位置。
- setdefault:如果切片缓存或时空大数据存储有多个备份位置,可使用 setdefault 指定其中一个备份位置作为默认位置。该位置是计划备份的写入位置,如果在不指定备份位置的情况下运行 backupdatastore、listbackups 或 restoredatastore实用程序,则该位置也会用作默认位置。
- change:使用此选项可更改以下任意内容:
- --force {true | false}:此选项仅配合关系数据存储使用,可用于更改默认备份位置,即使现有默认备份位置不可用时也是如此。
更改关系数据存储的默认备份位置时,ArcGIS Data Store 会将现有备份文件从旧位置复制到新位置。如果 ArcGIS Data Store 无法访问旧位置,则无法复制文件。在之前版本中,这可能会造成 configurebackuplocation 工具运行失败。如果您希望继续更改默认备份位置,而不复制现有备份文件,请指定 --force true。
此选项的默认值为 false,这意味着如果 ArcGIS Data Store 无法访问现有默认位置,则您无法更改默认备份位置。
- --prompt {yes | no}:默认值为 yes。
示例
在第一个示例中,关系数据存储的备份位置设置为计算机 myshare 上名为 fsdata_bu 的目录。
configurebackuplocation --operation change --store relational --location \\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 --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 --operation register --store spatiotemporal --location type=fs;location=\\sharedmachine\ge_bu;name=fshare
在此示例中,将在 AWS 上为同一个时空大数据存储指定第二个备份位置。awsloc 名称会分配到备份位置。
configurebackuplocation --operation register --store spatiotemporal --location type=s3;location=mybucket;name=awsloc;username=abcdefg1234567;password=z9y8x7w6v5u4t3s2r1q0
在此示例中,将在 Azure 上为该时空大数据存储指定第三个备份位置。
configurebackuplocation --operation register --store spatiotemporal --location type=azure;location=myblobs;name=mazloc;username=myazureaccountlogin;password=zpw4myazureaccount
在此示例中,将 S3 设置为时空大数据存储的默认备份位置。
configurebackuplocation --operation setdefault --store spatiotemporal --location name=awsloc
在此示例中,列出了时空大数据存储的所有备份位置。
configurebackuplocation --operation list --store spatiotemporal Backup locations for spatiotemporal big data store: ================================================================ Name Type Location isDefault ================================================================ fsshare fs \\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}] [--nosql-only {true | false}] [--mode {primaryStandby | cluster}]
- <ArcGIS Server admin URL> - 此为已用作或将用作门户托管服务器的 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} - 指定要创建的数据存储的类型。虽然您可以指定由逗号分隔(不含空格)的每种存储类型以在同一台计算机上配置多个类型的数据存储,但不建议您这样操作。例如,要在同一台计算机的共享数据存储目录下配置关系和切片缓存数据存储,请指定 --stores relational,tileCache。Esri 强烈建议您在独立于其他数据存储或软件的计算机上运行时空大数据存储。如果不这样做,则可能导致性能下降,甚至导致数据存储不可用。
- --nosql-only - 此可选操作已于 10.5 中弃用,且在 10.8.1 之后将不受支持。在 10.5 之前的版本中,您可将 --nosql-only 选项设置为 true,以创建仅用于场景图层缓存切片的数据存储。该选项仍然存在,因此现有脚本可以继续运行,但在 10.8.1 之后该选项将被移除。所有脚本都应将 --stores 选项设置为 tileCache。
- --mode - 此可选操作是 10.8.1 中的新增功能,且仅适用于切片缓存数据存储。在 10.8.1 中,新的切片缓存数据存储默认通过 primaryStandby 模式进行创建,这意味着您可以在切片缓存数据存储中设置两台计算机。备用切片缓存数据存储中包含的数据与主数据存储相同。如果主数据存储运行失败,则备用数据存储将成为主切片缓存数据存储。如果您需要存储大量的场景图层缓存,并因此需要切片缓存数据存储进行扩展以包括三台或更多台计算机,请在 cluster 模式创建切片缓存数据存储。您也可以使用模式操作将切片缓存数据存储从一种模式切换到另一种模式。
配置数据存储的特定类型
您可以使用 --stores 选项的以下设置来指定要创建的数据存储类型:
- relational
- tileCache
- spatiotemporal
要在同一计算机上配置多个数据存储类型,请使用逗号来分隔各个类型。例如,要在同一台计算机上配置关系和切片缓存数据存储,请指定 --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,数据存储的数据目录是 C:\datastore\data\。
configuredatastore https://gisserver.mydomain.com:6443 admin Iph33l$ik c:\datastore\data\ --stores relational
在以下示例中,现有切片缓存数据存储被更改为聚类模式:
configuredatastore https://gisserver.mydomain.com:6443 portaladmin S00perSecret c:\datastore\scenedata\ --stores tileCache --mode cluster
configureserviceaccount
适用于关系、切片缓存和时空大数据存储。
configureserviceaccount 实用程序可更改 ArcGIS Data Store 帐户使用的登录信息。使用该实用程序设置帐户时,可将帐户信息导出到文件中。注意,文件中密码已加密。在某些情况下您可以使用该文件来导入同一帐户信息,例如,设置另一 ArcGIS Data Store 并希望使用相同的帐户时。在这种情况下,则在新的计算机上运行 configureserviceaccount 实用程序并导入包含帐户信息的文件。
也可以使用此实用程序更新 ArcGIS Data Store 帐户的密码。如果 Windows 帐户密码发生变化,则运行该实用程序并为帐户指定新的密码。
如果您将 ArcGIS Data Store 帐户设置为组托管服务帐户,则您指定了用户名参数的帐户可以在帐户名称末尾包括 $ 或将其省略。使用组托管服务帐户时,不需要指定密码参数。
语法
configureserviceaccount [--username <Windows account>] [--password <account password>] [--readconfig <user configuration file>] [--writeconfig <user configuration file>]
示例
在此示例中,configureserviceaccount 设置 mynetwork\datastore 帐户以运行 ArcGIS Data Store 服务并授予此帐户 ArcGIS Data Store 系统文件夹和文件的所需权限。
configureserviceaccount --username mynetwork\datastore --password SewL0ng
在本示例中,组托管服务帐户用于 ArcGIS Data Store 帐户:
configureserviceaccount --username mydomain\datastore-gmsa$ --writeconfig c:\temp\domainaccountconfig.xml
请注意服务运行时更改帐户可导致服务重新启动。
在此示例中,ArcGIS Data Store 帐户已更改,且帐户信息已写入位于 C:\adminfiles 的文件 (adsainfo) 中。
configureserviceaccount --username mynetwork\datastore --password SewL0ng --writeconfig C:\adminfiles\adsainfo.xml
在此示例中,ArcGIS Data Store 安装在不同的计算机上,且管理员使用在上一示例中创建的文件运行 configureserviceaccount 实用程序以设置同一帐户。
configureserviceaccount --readconfig C:\adminfiles\adsainfo
deletebackup
适用于关系数据存储。
deletebackup 实用程序用于删除为关系数据存储创建的备份文件。首先,运行 listbackups 实用程序以查看手动备份的名称和创建时间。然后,您可以运行 deletebackup 实用程序以删除不再需要的手动备份。
请注意,您只能删除不需要恢复备份。例如,您不能删除关系数据存储的最近完整备份。
语法
deletebackup <backup name> [--prompt {yes | no}]
示例
deletebackup 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 的计算机上的剩余可用磁盘空间量
- 关系数据存储将置于只读模式且时空大数据存储将停止的可用磁盘空间阈值
- 每类数据存储所使用的备份位置
- 关系或切片缓存数据存储的备份位置是否已在网络上共享
- 数据存储创建备份的频率(备份计划)
- 保留关系数据存储备份文件的天数
- 数据存储是否正在运行(数据存储状态)
- 备用关系数据存储成为主数据存储的日期和时间(上次故障转移);如果从未发生故障转移则不显示
- 参与关系或切片缓存数据存储的计算机的名称(成员计算机)
- 关系数据存储允许的最大连接
- 数据存储注册到 GIS Server 站点的 URL(所属系统 URL)
- 使用 GIS Server 站点作为其托管服务器的门户 URL(门户 URL)
- 连接到关系数据存储的当前要素图层数
- 当前参与时空大数据存储的所有计算机的列表(时空集群中的计算机)
- 当前指定为主计算机的时空大数据存储内部的计算机(集群内的当前主计算机)
- 时空大数据存储集群中所有计算机的列表(已注册的时空计算机);显示集群中的所有计算机(无论其处于何种状态)
语法
describedatastore
示例
describedatastore 实用程序将返回适用于计算机上所有数据存储的常规信息并返回包含特定于每种类型数据存储信息的特定单独部分。
虽然您很可能会将不同的数据存储放置在不同的计算机上,但是以下输出显示了将三种类型放置在同一台具有 ArcGIS Data Store 10.5 的计算机上,以便您可以查看每个类型的不同部分:
describedatastore General Information of ArcGIS Data Store on machine.domain.com ============================================================== ArcGIS Data Store release....10.5.0.7777 Staging location.............C:\arcgisdatastore\staging Log location.................C:\arcgisdatastore\logs Free disk space..............174.00GB Threshold for READONLY mode..1024MB Information for relational data store ds_sthiu0_5T ============================================================== Backup location...........\\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 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 Information for tile cache data store ds_wztxj7um ============================================================== Data location.......................C:\arcgisdatastore\nosqldata Data store status...................Started Backup location............C:\arcgisdatastore\backup Is backup folder shared.............false Tile cache location.................C:\arcgisdatastore\nosqldata Member machines.....................MACHINE1.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 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 master machine 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
exportmanageddb
旧版本:
Esri 已在 10.5.1 上弃用了 exportmanageddb 实用程序。此功能已整合到 backupdatastore 实用程序中。为使现有脚本继续运行,exportmanageddb 实用程序仍存在,但您应使用 backupdatastore 实用程序创建备份文件,然后使用 restoredatastore 实用程序从备份文件中恢复数据存储。
适用于关系和切片缓存数据存储。
exportmanageddb 实用程序创建关系数据存储的转储文件、有关数据存储的元数据以及所有存储托管场景图层切片缓存的数据库。如果您需要备份,以便在使用不同操作系统的计算机上恢复到 ArcGIS Data Store 安装或恢复到其他 ArcGIS Data Store 版本的安装,可导出数据存储。
在向新计算机导入数据存储之前,确保没有人编辑要素图层或向门户发布图层的用户。另请确保您导出数据存储的位置包含足以保存关系数据存储转储文件的存储空间以及所有托管场景图层缓存数据库的副本。
exportmanageddb 实用程序不能导出时空大数据存储。
语法
exportmanageddb <output location> <backup name> [options]
输出位置即磁盘中创建文件夹 (<backup name>) 和导出文件的位置。您必须对该位置具有写入权限。
支持的选项如下:
- [--stores {relational | tileCache}]:指示要导出的数据存储类型。如果关系和切片缓存数据存储在同一台计算机上运行并且您希望导出这两种数据存储,则指定用逗号分隔的两种数据存储;例如,输入 --stores relational,tileCache。如果未指定 --stores 选项,则将假设为关系存储。
- [--include-tilecache {true | false}]:此选项是为了实现向后兼容性。如果未指定 --stores 选项或指定 --stores relational,则可以控制是否使用此选项导出切片缓存数据存储。
- [--prompt {yes | no}]:确定您是否必须回答提示问题才能运行实用程序。
示例
在以下示例中,将转储文件、托管场景图层缓存数据库副本及相关数据存储文件输出到名为 backupserver 的服务器上的 movedsfirstexp 共享网络目录中。
exportmanageddb \\backupserver movedsfirstexp --stores relational,tileCache You are attempting to back up database 'db_e3hsm and nosql databases'. This 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
importmanageddb
适用于关系和切片缓存数据存储。
如果您导出的 ArcGIS Data Store 包含托管要素图层或托管场景图层缓存数据库(或两者),则可使用 importmanageddb 实用程序恢复数据存储。您可以恢复到升级后的 ArcGIS Data Store 计算机,或者与源 ArcGIS Data Store 使用不同操作系统的计算机上的 ArcGIS Data Store 安装。
如果您希望如之前一样通过同一个 GIS Server 站点注册 ArcGIS Data Store,则指定--boundtrue 且不指定 --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 站点配置数据存储。
- 如果指定 --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 和管理员凭据。
- [--prompt {yes | no}]:确定您是否必须回答提示问题才能运行实用程序。
示例
在下面的示例中,数据存储恢复到版本较新的 ArcGIS Data Store 安装。新的 ArcGIS Data Store 数据目录已指定。数据存储仍与现有 GIS Server 站点绑定,因此数据存储和现有托管要素和场景图层仍然可用。重新启动 GIS Server 站点以允许托管要素和场景图层发布到新计算机上。
importmanageddb \\backupserver\expdir preupgradeexp --data-dir c:\arcgis\datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.4s --bound true
在本例中,GIS Server 站点和关系数据存储均已移动至新的计算机上。Web 服务已移动至新的 GIS Server 站点中,因此新站点的 URL 通过 --server-url 选项进行指定。备份名称是 movedbexp,且备份存储在 \\backupserver\expdir 下。
importmanageddb \\backupserver\expdir movedbexp --data-dir c:\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,且备份存储在 \\backupserver\expdir\movingexp2 下。
importmanageddb \\backupserver\dbdump\movingexp2 movedsfirstexp --data-dir c:\arcgis\datastore --stores relational,tileCache --bound false
listadminusers
适用于关系、切片缓存和时空大数据存储。
Listadminusers 实用程序针对关系数据存储的管理员、复本所有者和地理数据库管理员返回用户名和密码。该实用程序返回切片缓存和时空大数据存储的管理员。
语法
listadminusers
示例
在此示例中,listadminusers 在仅安装了关系数据存储的计算机上运行。
listadminusers Admin users for relational data store ds_abcd1234 ================================================= Database Admin User.... adm_32ret / tT30sbYk22jF Database Repl User..... dsrepuser / uWn/MV0678h4 GDB Admin User......... sde / iO=Qst751epb
在此示例中,listadminusers 在仅安装了时空大数据存储的计算机上运行。
listadminusers Admin users for spatiotemporal big data store bds_abcd1234 ================================================= Store admin user.... els_321ret / B1as70fF1
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 存储容器名称。
示例
在本例中,将列出关系数据存储的备份:
listbackups --store relational Backup_Name Status Backup_Time Mode ========================================================================== phase1proj_bu BackupComplete 2014-03-08 14:12 manual phase2proj_bu BackupComplete 2014-06-21 11:43 manual ds_gdt1oomh-201411030300 BackupComplete 2014-11-01 03:00 scheduled Backups located at: '\\myserver.net.com\dsbackups'
在本例中,为名称为 sbdsbu 的备份位置列出了时空大数据存储备份:
listbackups --store spatiotemporal --location name=sbdsbu Backup_Name Status Backup_Time Mode ======================================================================= backup1 BackupComplete 2016-07-11 09:47 manual Backups located at: '\\myserver.net.com\spatiotemporal'
listmanageduser
适用于关系、切片缓存和时空大数据存储。
listmanageduser 实用程序将返回关系和时空大数据存储中托管要素图层数据所有者帐户的用户名和密码。此实用程序还将返回切片缓存数据存储数据所有者的用户名和密码。
语法
listmanageduser
示例
在以下示例中,listmanageduser 在包含关系和切片缓存数据存储的计算机上运行。此计算机为主关系数据存储。
listmanageduser
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
Managed user for spatiotemporal big data store bds_6udbx4321 ============================================================= UserName Password fmr_o1He3 5vZggkPbaw+T
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}
如果您在同一台计算机上安装了多个不同类型的数据存储,则您可通过指定用逗号分隔(不含空格)的数据存储类型同时注册这些数据存储;例如,输入 --stores relational,tileCache。
示例
在本示例中,关系数据存储使用 URL https://gisserver.domain.com:6443 重新注册到 GIS Server 站点。ArcGIS Server 主站点管理员用户名为 agsadmin,密码为 Tan$p0n。
registerdatastore 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 gefour --store spatiotemporal
在此示例中,托管服务器站点不可用,并从数据存储中移除了名为 fsdata 的关系数据存储计算机。
removemachine fsdata --store relational --force true
removestandbymachine
旧版本:
Esri 已弃用 removestandbymachine 实用程序。它仍然存在以允许现有脚本继续运行,但您应开始改用 removemachine 实用程序。
您可以通过 ArcGIS Server 站点管理员使用移除 ArcGIS Server REST 命令从关系数据存储中移除备用计算机。但是,如果 GIS Server 站点不可用,您将无法以站点管理员身份登录来执行此操作。在这些情况下,运行 removestandbymachine 实用程序以从数据存储中移除备用计算机。
removestandbymachine 实用程序只能在关系数据存储的备用计算机上运行。
语法
removestandbymachine <machine name> --store {relational | tileCache} [--prompt {yes | no}]
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 <location of source backup files>]:这是您要用于恢复数据存储的备份文件的位置。这将是文件共享位置的路径、备份位置名称或 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 站点对其进行配置。但是,使用数据存储中的数据的图层将不会存在。您必须连接到数据存储数据库才能将数据提取为其他格式,并将其重新发布到门户。
示例
在本示例中,最新备份来自默认关系数据存储备份位置,并将恢复到现有数据存储中。由于默认存储类型为关系存储,且在默认情况下该数据存储仍会受到所注册的 GIS Server 站点的限制,因此您无需指定 --store relational 或 --bound true。但是,必须指定 GIS Server URL 和管理员凭据。
restoredatastore --target most-recent --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.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 --target 2014-07-17-14:30:00 --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.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 --target movedatastore --source-loc \\buserver\data\backups\relational --data-dir C:\datastore --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.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 --store tilecache --source-loc \\buserver\scenedata\backups\tilecache --data-dir C:\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 --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 --target bds1 --store spatiotemporal --source-loc name=awsloc --server-url https://gisserver.domain.com:6443 --server-admin siteadmin --server-password $Aup.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 workcom hqo.n_1E7
unregisterdatastore
适用于关系、切片缓存和时空大数据存储。
您可以使用 unregisterdatastore 命令实用程序执行下列操作:
- 取消注册 GIS Server 站点中的主关系数据存储计算机。
请注意,如果您有备用计算机,在您取消注册主机之前,必须首先将其从数据存储中移除。
- 取消注册单机切片缓存或时空大数据存储。
注:
要取消注册,必须先删除使用数据存储中的数据的托管图层。如果不执行此操作,门户中将留有不可用的图层,且托管服务器中将运行不可用的服务。
如果您决定不再使用数据存储或基于数据存储的服务,则应从 GIS Server 站点取消注册数据存储。取消注册数据存储的计算机时,GIS Server 站点不能再连接到该计算机,并且所有包含取消注册数据存储数据的服务都将不再运行。但是,此命令并不会删除数据;如果您仍然决定需要数据存储,则可使用 registerdatastore 或 configuredatastore 实用程序重新添加数据。
运行 removemachine 实用程序以移除备用计算机后,unregisterdatastore 实用程序仅可在主关系数据存储计算机上运行。运行 removemachine 移除数据存储的所有其他计算机后如果剩余一台计算机,则仅可运行切片缓存或时空大数据存储的 unregisterdatastore。
语法
unregisterdatastore --stores {relational | tileCache | spatiotemporal} [--prompt {yes | no}]
如果您在同一台计算机上安装有多个类型的数据存储并希望一次取消注册多个数据存储,则指定用逗号分隔(不含空格)的每个数据存储类型。例如,要取消注册关系和切片缓存数据存储,则输入 --stores relational,tileCache。
示例
在此处运行 unregisterdatastore 实用程序以取消注册 GIS Server 站点中的关系和切片缓存数据存储。系统将返回提示信息(此为默认行为)。要禁止提示符,指定 --prompt No。
unregisterdatastore --stores relational,tileCache You are going to unregister the data store. Do you want to continue (Yes or No)?Yes
updatebackupretaindays
适用于关系数据存储。
默认情况下,ArcGIS Data Store 将保留关系数据存储备份文件七天。通过运行 updatebackupretaindays 实用程序,您可以更改从备份目录中清除备份文件的频率。
只能在主关系数据存储计算机上运行 updatebackupretaindays 实用程序。
语法
updatebackupretaindays <number of days>
示例
在接下来的示例中会将备份文件保留时间更改为 10 天:
updatebackupretaindays 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 --starttime 23:00:00 --frequency 10
在本示例中,将为切片缓存数据存储设置备份计划。对所有切片缓存数据存储数据库的副本进行初始备份后,ArcGIS Data Store 每 14 天使用 configurebackuplocation 将新创建的数据存储数据库复制到指定位置一次。
updatebackupschedule --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
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 C:\myfiles\mysignedcert.pfx ps4mycert dsmachinename