Upgrade ArcGIS deployments on Microsoft Azure—ArcGIS Enterprise in the cloud

A new version of ArcGIS Enterprise Cloud Builder for Microsoft Azure is available with each ArcGIS release. Images that contain the latest version of ArcGIS software are also available at each release. The images and ArcGIS Enterprise Cloud Builder for Microsoft Azure versions you use must match. For example, to deploy ArcGIS Enterprise using 10.9 images or to manage 10.9 deployments, you must use the 10.9 version of ArcGIS Enterprise Cloud Builder for Microsoft Azure.

You can use ArcGIS Enterprise Cloud Builder for Microsoft Azure 10.9 to upgrade the following deployments:

Version 1 (V1) deployments created using ArcGIS Enterprise Cloud Builder for Microsoft Azure 10.6.x or 10.7.x
Version 2 (V2) deployments created using ArcGIS Enterprise Cloud Builder for Microsoft Azure 10.8.x

Note:

Before you can upgrade an ArcGIS GeoEvent Server site (V1 or V2) that contains multiple machines, you must remove all but one machine from the site. See Remove ArcGIS GeoEvent Server machines before upgrading the site for instructions.

For deployments earlier than 10.6, no management options are available from ArcGIS Enterprise Cloud Builder for Microsoft Azure 10.9. To upgrade those deployments, you must connect to the machines in Azure and upgrade the software in the same way as on-premises deployments.

Tip:

You can have different versions of ArcGIS Enterprise Cloud Builder for Microsoft Azure on the same machine, allowing you to manage version-specific deployments.

Upgrade 10.8.x deployments using Cloud Builder

If you created a 10.8 or 10.8.1 deployment using ArcGIS Enterprise Cloud Builder for Microsoft Azure, you can use ArcGIS Enterprise Cloud Builder for Microsoft Azure to upgrade it to the current release.

To upgrade a 10.8.x deployment you launched with ArcGIS Enterprise Cloud Builder for Microsoft Azure, complete the following steps:

Download and install the latest version of ArcGIS Enterprise Cloud Builder for Microsoft Azure.
Start ArcGIS Enterprise Cloud Builder for Microsoft Azure.
Sign in to Microsoft Azure.
If you want to use the Microsoft Azure Government cloud and have an Azure Government subscription, check U.S. Government Cloud.
Choose the Azure subscription that contains the ArcGIS Server site or ArcGIS Enterprise deployment you want to upgrade and click next.
Show V2 Sites and, in the Deployments list, open the details for the deployment you want to upgrade.
Click the Upgrade Deployment button .
When you start the upgrade process from any part of an ArcGIS Enterprise deployment, Cloud Builder upgrades the entire deployment. For example, if you clicked the Upgrade Deployment button for an ArcGIS GeoAnalytics Server site that is federated with your ArcGIS Enterprise portal, ArcGIS Enterprise is upgraded in its entirety, not just the ArcGIS GeoAnalytics Server site.
Provide the user name and password of the machine administrator.
Use the same account you used when you created the instances in your deployment.
If your machines are part of an existing Windows domain in your Azure environment, click Domain Join Options.
1. On the Domain Join Options dialog box, ensure that the Join Existing Windows Domain? option is checked.
2. Provide the name of the Active Directory domain.
3. Provide the user name and password for the domain administrator.
4. Click apply.
Click next to proceed to the License and Credentials page.
Under Site License, provide the current license files.
- If you are upgrading an ArcGIS Enterprise portal, browse to the Portal for ArcGIS license file for Portal License and choose the user type for the license. The user type affects which apps portal members can use.
- If you are upgrading an ArcGIS Enterprise portal (which always includes a hosting server) or a stand-alone ArcGIS GIS Server site, browse to the ArcGIS GIS Server license for Server License.
Type the user name and password for Site Administrator.
You created this account when you created your deployment. Use the same user name and password.
Type the user name and password for ArcGIS Service Account.
You created this account when you created your deployment. Use the same user name and password.
Click next to proceed to Deployment Options.
Choose or create a storage account to contain the artifacts that Cloud Builder creates during the upgrade process. To create a storage account, follow these steps:
1. Type a name for the storage account. Names must be unique. Click Check Availability to confirm that the storage account name is unique.
2. Choose the Azure region where the storage will reside.
3. Choose an existing resource group or create one.
4. Choose the type of redundancy for the storage account: Geo-Redundant, Locally Redundant, or Read-Access Geo-Redundant.
  See Azure Storage redundancy in the Microsoft Azure documentation for a description of each redundancy option.
