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.

Legacy:

At 10.2.2 and earlier versions, you were required to reference the Python directory and Python extension (.py) when executing the utilities from the command line. At 10.3, this is no longer required. You can run the utilities directly from the command line without referencing these Python dependencies.

If you implemented logic that automates the execution of these utilities, you need to update your scripts to remove the Python dependencies, for example:

  • <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 below for correct usage:

<ArcGIS Server installation location>/arcgis/server/tools/admin/managesite -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.

<ArcGIS Server installation location>/arcgis/server/tools/admin/managesite -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.

<ArcGIS Server installation location>/arcgis/server/tools/admin/managesite -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.

<ArcGIS Server installation location>/arcgis/server/tools/admin/managesite -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.

<ArcGIS Server installation location>/arcgis/server/tools/admin/managesite -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.

<ArcGIS Server installation location>/arcgis/server/tools/admin/managesite -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.

<ArcGIS Server installation location>/arcgis/server/tools/admin/managesite -u admin -p admin -s http://gisserver.domain.com:6080 -c geocluster -o start