Skip To Content

Authorizing Portal for ArcGIS

Each installation of Portal for ArcGIS needs to be authorized for use. Visit My Esri to obtain your authorization number (similar in format to ECP123456789) for use in the software or to create a provisioning file, which can be used to complete the authorization process.

Once you've obtained your authorization, use one of the following methods to launch the Software Authorization Wizard:

  • Use the shortcut in the desktop environment: ArcGIS > Portal for ArcGIS > Authorize Portal for ArcGIS.
  • Run the authorization script: ${HOME}/arcgis/portal/tools/authorizeSoftware.

Choose the authorization option

You can authorize Portal for ArcGIS by choosing one of two options:

  • I have installed my software and need to authorize it—Select this option if you do not already have an authorization file. Click Next. On the subsequent dialog box, choose one of the options to authorize your software. You'll need an Internet connection to complete the authorization.
  • I have received an authorization file from Esri and am now ready to finish the authorization process—Select this option if you've already received your authorization file from My Esri. Browse to the authorization file on disk and click Next to complete your authorization.

Authorizing Portal for ArcGIS silently

The authorization tool can also be launched silently after Portal for ArcGIS has been installed. For a complete list of available parameters, run the authorization script with the help parameter as shown below (based on the default installation location):

${HOME}/arcgis/portal/tools/authorizeSoftware -h

Usage: authorizeSoftware [options]

OptionDescription

none

Show Software Authorization Wizard GUI.

-s

Obtain 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 (.ecp) file 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 (.prvc) file provided by Esri.

EMAIL_ADDRESS is required to authorize using a provisioning file.

-f FULL_PATH_TO_PROVISIONING_FILE -e EMAIL_ADDRESS -o AUTHORIZATION_FILE_OUTPUT

Generates an authorization file to be uploaded to Esri's 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 (.prvc) file provided by Esri.

EMAIL_ADDRESS is required to authorize using a provisioning file.

AUTHORIZATION_FILE_OUTPUT is the output file generated which needs to be submitted to My Esri.

For more information, see Authorizing in a disconnected network environment and with no display set (headless).

-h;

Displays the command line help.

Authorizing in a disconnected network environment and with no display set (headless)

Starting at 10.3, installing Portal for ArcGIS in a disconnected network environment with no display set (headless) can now be authorized using a provisioning (.prvc) file. This is a two-step process.

  1. At the prompt, run the authorization command provided below after a successful installation of Portal for ArcGIS.

    <Portal for ArcGIS installation directory>/tools/authorizeSoftware -f <full path to the .prvc file>  -e <email address> -o <full path to authorization file output>

    Once the authorization information file output has been created, do one of the following:

    • Browse to the My Esri website. 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. Esri will send your ecp authorization file back to you in an email.

  2. Once you receive your ecp authorization file using either of the above methods, run the authorizeSoftware script again to process it and complete the server authorization process:

    <Portal for ArcGIS installation directory>/tools/authorizeSoftware -f <full path to the .ecp file>