Skip To Content

Upgrade ArcGIS Server

The ArcGIS Server 10.5.1 setup package is capable of upgrading 10.1 and later versions currently installed on your Linux system. To do this, follow the instructions below.


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

Considerations before upgrading ArcGIS Server

Before upgrading, carefully review the following information.

Can I upgrade directly to ArcGIS Server 10.5.1?

Yes. For example, if you have version 10.2.1 installed, running the 10.5.1 setup script will automatically upgrade it 10.5.1. There is no need for you to obtain and install each released version in order to upgrade to 10.5.1.

Do I need to uninstall my previous version of ArcGIS Server before installing version 10.5.1?

No, but you can. If you have an earlier version of ArcGIS Server installed, the setup script will automatically begin the upgrade to 10.5.1.

What is the order for upgrading my ArcGIS Enterprise deployment to 10.5.1?

Whether you are performing an in-place upgrade or uninstalling the previous version and installing newer software, the recommended order to upgrade your 10.5.1 deployment is the following:

  1. Portal for ArcGIS
  2. ArcGIS Web Adaptor (for Portal)
  3. ArcGIS Server
  4. ArcGIS Web Adaptor (for Server)
  5. ArcGIS Data Store (upgrade primary first, then stand-by)

Do I need to reauthorize when upgrading to 10.5.1?

If you are upgrading to 10.5.1 from 10.5, you do not need to reauthorize the software. However, if you are upgrading from a version previous to 10.5, you will need to authorize your software with a new authorization file for 10.5.1. You can obtain your new authorization files from My Esri.

Do I need to back up any information before performing the upgrade?

For steps on how to back up your ArcGIS Server site prior to upgrading, see Back up and restore your ArcGIS Server site configuration. Note that the backup cannot be used in the upgraded site. It can only be used to restore your site at the earlier release if you need to roll back to the previous version.

If you are using ArcGIS Data Store with a hosting server, create a full backup of the data store before upgrading.

If I've federated my ArcGIS Server with a portal, do I need to upgrade ArcGIS Server when I upgrade the portal?

For your portal deployment to function correctly, your portal and hosting server versions need to be the same. However, as of 10.5.1, you can federate a 10.5 server with Portal for ArcGIS as long as it is not set as a hosting server, GeoAnalytics server or raster analysis Server. If the ArcGIS Server site you've federated with the portal includes multiple machines, upgrade your ArcGIS Server machines sequentially. If you have ArcGIS Web Adaptor (single or multiple) configured with your ArcGIS Server site, you also need to update the Web Adaptors to the same version as ArcGIS Server.

If I've federated my ArcGIS Server with a portal, should I unfederate before upgrading?

No. Do not unfederate when you upgrade your deployment. Doing this will adversely impact your portal deployment. For example, when you unfederate, all hosted layer items remain in the portal but they are disconnected from their services in ArcGIS Server. This means that members cannot access, share, or use these layers in the portal. Additionally, any existing ArcGIS Server services that were imported during the federation process are removed from the portal and are no longer available.

What else do I need to consider before upgrading ArcGIS Server?

Single machine site

If you have a single machine ArcGIS Server site, follow the steps below to upgrade the ArcGIS Server site to version 10.5.1.

Multiple machine site

If you have a multiple machine ArcGIS Server site, you'll need to upgrade each ArcGIS Server machine in the site to version 10.5.1. Upgrade each ArcGIS Server machine sequentially; that is, wait until the first machine is upgraded before applying the upgrade on the next one. Each ArcGIS Server machine in the site must be at the same version number and be licensed exactly the same. Repeat the steps below to upgrade each machine to version 10.5.1.

