Document 2067527.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state...

OBIEE 12c: Quick Reference For Architecture, Lifecycle Management and File Locations (Doc ID 2067527.1)

In this Document

Purpose
Scope
Details
Logical Architecture
Documentation

Certification
Downloads
Sample Application Virtual Machine
High-level Directory Structure
File Location References:
Where are the start / stop / status and lifecyle management scripts located?
Where are the common configuration and script files located?
Where are the BI Executables?
Where are the JEE apps?
Where are the RPD and catalog located?
Where are the common diagnostic logs located?
Where are the common temporary | temp | tmp directories and cache located?
How has horizontal scale out changed?
References

APPLIES TO:

Business Intelligence Suite Enterprise Edition - Version 12.2.1.0.0 and later

Information in this document applies to any platform.

PURPOSE

This document intends to act as "quick reference" document for Oracle Business Intelligence (OBI) 12c architecture, file locations, lifecycle management,
installation and related new features. The document does not intend to supplant the official Oracle Business Intelligence documentation, rather to assist
one with as a central reference until the desired familiarity with the architectural and file locations differences (in relation to OBIEE 11g) are understood.
Documentation references will be provided when relevant. This document is a living document and will be updated as needed, feel free to provide
feedback, additions, modifications.

SCOPE

This document can be useful for anyone new to Oracle Business Intelligence Enterprise Edition 12c including administrators, consultants, sales, partners,
deployment engineers, architects, support.

DETAILS

Logical Architecture

1 of 6 11/16/2016 3:25 PM
Document 2067527.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state...

Documentation

Main: https://docs.oracle.com/middleware/1221/biee/docs.htm
Install: https://docs.oracle.com/middleware/1221/core/BIEIG/GUID-04F89ACA-A2F1-4F18-8B35-BD131ACC62ED.htm#INSOA369

Certification

OBIEE Certification is included in the main FMw 12c certification matrix

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html
System Requirements and Supported Platforms for Oracle Fusion Middleware 12c (12.2.1) ( xls)

Oracle Fusion Middleware System Requirements and Specifications 12c (12.2.1)

Downloads

Oracle Software Delivery Cloud (e-delivery)

Oracle Technology Network (OTN)

Sample Application Virtual Machine

The installation installs SampleAppLite (if selected) based on XML data

Oracle Technology Network (OTN) - SampleApp v511 when available

New terminology / topology

Reference: "New And Deprecated Terminology for 12c" in Oracle Fusion Middleware Concepts

System Administrator's Guide for Oracle Business Intelligence Enterprise Edition12c (12.2.1) -- New Features and Changes for Oracle BI EE 12c (12.2.1)

"Invoking WLST From a Single Location"

"Oracle Home Location Redefined and No Middleware Home"
"OPMN is No Longer Used in Fusion Middleware"
"Moving From Test To Production is Carried Out in a Different Way"
"New Commands For Process Control"
"Managing Metadata In Business Intelligence Archive Files"
"Single Enterprise Install"
"Changes to Scaling Out"
"Simplified Configuration"
"Managing System Component Instances Using Commands"
"Collecting Diagnostic Bundles"

High-level Directory Structure

2 of 6 11/16/2016 3:25 PM
Document 2067527.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state...

Oracle BI Domain Home: /.../Oracle_Home/user_projects/domains/bi

Single Data Directory (SDD): /.../Oracle_Home/user_projects/domains/bi/bidata
Lifecycle Management / Process Control Scripts: /.../Oracle_Home/user_projects/domains/bi/bitools/bin

File Location References:

Where are the start / stop / status and lifecyle management scripts located?

ORACLE_HOME/user_projects/domains/bi/bin - startNodeManager.sh | [startWebLogic.sh | startManagedWebLogic.sh - hint use start.sh for

weblogic (assuming node manager is running) ]
ORACLE_HOME/user_projects/domains/bi/bitools/bin - stop.sh / start.cmd | start.sh / start.cmd | status.sh / status.cmd [use -h for syntax help] -
hint: it starts the local nodemanger
ORACLE_HOME/bi/migration-tool/jlib/bi-migration-tool.jar (11g to 12c migration tool)
ORACLE_HOME/bi/lib/bi-bar.jar (CreateBIArchive java executable)

You may also continue to use Enterprise Manager Fusion Middleware Control and Weblogic Console.
Reference: System Administrator's Guide for Oracle Business Intelligence Enterprise Edition 12c (12.2.1) -- Chapter 2 Managing Oracle Business
Intelligence Processes

Using Commands to Stop, Start, and View Status of Oracle Business Intelligence Processes
Using Fusion Middleware Control to Start and Stop System and Java Components
Using Fusion Middleware Control to Start and Stop Java Components
Using Oracle WebLogic Server Administration Console to Start and Stop Java Components
Viewing the Status of Oracle Business Intelligence Components in a Domain

