Upgrade ArcGIS Mission Server

Upgrading ArcGIS Mission Server provides your organization with the software's latest features and improvements.

The ArcGIS Mission Server setup package detects whether you have an existing installation of a previous version of ArcGIS Mission Server on your machine. If you do, it can upgrade the software to the new version.

Multiple-machine ArcGIS Mission Server sites are supported at 10.8.1 and later. If you have a single-machine site and want to expand your ArcGIS Mission Server site to multiple machines after upgrading, follow the steps to join additional machines to the site after you have finished upgrading to to the new version.

The upgrade process for ArcGIS Mission Server is an in-place upgrade, which does not require uninstalling and reinstalling software. The site will be down during the upgrade process, and users will be unable to access until the upgrade is complete.

Follow the steps below to upgrade ArcGIS Mission Server.

Prepare to upgrade

Before upgrading, carefully review the following information:

• You can access all of the necessary files in My Esri before upgrading.
• For ArcGIS Mission Server to function correctly, its version must match the version of the portal with which it's federated.
• To upgrade your ArcGIS Enterprise deployment, do the following:
  1. Upgrade Portal for ArcGIS.
  2. Upgrade ArcGIS Web Adaptor (for Portal for ArcGIS).
  3. Upgrade the ArcGIS Server site serving as the portal's hosting server.
  4. Upgrade ArcGIS Web Adaptor (for Server).
  5. Upgrade ArcGIS Data Store (upgrade primary first, then standby).
  6. Upgrade any other servers, including ArcGIS Mission Server.
• Do not unfederate your ArcGIS Mission Server site from the portal or remove its designation as the portal's Mission Server at any point during the upgrade process.
• Before upgrading, clear the caches of all web browsers used on the ArcGIS Mission Server machine.

Back up your deployment

Before you upgrade, it's recommended that you make backups of your deployment. Perform the following steps to complete the backup operation:

1. Open the ArcGIS Mission Server Administrator Directory and sign in as a user with administrative privileges. The URL is typically https://missionserver.domain.com:20443/arcgis/admin.
2. Browse to site > Export Site.
3. Enter the full path of the location on your machine to which you want to export the file. The site must have access to this directory.
4. Click Export.
5. When the export operation is complete, the directory will provide a link to the backup file location on the server. Download the file, which will have an .agssite file extension, as promptly as possible.

Upgrade using the setup program

Complete the following steps to upgrade your server using the setup program:

1. During the installation, read the master agreement and accept it, or close the installation window if you do not agree with the terms.

   The setup program displays the feature that will be installed and the free disk space it requires on your hard drive.

2. On the next dialog box, either specify the account login credentials or provide a configuration file.

   The ArcGIS Mission Server account used by your existing installation is prepopulated in the ArcGIS Server Account box. Provide the password for the ArcGIS Mission Server account. Typically, this is the password you defined when installing the software.

   If the password is not validated successfully, an error message appears, indicating that the password is invalid. If you are unsure of the password for the ArcGIS Mission Server account, contact your system administrator or reset your password using the ArcGIS Mission Server Administrator Directory.

   If you provide a configuration file, the credentials in the server configuration file must be the same credentials used by your existing ArcGIS Mission Server site.

3. If you selected Specify the account name and password and manually entered the ArcGIS Mission Server account information, you can export a server configuration file on the dialog box that appears. If you do not want to export a configuration file, click Next and accept the default Do not export configuration file option. If you want to export a server configuration file for future installations, click Export configuration file, browse to a secure folder, and provide a name for the configuration file.

   Note:

   You may want to export a server configuration file if you need to do any of the following:

   • Create the same ArcGIS Mission Server account when installing on multiple machines.
   • Store the account for use when upgrading to a newer version.
   • Perform a silent installation in which the username and password are encrypted.

   Caution:

   When exporting a server configuration file to a network share, the Local System account on the machine where ArcGIS Mission Server is being installed must have write permissions to the network share. If the permissions are not set, the server configuration file may not export successfully. If you're unsure how to correctly set permissions for the network share, contact your system administrator, or export the server configuration file locally and copy it to the network share.

4. To complete the installation, follow the directions on the screen.
5. After installation is complete, the configuration wizard opens in a browser. Follow the instructions in the configuration wizard to complete the upgrade process.
6. If you have a multiple-machine site, proceed to follow steps 1 through 5 for the rest of your site's machines. If you have a single-machine site and plan to upgrade to a multiple-machine site, you can now join the additional machines to the site. You must also modify the paths of the server directories and of the configuration store to use shared locations that are accessible to each machine.

Upgrade from the command line

1. To start the upgrade, run ./Setup from the location where ArcGIS Mission Server was extracted, with the argument shown in the example below and follow the prompts to complete the upgrade. This will uninstall the previous version of ArcGIS Mission Server and install the upgraded version of ArcGIS Mission Server.

   <untar directory>/Setup -l yes -m silent

2. After the upgrade utility has completed, you must reauthorize your ArcGIS Mission Server software. Run the software authorization with the following syntax to authorize ArcGIS Mission Server silently:

   <ArcGIS Mission Server install directory>/tools/authorizeSoftware

   Run the following command to view all options for authorization:

   <ArcGIS Mission Server install directory>/tools/authorizeSoftware --help

   Note:

   See the section Authorize in a disconnected environment for information on authorizing the Mission Server installations in a disconnected environment.

3. Upgrade the site using the upgradesite command line utility. This utility has two parameters:

   • -s—When included in the command, this prompts the utility to run the upgrade. The upgrade won't run without -s. This is intended as a safeguard to ensure you only run the upgrade when you're ready.
   • -h—Displays the help for the tool. When the command is run without -s, the help also displays.

   By default, the upgradesite utility is found at ${HOME}/arcgis/missionserver/tools/upgradesiteutility/upgradesite.sh.

   Before upgrading, review the preparation information at the beginning of this topic. When you are ready to upgrade, open a command terminal on the machine you're upgrading. Browse to the directory where the utility is located, and run the following command:

   > ./upgradesite.sh -s

   The utility will display progress reports and stop when the upgrade is complete.

4. For a multiple-machine site, follow steps 1 through 3 for each machine in the site, then continue to the steps in the next section.

Upgrade from 10.9 using the setup program

Note:

If you encounter the following error, you launched setup.msi instead of setup.exe.

It is recommended that you use setup.exe to upgrade ArcGIS Mission Server. If organizational restraints prevent you from using setup.exe, complete the following workflow.

Upgrade silently from 10.9 using setup.msi

As a security concern, some organizations have restraints in place that prevent the use of executable files (.exe) within their IT infrastructure. If your organization has similar constraints, you can alternatively install the software using setup.msi.

Keep in mind that it is recommended that you upgrade ArcGIS Mission Server using setup.exe. This file accepts all supported command line parameters and automatically installs setup.msi as part of the upgrade.

To upgrade to using setup.msi, complete the following steps:

1. If you're not upgrading ArcGIS Mission Server from 10.9, skip this step and proceed to step 2. On the machine hosting ArcGIS Mission Server 10.9, run the following command to apply the SP1 patch: msiexec /p <path to ArcGIS Mission Server setup download folder>\Support\patch\ ArcGIS-109-MS-U-Patch.msp /qb
2. Specify the ArcGIS Mission Server account.

In the following example, the ArcGIS Mission Server account used by the software is myaccount: msiexec /I <path to ArcGIS Mission Server setup download folder>\SetupFiles\setup.msi /qb USER_NAME=myaccount PASSWORD=mypassword