Oracle BIEE 12c:

Installation and Configuration

Issues, Errors and How I Fix Them

The following suggestions is based on my

personal knowledge, idea and solutions as I work
with OBIEE 12c. This does not necessarily reflect
Oracles patch or documentation way of doing
these.

[email protected] |
+1 929 369 8221
 What You Need to Do or Know First

You can download Oracle BIEE 12c software from here:
http://www.oracle.com/technetwork/middleware/bi-enterprise-
edition/downloads/business-intelligence-2717951.html

You can install Oracle BIEE12c based on Oracle documentation
here:http://docs.oracle.com/en/middleware/middleware.html

For Independent installation guide, you can check the following links for
both Windows OS and Linux OS based systems step by step guide:
http://ssssupport.blogspot.com/2015/10/installing-oracle-obiee-12c-in-windo
ws.html

https://bisoftdiary.com/obiee12c_linux_installation/

You can also download Oracles developers VM sandbox for a pre-
configured Oracle BIEE12c SampApp and its deployment guide
here:http://www.oracle.com/technetwork/middleware/bi-foundation/obiee-
samples-167534.html

[email protected] |
+1 929 369 8221
 Oracle BI Client Tool

Oracle BI Tools is used to connect with BI

Server to create complete repository (Physical,
Business Model and Presentation Layer),
Upload to the server and do some other stuff
from the client development point of view.

It can be downloaded from here:

And installation is just a click away as this tool

only run on Windows OS. You can also get the
installation guide here:

[email protected] |
+1 929 369 8221
 Configuring OBI Client Tool for
System DNS

Click Start botton, Windows Administrative

Tools, ODBC, System DNS:

[email protected] |
+1 929 369 8221
 Configuring OBI Client Tool for
System DNS Continued

Click and choose Oracle BI Server-

Oracle_Home and Finish

[email protected] |
+1 929 369 8221
 Configuring OBI Client Tool for
System DNS Continued

Give your ODBC connection name and provide

the BI server name or IP address

[email protected] |
+1 929 369 8221
 Configuring OBI Client Tool for
System DNS Continued

Provide the User Name, Password and the Port

Number of your BI Server

[email protected] |
+1 929 369 8221
 Configuring OBI Client Tool for
System DNS Continued

Leave everything at default here and click finish

[email protected] |
+1 929 369 8221
 The Work Around
The Connection Has Failed Error in Oracle BIEE 12c

You need to copy your tnsname.ora file from

<ORACLE_HOME/network/admin> from
database server to this location in your BI Client
Tool installation directory like mine:
C:\Oracle\Middleware\Oracle_Home\domains\bi\config\fmwconfig\bienv\core

Set TNS_ADMIN environment variable to the

location above following this:
System property==> Advanced
Setting==>Environment Variable

[email protected] |
+1 929 369 8221
 Screen shot

[email protected] |
+1 929 369 8221
 Creating OBI Repository

Lunch your BI Client Tool: Administration

==>File==>New Repository as the image below

Provide Repository Name, User Name and

Password and click Next

[email protected] |
+1 929 369 8221
Creating OBI Repository Continued

Next is to provide your Data Source info. In my

case, Connection Type is and must be OCI
10g/11g if you are accessing Oracle DB and
ODBC for third party DB, pdborcl is my
database name(SID/Service Name)where my
analyzed data will come from while bisample is
my schema/user name and the password for it.

[email protected] |
+1 929 369 8221
Creating Repository Continued.

[email protected] |
+1 929 369 8221
 Creating Repository Continued

Next is to select your Metadata Types and you

can accept the default as below and click next

[email protected] |
+1 929 369 8221
 Creating Repository Continued

Export your table, in my case

SAMP_ADDRESSES_D to Repository View
and click Finish

[email protected] |
+1 929 369 8221
 Repository Creation Continued

Then you should be welcomed to the Physical

Layer of BI Repository Creation

[email protected] |
+1 929 369 8221
 My Completed and Uploaded
Repository: bisample01.rpd

Your complete, ready for upload should be

similar to this.

[email protected] |
+1 929 369 8221
 Uploading Your Repository

Unlike previous releases where Enterprise

Manager is used to upload repository, OBIEE
12c used WLS command script to do so.

data-model-cmd.cm in Windows OS and data-

model-cmd.sh on Unix/Linux OS .

uploadrpd -I <RPDname> [-W <RPDpwd>] -SI <service_instance> -U <cred_username>

[-P <cred_password>] [-S <hostname>] [-N <port_number>] [-SSL] [-H]

[email protected] |
+1 929 369 8221
 Uploading Your Repository
Where

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

W is the repository's 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 user's name to be used for Oracle BI EE authentication.

P specifies the password corresponding to the user's 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.

[email protected] |
+1 929 369 8221
 Sample Command to Upload

My personal example of how I put my commands together to

perform upload
data-model-cmd.cmd uploadrpd -I C:\Oracle\Middleware\Oracle_Home\bi\bifoundation\server\bisample01.rpd -W Admin123 -SI ssi -U
weblogic -P Admin123 -S 169.254.110.151 -N 7780

The next slides provide solution to the errors you may encountered
while performing this operation.

[email protected] |
+1 929 369 8221
 data-model-cmd.cmd upload
command error:
Exception in thread "main" java.lang.NoClassDefFoundError:
oracle/bi/lcm/metadata/MetadataUpdateException
at oracle.bi.utils.BIExec.main(BIExec.java:25) Caused by:
java.lang.ClassNotFoundException: oracle.bi.lcm.metadata.MetadataUpdateException
at java.net.URLClassLoader.findClass(Unknown Source) at
java.lang.ClassLoader.loadClass(Unknown Source) at
sun.misc.Launcher$AppClassLoader.loadClass(Unknown Source) at
java.lang.ClassLoader.loadClass(Unknown Source) ... 1 more

These two jar files "bi-blocking-metadata-update.jar" and "bi-customization-utils.jar"

should be in this directory: C:\Oracle\Midleware\Oracle_Home\bi\lib but they are not
there so, you have to copy it from the BI Server <Oracle_Middleware_Home>/bi/lib to
this above directory

[email protected] |
+1 929 369 8221
Be careful of your working directory

cmd-model-cmd.cmd should be in
C:\Oracle\Midleware\Oracle_Home\bi\bitools\bin
but unfortunately I found it here

C:\Oracle\Middleware\Oracle_Home\bi\modules\oracle.bi.
commandline.tools\scripts

[email protected] |
+1 929 369 8221
 John Kayode-Abusi
Data Science & Cyber Security Expert
[email protected]

[email protected] |
+1 929 369 8221