Skip To Content

Manage Site utility

In this topic

The Manage Site utility allows you to perform various ArcGIS Server site administration tasks from the command line, including adding and removing machines from clusters. You can also view the machines participating in any given cluster.

Parameters

ParameterDetails

-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:

  • http://gisserver.domain.com:6080
  • http://webadaptor.domain.com/arcgis
If your site is configured with web-tier authentication, you'll need to specify the local URL to your site.

-lc

Lists the clusters in the ArcGIS Server site.

-c

The name of the cluster, if you are performing an action on a cluster.

-l

Lists the machines in the cluster you specified with the -c parameter.

-o

The start or stop operation you want to perform on the cluster you specified with the -c parameter. The operation START starts all the machines in the cluster. The operation STOP stops all the machines in the cluster. The CHKSTATUS operation is not currently implemented.

-R

The fully qualified name of a machine you want to remove from the cluster you specified with the -c parameter.

-A

The fully qualified name of a machine you want to add to the cluster you specified with the -c parameter.

-D

Deletes the cluster you specified with the -c parameter.

-cr

Creates the cluster you specified with the -c parameter. Currently, this command is not functional due to a known issue.

-h

Prints help for the utility.

Examples

The following example lists the clusters participating in the ArcGIS Server 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

The following example lists the GIS server machines participating in the default cluster.

<Python installation location>\python.exe "C:\Program Files\ArcGIS\Server\tools\admin\managesite.py" -u admin -p admin -s http://vanguard:6080 -c default -l
===Machines on this cluster===
- VANGUARD.ESRI.COM
- BIRDLAND.ESRI.COM

The following example deletes the cluster named geocluster from the ArcGIS Server 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 -c geocluster -D

The following example removes the machine BIRDLAND.ESRI.COM from the default cluster.

<Python installation location>\python.exe "C:\Program Files\ArcGIS\Server\tools\admin\managesite.py" -u admin -p admin -s http://vanguard:6080 -R BIRDLAND.ESRI.COM -c default

The following example adds the machine BIRDLAND.ESRI.COM to the default cluster.

<Python installation location>\python.exe "C:\Program Files\ArcGIS\Server\tools\admin\managesite.py" -u admin -p admin -s http://vanguard:6080 -A BIRDLAND.ESRI.COM -c default

The following example stops all GIS servers in the cluster named geocluster.

<Python installation location>\python.exe "C:\Program Files\ArcGIS\Server\tools\admin\managesite.py" -u admin -p admin -s http://gisserver.domain.com:6080 -c geocluster -o stop

The following example starts all GIS servers in the cluster named geocluster.

<Python installation location>\python.exe "C:\Program Files\ArcGIS\Server\tools\admin\managesite.py" -u admin -p admin -s http://gisserver.domain.com:6080 -c geocluster -o start