Skip To Content

Upgrade ArcGIS Server

ArcGIS Server 11.2 is provided as a setup program and is run through a utility named Setup.exe.

The ArcGIS Server 11.2 setup package is capable of upgrading 10.7 and later versions currently installed on your system. To do so, follow the instructions below.

Caution:

The upgrade process will restart all of your ArcGIS Server services. You should consider your ArcGIS Server site to be offline during the upgrade.

Migrate ArcMap runtime services to the ArcGIS Pro runtime

Beginning with ArcGIS Enterprise 11.0, ArcGIS Server no longer supports the ArcMap service runtime. You cannot publish services from ArcMap (including those published using the version of ArcPy installed with ArcMap) to ArcGIS Server sites.

When you upgrade ArcGIS Server from 10.9.1 or earlier to 11.2, you will see the following behavior for existing web layers:

  • The following existing map, image, and geodata services that use the ArcMap service runtime will be migrated to the ArcGIS Pro service runtime as part of the upgrade process. The service configuration will remain the same after the service has been migrated.
    • Map services (with or without KML enabled)
    • Feature services (map services with feature access enabled)
    • Image services
    • WMS services (map services with WMS enabled)
    • WCS services (map services with WCS enabled)
    • WFS services (map services with WFS enabled)
    • Network Analysis services (map services with Network Analysis enabled)
    • Geodata services
  • If any of the migrated map, image, or geodata services contain data that the ArcGIS Pro runtime does not support, the layers will be removed from the service after you upgrade.
  • Geocode and geoprocessing services that use the ArcMap service runtime will not function until you migrate or republish them.

For more information on migrating services, see Migrating services to the ArcGIS Pro service runtime.

Upgrade ArcGIS Server from 10.7 and later

The ArcGIS Server 11.2 setup package is designed to detect and upgrade an existing installation of ArcGIS Server on the target system. There is no need to obtain and install each previously released version in sequence or to uninstall your previous version of ArcGIS Server.

Upgrade ArcGIS Server from 10.6.1 or earlier

Upgrading directly to ArcGIS Server 11.2 from version 10.6.1 or earlier is not supported. To upgrade to ArcGIS Server 11.2 from version 10.6.1 or earlier, first upgrade to an interim version (10.7–10.9.1). Then upgrade that version to ArcGIS Server 11.2. This will preserve your site's configuration store and server directories.

Note:

Read the upgrade documentation for the interim version to confirm direct upgrades are supported for the ArcGIS Server version you are starting with.

Sites at version 10.0 and earlier cannot keep existing content or directories. You must uninstall the software and install ArcGIS Server 11.2 as a new site.

Prepare to upgrade ArcGIS Server

Before upgrading, carefully review the following information. See the full list of frequently asked questions for upgrading ArcGIS Server.

ArcGIS Enterprise upgrade order

The recommended order to upgrade the components in your ArcGIS Enterprise deployment is as follows:

  1. Upgrade Portal for ArcGIS.
  2. Upgrade ArcGIS Web Adaptor (for Portal for ArcGIS) for IIS or Java (Windows).
  3. Upgrade the ArcGIS Server site serving as the portal's hosting server.
  4. Upgrade ArcGIS Web Adaptor (for ArcGIS Server) for IIS or Java (Windows).
  5. Upgrade ArcGIS Data Store.
  6. If your ArcGIS Enterprise deployment includes federated servers, upgrade them.

    Most federated servers must match the version of the base ArcGIS Enterprise deployment. For more information about supported versions for federated servers, see Federate an ArcGIS Server with your portal.

    See the upgrade information for the type of federated servers you need to upgrade.

Upgrade a single-machine site

If you have a single-machine ArcGIS Server site, follow the steps in the sections below to upgrade the ArcGIS Server machine to version 11.2. The following options are available to upgrade your ArcGIS Server site:

Upgrade a multiple-machine site

If you have a multiple-machine ArcGIS Server site, you need to upgrade each machine in the site to version 11.2. It's recommended that you upgrade each ArcGIS Server machine sequentially; that is, wait until the first machine is upgraded before continuing the upgrade on the next one. Each ArcGIS Server machine in the site must be at the same version number and be licensed the same.

If you have ArcGIS Web Adaptor configured with your machines, upgrade each ArcGIS Web Adaptor instance once its corresponding ArcGIS Server machine has finished upgrading.

If you have a multiple-machine ArcGIS GeoAnalytics Server site, follow the additional steps in the Upgrade ArcGIS GeoAnalytics Server section below when upgrading.

The following options are available to upgrade your ArcGIS Server machines. Repeat the upgrade steps on each ArcGIS Server machine to upgrade your site to version 11.2.

