A valid authorization file is required to run ArcGIS Monitor Server.
Learn more about obtaining an authorization file
You can authorize Monitor Server after it has been installed using one of the following methods:
- If the $DISPLAY environment variable is set and an X Window display is available, you can authorize Monitor Server using the graphical Authorization Wizard with or without an authorization file by running the authorizeSoftware script in the <ArcGIS Monitor installation directory>/tools directory without any parameters.
- Authorize Monitor Server silently by running the authorizeSoftware script in the <ArcGIS Monitor installation directory>/tools directory using the parameters specified below.
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 via 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 a user that has full permissions to the Monitor Server installation directory. 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 directory>/tools/authorizeSoftware --help
To authorize the software, run the authorization script using the following syntax:
authorizeSoftware [options]
| Option | Description |
|---|---|
none | Software Authorization Wizard GUI will run. |
-s | Displays authorization status. |
-f FULL_PATH_TO_ECP_AUTHORIZATION_FILE | Authorizing with an .ecp authorization file. FULL_PATH_TO_ECP_AUTHORIZATION_FILE is the full, absolute path to the authorization file (.ecp) provided by Esri. |
-f FULL_PATH_TO_PROVISIONING_FILE -e EMAIL_ADDRESS | Authorizing with a provisioning file. An email address is required. FULL_PATH_TO_PROVISIONING_FILE is the full, absolute path to the provisioning file (.prvc) 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 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 provisioning file (.prvc) 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 generated that must be uploaded to the Esri Customer Service website or sent via 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)
You can install Monitor Server in a disconnected network environment with no $DISPLAY set (headless) and authorize it using a provisioning file (.prvc). This is a three-step process.
- Run the following command in a terminal session as the ArcGIS Monitor account user after a successful installation of Monitor Server.
<ArcGIS Monitor Server installation directory>/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:
- Go to the Esri Customer Service website and follow the instructions on the screen to upload your authorization information file and download your .ecp authorization file.
- Send your authorization information file by email to authorize@esri.com and Esri will send your .ecp authorization file back to you in an email.
- Once you receive your .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 directory>/tools/authorizeSoftware -f <full path to the .ecp file>