BusinessObjects Mobile Interactive Viewing - Archive€¦ · BusinessObjects Mobile Interactive...

BusinessObjects Mobile Interactive Viewing

Installing and configuring BusinessObjects Mobile

Overview This guide provides information and instructions for setting up BusinessObjects Mobile Interactive Viewing (Mobi) on BusinessObjects Enterprise XI Release 2. This allows your wireless clients to access reports that are designed for wireless devices. This guide covers server component deployment for UNIX and Windows, the installation of an emulator (Blackberry), and configuration of the client piece.

Contents INTRODUCTION............................................................................................1 ENABLING BUSINESS OBJECTS MOBILE INTERACTIVE VIEWING ON YOUR SERVER......................................................................................................1

Install BusinessObjects Enterprise XI R2 Service Pack 2 ...........................1 Deploy the Mobile Web Services Package....................................................1

mobiwar.xml file contents on Windows ...................................................... 1 mobiwar.xml file contents on UNIX............................................................. 2 Verifying the Mobile Web Services Package has been deployed ............. 2

Configure the Over the Air Loader ..............................................................3 Customize the OTA JAD file for your CMS (optional)...............................4

If you choose, you can customize the JAD file that is sent to mobile clients when they install the client component. This allows you to pre-configure the program for your CMS. Here is a sample script:............................................................................................. 4

LOADING SAMPLE MOBILE REPORTS ON YOUR SERVER................................5 INSTALLING, TESTING, AND OPERATING THE WIRELESS CLIENT....................5

Handling Variations in Wireless Clients ....................................................6 BlackBerry 8700c client simulator...............................................................6

Java Development Kit (JDK) 5.0.................................................................... 7 BlackBerry Email and MDS Services Simulator.......................................... 7 BlackBerry Device Simulator......................................................................... 7

STARTING THE WIRELESS DEVICE SIMULATOR .............................................7 INSTALLING THE BUSINESS OBJECTS MOBILE INTERACTIVE VIEWING APPLICATION ..............................................................................................8

8/9/2007 2:03 PM Copyright © 2007 Business Objects. All rights reserved.

BusinessObjects Mobile Interactive Viewing Installing and configuring BusinessObjects Mobile

LOGGING IN TO THE BUSINESS OBJECTS ENTERPRISE XI R2 FROM YOUR WIRELESS DEVICE OR SIMULATOR.............................................................11 VIEWING MOBILE REPORTS .......................................................................12

Connecting to the Business Objects Test Server .......................................12 Connecting to your Own Business Objects Enterprise XI R2 Server.......13

TROUBLESHOOTING BUSINESS OBJECTS MOBILE ......................................15 Common Issues ..........................................................................................15 Adding MIME Types ................................................................................16

FINDING MORE INFORMATION .....................................................................16

8/9/2007 2:03 PM Copyright © 2007 Business Objects. All rights reserved.

bo_mobi_interactive_viewing_quick_install.pdf


Introduction This document provides quick overview of the basic steps to enable BusinessObjects Mobile Interactive Viewing on your BusinessObjects Enterprise XI R2 server and wireless devices.

Enabling Business Objects Mobile Interactive Viewing on your Server

There are several steps to enable BusinessObjects Mobile Interactive Viewing on a Windows based BusinessObjects Enterprise XI R2 server.

Install BusinessObjects Enterprise XI R2 Service Pack 2 The first is to install Business Objects Enterprise XI R2 Service Pack 2 as the BusinessObjects Mobile server can only be installed on top of BusinessObjects Enterprise XI R2 Service Pack 2.

Deploy the Mobile Web Services Package BusinessObjects Mobile is enabled through web services. The web services package is deployed from the dswsbobje-mobile.war file. The BusinessObjects Mobile zip file contains the dswsbobje-mobile.war file. For consistency, it is best to place the dswsbobje-mobile.war file in the same directory as the other BusinessObjects XI R2 WAR files. Here are the following recommended paths for Windows and UNIX environments: • Windows - C:\Program Files\Business Objects\BusinessObjects

Enterprise 11.5\java\applications

• UNIX - /path/to/xir2/bobje/enterprise115/java/applications

