4 Configuring Oracle Business Intelligence

This chapter walks you through a step-by-step process to configure Oracle BI standard topology using the Oracle Business Intelligence 12c Configuration Assistant.

4.1 About the Oracle Business Intelligence Configuration Assistant

The Oracle Business Intelligence 12c Configuration Assistant is a multi-functional utility that helps you to create database schemas, specify a port range, create system components, and start the application servers in addition to configuring the BI standard topology. Oracle strongly recommends that you to use the Configuration Assistant to configure the BI domain.

Oracle recommends you to create the Domain home and Application home directories under /home/oracle/config. But if you use the Configuration Assistant to configure the domain, the Application home is created under /home/oracle/product directory. To achieve the recommended directory structure, configure the domain using the Configuration Wizard by following the procedure described in Configuring the BI Domain in Enterprise Deployment Guide for Oracle Business Intelligence.

4.2 Configuration Assistant Prerequisites

It is important to make sure that you meet the criteria listed in this topic for a smooth, error-free domain configuration by using the Configuration Assistant.

To verify whether the required conditions are met, see that:

  • You have correctly installed the BI product binary files.
  • You have the latest supported JDK installed on your system.
  • You have access to any one of the Oracle certified databases: Oracle, DB2, SQLServer, or RAC.
  • (Optional) You have connection details of existing RCU schema prefix (STB) and you have already created BIPLATFORM, IAU, OPSS, MDS, STB, and WLS schemas in a single session.

    Note:

    You can, alternatively, generate a schema prefix (STB) and create the BIPLATFORM, IAU, OPSS, MDS, STB, and WLS schemas while you run the BI Configuration Assistant, provided you have the DBA credentials.

Note:

The database schemas are required to store internal housekeeping information. These schemas are different from any data sources which you plan to analyze by using Oracle BI.

4.3 Prerequisite for Configuring Oracle BI EE on AIX

You need to have the bash shell and the EN_US UTF-8 character set installed on the AIX system on which you’re configuring Oracle BI EE.

If you do not have bash shell (/bin/bash) installed on your system, you may see the following error message:

oracle.bi.exec.ExecutionStatusException: Execution of [/Oracle/Middleware/OBIEEDEV/config/domains/bi_domain/bitools/bin/start.sh] failed with exit value 127

To overcome this error, install the bash shell on the system on which you’re configuring Oracle BI.

The DOMAIN_HOME/servers/obis1/logs/obis1.out file may display the following error if the EN_US.UTF-8 locale is not installed on the system on which you’re configuring Oracle BI.

[nQSError: 46116] The locale EN_US.UTF-8 needs to be installed on the machine for the Oracle BI locale setting english-usa specified in NQSConfig.INI.
Please install locale EN_US.UTF-8

As a prerequisite, install the EN_US UTF-8 character set before configuring the Oracle BI domain.

4.4 Creating the Database Schemas

Before you can configure an Oracle Business Intelligence domain, you must install required schemas on a certified database for use with this release of Oracle Fusion Middleware.

4.4.1 Installing and Configuring a Certified Database

Before you create the database schemas, you must install and configure a certified database, and verify that the database is up and running.

4.4.2 Starting the Repository Creation Utility

Start the Repository Creation Utility (RCU) after you verify that a certified JDK is installed on your system.

To start the RCU:

  1. Verify that a certified JDK already exists on your system by running java -version from the command line. For 12c (12.2.1.4.0), the certified JDK is 1.8.0_131 and later.
  2. Ensure that the JAVA_HOME environment variable is set to the location of the certified JDK. For example:
    • (UNIX) setenv JAVA_HOME /home/Oracle/Java/jdk1.8.0_131
    • (Windows) set JAVA_HOME=C:\home\Oracle\Java\jdk1.8.0_131
  3. Change to the following directory:
    • (UNIX) ORACLE_HOME/oracle_common/bin
    • (Windows) ORACLE_HOME\oracle_common\bin
  4. Enter the following command:
    • (UNIX) ./rcu
    • (Windows) rcu.bat

4.4.3 Navigating the Repository Creation Utility Screens to Create Schemas

Enter required information in the RCU screens to create the database schemas.

4.4.3.1 Introducing the RCU

The Welcome screen is the first screen that appears when you start the RCU.

Click Next.

4.4.3.2 Selecting a Method of Schema Creation

Use the Create Repository screen to select a method to create and load component schemas into the database.

On the Create Repository screen:
  • If you have the necessary permissions and privileges to perform DBA activities on your database, select System Load and Product Load. This procedure assumes that you have SYSDBA privileges.

  • If you do not have the necessary permissions or privileges to perform DBA activities in the database, you must select Prepare Scripts for System Load on this screen. This option generates a SQL script that you can give to your database administrator. See About System Load and Product Load in Creating Schemas with the Repository Creation Utility.

  • If the DBA has already run the SQL script for System Load, select Perform Product Load.

4.4.3.3 Providing Database Connection Details

On the Database Connection Details screen, provide the database connection details for the RCU to connect to your database.

Note:

If you are unsure of the service name for your database, you can obtain it from the SERVICE_NAMES parameter in the initialization parameter file of the database. If the initialization parameter file does not contain the SERVICE_NAMES parameter, then the service name is the same as the global database name, which is specified in the DB_NAME and DB_DOMAIN parameters.

For example:

  • Database Type: Oracle Database
  • Connection String Format: Connection Parameters or Connection String
  • Connection String: examplehost.exampledomain.com:1521:Orcl.exampledomain.com
  • Host Name: examplehost.exampledomain.com
  • Port: 1521
  • Service Name: Orcl.exampledomain.com
  • User Name: sys
  • Password: ******
  • Role: SYSDBA

