Skip to main content

unregisterdatastore

This utility is used with all ArcGIS Data Store types.

You can use the unregisterdatastore utility to do the following:

  • Unregister a single-machine data store of any type from the hosting GIS Server site.

    Note:

    You must restart the hosting server after you unregister an object store.

  • In data stores running in primary-standby mode, you can unregister the primary machine after you remove the standby machine.

  • For spatiotemporal big data stores, you can unregister the last machine after you remove all the other machines from the cluster.

  • You can only remove one machine from a graph store cluster. If two machines in the graph store cluster fail, run the unregisterdatastore utility to unregister the entire cluster.

  • If more than one machine in a three-machine object store fails, run the unregisterdatastore utility to unregister the entire three-machine object store cluster.

When you unregister a machine from the data store, the hosting GIS Server site (or ArcGIS Knowledge Server site in the case of knowledge graphs) can no longer connect to that machine, and all services that contained data from the unregistered data store will no longer function. However, this utility does not delete the data; if you decide you still need the data store, you can use the registerdatastore or configuredatastore utility to add it back.

Note:

If you unregister the data store to permanently remove it from the deployment, delete the hosted layers that use the data before you unregister that data store.

Syntax

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

If you have more than one type of data store installed on the same machine and want to unregister more than one at a time, specify each data store type separated by a comma (no spaces).

Example

Here, the unregisterdatastore utility is run to unregister the relational store from the GIS Server site. A prompt is returned, which is the default behavior. To suppress the prompt, specify --prompt No.

./unregisterdatastore.sh --stores relational

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

unregisterdatastore --stores relational

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