ArcGIS Data Store is registered with a GIS Server site, which you set as a Portal for ArcGIS hosting server. You must upgrade all components of this system to the same version.
Note:
Be aware that you must upgrade ArcGIS Server on your hosting server before you upgrade ArcGIS Data Store. If you have a spatiotemporal big data store to which a federated ArcGIS GeoEvent Server site is writing data, you must also upgrade the ArcGIS GeoEvent Server site before upgrading ArcGIS Data Store.
Considerations before upgrading ArcGIS Data Store
Before upgrading, carefully review the following information:
Can I upgrade directly to ArcGIS Data Store 10.5.1?
Yes; you can upgrade to ArcGIS Data Store 10.5.1 directly from any previous version of ArcGIS Data Store. You do not have to upgrade to any intermediate version first.
Do I need to uninstall ArcGIS Data Store before installing a new version?
No; the upgrade procedure updates the ArcGIS Data Store installation for you. If you uninstalled the software before reading the upgrade instructions, your upgrade will still work. However, you'll have to install the new version of ArcGIS Data Store yourself.
Is there a specific order in which I must upgrade the software in my deployment?
Yes; you must upgrade ArcGIS Server before you upgrade ArcGIS Data Store. The ArcGIS Server, ArcGIS Data Store, and Portal for ArcGIS installations used in your deployment must be at the same release.
Is there a specific order in which I must upgrade my ArcGIS Data Store machines?
The order in which you upgrade data store types does not matter, but the order in which you upgrade each machine in a highly available data store does matter. When upgrading a highly available relational or tile cache data store, you must upgrade the primary machine before you upgrade the standby machine.
If your spatiotemporal big data store contains more than one machine, stop all but one of the spatiotemporal big data store machines. Upgrade the machine that is still running. Start each additional machine, one at a time, and upgrade it until all machines in the spatiotemporal big data store have been upgraded.
Note:
Do not run GeoAnalytics Tools that create hosted feature layers and do not create a new archiving service for ArcGIS GeoEvent Server until you finish upgrading all machines in the spatiotemporal big data store. To ensure no one runs the GeoAnalytics Tools while the spatiotemporal big data store is being upgraded, you can log in to ArcGIS Server Manager as the ArcGIS Server administrator and stop the GeoAnalyticsTools system service.
How long does it take to upgrade ArcGIS Data Store?
It depends on how many different types of data stores you have and how much data is in each.
Do I need to create a backup of ArcGIS Data Store before upgrading?
Yes; create a backup of each type of data store in your deployment before you upgrade the ArcGIS Data Store installation.
Steps to upgrade ArcGIS Data Store
Before you can upgrade ArcGIS Data Store, you must download the installation files for the ArcGIS Data Store release to which you want to upgrade, make a backup of your data store, and upgrade ArcGIS Server. If you are using a spatiotemporal big data store to archive high-volume data, you must also upgrade your ArcGIS GeoEvent Server installation.
Complete the upgrade steps for each ArcGIS Data Store installation. All data stores registered to the same ArcGIS Server site must run the same ArcGIS Data Store release. This means you complete the upgrade steps on separate machines for the following scenarios:
- If each type of data store is running on a separate machine, upgrade each data store individually. For example, if you have a relational data store on machine 1 and a spatiotemporal big data store on machine 2, complete the upgrade steps for each data store separately.
Tip:
Prior to the 10.5 release of ArcGIS Data Store, both a relational and tile cache data store were created when you configured a data store. However, if no one in your organization ever published a hosted scene layer to the portal, the tile cache data store is not configured and you do not have to upgrade it if you do not intend to use it after upgrading or you want to configure a tile cache data store on a separate machine than the relational data store.
- If you have primary and standby machines in your relational or tile cache data store, complete the steps to upgrade and reconfigure the primary machine first. Be sure to then upgrade and reconfigure the standby machine.
- If you have multiple spatiotemporal big data stores configured with your ArcGIS Server site, you must upgrade and reconfigure each spatiotemporal big data store machine individually.
- Run the backupdatastore utility to create a full backup or snapshot of the data store. Be sure your backup files are stored in a remote, secure location.
- Download the latest ArcGIS Data Store, Portal for ArcGIS, ArcGIS Server, and ArcGIS Web Adaptor software installation files from My Esri.
- You must upgrade ArcGIS Server and its web adaptor before upgrading ArcGIS Data Store. See Upgrade ArcGIS Server in the ArcGIS Server installation guide for instructions. If you have ArcGIS GeoEvent Server on one of your federated servers, upgrade it as well.
Tip:
You can upgrade Portal for ArcGIS before or after upgrading ArcGIS Server and ArcGIS Data Store, just be sure all components of your web GIS are upgraded to the same release before you begin using it.
- From the command prompt, launch the latest ArcGIS 10.5.1 Data Store setup script as the same user used to install the existing earlier version, for example, <CD ROOT or untar directory>/Setup.
Tip:
To launch the setup script from the ArcGIS 10.5.1 Data Store setup media, click the setup script, and click Run in Terminal.
Note:
You do not have to stop the ArcGIS Data Store service manually to upgrade; the setup script will stop it for you.
- The setup will detect your existing earlier version of ArcGIS Data Store on the target machine and prompt you to continue or exit the upgrade. For example
========================================================================= ArcGIS 10.5.1 Data Store (Linux) ========================================================================= Your ArcGIS 10.3 Data Store is installed at: /home/ags/arcgis/datastore Confirm Settings ========================================================================= Product to upgrade: ArcGIS 10.3 Data Store (Linux) Location to upgrade: /home/ags/arcgis/datastore/usr/arcgisdatastore Your ArcGIS 10.3 Data Store will be stopped when performing the upgrade and ArcGIS 10.5.1 Data Store 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 Data Store is upgraded to 10.5.1. This may take several minutes.
- Use the configuredatastore command utility to reconfigure the data store with its ArcGIS Server site. You must run the command prompt on the machine where ArcGIS Data Store is installed, and run it as the user who installed ArcGIS Data Store.
In this example, the primary relational and tile cache data stores are reconfigured with ArcGIS Server site https://myserver.network.com:6443/arcgis:
./configuredatastore.sh https://myserver.network.com:6443/arcgis serveradmin MyAdminPassword /home/ags/arcgis/datastore/usr/arcgisdatastore --stores relational,tilecache
- Once you have upgraded and reconfigured the primary relational or tile cache data store or the first spatiotemporal big data store, repeat steps 4 through 7 for the standby relational or tile cache data store or all additional spatiotemporal big data stores.
- Upgrading any individual machine in a spatiotemporal big data store stops ArcGIS Data Store on all spatiotemporal big data store machines. Therefore, after you upgrade all machines in a spatiotemporal big data store, you must manually start ArcGIS Data Store on each spatiotemporal big data store machine.
- If you have more than one type of data store configured with the same ArcGIS Server site, and the data stores are running on different machines, repeat step 1 and steps 4 through 8 for each type of data store.
Considerations after upgrading ArcGIS Data Store
After upgrading, you should confirm that your data stores are accessible. You can do this from ArcGIS Server Manager or the ArcGIS Server Administrator Directory. Also confirm that your hosted feature and scene layers still work.
Validate data stores
You can sign in to ArcGIS Server Manager to validate that your GIS Server site can still communicate with your relational data store. You cannot validate tile cache or spatiotemporal big data stores from ArcGIS Server Manager.
Follow these steps to validate a relational data store from ArcGIS Server Manager:
- Sign in to ArcGIS Server Manager.
- Go to Site > Data Stores.
- Check the box next to your relational data store (ArcGIS_Data_Store).
- Click Validate.
If the data store is running and the GIS Server site can communicate with it, a green check box appears in the Status column.
To validate a tile cache or spatiotemporal big data store after upgrade, log in to the ArcGIS Server Administrator Directory (URL format is https://gisserver.domain.com:6443/arcgis/admin) and use validate command.
Tip:
You can also validate relational data stores from the ArcGIS Server Administrator Directory, so if your site has multiple types of data stores running, validate all of them from the ArcGIS Server Administrator Directory.
Confirm layers work
You should also be sure your services are still working after you upgrade.
- Sign in to ArcGIS Server Manager.
- Go to Services > Hosted.
- Check to see that all services are running.