Install Esri Maps for SAP BusinessObjects
In this topic
The Esri Maps for SAP BusinessObjects add-on allows you to integrate your SAP business intelligence (BI) data with the ArcGIS platform. In the context of this topic, the ArcGIS platform refers to ArcGIS Online (available at arcgis.com) or to an on-premises Portal for ArcGIS instance (available through a URL specific to your organization).
After you have confirmed that you meet all the system and software requirements, you're ready to install Esri Maps for SAP BusinessObjects.
Installing Esri Maps for SAP BusinessObjects involves the following tasks:
- Mount the ISO image
- Install server-side components
- Install client-side components
- Register the application
- Configure login settings
- Configure administrative settings
- Configure a proxy (optional)
Note:
If your organization's ArcGIS Online is secured using PKI or IWA authentication, you must configure your environment so that your ArcGIS Online and the web server component of your Business Intelligence system are served from the same origin; that is, they must be on the same host, domain, and port, and use the same protocol.
Mount the ISO image
Esri Maps for SAP BusinessObjects is delivered as an ISO image containing separate folders for the server and client components, as well as a PDF versions of the Installation Guide and End User License Agreement.
- When deploying to a Windows operating system, use an ISO image mounting program to view the ISO image file as a virtual disk (for example, Virtual CloneDrive).
For instructions on mounting the ISO image file on a Linux-based system, see the administration documentation for your operating system.
- Copy the contents of the ISO image to a temporary location on your system.
Install server-side components
To install the Esri Maps for SAP BusinessObjects server-side components, do the following:
- Extract the contents of the server installation archive file, em4bobj_server_install.zip, to the webapps folder of your Tomcat installation.
For example, on Windows, the default installation path of Tomcat 6 on the server is as follows:
C:\Program Files (x86)\SAP BusinessObjects\Tomcat6\webapps
On Linux, the default installation path of Tomcat on the server is as follows:
<BIP_INSTALL_DIR>/tomcat/webapps
where <BIP_INSTALL_DIR> is the directory in which your BI platform is installed.
When the extraction is complete, the webapps directory will contain a new subdirectory named em4bobj.
- Restart your web application server.
The installation of the server-side components is complete. After installing the client-side components, configure login settings to specify the login method used to trigger the appropriate authentication method for your ArcGIS platform subscription. Optionally, configure the internal proxy; see Work with proxies for more information.
Install client-side components
The Esri Maps for SAP BusinessObjects client application is deployed as an add-on to SAP Dashboards; it allows you to display and configure data on an Esri Map component in an SAP BusinessObjects dashboard.
- Extract the client installation archive file, em4bobj_client_install.zip, to a temporary location on your system.
You will use the contents of this archive throughout the installation process.
- To install the Esri Maps for SAP BusinessObjects client, do the following:
- Install http://get.adobe.com/air/ to download the installation files and follow the instructions provided with the software.
- From the temporary location where you extracted the Esri Maps for SAP BusinessObjects client components, double-click the EM4BOBJDesigner.air file and follow the installation instructions.
Note:
During installation, clear the Add shortcut icon to my desktop and Start application after installation check boxes in the Installation Preferences panel. If the Esri Maps Designer window opens after installation, close the window before continuing with the installation.
- To configure the SAP BusinessObjects server properties, do the following:
- In the SAP Dashboards installation directory under \Xcelsius 4.0\assets, create a new subfolder named em4bobj.
For example, add the directory as follows:
C:\Program Files (x86)\SAP BusinessObjects\Xcelsius 4.0\assets\em4bobj
- From the temporary location where you extracted the Esri Maps for SAP BusinessObjects client components, copy the em4bobj.properties file to the newly created em4bobj folder.
- Using a text editor, open the em4bobj.properties file and modify the server name from localhost to the name of your BusinessObjects server.
For example, the default SAP Server URL is http://localhost:8080.
- If your server is running on a port other than 8080, change the port to reflect your SAP BusinessObjects Server configuration; otherwise, leave the port setting at 8080.
- In the SAP Dashboards installation directory under \Xcelsius 4.0\assets, create a new subfolder named em4bobj.
- Save the em4bobj.properties file.
- To deploy the Esri Maps for SAP BusinessObjects add-on, do the following:
- Start SAP Dashboards and create a new, blank dashboard.
- From the SAP Dashboards menu, click File > Manage Add-Ons.
The Add-On Manager opens, listing the available add-ons.
- Click Install.
- From the file browser, browse to the temporary location of the Esri Maps for SAP BusinessObjects client components and open the EsriMapsForBOBJ.xlx file.
The Esri Maps for SAP BusinessObjects add-on appears in the list of available add-ons.
- Click Close.
- At the prompt, click Exit to close SAP Dashboards. To save the current dashboard, click Save and Exit.
The installation of the client-side components is complete and you can safely delete the temporary folder that contains the installation files. If users will not have access to the Internet, see Work in a disconnected environment.