Click Next to proceed, then click OK in the dialog window that confirms a successful database connection.

4.4.3.4 Specifying Schema Passwords

On the Schema Passwords screen, specify how you want to set the schema passwords on your database, then enter and confirm your passwords.

You must make a note of the passwords you set on this screen; you will need them later on during the domain creation process.

4.4.3.5 Completing Schema Creation

Navigate through the remaining RCU screens to complete schema creation.

On the Map Tablespaces screen, the Encrypt Tablespace check box appears only if you enabled Transparent Data Encryption (TDE) in the database (Oracle or Oracle EBR) when you start the RCU. Select the Encrypt Tablespace check box if you want to encrypt all new tablespaces that the RCU creates.

When you reach the Completion Summary screen, click Close to dismiss the RCU.

4.5 Configuring the BI Domain with the Configuration Assistant

The Oracle BI 12c Configuration Assistant is a .sh (UNIX) or .cmd (Windows) file. Start the Configuration Assistant by starting the config executable from the bi/bin directory inside the Oracle home. Follow the procedure in this topic to complete the configuration step-by-step.

Note:

Oracle recommends that you use the Oracle BI 12c Configuration Assistant to configure your 12c system.
To configure the BI standard topology:

Important:

If you are extending the WebLogic domain with Oracle Business Intelligence by using the Configuration Assistant, make sure that the Administration Server for the domain is named AdminServer. Other names for the Administration Server are not supported.

Note:

Context-sensitive help is available on each screen as you navigate through the Configuration Assistant. Click Help to seek more information about the elements on that screen.
  1. Change to the following directory:
    (UNIX) ORACLE_HOME/bi/bin
    (Windows) ORACLE_HOME\bi\bin
  2. Start the Configuration Assistant by entering the following command:
    (UNIX) ./config.sh
    (Windows) config.cmd
  3. Select the components to install and click Next.

    Note:

    To ensure that a consistent set of suites are deployed, the Configuration Assistant automatically adjusts your selection.
    • Essbase: Includes components such as Essbase Server, Cube Deployment Server, and Analytic Provider Services.
    • Business Intelligence Enterprise Edition: Includes components such as Presentation Services, Visual Analyzer, BI Composer, web services, proactive intelligence (Delivers and Actions), Web Services for SOA (WS4SOA), and Mobile Application Designer.
    • Business Intelligence Publisher: Includes Oracle BI Publisher.
  4. On the Prerequisite Checks screen, after the prerequisite checks conclude with no errors, click Next.
    If any of the prerequisite checks fail, then a short error message appears at the bottom of the screen. Fix the error and click Rerun to try again. To ignore the error or warning messages and continue with the installation, click Skip, although this approach is not recommended.

    Note:

    The configuration might not function normally if you continue without resolving the issue that caused an error or warning message during the prerequisite checks.
  5. On the Define New Domain screen, specify the following, and click Next:

    Table 4-1 Field-name descriptions for the Define New Domain screen

    Field Description
    Domains Directory Specify the path where you want to set up the domain directory.
    Domain Name Specify domain.
    Username Specify a username for the System Administrator.

    Note:

    This user is created in the embedded LDAP and is granted WebLogic Administrator permissions.
    Password Specify a password for the System Administrator.
    Confirm Password Confirm the password by reentering it.
  6. On the Database Schema screen, either create a new schema or use an existing schema by clicking the appropriate option.
    If you select to create a new schema, the Configuration Assistant creates a schema for you. Specify the following and click Next.

    Table 4-2 Field-name descriptions for the Database Schema screen

    Field Description
    Schema prefix Specify a unique schema prefix.
    Schema password Specify a password for your schema.
    Confirm password Confirm the password by reentering it.
    Database type Select the database that you are using from the list of values. Supported databases are:
    • Oracle Database

    • Microsoft SQL Server

    • IBM DB2

    Username Enter the privileged username to create the schema.
    Password Enter the password for the above username.
    Simple connect string The connect string that you specify varies depending on the type of database you are using.
    • (Oracle Database) host:port/service or host:port:SID or TNS connect string

    • (Microsoft SQL Server) hostname:port:databasename

    • (IBM DB2) //host:port;DatabaseName=dbname

    If you select to use an existing schema, you must create STB, BIPLATFORM, IAU, MDS, OPSS, and WLS schemas using the RCU. Specify the following and click Next.

    Note:

    If you are using Oracle Database version 12.2.0.1 or higher, you must create a pluggable database within a container database to create repository schemas. You cannot create schemas within a container database without using a pluggable database.
  7. On the Port Range screen, specify the port range and click Next.

    Note:

    The default, allocated port range is from 9500 to 9999, both inclusive. You can keep the default values or specify different values within this range.
  8. On the Initial Application screen, select one of the following options as per your requirement, and click Next:
  9. On the Summary screen, verify the values that you specified on each screen.
    Click Save to generate a response file used for silent installation (optional).
    Click Configure.
    The configuration process starts and the Configuration Progress screen is displayed.
  10. After the configuration concludes without any errors, click Next to go to the Configuration Complete screen.
  11. On the Configuration Complete screen, review the configuration summary.
    Click Save to save the information displayed on this screen in a file.
    Click Finish to close the Configuration Assistant.
    The BI Application opens in the browser. Use the login credentials that you specified while configuring to sign in to the BI application home.
You have configured the standard BI topology. The Configuration Assistant automatically starts the newly configured BI instance after successful completion. However, if you want to restart a domain that has been shut down manually, see Starting the BI Instance.