Skip To Content

Configure Insights Enterprise

As the Insights Enterprise administrator, you can add an application configuration file to specify a variety of options. The configuration file must be called insights.json and should be placed in the following location on the ArcGIS Server: ArcGIS Server install directory\framework\etc\insights.json. Available options are described below.

Administrative settings

The following properties are used to define options.

PropertyDescription

enrich_max_features

Controls the maximum size of a dataset that can be enriched using the GeoEnrichment Service. If the number of records in the dataset exceeds this value, the Enrich Data tool will return an error. Acceptable values are integers; the default is 10,000. This is an Integer property value and does not require quotation marks.

Example: "enrich_max_features": 10000

locate_geocode_max_features

Controls the maximum size of a dataset that can be geocoded using the Geocoding Service. If the number of records in the dataset exceeds this value, Enable Location will return an error. Acceptable values are integers; the default is 10,000. This is an Integer property value and does not require quotation marks.

Example: "locate_geocode_max_features": 10000

buffer_network_max_features

Controls the maximum size of a dataset that can be buffered using the Network Service. If the number of records in the dataset exceeds this value, the Create Buffer/Drive Times tool will return an error. Acceptable values are integers; the default is 1,000. This is an Integer property value and does not require quotation marks.

Example: "buffer_network_max_features": 1000

max_feature_copy_limit

Controls the maximum size of a dataset that can be copied to the relational data store or a database. If the number of records in the dataset exceeds this value, operations requiring data to be copied will return an error. Acceptable values are integers; the default is 250,000. This is an Integer property value and does not require quotation marks.

If the limit is exceeded, the following error message will be displayed: The dataset contains too many records. Try reducing the size of your dataset. You can reduce the size of your dataset using an attribute filter or spatial filter.

Example: "max_feature_copy_limit": 250000

database_timeout

Controls the length of time in seconds that an operation using data from a database connection will run before timing out. If the number of records in the dataset exceeds this value, the operation will return an error. Acceptable values are integers; the default is 120 seconds. This is an Integer property value and does not require quotation marks.

Example: "database_timeout": 120

Note:

Operations performed with SAP HANA databases do not have time-out limits. The database_timeout property will not be applied to SAP HANA.

Change settings

Follow these steps to configure the settings for Insights Enterprise.

  1. Create a file named insights.json.
  2. Add the settings you want to configure to a single object in the JSON file.
  3. Copy the insights.json file to \framework\etc\.
  4. Restart ArcGIS Server.
  5. If your Insights Enterprise implementation includes more than one ArcGIS Server, repeat steps 3 and 4 for each ArcGIS Server in your site. The settings should be identical on all servers.
Note:

Ensure that the insights.json file contains valid JSON. The settings will not take effect if the file is not formatted correctly.

If you want to restore the default administrative settings, you can do so by deleting insights.json and restarting ArcGIS Server. Be sure to repeat these actions on each ArcGIS Server in your site.

Example

Contents of the insights.json file when configuring enrich_max_features, locate_geocode_max_features, buffer_network_max_features, max_feature_copy_limit:

{  
"enrich_max_features": 10000,  
"locate_geocode_max_features": 10000,  
"buffer_network_max_features": 1000,
"max_feature_copy_limit": 500000 
}

Esri User Experience Improvement program

The Esri User Experience Improvement program collects usage information from users and uses the data to make improvements to the software.

Administrators can opt-out of the program during the install process. If the Insights Enterprise installation process is complete, the settings can be configured to discontinue participation in the program.

Configure the settings for Windows

If you are installing Insights Enterprise on Windows, you can uncheck Click here to participate in the Esri User Experience Improvement program in the install wizard to opt-out.

The settings for the Esri User Experience Improvement program can be configured using the settings file (<portal_install_dir>/apps/insights/settings.json). To opt-out of the program, change the setting from eueiEnabled: "true" to eueiEnabled: "false".

Configure the settings for Linux

If you are installing Insights Enterprise on Linux, you can run the install command ./Insights-Setup.sh -e No to opt-out of the Esri User Experience Improvement program.

The settings for the Esri User Experience Improvement program can be configured using the settings file (<portal_install_dir>/apps/insights/settings.json). To opt-out of the program, change the setting from eueiEnabled: "true" to eueiEnabled: "false".