Niccole Murphy and Cameron Kroeker

Upgrading ArcGIS Enterprise

Session Agenda

1. Introduction

• Common Terms

• What are upgrades?

• Why upgrade?

• Supported versions

• Things to consider before upgrading

• Recommended Order of Upgrades

2. ArcGIS WebAdaptor

3. Portal for ArcGIS

4. ArcGIS Server

5. ArcGIS Data Store

6. Validation After Upgrading

7. ArcGIS Enterprise Builder

8. Video Demo

Cameron Kroeker

Introduction

Common Terms and Definitions

• In-Place Upgrade: Refers to how the setup is ran. In this scenario the setup for the new version is

installed on top of the existing software. This means you do not uninstall the previous version prior to

installing the newer version.

• Uninstall/Install Upgrade: Refers to how the setup is ran. In this scenario the previous version is

uninstalled prior to installing the newer version. You may also hear this type of upgrade referred to as

an ‘out of place’ upgrade.

• One Click: Refers to what needs to be done after installing the newer version. This means that one

does not need to fill in any forms, you simply click one button and the upgrade of the software

begins.

• Post-Upgrade: A post-upgrade operation is something one needs to do after the upgrade is

complete. The upgrade is complete after the new setup is run and the final continue upgrade button

has been clicked.

• Direct Upgrade: A direct upgrade is when you upgrade from your current version to another,

without needing to go to an intermediate version.

• Indirect Upgrade: An indirect upgrade is when you need to upgrade to an intermediate version of

the software before you can upgrade to the current release.

What are Upgrades?

• Upgrades are the way any existing version of the software moves to a newer version

of the software.

• An upgrade maintains the content, security, configurations, groups, and many

customizations (excludes config.js changes).

• Upgrades do not just apply to the core components, they also apply to Server Roles

(GeoEvent, GeoAnalytics, etc.) as well as all apps (Workforce, Insights, etc.).

Why Upgrade?

• Access the new features and functionality

• Staying within the supported life cycle

• Security vulnerability fixes

• Bug fixes and performance enhancements

Supported Versions

Upgrading To

Upgrading From 10.2 10.2.1 10.2.2 10.3 10.3.1 10.4 10.4.1 10.5 10.5.1 10.6 10.6.1 10.7 10.7.1

10.1 YES YES YES YES YES YES YES YES YES YES YES NO NO

10.2 YES YES YES YES YES YES YES YES YES YES YES YES

10.2.1 YES YES YES YES YES YES YES YES YES YES YES

10.2.2 YES YES YES YES YES YES YES YES YES YES

10.3 YES YES YES YES YES YES YES YES YES

10.3.1 YES YES YES YES YES YES YES YES

10.4 YES YES YES YES YES YES YES

10.4.1 YES YES YES YES YES YES

10.5 YES YES YES YES YES

10.5.1 YES YES YES YES

10.6 YES YES YES

10.6.1 YES YES

10.7 YES

* 10.7.x will be the last release series that direct upgrades from 10.2.x will be supported

Before Upgrading…

• Read the documentation

• Download setups from MyEsri

• Download license file from MyEsri

- Server license file

- Portal license file

- Starting at 10.7 this license file is a JSON file

• If you use any applications like Workforce, Collector, Insights, etc. check version

compatibility with Portal.

- Applications release on a different cycle than Enterprise, some applications may not

support the version of Portal you would like to upgrade to.

• If using a version where the WebGISDR tool is available, run this tool to create a

backup

• Each component has a backup method that should also be used:

- Portal: WebGISDR

- Server: Backup utility

- Data Store: backupdatastore utility

• Take backups of the content stores

- C:\arcgisportal, C:\arcgisserver, C:\arcgisdatastore

• Take a snapshot of all environments

DO NOT UNFEDERATE!

Documentation

• Where you can find upgrade documentation

- Portal for ArcGIS:

http://enterprise.arcgis.com/en/portal/latest/administer/windows/upgrade-portal-for-

arcgis.htm

- ArcGIS Server: http://enterprise.arcgis.com/en/server/latest/get-started/windows/upgrade-

arcgis-server.htm

- ArcGIS Data Store:

http://enterprise.arcgis.com/en/portal/latest/administer/windows/upgrade-data-store.htm

- ArcGIS Enterprise Builder: http://enterprise.arcgis.com/en/get-

started/latest/windows/upgrade-arcgis-enterprise.htm

- High Availability Portal:

http://enterprise.arcgis.com/en/portal/latest/administer/windows/configuring-a-highly-

available-portal.htm#ESRI_SECTION1_63C3F7683D89411187470BEB75A38FB9

Note: These topics will be updated to 10.7 once it is released

Recommended Order of Upgrades

1. Upgrade Portal for ArcGIS

2. Upgrade your Portal’s ArcGIS Web Adaptor

3. Upgrade ArcGIS Server

1. In a multi-node site, it is recommended to upgrade one server at a time

4. Upgrade your Server’s ArcGIS Web Adaptor

5. Upgrade ArcGIS Data Store

You do not need to upgrade through all releases

Cameron Kroeker

Upgrading ArcGIS Web Adaptor

• Take note of the Web Adaptor context you used at the previous version

• This is the Web Adaptor name (for example, ‘arcgis’)

• To find the name you can look at the programs you have installed

• Uninstall the previous version

• Install the 10.7.1 ArcGIS Web Adaptor

• Ensure you use the same context you used

previously

• Reconfigure the Web Adaptor with your Portal for

