A valid authorization file is required to run ArcGIS Monitor Server.
Learn more about obtaining an authorization file
You can authorize Monitor Server by running the authorizeSoftware script in the <ArcGIS Monitor installation location>/tools directory using the parameters specified below.
The default installation directory is <ArcGIS Monitor user account home directory>/arcgis/monitor/server.
Note:
Authorizing using a provisioning file (.prvc) allows you to authorize Monitor Server immediately if an internet connection is available. An email address may be required. If an internet connection is not available, you can authorize using the Esri website or by email to receive an authorization file to complete the authorization process.
Authorize Monitor Server silently
The authorization tool can be used to silently authorize Monitor Server after it has been installed. This script must be run by the ArcGIS Monitor account user. For a complete list of available parameters, run the authorization script with the --help parameter as shown below (based on the default installation location):
<ArcGIS Monitor Server installation location>/tools/authorizeSoftware --help
To authorize the software, run the authorization script using the following syntax:
authorizeSoftware [options]
| Option | Description |
|---|---|
-s | Displays the authorization status. |
-f FULL_PATH_TO_ECP_AUTHORIZATION_FILE | Authorize using an .ecp authorization file. FULL_PATH_TO_ECP_AUTHORIZATION_FILE is the full, absolute path to the .ecp file provided by Esri. |
-f FULL_PATH_TO_PROVISIONING_FILE -e EMAIL_ADDRESS | Authorize using a .prvc provisioning file. An email address is required. FULL_PATH_TO_PROVISIONING_FILE is the full, absolute path to the .prvc file provided by Esri. EMAIL_ADDRESS is required to authorize only if it is not specified in the provisioning file. |
-f FULL_PATH_TO_PROVISIONING_FILE -e EMAIL_ADDRESS -o AUTHORIZATION_FILE_OUTPUT | Generates an authorization file to be uploaded to the Esri website or sent by email. Once completed, run this tool again using the received .ecp authorization file to complete the authorization process for this product. FULL_PATH_TO_PROVISIONING_FILE is the full, absolute path to the .prvc provisioning file provided by Esri. EMAIL_ADDRESS is required to authorize only if it is not specified in the provisioning file. AUTHORIZATION_FILE_OUTPUT is the output file that must be uploaded to the Esri self service site website or sent by email to authorize@esri.com. |
-h; --help | Displays command line help and exits. |
Authorize in a disconnected network environment and with no $DISPLAY set (headless)
To install Monitor Server in a disconnected network environment with no $DISPLAY set (headless) and authorize it using a provisioning file (.prvc), complete the following steps:
- Run the following command in a terminal session with the ArcGIS Monitor account user after a successful installation of Monitor Server:
<ArcGIS Monitor Server installation location>/tools/authorizeSoftware -f <full path to the .prvc file> -e <email address> -o <full path to authorization output file>
- Once the authorization information file has been created, do one of the following:
- Browse to the Esri self service site, and follow the instructions on the screen to upload the authorization information file and download the .ecp authorization file.
- Send the authorization information file by email to authorize@esri.com, and Esri will send the .ecp authorization file back to you in an email.
- Once you receive the .ecp authorization file, run the following command in the command shell as the ArcGIS Monitor account user to process it and complete the Monitor Server authorization process:
<ArcGIS Monitor Server installation location>/tools/authorizeSoftware -f <full path to the .ecp file>