Quickly deploy this WAR file in Tomcat using an XML descriptor as you would with other WAR files. Tomcat has a configuration directory filled with XML files for each application, and all you need to do is add an XML descriptor for Mobi. To deploy the web services package from your Apache Tomcat server, a reference to it is loaded from an XML file that is located in the localhost subdirectory of your Tomcat server. mobiwar.xml file contents on Windows For Windows, create a mobiwar.xml file and enter the following contents:

8/9/2007 2:03 PM Copyright © 2006 Business Objects. All rights reserved. Page 1



Figure 1

Save this XML file to the Tomcat web application configuration directory, which by default is: C:\Program Files\Business Objects\Tomcat\conf\Catalina\localhost. mobiwar.xml file contents on UNIX For UNIX, create a mobiwar.xml file and enter the following contents:

Figure 2

Save this XML file to /path/to/xir2/bobje/tomcat/conf/Catalina/localhost.

NOTE The docBase attribute tells Tomcat where to find the web services package for BusinessObjects Mobile.

Verifying the Mobile Web Services Package has been deployed When this mobiwar.xml file is saved to the localhost directory, Tomcat will automatically recognize it and will deploy BusinessObjects Mobile (Mobi) for you. To verify that the web service protocol has been enabled, in a browser go to http://:/mobi. The server name will be your hostname, and on Windows the port is typically 8080. The page that opens will show if you have been successful in setting up AXIS. AXIS is an implementation of the Simple Objects Axis Protocol (SOAP) that web services uses to transfer data.



http://:/mobi


Figure 3

Configure the Over the Air Loader The Over the Air Loader (OTA) component allows wireless devices to download and install the client application to enable mobile interactive viewing. The OTA component is contained in a folder named OTALoader in your BusinessObjects Mobile zip folder, which is part of your installation package. Depending on whether you are using Windows and UNIX, copy the OTALoader folder to one of the following directories: • Windows - C:\Program Files\Business

Objects\Tomcat\webapps\mobi

• UNIX - /path/to/xir2/bobje/tomcat/webapps/mobi

Once the OTALoader package is in place, you can access it at: http://servername:8080/mobi/OTALoader/index.html

The links available at this page will be similar to:




Figure 4

Customize the OTA JAD file for your CMS (optional) If you choose, you can customize the JAD file that is sent to mobile clients when they install the client component. This allows you to pre-configure the program for your CMS. Here is a sample script: Manifest-Version: 1.0 MIDlet-Version: 11.5.42 MIDlet-Jar-Size: 45188 RIM-COD-URL-4: Mobi-4.cod RIM-COD-SHA1-4: 8f 3c 0a 50 7b da 75 a0 22 40 ef f1 8b 85 f0 a1 49 fa 97 3a RIM-COD-URL-3: Mobi-3.cod Created-By: 1.4.2_08-b03 (Sun Microsystems Inc.) RIM-COD-SHA1-3: 5f 03 2f bd 1c 7c fc cb f9 89 61 aa 9f 23 19 34 94 6a 51 f1 RIM-COD-URL-2: Mobi-2.cod MicroEdition-Configuration: CLDC-1.1 MIDlet-Jar-URL: Mobi.jar RIM-COD-Module-Dependencies: net_rim_cldc,net_rim_pdap RIM-COD-SHA1-2: fc 1f 82 24 52 c8 b7 b2 85 83 ab 00 a5 5e 9e 90 a0 7c 32 1f RIM-COD-URL-1: Mobi-1.cod MOBI_WS_URL: http://bm-winsp2:8080/dswsbobje/services RIM-COD-Size-4: 106680 RIM-COD-SHA1-1: a9 35 07 c2 6d e0 a0 a9 66 1d 89 2a 16 a6 55 c8 c5 0e 8d 6f RIM-COD-Size-3: 44816 RIM-COD-Size-2: 82616 RIM-COD-Size-1: 88632 RIM-COD-Module-Name: Mobi RIM-COD-Size: 91076 MIDlet-Name: Business Objects Mobile Interactive Viewing RIM-COD-Creation-Time: 1175654212 MIDlet-1: BusinessObjects Mobile, App.png,




