Available with Business Analyst license.
Common questions for installing and configuring Business Analyst Server 10.6.1
Business Analyst Server installation and configuration
The Business Analyst web app on-prem installation and configuration
- Why do I see an Invalid redirect uri when signing into the Business Analyst web app?
- Why can’t I login to the Business Analyst web app?
- Why don’t I have an option to manage licenses for the Business Analyst web app in Portal?
- Why does the Business Analyst web app never finish loading after logging in?
- Why can’t I create a project in the Business Analyst web app?
- Why doesn’t Color Coded Maps work in the Business Analyst web app, it is greyed out and reads: Color-Coded Maps is not available for the selected country or area?
- Why don’t all of the features display when using Color Coded Maps?
Configuring and using Utility Services
Business Analyst Server installation and configuration
If the post install fails with this message: Can't create default map service configuration. Please restart ArcGIS Server and rerun the Business Analyst Server Post Install. It is important to note the errors in the Post Install dialog window before clicking Finish. You can also click on Show Post Install log file before finishing to save the log messages to a text file.
Possible errors
The Map service created but failed to start because the ''map document file doesn't exist at this location ().
This error likely means that Business Analyst Server has been installed before the Business Analyst Server data. The Business Analyst Server data should exist in a location such as: C:\ArcGIS\Business Analyst\US_2020_Server. If the data has not been installed on the machine, see this topic on how to install: Installing Business Analyst data.
Failed: Can’t get Extension types.
The likely cause of this error is that ArcGIS Server has not been federated with Portal. Business Analyst Server can be installed on a standalone GIS Server, however, that type of installation must be selected at the beginning of the post install. For information on federating a server with Portal, see this topic: http://server.arcgis.com/en/portal/latest/administer/windows/federate-an-arcgis-server-site-with-your-portal.htm
Creating and starting the Map service with Business Analyst capability (DefaultMap) ... Can't create default map service configuration.
This error likely means the DefaultMap service failed to publish because the setup was unable to update files or services while the system was running. First try restarting ArcGIS Server and re-running the post install. If this does not fix the problem, a reboot of the machine is required.
The Business Analyst web app on-prem installation and configuration
The most likely cause is that redirectURIs have not been added in the App Info. Login to the portaladmin directory as an administrator and navigate to the UpdateAppInfo endpoint, for example: https://PortalName.domain.com/portal/portaladmin/security/oauth/updateAppInfo
In the example syntax below, replace domain.com with your domain name for both http and https. Paste the syntax into the App Info and click Update App. {"appId": "busanalystonline_2","redirectURIs": ["http://*.domain.com", "https://*.domain.com", "urn:ietf:wg:oauth:2.0:oob"]}
If you are receiving this error when trying to login: You do not have permissions to access this application it is likely because that user has not been granted a license by the Portal administrator. Login to Portal as an administrator and click My Organization > Manage Licenses:
Next, click on a user’s link to their licensed products:
Check the box for Esri Business Analyst web app to assign a license to the user.
Note:
User must be a level 2 user with at least a publisher role.
Before licenses can be managed within Portal, the entitlements file must first be imported, the entitlements file should be available to download in MyEsri. Once downloaded, the file can be imported in the Portal Administrator Directory, for example: https://PortalName.domain.com/portal/portaladmin/system/licenses/importEntitlements
After the entitlements are imported, refresh the My Organization page in Portal and Manage License should appear:
After logging in, the application takes some time to initialize by connecting to the underlying services. However, if the app never finishes initializing, the first thing to check is if GeoEnrichment has been configured as a utility service in Portal. The Portal administrator can check the portal/self endpoint and review the helper services. https://PortalName.domain.com/portal/sharing/portals/self"geoenrichment": {"url": "https://ServerName.domain.com/server/rest/services/DefaultMap/geoenrichmentserver"}
The project layers in the Business Analyst web app depend on hosted feature services in Portal and the most likely cause is that a hosting server has not been configured in Portal. To check, sign into Portal as an administrator My Organization > Edit Settings > Servers.
- What is the value in the Hosting Server list? If ‘No Hosting Server’, see this topic for configuring a hosting server: http://server.arcgis.com/en/portal/latest/administer/windows/configure-hosting-server-for-portal.htm
- The portal administrator can also check Portal’s list of servers in the sharing directory, for example: https://PortalMachine.domain.com/portal/sharing/portals/self/servers
Verify that there is a server listed with a value of true for Is Hosted.
A less likely cause for this behavior is that a hosting server is configured, however, the ArcGIS Data Store has not been installed and a different enterprise database is being used to support the hosting server. In this case unexpected behavior may occur as not all databases are the same e.g., postgres does not support mixed case field names. Enhancements can be considered to support hosting servers with a non-standard data store.
Why doesn’t Color Coded Maps work in the Business Analyst web app, it is greyed out and reads: Color-Coded Maps is not available for the selected country or area?
There are eight dynamic map services that need to be published and shared with the Esri Demographic Layers group in Portal to support this functionality. There are service definition files provided with the US_2020_Server data along with a script to publish and share these map services with the group and portal organization.
The Esri Demographic Layers group is a system group and does not need to be created manually, the provided script will publish the service definition files as map services, share them with the Esri Demographic Layers group, and also share them with the Portal organization so that users of the Business Analyst web app don’t need to belong to the Esri Demographic Layers group to use Color Coded Maps. If access of the map services is restricted to only the Esri Demographic Layers group, users of the app will need to belong to the group for Color Coded Maps to work.
Configuring and using Utility Services
If you're seeing an error such as: An unexpected error occurred when attempting to geocode, the most common reason is that a geocoder service hasn't been configured in Portal.
Place search in the Business Analyst web app uses a geocode service much as drive times use a network service area service. A cloud based geocoder can be used from ArcGIS Online or published locally to ArcGIS Server from the Business Analyst geocoding data. Place search or geosearch does not consume credits as it is not a batch geocoding operation (importing a csv file of x y locations would be considered a batch geocode job).
Check if a geocoder has been configured in Portal in the self-discovery endpoint, in this example the ArcGIS Online World geocoder has been configured. Note that the Batch Geocoder is listed first and has an associated portal item in the url referencing the item with stored credentials.
https://PortalName.domain.com/portal/sharing/portals/self"geocode": [{
"url": "https://PortalName.domain.com/portal/sharing/servers/3c090863fdff476aa448361be3391f04/rest/services/World/GeocodeServer",
"name": "Esri World Batch Geocoder",
"placeholder": "Find address or place",
"singleLineFieldName": "SingleLine",
"batch": true,
"placefinding": true,
"suggest": true,
"zoomScale": 10000
}, {
"url": "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer",
"northLat": "Ymax",
"southLat": "Ymin",
"eastLon": "Xmax",
"westLon": "Xmin",
"name": "Esri World Geocoder",
"suggest": true
A less common cause would be that a geocode service has been published to ArcGIS Server and configured in Portal but it does not support suggestions. When typing a place in the search bar, a suggestion is requested from the geocoder to guess the place. If the geocoder was published from an address locator that does not support suggestions, it will result in this behavior.
Note:
The Business Analyst Desktop 2020 US geocoding data does not support suggestions, whereas, the Business Analyst Server 2020 US geocoding data does. Address locators with support for suggestions consume more memory and this can lead to a degradation in performance for large geocode jobs within Business Analyst Desktop, thus, for performance reasons, suggestions were removed from the Business Analyst Desktop geocoding data. This is a primary reason why a separate Server US 2020 data download was made available - to support geocoders with suggestion capabilities.