Installing and configuring GeoEnrichment Server

Available with Business Analyst license.

Business Analyst Enterprise requires two ArcGIS Server machines.

  1. A complete base deployment with all software components is required, see installation overview for details.
  2. A dedicated ArcGIS Server machine is needed to install GeoEnrichment Server. This machine must meet the following guidelines:
    • ArcGIS Server and ArcGIS Web Adaptor installations. The server must be federated to your Enterprise portal.
    • The GeoEnrichment server setup requires a Microsoft Windows operating system.
    • The GeoEnrichment server setup cannot be installed on the same machine as the ArcGIS Data Store.
    • The GeoEnrichment server cannot be designated as the hosting server.

Download the setup

  1. On the My Esri site, click My Organizations then click Downloads.
  2. Verify that you are in the Products section. In the Quick Search text box, enter Business Analyst or Business.
  3. Look for ArcGIS Business Analyst Enterprise with 2023 U.S. Data and ensure the version is the latest one available. Click View Downloads.
  4. Click the Download Components tab then click Product Components to expand the list of files.
  5. There will be a setup for ArcGIS GeoEnrichment Server. Click Download.

    The Esri Download Manager dialog is launched.

  6. Click Click to download your file now.
  7. The Destination Folder for Files dialog will appear. Keep the default location or click Browse to choose a different location.

Run the setup

Browse to the location of the downloaded setup file and run the GeoEnrichment Server setup.

  1. Double-click setup.exe to run the GeoEnrichment Server install application.
  2. The GeoEnrichment Server welcome page is launched. Click Next.
  3. Review and accept the Esri Master Agreement. Click Next.
  4. Accept the default destination folder for the GeoEnrichment software to be installed or browse to a different location. Click Next.
  5. Enter the credentials for the ArcGIS Server primary account. Click Next.

    The primary account runs the ArcGIS Enterprise and ArcGIS Server processes and needs to be created when ArcGIS Server is installed. You may specify to use a configuration file from a previous install.

  6. Specify whether or not to export a configuration file based on this install. Click Next.

    Tip:
    Exporting an account configuration file helps with installing multiple systems.

  7. The GeoEnrichment Server software is ready to install. Click Install.
  8. GeoEnrichment Server will install on your machine. Once the install is complete, click Next.
  9. Once GeoEnrichment Server has been successfully installed, click Finish to close the GeoEnrichment Server install application.

GeoEnrichment environment configuration utility

After installing the GeoEnrichment Server software, an environment configuration utility is provided to perform several administrative tasks. These tasks include preparing the database and services, creating and sharing items in the portal, optimizing ArcGIS Server memory settings, and registering GeoEnrichment as a utility service in the portal.

  1. In the Start menu, search for GeoEnrichment and click on GeoEnrichment Environment Configuration Utility.

    Note:

    It may be necessary to agree to proceed through the User Account Control prompt.

  2. In the welcome page for the GeoEnrichment Server configuration wizard, click Next to begin specifying the parameters necessary to configure your server environment.
  3. Enter the credentials for the portal administrator user and click Next.
  4. Specify a folder where you would like the GeoEnrichment data to be stored. Click Next.

    Note:
    The specified location should have at least 200GB of dedicated storage for staging and installing the USA data pack. For recommendations on disk space for other regions, see the international data options.

  5. Select Yes to register the GeoEnrichment service as a portal utility service. Click Configure.

    Choosing to register the GeoEnrichment service as a portal GeoEnrichment utility service will make the service the default selection for GeoEnrichment processes executed on the portal.

  6. As the GeoEnrichment Server environment is configured, a status bar and additional details are made available to track the progress. Once completed, click Next.
  7. The GeoEnrichment Server environment is successfully configured. Click Finish.

    You have the option to manage data using the GeoEnrichment Data Management Utility by checking the Run the data management tools to install data packs check box.

Install GeoEnrichment Server silently

GeoEnrichment Server can be installed silently using command line parameters as described below.

  1. Open a command shell as the user who will run GeoEnrichment Server. Browse to the directory where you downloaded the GeoEnrichment Server tar.gz file from My Esri.
  2. Run the setup silently at the prompt. Sample syntax: <path to the GeoEnrichment Server setup download>\setup.exe -m silent -l yes

    The parameters of the command line tool are as follows:

    OptionDescription

    -m; --mode MODE

    Optional. Defaults to GUI.

    MODE is one of silent or GUI.

    -v; --verbose

    Installer runs in verbose mode.

    -h; --help

    Display this help and exits.

    -e; --examples

    Displays usage examples of these options and exits.

    -l; --license-agreement CHOICE

    Required for silent mode. CHOICE is either Yes or No. Yes indicates that you have read and agreed to the Esri Master Agreement (E204, E300).

    Visit: https://www.esri.com/legal/licensing-translations to read the agreement.

    -d; --directory DIRECTORY

    Optional. By default, GeoEnrichment Server is installed to your $HOME directory. DIRECTORY specifies a different installation directory.

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

Configure GeoEnrichment Server silently

The instructions below describe how to configure GeoEnrichment Server silently from the command line.

  1. Open a command shell and browse to the directory where ArcGIS Server install is located.
  2. Run the setup silently at the prompt. Sample syntax:

    <ArcGIS Server Installation Directory>/tools/geoenrichment/manageEnvironment.bat create -b -u <user name> -p <password>

    The parameters of the command line tool are as follows:

    OptionDescription

    create

    Create environment

    repair

    Repair environment

    remove

    Remove environment

    upgrade

    Run environment upgrade (only in upgrading state)

    info

    Show environment configuration information

    -b; --batch-mode

    Run in non-interactive (batch) mode

    -d; --directory <directory>

    By default, the GeoEnrichment Data Store will be installed in the user's <ArcGIS GeoEnrichment Installation Directory>/data. The DIRECTORY specifies a different installation directory.

    -h; --help

    Show command line syntax help

    -l; --log

    Log File directory

    -nu; --no-utility-service

    Do not register GeoEnrichment as a portal utility service

    -p; --password <password>

    Portal administrator password

    -u; --username <username>

    Portal administrator username

    -y; --yes

    Automatically answer yes for all prompts

Next step

Installing Geoenrichment data packs