ArcGIS Data Store REST commands
In this topic
When you configure ArcGIS Data Store, you associate it with an ArcGIS for Server site. Actions that change or check the status of the data store, or remove the data store from the ArcGIS for Server site, are performed from the ArcGIS Server Administrator Directory. (The URL format is https://gisserver.domain.com:6443/arcgis/admin.) The following sections summarize these operations and link to the ArcGIS API documentation.
Change the status of a data store machine
You can stop and restart individual machines in the data store. You can also promote a standby machine to be the primary.
Stopping the primary machine does not cause the data store to failover. You might do this if you need to temporarily take the data store offline, such as when upgrading.
For example, you change data store machine status as part of the following upgrade scenario:
- Stop the standby machine.
- Upgrade the standby.
- Start the standby.
- Promote the standby to primary using the makePrimary command.
- Stop the former primary machine.
- Upgrade the former primary.
- Start the former primary.
- Add the former primary machine back to the data store as the standby machine.
Log in to the ArcGIS Server Administrator Directory as the ArcGIS Server site administrator and go to a specific machine to use any of the following commands to change the status of a data store machine:
- stop
- start
- makePrimary (standby machines only)
For example, to get to the makePrimary command, go to data > items > enterpriseDatabases > <data store name> > machines > <machine name>.
Validate the data store
You can check the status of the machines in the data store using the validate ArcGIS Server REST command.
Log in to the ArcGIS Server Administrator Directory as the ArcGIS Server site administrator and click validate to see the health (healthy or unhealthy), status (started or stopped), and role (primary or standby) of each machine in the data store.
You might validate the data store to confirm a machine has been stopped or started, to confirm the standby was made primary after you used the makePrimary command, or as an initial troubleshooting step if hosted feature layers cannot be published or accessed.
Remove a standby machine
You can remove a standby machine from the data store using the remove ArcGIS Server REST command. For example, if you want to use a different computer for the standby, you could remove the old standby machine from the data store, install ArcGIS Data Store on the new machine, and configure the new machine as the standby.
Log in to the ArcGIS Server Administrator Directory as the ArcGIS Server site administrator to use the remove command.