Skip To Content

Restore utility

This utility restores your site configuration based on a backup that you have previously made using the Backup utility. See Back up and restore your ArcGIS Server site configuration to learn about the backup and restore capabilities of ArcGIS Server.

This utility always uses token-based authentication.

During the restore process, the following values are retained from the target site:

  • Security information
    • SSL configuration
    • AD/LDAP user configuration
    • Proxy settings
  • Configuration store and site directory paths
  • Machine names and admin URLs

Parameters

ParameterDetails

-u

The name of an ArcGIS Server user who will run the utility. This doesn't need to be the same user who created the backup. If your site is configured with web-tier authentication, specify a built-in user, such as the primary site administrator account.

-p

The password of the user who is specified with the -u parameter.

-s

The URL of the site, in one of the following formats:

  • https://gisserver.domain.com:6443
  • https://webadaptorhost.domain.com/webadaptorname
If your site is configured with web-tier authentication, you'll need to specify the local URL to your site.

-f

The absolute path of the .agssite backup file to be restored. The ArcGIS Server account must have permission to read from this location.

-r

Path to a folder where the utility will generate its report. The ArcGIS Server account must have write permissions to this folder. The report is always written to the console, regardless of whether you provide this path.

-h

Prints help for the utility.

--ignoressl

An optional parameter to disable SSL certification verification.

-a

An optional property that specifies the location of a properties file, for instance, /home/arcgis/serverbackups/restore.properties. The properties file must contain the following properties:

  • User name
  • Password
  • Site
  • File

site=https://gisserver.domain.com:6443/arcgis
username=administrator
password=securepassword
file=/home/arcgis/backups/backupfilename.agssite

Examples

The following example restores a backup from a file named Jan-24-2013_13-25-23.agssite:

Legacy:

If you implemented logic that automates the execution of these utilities, you need to update your scripts to remove the Python dependencies. The following are examples:

  • <ArcGIS Server installation location>/arcgis/server/tools/python
  • The .py extension when referring to the name of the command line utility

See the following example for correct usage:

<ArcGIS Server installation location>/arcgis/server/tools/admin/restore -u admin -p admin -s http://gisserver.domain.com:6080 -f /tmp/mybackups/Jan-24-2013_13-25-23.agssite -r /tmp/mybackups

In this topic
  1. Parameters
  2. Examples