Skip to end of metadata
Go to start of metadata

Introduction

This pattern uses the following three SAP BusinessObjects Mobile components:

  • SAP BusinessObjects Mobile client.
  • SAP BusinessObjects Mobile server.
  • SAP BusinessObjects Business Intelligence (BI) platform.

  • The mobile components are part of the SAP BusinessObjects Business Intelligence platform installer.
  • The following steps show how to install and deploy the SAP BusinessObjects Mobile solution on a distributed Web-tier solution.
  • This pattern uses iOS as the Mobile client. 

Prerequisites

To configure the system shown in the diagram, you will need these tools and configurations:

1) Access to BI Mobile and Explorer services.
2) Access to BI Mobile through Enterprise or Active Directory users.
3) Ability to load balance between Application Server Tier. 
4) Ability to work through a Firewall.

Workflow and further information

  1. Install the SAP Business Intelligence Mobile Server.
    Because this pattern uses a Web-Tier installation, the Mobile Servers must be enabled.  During the installation of the web-tier, you will select which features to install.
  2. Install the Mobile Plug-in.
    The Mobile Plug-in is needed by the CMS.
  3. Configure Tomcat to enable the Mobile client.
    You must add a category to enable Mobile to display reports.
  4. Install the SAP BusinessObjects Mobile app (client).
    This is done through the Apple App Store.

For information about using Mobile with AD authentication, a Load Balancer, and Firewals, see "Considerations" at the end of this topic.

To install the SAP Business Intelligence Mobile Server

Mobile services must be installed on the web-tier to offer the client connectivity to the Enterprise system.  If the feature "Mobile Services" is not enabled during the first installation, you can modify the installation and add the component later.

 
 
1) On the server that has the Web-Tier go to click Start > Control Panel > Programs and Features > SAP BusinessObjects BI Platform 4.0 SP4 , and then click Uninstall/Change. The "SAP BusinessObjects BI platform 4.0 SP4 setup" wizard opens.  Select the option to modify or change. 

2) On the "Select Features" page, select the Mobile Servers check box.

Make sure the SIA and other required services are selected in the Select Features screen when adding
the Mobile Servers to the application tier. If unselected, a required service may be inadvertently uninstalled from the server.

3) Proceed through the wizard to commit this change. 
    Enabling the "Mobile Servers" option creates a folder named Mobile 14 in the SAP BusinessObjects installation folder. 

4) Open the Mobile 14 folder, and copy these two .war files to the tomcat6/webapps folder: MobileBIService.war and MOBIServer.war.
    The .war files will be automatically deployed by Tomcat. 

5) To verify that the Mobile Server has been deployed, go to the this page to see if it displays the following result status:

http://winpb01:8080/MobileBIService/MessageHandlerServlet?message=GetVersion

 
 
SAP BI Mobile Server is now deployed. It will allow you to access reports through a mobile device using the SAP BusinessObjects Mobile app and the SAP BusinessObjects Explorer application, once the remaining components are installed and configured as shown here.

With the Support Package 5 release of the SAP BusinessObjects Mobile server, the files MobileBIService.war and MOBIServer.war will be automatically deployed.


To install the Mobile Plug-in

The Mobile Plug-in is required by the CMS.

1) In Windows, click Start > Control Panel > Programs and Features > SAP BusinessObjects BI Platform 4.0 SP4 , and then click Uninstall/Change.
     The "SAP BusinessObjects BI platform 4.0 SP4 setup" wizard opens.

2) On the "Select Features" page, select the CMS plugin for Mobile check box.

3) Proceed through the wizard to commit this change.

Note that the Mobile Plug-in must be installed on all Central Management Servers (CMS) on your system.

To configure Tomcat to enable the Mobile client

By defauilt, the Mobile will only show reports that are part of the Mobile category.  The Mobile category must be created manually. 

1) In the Central Management Console (CMC), go to Categories > Manage > New > Category, and type Mobile.

The category name in the CMC is case sensitive.  It must match the category in the config file exactly.   


We can now add a report into a category by going to the CMC > Folders > All Folders > Web Intelligence Samples . Right click the report and then select Categories. In Categories, select Mobile


To install SAP BusinessObjects Mobile Client

1) Go the the Apple App Store, do a search for “SAP BusinessObjects Mobile”, and download the latest version of the app.


2) On your device, start the application, and go to Settings > Create Connection.
3) Type the credentials needed to to connect to the Mobile Server, setting the Server URL to the Web Server and Load Balancer.


 
4) For the CMS Name, use the hostname and port of a CMS in the cluster.

 
5) When done, tap Add a Connection.
6) Connect to the server.
You will see the report that was saved in the Mobile category.

Considerations

Setting up Active Directory (AD) authentication with BI Mobile

SAP Mobile does support third-party authentication.  There is no explicit setup requirements for AD on Mobile.  Provided that BI Launchpad can be accessed through the AD user, this user account can access Mobile reports.

  • Note SSO is currently not supported.

Accessing Mobile Reports through a Load Balancer

SAP Mobile supports load balancers and web servers.  The supported types of persistence for Mobile reports are as follows:

  • Cookie-based persistence
  • IP-based Persistence

 Working With Firewalls and Mobile

The Mobile Server application deployed on Tomcat will need to communicate with the CMS, Web Intelligence Reporting Server, and the Adaptive Processing Server.

Troubleshooting


Users cannot view the reports but the Enterprise Administrator can

In this case, you must ensure that the users have access to the corporate category that was created. 

BI Mobile Reports do not display after upgrading

Ensure that the link shows the same version number as the CMS:

http://*winpb01:8080*/MobileBIService/MessageHandlerServlet?message=GetVersion

  • No labels