Upgrade ArcGIS Enterprise

Overview

The ESRI PowerShell for DSC project support upgrades as well as installs. The steps required to put this into practice will follow.

Process

  • Ensure backup exists

  • Update the ARM template parameters to ensure the CSE will copy the new install media

    • Increase timestamp or remove CSE extension from VMs

  • Run ARM template to ensure proper infrastructure config and to re-run the Custom Scripts Extensions.

    • CSE will copy new install media and DSC templates

    • CSE will ensure the current ArcGIS PowerShell module is installed

  • Create a DSC upgrade template from the original deployment template

  • Remote desktop to WEB0 as user \egisadmin

  • Copy this template to the WEB0 VM and ensure that all passwords and paths are correct

  • Remote desktop to WEB0 as user cloud\argisservice

  • Handle multiple versions of the ArcGIS PowerShell Module

    • May need to update the ArcGIS PowerShell module

      • Get-InstalledModule -Name "ArcGIS" -RequiredVersion 1.1.3 | Uninstall-Module

  • Run the script as follows as the cloud\arcgisservice user

    • If there are auto-shutdown configurations in place and this script is starting late in the day then it may be prudent to disable auto-shutdown (Check tags and VM auto-shutdown settings)

# Powershell Configure-ArcGIS ` -ConfigurationParametersFile 'D:\DSC\PowerShell DSC\some_upgrade_config.json ` -Mode Upgrade # Optional -Credential [Config RunAs - Optional] -DebugSwitch False
  • Wait for completion

Post-Upgrade

  • Quick tests

    • Portal loads

    • Log in

    • Server valid according to Portal > Organization > Settings > Servers

    • Data store valid according to Server > Site > Data Stores

    • Created new hosted layer from CSV

  • Confirm Basemaps

    • Go into the Org settings, click the Map tab, check Share the Esri default basemaps to this group when you click Save, select Raster Basemaps, and click Save.

  • To fix the CAHS symbols, we should invoke the ConfigureCAHSSymbols script against the environment

  • TODO- better wording?Remove and re-add custom print templates

 

Past upgrades