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 Backing up and restoring your ArcGIS Server site configuration to learn about the backup and restore capabilities of ArcGIS Server.

This utility always uses token-based authentication.




The name of an ArcGIS Server user who will execute 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.


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


The URL of the site, in the following format:

You cannot perform the restore through the ArcGIS Web Adaptor URL.


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


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.


Prints help for the utility.


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

<Python installation location>\python.exe "C:\Program Files\ArcGIS\Server\tools\admin\" -u admin -p admin -s -f d:\mybackups\Jan-24-2013_13-25-23.agssite -r d:\mybackups

In this topic
  1. Parameters
  2. Examples