- URL: https://<site-url>/upgrade(POST only)
- Required Capability:Default administrator role
- Version Introduced:10.5
Description
This is the first operation that must be invoked during an ArcGIS Server upgrade. Once the new software version has been installed and the setup has completed, the upgrade operation will be available. A successful run of this operation will complete the upgrade of ArcGIS Server. This operation is available only when a server machine is currently being upgraded. It will not be available after a successful upgrade of a server machine.
Caution:
If errors are returned with the upgrade operation, you must address the errors before you continue. For example, if you encounter an error about an invalid license, you must re-authorize the software using a valid license before running this operation again.
Request parameters
| Parameter | Details |
|---|---|
| runAsync | A flag that indicates whether the operation must be run asynchronously. The default value is false. Values: true | false |
| enableDebug | Introduced at 11.0. This parameter sets the log level for the upgrade process. If true, the log level is set to DEBUG during the upgrade, which can aid in troubleshooting issues related to the upgrade process. If false, the log level is set to VERBOSE during the upgrade process. The default value is false. Values: true | false |
| 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 upgrade operation:
POST /webadaptor/admin/upgrade HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
runAsync=false&enableDeubg=false&f=pjsonJSON Response example
{"status": "success"}