Skip to main content

removemachine

This utility is used with all ArcGIS Data Store types.

Use the removemachine utility to remove a machine from a data store that contains more than one machine. The removemachine utility is used in the following scenarios:

  • Remove a standby machine from a relational store.

    You can run this utility on the standby machine or from the primary machine in the case where the standby machine is unavailable.

  • Remove one machine from an object store cluster.

    You can run this utility on any machine in the object store cluster to remove the machine that you specify.

    Because an object store cluster must contain at least three machines, you cannot remove a machine from the cluster if there are only three machines in it. If removing a machine would leave the cluster with fewer than three machines, you must add a machine to the cluster before you run this utility to remove a machine.

  • Remove one machine from a graph store cluster.

    You can run this utility on any machine in the graph store cluster. However, you can only run this to remove a failed machine; in other words, a machine that is no longer accessible and that you could not bring back online. When you run this utility, the machine that you specify is marked for removal.

    Because a graph store cluster must contain three machines, you must add a machine to replace the one you've marked for removal. Once you've added a new third machine to bring the cluster back to a healthy state, the machine that you marked for removal will be unregistered from the cluster.

    You can only mark one machine for removal from the cluster. If two machines in the cluster failed, you must restore the graph store.

    You cannot run the removemachine utility on a graph store that is running in single instance mode.

  • Remove a machine from a spatiotemporal big data store.

    You can run this utility on any machine in the spatiotemporal big data store, but you cannot run removemachine on a spatiotemporal big data store composed of only one machine.

    If you run this utility on the current coordinator machine, one of the remaining manager-eligible machines in the cluster must take over as the current coordinator. There must be at least two other machines in the cluster that are assigned the manager role for this to happen. Before removing a machine, run the describedatastore utility to identify which machine is the current coordinator and which ones are eligible to become the coordinator.

Syntax

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

You must provide the machine name and the data store type.

Specify true with the --force option only if the registered ArcGIS Server site is unavailable.

By default, you'll be prompted to confirm running the utility. If you do not want to confirm the action, specify no with the --prompt option.

Examples

In this example, the spatiotemporal big data store machine, gefour, is removed from the data store.

./removemachine.sh gefour --store spatiotemporal --prompt no

removemachine gefour --store spatiotemporal --prompt no

In this example, the hosting server site is unavailable and the relational store machine, fsdata, is removed from the data store.

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

removemachine fsdata --store relational --force true --prompt no