Skip To Content

Back up and restore your deployment

ArcGIS Monitor administrators should make periodic backups of their deployment so that it can be restored in the event of hardware failure, human error, or migration.

Make a backup of Monitor Server and Monitor Agent

To make a backup of the ArcGIS Monitor Server and ArcGIS Monitor Agent machines in your deployment, complete these steps:

  1. Sign in to the Monitor Server machine with an account that has access to the Monitor Server installation location.
  2. Back up the <ArcGIS Monitor account username home directory>/.config/ESRI/ArcGISMonitor/config-store-<server or agent> directory.
  3. Sign in to each Monitor Agent machine with an account that has access to the Monitor Agent installation location and repeat step 2 for each Monitor Agent machine in the deployment.

Make a backup of the Monitor database

To back up the Monitor database, you must have read access to all of the Monitor database's tables. The following steps back up the Monitor database using the PostgreSQL pg_dump utility. Depending on your organization's database infrastructure, you may need to use another method to back up the Monitor database. To back up the Monitor database with the pg_dump utility, complete these steps:

  1. Sign in to the machine that contains the Monitor database with an account that has permissions to perform administrative operations on the Monitor database.
  2. Back up the Monitor database.

Restore your Monitor deployment

To ensure a successful restoration, backups should be restored in the order listed below. Depending on the type of failure or migration, you may not need to perform all of these steps. To restore your Monitor deployment, complete these steps:

  1. Restore the Monitor database.
  2. Monitor Server, if necessary.
  3. Sign in to the Monitor Server machine with an account that has access to the Monitor Server installation directory.
  4. Open a command shell.
  5. Run the following command to stop the arcgis-monitor service.
    • Ubuntu: sudo service arcgis-monitor stop
    • Red Hat Enterprise Linux Server: sudo systemctl stop arcgis-monitor
  6. Delete the <ArcGIS Monitor account username home directory>/.config/ESRI/ArcGISMonitor/config-store-server directory.
  7. Copy the backup of the Monitor Server configuration store to the <ArcGIS Monitor account username home directory>/.config/ESRI/ArcGISMonitor/config-store-server directory.

    Ensure that the ArcGIS Monitor account retains full read/write permissions to the configuration store directory.

  8. Run the following command to start the arcgis-monitor service:
    • Ubuntu: sudo service arcgis-monitor start
    • Red Hat Enterprise Linux Server: sudo systemctl start arcgis-monitor
  9. Access Monitor to verify the status of the restoration.
  10. Install Monitor Agent, if necessary.
  11. Sign in to the Monitor Agent machine with an account that has access to the Monitor Agent installation directory.
  12. Open a command shell.
  13. Run the following command to stop the arcgis-monitor service.
    • Ubuntu: sudo service arcgis-monitor stop
    • Red Hat Enterprise Linux Server: sudo systemctl stop arcgis-monitor
  14. Delete the <ArcGIS Monitor account username home directory>/.config/ESRI/ArcGISMonitor/config-store-agent directory.
  15. Copy the backup of the Monitor Agent configuration store to the <ArcGIS Monitor account username home directory>/.config/ESRI/ArcGISMonitor/config-store-agent directory.

    Ensure that the ArcGIS Monitor account retains full read/write permissions to the configuration store directory.

  16. Run the following command to start the arcgis-monitor service:
    • Ubuntu: sudo service arcgis-monitor start
    • Red Hat Enterprise Linux Server: sudo systemctl start arcgis-monitor
  17. Repeat steps 10 through 16 to restore other Monitor Agent machines in the deployment as necessary.
  18. Verify that the Monitor Agent machines are connected to Monitor Server and refresh Monitor Agent connections as necessary.

Related topics