Available with Business Analyst license.
Business Analyst Enterprise requires the following two ArcGIS Server machines:
- A complete base deployment with all software components is required; see Introduction to installation and deployment for details.
- A dedicated ArcGIS Server machine is needed to install ArcGIS GeoEnrichment Server. This machine must meet the following requirements:
- For ArcGIS Server and ArcGIS Web Adaptor installations, the server must be federated to your ArcGIS Enterprise portal.
- The GeoEnrichment Server setup requires Linux.
- The GeoEnrichment Server setup cannot be installed on the same machine as ArcGIS Data Store.
- GeoEnrichment Server cannot be designated as the hosting server.
Download the setup
To download the setup, complete the following steps:
- On the My Esri site, click Downloads, select All Products and Versions, click All Versions, and search for Business Analyst.
- Look for ArcGIS Business Analyst Enterprise, ensure that the correct version is used, and click View Downloads.
- To view the details of the download components, expand the details.
- For ArcGIS GeoEnrichment Server, click Download.
The downloaded file appears in your computer's Downloads folder.
Run the setup
The instructions below describe how to install ArcGIS Server from the setup user interface. For instructions to install ArcGIS Server silently from the command line, see Silently install ArcGIS Server.
The setup program begins by checking the prerequisites that must be met to successfully set up and use GeoEnrichment Server. If all the prerequisites are met, the Introduction dialog box appears.
- Click Next to proceed.
The License Agreement dialog box appears.
- Read the license agreement, and if you accept the terms, click I accept the license agreement, and click Next.
The Choose Product Features dialog box appears.
- Optionally, install AI Model features, and click Next.
The AI Model feature for semantic search is not installed by default. Semantic search is an AI-enhanced smart search technology that provides improved search results. Installing this feature enables the Find related variables functionality in the data browser and the Include related POIs functionality in points of interest search.
After choosing whether to install AI Model features, the Choose Install Folder dialog box appears.
- Specify an installation location.
Note:
The name of the installation directory must be lowercase. - Click Install to start the installation.
- Once GeoEnrichment Server has been successfully installed, click Finish to close the GeoEnrichment Server installation application.
Run the 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.
The environment configuration wizard relies on the ArcGIS Enterprise portal's built-in identity store. The initial administrator account can be used for authentication, or any other built-in account with administrator privileges. If the wizard cannot discover the portal's administrative URL automatically, an additional page appears, allowing for the URL to be entered manually.
To run the GeoEnrichment environment configuration utility, complete the following steps:
- Start the GeoEnrichment Environment Configuration Utility.
- On the welcome page for the GeoEnrichment Server configuration wizard, click Next.
- Provide the credentials for the portal administrator user, and click Next.
- Specify a folder where you want the GeoEnrichment data to be stored, and click Next.
Note:
The specified location should have at least 200 GB of dedicated storage for staging and installing the USA data pack, and it's recommended that it be located on a solid-state drive (SSD) instead of a hard disk drive for faster and more reliable file transfers during data installation. For more information, see Disk space requirements. - Select Yes to register the GeoEnrichment Service as a portal utility service, and click Configure.
Registering the GeoEnrichment Service as a portal GeoEnrichment utility service will make the service the default selection for GeoEnrichment processes run on the portal.
- Once the configuration is completed, click Next.
- Click Finish.
Install GeoEnrichment Server silently
To install GeoEnrichment Server silently using command line parameters, complete the following steps:
- Open a command shell as the user who will run GeoEnrichment Server, and browse to the directory where you downloaded the GeoEnrichment Server tar.gz file from My Esri.
- Run the setup silently at the prompt. Sample syntax:
<CD_ROOT or untar directory>/Setup -m silent -l yes
The parameters of the command line tool are as follows:
Parameter Description -m; --mode MODE
Optional. It defaults to GUI.
MODE is either silent or GUI.
-v; --verbose
Installer runs in verbose mode.
-h; --help
Display this help and exits.
-e; --examples
Display 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 License 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.
-i; --install set CHOICE
Optional. If this option is not used, the default typical installation of ArcGIS GeoEnrichment Server will be installed. CHOICE is either the word Typical or Complete. Using the word Complete will install AI models and semantic search features for enhanced demographic variable and POI search.
Configure the GeoEnrichment Server environment silently
To configure GeoEnrichment Server silently from the command line, complete the following steps:
- Open a command shell, and browse to the directory where the ArcGIS Server installation is located.
- Run the setup silently at the prompt.
Sample syntax:
<ArcGIS Server Installation Directory>/tools/geoenrichment/manageEnvironment.sh create -b -u <user name> -p <password>
The parameters of the command line tool are as follows:
Parameter Description 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 noninteractive (batch) mode.
-d; --directory <directory>
By default, the GeoEnrichment Data Store is installed in the user's <ArcGIS GeoEnrichment Installation Directory>/data directory. The directory parameter 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. It can be set to the environment variable GE_PORTAL_PASSWORD.
-u; --username <username>
Portal administrator username. It can be set to the environment variable GE_PORTAL_USER.
-y; --yes
Automatically answer yes to all prompts.
Next step
Learn how to install and manage data packs.