Skip To Content

Upgrade a base deployment with ArcGIS Enterprise Builder

Beginning at 10.6, ArcGIS Enterprise Builder can upgrade a base deployment previously installed by the builder. The same limitations apply as with installation.

Note:

Deployments set up using another method cannot be upgraded using the ArcGIS Enterprise Builder.

Steps to upgrade

  1. Review and complete prerequisite steps.
  2. Run the ArcGIS Enterprise 10.8.1 Builder installation program to install 10.8.1 components.
  3. Use the configuration wizard or upgradebasedeployment command line utility to perform the upgrade.
  4. Complete post-upgrade steps.

Prerequisites

If you are upgrading to 10.8.1, you may need to re-authorize your software for 10.8.1. If you are upgrading from a version within the same release series, for example from 10.7 to 10.7.1, you do not need to obtain new authorization files. If you are upgrading from a version from a prior release series, you will need to re-authorize your software. You can access your new authorization files in My Esri, along with the ArcGIS Enterprise Builder file.

Review the system requirements for the ArcGIS Enterprise Builder.

Caution:

Windows 7 is not supported for upgrades of an existing ArcGIS Enterprise deployment using the builder.

The Run As accounts for all ArcGIS Enterprise software components must be identical.

Run the ArcGIS Enterprise 10.8.1 Builder setup program

  1. Launch the setup program using Builder.exe.
  2. During the installation, read the master agreement and accept it, or exit if you do not agree with the terms.
  3. The destination folder of your previously installed ArcGIS Enterprise Builder components will be already provided. You cannot change this destination folder during an upgrade. Select Next to continue the setup program.
  4. Provide the password for the account specified. This is the account all ArcGIS Enterprise components were run as. You must use the correct password for this user or the setup program will return an error message. Contact your system administrator if you do not know the password for the specified user account.
  5. When upgrading an existing deployment, you will not be able to change the ArcGIS Web Adaptor (IIS) names for your hosting server and Enterprise portal. The setup program will configure ArcGIS Web Adaptor (IIS) names based on your previous configuration.
  6. At the software authorization dialog, provide the location of your current authorization files for Portal for ArcGIS and ArcGIS Server. These authorization files should be for the version you are installing.
  7. Once the setup has successfully upgraded, the post configuration wizard will automatically launch.

Upgrade using the configuration wizard

You can use the configuration wizard to upgrade ArcGIS Enterprise, or close the browser and use the upgradebasedeployment command line utility to complete your base deployment's upgrade. To use the configuration wizard, complete the following steps:

Once the Setup has run to completion, if it's not already open, browse to the configuration wizard's URL (http://mymachine.mydomain.com:6080/arcgis/enterprise). You can also search your machine for the ArcGIS Enterprise Configuration Wizard and launch it using the shortcut.

Caution:

Do not close or refresh the browser when the upgrade is in progress.

  1. The initial landing page appears and explains that the wizard needs to use a secure connection. Click Next.
  2. You are then redirected to secure port 6443 where the browser shows a security warning; this is expected the first time you access the secure wizard. Continue past the warning (this varies by browser).

The ArcGIS Enterprise Builder upgrade wizard comprises three pages:

  1. On the Import License File page, browse to your portal .JSON file containing authorized user types and app bundles. This file is obtained from My Esri.
  2. On the second page, click Upgrade. This triggers the upgrade and creates a backup of your portal's content, site information, and security settings. This step will take a few minutes to complete.
  3. The third page displays the upgrade progress.
  4. When the upgrade wizard is complete, a final page will confirm this. Exit this page to follow the post-upgrade steps in the next section.

Upgrade using the command line utility

Once you've installed the software with ArcGIS Enterprise Builder, complete the upgrade of your base deployment using the command line utility. In order to run the command line utility, you must choose to run it as administrator.

The upgradebasedeployment command line utility is located in <ArcGIS Server installation directory>\tools\upgradebasedeployment.

By default, that location is C:\Program Files\ArcGIS\Server\tools\upgradebasedeployment .

The following describes the parameters used in the command line utility:

  • -lf —Specifies the path to the portal .JSON license file. If you are upgrading to a version within the same release series, this property is ignored and you can import a new license file after upgrading if needed. The portal .JSON license file is obtained from My Esri.
  • -s —Upgrade the base ArcGIS Enterprise deployment silently with no prompt.
  • -h —Displays help and exits the program.

  1. Open a command prompt.
  2. In the command prompt, change the working directory to the location of the upgradebasedeploymentutility. For example: <ArcGIS Server installation directory>\tools\upgradebasedeployment.
  3. Type the upgradebasedeployment command and parameter directly within the command prompt.
  4. upgradebasedeployment.bat -lf <path to portal json file> -s

Post-upgrade steps

Once you've completed the upgrade wizard steps, you are provided with links to the portal and server.

  1. Verify that you can sign in to the ArcGIS Enterprise portal website through the ArcGIS Web Adaptor URL as an Administrator of your organization. The URL is formatted https://webadaptorhost.domain.com/webadaptorname/home.
  2. If you've configured ArcGIS Pro licenses with your organization, optionally upgrade ArcGIS License Server Administrator. When upgrading ArcGIS License Server Administrator, members with ArcGIS Pro licenses will be unable to access ArcGIS Pro. If members are currently logged in to ArcGIS Pro, they will see a message stating that the program will be closed in 24 hours. Members can complete or save their work within this time period. You are not required to reconfigure ArcGIS Pro licenses after upgrading ArcGIS License Server Administrator.
  3. Restore any customization you previously configured for your ArcGIS Enterprise portal. When restoring your portal customizations in 10.8.1, it's recommended that you do not replace the files you modified in the previous version in 10.8.1. This may adversely affect your 10.8.1 deployment. You need to open each file at 10.8.1 and manually re-add your custom behavior from the previous version.

Tip:

Esri recommends using the serverScan.py and portalScan.py scripts to check for security best practices with your upgraded ArcGIS Server and ArcGIS Enterprise portal.