Deployment

  • URL: http://server:port/arcgis/admin/system/deployment
  • Version Introduced:10.3.1

Description

ArcGIS Server has a deployment configuration resource that can control the load balancing functionality between GIS server machines:

Legacy:

Clusters have been deprecated. The use of clusters for new deployments is strongly discouraged and existing deployments are advised to migrate away from use of clusters as part of ongoing maintenance and upgrades.

  • singleClusterMode—At 10.4, in large sites with a single cluster, the site is configured to prevent load balancing between GIS server machines. This reduces network traffic between machines in the site and helps reduce load on your network. The default is true for new installations of ArcGIS Server, meaning that load balancing is disabled. Upgrades from earlier versions will set this property to true if the site uses a single cluster. Sites with multiple clusters cannot use singleClusterMode.

    To prevent load balancing, the following criteria must be met:

    • All machines in the site must participate in a single cluster. Multiple clusters cannot exist.
    • An external load balancer or ArcGIS Web Adaptor must be configured to forward requests to the site. If no external gateway exists, requests will only be handled by the machine designated in the request.

    To enable load balancing, set this property to false. Updating this property will restart all machines in the site.

    Note:

    As of 10.6, updates to this property will require a manual restart of ArcGIS Server.

    Note:

    As of 10.6, setting singleClusterMode property to false and restarting all ArcGIS Server machines will cause the server to use the Legacy architecture. For details, review the AppServer property.

Request parameters

ParameterDetails
f

Description: The response format. The default response format is html.

Values: html | json

Response format

{
    "<property>": <value>,
}

Example usage

{
    "singleClusterMode": true,
}