ArcGIS upgrades on AWS
How you upgrade existing deployments depends on the following factors:
The method you used to create the deployment.
Example methods include ArcGIS Enterprise Cloud Builder for Amazon Web Services, Amazon Web Services CloudFormation templates provided by Esri, Chef cookbooks provided by Esri, or installation of software using the same procedures as an on-premises deployment.
The version you are upgrading from.
You can upgrade directly to 12.2 from version 12.1, 12.0, 11.5, 11.3, or 11.1. To upgrade from any other version, you must first upgrade to a version that supports direct upgrades, and upgrade that version to 12.2.
When deciding which interim version to upgrade to, take into account retired components and item types that you must migrate or remove before upgrading to 12.2. For example, if you are upgrading a base ArcGIS Enterprise 11.1 deployment, you must first upgrade to 11.5 to add an object store, migrate hosted scene layer caches from the tile cache data store to the object store, and remove the tile cache data store before you can upgrade to 12.2.
See the ArcGIS Blog article Dive into ArcGIS Enterprise 11.5 before you delve into 12 for more information about retired functionality and item types.
Deployment methods, versions, and upgrade methods
In general, if you create a deployment using a particular tool or method, you can continue using that same tool or method to upgrade.
For example, if you create a deployment with the ArcGIS Enterprise Cloud Builder for Amazon Web Services app, you can use it to upgrade the deployment. But if you configured each component in AWS using the same method as you would for an on-premises deployment, you cannot use the ArcGIS Enterprise Cloud Builder for Amazon Web Services app to upgrade; you must upgrade using the same methods as you would use for an on-premises deployment.
As indicated above, though, the version you're upgrading from may also determine what method you can use to upgrade. The following sections outline these differences in supported upgrade methods.
Deployment created with supported cloud tooling provided by Esri
If you created the deployment using the ArcGIS Enterprise Cloud Builder for Amazon Web Services (AWS) app or command line interface and you did not substantially alter the deployment, use the app to upgrade.
If you created the deployment using an AWS CloudFormation template provided by Esri and you did not substantially alter the deployment, use the corresponding upgrade template to upgrade.
Substantial alterations include changing the deployment mode of an ArcGIS Data Store, changing the Elastic IP address of a component, adding a load balancer, adding an Elastic Block Storage volume to an Elastic Compute Cloud (EC2) instance in the deployment, or adding components to a deployment created using the all-in-one CloudFormation templates.
Tip:
Upgrade templates have the same name as their corresponding deployment templates, but with -upgrade appended to it. For example, the upgrade template that corresponds to arcgis-portal-ha.template.json is named arcgis-portal-ha-upgrade.template.json.
The table below describes upgrade methods for deployments created with ArcGIS Enterprise Cloud Builder for Amazon Web Services or a CloudFormation template provided by Esri based on the version from which you are upgrading.
|
Creation method |
Version upgrading from |
Upgrade method |
|---|---|---|
|
ArcGIS Enterprise Cloud Builder for AWS app or command line interface |
12.1, 12.0, 11.5, 11.3, or 11.1 |
If you did not alter the architecture of the deployment after creating it, use the Cloud Builder app to upgrade. |
|
CloudFormation template provided by Esri |
12.1, 12.0, 11.5, 11.3, or 11.1 |
If you did not alter the architecture of the deployment after creating it, you can use a 12.2 CloudFormation template provided by Esri to upgrade. |
|
ArcGIS Enterprise Cloud Builder app or command line interface or CloudFormation templates provided by Esri |
11.4, 11.2, 11.0, 10.9.1, or 10.9 |
Upgrade to 11.5 before you upgrade to 12.2. Read the ArcGIS Enterprise 11.5 for AWS help for upgrade instructions. Test the 11.5 deployment, then follow upgrade instructions for 12.2. |
|
ArcGIS Enterprise Cloud Builder app or command line interface or CloudFormation templates provided by Esri |
10.8.1 or earlier, or any version if you altered the architecture after deploying. |
Upgrade in the same way you would upgrade on-premises software. You must first upgrade to 11.5 before you upgrade to 12.2. Read the ArcGIS Enterprise 11.5 for AWS help for upgrade instructions. Test the 11.5 deployment, then follow upgrade instructions for 12.2. |
Deployment created using the Amazon Web Services (AWS) Management Console
If you used AWS Management Console to create the deployment, upgrade the software the same way you would upgrade on-premises software.
See the following pages in the ArcGIS Enterprise on Windows and Linux help to upgrade each component:
For federated servers, see the following:
Upgrading databases and geodatabases
If your deployment includes registered databases, you must upgrade the database management systems and enterprise geodatabases separately; the ArcGIS Enterprise tools for Amazon Web Services do not upgrade them.
For the database management system, follow the instructions provided by the database provider. To upgrade enterprise geodatabases, upgrade the geodatabase after you upgrade the ArcGIS software on AWS. See the following for geodatabase upgrade instructions:
Patches
ArcGIS Enterprise tools for AWS do not apply patches. Use the patch notification tool (patchnotification) included with ArcGIS software to determine if patches are required.
The patch notification tool is in the tools directory of each ArcGIS component's installation directory. The tool lists and installs the patches.
Always read patch descriptions before applying them. You can find these on the Downloads page of the Esri support website.
Next steps
Read the prerequisites for upgrading before you upgrade ArcGIS Enterprise on AWS.