Upgrade an ArcGIS Enterprise deployment - Esri/arcgis-powershell-dsc GitHub Wiki

If you have deployed ArcGIS Enterprise using the PowerShell DSC ArcGIS Module, you can use the PowerShell DSC ArcGIS Module to upgrade to new version of ArcGIS Enterprise.

Note: The ArcGIS Module will perform an in-place upgrade, meaning you do not need to manually uninstall any of the ArcGIS Enterprise software components.

Prerequisites

Log in to My Esri. Download your latest ArcGIS Enterprise software installation files and licenses to all of the target nodes.

If there is a newer version of the PowerShell DSC Module in this repository, add it to all of the target nodes, using one of two options:

Note: Remove all previous versions of the ArcGIS Module prior to performing the upgrade.

  1. Clone this repository to the target node or
  2. Install the module from the PowerShell Gallery using the command Install-Module ArcGIS.

Edit your configuration file

Retrieve all of the JSON configuration files you used in your initial installation effort, and make the following modifications:

  1. Modify the Version parameter to match the version you are upgrading to.
  2. Add a new parameter, OldVersion, to the ConfigData block and specify it as the version you are upgrading from. For example, if upgrading from 10.9 to 10.9.1:
"ConfigData":  {
   "Version":  "10.9.1",
   "OldVersion": "10.9"
}
  1. Change the paths to the installer and authorization files you obtained from My Esri.

Note: If the initial deployment was deployed using ArcGIS Module v3.0.0 and below, and you are going to upgrade using an ArcGIS Module v3.0.1 and above, you will also to make changes to the ArcGIS Server Primary Administrator Account and Portal for ArcGIS Initial Administrator Account variables.

Run the upgrade

In PowerShell DSC, run the Invoke-ArcGISConfiguration cmdlet and provide the path to each configuration file used as a comma-separated list - indicated here with the placeholder [Path to Configuration JSON file]. The -Credential, and -DebugSwitch arguments are optional. For additional details regarding the command line arguments, please refer to PowerShell DSC ArcGIS Module Command Line Parameters.

Invoke-ArcGISConfiguration -ConfigurationParametersFile [Path to Configuration JSON File] -Mode Upgrade -Credential [DSC RunAs Account- Optional] -DebugSwitch