Updating software on your multimachine ArcGIS Enterprise deployment on Amazon Web Services (AWS) is similar to updating software on-premises. You can download software updates from My Esri onto your EC2 instances, and apply the updates directly to your existing deployment. All ArcGIS Enterprise components on each machine must be running the same software version.
Prepare to update components
Before you upgrade your ArcGIS Enterprise deployment, create a backup of the deployment.
- Download new versions of Portal for ArcGIS, ArcGIS Web Adaptor, ArcGIS Server, and ArcGIS Data Store from My Esri. Also obtain new licenses from Esri
- Ensure that ports 5701-5703, 7005, 7099, 7199, 7654, 7120, and 7220 are allowed by your firewall and not currently in use by another application. Highly available deployments use these ports for intermachine communications and synchronization.
- Make sure no one is connected to your ArcGIS Enterprise portal or ArcGIS Server sites.
Caution:
Do not stop the Portal for ArcGIS, ArcGIS Server, or ArcGIS Data Store services. If you stop those services, the webgisdr utility will fail to create a backup of your deployment.
- Create a full backup of your deployment using the webgisdr utility installed with Portal for ArcGIS. This is your backup that you can use to redeploy the previous software versions if any issues arise during the upgrade process.
Upgrade Portal for ArcGIS
First, upgrade Portal for ArcGIS.
- Make a remote desktop connection (Windows) or SSH (Linux) connection to your Portal for ArcGIS machine on AWS. If your portal is highly available, connect to one of the Portal for ArcGIS machines on AWS. Connect as the arcgis user.
If this is the first time you are upgrading Portal for ArcGIS on Windows on AWS, change the arcgis user's password. You must do this for every machine in the deployment, and the password must be the same for all machines.
If you deployed ArcGIS Enterprise using the AWS Management Console, be sure this machine is allowed to create Amazon Simple Storage Service (S3) buckets in your AWS account, as the Portal for ArcGIS upgrade procedure creates an S3 bucket for temporary storage of the content directory. If you deployed using a CloudFormation template provided by Esri, the template already configured this.
- Place the new Portal for ArcGIS and ArcGIS Web Adaptor installations and (if applicable) your new Portal for ArcGIS license file on this machine.
- If your portal contains only one Portal for ArcGIS machine, follow the steps to upgrade Portal for ArcGIS to update the portal machine and its web adaptor, and, if necessary, authorize Portal for ArcGIS with your new license file.
- If your portal is highly available, repeat steps 1 and 2 for the second Portal for ArcGIS machine. Next, follow the steps to upgrade a highly available portal to update software and, if necessary, authorize Portal for ArcGIS on each machine with your new license file.
Note:
At 10.6, a highly available portal uses available ports between 5701 and 5703 to keep item, group, and user information synchronized between machines. This range is narrower than previous versions. When upgrading a highly available portal, open these ports to enable communication between machines.
Upgrade ArcGIS Server
Upgrade your portal's hosting server and any additional ArcGIS Server sites you federated with your portal.
If you are upgrading from 10.4.1 or an earlier release, provide an ArcGIS GIS Server license when upgrading the portal's hosting server. Which license you provide when upgrading federated servers depends on the role the ArcGIS Server fills in your deployment.
Note:
You must upgrade ArcGIS Server sites before upgrading ArcGIS Data Store.
- Make a remote desktop connection (Windows) or SSH (Linux) connection as the arcgis user to the ArcGIS Server SITEHOST machine for your portal's hosting server.
- Place the new ArcGIS Server and ArcGIS Web Adaptor installations and your ArcGIS GIS Server license file on this machine.
- If your ArcGIS Server site contains only one machine, follow the instructions in Upgrade ArcGIS Server to upgrade a single-machine site.
- If your ArcGIS Server site contains multiple machines, repeat steps 1 and 2 on each machine. Next, follow the instructions in Upgrade ArcGIS Server to upgrade a multiple-machine site.
- If you manually federated additional ArcGIS Server sites with your portal, connect to those machines and upgrade the software and licenses for those sites as well.
Upgrade ArcGIS Data Store
If you have more than one type of data store configured with your portal's hosting server, upgrade each of them.
When upgrading a highly available relational or tile cache data store, upgrade the primary machine before you upgrade the standby machine. When upgrading a multimachine spatiotemporal big data store, stop all but one of the spatiotemporal big data store machines and upgrade the machine that is still running. Start each additional machine, one at a time, and upgrade it until all machines in the spatiotemporal big data store have been upgraded.
- Make a remote desktop connection (Windows) or SSH (Linux) connection as the arcgis user to each machine where ArcGIS Data Store is installed.
- Place the ArcGIS Data Store installation on each machine.
- If your deployment is running on Windows machines on AWS, follow the steps in Upgrade ArcGIS Data Store to update each data store machine.
- If your deployment is on Linux machines on AWS, follow these steps to upgrade ArcGIS Data Store:
- For spatiotemporal big data stores, stop all but one of the spatiotemporal big data store machines.
- Install a new version of ArcGIS Data Store, but do not run the Data Store Configuration wizard.
For highly available tile cache or relational data stores, install the new version of ArcGIS Data Store on the primary data store machine first.
- Run the stopdatastore.sh command to stop ArcGIS Data Store on the machine.
The command is located in <ArcGIS Data Store installation directory>/arcgis/datastore.
- Change directories to <ArcGIS Data Store installation directory>/arcgis/datastore/framework/etc.
- Make a copy of the hostidentfier.properties file and place the copy in another directory.
- Open the original hostidentfier.properties file (not the copy) in a text editor.
- Uncomment the line preferredidentifier=ip.
- Save and close the hostidentfier.properties file.
- Run the startdatastore.sh command to start ArcGIS Data Store.
The command is located in <ArcGIS Data Store installation directory>/arcgis/datastore.
- Open the Data Store Configuration wizard or run the configuredatastore command utility to reconfigure the data store you are currently upgrading.
If you have only one type of data store on a single machine, proceed to test the upgraded deployment.
- For spatiotemporal big data stores, start each additional machine, one at a time, and repeat substeps b through k until all machines in the spatiotemporal big data store are upgraded.
- For highly available tile cache and relational data stores, repeat substeps b through j on the standby data store machine.
Test the upgraded deployment
Test the upgraded ArcGIS Enterprise deployment to be sure all services are running and accessible and your normal workflows still work.
Once testing is successfully completed, you can delete the backup you created before upgrading as it cannot be used to restore to your upgraded machines.
Note:
Create a full backup of the successfully upgraded deployment using the webgisdr utility so that you have a base backup of this version of your deployment.