Where are the common configuration and script files located?

Configuration files are no longer duplicated. Separate configuration files still exist for example, for Oracle BI Presentation Services and BI Server, but they
are not duplicated in the case of a cluster.
For information, see Section 8.3, "Configuring Oracle Business Intelligence System Settings".

Weblogic configuration
/.../ORACLE_HOME/user_projects/domains/bi/config/config.xml
/.../ORACLE_HOME/user_projects/domains/bi/bin/setDomainEnv.sh/cmd

nodemanager configuration:
/.../ORACLE_HOME/user_projects/domains/bi/nodemanager |nodemanager.properties | nodemanager.domains
JDBC Data Sources
/.../ORACLE_HOME/user_projects/domains/bi/config/jdbc/..

Weblogic Scripting Tool (WLST)

/.../ORACLE_HOME/oracle_common/common/bin/wlst.sh

RCU
/.../ORACLE_HOME/oracle_common/bin/rcu

Table and Schema DDL/SQL

/.../ORACLE_HOME/oracle_common/common/sql/biplatform

Test-to-Production (T2P, X2X) / Clone

"Moving Oracle Business Intelligence Between Environments"

Sample Application XML data files

/.../Oracle_Home/bi/bifoundation/server/samples/SampleAppLite/sample/SampleAppFiles/Data

Core BI Domain
/.../Oracle_Home/user_projects/domains/bi/config/fmwconfig/biconfig/core/ bi-config.xml
/.../Oracle_Home/user_projects/domains/bi/config/fmwconfig/bienv/core/ bi-environment.xml | bienv-components.xml | tnsnames.ora |
odbc.ini

Action Framework: /.../Oracle_Home/user_projects/domains/bi/config/fmwconfig/biconfig/actions/ActionFrameworkConfig.xml

Essbase: /.../Oracle_Home/user_projects/domains/bi/config/fmwconfig/biconfig/aps/essbase.properties

3 of 6 11/16/2016 3:25 PM
Document 2067527.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state...

BI Search: /.../Oracle_Home/user_projects/domains/bi/config/fmwconfig/biconfig/bisearch/BISearchConfig.properties

Datasets: /.../Oracle_Home/user_projects/domains/bi/config/fmwconfig/biconfig/DSS/DatasetsvcConfig.properties [ dataset upload quotas ]

SSL:
/.../Oracle_Home/user_projects/domains/bi/bitools/bin/ssl.sh
/.../Oracle_Home/user_projects/domains/bi/config/fmwconfig/biconfig/bi-security

OBI Server (nqsserver)

/.../ORACLE_HOME/user_projects/domains/bi/config/fmwconfig/biconfig/OBIS/NQSConfig.INI

Presentation Server (sawserver)

