You are on page 1of 17

Deploying/upload rpd in OBIEE 12.2.1.

0 /
12c server
Posted on November 15, 2015 by Kishore & Naresh

Standard
Dear All,

We will learn how to upload / deploy new rpd in obiee 12c server.
Unlike in 11g, em does not have any option for deployments of rpd, it is all now uploading repository to a specific
service instance. we should be using weblogic scripting command uploadrpd to upload repository to Oracle BI
Server.
You execute the utility through a launcher script, data-model-cmd.sh on UNIX and data-model-cmd.cmd on
Windows. You can find the launcher script at the following location:
<Oracle_Home>/user_projects/domains/bi/bitools/bin
>wlst.cmd
Syntax:
uploadrpd -I <RPDname> [-W <RPDpwd>] -SI <service_instance> -U <cred_username> [-P <cred_password>] [S <hostname>] [-N <port_number>] [-SSL] [-H]

I specifies the name of the repository that you want to upload.


W is the repositorys password. If you do not supply the password, then you will be prompted for the

password when the command is run. For security purposes, Oracle recommends that you include a
password in the command only if you are using automated scripting to run the command.
SI specifies the name of the service instance.
U specifies a valid users name to be used for Oracle BI EE authentication.
P specifies the password corresponding to the users name that you specified for U. If you do not supply

the password, then you will be prompted for the password when the command is run. For security
purposes, Oracle recommends that you include a password in the command only if you are using
automated scripting to run the command.
S specifies the Oracle BI EE host name. Only include this option when you are running the command

from a client installation.


N specifies the Oracle BI EE port number. Only include this option when you are running the command

from a client installation.


SSL specifies to use SSL to connect to the WebLogic Server to run the command. Only include this

option when you are running the command from a client installation.
H displays the usage information and exits the command.
Example: data-model-cmd.sh uploadrpd -I <RepositoryName.rpd> -SI ssi -U weblogic -S server.example.com -N
9502 -SSL

Note: Using uploadrpd, we can upload an Oracle BI repository in RPD format and cannot upload a repository
composed of MDS XML documents.
The online rpd in the server is with name liverpd.rpd_n (n is integer with increased number) and can be found
at: <Oracle_Home>\user_projects\domains\bi\bidata\service_instances\ssi\metadata\datamodel\customizations
You can log into analytics and see the subject area contents of new rpd with changes affected.
You can also download current online rpd from server which acts as offline rpd on which you will be developing
your changes or for any diagnose purpose
syntax: downloadrpd -O RPDname [-W RPDpwd] -SI service_instance -U cred_username [-P cred_password] [S hostname] [-N port_number] [-SSL] [-H]

rpd will be saved under the same location where you executed above command..

OBIEE 12c remote repository


download/upload

Posted on: 12 November 2015


By: andrew

One of the most interesting features of OBIEE 12c is an ability to download/upload a


repository with command-line utility without using OEM and the best part of all:
without restarting of an Analytics server! But when I tried to use it and upload a
repository from my developer workstation to a server, I've faced two issues.
Disclaimer. This post is a result of my personal investigation. It's neither
documented nor supported by Oracle.Following this guide is on your own
responsibility.

Update Dec 12, 2015 This is now documented: 1.2.4 Error When Running datamodel-cmd.cmd Launcher Script. The bug 22095286 BI-LCM TOOLS NOT WORKING
FROM CLIENT INSTALLATION will be fixed in 12.2.3 (My Oracle Support).
The first issue was that the data-model-cmd.cmd script wasn't where I've been
expected to find it. I thought that it should be in
the C:\Oracle\Middleware\Oracle_Home\bi\bitools\bin folder by analogy with
Linux installation. There is a script in the analogous directory on Linux server. It's
pretty small and does two things: defines the DOMAIN_HOME environment variable
and calls $ORACLE_HOME/bi/modules/oracle.bi.commandlinetools/scripts/datamodel-cmd.cmd script. But it wasn't there. I found only a script in
the %ORACLE_HOME%\bi\modules\oracle.bi.commandlinetools\scripts folder.

I tried to call the script I've found with -H (help) flag...

..and got an error:

Error text for google users


Hm, "java.lang.ClassNotFoundException" it looks like something is missing. Take a
look at this script text: "bi-blocking-metadata-update.jar" and "bi-customizationutils.jar" are supposed to be in the !BI_CLIENT_HOME!\lib folder.

