The ArcGIS 10.4.1 for Server setup package is capable of upgrading 10.1 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.
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, such as IBM DB2 database requirements, for details.
When using ArcGIS Server with ArcGIS Data Store, ensure that you upgrade ArcGIS Server before upgrading ArcGIS Data Store.
For steps on how to back up your 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 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.
Single machine site
If you have a single machine ArcGIS Server site, follow the steps below to upgrade the GIS server to version 10.4.1.
Multiple machine site
If you have a multiple machine ArcGIS Server site, you'll need to upgrade each GIS server in the site to version 10.4.1. It's recommended that you upgrade each GIS server sequentially; that is, wait until the first GIS server is upgraded before applying the upgrade on the next GIS server. Each GIS server in the site must be at the same version number and be licensed exactly the same. Repeat the steps below to upgrade each GIS server to version 10.4.1.
Upgrade ArcGIS for Server
From the command prompt, launch the ArcGIS 10.4.1 for Server 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 10.4.1 for Server setup media, click the setup script, and select the Run in Terminal button.
The setup will detect your existing earlier version of ArcGIS for Server on the target machine and prompt you to continue or exit the upgrade. For example:
========================================================================= ArcGIS 10.4.1 for Server (Linux) ========================================================================= Your ArcGIS 10.3 for Server is installed at: /home/ags/arcgis/server Confirm Settings ========================================================================= Product to upgrade: ArcGIS 10.3 for Server (Linux) Location to upgrade: /home/ags/arcgis/server Your ArcGIS 10.3 for Server will be stopped when performing the upgrade and ArcGIS 10.4.1 for Server 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 for Server is upgraded to 10.4.1. This may take several minutes.
After the installation completes, ArcGIS Server Manager will automatically open. It is not necessary to reauthorize ArcGIS Server or configure ArcGIS Server Manager.
If you have a multiple machine ArcGIS Server site, repeat the steps above on the remaining GIS servers in your site.
If you configured ArcGIS Web Adaptor to work with your site, you'll need to install 10.4.1 as well. For instructions, see the following applicable Web Adaptor:
- Installing ArcGIS 10.4.1 Web Adaptor (IIS)
- Installing ArcGIS 10.4.1 Web Adaptor (Java Platform) on Windows
- Installing ArcGIS 10.4.1 Web Adaptor (Java Platform) on Linux
If you want the ability to update passwords in registered and managed database connections used by existing services, run the ExternalizeConnectionStrings.so command utility as described in the next section.
Update services to allow password changes
GIS services use the credentials of the GIS 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 10.3.1 for Server or an older release to 10.4.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 GIS 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.shThis will return a list of all services running on the ArcGIS Server site, with messages indicating whether the connection was updated for the service.