Authorize ArcGIS Monitor Server

A valid authorization file is required to run ArcGIS Monitor Server. Once the installation is complete, the software authorization wizard must be opened manually using the search function in your computer's start menu. Use the wizard to authorize the Monitor Server installation with an ArcGIS Monitor license.

A valid authorization file is required to run ArcGIS Monitor Server.

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.

Learn how to obtain an authorization file

Authorize Monitor Server using a wizard

To authorize Monitor Server, complete the following steps:

Open the software authorization wizard from your computer's start menu.
Choose one of the following options:
- I have already installed my software and need to authorize it—Use this option if you used the installation wizard and are not reinstalling or repairing Monitor Server or installing any extensions.
- I have already authorized the software and need to authorize additional extensions—Use this option if you have custom extensions to install.
- I have received an authorization file and am now ready to finish the authorization process—Use this option if you already installed Monitor but stopped the installation before authorizing your software. This option is most commonly used as part of a silent installation.
Click Next.
Choose one of the following options to authorize the software:
- Authorize with Esri now using the internet (Recommended)—Choose this option to proceed through the software authorization wizard and obtain your authorization code.
- Authorize at Esri's website or by email to receive your authorization file—Choose this option if you're authorizing in a disconnected environment.

Authorize Monitor Server silently

Run the following command to authorize Monitor Server silently, editing the command line where necessary to reflect the actual authorization file location:

<ArcGIS Monitor installation location>\tools\softwareauthorization\SoftwareAuthorization.exe /S /Ver 26.0 /LIF <path to .prvc authorization file>

Note:

The .prvc authorization file must have all user information completed before running the command to authorize Monitor Server silently. Open the authorization file in a text editor and complete the User Information section.

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`. Learn more about authorizing in a disconnected network environment and with no $DISPLAY set (headless)
-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>
```