Skip To Content

Upgrade ArcGIS Data Store

ArcGIS Data Store is registered with the GIS Server site that is set as the hosting server for an ArcGIS Enterprise deployment. You must upgrade all components of this deployment to the same version.

Prepare to upgrade ArcGIS Data Store

Carefully review the following information and complete any required actions before you upgrade ArcGIS Data Store:

  • Read the ArcGIS Data Store 11.3 system requirements to ensure your hardware meets current requirements.
  • Read What's new in ArcGIS Data Store 11.3 for information about changes in support and functionality.
  • Upgrading directly to ArcGIS Data Store 11.3 from version 10.6.1 or earlier is not supported. To upgrade ArcGIS Data Store 10.6.1 or earlier, first upgrade to an interim version (10.7.x –10.9.1) then upgrade that version to 11.3. Read the upgrade documentation for the interim version to confirm direct upgrades are supported for the ArcGIS Data Store version you start with.
  • Before upgrading a relational data store or tile cache data store, check the size of the ArcGIS Data Store directory on each machine. Ensure that the machine contains enough free disk space to accommodate double the size of the ArcGIS Data Store directory.
  • Before upgrading a relational data store, ensure that port 50432 is free on each relational data store machine.
  • If you have a tile cache data store that is running in primary-standby mode, ensure the standby machine has access to the default backup location before you upgrade. If it does not, there will be no default backup location for your tile cache data store after you upgrade, and you will have to configure one.
  • If you have a tile cache data store that contains more than one machine and you are upgrading from 10.7.x, 10.8.x, or 10.9, you must also open ports 29079–29090 and 4369 in the firewall.
  • If you upgrade an ArcGIS Data Store 10.9 object store to 11.3, you must open ports 29878 (HTTP) and 29879 (HTTPS) on the object store machines to allow the hosting server to communicate with the object store. At 10.9, port 9900 was used. This port is no longer required. You must also open ports 9880 (HTTP) and ports 9820, 9830, and 9840 (TCP) for communication between object store machines if the object store is deployed in cluster mode.
  • The following ports must be available on the relational data store machines before you upgrade: 25672, 44369, 45671, and 45672. The first two must be available, the second two must be open for communication with the hosting server or other federated ArcGIS GIS Server sites. If you do not open these ports, you cannot create service webhooks in the ArcGIS Enterprise deployment.
  • If you're upgrading a 10.8.1 spatiotemporal big data store, check to see whether the ArcGIS Enterprise deployment contains ArcGIS GeoEvent Server map services that use a square or hexagon aggregation. If it does, you must complete additional steps after upgrading the spatiotemporal big data store to correct a rendering issue.
  • ArcGIS Data Store 11.3 object stores deployed in cluster mode must contain an odd number of machines. When you upgrade a clustered 10.9 object store to 11.3, you may need to add a machine to the object store after you upgrade.
  • Create a backup of all data stores in the deployment, and store the backup files 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. Also download 11.3 authorization files for Portal for ArcGIS and ArcGIS Server from My Esri.

    All components of a base ArcGIS Enterprise deployment must be the same software version.

  • ArcGIS Data Store is always used as part of an ArcGIS Enterprise deployment, and you must upgrade certain components of the deployment before you upgrade ArcGIS Data Store. Read the next section and upgrade the required ArcGIS Enterprise components before you upgrade ArcGIS Data Store.

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).
  3. Upgrade the ArcGIS Server site serving as the portal's hosting server.
  4. Upgrade ArcGIS Web Adaptor (for ArcGIS Server).
  5. Upgrade ArcGIS Data Store.
  6. If your ArcGIS Enterprise deployment includes them, upgrade federated servers.

    Most federated servers must match the version of the base ArcGIS Enterprise deployment. For information on 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 ArcGIS Data Store