Upgrade using the setup program

  1. Browse to the location of the setup files and double-click Setup.exe.
  2. During the installation, read the master agreement and accept it, or close the installation window if you do not agree with the terms.
  3. Click next after confirming the features that will be installed.Select features for installation.

    GIS Server—Hosts GIS services that can be accessed through REST and SOAP. It is administered using ArcGIS Server Manager and its services are browsed through the Services Directory. This feature is required, and includes support for publishing and hosting ArcGIS Pro-based services.

    .NET Extension Support—Supports the development and deployment of .NET server object extensions (SOEs) and server object interceptors (SOIs). This feature is optional. The appropriate version of Microsoft .NET is required for the .NET Extension Support feature to be displayed as a feature to be installed.

    See the ArcGIS Server system requirements for the currently supported version of Microsoft .NET.

  4. Specify an ArcGIS Server account.
    Specify
    1. If you select the Specify the account name and password option, enter the password for the ArcGIS Server account used by your existing installation that is prepopulated in the ArcGIS Server Account text box.

      Typically, this is the password you provided when installing the software. If the password has changed since you installed the software, for example, by using the Configure ArcGIS Server Account Utility, you must provide the password you designated when modifying the account.

      If the password is not validated, an error message appears indicating that the password is invalid. If you are unsure of the password for the ArcGIS Server account, contact your system administrator or reset your password using the Configure ArcGIS Server Account Utility. For more information, see The ArcGIS Server account.

    2. If you select the second option, I have a configuration file with the account information generated by a previous run of this setup, the credentials in the server configuration file must be the same credentials used by your existing ArcGIS Server site.
  5. If you selected Specify the account name and password and manually entered the ArcGIS Server account information, the next dialog box presents you with the option to export a server configuration file. 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, select Export configuration file. Browse to a secure folder and provide a name for the configuration file.
    Export a server configuration file.

    The following are reasons you may want to export a server configuration file:

    • Create the same ArcGIS 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 Server is being installed must have write permissions to the network share. For example, if you're installing ArcGIS Server on a machine named Quick, the Local System account on Quick must have write permission 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.

  6. Follow the directions on screen to complete the installation.
  7. After installation is complete, the software authorization wizard appears, prompting you to reauthorize ArcGIS Server with a new license file. You can access your new authorization files in My Esri. You can choose to authorize your software later, but you must complete this workflow before moving on to the next step of the upgrade process.
    Note:

    If you'll be authorizing your ArcGIS Server as multiple licensing roles, you'll need to run the software authorization wizard again, once for each licensing role you apply to the machine.

    If your ArcGIS Server license has an expiration date, consider updating the licenses in your enterprise geodatabases after upgrading and updating your ArcGIS Server license.

  8. Once authorized, ArcGIS Server Manager automatically starts. Click Continue Server Upgrade to complete the upgrade.

    You must use ArcGIS Server Manager on the local machine where you're running the upgrade to complete this step. If a local host is not available, you can access ArcGIS Server Manager through the fully qualified domain name of the server machine on port 6443 (https://gisserver.domain.com:6443/arcgis/manager). You cannot continue the upgrade through a Web Adaptor or load balancer.

    Caution:

    If errors are returned when you click Continue Server Upgrade, you may need to address the errors before you can continue. For example, if you encounter an error about an invalid license, you must reauthorize the software using a valid license. You can retry by clicking Continue Server Upgrade again.

  9. If you configured ArcGIS Web Adaptor to work with your site, you'll need to install a 11.2 ArcGIS Web Adaptor as well. Follow the instructions for the type of web adaptor you use.

    Note:

    If you federated an ArcGIS Server site with your portal and you're using ArcGIS Web Adaptor with your site, sign in to the machine hosting the Web Adaptor and uninstall ArcGIS Web Adaptor. Take note of the Web Adaptor name; you must use the same name when you reinstall.

    If you have a multiple-machine ArcGIS Server site, repeat the steps above on the remaining ArcGIS Server machines in your site. Wait until a site has finished upgrading before clicking Continue Server Upgrade on another site.

  10. If you'll use the upgraded ArcGIS Server as an ArcGIS GeoAnalytics Server or for raster analysis with ArcGIS Image Server and you haven't previously used either of these roles, follow these steps to use your upgraded ArcGIS Server site for these purposes:
    1. Be sure you authorized the site with an ArcGIS GeoAnalytics Server or ArcGIS Image Server licensing role.
    2. Sign in to the portal federated with your site. Sign in as a member of the default administrator role. The portal URL is in the format https://webadaptorhost.domain.com/<webadaptorname>/home.
    3. Click Organization > Edit Settings > Servers.
    4. On the Servers page, click Validate Servers to verify that the federated server you want to use as an ArcGIS GeoAnalytics Server or raster analysis server can still communicate with the portal. A green check mark appears next to each valid federated server.
    5. Once you verify that the server is valid, configure it as the portal's GeoAnalytics Server or raster analysis server by choosing the federated server from the Feature Analysis - GeoAnalytics Tools or Raster Analysis drop-down list.
  11. If you're upgrading from 10.4.1 or earlier, restart the ArcGIS Server service on the machines in the portal's hosting server and the machines in the federated ArcGIS GeoAnalytics Server and raster analysis server (ArcGIS Image Server).
Legacy:

