ArcGIS Server includes utilities that you can use to administer the server from the operating system command line. These are installed as a series of scripts in <ArcGIS Server installation location>/tools/admin. These utilities can be run directly from this location or by referencing the full path to the directory.
Note:
You must run these tools on the installation of Python that is included with ArcGIS Server.
With these utilities, you can do the following:
- Start and stop services.
- Publish services from a service definition file (.sd).
- Back up or restore a site configuration.
- Define new map caches.
- Build and delete map caches.
- Convert map cache formats from exploded to compact.
- Scan ArcGIS Server for security best practices.
Note:
These 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 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 is specified with the -u parameter. |
-s | The URL of the site, in one of the following formats:
|
-h | Prints help for the utility. |
--ignoressl | An optional parameter to disable SSL certification verification. |
These parameters are included in the following example:
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/manageservice -u admin -p admin -s http://gisserver.domain.com:6080