Upgrade ArcGIS Server—ArcGIS Server | Documentation for ArcGIS Enterprise

Note:

If you are upgrading ArcGIS Server from 10.1 to 10.6.x, an in-place upgrade is not supported. You must uninstall the 10.1 software and then install ArcGIS Server 10.6.x.

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

Caution:

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

Prepare to upgrade ArcGIS Server

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

If you are upgrading to 10.6.1 from version 10.5.1 or earlier, you will need to re-authorize your software with a new authorization file for 10.6.1. You can access your new authorization files in My Esri. If you are upgrading from version 10.6, you do not need to reauthorize your software.
Running the 10.6.1 setup will automatically upgrade your ArcGIS Server to 10.6.1. There is no need to obtain and install each previously released version in sequence, or to uninstall your previous version of ArcGIS Server.
For your ArcGIS Enterprise portal to function, it must be the same version as your hosting server. You also need to re-install your Web Adaptor instances to the same version as ArcGIS Server.
The recommended order to upgrade your 10.6.1 deployment is the following:
1. Upgrade Portal for ArcGIS
2. Upgrade ArcGIS Web Adaptor (for Portal)
3. Upgrade ArcGIS Server (update hosting server first, then any other servers)
4. Upgrade ArcGIS Web Adaptor (for Server)
5. ArcGIS Data Store (upgrade primary first, then stand-by)
If you have a multimachine ArcGIS Server site, you need to upgrade each machine in the site to version 10.6.1. It's recommended that you 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.
If you have already configured an enterprise geodatabase as the managed database for your hosting server and you are upgrading to 10.6.1, you will need to conduct a few additional steps. Once you've upgraded Server, you will need to register the enterprise geodatabase as a database (as opposed to a managed database). Then, install ArcGIS Data Store and register it as a relational data store. This will configure ArcGIS Data Store as your hosting server's managed database.
Your ArcGIS Enterprise portal's version must match the version of the hosting server, any GeoAnalytics Server, any GeoEvent Server, and any Raster Analytics Server federated with it. However, a 10.6 portal will work with any other federated server that is at version 10.5 or later. For example, a 10.5 GIS Server (that is not the hosting server) and a 10.5.1 Business Analyst Server can be federated with a 10.6 portal as long as its hosting server is at version 10.6.
If you have a multiple-machine ArcGIS GeoAnalytics Server site, follow the additional steps in this section when upgrading.
If you back up your ArcGIS Server site prior to upgrading, you can use the backup if you need to roll back to the previous version. For steps on how to back up your ArcGIS Server site prior to upgrading, see Back up and restore your ArcGIS Server site configuration
Do not unfederate any server federated with a portal when you upgrade your deployment. This adversely impacts your portal deployment, as users will be unable to access, share, or use ArcGIS Server services in the portal.
If your site is in read-only mode, the site mode will be set to editable for you when you upgrade. After all machines in your site have been successfully upgraded, the site will remain in editable mode. You can switch back to read-only mode once your upgrade is complete.
The 10.0 SQL Server-based identity store has been deprecated as of 10.5. Your site will be changed to use a built-in user and group store if you upgrade to 10.6.1 and previously used a SQL Server-based identity store.
Before you upgrade your ArcGIS Server site, ensure that any databases you use are supported at the upgraded ArcGIS Server release. See the relevant Relational Database Management Systems requirements topic for details.

Upgrade ArcGIS Server

From the command prompt, launch the ArcGIS Server 10.6.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.
Tip:
To launch the setup script from the ArcGIS Server 10.6.1 setup media, click the setup script, and click the Run in Terminal button.

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.6.1 (Linux)
=========================================================================

Your ArcGIS Server 10.3 is installed at:

/home/ags/arcgis/server

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.6.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):

Type y and press Enter to accept the detected settings and continue with the update.
Note:
Wait while ArcGIS Server is upgraded to 10.6.1. This may take several minutes.
After installation is complete, 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.
Note:
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.
Once authorized, open ArcGIS Server Manager. Click Continue Server Upgrade to complete the upgrade on your first machine. You must use ArcGIS Server Manager on the local machine where you are running the upgrade to complete this step, and you should run the upgrade one machine at a time. You cannot Continue Server Upgrade 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 post-upgrade operations silently. In the command line, navigate to your <Server install directory>/tools/upgradeserver folder and run the following: upgradeserver.sh -s. For assistance, run the command with -h or --help.
Caution:
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.
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 https://webadaptorhost.domain.com/<webadaptorname>/home.
3. Browse to 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.
If you are upgrading from version 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.6.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 externalizeconnectionstrings.sh command utility as described in the next section.

If you have customized a service with server object extensions (SOEs) or server object interceptors (SOIs), restart the service after upgrading ArcGIS Server.

Upgrade ArcGIS GeoAnalytics Server

If you have a multi-machine GeoAnalytics Server site, you must follow some additional steps when upgrading your deployment.

Stop the ArcGIS Server service on all machines in the GeoAnalytics Server site using the stopserver.sh command.
Check for any orphaned ArcGIS Server processes that are known to impede the upgrade process:
1. Use the command ps -ef | grep arcgis/server to identify any orphaned processes.
2. Look for any processes with paths beginning with <ArcGIS Server install location>/arcgis/server. For any of these processes, use the kill -9 command to terminate them.
3. Repeat this workflow for all machines in the GeoAnalytics Server site.
When you are sure no orphaned ArcGIS Server processes are still running, follow steps 1 through 5 of the previous section to upgrade the primary machine in your GeoAnalytics Server site.
Repeat these steps for each machine in the site.
When all machines have been upgraded, run stopserver.sh again to stop the ArcGIS Server service on all machines. Wait at least five minutes to allow the system to make necessary adjustments.
After at least five minutes have elapsed, run the startserver.sh command utility to restart the ArcGIS Server service on all machines in your site. Again, wait at least five minutes after running the operation.
Use the Compute Platform Health Check operation in the ArcGIS Server Administrator Directory to verify your GeoAnalytics Server site is ready to use.

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.6.1 and have existing map, feature, or image services that access a database using a database user, you need to run the externalizeconnectionstrings.sh command utility to update the services if you want the ability to update passwords.

Note:

Although the externalizeconnectionstrings.sh 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.

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.
If any registered database connections are invalid, fix the connection.
Log in to one of the ArcGIS Server machines as the ArcGIS Server installation owner.
Open a command shell and change the directory to <ArcGIS Server installation>/tools/externalizeconnectionstrings.
Run externalizeconnectionstrings.sh. For example
```
/usr/arcgis/tools/externalizeconnectionstrings>./externalizeconnectionstrings.sh
```
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.

Scan for security best practices

Esri recommends using the serverScan.py script to check for security best practices with your ArcGIS Server after installation.

Feedback on this topic?

Note:

Caution:

Prepare to upgrade ArcGIS Server

Upgrade ArcGIS Server

Tip:

Note:

Note:

Caution:

Upgrade ArcGIS GeoAnalytics Server

Update services to allow password changes

Note:

Scan for security best practices

In this topic