Installing and Configuring Esri on Premise

How to:

Install and Configure Esri on Premise

The Esri on Premise feature enables customers to generate Esri maps using a locally hosted Esri server, making it unnecessary to go to ArcGIS Online or another outside site for basemaps, geographic roles, and the geometry task (the service that performs operations on input geometries such as projecting geometries into a different spatial reference). This feature enables the App Studio Esri Viewer feature to leverage all GIS Enterprise Data developed by a customer with intranet connectivity.

When a site uses Esri on Premise, the following geographic elements must be customized to be retrieved from the local Esri server.

Geographic roles. For information on configuring custom geographic roles, see Editing the List of Geographic Roles.
Basemaps. For information, see How to Edit the Geographic Configuration.
Geometry task.
Demographic layers.

Note: All on-premise published feature layers should be published on a CORS-enabled ArcGIS Server and avoid proxy on client.

Procedure: How to Install and Configure Esri on Premise

Download the ArcGIS Online API for JavaScript.
1. Go to https://developers.arcgis.com/downloads/ > ArcGIS API for Javascript > Version 3.22, as shown in the following image.
  Note:
  - You may be prompted to sign in with your Esri credentials.
  - Even if a newer version of the API is available, it is critical that you download and use the 3.22 version.
2. Click API to download the API.
Unzip the API.
1. Create a folder called arcgis_api under:
```
webfocusdir\config\web_resource\
```
  where:
  
  webfocusdir
  
  Is the directory where WebFOCUS is installed.
2. Navigate to the following subfolder in the zip file you downloaded:
```
arcgis_js_v322_api\arcgis_js_api\library\3.22\3.22
```
  Extract its contents to the folder you created in step 2:
```
webfocusdir\config\web_resource\arcgis_api
```
Configure the Administration Console for Esri on Premise.
1. In the Administration Console, click ESRI, and in the Esri on Premise text box add the path to the folder in which you unzipped the API, as shown in the following image.
  
  This identifies the path to the internal ArcGIS Javascript API Source that develops Esri-based maps. This setting is blank, by default, meaning that the use of the internal API Source to develop Esri maps is not activated. The API referenced by default is https://js.arcgis.com/3.22/. To direct to use the internal ArcGIS Javascript API to develop Esri maps, type the path to it in this text box.
  
  This path should be a relative path accessible to the local installation.
2. Click Save.
Clear your browser cache.

Once you have installed and configured the API, you must configure the locally hosted geometry task when creating a map.

The geometry task is the service that performs operations on input geometries, such as projecting geometries into a different spatial reference. You configure the geometry task in the Esri Viewer Properties panel when creating a map. Add the URL to the locally hosted geometry task in the Map: Geometry Service text box of the Esri Viewer Properties panel, as shown in the following image.

Using the Reporting Server Geographic Configuration tool, configure locally hosted, roles, basemaps, and demographic layers.

	WebFOCUS