SAP Business Objects Cloud (BOC) allows for data acquisition from various on-premise solutions, including BI4.x universes, SAP BW, OData, SAP ERP, SAP BPC MS, JDBC sources, and SAP BPC NW. This blog will cover how to setup HANA Cloud Connector and SAP BusinessObjects Cloud Agent to allow SAP Business Objects Cloud to acquire data from these sources. Typically this setup would be done by someone in IT. After the HANA Cloud Connector and SAP BusinessObjects Cloud Agent have been setup inside your organization, your business users can access on-premise data. To allow for this you will need to complete the following tasks:
- Install and initial configuration of SAP HANA Cloud Connector
- Deploy SAP BusinessObjects Cloud Agent
- Optionally deploy SAP JCO connectors for BW and ERP connectivity
- Configure Access Control in SAP HANA Cloud Connector
- Configure SAP BusinessObjects Cloud Agent in your BOC tenant
Note: SAP BPC NW and on-prem ODATA services do not require deployment of SAP BusinessObjects Cloud Agent. For SAP BPC NW and ODATA connectivity from SAP BusinessObjects Cloud follow the sections on Install and initial configuration of SAP HANA Cloud Connector and SAP BPC NW specific section under Configure Access Control in SAP HANA Cloud Connector.
Install and initial configuration of SAP HANA Cloud Connector
In order to configure SAP HANA Cloud Connector (HCC), the HCP account name and S-User credentials are required for the HCP instance where your BOC tenant is running. This information can be obtained through the following steps:
1. Log into your SAP BusinessObjects Cloud tenant using an account with “Admin” role assigned.
2. Navigate to System >> Administrator >> DataSource Configuration
3. Click the pencil icon on the top right of your screen to edit the configuration.
4. Enter your S-User credentials and click Add S-User.
5. Make a note of the Account Name, LandScape Host and your S-User account as it will required for Hana Cloud Connector Configuration later.
If the screens to add/change your S-User are not vsible, confirm that you have admin role assigned in the BOC system. If everything checks out and the screens are still not available under Datasource Configuration, log a support ticket using the component LOD-ANA-BI.
NOTE: HANA Cloud Connector needs to be installed on a machine on the same network where your on-premise systems like BW, BI4 etc. reside. The HANA Cloud Connector also needs to be able to communicate with the datacenter where your BusinessObject Cloud tenant resides. A detail list of pre-requisites is available at the link below:
Install HANA Cloud Connector
Access https://tools.hana.ondemand.com/#cloud and download SAP JVM 8. I used JVM 8 on my system but you can also leverage your existing JVM 7, or JVM 8 installation. Check the pre-requisites on the link above for supported version of JVM.
Extract the zip file on the server where HCC will be installed. I extracted mine under C:\SAPJVM\sapjvm_8
Download the HANA Cloud Connector installation appropriate for your OS distribution. My install is on a Windows server hence the Windows MSI download.
Double click on the downloaded MSI file to launch the installation of HANA Cloud Connector and select an install folder.
Specify the JDK directory and complete the installation process. Choose the option to start the HANA Cloud Connector after installation.
Initial Configuration of HANA Cloud Connector
Launch https://<HCC host>:8443 to launch the HANA Cloud Connector configuration page.
https://localhost:8443 can be used if accessing from the same machine where HCC is installed.
Ignore the certificate warning and continue to the site
Login with the default credentials of:
User: Administrator //User is case sensitive
The default password will have to be changed after first login.
Choose Master (Primary Installation)
Specify the following information(captured earlier).
Landscape Host: <HCP Datacenter where your BOC tenant is running>
Account Name: <HCP account name>
User: <Your S-USER user>
Password: <S-USER password>
If you access the internet through a proxy, specify your proxy host and port number otherwise you can leave those blank
Confirm that the connector state shows as Connected. You may have to hit the Connect button on the right of the screen.
Install Tomcat and deploy SAP BusinessObjects Cloud Agent
Download Tomcat 8 for Windows from https://tomcat.apache.org/download-80.cgi
Double click the downoaded Tomcat executable to launch the installation and accept the license agreement.
On the Choose Components screen, leave the default options
Specify the Tomcat ports to use. Ensure there are no port conflicts with existing applications that may be running on your system already.
Specify the path to your JVM folder.
Note: You must use 64 bit JVM. In this case, we are using the same 64 bit SAP JVM that we use for HANA Cloud Connector configuration earlier.
Choose an Installation folder and click Install.
Click Finish to complete the install.
Launch Tomcat configuration to and update the JAVA Heap space allocation. To launch, navigate to Tomcat installation directory and double click Tomcat8w.exe.
The default value for -Xms and -Xmx is usually 128MB, and 256MB respectively and is usually not sufficient. Failure to increase these values will usually result in timeout errors when acquiring larger data sets into BOC. Here I’ve set the values to 1024MB and 2048MB, but you may have to increase the Maximum Memory pool(Xmx) to even higher value in your landscape.
Deploy SAP BusinessObjects Cloud Agent
Note: This step is not necessary if only connecting to SAP BPC NW from SAP BusinessObjects Cloud. Proceed to Configure Access Control in SAP HANA Cloud Connector section below and follow the steps specific to creating access control for SAP BPC NW.
The SAP BusinessObjects Cloud Agent(BOC Agent) is just a war file that can be deployed on Tomcat application server. This can either be an existing Tomcat Java application server running in your environment or install(like we have done) a separate application server to deploy BOC Agent war file. My recommendation would be setup a new Tomcat server to deploy the BOC Agent. The main reason for this recommendation is that BOC Agent is being updated frequently to take advantage of the new connectivity types being offered in SAP BusinessObjects Cloud. As SAP BusinessObjects Cloud is being updated frequently, the BOC agent must also be updated to keep pace with this innovation. This means you may have to deploy a new BOC Agent war file every few weeks, which could result in taking a potential down time on running application server that may be hosting other apps. To avoid impacting an existing production application server and potentially take a down time to deploy new war file, it’s advisable to setup a separate application server for BOC Agent deployment.
To download BOC Agent access https://support.sap.com/swdc
Click Software Downloads.
Click Support Packages and Patches >> By Alphabetical Index (A-Z) >> and letter “C”
Click SAP BOBJ CLOUD AGENT >> SAP BOBJ CLOUD AGENT 1.0 >> SAP BOBJ CLOUD AGENT 1.0 and download the latest version of SAP Business Objects Cloud Agent available.
Extract the zip file and copy the C4A_AGENT.war file into tomcat webapps directory. The war file will automatically deploy once Tomcat is restarted later.
Modify the tomcat-users.xml file under the tomcat conf directory using Notepad and add a new user with Services role. The username/password used here will be required later when configuring the BOC Agent in SAP BusinessObjects Cloud. Type the following lines into the xml file and modify the username/password for your environment.
<user username=”c4agent” password=”Welcome1″ roles=”Services”/>
NOTE: Do not copy and past the lines above in the tomcat-users.xml file as I’ve heard the double quotes don’t copy over properly.
Save the tomcat-users.xml file. You will need to restart your Tomcat application server for the settings to take effect. If you also plan on deploying the SAP JAVA Connectors, hold off on restarting the server until those files also deployed (see below).
Optionally deploy SAP JCO connectors for BW and ERP connectivity
Deployment of SAP Java Connectors is only required if you plan on using SAP BusinessObjects Cloud to acquire data from an on-premise BW or ERP systems.
Click on Software Downloads
Search for “java connector” and download the 64 bit SAP JAVA Connector version 3.0.14 for the appropriate operating system.
Extract the downloaded zip file and copy sapjco3.dll and sapjco3.jar file into tomcat/lib directory
Restart Tomcat application server.
Configure Access Control in SAP HANA Cloud Connector
Launch https://<HCC host>:8443 to launch the HANA Cloud Connector configuration page.
http://localhost:8443 can be used if accessing from the same machine where HCC is installed.
Login with your credentials and click on Access Control >> Add
Choose Other SAP System as the Back-end Type
Select HTTP protocol. Choose HTTPS if SSL configured on the Tomcat instance where the BOC Agent is deployed.
Enter the hostname (Internal Host) and portnumber (Internal Port) of the tomcat server where the BOC Agent is running.
The default tomcat http port is 8080 and the https port is 8443.
Optionally enter the Virtual hostname and port to use on the cloud side. The defaults are the actual hostname and port specified in the previous step, but this can be changed so that the actual hostname and port is not exposed in SAP BusinessObjects Cloud. The virtual hostname and port could be any name or port of your liking. The virtual hostname and port will be used later when configuring the BOC Cloud agent in SAP BusinessObjects Cloud.
Choose None for the Principal Type. The option to use Kerberos is a topic for later blogs.
Optionally add a description on the next screen and click Next.
Select the option “Check availability of internal host” to ensure the HANA Cloud Connector can access the C4A Agent.
The HCC configuration screen should look similar to the one below.
Under Accessible Resource click Add
Set the URL PATH: /C4A_AGENT/ and choose the option Path and all sub-paths and click Save
Your HANA Cloud Connector screen should look like the screen below. Your mapped system should be in green state.
Configure Access Control for SAP BPC NW
Add a new system mapping and resource with the following details:
- Virtual and Internal host = <Host name of a BPC NW>
- Virtual and Internal port = <Port of a BPC NW>
- URL path = /sap/bpc
- Access policy = Path and all sub-paths
Configure SAP BusinessObjects Cloud Agent in your BOC tenant
Launch your BOC system (tenant) URL and log in with an account that has administrative access.
Access System >> Administration option
Click on the SAP BusinessObjects Cloud Agent tab and edit the configuration. Enter the following information:
Host: <virtual hostname specified during the HANA Cloud Connector configuration>
Port: <virtual port specified during the HANA Cloud Connector configuration>
Username: <username specified in tomcat-users.xml file>
Password: <password specified in tomcat-users.xml file>
Save your configuration. You are now ready to acquire data from on-premise BI4 universe, BW, ERP, JDBC, ODATA and BPC data sources.
Still having troubles setting this up? Have a look at this handy troubleshooting guide created by one of my colleague:
To acquire data from a universe, have a look at Matt Pott’s blog:
For accessing on-premise system from SAP BusinessObjects Cloud in online (i.e. no acquisition) mode, follow Dong Pan’s blog post: