There are four steps to installing the Oracle BI Mobile App Designer: 1. Apply the required patch file 2. Deploy the Mobile App Designer to the Weblogic application server 3. Set up security permissions in the system-jazn-data.xml file 4. Configure the Apps library folder in the catalog to manage mobile applications

1. Installing the Oracle BI Mobile App Designer
PREPARED BY RAVI KUMAR LANKE
Page 1

2. The BI Mobile App Designer is the replacement for the BI Mobile App for Ipads that now lets
you build your own BI reporting applications for any mobile device, phone or tablet, even
browsers on pc‟s.
This is a new feature available in OBIEE from version 11.1.1.7.1 onwards. If you are only
11.1.1.6x or 11.1.1.7 then you must upgrade/patch to 11.1.1.7.1 before installing this. This
blog takes you through the steps of installing & configuring it within OBIEE.
Prerequisite patch
Before it can be installed OBIEE 11.1.1.7.1 needs to be patched with patch number
17004920.
Download the appropriate patch file for your environment from Oracle Support – I‟m using
Windows 64bit, so I downloaded p17004920_111171_MSWIN-x86-64.zip.
Unzip this into a temporary directory.
Now stop all of the OBIEE services in the way you would normally do for your installation.
In this temporary directory create batch (or shell for linux) file called setpaths.bat (or
setpaths.sh) which we need to set the path and environment variables for the patch
correctly.
Into this file enter the following commands, replacing the <obiee_home> reference on the
first line with the actual directory path:
set ORACLE_HOME=<obiee_home>Oracle_BI1
set PATH=%ORACLE_HOME%bin;%PATH%
set JAVA_HOME=%ORACLE_HOME%jdk
set PATH=%JAVA_HOME%bin;%PATH%
set PATH=%ORACLE_HOME%OPatch;%PATH%
on Linux this commands should be:
ORACLE_HOME =<obiee_home>/Oracle_BI1;export ORACLE_HOME
PATH=$ORACLE_HOME/bin:$PATH;export PATH
JAVA_HOME=$ORACLE_HOME/jdk;export PATH
PATH=$JAVA_HOME/bin:$PATH;export PATH
PATH=$ORACLE_HOME/OPatch:$PATH;export PATH
On linux also run “chmod
777 setpaths.sh”
PREPARED BY RAVI KUMAR LANKE
to make the script executable.
Page 2

3. Now open a command window (in windows open this as “run as administrator”), and cd to
your temporary directory and run setpaths.bat (.sh)
PREPARED BY RAVI KUMAR LANKE
Page 3

4. Then cd into the 17004920 sub-directory and run „opatch apply‟
If the verify passes, enter „y‟ to continue with the patch. It should only take a few minutes.
Leave this window open, you‟ll need it again in a mo.
PREPARED BY RAVI KUMAR LANKE
Page 4

5. 1.
2.
3.
4.
Install Oracle BI Mobile App Designer
There are four steps to installing the Mobile App Designer:
Apply the patch file
Deploy the Mobile App Designer to Weblogic
Setup the Security for the Mobile App Designer
Setup the Apps library
Apply the Oracle BI Mobile App Designer patch
The Oracle BI Mobile App Designer upgrade is supplied as a patch file. So the first step is
to apply this patch, in exactly the same way as the previous patch.
This time download patch number 17220944 from Oracle Support – this is platform
independent, so the file you will download is p17220944_111170_Generic.zip. Unzip this
into your temporary directory.
In the same command window as above cd into the new patch directory and run opatch
again. If you closed the command window you will need to reopen it and run the
setpaths.bat/sh script again.
There is no prompting on this patch, it just installs straight away.
PREPARED BY RAVI KUMAR LANKE
Page 5

6. Do not start weblogic or OBIEE just yet, but leave this window open.
PREPARED BY RAVI KUMAR LANKE
Page 6

7. Deploy the Mobile App Designer to Weblogic
Now the Mobile App Designer needs to deployed to the Weblogic web server. To do this run
the Middleware Configuration Assistant.
This started by running <obiee_home>/Oracle_BI1/common/bin/config.cmd (.sh on
Linux) On Linux you‟ll need a GUI/X11 emulator to run this.
Once past the splash screen, select „Extend an existing WebLogic domain:
Then select the domain to extend – it should default to the domains directory, so select the
domain from under there.
PREPARED BY RAVI KUMAR LANKE
Page 7

8. Next check the option “Extend my domain using an existing extension template‟, then use
the browse button to locate the file
<obiee_home>Oracle_BI1commontemplatesapplicationsoracle.bimad_template_11.1.1.j
ar
PREPARED BY RAVI KUMAR LANKE
Page 8

9. PREPARED BY RAVI KUMAR LANKE
Page 9

10. On the JDBC Component Schema config screen leave the settings as they are and just
click next
PREPARED BY RAVI KUMAR LANKE
Page 10

11. On the the JDBC Component Schema test screen we don‟t want to perform any tests, so
just click next again.
PREPARED BY RAVI KUMAR LANKE
Page 11