But they are not there.

The good news is that I have a server installation with these jars (I wouldn't need all
this if I haven't had one :) ).

These are the jars we are looking for.

I copied them into ORACLE_HOME\bi\lib folder of my Windows (Windows 10 by the


way) machine.

Help command works well. It shows commands we can use.

Command name with an -H flag shows help for the command.

Sample for download a repository from my server.

A few seconds and a repository file is on my Windows machine. Now I can edit it in
on offline mode as usual.

And I can upload it to a server. Without OEM. Without restarting a server.

Disclaimer. This post is a result of my personal investigation. It's neither


documented nor supported by Oracle. Following this guide is on your own
responsibility.

Unravel OBI 12c RPD features


Installed the latest version of OBIEE 12c yet? If yes, then you would have
totally been yapping about the cool data visualizations available from Visual
Analyzer.
Also by default with Oracle BI 12c, sample repository is provided having
best practices for modelling many different types of objects. A basic version
of rpd is already installed as the default repository.
But if you want to start building your own rpd and start seeing some
reports, there are some facts you should be aware of.
RPD deployment option is no longer available in 12c EM (as in when
compared with 11g).

Below are some repository commands required for rpd deployment, but
before that let's look at a pre-fix to be performed before using those
commands.

'data-model-cmd.cmd'
This command is used to run any of new command line tools (including for
upload/download) of rpd.
However there is a certain "ClassNotFoundException" message that
appears in command box when run on windows (no issues
for Linux installation).

A simple fix as per the Oracle docs for this would be to copy the "bicommandline-tools.jar" from the full server installation (in this case it's
Linux machine location: "Oracle_Home/bi/lib")

Navigate to OBIEE Client installation and paste it in


"Oracle_Home/bi/lib"

Go to the following link to read more about the pre-fix: Error when running
data-model-cmd.cmd Launcher Script

'RPD download command'


Using this command OBIEE 12c repository is downloaded to the desired
location. RPD modelling/backup can be performed.
'downloadrpd' command takes the following parameters:
downloadrpd -O RPDname [-W RPDpwd] -SI service_instance -U
cred_username [-P cred_password] [-S hostname] [-N port_number] [SSL] [-H]
Note:
-O specifies the location/rpd name where repository is to be downloaded
(miscorrection in Oracle docs)
SI specifies the service instance. Finds its name at
/user_projects/domains/bi/bidata/service_instances/

Service Instance name can also be found by navigating to Administration


tab in analytics page at the Presentation Catalog path

Go to the following link to read more: Download Repository Command

Test and refine rpd (nqcmd) command:


After completion of work on repository, to run sample queries (sanity
testing, not for heavy load testing) use the "nqcmd". This is an Oracle BI
server utility available both on UNIX and Windows systems.

Navigate to: ORACLE_HOME/user_projects/domains/bi/bitools/bin


Sample parameters used:
nqcmd -dmy_dsn -umy_username [-pmy_password] -ssql_input_file
-omy_result_file
Go to the following link to read more: Using nqcmd to Test and Refine the
Repository

RPD validaterpd Command:


Its used to check the validity of all metadata objects in a repository. This
utility performs the same validation checks as the consistency check
manager in Admin tool performs.
The location of the validaterpd utility is:
ORACLE_HOME/user_projects/domains/bi/bitools/bin

validaterpd utility takes the following parameters:


validaterpd {-R repository_name | -I input_file_pathname |
-D MDS_XML_document_directory} [-P repository_password] {-O
output_txt_file_name |
-C output_csv_file_name | -X output_xml_file_name} [-8] [-F
fixed_rpd_name] [-S] [-B]

Go to the following link to read more: Validaterpd Utility

RPD Upload Command:


To upload the rpd to BI server, use the "uploadrpd" command (does not
work if repository composed of MDS XML documents).
uploadrpd command takes the following parameters:
uploadrpd -I <RPDname> [-W <RPDpwd>] -SI <service_instance> -U
<cred_username> [-P <cred_password>] [-S <hostname>] [-N
<port_number>] [-SSL] [-H]
Note:
I specifies location/name of repository you want to upload.

Linux Terminal

Windows Command prompt

Go to the following link to read more: Upload Repository Command