5. Once the storage account is created, click close.
Click next.
If you are upgrading an ArcGIS Enterprise portal that includes federated servers, provide the user name and password for the account that runs the ArcGIS Server service for each federated server in ArcGIS Service Account. Click next.
The licenses you provide must be for the correct role for each federated server.
Review the settings in the Summary pane. If anything needs to be changed, click back to go to the page where you need to change the information.
Tip:
Click save summary to save your upgrade information to a text file so you can refer to it for information such as license file location and the names of machines that were upgraded.
Click save automation artifacts to export an archive file (.zip) containing information and files you can use in automation scripts to perform future upgrades of this deployment.
1. Browse to a location on the local disk where the archive file will be created and type a name for the file.
2. Choose the automation format.
3. Click generate to create the file.
4. To automate future upgrades, run the Upgrade-ArcGISSite.ps1 script in an Azure PowerShell console or, to upgrade with Azure CLI on Bash, run the upgradeArcGISSite.sh script in a bash shell.
5. Confirm that all settings are correct and save the files you need.
Click finish to upgrade.
Note:
Upgrades can take up to five hours to complete depending on the size of your deployment. Do not close ArcGIS Enterprise Cloud Builder for Microsoft Azure until the upgrade process finishes for all components in the deployment or until you correct for a time-out error as described below.
Due to a current restriction in Microsoft Azure Resource Manager (ARM), template execution is configured to time out at 90 minutes. If your upgrade takes longer than 90 minutes to complete, you will receive a time-out error. Do not close Cloud Builder after receiving the time-out error. Wait 60 minutes after you receive the time-out error, and retry the upgrade operation. To do that, click the back button to return to the beginning of the operation, step through the Cloud Builder windows again, and click finish.
If you encounter problems upgrading, review the log files created in the %temp% directory on the machine where Cloud Builder is installed. By default, that directory is C:\Users\<your login>\AppData\local\temp.
If your deployment contains a federated ArcGIS Notebook Server site, do the following after the deployment upgrade successfully finishes:
1. Make a remote desktop connection to the virtual machine where ArcGIS Notebook Server is running. Connect using the machine administrator credentials you specified when you created the deployment.
2. Copy the new ArcGIS Docker images to the ArcGIS Notebook Server machine and run the postinstallation utility.

Upgrade 10.6 to 10.7.1 deployments using Cloud Builder

If you created a 10.6, 10.6.1, 10.7, or 10.7.1 deployment using ArcGIS Enterprise Cloud Builder for Microsoft Azure, you can use ArcGIS Enterprise Cloud Builder for Microsoft Azure to upgrade it to the current release; however, these deployments remain V1 deployments.

Note:

Before you upgrade, read the following information and complete the preparatory tasks that are applicable to your deployment and upgrade path:

Ensure that at least 20 percent of your operating system disk is free on all virtual machines before you upgrade. In many cases, a disk size of 128 GB is sufficient. If you do not have sufficient free disk space, add more space. If your deployment is using HDD disks and you need more than 128 GB of space, you must upgrade the disk to SSD before you can add more space.
If you created a multimachine deployment using Cloud Builder 10.6 or 10.6.1, you must update the load balancer probe port setting from 7080 to 7443 to account for the changes in the software to ensure network communication uses Transport Layer Security (TLS). To change the load balancer probe port setting, sign in to your account in the Microsoft Azure Portal and locate the Azure internal load balancer associated with machines where Portal for ArcGIS is running. The load balancers are typically named InternalLoadBalancer-Portal. Change the lbprobe port value from 7080 to 7443. For further instructions on editing ports for internal load balancers, see the Microsoft Azure documentation.
You must open ports 29079-29090 and 4369 in the firewall of a multimachine ArcGIS Enterprise deployment before upgrading. You also must confirm that a shared file location is set for tile cache data store backups before upgrading.
Even if you upgrade a 10.6.x or 10.7.x deployment to 10.9, it is still considered a V1 deployment because it was created with the earlier deployment framework.

To upgrade a deployment you launched with ArcGIS Enterprise Cloud Builder for Microsoft Azure 10.6, 10.6.1, 10.7, or 10.7.1, complete the following steps:

