ArcGIS Server includes some scriptable utilities that allow you to administer the server from batch files or the operating system command line. These are installed as a series of Python scripts in <ArcGIS for Server installation location>\tools\admin.
With these utilities, you can do things such as:
- Start and stop services
- Add and remove machines from a cluster
- Publish services from a service definition (.sd) file
- Back up or restore a site configuration
- Define new map caches
- Build and delete map caches
- Convert map caches between exploded and compact formats
- Scan ArcGIS Server for security best practices
Note:
The utilities only support token-based authentication. If your site uses web-tier authentication, you'll need to run these scripts using a built-in account and specify the local URL to your site, as described in the section below.
Common parameters
The parameters described in the following table are used in many of the utilities:
| Parameter | Details |
|---|---|
-u | The name of an ArcGIS Server user who will execute the utility. The user must have the appropriate level of privileges to execute the action. 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 was specified with the -u parameter. |
-s | The URL of the site, in one of the following formats:
|
-h | Prints help for the utility. |
In the following example, you can see these parameters at work. This example uses the -lc (list clusters) command of the Manage Site utility to list the clusters in the site:
<Python installation location>\python.exe "C:\Program Files\ArcGIS\Server\tools\admin\managesite.py" -u admin -p admin -s http://gisserver.domain.com:6080 -lc
===Clusters on this site===
- default
- geocluster