Skip To Content

Install ArcGIS Data Store

You can use an installation wizard or a command to install ArcGIS Data Store.

Esri recommends that each type of data store run on a different machine, and that your ArcGIS Server sites run on separate machines than your data stores so they don't compete for memory and other resources. This is especially important for spatiotemporal big data stores; you should always install those on their own machine separate from any ArcGIS Server sites and other data stores.

Install ArcGIS Data Store

Run the ArcGIS Data Store installation wizard, or run the installation from a command prompt.

Verify that your computer meets the minimum system requirements for ArcGIS Data Store, and then follow the instructions in the appropriate section for the method you want to use for installation.

Run the installation wizard

Run the ArcGIS Data Store installation wizard for an interactive installation experience.

  1. Log in to your machine as a user with administrative privileges. You cannot install ArcGIS Data Store as a root user.
  2. Run the setup program from the ArcGIS Data Store download folder or setup media. The setup program begins by checking the prerequisites that must be met to successfully set up and use ArcGIS Data Store. If your system does not meet any of the prerequisites, follow the instructions in the dialog box to correct any issues.
  3. If all prerequisites are met, the Introduction dialog box displays. Click Next to proceed.
  4. On the Master Agreement dialog box, read the license agreement. If you accept the terms, click the I accept the master agreement button and click Next to proceed; otherwise, exit the setup by clicking Cancel.
  5. On the Choose Install Folder dialog box, specify the installation location. Click Next to continue.
  6. Review the summary information and click Install to begin the installation.
  7. When completed, click Done to exit the wizard.

Follow postinstallation instructions to configure ArcGIS Data Store to start with the operating system.

Run from terminal

Follow these steps to install ArcGIS Data Store from a command prompt:

  1. Log in to your machine as a user with administrative privileges. You cannot install ArcGIS Data Store as a root user.
  2. Before beginning the installation, read the license agreement located at <CD_ROOT or untar directory>/Documentation/EULA.pdf and accept the terms.
  3. Run the setup silently at the prompt. See sample syntax below:

    <CD_ROOT or untar directory>/Setup -m silent -l yes

    Command line options:

    OptionsDescriptions

    -m; --mode MODE

    Optional. Defaults to GUI.

    MODE is one of the following: silent or gui.

    -l; --license-agreement CHOICE

    Required for silent mode. CHOICE can be Yes or No. Yes indicates that you have read and agreed to the Esri Master Agreement (E204, E300). Read the agreement at https://www.esri.com/legal/licensing-translations.

    -d; --directory DIRECTORY

    Optional. By default, ArcGIS Data Store will be installed in the user's $HOME directory. DIRECTORY specifies a different installation directory.

    The path /arcgis/datastore will be appended to the installation directory.

    -v; --verbose

    Installer runs in verbose mode.

    -h; --help

    Displays command line help and exits.

    -e; --examples

    Displays usage examples of these options and exits.

Follow postinstallation instructions to configure ArcGIS Data Store to start with the operating system.

Postinstallation configuration

If you want ArcGIS Data Store to start with the operating system, complete the steps specific to your operating system.

Operating systems that support systemd

If your operating system supports the use of systemd to bootstrap and manage processes (for example, if you are using Red Hat Enterprise Linux (RHEL) Server 7.x), follow these steps to configure ArcGIS Data Store to start with the operating system.

  1. Within a command shell, switch to root user.
  2. Copy <ArcGIS Data Store installation directory>/framework/etc/scripts/arcgisdatastore.service to /etc/systemd/system. Update the permissions of the /etc/systemd/system/arcgisdatastore.service from 700 to 600

    By default, the arcgisdatastore.service file is configured to use with the relational and tile cache data stores. If you configure a spatiotemporal big data store instead, edit the arcgisdatastore.service file, add comment marks (#) to the relational and tile cache data store parameters and remove the comment marks from the spatiotemporal big data store parameters as shown here:

    # Configuration for relational and tile cache data stores
    # LimitNOFILE=65535
    # LimitNPROC=25059
    # Configuration for spatiotemporal big data store
    LimitNOFILE=65536
    LimitNPROC=25059
    LimitAS=infinity
    LimitFSIZE=infinity

  3. Still as the root user, run the following command to automatically create the links in /etc/systemd/system/multi-user.target.wants:
    $ systemctl enable arcgisdatastore.service
  4. To verify that the systemd service is properly configured, restart the service and check its status.
    $ systemctl stop arcgisdatastore.service
    $ systemctl start arcgisdatastore.service
    $ systemctl status arcgisdatastore.service
  5. End the root user session.
  6. Reboot the operating system and verify that ArcGIS Data Store restarts properly.
Note:

If you install ArcGIS Data Store on a Linux machine that includes systemd v228 or a later version, you may need to enable and raise the systemd limit to 512 maximum threads if the data store machine is heavily used. (For example, SUSE Linux Enterprise Server (SLES) 12 SP2 includes systemd v228.) Setting systemd to a maximum of 512 threads can prevent any single service from spawning too many threads and consuming all server resources.

To enable and raise the limit, as the root user, uncomment and edit the following line in the arcgisdatastore.service unit file before deploying it to the /etc/systemd/system directory:

# TasksMax=512

Operating systems that support SysV

If your operating system supports the use of SysV to bootstrap and manage processes, follow these steps to configure ArcGIS Data Store to start with the operating system.

  1. Within a command shell, switch to root user.
  2. Copy the <ArcGIS Data Store installation directory>/framework/etc/scripts/arcgisdatastore shell script to the appropriate supported Linux distribution-based locations provided below:
    • RHEL Server: /etc/rc.d/init.d/
    • SLES: /etc/init.d/
  3. Change the directory to the applicable init.d folder and check the arcgisdatastore script to make sure that root has at least read and execute permissions.
  4. Edit the arcgisdatastore script as follows:
    1. Update the datastorehome variable to the ArcGIS Data Store installation directory, for example, /home/username/arcgis/datastore.
    2. For RHEL Server only, add the following line just before # Description: ArcGIS Data Store Service:

      # chkconfig: 35 99 01

    3. Save the edits to the arcgisdatastore script.
  5. Still as root user, run the following command to automatically create the links in /etc/rc*.d with the appropriate run levels:
    • RHEL Server:
      $ chkconfig --add arcgisdatastore
      $ chkconfig arcgisdatastore on
    • SLES:
      $ insserv arcgisdatastore
      $ chkconfig arcgisdatastore on
  6. End the root user session.
  7. Reboot the operating system and verify that ArcGIS Data Store restarts properly.

Next step

After you install ArcGIS Data Store, you can create a data store.