Skip to end of metadata
Go to start of metadata


This document will show how to setup a basic single server deployment of SAP BI Platform 4.0 Mobile using BlackBerry simulators . 


SAP BI Platform 4.0 (BI 4.0) is a powerful and robust Business Intelligence suite that delivers feature rich content in an easy to use interface.  You can use Crystal Reports, Web Intelligence Reports, Xcelsius documents to give your end users a diverse and exciting view on normally bland data.  SAP BusinessObjects Mobile consists of a client-side application for mobile devices and a Mobile server component that communicates with the SAP BusinessObjects Business Intelligence Platform server. Using SAP BusinessObjects Mobile, professionals on the move can access business intelligence information from a mobile device, such as a Smartphone or PDA. 

SAP BusinessObjects Mobile provides users of a mobile device with remote access to the following types of Web Intelligence and Crystal Reports. 

This guide will show basics on how to setup a BlackBerry Simulator and configure the mobile services for SAP BI Platform 4.0. 
** Please note that this guide is not designed for the IPhone or Ipad **


Environment Details

Operating Systems: Microsoft Windows Server 2008 R2 64-bit, client Windows 7
MDS Simulator Version: 4.1.2 (Bundle 17)
BlackBerry Device Simulator Version: v7.1.0.130 (9860). 
Product: SAP BI Platform 4.0 SP02

** VMWare VCenter Lab Manager is used for the Windows **

The diagram below outlines the recommended deployment scenario for SAP BI Mobile:

In an effort to simplify the deployment, The Mobile Servers and Enterprise Servers will be on the same machine. 

Downloading the BlackBerry Simulator and MDS Service.

This section will outline the steps to download and install the BlackBerry simulator on Windows 7. 

The first thing to download is the BlackBerry Email and MDS Services Simulator Package.  This will provide network access for the BlackBerry Simulator.  Go to the following website  and select BlackBerry Email and MDS Services Simulator Package. 

Select the latest version of the Email and MDS Services Simulator.  In this example, Version 4.1.2 (Bundle 17) is used.   Click on the Alternate Download link to download the package directly without the download manager.  After downloading the software, proceed to install it 

Next, download the BlackBerry Simulator.  On the same site as above, Select a BlackBerry device simulator.  In this example, BlackBerry Device Simulators 7.1.0 is used.  From here, the device selected is the BlackBerry Device Simulators v7.1.0.130 (9860).  After downloading the software, proceed to install it. 

The last thing to do is run and test network connectivity from the BlackBerry simulator. To do this, run the MDS Simulator through Start > Research In Motion > BlackBerry Email and MDS Services Simulator > MDS

A command window will appear.  When “pending push messages” appears, the MDS engine has loaded successfully. 

The next thing to do is start the BlackBerry device simulator.  Perform the following to disable the JVM errors in the simulator. 

Navigate to the following directory: C:\Program Files (x86)\Research In Motion\BlackBerry Smartphone Simulators 7.1.0\ (9860) 

There will be a batch file for the simulator.  It should be named after the simulator version.  Edit this file in notepad and add the following to the end of the execution line:

/ignore-error=104 /app-param=JvmNoBreakOnThrowable


Execute the application now through Start > Research In Motion > BlackBerry Smartphone Simulators 7.1.0 > (9860) > 9860

Once it has loaded successfully, try to access Tomcat from the SAP BI Platform system. 

Configuring Tomcat for Over-The-Air (OTA) Download

Over-The-Air or OTA is a term that is used to describe downloading software without connecting the mobile device to a computer.  To do this, a web application server, in this instance Tomcat, will be used to “push” the application to the device.

Navigate to the installation directory of SAP BI Platform.  From here, there should be a Mobile 14\Client directory. 

Copy the MobileOTA14.war file and then copy it into the Tomcat6/webapps directory.  Tomcat will deploy the war file in a couple of seconds.  It will look like this:
The BlackBerry simulator is now ready to receive the OTA SAP Mobile application. 

Download and Install SAP Mobile

Open a browser and enter the URL for download the Mobile Application: http://hostname:8080/MobileOTA14

The following page will appear:

 Select the “Click here to download SAP BusinessObjects mobile for BlackBerry”. 

Leave “Set Application Permission” unchecked.  Click Download. 

After it has finished downloading the application, click OK. 

Configure the Mobile Services

For SAP BusinessObjects Mobile to work properly, the Mobile Authentication Server (VAS) and Mobile Processing Server (VMS) must be configured.  In SAP Mobile 4.0, this is made very simple through a configuration tool called “Mobile Server Configuration Tool” which can be launched through Start > Programs > SAP BusinessObjects Enterprise XI 4.0 > SAP BusinessObjects Enterprise Mobile > Mobile Server Configuration Tool

Follow the next screens to complete the configuration.


The VAS and VMS server are now configured properly. 

Connecting SAP BI Mobile to Enterprise 

The next step is to run the installed SAP BI Mobile application from the BlackBerry simulator and then connect it to the Enterprise system. 

The Application can be accessed through the Main Menu

Once Launched, select Connect to Server.  

Click the BlackBerry Button to bring up the context menu.

Select Connection Settings

Notice that the same IP address is used for the Mobile Server and the CMS Name.  This is because the VAS and VMS services are located on the same machine as the Central Management System (CMS). 

Click the BlackBerry button again and then save the configuration. 

Input the username and password to access the CMS system. 

Click the BlackBerry Button and then select Login.

You should see the following menu when connected successfully. 

  • No labels