Move an ArcGIS Data Store single-instance installation to another machine

If you need to replace the machine on which a single-instance ArcGIS Data Store installation is running, you can move the installation to another machine provided it is the only type running on that machine. You might do this if you want the data store to run on a newer, faster, or larger-capacity machine.

Note:

In the steps below, it is assumed that there is only one type of data store on the machine.

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

The method you use to move the ArcGIS Data Store depends on the type of data store you're moving and your tolerance for downtime.

The first set of instructions below can be used to move any type of single-instance ArcGIS Data Store, but this workflow requires the data store to be inaccessible for the longest amount of time. Options that result in less downtime are available for moving a relational data store or moving a spatiotemporal big data store.

Move any type of single-instance ArcGIS Data Store to a new machine

You can use backup and restore to move any type of single-instance ArcGIS Data Store.

When you use this workflow, the data store is unavailable until it is restored to the new machine.

To restore a single-instance ArcGIS Data Store to a new machine, complete the following steps:

1. Open a command shell on the ArcGIS Data Store machine.
2. Run the backupdatastore utility.

   See the utility reference for syntax and rules to run the backupdatastore utility for each data store type.

3. Run the unregisterdatastore utility to unregister the data store from the hosting server.

   See the utility reference for syntax and rules to run the unregisterdatastore utility for each data store type.

4. Install ArcGIS Data Store on the new machine, and choose the same data store type that you are moving.

   Note:

   Install the software only; do not proceed with configuring the data store.

5. Open a command shell on the new ArcGIS Data Store machine.
6. Run the restoredatastore utility with the backup you created in step 3 and use the following syntax:

   Replace values in brackets with information specific to your installation.

   restoredatastore --store <data store type> --target <name of backup file>
   --source-loc <backup file location> --data-dir <ArcGIS Data Store content directory location> 
   --server-url <URL of the hosting server in the format https://server.example.com:6443> 
   --server-admin <user name of the hosting server site administrator> 
   --server-password <password of the hosting server site administrator>

7. Test the hosted layers that access the restored data store to ensure that they function.

   If the restoration is successful and the hosted layers function as expected, you can uninstall ArcGIS Data Store from the retired machine.

   If there are problems with the restored data store, retain the installation on the old machine and contact Esri Technical Support or your Esri distributor to help you remove the failed data store and register the old installation with the hosting server.

Move a single-machine relational data store

If only one machine participates in the relational data store, you can add a standby relational data store machine that you will promote to be the primary machine. The old primary machine becomes the secondary machine, which you can remove and retire, leaving the relational data store on the new machine.

When you use this method to move the relational data store to a new machine, hosted feature layers are unavailable for a few seconds while the standby machine is promoted to be the primary machine.

To migrate a single-machine relational data store to a new machine, complete the following steps:

1. Install ArcGIS Data Store on the new machine.
2. Add the new machine to the existing relational data store as the standby machine.

   Depending on the amount of data in the relational data store, it may take several minutes for data to replicate to the standby machine.

3. Promote the new standby machine to be the primary machine, by doing the following:
   1. After all data from the primary machine has been replicated to the standby machine, sign in as the ArcGIS Server administrator to the ArcGIS Server REST API site for the hosting server.
   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 the standby machine.

   3. Access the hosted feature layers in the ArcGIS Enterprise organization and test that 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.
4. Uninstall ArcGIS Data Store from the machine you removed from the relational data store.

Move a single-machine spatiotemporal big data store

If only one machine participates in the spatiotemporal big data store, you can add a machine to it. After data has replicated to the new machine, remove the old machine.

To move a single-machine spatiotemporal big data store to a new machine, complete the following steps:

1. Install ArcGIS Data Store on the new machine.
2. Add the new machine to the existing data store.
3. Wait until all data has replicated from the old machine to the new machine.

   You can use the validate function in the ArcGIS Server Administrator Directory to determine if the data is replicated. If clusterStatus is set to green, the data is replicated.

   When replication completes, test the web layers that access the spatiotemporal big data store to ensure that they function; then remove the old machine from the data store as described below.

   1. Open a command shell on the old spatiotemporal big data store machine.
   2. Run the removemachine utility to remove the old machine from the data store.
4. Uninstall ArcGIS Data Store from the machine you removed from the spatiotemporal big data store.