Available with Business Analyst license.
This section outlines the software and data components and prerequisites required to install ArcGIS GeoEnrichment Server.
Business Analyst Enterprise requires a multiple-machine deployment with a complete ArcGIS Enterprise base deployment and one additional federated ArcGIS Server site dedicated for GeoEnrichment Server. The requirements in this topic are specific to ArcGIS GeoEnrichment Server, which should be installed on an ArcGIS Server site separate from the hosting server's site. The ArcGIS Server site with ArcGIS GeoEnrichment Server must be federated to Portal for ArcGIS.
For system requirements on the ArcGIS Enterprise base deployment, refer to the Base ArcGIS Enterprise deployment topic. For more information on how to install ArcGIS Server, refer to the ArcGIS Server installation guide.
Note:
- Before installing ArcGIS GeoEnrichment Server, check that ArcGIS Enterprise and the additional federated server are installed and functioning. Make sure that you are able sign in to Portal for ArcGIS. Also make sure that you can access ArcGIS Server Manager on each machine.
- The GeoEnrichment Server setup assumes that the Web GIS Server infrastructure is already in place. The post-installation wizards require the server to be federated to run.
GeoEnrichment Server as a federated server uses Portal for ArcGIS Security. Access to the service is controlled by the sharing capabilities in Portal for ArcGIS. By default, the service is shared with the organization and the sharing must be updated by the portal administrator if changes are needed. For more information on sharing items in Portal for ArcGIS, see Share items.
Supported platforms
Business Analyst Enterprise is supported on all Windows and Linux versions supported by ArcGIS Enterprise.
For the full list of supported versions, refer to the ArcGIS Server system requirements.
Hardware requirements
For optimal performance, ArcGIS GeoEnrichment Server should be installed on a machine with 32 GB of RAM or more. These requirements are based on a standard installation:
- GeoEnrichment Service
- Reporting Tools Service
- Demographic Feature Services (color-coded maps and smart mapping)
For a production environment, minimum hardware requirements may vary and should be scaled based on the amount of usage and number of data vintages installed. If multiple years of USA data are installed, it will increase memory usage. If helper services for geocoding and routing are published alongside the GeoEnrichment Server on the server site, it will also increase memory usage. At least 32 GB of RAM is highly recommended.
For further guidance, see the system requirements for ArcGIS Enterprise Builder and ArcGIS Server.
Change environment settings
GeoEnrichment Server uses a spatiotemporal big data store behind the scenes to store Points of Interest (POI) data for business listings. To accommodate this, additional environment settings are required for these types of data stores.
The minimum file handle and process settings for spatiotemporal big data stores are 65,536 and 25,059 respectively. In addition, set file size and virtual memory to unlimited.
Set all of these limits in the /etc/security/limits.conf file.
The following is an example of file limit, file size, process, and virtual memory settings in the /etc/security/limits.conf file on spatiotemporal big data store machines:
<ArcGIS Data Store installation user> soft nofile <file limit>
<ArcGIS Data Store installation user> hard nofile <file limit>
<ArcGIS Data Store installation user> soft fsize unlimited
<ArcGIS Data Store installation user> hard fsize unlimited
<ArcGIS Data Store installation user> soft nproc <process limit>
<ArcGIS Data Store installation user> hard nproc <process limit>
<ArcGIS Data Store installation user> soft as unlimited
<ArcGIS Data Store installation user> hard as unlimited
Note:
The <ArcGIS Data Store installation user> is the name of the login you use to install ArcGIS Data Store.
- Sign in with the <ArcGIS Data Store installation user> specified user for the file handle and process limit values to take effect. To verify that the limits have been modified appropriately, use the ulimit -Hn -Hu and ulimit -Sn -Su commands as described above.
- Change the following system virtual memory settings:
- vm.max_map_count—Set to at least 262144. If you do not set this, you may receive out-of-memory exceptions.
- vm.swappiness—Set to 1; otherwise, it will negatively affect the performance of the spatiotemporal big data store.
- Virtual memory settings apply to the whole system rather than the ArcGIS Data Store installation user. To configure your virtual memory settings, update the /etc/sysctl.conf file with the following virtual memory values and replace the map count with a number appropriate for your use:
vm.max_map_count = <map count> vm.swappiness = 1
- After changing process, file, and virtual memory limits, restart ArcGIS Data Store.
Disk space requirements
Business Analyst Enterprise is powered by large datasets known as data packs, which are downloaded from My Esri. For the USA data pack, you will need 220 GB of free space on the disk where these files will be installed. Additional space is required if installing the optional hexagon data.
It is important to have enough available disk space for staging the files as well as installing the data. During the data installation, files are extracted to the default temporary location to prepare them to be uploaded to the database. If the data installation wizard detects that there is not enough space in the default temporary location, there will be a prompt to change the folder. For best results, the recommended available disk space exceeds the size of the installed data. See the table below for best practices. The installed sizes below include the points of interest (POI) data.
Data pack | Installed size | Recommended available storage |
---|---|---|
USA 2021 R1 | 85 GB | 200 GB |
USA 2022 R1 | 85 GB | 200 GB |
USA 2023 R1 | 94 GB | 220 GB |
USA 2024 R1 | 94 GB | 220 GB |
USA 2024 R1 with hexagons | 233 GB | 550 GB |