Once you have your installation files and backup files and have upgraded the hosting server, complete the upgrade steps for each type of data store. All data stores registered to the same ArcGIS Server site must run the same ArcGIS Data Store release. Keep the following in mind when upgrading ArcGIS Data Store:

  • Always install ArcGIS Data Store on all machines in a data store before reconfiguring the data store.
  • Do not uninstall ArcGIS Data Store before installing the new version.

    Running the 11.3 ArcGIS Data Store setup will automatically upgrade your ArcGIS Data Store 10.7 or later deployment to 11.3. There is no need to obtain and install each previously released version in sequence.

  • If you have primary and standby machines in your relational or tile cache data store, install the new version of ArcGIS Data Store on the primary and standby machines, then reconfigure the data store from either machine.
  • If you have multiple tile cache data store, spatiotemporal big data store, or object store machines configured with the hosting server site, install the new version of ArcGIS Data Store on every data store machine in the cluster. Once the new version is installed on all machines in the cluster, you can reconfigure the data store.

After you complete the steps outlined in Prepare to upgrade ArcGIS Data Store and have upgraded the ArcGIS Enterprise components that must be upgraded before ArcGIS Data Store, follow these steps to upgrade your data stores:

  1. If you are using a spatiotemporal big data store with ArcGIS GeoEvent Server, sign in to ArcGIS GeoEvent Server Manager and stop the feature services used to archive data.
  2. Update the ArcGIS Data Store installation on every data store machine.

    To update the installation, run the latest ArcGIS Data Store 11.3 setup script from the command prompt as the same user who installed ArcGIS Data Store the first time. Do not uninstall the existing installation.

    When you install ArcGIS Data Store to upgrade from 10.9.1 or earlier, all data store types—relational, tile cache, object, graph, and spatiotemporal big data store—are installed.

    To run the command, change to the ROOT or untar directory and run /Setup.

    To run the setup script from the ArcGIS Data Store 11.3 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 stops it for you.

    The setup detects your existing version of ArcGIS Data Store on the target machine and prompts you to continue or exit the upgrade. See the following example:

    =========================================================================
    ArcGIS Data Store 11.3 (Linux)
    =========================================================================
    
    Your ArcGIS Data Store 10.9.1 is installed at:
    
    /home/ags/arcgis/datastore
    
    Confirm Settings
    =========================================================================
    Product to upgrade:             ArcGIS Data Store 10.9.1 (Linux)
    Location to upgrade:            /home/ags/arcgis/datastore/usr/arcgisdatastore
    
    Your ArcGIS Data Store 10.9.1 will be stopped when performing the upgrade 
    and ArcGIS Data Store 11.3 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):

    Tip:

    To avoid being prompted for confirmation, run /Setup -l yes -m silent instead of /Setup.

  3. Type y and press Enter to accept the detected settings and continue with the update.

    Note:

    Wait while the ArcGIS Data Store installation on this machine is updated to 11.3. This may take several minutes.

  4. After you install the new release of ArcGIS Data Store on the first machine in the data store, install the same release of ArcGIS Data Store on all other data store machines that are configured with the same GIS Server site. For example, if you have a highly available relational data store (two machines) and a highly available spatiotemporal big data store that includes three machines, repeat the installation steps on the remaining machines before proceeding with the next step.
  5. After all ArcGIS Data Store installations are updated to the latest release, use the configuredatastore utility to reconfigure each data store type with the hosting GIS Server site.

    How many times you run the configuredatastore utility depends on your configuration.

    • For data stores running in primary-standby mode, sign in to either the primary or standby machine as the user who installed ArcGIS Data Store and run the configuredatastore utility. This upgrades the data store on both the primary and standby machines.
    • When different types of data stores are on the same machine, you can specify the ones to upgrade using the --stores parameter when you run the configuredatastore utility.
    • For data stores running in cluster mode, sign in to any of the machines as the user who installed ArcGIS Data Store and run the configuredatastore utility. This upgrades all machines in the clustered data store.

    In this example, the configuredatastore utility is run on a machine where both the relational and tile cache data stores are running. Both data stores are configured with the GIS 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

    In this example, the configuredatastore utility is run on one of the machines in a spatiotemporal big data store that is configured with the GIS Server site https://gisserver.mynetwork.com:6443/arcgis:

    ./configuredatastore.sh https://gisserver.mynetwork.com:6443/arcgis serveradmin MyAdminPassword /home/ags/arcgis/datastore/usr/arcgisdatastore --stores spatiotemporal

    Running the configuredatastore utility restarts ArcGIS Data Store on all machines in the data store.

    Before upgrading, ArcGIS Data Store confirms that all machines in the data store have the same version of ArcGIS Data Store installed and all machines are accessible. If any machines are not updated or accessible, ArcGIS Data Store cannot proceed with the upgrade. Correct the installation or network problems and run the configuredatastore utility again.

  6. If you have a spatiotemporal big data store, confirm the spatiotemporal big data store shows a status of healthy.

    To determine a data store's status, sign in to the ArcGIS Server Administrator Directory for the hosting server and run the validate REST command.

  7. If the ArcGIS Enterprise portal has federated ArcGIS GeoEvent Server, ArcGIS GeoAnalytics Server, ArcGIS Mission Server, or ArcGIS Knowledge Server sites, upgrade these sites.

    After the federated sites are upgraded, confirm that the services running on the sites are functional.