To change the passwords for the database connection files used with services published from ArcGIS Server 10.1 to 10.3, you must run the externalizeconnectionstrings.bat utility. This process is only necessary when ArcGIS Server has been upgraded to recent releases, but services were not externalized in the process.

If you've customized a service with SOEs or SOIs, restart the service after upgrading ArcGIS Server.

Upgrade silently

When silently upgrading using the setup.exe file, you must specify the ArcGIS Server account used by the software. Typically, this is the account you defined when installing the software. If the account has changed since you installed, for example, by using the Configure ArcGIS Server Account Utility, you must provide the username and password you designated when modifying the account.

If you do not specify the ArcGIS Server account, or it does not match the ArcGIS Server account used by your current installation, the installation process displays a message indicating that the credentials could not be validated. As a result, the installation window will close.

You can determine the ArcGIS Server account by accessing the Configure ArcGIS Server Account Utility from the Start menu on the machine hosting ArcGIS Server. The ArcGIS Server account is listed on the dialog box. If you are unsure of the password for the ArcGIS Server account, contact your system administrator or reset your password using the Configure ArcGIS Server Account Utility. For more information, see The ArcGIS Server account.

In the following example, the ArcGIS Server account used by the software is myaccount:

<path to ArcGIS Server setup download folder>\Setup.exe /qb USER_NAME=myaccount PASSWORD=mypassword ACCEPTEULA=yes

After the installation completes, the software authorization wizard appears, prompting you to reauthorize ArcGIS Server with a new license file. You can access your new authorization files in My Esri. You can choose to authorize your software later, but you must complete this workflow before moving on to the next step of the upgrade process.

Note:

If you'll be authorizing your ArcGIS Server as multiple licensing roles, you must run the software authorization wizard again, once for each licensing role you apply to the machine.

If your ArcGIS Server license has an expiration date, consider updating the licenses in your enterprise geodatabases after upgrading and updating your ArcGIS Server license.

Once authorized, ArcGIS Server Manager automatically starts. Click Continue Server Upgrade to complete the upgrade.

Note:

You must use ArcGIS Server Manager on the local machine where you are running the upgrade to complete this step. The Continue Server Upgrade operation cannot be completed through a Web Adaptor or load balancer.

Starting at 10.6, you can also use the upgradeserver command line utility to complete the upgrade and postupgrade operations silently. In the command line, browse to your <Server install directory>/tools/upgradeserver folder and run the following: upgradeserver.bat -s. For assistance, run the command with -h or --help.

If you configured ArcGIS Web Adaptor to work with your site, you'll need to install a 11.2 ArcGIS Web Adaptor as well. Follow the instructions for the type of web adaptor you use

Note:

If you federated an ArcGIS Server site with your portal and you're using ArcGIS Web Adaptor with your site, sign in to the machine hosting the Web Adaptor and uninstall ArcGIS Web Adaptor. Take note of the Web Adaptor name; you must use the same name when you reinstall.

Note:

If you have a multiple-machine ArcGIS Server site, repeat the silent upgrade above on the remaining ArcGIS Server machines in your site.

You can update passwords and host names in registered and managed database connections used by existing services.

Upgrade ArcGIS GeoAnalytics Server

If you have a multiple-machine GeoAnalytics Server site, you must complete additional steps when upgrading your deployment as follows:

  1. Stop the ArcGIS Server service on all machines in the GeoAnalytics Server site using the Windows Service Manager desktop app.
  2. Restart each machine in the site. Once restarted, open the Windows Service Manager on each machine. If the ArcGIS Server service is running, stop the service.
  3. Check for any detached ArcGIS Server processes that are known to impede the upgrade process as follows:
    1. Open Task Manager to view running processes. Click More Details if it's not open by default.
    2. On the Details tab, right-click the Name header and click Select Columns.
    3. On the Select Columns dialog box, check the Command Line option and click OK. Sort the processes by the Name column.
    4. Look for processes named cmd.exe. In the Command Line column, check for paths beginning with <ArcGIS Server install location>\ArcGIS\Server\. If these processes exist, right-click each and click End Task.
    5. Look for processes named java.exe. In the Command Line column, check for paths beginning with <ArcGIS Server install location>\ArcGIS\Server\. If these processes exist, right-click each and click End Task.
    6. Repeat the above steps for all machines in the GeoAnalytics Server site.
  4. When you're sure that no detached ArcGIS Server processes are still running, follow the upgrade steps in this topic to upgrade the primary machine in your GeoAnalytics Server site, whether you're using the setup program or upgrading silently.
  5. Repeat these steps for each machine in the site.
  6. When all machines have been upgraded, stop the ArcGIS Server service on all machines again. Wait at least five minutes to allow the system to make necessary adjustments.
  7. After at least five minutes have elapsed, use the Services app to restart the ArcGIS Server service on all machines in your site. Again, wait at least five minutes after restarting the service.
  8. Use the Compute Platform Health Check operation in the ArcGIS Server Administrator Directory to verify that your GeoAnalytics Server site is ready to use.

Scan for security best practices

It is recommended that you use the serverScan.py script to check for security best practices with your ArcGIS Server site after installation.