Esri releases new ArcGIS Amazon Machine Images (AMIs), CloudFormation templates, and an updated ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services shortly after each new ArcGIS Enterprise release. You should use the latest AMIs and tools when you build new deployments.
For existing deployments, how you upgrade depends on the type of deployment you are upgrading, what ArcGIS version you originally deployed with, and what tool you used to create the deployment.
For information on what you can use to upgrade, see the section for the tool you used to create your deployment.
Deployment created with Cloud Builder app
From 10.3 to 10.6.1, the ArcGIS Server Cloud Builder on Amazon Web Services app was available to help you create ArcGIS Server sites and managed databases. Beginning with 10.7.1, a new Cloud Builder app was made available—ArcGIS Enterprise Cloud Builder for Amazon Web Services—that allows you to create ArcGIS Enterprise deployments and stand-alone or federated ArcGIS Server sites.
| Tool | Original ArcGIS version | Upgrade method |
|---|---|---|
ArcGIS Enterprise Cloud Builder for Amazon Web Services app | 10.7.1 or later | If you did not alter the architecture of the deployment after creating it, use the ArcGIS Enterprise Cloud Builder for Amazon Web Services app to upgrade. If you altered the deployment's architecture after creating it, upgrade in the same way you would upgrade on-premises software. See the upgrade topics for each component to upgrade them. |
ArcGIS Server Cloud Builder on Amazon Web Services | 10.6.1 or earlier | Upgrade the site the same way you would upgrade on-premises software. See Upgrade ArcGIS Server for instructions. |
Note:
You cannot use the Cloud Builder app to upgrade ArcGIS GeoEvent Server sites. Upgrade federated and stand-alone ArcGIS GeoEvent Server sites on AWS the same way you would upgrade on-premises software. See Upgrade GeoEvent Server for instructions.
Deployment created with ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services
ArcGIS Enterprise Cloud Builder Command Line Interface for Amazon Web Services was introduced with ArcGIS Enterprise 10.7. You can use it to create ArcGIS Enterprise deployments and stand-alone or federated ArcGIS Server sites.
| Original ArcGIS version | Upgrade method |
|---|---|
10.7.x | If you did not alter the architecture of the deployment after creating it, use a CloudFormation template provided by Esri to upgrade. |
10.8 | If you did not alter the architecture of the deployment after creating it, use the ArcGIS Enterprise Cloud Builder for Amazon Web Services app or an Esri CloudFormation template to upgrade. |
Any version if you altered the architecture (for example, you changed the Elastic IP address, added a load balancer, or added an Elastic Block Storage volume) after deploying using a CloudFormation template. | Upgrade the site the same way you would upgrade on-premises software. See the upgrade topics for each component to upgrade them. |
Deployment created with an Esri sample CloudFormation template
Esri began providing sample AWS CloudFormation templates with ArcGIS 10.3.1. Over time, templates have been added that allow you to create many different types of deployments.
| Original ArcGIS version | Upgrade method |
|---|---|
10.7.x | If you did not alter the architecture of the deployment after creating it, you can use the 10.8 or 10.8.1 CloudFormation template provided by Esri to upgrade. |
10.6.x | If you did not alter the architecture of the deployment after creating it, you can use the 10.8 CloudFormation template provided by Esri to upgrade. To upgrade to 10.8.1, you must upgrade the deployment the same way you would upgrade on-premises software. See the upgrade topics for each component to upgrade them. |
Any version if you altered the architecture (for example, you changed the Elastic IP address, added a load balancer, or added an Elastic Block Storage volume) after deploying using a CloudFormation template. | Upgrade the deployment the same way you would upgrade on-premises software. See the upgrade topics for each component to upgrade them. |
Deployment created with Amazon Web Services (AWS) Management Console
If you used AWS Management Console to create your deployment, upgrade the software the same way you would upgrade on-premises software. See the following upgrade topics to upgrade each component:
- Portal for ArcGIS
- ArcGIS Server
- ArcGIS Data Store
- Additional federated servers:
Apply patches
A patch notification tool (patchnotification) is included with ArcGIS software 10.3 and later. It is in the tools directory of each ArcGIS component's installation directory. From 10.3 to 10.6, the tool returns a list of required patches and provides a link to a page that allows you to download the patches. The 10.6.1 and later patch notificaton tool lists and installs the patches. However, for 10.6.1, 10.7.x, and 10.8 deployments, you must install patches one at a time. On 10.8.1 deployments, you can apply patches in bulk when components are installed on the same Amazon Elastic Compute Cloud (EC2) instance.
Before applying patches, you should always read their descriptions. You can find these on the Downloads page of the Esri support website.
Back up before upgrading
Before you upgrade an ArcGIS Enterprise deployment or apply patches, use the webgisdr tool installed with Portal for ArcGIS to create a backup of the ArcGIS Enterprise components. This backup allows you to restore your deployment using the same URLs if you encounter issues that require you to revert to your old deployment.
Note:
If you have a spatiotemporal big data store in your deployment, use the ArcGIS Data Store backupdatastore utility to create a backup of it, as it is not included in the backup created by the webgisdr tool.
Before you upgrade a stand-alone ArcGIS Server site, create a backup of the site.