com.bo.mobi.client.MobiMIDlet RIM-COD-URL: Mobi.cod MOBI_UPDATE_URL: http://bm-winsp2:8080/mobi/OTALoader/BlackBerry/Mobi.jad RIM-COD-SHA1: b6 d0 b6 ac 07 b3 02 da c1 66 36 af d1 21 b0 bb 99 54 4c fa MicroEdition-Profile: MIDP-2.0 MIDlet-Vendor: Business Objects Ant-Version: Apache Ant 1.6.5 MOBI_CMS: bm-winsp2:6400

Loading Sample Mobile Reports on your Server Once mobile interactive viewing has been enabled on your server, you can install sample mobile reports. These reports can be loaded from the MOBI_Test_Report_Samples.biar file. It can be found in the ReportSamples folder that is included with the BusinessObjects_Mobile_XI_R2 install package. The BIAR file contents can be imported using the Business Objects Enterprise XI R2 Import Wizard by doing the following:

1. Click Start > BusinessObjects XI Release 2 > BusinessObjects Enterprise > Import Wizard.

2. Select Business Intelligence Archive Resource (BIAR) File in the Source drop-down list.

3. In the BIAR file text box click the …button on the right to launch the Open dialog.

4. Navigate to the BIAR file, select it, and click the Open button.

5. Click the Next button and the Destination Environment dialog appears prompting you to enter the CMS name and login information.

6. Click the Next button and advance through each dialog choosing all defaults until you reach the Folders and objects dialog.

7. In this dialog, select the Mobile folder, click Next and choose all defaults that follow

8. When you reach the Ready to Import dialog click Finish to load the BIAR file.

NOTE If you are successful these samples will be available on your server to view on your wireless devices or on your wireless device simulators.

Installing, Testing, and Operating the Wireless Client A wireless device simulator allows you to simulate the behavior of a wireless device from your PC so you do not actually need to have the actual physical hardware to test it. The simulator may not always show the true behavior of the actual device but, for testing, it is often a good approximation of how the wireless device will respond.




Handling Variations in Wireless Clients The wide variation in menus and controls for wireless devices can have a significant impact on the steps needed to complete each task. As a result, the work flow described in this document will vary depending on the wireless device you are using.

BlackBerry 8700c client simulator The BlackBerry 8700c client simulator is used for this demonstration. This client simulator is shown here:

Figure 5

NOTE For this device simulator, to delete text on a line, press the down arrow key on the keyboard to move the cursor down to the line that follows. Then press the up arrow key on the keyboard to move back to the original line. This will position the cursor at the end of the original line. With the cursor positioned at the end of the line, you can use the Backspace key on your keyboard to delete the unwanted characters in it.

There are three items required to load and run the BlackBerry Device Simulator discussed ion the next three sections.




Java Development Kit (JDK) 5.0 The BlackBerry Email and MDS Services Simulator requires JDK 5.0 to be present or it will not install. The JDK 5.0 can be obtained at the link below:

http://java.sun.com/j2se/1.5

NOTE On UNIX machines, you must set your JAVA_HOME environment variable for the MDS to work. The Windows installer will usually do this for you.

BlackBerry Email and MDS Services Simulator The BlackBerry Device Simulator will only work properly if the BlackBerry Email and MDS Services Simulator is running. The BlackBerry Email and MDS Services Simulator version 4.1.0.359 has been used for this demonstration. You can download this application from the link below:

https://www.blackberry.com/Downloads/browseSoftware.do BlackBerry Device Simulator For this demonstration, the BlackBerry Device Simulator 4.1.0 is used. The installer for this application can be downloaded to your PC. You can download it from the link below:

https://www.blackberry.com/Downloads/browseSoftware.do

Starting the Wireless Device Simulator To enable BusinessObjects Mobile Interactive Viewing from your BlackBerry simulator, you must first start the BlackBerry Email and MDS Services Simulator.

NOTE If you are using a different wireless device simulator (other than BlackBerry) you likely will not need a wireless services simulator. Check your simulator kit for details.

To start your BlackBerry Email and MDS Services Simulator click Start > Research in Motion > Blackberry and Email Device Simulators 4.1.0 > MDS. Once selected, a command prompt window will appear. When start up is complete, the command prompt window will show “pending push messages” at the prompt as in the picture on the next page.