12. There are no Optional Configurations required, so just click next.
PREPARED BY RAVI KUMAR LANKE
Page 12

13. On the Configuration Summary screen click „Extend‟ to begin.
PREPARED BY RAVI KUMAR LANKE
Page 13

14. The extension only takes a few seconds. Click Done to close the config wizard.
PREPARED BY RAVI KUMAR LANKE
Page 14

15. Enable the Mobile App Designer in Presentation Services
We need to add a new entry to the instanceconfig.xml file for presentation services to make
the Mobile App Designer visible to the users.
Go to the directory
<obiee_home>instancesinstance1configOracleBIPresentationServicesComponentcorea
pplication_obips1
edit the file instanceconfig.xml.
Near the bottom of the file locate the </ServerInstance> tag and just before this insert the
following lines:
<AdvancedReporting>
<EnableMAD>true</EnableMAD>
</AdvancedReporting>
Save the file and close your editor.
PREPARED BY RAVI KUMAR LANKE
Page 15

16. Setup the Security for the Mobile App Designer
This step updates the system-jazn-data.xml file with the security permissions required for BI
Mobile App Designer.
First we need to start WebLogic (but not the managed servers or OBIEE just yet).
From your command window Navigate to the
<obiee_home>user_projectsdomainsbifoundation_domainbin directory and run
startWebLogic.cmd (.sh).
and wait for the 'started in RUNNING mode' message.
PREPARED BY RAVI KUMAR LANKE
Page 16

17. Once WebLogic is running you need to run a WLST script. Open a new command window
and change directory to the <obiee_home>Oracle_BI1bifoundationinstall directory
Now run the following command, substituting the <hostname> and <Weblogic administrator
name> fields as appropriate:
<obiee_home>Oracle_BI1commonbinwlst.cmd addMADCodeGrants.py
t3://<hostname>:7001 <WebLogic administrator name>
Note it‟s <obiee_home>Oracle_BI1commonbinwlst.sh… on Lunix
You‟ll be prompted to enter the password for the Weblogic Admin user, then the script will
complete in a few seconds.
PREPARED BY RAVI KUMAR LANKE
Page 17

18. Now complete the start-up of OBIEE. You can either stop the weblogic server above
(stopweblogic.cmd/sh) and perform a full normal start-up of weblogic and OBIEE the way
you normally do, or run the following to complete the start-up:
From your command window Navigate to the
<obiee_home>user_projectsdomainsbifoundation_domainbin directory and run
startManagedWebLogic.cmd (.sh) with the BI Server name as the parameter:
startManagedWebLogic.cmd bi_server1
PREPARED BY RAVI KUMAR LANKE
Page 18

19. Wait for „started in RUNNING mode‟ message:
Then minimise this window (do not close) and open a new command window and start the
opmn:
Change directory to <obiee_home>instancesinstance1bin (change instance1 to your
instance name if necessary)
And run opmnctl.bat startall (or opmnctl.sh)
PREPARED BY RAVI KUMAR LANKE
Page 19

20. Setup the Apps Library
The Apps library is basically a folder in the catalog from where users can view, manage and
subscribe to published apps.
With OBIEE fully started, open a browser and login using an administrator user, then go to
the Catalog and select Shared Folders.
PREPARED BY RAVI KUMAR LANKE
Page 20

21. Use the new icon in the menu bar and select Folder.
Enter a names for the Apps Library (it doesn‟t have to be “Apps Library”!)
Under the new Apps Library folder, select More, then Permissions
PREPARED BY RAVI KUMAR LANKE
Page 21

22. At the moment you will not have any groups specifically aimed at BI Mobile users, so for
now leave the permissions as they are:
Administrators can create content, BI Consumers can access it. As you build BI Mobile
Apps you may grant specific permissions to individual users or create application/catalog
groups to manage these user. You will need to come back to this screen to set the
necessary permissions when you do.
Finally the folder you have created needs to be registered to act at the Apps Library.
Using a text editor, edit the xmlp-server-config.xml file in the directory:
<obiee_home>user_projectsdomains<bifoundation_domain>configbipublisherrepository
AdminConfiguration
Substitute <bifoundation_domain> for your domain name.
Add a line for the APPS_LIBRARY_FOLDER_LOCAL property before the </xmlpConfig>
tag.
Replace with value with the name you gave the directory above.
PREPARED BY RAVI KUMAR LANKE
Page 22

23. <property name="APPS_LIBRARY_FOLDER_LOCAL" value="/Apps Library"/>
Save the file.
PREPARED BY RAVI KUMAR LANKE
Page 23

24. Verify the installation
To verify the installation has worked, simply click on the OBIEE New dashboard link and
see if „Mobile Application‟ -> „Mobile App‟ exists:
In a few seconds the Wizard should begin…choose type of mobile device…
PREPARED BY RAVI KUMAR LANKE
Page 24

25. Then the data source…
PREPARED BY RAVI KUMAR LANKE
Page 25

26. Save it in your Apps Library folder…
PREPARED BY RAVI KUMAR LANKE
Page 26

27. And start to Create…
PREPARED BY RAVI KUMAR LANKE
Page 27