Skip To Content

Upgrade ArcGIS Enterprise

If you installed a base deployment using ArcGIS Enterprise Builder, you can upgrade the base deployment to ArcGIS Enterprise 11.3 using the builder. This is a way to upgrade your deployment using the configuration wizard. All other ArcGIS Enterprise deployments need to be upgraded by individual software components.

Caution:
Before upgrading to ArcGIS Enterprise 11.3, review considerations for upgrades.

When upgrading by individual software components, ensure that the version of the ArcGIS Enterprise portal matches the versions of any GeoAnalytics Server sites, Raster Analytics sites, and Image Hosting sites. To learn about the exceptions that support a federated server site at a prior version to the portal, see Federate an ArcGIS Server with your portal.

Upgrading directly to ArcGIS Enterprise 11.3 from versions 10.6.1 or earlier is not supported. To upgrade ArcGIS Enterprise 10.6.1 or earlier, first upgrade it to an interim version (10.7.x - 10.9.x) and then upgrade that version to 11.3. Read the upgrade documentation for the interim version to confirm direct upgrades are supported for the ArcGIS Enterprise version you start with.

Upgrade an ArcGIS Enterprise deployment

Running the 11.3 setups will automatically upgrade your ArcGIS Enterprise software components to 11.3. There is no need to obtain and install each previously released version in sequence or to uninstall any of your software components.

  1. Obtain your new 11.3 setup and authorization files from My Esri.
  2. Back up the following information:
    • In your ArcGIS Enterprise portal: Use the webgisdr utility to back up your deployment. Back up the arcgisportal content directory folder, and any extensions you've added for Dashboards and Web AppBuilder. Additionally, back up the config.js file if you've configured advanced portal options by modifying the properties in the file. You can use the backed-up file as a reference to customize your portal's behavior through the ArcGIS Portal Directory (Sharing API) after upgrade.
    • For ArcGIS Server: Use the backup utility to back up your server site configuration.
    • For ArcGIS Data Store: Run the backupdatastore utility to create a full backup of each of your data stores.
  3. Perform the upgrade steps for each ArcGIS Enterprise software component in the following order:
    1. Upgrade Portal for ArcGIS.
      Note:

      If your organization requires the complete set of 3D symbology in Scene Viewer, install the Web Styles setup on both Portal for ArcGIS machines.

    2. Upgrade ArcGIS Web Adaptor (for Portal) for IIS or Java (Windows).
    3. Upgrade the ArcGIS Server site serving as the portal's hosting server.
    4. Upgrade ArcGIS Web Adaptor (for Server) for IIS or Java (Windows).
    5. Upgrade ArcGIS Data Store.
    6. Upgrade any additional ArcGIS Server sites.
    7. Note:

      You don't need to upgrade ArcGIS Pro at the same time as ArcGIS Enterprise.

    Tip:

    It is recommended that you use the serverScan.py and portalScan.py scripts to review for security best practices with your ArcGIS Server and ArcGIS Enterprise portal following the upgrade.

  4. Review Ports used by base ArcGIS Enterprise components and verify that all necessary ports have been opened to ensure your upgraded deployment performs properly.

    For example, to use webhooks, ports 45671 and 45672 must be open on any relational data store machines to allow for communication with ArcGIS Server. If you previously had all ports closed, these will need to be opened in your upgraded environment.

High availability upgrades

Running the 11.3 setups will automatically upgrade your ArcGIS Enterprise software components to 11.3. There is no need to obtain and install each previously released version in sequence or to uninstall any of your software components.

  1. Obtain your new 11.3 setup and authorization files from My Esri.
  2. Back up the following information:
    • In your ArcGIS Enterprise portal: Use the webgisdr utility to back up your deployment. Back up the arcgisportal content directory folder, and any extensions you've added for Dashboards and Web AppBuilder. Additionally, back up the config.js file if you've configured advanced portal options by modifying the properties in the file. You can use the backed-up file as a reference to customize your portal's behavior through the ArcGIS Portal Directory (Sharing API) after upgrade.
    • For ArcGIS Server: Use the backup utility to back up your server site configuration.
    • For ArcGIS Data Store: Run the backupdatastore utility to create a full backup of each of your data stores.
  3. Perform the upgrade steps for each ArcGIS Enterprise software component in the following order:
    1. Upgrade a highly available portal.
      Note:

      If your organization requires the complete set of 3D symbology in Scene Viewer, install the Web Styles setup on both Portal for ArcGIS machines.

    2. Upgrade ArcGIS Web Adaptor (for Portal) for IIS or Java (Windows).
    3. Upgrade a multimachine ArcGIS Server site.
    4. Upgrade ArcGIS Web Adaptor (for Server) for IIS or Java (Windows).
    5. Upgrade a high availability ArcGIS Data Store.
    6. Upgrade any additional ArcGIS Server sites.
    7. Note:

      You don't need to upgrade ArcGIS Pro at the same time as ArcGIS Enterprise.

    Tip:

    It is recommended that you use the serverScan.py and portalScan.py scripts to review for security best practices with your ArcGIS Server and ArcGIS Enterprise portal following the upgrade.

  4. Review Ports used by base ArcGIS Enterprise components and verify that all necessary ports have been opened to ensure your upgraded deployment performs properly.

    For example, to use webhooks, ports 45671 and 45672 must be open on any relational data store machines to allow for communication with ArcGIS Server. If you previously had all ports closed, these will need to be opened in your upgraded environment.