Considerations after upgrading ArcGIS Data Store

After upgrading, 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.

Instructions for validating your data stores and confirming that layers are running from ArcGIS Server Manager are provided below.

After you confirm the upgrade is valid, create full backups of all data stores. This provides you with a usable full backup in case anything happens before your next scheduled backup.

The last section below includes steps you must complete after upgrading a spatiotemporal big data store from 10.8.1 if the ArcGIS Enterprise deployment includes ArcGIS GeoEvent Server map services that use square or hexagon aggregations.

After you confirm that the upgrade was successful and, if necessary, complete the postupgrade steps for the spatiotemporal big data store, you can run the diskcleanup utility to remove temporary files that are no longer necessary.

Validate data stores

You can sign in to ArcGIS Server Manager to validate that your GIS Server site can still communicate with each of your data stores.

Follow these steps to validate a data store from ArcGIS Server Manager:

  1. Sign in to ArcGIS Server Manager.
  2. Go to Site > Data Stores.
  3. Check the box next to the data store you want to validate. (ArcGIS_Data_Store).
  4. Click Validate.

If the data store is running and the GIS Server site can communicate with it, a green check mark appears in the Status column.

Confirm layers work

You should also ensure your services are still working after you upgrade.

  1. Sign in to ArcGIS Server Manager.
  2. Go to Services > Hosted.
  3. Check to see that all services are running.

Correct ArcGIS GeoEvent Server map service rendering issues

To correct rendering issues caused by BUG-000139639, you must run the upgradedatasource utility on the spatiotemporal big data store after upgrading it from 10.8.1 if you have ArcGIS GeoEvent Server map services that are configured to use square or hexagon aggregation.

  1. From a command line window, open the ArcGIS Data Store tools directory on any machine in the spatiotemporal big data store.
  2. Run the listdatasources utility to list the GeoEvent Server map services.

    ./listdatasources

  3. Run the upgradedatasource utility.

    No one can access the map services while their sources are being upgraded. You can specify the name of a map service when you run the upgradedatasource utility so only one service at a time is affected. Or, you can run the upgradedatasource utility without any names and all services will be upgraded. That means, though, no one can access any of the services until all are upgraded.

    In this example, all GeoEvent Server map services are upgraded:

    ./upgradedatasource

    In this example, only one service—deliveryroutes—is upgraded.

    ./upgradedatasource deliveryroutes

After completing these steps, validate the spatiotemporal big data store. Optionally, use the backupdatastore utility to create a backup of the updated spatiotemporal big data store.