http://java.sun.com/j2se/1.5https://www.blackberry.com/Downloads/browseSoftware.dohttps://www.blackberry.com/Downloads/browseSoftware.do


Figure 6

Now you can start your BlackBerry Device Simulator. Click Start > Research in Motion > Blackberry Device Simulators 4.1.0 > Device Simulators 4.1.0.359 > 8700c.

Installing the Business Objects Mobile Interactive Viewing Application

The BusinessObjects Mobile Interactive Viewing Application is a J2ME midlet. This application can be downloaded from your BusinessObjects server to your wireless device or your wireless device simulator from

http://servername:8080/mobi/mobiloader

Here are the steps to download it:

1. Access the browser from the main page by scrolling the thumbwheel until the globe icon is highlighted if you are using the BlackBerry Device Simulator for model 8700c.

Figure 7




2. Left-click the mouse on the thumbwheel to open the Bookmarks page:

Figure 8

3. Left-click the thumbwheel again, while Home Page is selected, to show several options. You can use the down arrow key on your keyboard to navigate to the Go To option.

Figure 9

4. Select the Go To option by left-clicking the thumbwheel. This will launch the Bookmarks screen where you can type in the link:

http://servername:8080/mobi/OTALoader/

NOTE Once this URL has been entered, you can go there from your BlackBerry by left-clicking the thumbwheel and choosing OK.

5. While the BlackBerry Version link is highlighted, left-click the thumbwheel and select Get Link.

NOTE Download the BlackBerry Version if you are using the BlackBerry device simulator.




Figure 10

6. Left-clicking the thumbwheel while the Download button is selected will initiate the download.

Figure 11

NOTE If you do not see this screen, you may need to set up MIME types. See Appendix B.

7. Select Yes to indicate that the source is trusted if you are downloading from the server that you installed.

Figure 12




8. If the viewer install is successful, you should see the following window that confirms success:

Figure 13

Logging in to the Business Objects Enterprise XI R2 from your Wireless Device or Simulator

After you have installed the J2ME midlet on your wireless device or wireless device simulator, you will be able to login to BusinessObjects Enterprise from your wireless device or wireless device simulator. To login, navigate to the Applications folder. For the BlackBerry, scroll to the Applications folder highlighted in the main menu and left-click the thumbwheel to open it:

Figure 14




The BusinessObjects icon should now appear in the Applications directory on the right as shown below:

Figure 15

Viewing Mobile Reports If you select the BusinessObjects icon, by left-clicking the thumbwheel on the BlackBerry, your wireless device will load the default login information that is configured with the install. The User name and Password for this case are mobile and mobile. Figure 16

Connecting to the Business Objects Test Server If you wanted, you could actually test your wireless device and view mobile reports located on the Business Objects test server. You can login to the test server if you scroll down to the Login option and select it.

Figure 17




The default connection options that are set for the Business Objects test server when you download and install the J2ME midlet are below:

Options Values

CMS Name URL of Root Services Authentication Type Mobi Update URL

Sofia http://uws.businessobjects.com/ws-sofiaEnterprise (default) http://uws.businessobjects.com/mobiloader/BlackBerry/Mobi.jad

If you select Connection options from the Login window to view the default connection information you would see:

Figure 18

Connecting to your Own Business Objects Enterprise XI R2 Server From the Login window on your wireless device, if instead you click the thumbwheel and then select Connection Options, you can change your connection information to direct your wireless device to your server. For this demonstration, your connection would be similar to below:

Options Values

CMS Name URL of Root Services Authentication Type Mobi Update URL

host machine name unless you have assigned a different name to the Central Management Server. http://yourservername:8080/dswsbobje/servicesEnterprise (default) http://yourservername:8080/mobi/OTALoader/BlackBerry/Mobi.jad



http://uws.businessobjects.com/ws-sofiahttp://uws.businessobjects.com/mobiloader/BlackBerry/Mobi.jadhttp://uws.businessobjects.com/mobiloader/BlackBerry/Mobi.jadhttp://yourservername:8080/dswsbobje/serviceshttp://yourservername:8080/mobi/OTALoader/BlackBerry/Mobi.jadhttp://yourservername:8080/mobi/OTALoader/BlackBerry/Mobi.jad


