Configure ArcGIS Data Store default backup location

To recover a data store in the event of a catastrophe, such as machine failure or data corruption, you must have a backup of the data store. To ensure this, configure a secure backup location to which default (automated) backups can write files.

Tip:

To learn about other types of backups and backup management, see Manage ArcGIS Data Store backups.

Change the default backup location for the relational store

When you create a relational store, a backup location is automatically configured on the same machine as the data store. By default, ArcGIS Data Store creates backups of relational stores in /usr/arcgisdatastore/backup/relational. This is the default backup location.

When you create a relational store, a backup location is automatically configured on the same machine as the data store. By default, ArcGIS Data Store creates backups of relational stores in c:\arcgisdatastore\backup\relational. This is the default backup location.

However, it is not a good practice to keep backups on the same machine as the data store. If the primary data store machine fails, you can't access the backup files and cannot restore the hosted layer data. Another reason you should not leave backup files and the data store on the same machine is that the backup files can rapidly fill the disk space on the machine. If you run low on disk space, the data store will be placed in read-only mode to avoid data corruption, and you cannot publish new hosted layers.

Define a different, secure location to store backups for the relational store. To do this, use the change operation with the configurebackuplocation utility.

For relational stores, you can designate a shared file directory on another machine to use for the default backup location.

Note:

Ensure there is enough storage space to hold all the files that are included in a data store backup.
The rate at which the default backup location fills up depends on the backup schedule and the number of days you retain backups. Monitor the size of the backup directory and adjust these settings and storage sizes as needed.
All machines in the same data store must have access to the default backup location. For example, when you register a file share backup location for the relational store, both the primary and standby machines in the relational store must have write access to the file share location.

Note:

Ensure there is enough storage space to hold all the files that are included in a data store backup.
The rate at which the default backup location fills up depends on the backup schedule and the number of days you retain backups. Monitor the size of the backup directory and adjust these settings and storage sizes as needed.
All machines in the same data store must have access to the default backup location. For example, when you register a file share backup location for the relational store, both the primary and standby machines in the relational store must have write access to the file share location. This means that you must use a domain account to run the ArcGIS Data Store service.

If you used a local Windows account for the ArcGIS Data Store account when you installed, request a domain account from your domain administrator. The account needs to run the ArcGIS Data Store service and read and write files to the network directory where backup files will reside. Run the configureserviceaccount utility to set the domain account as the ArcGIS Data Store account.

Follow these steps to change the default backup location for a relational store:

Create a shared directory on another machine to store backup files.
Grant read and write access on the shared network directory to the account that installed ArcGIS Data Store.
If you did not specify a domain ArcGIS Data Store account when you installed or upgraded ArcGIS Data Store, set the data store service to run using a domain account now, and grant that account read and write access to a shared network directory.
Run the configurebackuplocation utility with the change option and the location option to specify the shared directory as the default output location for relational store backups.

If you run this utility for a relational store to use a shared directory after users published hosted feature layers and an automatic backup already took place, the configurebackuplocation utility will move the existing relational store backup files from the default backup location to the shared directory.

The location you specify cannot be a registered backup location.

In this example, the backup location for a relational store is changed to a shared directory named ds_backups on a computer named sysshare. The backup location is named reldefbu.
```
./configurebackuplocation.sh --operation change --store relational
--location "type=fs;location=/net/sysshare/ds_backups;name=reldefbu"


You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)? Yes
```
```
configurebackuplocation --operation change --store relational
--location "type=fs;location=\\sysshare\ds_backups;name=reldefbu"


You are going to change the backup location of the data store. Existing backups will be copied to the new location and it could take a few moments.
Please do not interrupt the process once it has started.

Do you want to continue (Yes or No)? Yes
```
For full syntax and additional examples, see ArcGIS Data Store command utility reference.

Register an initial default backup location for the graph, object, or spatiotemportal big data store

Upon creation, the graph store, object store, and spatiotemporal big data store do not have a default backup location. You must register at least one backup location before you can create backups of these types of data stores.

Register a secure, shared default backup location where ArcGIS Data Store can place files from scheduled (automatic) backups.

You can register a file share, Amazon S3 bucket, or Microsoft Azure Blob Storage container as the default backup location.

Note:

Ensure there is enough storage space to hold all the files that are included in a data store backup. Graph stores can be quite large and spatiotemporal big data stores and object stores tend to be even larger.
The rate at which the default backup location fills up depends on the backup schedule and how many manual backups you write to the default backup location. Monitor the size of the backup directory and adjust the schedule and storage sizes as needed.
All machines in the same data store must have access to the default backup location. For example, when you register a file share backup location for a spatiotemporal big data store, all machines in the spatiotemporal big data store must have write access to the file share location.

Follow these steps to configure a default location for data store backup files for the spatiotemporal big data store, object store, or graph store:

Create one of the following to store data store backup files:
- A shared directory on another machine
- An Amazon S3 bucket under your Amazon Web Services account
- A Microsoft Azure Blob Storage container under your Azure Blob Storage account
Grant read and write access to the location you configured in the previous step to the account that installed ArcGIS Data Store.
If you did not specify a domain ArcGIS Data Store account when you installed or upgraded ArcGIS Data Store, set the data store service to run using a domain account now, and grant that account read and write access to the location you configured in the previous step.
Run the configurebackuplocation utility with the register option to specify the default output location for data store backups.

See the sections that follow these steps for examples for each type of data store.

For full syntax and additional examples, see the ArcGIS Data Store utility reference.

Tip:

If the backup directory goes offline for more than a few minutes, perform a full manual backup of the data store as soon as a backup location is available.

Graph store example

In this example, a default backup location is registered for the graph store. The location is a file share directory named graphbu on sysshare. The backup location name is graph_defaultbu.

./configurebackuplocation.sh --operation register --store graph
--location "type=fs;location=/net/sysshare/graphbu;name=graph_defaultbu"

configurebackuplocation --operation register --store graph
--location "type=fs;location=\\sysshare\graphbu;name=graph_defaultbu"

Object store example

In this example, a default backup location is registered for the object store. The location is a file share directory named videobu on netshare. The backup location name is object_defaultbu.

./configurebackuplocation.sh --operation register --store object
--location "type=fs;location=/net/netshare/videobu;name=object_defaultbu"

configurebackuplocation --operation register --store object
--location "type=fs;location=\\netshare\videobu;name=object_defaultbu"

Spatiotemporal big data store example

In this example, a backup location is registered for a spatiotemporal big data store. The location is an Azure Blob Storage location named dsbackups. The backup location is named sbds_defaultbu. Credentials to access the Blob Storage location are provided.

./configurebackuplocation.sh --operation register --store spatiotemporal
--location "type=azure;location=dsbackups;name=sbds_defaultbu;username=azureaccountlogin;password=zpw4azureaccount"

configurebackuplocation --operation register --store spatiotemporal
--location "type=azure;location=dsbackups;name=sbds_defaultbu;username=azureaccountlogin;password=zpw4azureaccount"