ArcGIS and your ArcGIS Server

Niccole Murphy

Upgrading Portal for ArcGIS

• At 10.7, if your content is on a file system, you do not need to run a manual reindex

• If upgrading to a version that is not 10.7, you will need to run a full reindex

- This is required to ensure all new and existing content is searchable

- This also ensures the Portal knows where to find content

• If you have configured Living Atlas premium or subscriber content, depending on

the version you are upgrading to, you may be required to upgrade the Living Atlas

content after the upgrade

- At 10.7 Living Atlas content is upgraded for you during a post-upgrade operation

- Prior to 10.7 you need to run the Living Atlas upgrade

• Starting at 10.6.1 we no longer support EGDB’s for the Hosting Server

- You are required to use ArcGIS Data Store

• Prior to 10.7 when upgrading Portal, at the end of the setup you were presented with

the Software Authorization Wizard, at this point you supply a new license file from

My Esri

Licensing

• You will need your new Portal JSON license file before you can upgrade Portal

• If you are upgrading from 10.2 – 10.4.1

- Single

- Multiple

CreatorMember

Creator

Standard (Temporary)Member

Creator

GIS Professional

• If you are upgrading from 10.5 – 10.6.1

- One to One

- Many to Many

Level 1

Level 2

Viewer

Creator

Viewer

Creator

Level 1

Level 2

Creator

GIS Professional

Viewer

…

Lite (Temporary)

Standard (Temporary)

- One to Many (Level 2)

- Many (Level 1) to One

Level 1

Viewer

Viewer

Level 2

Creator

GIS Professional

Standard (Temporary)

Level 1

Viewer

…

Lite (Temporary)

Level 2

Creator

Creator

Licensing

History of Portal Highly Available Upgrades

Pre 10.6.1

• Had to unregister standby

• No validation if that was done

10.6.1

• No need to unregister standby

• Had to Continue Upgrade primary

10.7

• Continue Upgrade either machine

Portal Highly Available Upgrades - 10.6.1

• No validation of whether Portal was HA at 10.6 and earlier

• Starting at 10.6.1, no need to unregister standby

- Had to run Continue Upgrade on primary

• Which machine should I start the install on first?

• Which machine is primary when I want to continue the upgrade?

Portal Highly Available Upgrades - 10.7

• No need to be aware of primary/standby

• Can be run on either machine:

- Start the 10.7 setup

- Continue Upgrade

- Post-upgrade operations

Niccole Murphy

Upgrading ArcGIS Server

• Pre-10.5 when upgrading Server, after the installation, Server upgrade would be

complete and ready to use

• 10.5 and beyond you now have a second step.

- After the setup completes, the browser will open and you will see a page directing you to

‘Continue Server Upgrade’, once this is complete your server will be upgraded and ready

to use

• If you have multiple federated servers that are at minimum 10.5, you can upgrade

them at a later time.

- The Hosting Server must be at the same version as the Portal

Direct Upgrade from 10.1

• At 10.7 you can no longer directly upgrade from 10.1

• If you are at 10.1 you will need to first upgrade to an intermediate version

Multi-Cluster Sites

• At 10.7 we no longer support multiple clusters

• During the upgrade, if you have multiple clusters:

- If you do not have the ‘Default’ cluster, this will be created

- All Servers in the site will be moved to the ‘Default’ cluster

- All services will be moved to the ‘Default’ cluster

- This includes the System and Utility services

- All services will be in a ‘Stopped’ state

- System and Utility services will be in their expected state.

- Services will need to be manually started

Niccole Murphy

Upgrading ArcGIS Data Store

• Prior to 10.7 you are required to upgrade the Primary Data Store before you can

upgrade the Standby Data Store

• At 10.7 you are able to upgrade from either the Primary or Standby Data Store

- You will first need to install the setup on all Data Stores

- Relational and TileCache Primary and Standby

- All Spatiotemporal Data Stores

- On one of the Data Stores initiate the upgrade

• Starting at 10.6 you can no longer perform an uninstall/install upgrade of Data Store

- You will need to perform an inplace upgrade

• To upgrade the spatiotemporal big data store

- Run the installation on each machine in the configuration

- Run the configuration on any machine in the configuration

- The remaining machines are all upgraded automatically

Niccole Murphy

Validation After Upgrade

• After your upgrade is complete, there are a few validations you should check:

- Login to portal and validate all of your servers

- Check your index status in portaladmin

- Check your TLS settings, these may need to be updated

- Publish to Portal

- Publish to Server

- Some common workflows: Server Manager, from ArcGIS Pro, from ArcMap

- If you have upgraded to 10.7 you may need to reassign members of your portal to a valid

User Type

- In some cases your users may be assigned ‘Standard (Temporary)’ or ‘Lite (Temporary)’

Niccole Murphy

ArcGIS Enterprise Builder

• Enterprise Builder was first introduced at 10.5.1

• Upgrades were first supported at 10.6

• Only a deployment initially setup with the Enterprise Builder can be upgraded using

the Enterprise Builder

- During the upgrade, it will upgrade your Portal, Hosting Server, Hosting Data Store, as well

as reconfigure WebAdaptors (keeping the same context that was used at previous version)

• Can use the upgradebasedeployment utility to upgrade silently

Cameron Kroeker

Demo Video

Please Share Your Feedback in the App

Download the Esri

Events app and find

your event

Select the session

you attended

Scroll down to

“Survey”

Log in to access the

survey

Complete the survey

and select “Submit”