Skip To Content

Configure the portal to support Insights

Before users can access Insights, you must set up a base ArcGIS Enterprise deployment that includes Portal for ArcGIS with a federated ArcGIS Server site as your hosting server.

You will also need to install Insights for ArcGIS. For instructions, see Install Insights for ArcGIS.

Required base ArcGIS Enterprise deployment

All of the components listed below, which together make up a base ArcGIS Enterprise deployment, are required. A Workgroup deployment is also supported. For a tutorial on how to create a base deployment, see Tutorial: Set up a base ArcGIS Enterprise deployment.


If ArcGIS Web Adaptor for ArcGIS Server is not configured to enable administrative access, ArcGIS Server must be configured to use a CA-signed certificate to support creating database connections.

ArcGIS Server must be licensed as ArcGIS GIS Server Standard or ArcGIS GIS Server Advanced. For more information about ArcGIS Server licensing roles, see ArcGIS Enterprise licensing in the Portal for ArcGIS administrator guide or ArcGIS Server help.

After you build your deployment, you will also need to configure required portal settings (see below).

Required portal configuration settings

After you set up the base ArcGIS Enterprise deployment, do the following:

  1. Configure Insights for ArcGIS licenses.
  2. Ensure that users in your organization have the appropriate role, privileges, and membership level to access and use Insights.

    A user requires the following:

    • The Publisher role to add data, create visualizations, and use spatial analytics
    • Level 2 membership

For more information, see Organization roles and membership levels in the Portal for ArcGIS Administrator Guide.

Next, configure other settings to enable important services and features such as geocoding and routing (see below).

Important settings for Insights for ArcGIS features

These configuration settings are not required, but they allow portal members to connect to data warehouses, geocode data, use maps (and extents) suitable for their region, and more.

Register relational data store types

To support database connections that allow users to add datasets from a business database, your portal's hosting server site must have the required relational data store types registered for use. Follow these steps to ensure Insights can work with your database.

  1. Upload the required vendor files to ArcGIS Server.
    1. Get the required vendor files for the database type you want to register (see Supported databases to get the list of required vendor files).
    2. Package vendor files into a ZIP file (.zip) for a single database type.

      When zipping the JDBC drivers for upload, .jar files should be located in the root of the zip archive. There should not be any folders in the .zip file.

    3. Using an administrator account, sign in to the ArcGIS Server Administrator Directory (http://server:port/arcgis/admin).
    4. Navigate to Uploads.
    5. Click Choose File.
    6. Browse to the ZIP file containing the vendor files for the database to be registered.
    7. Select the ZIP file and click Open.
    8. Optionally add a description to the file to upload.
    9. Click Upload.
    10. Note the Item ID of the uploaded file.
    11. Navigate back to Home.
  2. Register the data store type on ArcGIS Server.
    1. Navigate to Data in the ArcGIS Server Administrator Directory.
    2. Navigate to relationalDatastoreTypes.
    3. Navigate to Register.
    4. Select the ZIP file using the Item ID from the Uploaded item ID drop-down list.
    5. Select the corresponding type from the Relational Datastore Type drop-down list.
    6. Click Register Item.
  3. Restart ArcGIS Server.
    1. After registering all required data store types following steps 1 and 2, you have to restart ArcGIS Server on each machine in your site. To do this, you need to restart the Windows Service or use the stopserver and startserver scripts on Linux.
  4. Validate user database privileges.
    1. Make sure that Insights users have the required database privileges to create database connections and query data.

Insights displays spatial data in the spatial reference system of your portal organization's default basemap. This is for display and query purposes only; the underlying data is not altered. If the two spatial reference systems' underlying geographic coordinate systems are incompatible, alignment and accuracy problems may be observed. To ensure fast performance and accurate display of spatial data, it is recommended that organizations use the same spatial reference system for their default basemap and their spatial data. You can change the default basemap of the portal or re-project your spatial data to match your organization's basemap.

Edit relational data store types

Edit a registered relational data store type to update its properties. Before proceeding with any edit, make a backup copy of the JSON properties. To edit the relational data store type, use the following steps:

  1. Edit the registered relational data store type on ArcGIS Server.
    1. Using an administrator account, sign in to the ArcGIS Server Administrator Directory (http://server:port/arcgis/admin).
    2. Navigate to Data in the ArcGIS Server Administrator Directory.
    3. Navigate to relationalDatastoreTypes.
    4. Click on the registered relational data store type that needs to be edited.
    5. Scroll down to the bottom of the page and click on edit.
    6. Modify the properties and click on update.
  2. Restart ArcGIS Server for the changes to take effect.

    After editing registered relational data store types, you have to restart ArcGIS Server on each machine in your site. To do this, you need to restart the Windows Service or use the stopserver and startserver scripts on Linux.

For more information, see Edit Relational Data Store Type.

Configure utility services

Configure utility services required to power specific functionality in your portal, such as performing analysis with tools that depend on utility services. The table below lists each utility service and the Insights feature it supports.



Allows users to add location to their datasets by specifying an address. For user instructions, see Enable location for your data.


Enables the use of dissolved boundaries for the Create Buffer/Drive Times tool.


Enables the Find Nearest spatial analysis tool.


Allows users to add demographic information to a location or area using the Enrich Data tool.

Configure travel modes

Allows users to specify a means of transportation, such as walking time or trucking distance, for spatial tools such as Create Buffer/Drive Times.

  • You can configure your portal to use utility services from ArcGIS Online. See Configure ArcGIS Online utility services for details.
  • If you are running Insights in a disconnected environment, you must configure the service from a federated or hosting server.

Configure boundary layers

Configure boundary layers to allow users to use feature layers containing boundary information for supported countries in their maps and analyses.

When you configure boundary layers, users can add these layers from the Boundaries tab of the Add To Page window. Boundary layers are another way for users to add location to their data. For user instructions, see the following:

Specify a default region

Specify a default region to control the default map extent and to make boundary layers for the default region available to users on the Boundaries tab of the Add To Page window.

Configure Living Atlas content

Configure subscriber and premium content from ArcGIS Living Atlas of the World to make this ArcGIS Online collection available in your portal. Living Atlas content that does not require you to sign in to an ArcGIS Online account is available by default.

Once the portal has been configured to support Insights, users can access it through a URL in the format<webadaptorname>/apps/insights. Help documentation can be accessed from the Help menu in Insights.