Upgrade ArcGIS Server

  1. From the command prompt, launch the ArcGIS Server 10.5.1 setup script as the same user used to install the existing earlier version, for example, <CD ROOT or untar directory>/Setup. You do not need to stop ArcGIS Server before launching this script.


    To launch the setup script from the ArcGIS Server 10.5.1 setup media, click the setup script, and select the Run in Terminal button.

  2. The setup will detect your existing earlier version of ArcGIS Server on the target machine and prompt you to continue or exit the upgrade. For example:

    ArcGIS Server 10.5.1 (Linux)
    Your ArcGIS Server 10.3 is installed at:
    Confirm Settings
    Product to upgrade:             ArcGIS Server 10.3 (Linux)
    Location to upgrade:            /home/ags/arcgis/server
    Your ArcGIS Server 10.3 will be stopped when performing the upgrade and 
    ArcGIS Server 10.5.1 will be started after the upgrade completes.
      'y' to continue with these settings
      'q' to exit without upgrading this product
    Enter choice [y,q] (y):
  3. Type y and press Enter to accept the detected settings and continue with the update.


    Wait while ArcGIS Server is upgraded to 10.5.1. This may take several minutes.

  4. If you upgraded from 10.4.1 or an earlier version, you must use the authorizeSoftware tool to reauthorize ArcGIS Server with a new license file once the installation completes. 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.

    If you are upgrading to 10.5.1 from 10.5, you do not need to reauthorize the software.


    If you will be authorizing your ArcGIS Server as multiple licensing roles, you will need to run the authorizeSoftware tool again, for a total of once for each licensing role you apply to the machine.

  5. Once authorized, open ArcGIS Server Manager. Click Continue Server Upgrade to complete the upgrade. You must use ArcGIS Server Manager on the local machine where you are running the upgrade to complete this step. You cannot Continue Server Upgrade through a Web Adaptor or load balancer.

    If errors are returned when you 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 then retry by clicking Continue Server Upgrade again.

  6. If you will use the upgraded ArcGIS Server as an ArcGIS GeoAnalytics Server or for raster analysis with ArcGIS Image Server and you have not 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<webadaptorname>/home.
    3. Browse to My 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 the server is valid, configure it as the portal's GeoAnalytics or raster analysis server by choosing the federated server from the Feature Analysis - GeoAnalytics Tools or Raster Analysis drop-down list.
  7. If you are upgrading from a version previous to 10.5 (10.4.1 or earlier), restart the ArcGIS Server service on the machines for the portal's hosting server and for the federated server that will be used as an ArcGIS GeoAnalytics Server or for raster analysis with ArcGIS Image Server.

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

If you configured ArcGIS Web Adaptor to work with your site, you'll need to install 10.5.1 as well. For instructions, see the following applicable Web Adaptor:

If you want the ability to update passwords in registered and managed database connections used by existing services, run the command utility as described in the next section.

Update services to allow password changes

GIS services use the credentials of ArcGIS Server's registered and managed databases to access data. If the service connects to the registered or managed database using a database user, and that user's password changes, the service can no longer access the data. Starting with ArcGIS 10.4, newly published services are configured to allow you to update database passwords. However, if you upgrade ArcGIS Server 10.3.1 or an older release to 10.5.1 and have existing map, feature, or image services that access a database using a database user, you need to run the command utility to update the services if you want the ability to update passwords.


Although the command will update the database connection, resetting the password will not apply to existing geoprocessing services or their associated result map services. However, you can republish geoprocessing services to your upgraded ArcGIS Server to obtain the type of connection that can be updated to use a new password.

  1. After you upgrade ArcGIS Server on all machines in the ArcGIS Server site, sign in to ArcGIS Server Manager as an ArcGIS Server administrator and validate all registered databases. Go to Site > Data Store and click Validate All.
  2. If any registered database connections are invalid, fix the connection.
  3. Log in to one of the ArcGIS Server machines as the ArcGIS Server installation owner.
  4. Open a command shell and change the directory to <ArcGIS Server installation>/tools/externalizeconnectionstrings.
  5. Run For example


    This will return a list of all services running on the ArcGIS Server site, with messages indicating whether the connection was updated for the service.