Upgrade ArcGIS Insights - Esri/arcgis-powershell-dsc GitHub Wiki

If you have deployed ArcGIS Insights using the PowerShell DSC ArcGIS Module, you can use the PowerShell DSC ArcGIS Module to upgrade to new version of ArcGIS Insights. There are two different scenarios for upgrading ArcGIS Insights. The first scenario is if you want to upgrade both ArcGIS Enterprise and ArcGIS Insights then it's recommended to use -Mode Upgrade. The second scenario is if you want to keep ArcGIS Enterprise the same version and only need to upgrade ArcGIS Insights then it's recommended to use -Mode Install. Both of these scenario's are described below.

Note: You do not need to manually uninstall any of the ArcGIS Enterprise or ArcGIS Insights software components.

Prerequisites

Log in to My Esri. Download your latest ArcGIS Enterprise software installation files and licenses to all of the target nodes. Alternatively, if you have an ArcGIS Online organization account, you can have the Module download the setups for you. For further details, please refer to the Downloading ArcGIS Installation Setups wiki page.

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

Note: Remove all previous versions of the ArcGIS Module prior to performing the upgrade. The default location is C:\Program Files\WindowsPowerShell\Modules

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

Upgrade both ArcGIS Enterprise and ArcGIS Insights:

1. Edit your JSON 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 json block and specify it as the version you are upgrading from.
  3. Modify the InsightsVersion parameter to match the version you are upgrading to.
  4. Add a new parameter, OldInsightsVersion, to the ConfigData json block and specify it as the version you are ugprading from.

For example, if upgrading from ArcGIS Enterprise 10.9.1 to 11.0, and upgrading ArcGIS Insights 2022.1.1 to 2022.3:

"ConfigData":  {
   "Version":  "11.0",
   "OldVersion": "10.9.1",
   "InsightsVersion": "2022.3",
   "OldInsightsVersion": "2022.1.1"
}
  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.

2. 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]. Be sure to include -Mode Upgrade. 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

Upgrade only ArcGIS Insights:

1. Edit your JSON configuration file

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

  1. Modify the InsightsVersion parameter to match the version you are upgrading to.
  2. Change the ConfigData.Insights.Installer.Path to the new installer.

2. 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]. Be sure to include -Mode Install. 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 Install -Credential [DSC RunAs Account- Optional] -DebugSwitch