Skip To Content

Move an ArcGIS Data Store installation to another machine

You can move an ArcGIS Data Store installation from one machine to another by adding a machine to the data store and retiring the old machine. You might do this if you want the data store to run on a newer, faster, or larger-capacity machine.

Before you proceed with any of the steps below, create a full backup of the ArcGIS Data Store type to be moved.

The steps below assume there is only one type of data store on each machine.

Move a single-machine data store

If only one machine participates in the relational, tile cache (primary-standby mode), or spatiotemporal big data store, do the following to migrate it to a new machine:

  1. Install ArcGIS Data Store on the new machine.
  2. Add the new machine to the existing data store.
  3. The next step varies depending on the type of data store you're moving.
  4. For a relational or tile cache data store running in primary-standby mode, promote the new standby machine to be the primary machine, as described below.

    The old primary machine will become the standby machine. You can then remove the standby machine from the data store.

    1. After all data from the primary machine has been replicated to the standby machine, sign in to the ArcGIS Server REST API site for the hosting server as the ArcGIS Server administrator.
    2. Go to data > items > enterpriseDatabases > <data store name> > machines > <standby machine name> and click makePrimary.

      This promotes the standby machine you just added to act as the primary machine. When the new primary machine is online, the old primary will become a standby machine.

    3. Access the hosted feature layers and hosted scene layers in the portal to ensure they still function properly.
    4. Use the ArcGIS Server REST API remove command to remove the old primary machine from the data store. Go to data > items > enterpriseDatabases > <data store name> > machines > <old primary machine name> and click remove.
  5. For a spatiotemporal big data store, wait until all data has replicated from the old machine to the new machine. When that completes, test the web layers that access the spatiotemporal big data store to ensure they function, then remove the old machine from the data store, as described below.
    1. Open a command window on one of the spatiotemporal big data store machines.
    2. Run the removemachine utility to remove the old machine from the data store.
  6. Uninstall ArcGIS Data Store from the machine you removed from the data store.

Move a two-machine relational or tile cache data store

If the relational data store or tile cache data store running in primary-standby mode contains a primary and standby machine and you want to replace both machines, do the following:

  1. Install ArcGIS Data Store on the two new machines but do not proceed with configuration yet.
  2. Run the removemachine utility to remove the existing standby machine from the data store.
  3. Add one new machine as a standby to the existing relational or tile cache data store.
  4. When all web layer data from the primary machine has been replicated to the standby machine, use the makePrimary command in the ArcGIS Server REST API site to promote the standby to be the primary machine.
    1. Sign in to the ArcGIS Server REST API site for the hosting server as the ArcGIS Server administrator.
    2. Go to data > items > enterpriseDatabases > <data store name> > machines > <standby machine name> and click makePrimary.

    When the new primary machine is online, the old primary will become a standby machine.

  5. Access the layers in the portal to ensure they still function properly.
  6. Use the remove command in the ArcGIS Server REST API site to remove this standby machine (the old primary machine) from the data store.

    Go to data > items > enterpriseDatabases > <data store name> > machines > <old primary machine name> and click remove.

  7. Uninstall ArcGIS Data Store from the machine you removed from the data store.
  8. Add the second machine as a standby to the data store.

Move machines in a multimachine spatiotemporal big data store

To replace more than one machine in a multimachine spatiotemporal big data store, add a new machine for each machine you want to replace. When the spatiotemporal big data store finishes replicating data to the new machines, remove the machines you want to retire, one at a time.

Note:
You must wait for the spatiotemporal big data store to rebalance content across the machines before you remove the next machine.

  1. Install ArcGIS Data Store on each new machine.
  2. Add the new machine or machines to the existing spatiotemporal big data store.
  3. When the spatiotemporal big data store finishes replicating data to the new machines, test the web layers in the portal to ensure they're functioning.
  4. Remove one machine from the spatiotemporal big data store.

    You can use the removemachine utility or the remove command in the ArcGIS Server REST API site.

  5. When the data has been rebalanced among the remaining machines, you can remove the next machine, if applicable.
  6. Uninstall ArcGIS Data Store from the machine you removed from the data store.