- URL:https://<machines-url>/register(POST only)
- Required Capability:Default administrator role | Security and Infrastructure
- Version Introduced:10.1
Description
The register operation registers a server machine with the site. The server machine must have ArcGIS Server installed and authorized. Registering machines this way is a pull approach to growing the site and allows you to add a large number of machines to a site. In contrast, you can join a server machine to a site.
Note:
If you are adding more than one machine to a site, the server directories and configuration store must be directories on a shared file system.
If the site has registered Relational Data Store Types and more machines are added, you must completely restart ArcGIS Server on each newly registered machine. To do this, restart the Windows service or use the stopserver/startserver scripts on Linux.
Legacy:
At 10.9.1, when installing ArcGIS Server you had the option to disable the ArcMap service runtime. Attempting to register a server machine that had a conflicting ArcMap runtime status to the site would result in an error. Starting at ArcGIS Enterprise 11.0, the optional ArcMap Runtime Support feature is removed, and an existing site and any new machines being registered no longer have the potential to be in conflict.
Request parameters
| Parameter | Description |
|---|---|
| machineName | The name of the server machine to be registered with the site. This server machine must have ArcGIS Server installed and authorized. Example |
| adminURL | The URL where the administrator API is running on the server machine. Example |
| f | The response format. The default response format is html. Values: html | json | pjson |
Example usage
The following is a sample POST request for the register operation:
POST /webadaptor/admin/machines/register HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
machineName=MACHINE2.DOMAIN.COM&adminURL=https://machine.domain.com:6443/arcgis/admin&f=jsonJSON Response example
The following is a sample success response for the register operation, indicating that the machine has been registered successfully with the site:
{
"status": "success"
}