Skip to main content

Upgrade ArcGIS Enterprise

Upgrading ArcGIS Enterprise requires upgrading each component. The sections of this page provide an overview of the process and links to specific instructions for upgrading each component.

Versions supported for direct upgrade

Recent versions of ArcGIS Enterprise support a direct upgrade to the latest version. Older versions may require multiple upgrades to reach the latest version of ArcGIS Enterprise. The table below indicates the latest version supported for direct upgrade for each version of ArcGIS Enterprise.

See Considerations for choosing a software version for more information about choosing a version that meets your organization's needs.

Caution:

Even if a software version supports direct upgrade, an interim upgrade may be required if your organization needs access to migration tools that are only available in an earlier release. See deprecations and retirements for more information.

Source version

Latest target version supported for direct upgrade

11.1, 11.3, 11.5, 12.0, 12.1

12.2

11.0, 11.2, 11.4

12.1

10.8 - 10.9.1

11.5

10.7 - 10.7.1

11.3

10.5 - 10.6.1

10.9.1

If your source version supports direct upgrades to your target version, the setup files for the target version of each component will automatically upgrade the component. There is no need to obtain and install each previously released version in sequence or uninstall your current version. For example, if your current version is 12.0, you can directly upgrade to version 12.2.

If your source version does not support direct upgrades to your target version, you will need to perform one or more upgrades to an interim version. For example, if your current version is 11.0, you cannot directly upgrade to 12.2. You must perform an upgrade to at least version 11.1, because this is the lowest version that does support direct upgrades to 12.2. The interim version can be no higher than 12.1, because that is the highest version supported for direct upgrades from 11.0. From an interim version within this range, you can perform a second upgrade directly to 12.2.

ArcGIS Enterprise upgrade order

The recommended order to upgrade the components in your ArcGIS Enterprise deployment is as follows:

  1. Upgrade Portal for ArcGIS.

  2. Upgrade ArcGIS Web Adaptor (for Portal for ArcGIS).

  3. Upgrade ArcGIS Web Adaptor (for Portal for ArcGIS) for IIS or Java (Windows).

  4. Upgrade the ArcGIS Server site serving as the hosting server.

  5. Upgrade ArcGIS Web Adaptor (for ArcGIS Server).

  6. Upgrade ArcGIS Web Adaptor (for ArcGIS Server) for IIS or Java (Windows).

  7. Upgrade ArcGIS Data Store.

  8. If your ArcGIS Enterprise deployment includes them, upgrade any other federated server sites.

    Federated server sites should match the version of the base ArcGIS Enterprise deployment.

    See the upgrade information for any additional federated ArcGIS Enterprise servers you need to upgrade.

  9. Install the Web Styles setup if you want to use a complete set of 3D symbology from Scene Viewer. For additional information, see Scene Viewer requirements.

Upgrade considerations

To ensure the success of your upgrade, there are a variety of considerations that you should take into account. Carefully review these considerations before proceeding with the upgrade process.

  • Take a backup of ArcGIS Enterprise before upgrading any components. If the upgrade process fails, you may need to use the backup to restore the previous state of your deployment.

  • Review What's new in ArcGIS Enterprise for each release on your upgrade path to understand changes in functionality and requirements. Review Deprecation and retirements for information about deprecated or retired functionality that may require migration before or after upgrading.

    Note:

    If your upgrade path includes mature or retired ArcGIS Enterprise versions, see the archived documentation to review changes introduced at those releases.

  • The version of all base ArcGIS Enterprise components must be the same.

  • The system requirements may have changed in later versions. Make sure that you are able to meet the requirements of the version you are upgrading to for each component of ArcGIS Enterprise.

  • Make sure that the required ports are open for each machine involved in the upgrade.

  • Before performing an upgrade, it is recommended to check for software updates and patches at your current software version and in the target upgrade version. To identify patches for a base deployment at your current version, use the patch notification tool on each machine in your deployment. To identify patches for your target upgrade version, use the patches and updates page to filter based on version and components.

  • To minimize downtime during an upgrade, use an identical, isolated standby environment. You can upgrade the standby environment while your production environment remains available. To learn more about this upgrade strategy and about how to upgrade your highly available or replicated environment, see Upgrade highly available and replicated environments.

  • Supported geodatabase versions may be different in later versions. You may need to upgrade your geodatabase as part of your ArcGIS Enterprise upgrade.

  • You don't need to upgrade ArcGIS Pro at the same time as ArcGIS Enterprise. However, it is recommended that you keep ArcGIS Pro and ArcGIS Enterprise at companion versions. See Companion ArcGIS Pro and ArcGIS Enterprise versions for more information.

  • If your organization uses a utility network, ensure that the versions of ArcGIS Enterprise, ArcGIS Pro, and utility network are compatible. See Utility network compatibility for more information.

  • During an upgrade, if more space is needed for installed resources than is available in the default /tmp directory, you can specify an alternate setup temp location by setting the IATEMPDIR environment variable to a larger directory.

  • During upgrades, if the system temp directory does not have enough space to backup your files and folders, you can either run the export TMPDIR=/path/to/new/tmp command to set a larger alternative temp directory, or expand the size of the system temp directory.

  • It is recommended that you confirm how ArcGIS Enterprise was originally installed and use the same approach for the upgrade. For example, if your deployment was created using ArcGIS Enterprise Builder or an ArcGIS Enterprise Cloud Builder application (AWS or Microsoft Azure), use the corresponding builder to perform the upgrade if possible.

  • After the upgrade is complete, it is recommended that you run the portalScan.py and serverScan.py scripts to check for security best practices with your upgraded organization.