Edit Machine

Description

ArcGIS Server uses four ports for communication between GIS servers. When you create or join a site, these are assigned to ports 4000–4003. If any of those ports are in use by other applications, those ports are skipped and a corresponding number of additional ports are used beyond 4003.

You must ensure that your firewall allows communication with other GIS server machines through four ports beginning with 4000 and not counting any port currently in use by another application. You can use this operation to see where the ports were assigned (and thus which ports you should open on your firewall) or use it to modify ArcGIS Server to use a different set of port numbers if there is a conflict.

You'll notice that the ports are named according to their function. The port names do not have to match the port numbers between GIS server machines. For example, the NamingPort could be 4003 on one GIS server and 4006 on a different GIS server.

NoteNote:

Editing the machine configuration causes the machine to be restarted, so it's not recommended you perform this operation during peak usage.

Parameters

Parameter

Description

adminURL

The URL where the Administrator API is running on the server machine. Example: http://<machineName>:6080/arcgis/admin

webServerMaxHeapSize

The web server maximum heap size limits the file size that can be sent to the GIS Server. The default value is -1 MB.

webServerCertificateAlias

The alias of the web server's SSL certificate.

appServerMaxHeapSize

The application server maximum heap size limits the file size that can be sent to the GIS Server. The default value is 256 MB.

socMaxHeapSize

The SOC maximum heap size limits the file size that can be sent to the GIS Server. The default value is 64 MB.

<ports>

The name of the port being the parameter and its value being the port number.

Examples:

OpenEJBPort=4001

JMXPort=4000

NamingPort=4002

DerbyPort=4003

f

The response format. The default response format is html.

Values: html | json

Example usage

http://server:port/arcgis/admin/machines/SERVER1.DOMAIN.COM/edit
adminURL=https://SERVER1.DOMAIN.COM:port/arcgis/admin
webServerMaxHeapSize=-1
webServerCertificateAlias=server1
appServerMaxHeapSize=256
socMaxHeapSize=64
OpenEJBPort=4001
JMXPort=4000
NamingPort=4002
DerbyPort=4003
f=html

JSON response

{"status": "success"}

7/27/2017