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.
Do I need to set permissions on the ArcGIS Data Store content directory?
If you upgrade from 10.3 or 10.3.1, you need to grant the full control on your ArcGIS Data Store content directory to the ArcGIS Data Store account.
If you upgrade from 10.4 or later, the privileges are already set.
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.
- 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.
You can upgrade using an interactive wizard-driven experience by launching the Setup.exe program, or run Setup.exe and the configuredatastore utility from a command prompt or script to silently upgrade ArcGIS Data Store. No matter which method you use, the Setup.exe installation file detects and upgrades an existing installation of ArcGIS Data Store.
Note:
Upgrading ArcGIS Data Store restarts the ArcGIS Data Store service.
Upgrade using an interactive wizard-driven experience
- Run the backupdatastore utility to create a full backup or snapshot of each of your data stores. 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 on your hosting server before upgrading ArcGIS Data Store. See Upgrade ArcGIS Server in the ArcGIS Server installation guide for instructions. If you have a federated ArcGIS GeoEvent Server, 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.
- Once ArcGIS Server and its web adaptor are upgraded, double-click Setup.exe to launch the ArcGIS Data Store setup program.
- During the installation, read the license agreement and accept it, or exit if you do not agree with the terms.
- If you accept the license agreement, the ArcGIS Data Store setup program displays the features that will be installed.
- The
account used by your existing installation is prepopulated in the
ArcGIS Data Store input box.
Provide the password for the account. Typically, this
is the password you defined when installing the software. If the
password has changed since you installed the software, you need to
provide the password you designated when modifying the account.
If the password
is not validated successfully, an error message is displayed
indicating the password is invalid. If you are unsure of the
password for the account, contact your system
administrator.
Note:
Earlier versions of ArcGIS Data Store used the Local System account to create the ArcGIS Data Store service. At version 10.4 and later, you specify a local user or domain user account to start the ArcGIS Data Store service. If you are upgrading from ArcGIS Data Store 10.3 or 10.3.1, you must manually provide this account full control to your ArcGIS Data Store content directory (the default location is C:\arcgisdatastore).
- To complete the installation, follow the directions on the screen.
When the installation wizard completes, it automatically opens the Data Store Configuration wizard in your default browser. You must reconfigure each data store with the same GIS Server site you were using before upgrading to complete the ArcGIS Data Store upgrade process.
- In the Data Store Configuration wizard, provide the user name and password of an ArcGIS Server administrator and click Next.
- Confirm the location of the content directory is correct and click Next.
A list is displayed showing the data stores on this machine that can be upgraded. In most cases, you will only have one data store per machine.
- Leave the data store types checked and click Next.
- Confirm the information on the Upgrade Summary page is correct. If it is, click Finish to upgrade. If it is not correct, click Back to correct the information before proceeding with the upgrade process.
- 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 12 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 GIS Server site, and the data stores are running on different machines, repeat step 1 and steps 4 through 13 for each type of data store.
When the hosting server, federated servers, portal, and all ArcGIS Data Store machines are upgraded to the latest release, your existing hosted web layers are available for use, and you can publish new hosted feature and scene layers, and archive high-volume observation data from GeoEvent Server.
Silently upgrade using commands
Rather than run the setup program, you can run the Setup.exe file at a command prompt or in a batch script.
- Run the backupdatastore utility to create a full backup or snapshot of each of your data stores. 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.
- Once ArcGIS Server and its web adaptor on your hosting server are upgraded, run the Setup.exe from a command prompt or in a script.
When silently upgrading using Setup.exe, you must specify the ArcGIS Data Store account. Typically, this is the account you defined when installing the software. If the account has changed since you installed, you need to provide the user name and password you designated when modifying the ArcGIS Data Storeaccount.
Earlier versions of ArcGIS Data Store used the Local System account to create the ArcGIS Data Store service. At version 10.4 and later, you specify a local user or domain user account to start the ArcGIS Data Store service. If you are upgrading from ArcGIS Data Store 10.3 or 10.3.1, you must manually provide this account full control to your ArcGIS Data Store content directory (the default location is C:\arcgisdatastore).
If you do not specify the ArcGIS Data Store account, or it does not match the account used by your current installation, the installation process displays a message indicating the credentials could not be validated. As a result, the installation will exit.
In the following example, the account used by the software is myaccount:
<path to ArcGIS Data Store setup download folder>\Setup.exe /qb USER_NAME=myaccount PASSWORD=mypassword
For example, to run the command with a domain account, such as mydomain\myaccount, with the password 4myI.s0nly, type the following:
\\machinename\mydownloadfolder\Setup.exe /qb USER_NAME=mydomain\myaccount PASSWORD=4myI.s0nly
Caution:
Command line parameters are case sensitive. If you are having trouble upgrading, confirm the case matches the properties as shown in the examples.
- Use the configuredatastore command utility to reconfigure the data store with the same ArcGIS Server site you were using before upgrading. You must run the command prompt as an administrator on the machine where ArcGIS Data Store is installed.
In this example, the primary relational and tile cache data stores are reconfigured with GIS Server site https://myserver.network.com:6443/arcgis:
configuredatastore https://myserver.network.com:6443/arcgis serveradmin MyAdminPassword C:\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 and 5 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.
When the hosting server, federated servers, portal, and all ArcGIS Data Store machines are upgraded to the latest release, your existing hosted web layers are available for use, and you can publish new hosted feature and scene layers, and archive high-volume observation data from GeoEvent Server.
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.