xi3 mobile admin en
TRANSCRIPT
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 1/56
Installing and Deploying
BusinessObjects Mobile
BusinessObjects Mobile
Windows
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 2/56
© 2008 Business Objects. All rights reserved. Business Objectsowns the following
U.S. patents, which may cover products that are offered and licensed by Business
Copyright
Objects: 5,555,403; 5,857,205; 6,289,352; 6,247,008; 6,490,593; 6,578,027;
6,831,668; 6,768,986; 6,772,409; 6,882,998; 7,139,766; 7,299,419; 7,194,465;
7,222,130; 7,181,440 and 7,181,435. Business Objects and the Business Objects
logo, BusinessObjects, Business Objects Crystal Vision, Business Process OnDemand, BusinessQuery, Crystal Analysis, Crystal Applications, Crystal Decisions,
Crystal Enterprise, Crystal Insider, Crystal Reports, Desktop Intelligence, Inxight,
the Inxight Logo, LinguistX, Star Tree, Table Lens, ThingFinder, Timewall, Let
there be light, Metify, NSite, Rapid Marts, RapidMarts, the Spectrum Design, Web
Intelligence, Workmail and Xcelsius are trademarks or registered trademarks in
the United States and/or other countries of Business Objects and/or affiliated
companies. All other names mentioned herein may be trademarks of their respective
owners.
Business Objects products in this release may contain redistributions of software
licensed from third-party contributors. Some of these individual components may
Third-party
Contributorsalso be available under alternative licenses. A partial listing of third-party
contributors that have requested or permitted acknowledgments, as well as required
notices, can be found at: http://www.businessobjects.com/thirdparty
2008-02-08
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 3/56
ContentsAbout the BusinessObjects Mobile Installation and Deployment
Guide 5
Chapter 1
The information in the BusinessObjects Mobile installation guide...............6
Target audience for the BusinessObjects Mobile installation guide.............6
Introducing BusinessObjects Mobile 9Chapter 2
BusinessObjects Mobile overview.............................................................10
BusinessObjects Mobile business intelligence features.......................11
BusinessObjects Mobile deployment and administration features.......13
How BusinessObjects Mobile works..........................................................14
Supported Platforms.............................................................................16
Server requirements.............................................................................17
Device prerequisites and device type support.....................................17
What's new in this release.........................................................................17
Installing and Configuring BusinessObjects Mobile 19Chapter 3
BusinessObjects Mobile deployment checklist..........................................20
Recommended deployment architecture...................................................21
Deploying Mobile server components..................................................22
Deploying the client OTA web application components ......................23
Installation package contents....................................................................23
Installed file description and location...................................................25
Server-side installation..............................................................................27
Installing BusinessObjects Mobile on Windows...................................27
Installing alert and status icons for Web Intelligence documents.........28
Installing background images as templates for device screens...........29
Installing and Deploying BusinessObjects Mobile 3
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 4/56
Server-side configuration...........................................................................30
To configure the Mobile server.............................................................30
Setting up the Mobile Administration database....................................32
Deploying with a BlackBerry Enterprise Server (BES).........................33
Standard deployment with a proxy server............................................34
To start the Mobile servers manually....................................................35
To use a device simulator for testing....................................................35
To migrate BusinessObjects Mobile version 1 to version 2..................36
Deploying the client OTA download web application.................................36
Deploying the war file...........................................................................37
Setting the required MIME types on the application server..................38Client installation........................................................................................39
Automated deployment to mobile devices...........................................39
Setting up administration and security rights 41Chapter 4
Managing security rights for mobile users and documents.......................42
Tracking user activity.................................................................................42
Troubleshooting Information 43Chapter 5
Logging and tracking errors on the Mobile server.....................................44
To reload log levels...............................................................................44
To trigger the log dump remotely..........................................................45
Tracking device errors...............................................................................45
Standard troubleshooting tips....................................................................45
Network unavailable errors........................................................................46
Get More Help 49Appendix A
Index 53
4 Installing and Deploying BusinessObjects Mobile
Contents
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 5/56
About the BusinessObjectsMobile Installation and
Deployment Guide
1
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 6/56
The information in the BusinessObjects
Mobile installation guideThis guide provides information about BusinessObjects Mobile features and
technology, and gives instructions on how to deploy the application as part
of a BusinessObjects Enterprise deployment. It includes:
• descriptions of the deployment scenarios supported by Business Objects
for BusinessObjects Mobile.
• information on how to provide a secure wireless network to transfer
business intelligence data to mobile device users.
• step-by-step instructions on how to install and deploy the BusinessObjects
Mobile server components on top of BusinessObjects Enterprise for each
supported platform.
• step-by-step instructions on how to deploy the client application for
BusinessObjects Mobile to supported mobile devices via a corporate web
site.
• information on how to set up and manage user rights.
• information on key administration tasks, such as pushing documents to
mobile users, subscribing users to alerts, tracking server and device
activity, and troubleshooting your BusinessObjects Mobile system.
Note: Instructions on how to download the BusinessObjects Mobile client
application to a mobile device from a corporate web site page are provided
in the Using BusinessObjects Mobile guide.
Related Topics
• Recommended deployment architecture on page 21
Target audience for the BusinessObjectsMobile installation guide
This guide is designed to help the following administrators set up and manage
a Business Objects business intelligence deployment that caters to users of
mobile devices:
• IT administrators, who install and configure the Mobile server and the
Mobile server database.
6 Installing and Deploying BusinessObjects Mobile
About the BusinessObjects Mobile Installation and Deployment Guide
1 The information in the BusinessObjects Mobile installation guide
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 7/56
• Business intelligence administrators, who deploy BusinessObjects
Enterprise XI 3.0, to plan and manage how business intelligence data
and applications are deployed and managed enterprise wide, and who
manage BI documents, folders and alerts for Mobile users.
• IT security managers, who guarantee that business intelligence datacommunicated via the internet and wireless networks remains secure, to
manage Mobile client access to the server, and to manage the security
policy of the Mobile server.
• Email/mobile administrators, who configure the BlackBerry Enterprise
server and Mobile proxy server.
Related Topics
• BusinessObjects Mobile overview on page 10
Installing and Deploying BusinessObjects Mobile 7
1About the BusinessObjects Mobile Installation and Deployment Guide
Target audience for the BusinessObjects Mobile installation guide
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 8/56
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 9/56
Introducing BusinessObjectsMobile
2
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 10/56
BusinessObjects Mobile overview
BusinessObjectsMobile consists of a client-side application formobile devicesand a Mobile server component that communicates with the BusinessObjects
Enterprise server, so that professionals on the move can access business
intelligence information from a mobile device, such as a smartphone or PDA.
The application is designed specifically to meet the screen size and
interactivity constraints of mobile devices. Business intelligence documents,
reports and analytics are displayed on supported mobile devices with native
rendering, single-click access and device-appropriate user interactivity.
BusinessObjects Mobile is a java application of approximately 1 mb that you
download to your mobile device. This application exists in different versions
for the following device types:
• BlackBerry
Although BusinessObjects Mobile can work on data networks like GSM and
GPRS; EDGE, 3G or 3G+ networks offer the best performance.
Related Topics• BusinessObjects Mobile business intelligence features on page 11
• Device prerequisites and device type support on page 17
10 Installing and Deploying BusinessObjects Mobile
Introducing BusinessObjects Mobile
2 BusinessObjects Mobile overview
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 11/56
BusinessObjects Mobile business intelligencefeatures
Using BusinessObjects Mobile, professionals on the move can analyze,
interact, and be alerted about changes to critical data related to their business
interest easily at any time.
Related Topics
• Supported documents on page 11
• Supported business intelligence functionality on page 11
Supported documents
BusinessObjectsMobile provides users of a mobile devicewith remoteaccess
to the following types of business intelligence document:
• Web Intelligence documents
• Crystal Reports documents
• Some gauge analytics (including speedometers, barometers, and
thermometers)
Note: For details on which document versions that BusinessObjects Mobile
supports, go to http://support.businessobjects.com/documentation/support ed_platforms/default.asp.
Depending on the document type, you can view, analyze and interact with
the data it contains in a variety of ways.
Related Topics
• Supported business intelligence functionality on page 11
Supported business intelligence functionality
Using BusinessObjects Mobile, you can leverage a wide range of features
and functionality to manage your Business Intelligence documents and data.
Key features include the ability to:
• Set up a default document or folder that opens automatically whenever
you log into the application.
Installing and Deploying BusinessObjects Mobile 11
2Introducing BusinessObjects Mobile
BusinessObjects Mobile overview
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 12/56
• Refresh reports to retrieve the most up-to-date data.
• View results using zoom and navigational shortcuts.
• Drill on results to analyze detailed or summary data.
• Navigate to related documents via hyperlinks on reports.• Change how results are filtered by modifying prompt values.
• Receive alerts when a specific document is modified, a condition is met,
or a schedule is run.
• Take follow-up actions by clicking on report cells to launch an SMS, phone
call or email.
• Save and consult documents offline to mitigate network interruptions and
minimize communication costs.
Functional limitations
BusinessObjects Mobile presents some functional limitations, due to thetechnical and design constraints of mobile devices:
• BusinessObjects Mobile is not guaranteed to work on all mobile devices
and operating systems. For the list of supported devices and operating
systems, see: http://support.businessobjects.com/documentation/support
ed_platforms/default.asp.
• Report data sets can be large and can theoretically saturate available
device memory. The unsatisfactory display of large data sets can be
mitigated by designing smaller report views.
Detailed information on the supported document features that can beleveraged using BusinessObjects Mobile is provided in the Using
BusinessObjects Mobile guide: Best practices for mobile document design
section. BusinessObjects Mobile supports Web Intelligence documents,
Crystal reports and some analytics, with some functional limitations.
Related Topics
• Device prerequisites and device type support on page 17
• Supported documents on page 11
Report creation recommendations
Although BusinessObjectsMobile can display any Web Intelligencedocument
or Crystal report, user experience is best when reports are written specifically
for easy reading and navigation on a small screen. You can find best practice
information on how to design reports targeted at mobile end users in the
12 Installing and Deploying BusinessObjects Mobile
Introducing BusinessObjects Mobile
2 BusinessObjects Mobile overview
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 13/56
Using BusinessObjects Mobile guide: Best practices for mobile document
design section.
BusinessObjects Mobile deployment andadministration features
The BusinessObjects Mobile package includes components designed to
facilitate the deployment and administration tasks that IT and business
intelligence Administrators need to perform when catering to mobile users.
Ease of deployment
IT Administrators responsible for installing and deploying the application canleverage the following deployment features:
• Deploy a secure web site so that users can download and install the
BusinessObjects Mobile client application Over-The-Air (OTA).
• Deploy the Mobile server and a proxy server or BlackBerry Enterprise
Server.
Ease of administration
Business intelligence administrators responsible for managing business
intelligence applications and content can leverage the following administration
features:
• Set up a group of mobile users with secured access to business
intelligence content on a Business Objects Enterprise server.
• Track user activity, for example the devices used and user login
information, to provide statistical information about how BusinessObjects
Mobile is being used.
• Design content specifically for the targeted mobile devices.
Note: Power users with experience in designing Web Intelligence
documents and Crystal Reports can also design mobile content. For full
information on designing these documents and reports for mobile
consumers, see the Using BusinessObjects Mobile guide:Best practices
for mobile document design section.
Installing and Deploying BusinessObjects Mobile 13
2Introducing BusinessObjects Mobile
BusinessObjects Mobile overview
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 14/56
Related Topics
• Automated deployment to mobile devices on page 39
• Tracking user activity on page 42
How BusinessObjects Mobile works
The BusinessObjects Mobile solution includes server components that need
to be installed next to BusinessObjects Enterprise XI 3.0, plus a client
application formobile devices.A BusinessObjects Mobiledeployment consists
of the following client and server components:
• BusinessObjects Enterprise XI 3.0 server
• BusinessObjects Mobile server, including the BusinessObjects Mobile
server database• BusinessObjects Mobile client application on mobile devices
In addition, if you are deploying BusinessObjects Mobile to BlackBerry
devices, Business Objects recommends that you also deploy the BlackBerry
Enterprise Server (BES).
BusinessObjects Enterprise XI 3.0
The standard BusinessObjects Enterprise XI 3.0 server is packaged with
two BusinessObjects SDKs (the Report Engine SDK and the Crystal
Enterprise SDK). The BusinessObjects Enterprise server exposes corporatedata captured from corporate databases and data warehouses through
business intelligence documents, and handles the document lifecycle
(creation, catalog, refresh, content delivery and report interactivity). Users
access data through the server portal.
BusinessObjects Mobile relies on the BusinessObjects Enterprise SDKs to:
• authenticate the user
• provide folder and document access
• provide open, refresh, navigate, and drill functionality
• expose gauges
• expose remote action functionality
The BusinessObjects Mobile package includes some report design best
practice documentation, to help document creators design business
intelligence content that displays correctly on supported mobile devices.
14 Installing and Deploying BusinessObjects Mobile
Introducing BusinessObjects Mobile
2 How BusinessObjects Mobile works
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 15/56
BusinessObjects Mobile server
The Mobile server is installed on the corporate intranet and passes requests
and answers between the BusinessObjects Enterprise server and Mobile
clients. The BusinessObjects Mobile server comprises two servers:• Mobile authentication server -- manages user access and security policy,
and records user logs.
This information can be used as source data for reports on your mobile
user activity.
• Mobile job server -- stores details about each synchronization operation
performed by a device with business intelligence content published to the
BusinessObjects Enterprise server.
Data from both servers is stored in the Mobile server database.
BusinessObjects Mobile server database
The BusinessObjects Mobile server database stores data on user activity
and the status on synchronization between the BusinessObjects Enterprise
server, the Mobile server, and the devices. It contains one row for every
record on the device for each user, so there are a lot of rows, but little data
in each row.
BusinessObjects Mobile supports a subset of the database platforms and
versions supported by BusinessObjects Enterprise XI 3.0. A pre-configured
Apache Derby database is delivered with BusinessObjects Mobile.
Note: It is recommended you plan for 2 KB of memory per user that connects
to the mobile server.
BusinessObjects Mobile client
The Mobile client is a J2ME application that must be download to each mobile
device. The Mobile client application enables business intelligence content
access, rendering, and navigation from a mobile device. It is also triggers
selected server actions on documents such as refresh or drill.BusinessObjects Mobile can read any Web Intelligence document or Crystal
report and most Dashboard and Analytics gauge analytics. However, it is
best to design documents to fit the constraints of mobile device displays.
Installing and Deploying BusinessObjects Mobile 15
2Introducing BusinessObjects Mobile
How BusinessObjects Mobile works
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 16/56
The Mobile client also supports secured local storage for downloading and
storing local copies of Web Intelligence documents, Crystal Reports and
supported analytics on the mobile device.
The Mobile client application also allows you to subscribe to alerts ondocuments that have been modified on the server or have alerters configured.
Supported alerts include alerts on the device when:
• the server document is modified
• a data condition is met when the server document is modified
• the schedule of a document is executed
The alert mechanism allows the display of an alert description and a link to
the related document on the device. Depending on the device, an alert can
trigger a sound, vibration or flashing light on the screen. Alerts also enable
users to store the document related to the alert on the device.
The communication between the Client Application and the BusinessObjects
Enterprise Server is through a secured proprietary transport protocol.
For the latest list of supported platforms and devices, see: http://support.busi
nessobjects.com/documentation/supported_platforms/default.asp.
Related Topics
• BusinessObjects Mobile deployment checklist on page 20
• Device prerequisites and device type support on page 17
• Setting up the Mobile Administration database on page 32• Deploying with a BlackBerry Enterprise Server (BES) on page 33
Supported Platforms
The BusinessObjects Mobile application is delivered as a plug-in to
BusinessObjects Enterprise XI 3.0. The application includes server
components designed to work on the following platforms:
• Microsoft Windows
For detailed information about platform requirements for each of the
BusinessObjects Mobile supported platforms, see: http://support.businessob
jects.com/documentation/supported_platforms/default.asp.
16 Installing and Deploying BusinessObjects Mobile
Introducing BusinessObjects Mobile
2 How BusinessObjects Mobile works
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 17/56
Related Topics
• Server requirements on page 17
• Server-side installation on page 27
Server requirements
BusinessObjects Mobile is delivered as an add-on to an existing
BusinessObjects Enterprise XI 3.0 deployment. To leverage functionality
designed specifically for mobile users, it is necessary to deploy the following
server components on top of BusinessObjects Enterprise XI 3.0:
• Mobile server (composed of an authentication server and a job server)
• Database server that logs user activity and provides information on the
synchronization of data between the BusinessObjects Enterprise server and devices
• If you are deploying the application to BlackBerry devices users, Business
Objects recommends that you include the BlackBerry Enterprise Server
(BES) in your deployment. If you are not, you can deploy a proxy server
to handle communication between the BusinessObjects Enterprise server
and client devices
Related Topics
• How BusinessObjects Mobile works on page 14
• Recommended deployment architecture on page 21
Device prerequisites and device type support
For the list of supported platforms and devices see: http://support.busines
sobjects.com/documentation/supported_platforms/default.asp.
Although BusinessObjectsMobile canwork on data infrastructures like GPRS,
the best performance is experienced on 3G, 3G+ or EDGE networks.
What's new in this release
This release of BusinessObjects Mobile introduces powerful new features
to improve your business intelligence deployment for mobile users.
Installing and Deploying BusinessObjects Mobile 17
2Introducing BusinessObjects Mobile
What's new in this release
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 18/56
New server features
• Uses Business Objects SDKs (Web Intelligence report Engine SDK and
Crystal Enterprise SDK) instead of Web Services.
• Works as an add-on to BusinessObjects Enterprise XI 3.0.• Delivers new integrated server components for: security, alerting, and
synchronization with the BusinessObjects Enterprise server.
New client features
• Provides the ability for users of mobile devices to work offline, on
documents stored locally on the device, without being connected to the
server.
• Allows users to subscribe to alerts that notify the device of specific
modifications to documents and document alerters.• Supports interaction with Crystal reports.
• Allows mobile users to leverage the new tracking feature in Web
Intelligence documents, where changes compared to a previous version
of the document are highlighted.
New administration features
• The server database tracks user and device activity.
Comparing versions 1 and 2
Mobile version 2Mobile version 1
Based on XI 3.0Based on XI Release 2
Uses SDKUses Web Services
Works only with BlackBerry devicesWorks with any J2ME MIDP/CLDC de-
vices
Related Topics• BusinessObjects Mobile overview on page 10
18 Installing and Deploying BusinessObjects Mobile
Introducing BusinessObjects Mobile
2 What's new in this release
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 19/56
Installing and ConfiguringBusinessObjects Mobile
3
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 20/56
BusinessObjects Mobile deployment
checklistThis checklist provides an overview of the steps you need to accomplish to
complete a successful installationand deployment of BusinessObjectsMobile.
It is recommended you read this checklist before beginning the installation
procedure.
1. Visit the Business Objects Supported Platforms web site at: http://sup
port.businessobjects.com/documentation/supported_platforms/default.asp .
2. Install and configure BusinessObjects Enterprise XI 3.0.
Refer to the BusinessObjects Enterprise XI 3.0 Installation and
Configuration Guide for more information.
3. Install the BusinessObjects Mobile server components on:
• a dedicated server
• the BusinessObjects Enterprise XI 3.0 server
4. Configure the Mobile server (both the authentication and job servers).
5. Set up the Mobile server database and configure the connection.
6. Optional: enter the configuration for the BlackBerry Enterprise Server
(BES) if you are including a BES in your deployment.
7. Optional: if your deployment includes a BlackBerry Enterprise Server (BES) then you need to set up the BES connection and activate the BES
push listener and configure the BES IT policy.
8. Optional: if you are deploying a proxy server to enable communication
between the mobile server and devices, configure and deploy the proxy
server.
9. Optional: if your deployment includes a BlackBerry Enterprise Server
(BES), start the MDS.
10. Start the Mobile authentication server (VAS).
11. Start the Mobile job server (VMS).
12. Optional: install and configure the OTA download page on a corporate
web server, so that device users can download the Mobile client
application Over-The-Air:
a. Deploy the web application (war file).
b. Add the required MIME types to the application server.
20 Installing and Deploying BusinessObjects Mobile
Installing and Configuring BusinessObjects Mobile
3 BusinessObjects Mobile deployment checklist
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 21/56
Related Topics
• Server-side installation on page 27
• Installed file description and location on page 25
• Server-side configuration on page 30
• Deploying the client OTA download web application on page 36
Recommended deployment architecture
Note: Before planning your deployment architecture for BusinessObjects
Mobile, we recommend that you read the documentation on BusinessObjects
Mobile overview and How BusinessObjects Mobile works.
Several deployment scenarios are supported for BusinessObjects Mobile:
• Deploy BusinessObjects Mobile server components and client OTAdelivery web application together on the BusinessObjects XI 3.0 server.
• Deploy BusinessObjects Mobile server components and client OTA
delivery web application together on a dedicated server.
• Deploy BusinessObjects Mobile server components and client OTA
delivery web application on separate servers.
You can choose to enable communication between mobile devices and the
BusinessObjects XI 3.0 server via a third-party proxy server inside your
corporate DMZ or a BlackBerry Enterprise Server (BES).
Installing and Deploying BusinessObjects Mobile 21
3Installing and Configuring BusinessObjects Mobile
Recommended deployment architecture
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 22/56
Related Topics
• Deploying with a BlackBerry Enterprise Server (BES) on page 33• How BusinessObjects Mobile works on page 14
• Deploying Mobile server components on page 22
• Deploying the client OTA web application components on page 23
Deploying Mobile server components
Deploying the client OTA web application is optional. To prevent having the
client application available to device users in this way, do not install the war
file containing the OTA delivery web application.
If you do want to install the client OTA delivery web application, do so on the
same server as the mobile server or on a separate server. Business Objects
recommends that you install the Mobile server components on a dedicated
server for performance and stability reasons.
22 Installing and Deploying BusinessObjects Mobile
Installing and Configuring BusinessObjects Mobile
3 Recommended deployment architecture
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 23/56
Related Topics
• Deploying the client OTA download web application on page 36
• Deploying the client OTA web application components on page 23
Deploying the client OTA web applicationcomponents
Deploying the client OTA web application is optional. To prevent making the
client application available to device users,do not install the war file containing
the OTA delivery web application.
To deploy the client OTA web application, do so in either a distributed or
combined installation. In a combined installation, you install theBusinessObjects Mobile server components and the client OTA web
application on the same server. To configure this deployment, run the
BusinessObjects Mobile setup on the desired server and select all
components for install.
In a distributed installation, you install the BusinessObjects Mobile server
components and the client OTA web application on separate servers. To
configure this deployment, run the BusinessObjects Mobile setup on the
server that you use to host the mobile server components, and select only
the Mobile server components for install.
Then run the setup again on the server on which you are deploying the client
OTA web application. BusinessObjects recommends that you deploy the
client OTA web application on the BusinessObjects Enterprise XI 3.0 server
to leverage the wdeploy tool to deploy automatically the client OTA web
application.
Related Topics
• Deploying the client OTA download web application on page 36
Installation package contentsThe BusinessObjects Mobile setup is approximately 300 MB in size. It
includes the following packages, which are installed by default:
• the Mobile server package, which includes:
• jar files: java archives containing the code
Installing and Deploying BusinessObjects Mobile 23
3Installing and Configuring BusinessObjects Mobile
Installation package contents
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 24/56
• cod files: archives containing the code
• the Mobile server database
• the Mobile server
• the signed client applet (MobiBB.jad)
• Documentation files:
• the administrator guide: xi3_mobile_admin_xx.pdf
• the device user guide: xi3_mobi_admin_xx.pdf
• ReportSamples folder: Sample database and reports for testing
• ReportSamples/README_ReportSamples.pdf: About this test
database and reports
• ReportSamples/MOBI_Test_Universe.unv: Sample Universe for
MoBI_Test_DB
• ReportSamples/MOBI_Test_Report Samples.biar: Sample Reportsfor MoBI_Test_DB
• ReportSamples/MOBI_Test_DB: Sample Microsoft Access database
• Images folder: Mobile device visuals for report authors
The Images folder contains a folder with two images of a Nokia or a
Blackberry screen that authors can use as a design backdrop in Web
Intelligence as well as a folder of alert icons authors can use in their
reports.
• images/README_Images.txt: About images for report design• images/skin_Blackberry.gif: Blackberry report authoring skin
• images/skin_Nokia.gif: Nokia report authoring skin
• images/SymbolFail: Fail report alerts icon
• images/SymbolPass: Pass report alerts icon
• images/SymbolWarning: Warning report alerts icon
• images/TrendGreenUp: TrendGreenUp report alerts icon
• images/TrendRedDown: TrendRedDown report alerts icon
• images/TrendYellowDown: TrendYellowDown report alerts icon
• images/TrendYellowFlat: TrendYellowFlat report alerts icon
• images/TrendYellowUp: TrendYellowUp report alerts icon
• (There are a variety of 3D versions of these same images also included
in the zip file)
24 Installing and Deploying BusinessObjects Mobile
Installing and Configuring BusinessObjects Mobile
3 Installation package contents
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 25/56
Note: These image files for alerts icons and report skins are delivered
to assist document creators to design reports optimized for display on
mobile devices.
• the Mobile client OTA download web archive (.war) which includes:• the client executables with a simple download Web page which enables
end users to download and install the client into a Mobile device
Over-The-Air (OTA). These pages should be made available to your
mobile users via a web server.
• the device user online help
The mobile_user.zip file contains an HTML version of the
BusinessObjects Mobile User Guide that you can deploy on the OTA
site for device user access.
• a java servlet that enables the web page to detect the OS version of the device connecting to the web page.
Related Topics
• Deploying the client OTA download web application on page 36
• Installing alert and status icons for Web Intelligence documents on
page 28
• Installing background images as templates for device screens on page 29
Installed file description and location
After a successful installation of BusinessObjects Mobile server components,
the following files are installed on the BusinessObjects Mobile server:
In server:
• Server\common contains:
• Root key
• Signed authentication key
• Common configuration files keys
• Common binaries (JAR files)
• Server\VAS contains:
• VAS (authentication server) configuration files
• VAS (authentication server) binaries (JAR files)
• authentication server data and logs
Installing and Deploying BusinessObjects Mobile 25
3Installing and Configuring BusinessObjects Mobile
Installation package contents
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 26/56
• authentication key pair
• Server\VMS contains:
• VMSServer (job server) log files
• VMSServer (job server) configuration files• VMS binaries (JAR files)
• Server\Preinstall contains database configuration scripts for supported
databases.
• Server\Tools contains the Password Scrambler tool to encrypt the Mobile
server database administrator password.
The selected components are now installed on the server. If you installed
the Mobile server components, the following options are now available from
the Windows Start menu under BusinessObjects XI 3.0 > BusinessObjects
Mobile:
• Launch Mobile Authentication server (VAS)
• Launch Mobile Job server (VMS)
• Install Mobile Authentication server (VAS) as a service
• Uninstall Mobile Authentication server (VAS) as a service
• Install Mobile Job server (VMS) as a service
• Uninstall Mobile Job server (VMS) as a service
• Launch Password Scrambler
The images and icons packaged with the setup are installed in the
BusinessObjects Enterprise 12.0\images directory. If you run the setup
on the same server that is running BusinessObjects XI 3.0, the image files
are added to the existing directory. If you run the setup on a different server,
the setup creates the BusinessObjects Enterprise 12.0\images directory.
If you chose to install the client OTA web application, the setup installs the
MobileOTA.war at BusinessObjects Enterprise 12.0\Java\application
by default.
Related Topics
• BusinessObjects Mobile deployment checklist on page 20
26 Installing and Deploying BusinessObjects Mobile
Installing and Configuring BusinessObjects Mobile
3 Installation package contents
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 27/56
Server-side installation
Installing BusinessObjects XI 3.0
You need to install BusinessObjects Mobile on top of BusinessObjects
Enterprise XI 3.0. For the list of supported platforms and devices, see:
http://support.businessobjects.com/documentation/supported_platforms/de
fault.asp.
Installing the Client application download page
The client application download page files allow you to configure a web page
that mobile users can access from their devices to download the client
application. The war package delivered with the installation setup includes:• mobile_user.zip: the device user online help in HTML format
• a java servlet that enables device OS detection by the web site (to
download automatically the correct version of the client application)
Related Topics
• Deploying the war file on page 37
Installing BusinessObjects Mobile on Windows
Verify that BusinessObjects Mobile supports your server platform and
operating system. Refer to the Business Objects Supported Platforms web
site at http://support.businessobjects.com/documentation/supported_plat
forms/default.asp.
To install the BusinessObjects Mobile server-side components and client
OTA web application on a Windows server:
1. Extract the BusinessObjects Mobile .zip file to the Mobile server host
machine and launch the BusinessObjects Mobile installer (setup.exe).
2. Select the installation language (the default is Optionally, check the Create
log file during installation checkbox to activate logs during the setup
process. Click OK to proceed.
3. Click Next to display the License Agreement.
4. Accept the license agreement and click Next to proceed.
Installing and Deploying BusinessObjects Mobile 27
3Installing and Configuring BusinessObjects Mobile
Server-side installation
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 28/56
5. Enter user and organization information and select one of the availability
options then click Next to proceed.
6. Select one of the following installation options:
• Typical• Complete
• Custom -- if you want to select individual components for installation
Note: Use this option if you want to conduct a distributed installation
(installing the server components and the client OTA web application
on separate servers).
7. Select a destination location (default location is c:\BusinessObjects
XI 3.0\BusinessObjects Mobile) and click Next to proceed.
The application files are installed on the server.
8. Click Finish to complete the installation process.
You are ready to perform the server-side configuration steps appropriate to
your chosen deployment scenario.
Related Topics
• BusinessObjects Mobile deployment checklist on page 20
• Server-side installation on page 27
• Server-side configuration on page 30
Installing alert and status icons for Web Intelligencedocuments
The BusinessObjects Mobile download package includes eight trend and
status alerting icons that can be added to Web Intelligence conditional report
alerters for greater visual impact when viewed on mobile devices.
Using these icons requires two steps:
1. Make these icons available to Web Intelligence document creators bycopying the icon images into the images folder of the BusinessObjects
Enterprise XI program folder on the server at the following path:
C:\Program Files\Business Objects\BusinessObjects Enterprise
12\images
28 Installing and Deploying BusinessObjects Mobile
Installing and Configuring BusinessObjects Mobile
3 Server-side installation
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 29/56
Note: The BusinessObjects Mobile setup installs the icon files in this
directory by default. If you did not install the Mobile server components
on the BusinessObjects Enterprise server, you need to move the icons
from the Mobile server to the BusinessObjects Enterprise server so that
they are available to document creators.
2. To add icons to a conditional alerter within a report:
a. Select the column for the alert and open the alerts button.
b. Select or create the alert you need for the data in question.
c. Set the appropriate icon on each condition of the alert by selecting
the Format button on the alert condition.
d. In the Background part of the Alert Format dialog type in the specific
icon file name in the URL entry field.
The server adds boimg:// as a prefix to your file name, directing the
server to the local images directory for this image file.
Related Topics
• Installing background images as templates for device screens on page 29
Installing background images as templates for devicescreens
It is highly recommended that document creators, catering to mobile users,
use image backgrounds for target mobile devices as report design templates.
Embedding an image of the target device in the report background provides
a model of the screen size that helps design the report to fit the device
constraints. This makes it easy to position blocks and set column widths so
that the report elements fit to the device screen.
Note: Business Objects provides two backgrounds for this purpose in the
BusinessObjects Mobile download package. You can also create your own
backgrounds for specific mobile devices.
1. Install these graphics files on the BusinessObjects Enterprise server at
the following location: C:\Program Files\Business Objects\Busines
sObjects Enterprise 12\images
Note: The BusinessObjects Mobile setup installs the background image
files in this directory by default. If you did not install the Mobile server
components on the BusinessObjects Enterprise server, you need to move
Installing and Deploying BusinessObjects Mobile 29
3Installing and Configuring BusinessObjects Mobile
Server-side installation
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 30/56
the images from the Mobile server to the BusinessObjects Enterprise
server so that they are available to document creators.
2. To set the background image in a Web Intelligence document, go to the
Background Image item in the Properties tab of Web Intelligence JavaReport Panel, and then select the Custom radio button and enter the file
name of the image.
The server adds boimg:// as a prefix to your file name, which tells the
server to look in the local images directory for this image file.
Server-side configuration
Depending on the deployment scenario you have adopted for
BusinessObjects Mobile, you need to configure one or more of the followingserver connections after installation:
• If your deployment does not includes a BES, you can install and configure
a third-party proxy server to enable communication between the
BusinessObjects Enterprise server on the intranet and mobile devices.
• If you have a BES server, you need to configure the connection between
the BES server and the Mobile server.
Related Topics
• To configure the Mobile server on page 30
• Deploying with a BlackBerry Enterprise Server (BES) on page 33
• Setting up the Mobile Administration database on page 32
• Deploying the client OTA download web application on page 36
To configure the Mobile server
You can install the mobile server on the BusinessObjects XI 3.0 server or
on a dedicated server.
1. Open the Business Objects\Mobile
12\server\VMSServer\config\server.config and the Business
Objects\Mobile 12\server\VAS\config\server.config files for edit.
2. Set the EXTERNAL_HOSTNAME parameter to the name of the machine
that hosts so that devices can resolve the machine name to locate the
mobile server.
30 Installing and Deploying BusinessObjects Mobile
Installing and Configuring BusinessObjects Mobile
3 Server-side configuration
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 31/56
For example: EXTERNAL_HOSTNAME=mobile_server.do
main_name.com
3. Open the Business Objects\Mobile
12\server\VAS\config\cluster.config and the BusinessObjects\Mobile 12\server\VMSServer\config\cluster.config files
for edit.
4. Set the HOST_PORT parameter to the name of the machine that hosts
your BES/MDS so that devices can locate the server.
For example: HOST_PORT=MDS_server.domain_name.com
The Mobile server can communicate with multiple CMS. The Mobile server
is located on the intranet and can therefore be deployed in a firewalled
configuration.
Note: The Mobile server cannot be configured in a reverse proxyconfiguration however, because communication between the Mobile
server and client is via proprietary communication protocols, not HTTP.
Related Topics
• Deploying with a BlackBerry Enterprise Server (BES) on page 33
• BusinessObjects Mobile deployment checklist on page 20
To change the default communication ports on the Mobile server
By default, the ports through which the Mobile server communications are
11011 for the authentication server (VAS) and 11711 for the job server (VMS).
You can change the default ports by instructing the server to accept incoming
traffic from a different port.
All incoming traffic is via the port you specify. If you are deploying a proxy
server (not a BES), configure it to redirect communication to the port that
you selected.
To change the ports through which the Mobile server communicates:
1. Open the config\server.config files in the VAS and VMSServer
directories.
2. Set the BINDTO_PORT parameter to the port you want to use for traffic
incoming to the Mobile server.
3. Save and close both config files.
Installing and Deploying BusinessObjects Mobile 31
3Installing and Configuring BusinessObjects Mobile
Server-side configuration
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 32/56
4. Restart the Mobile server.
Setting up the Mobile Administration database
Verify that your database platform and version is supported for
BusinessObjects Mobile. Refer to: http://support.businessobjects.com/docu
mentation/supported_platforms/default.asp. Verify that your database has
at least 2 KB of memory per user in your mobile deployment.
The mobile administration database is made up of two major databases:
• the authentication database, which stores information about:
• mobile users (ID, name, email)
• definition of mobile user groups• mobile devices (ID, type, IP, login time, user ID, device ID)
• the push/sync database, which stores information about user
synchronizations to the server, including document versioning information
for documents in the local store.
The mobile server database does not store user credentials, but information
about user connections and synchronizations to the mobile server. The
BusinessObjects Mobile setup includes a pre-configured Apache Derby
database that you can use with the mobile server, plus configuration files for
other standard supported databases. To configure a database other than
Apache Derby:
1. Create a database and a database admin user.
This database houses the mobile authentication database and the mobile
job server database.
2. Run the appropriate SQL configuration scripts in the database of your
choice. The configuration scripts delivered with the mobile setup are
located at:
Business Objects\Mobile 12\preinstall\VAS and Business
Objects\Mobile 12\preinstall\VMSServer
Note: You must run two separate configuration scripts: one for the
authentication server (VAS) and one for the job server (VMSServer).
Configuration scripts are available for:
• SQL Server
32 Installing and Deploying BusinessObjects Mobile
Installing and Configuring BusinessObjects Mobile
3 Server-side configuration
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 33/56
• Apache Derby
• DB2
• Oracle
• MySQL3. Fromthe Start menu, launch BusinessObjects XI 3.0 > BusinessObjects
Mobile > Launch Password Scrambler .
4. Type the database administrator password in the Password Scrambler
tool, and click OK to run the tool.
The Password Scrambler Tool generates an encrypted password to
protect the password in the Mobile server configuration files.
5. Copy the encrypted password.
6. Update the mobile server configuration files to point to the mobile server
database. Open and edit the cluster.config files in both the server\VASand server\VMSServer folders and change the following parameters:
a. URL: URL of the JDBC connection. The default value of the JDBC
connection is: derby:../derby_db.
b. DB_DRIVER: the database driver name The default value is
org.apache.derby.jdbc.EmbeddedDriver .
c. Type the database admin user name in the LOGIN field.
d. Paste the encrypted database admin password in the PASSWORD
field.
7. Optionally, update the other configurable database parameters:
• Maximum number of simultaneous connections (Default = 30)
• Initial capacity (Default = 5)
8. Save and close the configuration files.
Related Topics
• How BusinessObjects Mobile works on page 14
Deploying with a BlackBerry Enterprise Server (BES)
This deployment scenario is recommended if you are deploying
BusinessObjects Mobile to BlackBerry users.
If you are deploying BusinessObjects Mobile to BlackBerry users, Business
Obejcts recommends that you deploy via a BlackBerry Enterprise Server
Installing and Deploying BusinessObjects Mobile 33
3Installing and Configuring BusinessObjects Mobile
Server-side configuration
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 34/56
(BES). You need to configure the connection between the BES server and
the BusinessObjects Mobile server. You then need to activate the BES push
listener, which reconnects the BlackBerry server automatically if it cuts out
while data is being processed.
To configure the BES, refer to BlackBerry documentation.
Related Topics
• To configure the Mobile server on page 30
Standard deployment with a proxy server
This deployment scenario is recommended if you are not using the BlackBerry
Enterprise server (BES) as part of of the Mobile deployment.
You can configure a proxy server to enable communication between client
devices and the BusinessObjects XI server.
If you do not plan to include a BlackBerry Enterprise server in your
deployment, you can configure a proxy server to enable communication
between client devices and the BusinessObjects XI server.
The Mobile server can communicate with multiple CMS. The Mobile server
is located on the intranet and can be deployed in a firewalled configuration.
The Mobile server cannot be configured in a reverse proxy congurationhowever, because communication between the Mobile server and client is
via proprietary communication protocols, not HTTP.
To configure a proxy server to allow devices to communicate with the Mobile
server, open ports 11011 and 11711. These are the default ports that are
opened for incoming and outgoing communication with the proxy server. If
you change these default values, update the proxy with the customized
values you selected.
Related Topics
• To configure the Mobile server on page 30
34 Installing and Deploying BusinessObjects Mobile
Installing and Configuring BusinessObjects Mobile
3 Server-side configuration
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 35/56
To start the Mobile servers manually
If your deployment includes a BlackBerry Enterprise Server (BES), start theMDS server before launching the Mobile servers.
You can start the mobile servers (the Authentication and job servers) by
launching them from the Start menu under: \BusinessObjects Enterprise
XI 3.0\BusinessObjects Mobile. Always start the Authentication server
(VAS) first. You can also configure the servers as Windows services.
If you want to start the servers manually:
1. Start the VAS first with the vtauthd.bat in the server\VAS\bin file. Use
the command start2 to launch the bat.
A DOS window launches and displays the progression of the VAS startup.
2. Once the VAS is ready, start the VMS first with the vtvmsd.bat in the
server\VMSServer\bin file. Use the command start2 to launch the
bat.
A DOS window launches and displays a server initialization complete
message when the VMS is ready.
Related Topics
• Logging and tracking errors on the Mobile server on page 44
• Installed file description and location on page 25
To use a device simulator for testing
You can use device simulators to test your deployment and connections,
and to view documents before deploying them to real devices.
Note: To use a device simulator for testing, you have to update the
VAS/cluster.config file to enable the simulator to access the server via the
BlackBerry MDS server.
You can download simulators and instructions for deploying and configuring
them from the device vendors who create them.
Installing and Deploying BusinessObjects Mobile 35
3Installing and Configuring BusinessObjects Mobile
Server-side configuration
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 36/56
To migrate BusinessObjects Mobile version 1 toversion 2
You must first install BusinessObjects XI 3.0.
If you have already deployed BusinessObjects Mobile version 1 on top of
BusinessObjects XI Release 2, migrate your mobile device users to
BusinessObjects Mobile version 2:
1. Install BusinessObjects XI 3.0.
2. Disable access to the web services.
3. Install and configure the new Mobile version 2 server components.
4. Remove the version 1 application from client devices. If you deployedversion 1 via the BES, you can replace the version 1 client application
with the version 2 application by using the BES server to force removal
of the version 1 client and to push the version 2 client to devices.
If you are maintaining both BusinessObjects Enterprise XI R2 and XI 3.0
servers at the same time, you can maintain a side-by-side install of
BusinessObjects Mobile versions 1 and 2.
Related Topics
• BusinessObjects Mobile deployment checklist on page 20
Deploying the client OTA download webapplication
To enable device users to download to the BusinessObjects Mobile client
application to their devices, you can configure an OTA download web site.
The client package and download page is delivered in a standard SUN war
file in the BusinessObjects Mobile setup. The MobileOTA.war file includes:
• a web application• a java servlet to enable device detection on the web page
• the device user HTML online help files (which can be deployed on the
web page)
• the client application
To configure the OTA web application:
36 Installing and Deploying BusinessObjects Mobile
Installing and Configuring BusinessObjects Mobile
3 Deploying the client OTA download web application
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 37/56
• ensure that your application server is Java-compliant and supported by
BusinessObjects Enterprise XI 3.0.
• use the wdeploy tool to deploy the MobileOTA.war file (only available if
you installed the mobile server package on the BusinessObjects XI 3.0
server and in the BusinessObjects Enterprise installation directory).
• manually deploy the war file (required if you installed the mobile server
package on a dedicated server).
• configure the required MIME types on the application server.
Related Topics
• Setting the required MIME types on the application server on page 38
• Installation package contents on page 23
• Deploying the client OTA download web application on page 36
• Deploying the war file on page 37
Deploying the war file
The OTA web pages are packaged in a Web Archive (war) file. Detailed
instructions on deploying web applications in war files are located in:
• for manual deployments: BusinessObjects Enterprise XI 3.0 Installation
and Configuration Guide
• for automatic deployment using the wdeploy tool delivered with
BusinessObjects Enterprise XI 3.0:BusinessObjects Enterprise XI 3.0
Installation and Configuration Guide
Overview of wdeploy
wdeploy can do any or all of the following:
• list all the available, installed applications listed in your BusinessObjects
Enterprise $INSTALLDIR\deployment\apps directory
• deploy all the available BusinessObjects web applications that you haveinstalled and BusinessObjects customized web applications developed
with Developer Suite.
• build the available web applications you have installed
• create the resources and configuration files required for a specified
application and then deploy the application
Installing and Deploying BusinessObjects Mobile 37
3Installing and Configuring BusinessObjects Mobile
Deploying the client OTA download web application
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 38/56
• deploy an application whose resources and configuration files have been
prepared for deployment
• list all the applications that have been previously deployed in an application
server • undeploy applications that have been previously deployed in an application
server, in a web server or both
Note: In line with BusinessObjects Enterprise version XI Release 2
terminology, this documentation uses the term web application server instead
of the term application server used through version 6.x.
See the README file for specific information or known issues.
wdeploy is a command-line tool for JSP environments that you can use to
deploy BusinessObjects web applications.
wdeploy is ANT-based with some Javascript helpers.
Setting the required MIME types on the applicationserver
To deploy the OTA web archive and support download of the Mobile client
application to device users, add the following MIME types to the application
server:
Mime typeExtension
text/vnd.sun.j2me.app-descriptor Jad
application/vnd.rim.codCod
Example: Setting the required MIME types in Tomcat
In Tomcat, MIME type declarations are added at the end of <mime-map
ping> list of the $TOMCAT_HOME/conf/web.xml file as follows:
1. Open $TOMCAT_HOME/conf/web.xml for edit.
38 Installing and Deploying BusinessObjects Mobile
Installing and Configuring BusinessObjects Mobile
3 Deploying the client OTA download web application
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 39/56
2. Add the following text:
<!-- MH Extensions for Mobile Application download -->
<mime-mapping><extension>jad</extension><mime-type>text/vnd.sun.j2me.app-descriptor</mime-type></mime-mapping>
<mime-mapping><extension>cod</extension><mime-type>application/vnd.rim.cod</mime-type></mime-mapping>
3. Save and close the web.xml file.
Client installation
The BusinessObjects Mobile client is a small application that needs to be
downloaded to each device. There are three ways to install the client on the
mobile device:
• from a secured web site using Over-The-Air (OTA) provisioning.
• Over-The-Air via the BlackBerry Enterprise Server (BES) to push the
download to devices.
• manually on each device via the client desktop (using, for example, USB,
Bluetooth, Infrared).
Related Topics
• Automated deployment to mobile devices on page 39
• Deploying the client OTA download web application on page 36
Automated deployment to mobile devices
Dependingon your deployment scenario, youcandeliver theBusinessObjects
Mobile client application to users:
• Over-The-Air (using OTA delivery) via an internal web site page
• Over-The-Air to BlackBerry devices using the push capability in the
BlackBerry Enterprise Server (BES)
Installing and Deploying BusinessObjects Mobile 39
3Installing and Configuring BusinessObjects Mobile
Client installation
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 40/56
Related Topics
• Deploying the client OTA download web application on page 36
• Deploying with a BlackBerry Enterprise Server (BES) on page 33
40 Installing and Deploying BusinessObjects Mobile
Installing and Configuring BusinessObjects Mobile
3 Client installation
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 41/56
Setting up administrationand security rights
4
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 42/56
Managing security rights for mobile users
and documentsBusiness intelligence administrators and document creators designing
documents for mobile users, are advised to publish those documents to a
folder dedicated to mobile documents. Typically, this folder is named Mobile.
Administrators can then easily set up security rights for mobile users, groups,
and documents using the standard BusinessObjects Enterprise security
rules.
To manage mobile user and document security rights, you use the standard
BusinessObjects Enterprise Central Management Console (CMC).
To access documents viaBusinessObjects Mobile, device users need access
rights for documents via InfoView.
Note: For full details on setting up security rights, refer to the
BusinessObjects Enterprise Administrator's Guide.
Tracking user activity
Administrators can track and store data on mobile users and devices acrossthe BusinessObjects Mobile deployment, including:
• device names
• IP addresses
• device serial numbers
• user names
• user logins
• time/date of connection
• device types
The data on device profiles and user activity can be used to provide statisticalreports to fine-tune and evolve your mobile deployment.
This information is stored in the mobile server database that you created to
log user activity and errors.
42 Installing and Deploying BusinessObjects Mobile
Setting up administration and security rights
4 Managing security rights for mobile users and documents
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 43/56
Troubleshooting Information
5
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 44/56
Logging and tracking errors on the
Mobile serverThe main types of server errors you need to capture in your deployment are:
• BusinessObjects Enterprise errors directly reported to the Mobile client.
Refer to the BusinessObjects Enterprise Error Message Guide for details.
• Mobile server errors:
• Generic errors
• Authentication errors: invalid credentials, session errors
• Networking Errors: Remote site unreachable, Cannot resolve address,
Local database access errors, Connection to application server lost
To control the server level of logging, edit the values in the server\com
mon\config\shared.config.
To reload log levels
You can change the server logs level without stopping the servers.
To reload the log levels while the server is running:
1. Open the server config files and issue the following command: vtXXXd
reload_cfg.
The log is reloaded and the server dumps a state snapshot to the
VMP_DUMP channel when it encounters a suspicious condition.
2. You can also trigger this dump by issuing the following command: vtXXXd
dump.
Related Topics
• To trigger the log dump remotely on page 45
44 Installing and Deploying BusinessObjects Mobile
Troubleshooting Information
5 Logging and tracking errors on the Mobile server
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 45/56
To trigger the log dump remotely
The MANAGEMENT_PORT can be used to trigger a server dump or tomonitor server status. Do not proxy it or make it externally accessible. To
generate a server dump remotely:
1. Open the config\server.config files in both the VAS and VMSServer
directories.
2. Set the MANAGEMENT_PORT to the ports you want to open to receive
commands via TCP. By default, these ports are 11012 and 11712.
The management ports are enabled to receive and process commands
via TCP.
3. Send the following command to the server via the TCP connection: dump
The server writes a state dump to the logs.
Related Topics
• To reload log levels on page 44
Tracking device errors
In addition to BusinessObjects Enterprise errors and Mobile server errors
that can be displayed on the device, the device also displays and logs mobileclient errors:
• Connectivity errors: Network not available, Cannot find server
• Local Store Errors: Cannot access local store, Cannot open document
from local store, Out of memory
You can check the logs on BlackBerry devices by pressing and maintaining
the Alt key while typing lglg on the device.
Standard troubleshooting tipsThe following questions can help you resolve errors captured in your server
and device logs.
Is this error caused by:
• a server- or client- specific issue?
Installing and Deploying BusinessObjects Mobile 45
5Troubleshooting Information
Tracking device errors
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 46/56
• an installation/deployment issue?
• a login issue?
• an execution issue?
Some areas to check when troubleshooting:
• Is the device supported/compatible?
• Can the device browser access the internet?
• Can the device access BES/MDS or the proxy server?
• Are the server OS/JDK version/database supported/compatible?
• Did you start the servers in the right order (BES, then VAS, then VMS)?
For detailed errors in the VAS and VMS logs, check that:
• the VAS can communicate with the BlackBerry server (if you are deploying
a BES)• the VMS has registered to the VAS
• the client has registered to the VAS
• the VMS can communicate with the BusinessObjects Enterprise server
Network unavailable errors
Mobile devices that connect to BusinessObjects Mobile need to be configured
to access the internet. Ensure that all devices in your deployment can connect
to the internet so they can access the Mobile server.
If TCP and APN settings are not correctly configured on the device, the user
can receive "open-tunnel failure" or "Network unavailable" errors.
Configure the device for internet access to resolve these errors, which can
also be caused by:
ResolutionCause
• Check the data subscription
• Check the carrier settings (TCP)
• Check the IT policy• Check the application rights (can use HTTP and
socket connection)
Incorrect Network con-
figuration of the device
46 Installing and Deploying BusinessObjects Mobile
Troubleshooting Information
5 Network unavailable errors
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 47/56
ResolutionCause
• Mobile server name
• Mobile port number
• CMS name
Incorrect connection
settings
• Device cannot connect to the BES
• BES cannot connect to the Mobile Server
• Mobile Server cannot connect to the BusinessOb-
jects XI 3.0 Server
• Device cannot connect to the internet or to the
proxy server (if your deployment includes a proxy
server)
• The proxy server (if your deployment includes a
proxy server) cannot connect to the Mobile Server • The Mobile Server cannot connect to the Busines-
sObjects XI 3.0 Server
Device cannot connect
to the Mobile server
Installing and Deploying BusinessObjects Mobile 47
5Troubleshooting Information
Network unavailable errors
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 48/56
48 Installing and Deploying BusinessObjects Mobile
Troubleshooting Information
5 Network unavailable errors
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 49/56
Get More Help
A
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 50/56
Online documentation library
Business Objects offers a full documentation set covering all products and
their deployment. The online documentation library has the most up-to-dateversion of the Business Objects product documentation. You can browse
the library contents, do full-text searches, read guides on line, and download
PDF versions. The library is updated regularly with new content as it becomes
available.
http://support.businessobjects.com/documentation/product_guides/
Additional developer resources
http://devlibrary.businessobjects.com
Online customer support
The Business Objects Customer Support web site contains information about
Customer Support programs and services. It also has links to a wide range
of technical information including knowledgebase articles, downloads, and
support forums.
http://www.businessobjects.com/support/
Looking for the best deployment solution for your company?
Business Objects consultants can accompany you from the initial analysis
stage to the delivery of your deployment project. Expertise is available in
relational and multidimensional databases, in connectivities, database design
tools, customized embedding technology, and more.
For more information, contact your local sales office, or contact us at:
http://www.businessobjects.com/services/consulting/
Looking for training options?
From traditional classroom learning to targeted e-learning seminars, we can
offer a training package to suit your learning needs and preferred learning
style. Find more information on the Business Objects Education web site:
http://www.businessobjects.com/services/training
50 Installing and Deploying BusinessObjects Mobile
Get More Help
A
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 51/56
Send us your feedback
Do you have a suggestion on how we can improve our documentation? Is
there something you particularly like or have found useful? Drop us a line,
and we will do our best to ensure that your suggestion is included in the nextrelease of our documentation:
mailto:[email protected]
Note: If your issue concerns a Business Objects product and not the
documentation,pleasecontact ourCustomer Support experts. For information
about Customer Support visit: http://www.businessobjects.com/support/ .
Business Objects product information
For information about the full range of Business Objects products, visit:http://www.businessobjects.com.
Installing and Deploying BusinessObjects Mobile 51
AGet More Help
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 52/56
52 Installing and Deploying BusinessObjects Mobile
Get More Help
A
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 53/56
Index.NET client application 14
3G 10
3G+ 10, 17
A
actions 11email 11
SMS 11
administration console 13
administration Console 10
Administration Console 17, 42
administration database 10
administration tasks 6
alerters
download icons 28
alerts 11, 17
subscribing groups 13
analytics 11Apache
configuring 38
application
client-side 14, 39
authentication server 14, 17, 30
B
barometers 11
BES 14, 20, 21, 30, 39
Blackberrydevices 39
BlackBerry
client application 27
Enterprise Server 14, 17, 20, 21, 30, 39
BlackBerry (continued)
installation package 23
server 39
BlackBerry device 10
C
Central Management Console 42
checklist
installation 20
CLDC 10
client
application 39
client application 14
downloading 6
installing 6
CMC 42
connection information
preconfigure 13, 20
Crystal Reports 11, 17
D
database
mobile administration 14, 20, 32
repository 20
default document 11
default folder 11
demos 23
deployment 34
architecture 21
automating 13, 39
distributed 20, 30
scenarios 21
standalone 20
Installing and Deploying BusinessObjects Mobile 53
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 54/56
deployment (continued)
with BES 33
device errors
tracking 45
device tracking 17, 42
devices
BlackBerry 39
DMZ 20, 21, 30
configuring 30
document security 42
documents
default 11
local 11
offline 11
Web Intelligence 11drill 11
E
EDGE 10
EDGE networks 17
email 11
errors
open-tunnel failure 46
tracking 45
F
features
limitations 12
folders
default 11
G
GPRS 10
GSM 10
I
icons
for reports 23, 28
images
report templates 29
installation 27
background images 29
checklist 20
client application via OTA 13, 36, 39
client application via wire 13, 39
client device application 6
files installed 25
graphics files 23
icons 28server-side 32
validating 25
web download page 23
intranet environment 21
J
J2ME 10, 23, 39
client application 27
J2ME client application 14
job server 14, 17, 20, 30
L
limitations
features 12
Linux 16
load balancing 30
local
documents 11
login
preconfigure 13, 20
logonpreconfigure 39
logs
log dump 45
reload 44
54 Installing and Deploying BusinessObjects Mobile
Index
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 55/56
M
midlet 39
MIDlet 14
download 27
MIDP 10
MIME types 38
configure 27
mobile server
errors 44
logs 44
Mobile server 17
mobile servers
starting 35
N
network unavailable 46
networks
3G+ 17
EDGE 17
supported 17
O
offlinedocuments 11
open-tunnel failure
troubleshooting 46
OTA 23, 27, 39
web download page 36
OTA delivery
for installation 13, 39
OTA web pages 37
OTALoader file 23, 27
Pplatforms 27
Linux 16
UNIX 16
platforms (continued)
Windows 16
ports
for proxy server 30
proxy server 14, 30, 33, 34
configuring 30
R
readme 23
report design
download icons 28
reports
Crystal Reports 11
display recommendations 12refresh 11
repository 14, 17, 32
S
samples 23
SDK
Crystal Enterprise 14, 17
Report Engine 14, 17
security 21
server BlackBerry 39
servers
authentication 14, 17, 21, 30
BlackBerry 14
database 17
job 14, 17, 30
Mobile 17
proxy 14, 30, 33
supported platforms 16
skins 29
smartphone 10
SMS 11speedometers 11
Symbian series-60 10
Symbian UIQ 10
Installing and Deploying BusinessObjects Mobile 55
Index
8/14/2019 Xi3 Mobile Admin En
http://slidepdf.com/reader/full/xi3-mobile-admin-en 56/56
T
templates
background images 29
thermometers 11
Tomcat
configuring 38
tracking devices 42
troubleshooting 44, 45, 46
U
UNIX 16
user rights 42
user tracking 17, 42
W
war file
deploying 37
Web Intelligence
alerter icons 28
documents 11
tracking changes 17
Windows 16
server installation 27
Windows CE 10
Windows Mobile 10
wire delivery
for installation 13, 39
Index