Вы находитесь на странице: 1из 27
Installing the Oracle BI Mobile App Designer PREPARED BY RAVI KUMAR LANKE Page 1

Installing the Oracle BI Mobile App Designer

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

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” to make the script executable.

PATH On linux also run “ chmod 777 setpaths.sh” to make the script executable. PREPARED BY
PATH On linux also run “ chmod 777 setpaths.sh” to make the script executable. PREPARED BY

Now open a command window (in windows open this as “run as administrator”), and cd to your temporary directory and run setpaths.bat (.sh)

as administrator”), and cd to your temporary directory and run setpaths.bat (.sh) PREPARED BY RAVI KUMAR
as administrator”), and cd to your temporary directory and run setpaths.bat (.sh) PREPARED BY RAVI KUMAR
as administrator”), and cd to your temporary directory and run setpaths.bat (.sh) PREPARED BY RAVI KUMAR
as administrator”), and cd to your temporary directory and run setpaths.bat (.sh) PREPARED BY RAVI KUMAR

Then cd into the 17004920 sub-directory and run „opatch apply‟

into the 17004920 sub- directory and run „opatch apply‟ If the verify passes, enter „y‟ to

If the verify passes, enter „y‟ to continue with the patch. It should only take a few minutes.

continue with the patch. It should only take a few minutes. Leave this window open, you‟ll

Leave this window open, you‟ll need it again in a mo.

only take a few minutes. Leave this window open, you‟ll need it again in a mo.
only take a few minutes. Leave this window open, you‟ll need it again in a mo.

Install Oracle BI Mobile App Designer There are four steps to installing the Mobile App Designer:

1. Apply the patch file

2. Deploy the Mobile App Designer to Weblogic

3. Setup the Security for the Mobile App Designer

4. 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.

script again. There is no prompting on this patch, it just installs straight away. PREPARED BY
script again. There is no prompting on this patch, it just installs straight away. PREPARED BY
Do not start weblogic or OBIEE just yet, but leave this window open. PREPARED BY

Do not start weblogic or OBIEE just yet, but leave this window open.

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

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:

splash screen, select „Extend an existing WebLogic domain: Then select the domain to extend – it

Then select the domain to extend it should default to the domains directory, so select the domain from under there.

it should default to the domains directory, so select the domain from under there. PREPARED BY
it should default to the domains directory, so select the domain from under there. PREPARED BY
Next check the option “Extend my domain using an existing extension template‟, then use the

Next check the option “Extend my domain using an existing extension template‟, then use the browse button to locate the file

<obiee_home>\Oracle_BI1\common\templates\applications\oracle.bimad_template_11.1.1.j

ar

ar PREPARED BY RAVI KUMAR LANKE Page 8
ar PREPARED BY RAVI KUMAR LANKE Page 8
PREPARED BY RAVI KUMAR LANKE Page 9
PREPARED BY RAVI KUMAR LANKE Page 9
PREPARED BY RAVI KUMAR LANKE Page 9

On the JDBC Component Schema config screen leave the settings as they are and just click next

Component Schema config screen leave the settings as they are and just click next PREPARED BY
Component Schema config screen leave the settings as they are and just click next PREPARED BY
Component Schema config screen leave the settings as they are and just click next PREPARED BY

On the the JDBC Component Schema test screen we don‟t want to perform any tests, so just click next again.

Schema test screen we don‟t want to perform any tests, so just click next again. PREPARED
Schema test screen we don‟t want to perform any tests, so just click next again. PREPARED
Schema test screen we don‟t want to perform any tests, so just click next again. PREPARED

There are no Optional Configurations required, so just click next.

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

On the Configuration Summary screen click „Extend‟ to begin.

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

The extension only takes a few seconds. Click Done to close the config wizard.

The extension only takes a few seconds. Click Done to close the config wizard. PREPARED BY
The extension only takes a few seconds. Click Done to close the config wizard. PREPARED BY
The extension only takes a few seconds. Click Done to close the config wizard. PREPARED BY

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>\instances\instance1\config\OracleBIPresentationServicesComponent\corea

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.

</AdvancedReporting> Save the file and close your editor. PREPARED BY RAVI KUMAR LANKE Page 15
</AdvancedReporting> Save the file and close your editor. PREPARED BY RAVI KUMAR LANKE Page 15

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_projects\domains\bifoundation_domain\bin directory and run startWebLogic.cmd (.sh).

directory and run startWebLogic.cmd (.sh). and wait for the 'started in RUNNING mode' message.

and wait for the 'started in RUNNING mode' message.

