Scale the ArcGIS Data Store object store

Summary

The ArcGIS Data Store object store can be deployed in one of two modes: as a single instance or as a cluster. For some organizations, a single instance ArcGIS Data Store object store may provide adequate performance to support their hosted scene layers, hosted 3D tiles layers, and other information that is stored in this type of ArcGIS-managed data store, such as the cached query responses for hosted feature layers. However, organizations who anticipate putting a lot of data into, and load on, their ArcGIS Data Store object store should deploy it in cluster mode. Cluster mode is the highly available configuration mode of the ArcGIS Data Store object store, as it can scale horizontally across three or more machines. When the ArcGIS Data Store object store is deployed in cluster mode, organizations can add additional machines to the object store cluster as storage and usage requirements grow.

You cannot change a single instance configuration of the ArcGIS Data Store object store to cluster mode after deploying it. Instead, organization administrators must perform the migration workflow detailed in this technical article to migrate their object store from one configured as a single instance to one that has been configured in cluster mode.

Procedure

Take a backup of ArcGIS Enterprise and the ArcGIS Data Store object store

1. Take a WebGISDR backup, including snapshots. This is needed in the event that you need to restore ArcGIS Enterprise from a backup in the event that you encounter issues with the migration.
2. Register a backup location for the ArcGIS Data Store object store. Once the location is decided, use the configurebackuplocation utility found in the ArcGIS Data Store tools directory to set the location where your backup will be taken.

Example:

configurebackuplocation.bat --location '<backup-location>' --operation register --store object

3. Backup the ArcGIS Data Store object store using the backupdatastore utility.

Example:

backupdatastore.bat <usergivenbackup name> --store object

Unregister the object store from the hosting server

1. After taking a backup of ArcGIS Enterprise and the ArcGIS Data Store object store, you will need to unregister the object store from your hosting server. This can be done using the unregisterdatastore utility.

Example:

Unregisterdatastore –stores object

2. As the utility reference documentation mentions, you must restart the hosting server after you unregister an object store. Restart the hosting server machine(s).
3. If the only ArcGIS Enterprise software installed on the single instance object store machine was the ArcGIS Data Store object store, and you’d like to recycle the machine to be one of the machines in the object store cluster, proceed with uninstalling the ArcGIS Data Store on this machine.

Install and then configure the ArcGIS Data Store object store

1. Install the ArcGIS Data Store on three machines, but do not configure it yet. You will create the object store in a later step.
2. On the first machine, use the restoredatastore utility to restore the data store using the object store backup taken prior to unregistering the object store.
   Use the following options when you run the utility:
   • --store: object
   • --server-url: <your hosting server URL>
   • --loaddata: false
   • --mode: cluster

Example:

restoredatastore --store object --target <user specified name of the backup> --source-loc <backup-location> --data-dir <c:\arcgisdatastore> 
--server-url <hostingservername> --server-admin <siteadmin> --server-password <siteadmin password> --mode cluster --loaddata false

3. On the second and third machines, run the configuredatastore utility to complete the configuration of the object store with the mode parameter set to cluster.

Example:

configuredatastore <serverURL> <serverAdmin> <serverAdminPassword> <directory> --mode cluster --stores object

Load data into the object store cluster

1. Navigate back to the first object store machine, where you ran the restoredatastore utility in step 2 of the previous section, "Install and then configure the ArcGIS Data Store object store", and run the utility again, this time with the loaddata parameter set to true. This second restore will load the data from the backup into the object store cluster.
2. After these steps are completed, validate that the object store is functioning as expected.