Skip To Content

Update a single-machine ArcGIS Enterprise deployment on AWS

Updating software on your single-machine ArcGIS Enterprise deployment on Amazon Web Services (AWS) is similar to updating software on-premises; download software updates from My Esri onto your Amazon Elastic Compute Cloud (EC2) instance, and apply the updates directly to your existing deployment. All ArcGIS Enterprise components must be running the same software version. The main difference in updating on AWS is how you create a backup of your existing deployment.

Tip:

If you created your deployment with a CloudFormation template, you may be able to use a CloudFormation template to upgrade. See ArcGIS upgrades on Amazon Web Services to determine if the software version you want to upgrade can be achieved with a CloudFormation template.

  1. Log in to AWS Management Console and create an Amazon Machine Image (AMI) from your existing instance. This is your backup that you can use to redeploy if any issues arise during upgrading. If you have to redeploy, you must deploy using the same portal URL.
  2. Obtain new Portal for ArcGIS and ArcGIS GIS Server licenses from Esri.
  3. Download new versions of Portal for ArcGIS, ArcGIS Web Adaptor, ArcGIS Server, and ArcGIS Data Store from My Esri.
  4. Make a remote desktop connection (Microsoft Windows) or SSH (Linux) connection to the machine on AWS. Connect as the arcgis user. Place all the software downloads on this machine.

    If this is the first time you are upgrading a deployment on a Windows AWS instance, change the arcgis user's password.

    If you deployed the ArcGIS Enterprise on this machine 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.

  5. Follow the steps in Upgrade Portal for ArcGIS to update your portal and its web adaptor, and update your Portal for ArcGIS license.
  6. Follow the single-machine site steps in Upgrade ArcGIS Server to update ArcGIS Server and its web adaptor, and update your ArcGIS Server site with an ArcGIS GIS Server license.
  7. Note:

    You must upgrade ArcGIS Server before upgrading ArcGIS Data Store.

  8. If your deployment is on a Windows instance on AWS, follow the steps in Upgrade ArcGIS Data Store to update the data store.
  9. If you are upgrading a 10.5 or newer deployment on Linux on AWS, follow the steps in Upgrade ArcGIS Data Store to update the data store.
  10. If you are upgrading a 10.3.1, 10.4, or 10.4.1 deployment on Linux on AWS, you must make a copy of the hostidentifier.properties file before you begin upgrading. Follow these steps to copy the file and upgrade ArcGIS Data Store:
    1. Change directories to <ArcGIS Data Store installation directory>/arcgis/datastore/framework/etc.
    2. Make a copy of the hostidentfier.properties file and place the copy in a safe location.
    3. Install the new version of ArcGIS Data Store, but do not run the Data Store Configuration wizard.
    4. Run the stopdatastore.sh command to stop ArcGIS Data Store.

      The command is located in <ArcGIS Data Store installation directory>/arcgis/datastore.

    5. Replace the hostidentfier.properties file in <ArcGIS Data Store installation directory>/arcgis/datastore/framework/etc with the copy of the file you made in step b.
    6. Run the startdatastore.sh command to start ArcGIS Data Store.

      The command is located in <ArcGIS Data Store installation directory>/arcgis/datastore.

    7. Open the Data Store Configuration wizard or run the configuredatastore command utility to upgrade the data store.
  11. When you finish upgrading and testing your updated deployment, you can delete your backup AMI.