This document provides guidance on installing, configuring, and using Oracle BIEE 12c. It begins with instructions on downloading and installing BIEE 12c software. It then discusses configuring the Oracle BI client tool, including setting up an ODBC connection to the BI server. The document outlines the steps to create an OBI repository by importing data, upload the repository to the BI server, and provides solutions for common errors encountered during the upload process.
1. jkayodeabusi@kahfitconsulting.com |
+1 929 369 8221
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
Oracle’s patch or documentation way of doing
these.
2. jkayodeabusi@kahfitconsulting.com |
+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 Oracle’s developers VM sandbox for a pre-
configured Oracle BIEE12c SampApp and it’s deployment guide
here:http://www.oracle.com/technetwork/middleware/bi-foundation/obiee-
samples-167534.html
●
3. jkayodeabusi@kahfitconsulting.com |
+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:
6. jkayodeabusi@kahfitconsulting.com |
+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
7. jkayodeabusi@kahfitconsulting.com |
+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
●
9. jkayodeabusi@kahfitconsulting.com |
+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:OracleMiddlewareOracle_Homedomainsbiconfigfmwconfigbienvcore
●
Set TNS_ADMIN environment variable to the
location above following this:
System property==> Advanced
Setting==>Environment Variable
11. jkayodeabusi@kahfitconsulting.com |
+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
12. jkayodeabusi@kahfitconsulting.com |
+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.
14. jkayodeabusi@kahfitconsulting.com |
+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
18. jkayodeabusi@kahfitconsulting.com |
+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]
19. jkayodeabusi@kahfitconsulting.com |
+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.
20. jkayodeabusi@kahfitconsulting.com |
+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:OracleMiddlewareOracle_Homebibifoundationserverbisample01.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.
21. jkayodeabusi@kahfitconsulting.com |
+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:OracleMidlewareOracle_Homebilib” but they are not
there so, you have to copy it from the BI Server “<Oracle_Middleware_Home>/bi/lib” to
this above directory
22. jkayodeabusi@kahfitconsulting.com |
+1 929 369 8221
Be careful of your working directory
cmd-model-cmd.cmd should be in
“C:OracleMidlewareOracle_Homebibitoolsbin”
but unfortunately I found it here
“C:OracleMiddlewareOracle_Homebimodulesoracle.bi.
commandline.toolsscripts”