Download and install the latest version of ArcGIS Enterprise Cloud Builder for Microsoft Azure.
Start ArcGIS Enterprise Cloud Builder for Microsoft Azure.
Sign in to Microsoft Azure.
If you want to use the Microsoft Azure Government cloud and have an Azure Government subscription, check U.S. Government Cloud.
Choose the Azure subscription that contains the ArcGIS Server site or ArcGIS Enterprise deployment you want to upgrade and click next.
Show V1 Sites and, in the Deployments list, open the details for the deployment you want to upgrade.
Click the Upgrade Deployment button .
When you start the upgrade process from any part of an ArcGIS Enterprise deployment, Cloud Builder upgrades the entire deployment. For example, if you clicked the Upgrade Deployment button for an ArcGIS GeoAnalytics Server site that is federated with your ArcGIS Enterprise portal, ArcGIS Enterprise is upgraded in its entirety, not just the ArcGIS GeoAnalytics Server site.
Provide the user name and password of the machine administrator.
Use the same account you used when you created the instances in your deployment.
If your machines are part of an existing Windows domain in your Azure environment, click Domain Join Options.
1. On the Domain Join Options dialog box, ensure that the Join Existing Windows Domain? option is checked.
2. Provide the name of the Active Directory domain.
3. Provide the user name and password for the domain administrator.
4. Click apply.
Click next to proceed to the License and Credentials page.
Under Site License, provide the current license files.
- If you are upgrading an ArcGIS Enterprise portal, browse to the Portal for ArcGIS license file for Portal License and choose the user type for the license. The user type affects which apps portal members can use.
- If you are upgrading an ArcGIS Enterprise portal (which always includes a hosting server) or a stand-alone ArcGIS GIS Server site, browse to the ArcGIS GIS Server license for Server License.
Type the user name and password for Site Administrator.
You created this account when you created your deployment. Use the same user name and password.
Type the user name and password for ArcGIS Service Account.
You created this account when you created your deployment. Use the same user name and password.
Click next to proceed to Deployment Options.
Choose or create a storage account to contain the artifacts Cloud Builder creates during the upgrade process. To create a storage account, follow these steps:
1. Type a name for the storage account. Names must be unique. Click Check Availability to confirm that the storage account name is unique.
2. Choose the Azure region where the storage will reside.
3. Choose an existing resource group or create one.
4. Choose the type of redundancy for the storage account: Geo-Redundant, Locally Redundant, or Read-Access Geo-Redundant.
  See Azure Storage redundancy in the Microsoft Azure documentation for a description of each redundancy option.
5. Once the storage account is created, click close.
Click next.
If you are upgrading an ArcGIS Enterprise portal that includes federated servers, provide the license file and user name and password for the account that runs the ArcGIS Server service for each federated server in ArcGIS Service Account. Click next.
The licenses you provide must be for the correct role for each federated server.
Review the settings in the Summary pane. If anything needs to be changed, click back to go to the page where you need to change the information.
Tip:
Click save summary to save the upgrade information to a text file so you can refer to it for information such as license file location and the names of machines that were upgraded.
Click save automation artifacts to export an archive file (.zip) containing information and files you can use in automation scripts to perform future upgrades of this deployment.
1. Browse to a location on the local disk where the archive file will be created and type a name for the file.
2. Choose the automation format.
3. Click generate to create the file.
4. To automate future upgrades, run the Upgrade-ArcGISSite.ps1 script in an Azure PowerShell console or, to upgrade with Azure CLI on Bash, run the upgradeArcGISSite.sh script in a bash shell.
5. Confirm that all settings are correct and save the files you need.
Click finish to upgrade.
Note:
Upgrades can take up to five hours to complete, depending on the size of your deployment. Do not close ArcGIS Enterprise Cloud Builder for Microsoft Azure until the upgrade process finishes for all components in the deployment or until you correct for a time-out error as described below.
Due to a current restriction in Microsoft Azure Resource Manager (ARM), template execution is configured to time out at 90 minutes. If your upgrade takes longer than 90 minutes to complete, you will receive a time-out error. Do not close Cloud Builder after receiving the time-out error. Wait 45 to 60 minutes after you receive the time-out error, and retry the upgrade operation. To do that, click the back button to return to the beginning of the operation, step through the Cloud Builder windows again, and click finish.
If you encounter problems upgrading, review the log files created in the %temp% directory on the machine where Cloud Builder is installed. By default, that directory is C:\Users\<your login>\AppData\local\temp.
If your deployment contains a federated ArcGIS Notebook Server site, do the following after the deployment upgrade successfully finishes:
1. Make a remote desktop connection to the virtual machine where ArcGIS Notebook Server is running. Connect using the machine administrator credentials you specified when you created the deployment.
2. Copy the new ArcGIS Docker images to the ArcGIS Notebook Server machine and run the postinstallation utility.

Upgrade 10.5.1 or earlier deployments

If you created your deployment using ArcGIS Enterprise Cloud Builder for Microsoft Azure 10.5.1 or an earlier version, you must upgrade the ArcGIS software in the same way as on-premises installations. Even if your deployment is currently 10.8, if you created it at an earlier release and upgraded it to 10.8, you need to continue manually upgrading the components.

See the following upgrade topics for each component you need to upgrade:

Once you've upgraded the software, do not use ArcGIS Enterprise Cloud Builder for Microsoft Azure for postdeployment operations such as registering databases with ArcGIS Server, installing CA-issued-certificates, managing machines, or upgrading.

Upgrade registered databases that contain geodatabases

If you have managed databases registered with your ArcGIS Server site or you enabled a geodatabase in any of the databases you registered to your ArcGIS Server site, you can upgrade the geodatabase after upgrading ArcGIS Server or ArcGIS Pro in your Azure deployment. See Upgrade an enterprise geodatabase in SQL Server in the ArcGIS Pro help for instructions.

Feedback on this topic?