(.sh). and wait for the 'started in RUNNING mode' message. PREPARED BY RAVI KUMAR LANKE Page
(.sh). and wait for the 'started in RUNNING mode' message. PREPARED BY RAVI KUMAR LANKE Page
(.sh). and wait for the 'started in RUNNING mode' message. PREPARED BY RAVI KUMAR LANKE Page

Once WebLogic is running you need to run a WLST script. Open a new command window and change directory to the <obiee_home>\Oracle_BI1\bifoundation\install directory

Now run the following command, substituting the <hostname> and <Weblogic administrator name> fields as appropriate:

<obiee_home>\Oracle_BI1\common\bin\wlst.cmd addMADCodeGrants.py t3://<hostname>:7001 <WebLogic administrator name>

Note it‟s <obiee_home>\Oracle_BI1\common\bin\wlst.sh… on Lunix

\Oracle_BI1\common\bin\ wlst.sh… on Lunix You‟ll be prompted to enter the password for the Weblogic

You‟ll be prompted to enter the password for the Weblogic Admin user, then the script will complete in a few seconds.

for the Weblogic Admin user, then the script will complete in a few seconds. PREPARED BY
for the Weblogic Admin user, then the script will complete in a few seconds. PREPARED BY
Now complete the start-up of OBIEE. You can either stop the weblogic server above (stopweblogic.cmd/sh)

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_projects\domains\bifoundation_domain\bin directory and run startManagedWebLogic.cmd (.sh) with the BI Server name as the parameter:

startManagedWebLogic.cmd bi_server1

(.sh) with the BI Server name as the parameter: startManagedWebLogic.cmd bi_server1 PREPARED BY RAVI KUMAR LANKE
(.sh) with the BI Server name as the parameter: startManagedWebLogic.cmd bi_server1 PREPARED BY RAVI KUMAR LANKE
(.sh) with the BI Server name as the parameter: startManagedWebLogic.cmd bi_server1 PREPARED BY RAVI KUMAR LANKE

Wait for „started in RUNNING mode‟ message:

Wait f or „started in RUNNING mode‟ message : Then minimise this window (do not close)

Then minimise this window (do not close) and open a new command window and start the opmn:

Change directory to <obiee_home>\instances\instance1\bin instance name if necessary)

(change instance1 to your

And run opmnctl.bat startall (or opmnctl.sh)

necessary) (change instance1 to your And run opmnctl.bat startall (or opmnctl.sh) PREPARED BY RAVI KUMAR LANKE
necessary) (change instance1 to your And run opmnctl.bat startall (or opmnctl.sh) PREPARED BY RAVI KUMAR LANKE
necessary) (change instance1 to your And run opmnctl.bat startall (or opmnctl.sh) PREPARED BY RAVI KUMAR LANKE

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.

using an administrator user, then go to the Catalog and select Shared Folders. PREPARED BY RAVI
using an administrator user, then go to the Catalog and select Shared Folders. PREPARED BY RAVI
using an administrator user, then go to the Catalog and select Shared Folders. PREPARED BY RAVI

Use the new icon in the menu bar and select Folder.

Use the new icon in the menu bar and select Folder. Enter a names for the

Enter a names for the Apps Library (it doesn‟t have to be “Apps Library”!)

Apps Library (it doesn‟t have to be “Apps Library”! ) Under the new Apps Library folder,

Under the new Apps Library folder, select More, then Permissions

Library”! ) Under the new Apps Library folder, select More, then Permissions PREPARED BY RAVI KUMAR
Library”! ) Under the new Apps Library folder, select More, then Permissions PREPARED BY RAVI KUMAR
Library”! ) Under the new Apps Library folder, select More, then Permissions PREPARED BY RAVI KUMAR

At the moment you will not have any groups specifically aimed at BI Mobile users, so for now leave the permissions as they are:

Mobile users, so for now leave the permissions as they are: Administrators can create content, BI

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_projects\domains\<bifoundation_domain>\config\bipublisher\repository

\Admin\Configuration

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.

tag. Replace with value with the name you gave the directory above. PREPARED BY RAVI KUMAR
tag. Replace with value with the name you gave the directory above. PREPARED BY RAVI KUMAR

<property name="APPS_LIBRARY_FOLDER_LOCAL" value="/Apps Library"/>

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

Save the file.

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

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:

„Mobile Application‟ -> „Mobile App‟ exists: In a few seconds the Wizard should begin…choose type of

In a few seconds the Wizard should begin…choose type of mobile device…

exists: In a few seconds the Wizard should begin…choose type of mobile device… PREPARED BY RAVI
exists: In a few seconds the Wizard should begin…choose type of mobile device… PREPARED BY RAVI
exists: In a few seconds the Wizard should begin…choose type of mobile device… PREPARED BY RAVI

Then the data source

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

Save it in your Apps Library folder

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

And start to Create

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