Once you adjust the Connection options for your server, the Connection options screen for your wireless device will similar to that shown below:

Figure 19

After you have entered your login information, when selecting Login you will be directed to the Business Objects mobile samples folders. Here you will see folders that contain mobile reports:

Figure 20

From here, you can open a folder and select a report for viewing:

Figure 21

If successful, you will be able to view the report. You can view it by clicking the thumbwheel while a report is selected and choosing Open. This should open the report in the wireless device window.




Troubleshooting Business Objects Mobile This section includes tips for troubleshooting common problems with setting up Business Objects Mobile.

Common Issues The following table describes an error message that can be encountered and three causes and solutions to fix it.

Problem JVM Error 104 – Uncaught: Proxy Exception

Possible Cause Your CMS name is specified incorrectly.

Fix Check your connection options in Mobi

Possible Cause Your emulator device lost its connection to the MDS server, or the MDS server has crashed.

Fix Try turning off your wireless, then turn it on and try to log in again. When you turn on the wireless, the MDS server dos window should show start up activity and then display “pending push messages”. Failing that, try to restart the MDS server emulator

Possible Cause Your Mobi WAR file is not deployed on the server properly

Fix Verify that your services are deployed: http://myserver:8080/mobi/services (Do not use a “/” at the end of the URL, you are not requesting a directory)



http://myserver:8080/mobi/services


Adding MIME Types If you have trouble downloading the viewer application to your client device, you may need to set up mime types in your web application server. In Tomcat, which we are using here do the following:

1. Open the $TOMCAT_HOME/conf/web.xml file.

2. Add the following three MIME type declarations at the end of section of the file: jad text/vnd.sun.j2me.app-descriptor jar application/java-archive cod application/vnd.rim.cod

3. Save and close the file.

NOTE For more detail or for IIS instructions, see Chapter 2 of the xir2_mobi_admin_en.pdf guide.

Finding more information For more information and resources, refer to the product documentation and visit the support area of the web site at: http://www.businessobjects.com/

If you require a detailed explanation on configuring Business Objects Mobile such as advanced configuration for SSL communication and best practices read the following product guides:

xir2_mobi_user_en.pdf

xir2_mobi_admin_en.pdf



http://support.businessobjects.com/documentation/product_guides/download.asp?manual=boexir2/en/xir2_mobi_admin_en.pdfhttp://www.businessobjects.com/http://support.businessobjects.com/documentation/product_guides/download.asp?manual=boexir2/en/xir2_mobi_user_en.pdfhttp://support.businessobjects.com/documentation/product_guides/download.asp?manual=boexir2/en/xir2_mobi_admin_en.pdf




http://www.businessobjects.com

OverviewContentsIntroductionEnabling Business Objects Mobile Interactive Viewing on yourInstall BusinessObjects Enterprise XI R2 Service Pack 2Deploy the Mobile Web Services Packagemobiwar.xml file contents on Windowsmobiwar.xml file contents on UNIXVerifying the Mobile Web Services Package has been deployed

Configure the Over the Air LoaderCustomize the OTA JAD file for your CMS (optional)If you choose, you can customize the JAD file that is sent t

Loading Sample Mobile Reports on your ServerInstalling, Testing, and Operating the Wireless ClientHandling Variations in Wireless ClientsBlackBerry 8700c client simulatorJava Development Kit (JDK) 5.0BlackBerry Email and MDS Services SimulatorBlackBerry Device Simulator

Starting the Wireless Device SimulatorInstalling the Business Objects Mobile Interactive Viewing ALogging in to the Business Objects Enterprise XI R2 from youViewing Mobile ReportsConnecting to the Business Objects Test ServerCMS NameURL of Root ServicesAuthentication Type

Connecting to your Own Business Objects Enterprise XI R2 SerCMS NameURL of Root ServicesAuthentication Type

Troubleshooting Business Objects MobileCommon IssuesAdding MIME Types

Finding more information

BusinessObjects Mobile Interactive Viewing - Archive€¦ · BusinessObjects Mobile Interactive...

Documents

Transcript of BusinessObjects Mobile Interactive Viewing - Archive€¦ · BusinessObjects Mobile Interactive...