/.../ORACLE_HOME/user_projects/domains/bi/config/fmwconfig/biconfig/OBIPS/instanceconfig.xml
/.../ORACLE_HOME/bi/bifoundation/web/schemas/*.xsd
/.../ORACLE_HOME/bi/bifoundation/web/display/authenticationschemas.xml
/.../ORACLE_HOME/user_projects/domains/bi/bidata/components/OBIPS/customMessages (for custom xml messaging)

ClusterController
/.../ORACLE_HOME/user_projects/domains/bi/config/fmwconfig/biconfig/OBICC/bi-cluster-config.xml
/.../Oracle_Home/user_projects/domains/bi/config/fmwconfig/biconfig/core/ClusterConfig.xml

Scheduler
/.../ORACLE_HOME/user_projects/domains/bi/config/fmwconfig/biconfig/OBISCH/schedulerconfig.xml

JavaHost
/.../ORACLE_HOME/bi/modules/oracle.bi.cam.obijh/env/obijh.properties -- 17.2.1 Increasing Heap Size to Assist in Exports to Excel
/.../ORACLE_HOME/bi/modules/oracle.bi.cam.obijh/env/startOBIJH.sh (sourced, not executed -- see obijh.properties
/.../ORACLE_HOME/user_projects/domains/bi/config/fmwconfig/biconfig/OBIJH/config.xml

Where are the BI Executables?

OBI Server | Scheduler | ClusterController: /.../ORACLE_HOME/bi/bifoundation/server/bin/ nqsserver | nqscheduler | nqsclustercontroller

PS: /.../ORACLE_HOME/bi/bifoundation/web/bin/ sawserver | catalogmanager | sawrepaj -deprecated
JavaHost: /.../ORACLE_HOME/bi/modules/oracle.bi.cam.obijh/startOBIJH.sh/cmd
Catalog Manager CLI: /.../Oracle_Home/user_projects/domains/bi/bitools/bin/runcat.sh
RDA: /../oracle_common/rda

Where are the JEE apps?

/.../Oracle_Home/bi/bifoundation/jee/ analytics.ear | xmlpserver.ear | bimad.ear | bisearch.ear | jbips.ear | bicustom.ear | ...

Where are the RPD and catalog located?

The files are located under the SDD [Singleton Data Directory] and the service instance:
for example: [DOMAIN_HOME]/service_instances/ssi/metadata (ssi is the default service instance and currently only one supported in 12.2.1)

Catalog: SDD/metadata/content
Default example: [DOMAIN_HOME]/bidata/service_instances/ssi/metadata/content/catalog

RPD (server-side): The online RPD (binary) is named liverpd.rpd. This is the "cache" binary RPD that you connect to when using the OBIEE
Administration tool in online mode. The data model itself is stored and accessed in XML. This XML file is located and named
[DOMAIN_HOME]/bidata/service_instances/[service_name]/metadata/datamodel/customizations/default/default-diff.xml
You may see "placeholder" RPD files such as liverpd.rpd_XX when you upload an RPD. The liverpd.rpd_XX will exist until converted to XML.
You upload and download the RPD via the data-model-cmd .sh|.cmd command-line API (for reference, see Doc Id 2067354.1).

RPD (client-side): When you create a new repository using admin tool, the repository can be of 2 formats: Binary or MDS XML
RPD Binary format stores repository as rpd file.
Default RPD Location : New rpd file is stored by default in repository sub-directory under C:[client install location]\bi
\bifoundation\server
MDS XML format stores repository as MDS XML Documents
For MDS XML format repositories, select|choose a root folder location for the set of MDS XML files.

Where are the common diagnostic logs located?

/.../ORACLE_HOME/user_projects/domains/bi/servers/obis1/logs/FineGrainedLogDir (on-line RPD udxml logs)

4 of 6 11/16/2016 3:25 PM
Document 2067527.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state...

Weblogic
Administration Server: [DOMAIN_HOME]/servers/AdminServer/logs - AdminServer-diagnostic.log | AdminServer.log | AdminServer.out
Managed Server: [DOMAIN_HOME]/servers/bi_server1/logs - bi_server1-diagnostic.log | bi_server1.log | bi_server1.out
Nodemanager: [DOMAIN_HOME]/nodemanager/nodemanager.log
System Components
OBI Server: [DOMAIN_HOME]/servers/obis1/logs - obis1.out | obis1-diagnostic.log | obis1-query.log | oracle_BiServerXmlGen.log |
oracle_nQSecUDMLGen.log
Presentation Server: [DOMAIN_HOME]/servers/obips1/logs - sawlog0.log | obips1.out | webcateupgrade0.log | upgrade-[date stamp].log
Catalog Manager: [DOMAIN_HOME]/servers/obips1/logs/catalogmanager - catalogmanager.0.0.log
Scheduler:[DOMAIN_HOME]/servers/obisch1/logs - nqscheduler.log | obisch1.out
JavaHost: [DOMAIN_HOME]/servers/obijh1/logs - jh.log | obijh1.out
ClusterController:[DOMAIN_HOME]/servers/obiccs1/logs - nqcluster.log | obiccs1.out
Other
Mapviewer: [DOMAIN_HOME]/config/fmwconfig/mapviewer/log/mapviewer.log
JBIPS: [DOMAIN_HOME]/servers/bi_server1/logs/jbips.log

Where are the common temporary | temp | tmp directories and cache located?

System Components
OBI Server:
[DOMAIN_HOME]/servers/obis1/tmp
[DOMAIN_HOME]/servers/obis1/tmp/obis_temp
[DOMAIN_HOME]/servers/obis1/cache
[DOMAIN_HOME]/servers/obis1/MDXCache
Global Cache - no default, user defined

Presentation Server: [DOMAIN_HOME]/servers/obips1/tmp

Scheduler: [DOMAIN_HOME]/servers/obisch1/tmp

JavaHost:
[DOMAIN_HOME]/servers/obijh1/tmp
[DOMAIN_HOME]/system_components/OBIJH/obijh1/tmp
other as defined in JavaHost configuratoin file (e.g. ramdisk)

How has horizontal scale out changed?

The scale-out procedure has been simplified.

Logical architecture

5 of 6 11/16/2016 3:25 PM
Document 2067527.1 https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state...

"Scaling Your Deployment"

"Deploying Oracle Business Intelligence for High Availability"

REFERENCES

NOTE:2066868.1 - OBIEE 12c FAQ: Does OBIEE 12c (12.2.1) Support Multiple Service Instances?
NOTE:2064302.1 - OBIEE 12c: Quick Reference For Oracle Business Intelligence Enterprise 12c (12.2.1) Installation
Didn't find what you are looking for?

6 of 6 11/16/2016 3:25 PM