Skip to content
  • Technology & data

Installing an Oracle BI 12C cluster

by Antony Heljula

Here, we are going to explain how to scale out a standalone OBIEE 12c node to a 2-node cluster.

The scale-out process with 12c is very different to the previous 11g version, since you perform more manual steps using the command line rather than via a GUI.   But the overall process is a lot slicker / simpler than 11g.

Before we start to scale-out, you should have the first OBIEE node completely installed and working.  The second node should also be installed (weblogic and OBIEE) but not configured (using  

Furthermore, you need a shared file system mounted at the same location on both nodes, this shared folder is where the RPD, catalog and cache get stored (you no longer have RPDs stored locally on each BI Server).

The shared file system can be a network share (e.g. NFS) or a clustered file system (e.g. OCFS2).


  • You have two OBIEE servers e.g. binode1 and binode2

  • You have shared storage (e.g. clustered file system or network share) accessible to both servers and is mounted at the same location on both. For example:

    • /app/oracle/oraclebi_shared

  • On the first server (binode1) you have performed the following tasks:

    • Installed Weblogic Server

    • Installed Oracle BI 12c

    • Run the configuration for Oracle BI 12c (

  • On the second server (binode2) you have performed the following:

    • Installed Weblogic Server To the exact same locations

    • Installed Oracle BI 12c } as on binode1

NOTE: You should not run the OBIEE utility on binode2


  1. binode1: Stop your OBIEE environment:


  2. binode1: Edit the “bi-environment.xml” file and set the location of the shared folder that you intend to use as the OBIEE cluster share location

    [home]/user_projects/domains/bi/config/fmwconfig/bienv/    core/bi-environment.xml




    NOTE:  You need to copy your existing "bidata" folder locationto this shared location.
    The folder is located in your Domain Home e.g. [home]/user_projects/domains/bi/bidata

  3. binode1: Start your OBIEE environment:


  4. Log on to Enterprise Manager as weblogic:


  5. Navigate to “Business Intelligence > biinstance > Configuration > Performance

  6. Click “Lock & Edit”:

  7. Set the location and size of your BI “global cache”, the location should be on your shared folder location:

    e.g. /app/oracle/oraclebi_share/bicache

  8. Click “Apply”

  9. Click “Activate Changes”

  10. binode1: Log on as your oracle user and navigate to   the following folder:

  11. binode1: Stop your OBIEE environment:

  12. binode1: Run the following command to create a pack  file to scale out your 2nd node:
    ./ [-m <new machine name>]  <new machine ip address> <pack file>
    ./ -m binode2   binode2.jar

  13. binode1: Copy the pack file (e.g. binode2.jar) to binode2

  14. Binode2: Log on as your oracle user to binode2 and run the following command:[home]/oracle_common/common/bin/ -domain=[home]/user_projects/domains/bi -template=     [pack file]
    /app/oracle/oraclebi/oracle_common/common/bin/ -domain=/app/oracle/oraclebi/user_projects/domains/bi -template=/home/oracle/binode2.jar

  15. binode1: Login again as oracle to your binode1, change directory to the “bitools/bin” folder

  16. binode1: Run the following command:

  17. binode1: Copy the contents of the original local “bidata” folder to the equivalent folder on your shared folder location. For example:
    cp -R /app/oracle/oraclebi/user_projects/domains/bi/bidata /app/oracle/oraclebi_share

  18. binode2: On your new machine binode2, start Node Manager: nohup [home]/user_projects/domains/bi/bin/ &

  19. binode1: Back on binode1, start your OBIEE environment once again:

Your clustered OBIEE environment will now start……and the bi_server2 managed server will be created, so it will take longer than usual to start up! That's it..!!

Antony Heljula's avatar

Antony Heljula

Technology Director

Contact Antony

Our recent blog posts

Transformation is for everyone. We love sharing our thoughts, approaches, learning and research all gained from the work we do.

Air Quality Newcastle (1)

Predicting and monitoring air quality

How we delivered an end-to-end forecasting solution for predicting the values of the air pollutant, PM2.5, in Newcastle.

Turbocharging Power BI performance

How external tools can improve the performance of Power BI semantic models.

Hash keys, the unsung hero of data warehousing - Part 2

We delve into the examples and benefits of using hash keys to improve data warehousing solutions