Skip To Content
ArcGIS Developers
Dashboard

Edit Machine

Description

This operation allows you to make changes to the configuration of the specified machine in your ArcGIS Server site.

Note:

Editing the machine configuration causes the machine to be restarted. It's recommended that you perform this operation during low usage.

Request parameters

ParameterDescription
adminURL

The URL where the Administrator API is running on the server machine.

Caution:

It is recommended that you keep the default URL.

Example

https://machine:6443/arcgis/admin
webServerMaxHeapSize

This property defines the maximum file size (in MB) that the web server's Java process can send to ArcGIS Server. The default value is -1 MB, meaning the web server will use one-fourth of the available system memory as the maximum heap size.

If you are observing a server performance impact and you have additional system memory, you can increase the heap size of the web server by updating this value from the default of -1 MB to an appropriate value. Note that doing so will potentially increase the amount of memory assigned to ArcGIS Server processes by your operating system.

If you have a multiple-machine site, this property should be identical on each of your machines.

Example

webServerMaxHeapSize=-1
webServerCertificateAlias

The alias of the web server SSL certificate.

Example

webServerCertificateAlias=server1
appServerMaxHeapSize
Legacy:

This property has no utility in 10.6 and later versions, due to changes in the application server at 10.6.

This property defines the maximum file size that the internal application server's Java process can send to ArcGIS Server. The default value is 256 MB. If you have a multiple-machine site, this property should be identical on each of your machines.

socMaxHeapSize

This property defines the maximum file size (in MB) that an individual ArcSOC process can send to the ArcGIS Server internal web server. The default value is 64 MB. You may choose to increase this property if you are experiencing performance impacts in your services, for example, if a service is failing to pass a very large JSON file to the server site. If you only want to change the maximum heap size for a specific service, you can do so by specifying the javaHeapSize framework property in the Edit Service operation.

If you have a multiple-machine site, this property should be identical on each of your machines.

Example

socMaxHeapSize=64
underMaintenance

Introduced at 10.7, this property is a flag you can use to designate the machine as being under maintenance (by you, not by the ArcGIS Server site itself). The default value is false. When set to true, this causes the machine to fail its regular health check report.

Starting at 10.7.1, ArcGIS Web Adaptor will not send service requests to any machine with this flag set to true.

A machine under maintenance will still honor administrative changes and publishing events made to the site through other ArcGIS Server machines. You can implement similar logic in your third-party load balancer or reverse proxy server to avoid forwarding service requests to machines that fail the health check. This allows you to make changes to the machine (such as updating its OS) without causing service requests to fail. When you are done performing maintenance on the machine, change this property back to false.

Note:

Starting at 10.8, the join-site command line utility includes an optional flag to place the new machine under maintenance as soon as it's joined to the site.

Values: true | false

<ports>
Legacy:

Prior to 10.7, ArcGIS Server used ports 4000 through 4003 for intermachine communication, with ports named OpenEJBPort, JMXPort, NamingPort, and DerbyPort. These ports were provided in the Ports section of the Machine resource. They are no longer used at 10.7, so this list is empty.

The names of the intermachine communication ports used by ArcGIS Server and their corresponding port value.

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

Below is a sample POST request for edit:

POST /webadaptor/admin/machines/MACHINE.DOMAIN.COM/edit HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

adminURL=https://SERVER1.DOMAIN.COM:port/arcgis/admin&webServerMaxHeapSize=-1&webServerCertificateAlias=server1&socMaxHeapSize=64&underMaintenance=false&f=json

JSON Response example

{"status": "success"}