Upgrade an existing single machine base ArcGIS Enterprise deployment

In this workflow, you will use the arcgis-enterprise cookbook to upgrade an existing ArcGIS Enterprise deployment.

Prerequisites:

• Latest Setups from My Esri for ArcGIS Enterprise:
  • Portal for ArcGIS
    • Portal for ArcGIS WebStyles (optional: starting at 10.7.1 and above)
  • ArcGIS Server
  • ArcGIS Data Store
  • ArcGIS Web Adaptor
• Portal for ArcGIS and ArcGIS Server authorization files
• Additionally, it is recommended to create a backup using the ArcGIS Enterprise WebGISDR tool
• An existing ArcGIS Enterprise base deployment that was originally deployed using Chef. This is so that we can modify a few of the parameters in the existing role JSON file for the upgrade.

Windows or Linux

1. Download and install Chef Client. ArcGIS Chef cookbooks support Chef-Client versions 13 and 14.

   Note: For Windows Server 2019 it is recommended to use 14.14.29.

2. Download the latest arcgis-cookbook that corresponds with the ArcGIS Enterprise version you are upgrading to here.

3. Extract the contents of the cookbook.

   • If using Windows, extract the contents of the cookbook zip file to C:\chef. The final folder structure should be c:\chef\cookbooks\arcgis-enterprise; c:\chef\cookbooks\arcgis-repository; etc.
   • If using Linux, unzip and untar the gz file to the /var/chef folder. The final folder structure should be /var/chef/cookbooks/arcgis-enterprise; /var/chef/cookbooks/arcgis-repository; etc.

4. Using a text editor, open the role JSON file that was used to originally deploy ArcGIS Enterprise, and save with a new name.

   • Windows: C:\chef\roles\arcgis-enterprise-upgr.json
   • Linux: /var/chef/roles/arcgis-enterprise-upgr.json

5. Using a text editor, open the arcgis-enterprise-upgr.json file created in step 4.

   • Update the node['arcgis']['version'] attribute to the latest version you are upgrading to.
   • Update the ['setup'], or ['setup_archive'], paths to point to the latest version you are upgrading to for each Enterprise component.
   • Update the node['arcgis']['portal']['authorization_file'] and node['arcgis']['server']['authorization_file'] to point to the latest version of authorization files you are upgrading to.
   • Add the node['arcgis']['portal']['user_license_type_id'] attribute.
     • For example: "user_license_type_id":"creatorUT"

6. In the arcgis-enterprise-upgr.json file, ensure the recipe "run-list" is in the following order:

   • "recipe[arcgis-enterprise::portal]",
   • "recipe[arcgis-enterprise::portal_wa]",
   • "recipe[arcgis-enterprise::server]",
   • "recipe[arcgis-enterprise::server_wa]",
   • "recipe[arcgis-enterprise::datastore]"

7. Use chef-client and the arcgis-enterprise-upgr.json role file to perform the upgrade.

   • Windows: Start a command prompt window as an administrator and run chef-solo -j C:\chef\roles\arcgis-enterprise-upgr.json
   • Linux: As the super user, run chef-solo -j /var/chef/roles/arcgis-enterprise-upgr.json

8. After the chef-client run is completed, your ArcGIS Enterprise portal and hosting server will be available at the https://hostname.domain.com/portal and https://hostname.domain.com/server URLs, respectively.

Supported platforms

• Windows Server 2008 R2, Windows Server 2012 and 2012 R2, Windows Server 2016, Windows Server 2019
• Ubuntu 14.04 LTS, Ubuntu 16.04 LTS, Ubuntu 18.04 LTS RHEL 6.5, RHEL 7, CentOS 7
• Non-English Operating Systems are supported.

Note:

• For a disconnected environment, make sure you have access to the component resources, e.g. for Tomcat, .NET Framework, etc.