Installing 11g Warehouse Builder (OWB)

Author: James L. Colestock Create Date: 02/09/08 Last Modified Date: 02/09/08 Summary: Purpose of this guide is to document the steps required to install and initially configure a properly working 11g Warehouse Builder installation. In this example, I use a single 11.1.0.6 database on Linux for the Repository, Runtime, and Target schemas. Pre-configure the Database: 11g now ships automatically with most of the Oracle Warehouse Builder technology stack. If the OWBSYS user does not already exist, run the DBCA to add this schema. OWB on 11g will automatically tune the instance to meet the prerequisites, except for the utl_file_dir parameter:
SQL> alter system set utl_file_dir='/tmp' scope=spfile; System altered. SQL> shutdown immediate; ORACLE instance shut down. SQL> startup ORACLE instance started. Total System Global Area 422670336 bytes Fixed Size 1300352 bytes Variable Size 390072448 bytes Database Buffers 25165824 bytes Redo Buffers 6131712 bytes Database mounted. Database opened.

Make sure that the $OWB_HOME/network/admin directory has the appropriate networking files in order to connect to your repository:
[/u03/app/oracle/product/db/11.1.0.6/owb/bin/unix nf@rac2]$ cp $TNS_ADMIN/* $ORACLE_HOME/owb/network/admin/. cp: omitting directory `/u03/app/oracle/product/db/11.1.0.6/network/admin/samples' [/u03/app/oracle/product/db/11.1.0.6/owb/bin/unix nf@rac2]$ ls -lart $ORACLE_HOME/owb/network/admin/. total 24 drwxr-xr-x 3 oracle dba 4096 Oct 4 09:14 .. -rw-r--r-- 1 oracle dba 896 Feb 7 23:46 tnsnames.ora -rw-r--r-- 1 oracle dba 102 Feb 7 23:46 sqlnet.ora -rw-r--r-- 1 oracle dba 187 Feb 7 23:46 shrept.lst -rw-r--r-- 1 oracle dba 1040 Feb 7 23:46 listener.ora drwxr-xr-x 2 oracle dba 4096 Feb 7 23:46 .

Unlock the OWBSYS user:

[/u03/app/oracle/product/db/11.1.0.6/owb/bin/unix nf@rac2]$ sqlplus "/ as sysdba" SQL> alter user OWBSYS account unlock; User altered.

Page 1 of 10

Installing 11g OWB

2/9/2008

Run the Repository Assistant:

[/u03/app/oracle/product/db/11.1.0.6/owb/bin/unix nf@rac2]$ export DISPLAY=192.168.1.104:0.0 [/u03/app/oracle/product/db/11.1.0.6/owb/bin/unix nf@rac2]$ ./reposinst.sh

Here are the screen shots for this process:

Page 2 of 10

Installing 11g OWB

2/9/2008

Page 3 of 10

Installing 11g OWB

2/9/2008

Verify the efficacy of your install via the following checks:

[/u03/app/oracle/product/db/11.1.0.6/owb/bin/unix nf@rac2]$ cd ../admin [/u03/app/oracle/product/db/11.1.0.6/owb/bin/admin nf@rac2]$ more rtrepos.properties #Runtime Properties #Fri Feb 08 00:01:38 GMT-07:00 2008 repos.77.tag=15CF4D3CFCE33DC5152658FFBDB33CE8 [/u03/app/oracle/product/db/11.1.0.6/owb/rtp/sql nf@rac2]$ sqlplus owbsys@nf SQL> select * from owbsys.wb_rt_service_nodes;
NODE_ID INSTANCE_NUMBER HOST PORT SERVICE_NAME ENABLED RUNTIME_VERS SERVER_SIDE_HOME ------- --------------- -------------------- ---------- -------------------- ------- ------------ ----------------------------------1 1 RAC2.COLESTOCK.TEST 1523 NF.COLESTOCK.TEST 1 11.1.0.6.0 /u03/app/oracle/product/db11.1.0.6 /

SQL> select * from owbsys.owbrtps; KEY VALUE ---------------------------------------- ---------------------------------------11.1.0.6.0[1] /u03/app/oracle/product/db/11.1.0.6

[/u03/app/oracle/product/db/11.1.0.6/owb/rtp/sql nf@rac2]$ sqlplus owbsys@nf @service_doctor.sql Role set. >>>>>> There are errors in one or more PL/SQL packages and functions Platform properties have been loaded correctly Platform location has been seeded correctly NLS messages have been loaded correctly >>>>>> The platform service is not available Service script is accessible to the database server Connection information stored within the repository is correct

Page 4 of 10

Installing 11g OWB

2/9/2008

Start the Control Center Service:

[/u03/app/oracle/product/db/11.1.0.6/owb/rtp/sql nf@rac2]$ sqlplus owbsys@nf @show_service Role set. Not Available PL/SQL procedure successfully completed. SQL> @start_service.sql Role set. Available PL/SQL procedure successfully completed. SQL> @show_service.sql Role set. Available PL/SQL procedure successfully completed. [/u03/app/oracle/product/db/11.1.0.6/owb/rtp/sql nf@rac2]$ ps -ef | grep owb | grep -v grep | wc -l 2
[/u03/app/oracle/product/db/11.1.0.6/owb/rtp/sql nf@rac2]$ ps -ef | grep owb oracle 19985 1 0 01:34 ? 00:00:00 /bin/sh /u03/app/oracle/product/db/11.1.0.6/owb/bin/unix/run_service.sh-manual 1 /u03/app/oracle/product/db/11.1.0.6 OWBSYS RAC2.COLESTOCK.TEST 1523 NF.COLESTOCK.TEST oracle 19987 19985 0 01:34 ? 00:0 0:02 /u03/app/oracle/product/db/11.1.0.6/jdk/jre/bin/java -Xmx768M -Djava.awt.headless=true DORACLE_HOME=/u03/app/oracle/product/db/11.1.0.6 -DOCM_HOME=/u03/app/oracle/product/db/11.1.0.6 DOCM_ORACLE_HOME=/u03/app/oracle/product/db/11.1.0.6 -classpath ../admin:../admin/launcher.jar:Personalties.jar:: DOWB_HOME=/u03/app/oracle/product/db/11.1.0.6 -DJDK_HOME=/u03/app/oracle/product/db/11.1.0.6/jdk DORA_HOME=/u03/app/oracle/product/db/11.1.0.6 -DOEM_HOME=/u03/app/oracle/product/db/11.1.0.6 -DIAS_HOME=/u03/app/oracle/product/db/11.1.0.6 Launcher ../admin/owb.classpath oracle.wh.runtime.platform.service.Service -manual 1 OWBSYS RAC2.COLESTOCK.TEST 1523 NF.COLESTOCK.TEST

[/u03/app/oracle/product/db/11.1.0.6/owb/log nf@rac2]$ tail -f OWBSYS.00005.log 2008/02/08-02:00:05-MST [1D332B][] Connection Manager - using service timezone America/Denver 2008/02/08-02:00:05-MST [1D332B][] Connection Manager - defaultimg session timezone offset to -07:00 2008/02/08-02:00:05-MST [1D332B][] Free Memory(bytes)=131480 Total Me mory(bytes)=2830336 Used Memory(bytes)=2698856 Used Memory(percent)=96% 2008/02/08-02:00:06-MST [1D332B][] Control Center Service Version 11.1.0.6.0 starting 2008/02/08-02:00:06-MST [1D332B][] Startup due to manual request 2008/02/08-02:00:06-MST [1D332B][] Control Center Repository Name OWBSYS on Service NF.COLESTOCK.TEST at Host RAC2.COLESTOCK.TEST 2008/02/08-02:00:06-MST [1D332B][] Explicit garbage collection - every 1 execution(s) 2008/02/08-02:00:06-MST [1D332B][] Initializing Platform 2008/02/08-02:00:08-MST [1D332B][] Recovery starting 2008/02/08-02:00:08-MST [1D332B][] Service startup complete

Page 5 of 10

Installing 11g OWB

2/9/2008

Download and Install OWB 11g to your local client PC: Here are the screen shots for the local OWB install. Pretty straight-forward.

Login to the Design Center from the Client and Configure: Remember to update the $TNS_ADMIN with a net service entry for your repository. Here are the screenshots for logging into the Design Center and creating a sample module.

Page 6 of 10

Installing 11g OWB

2/9/2008

Page 7 of 10

Installing 11g OWB

2/9/2008

Page 8 of 10

Installing 11g OWB

2/9/2008

Page 9 of 10

Installing 11g OWB

2/9/2008

Test the configuration by modeling objects and deploying them: I used the following Oracle by Example article to create a Dimension and then deployed it, to verify that my configuration works from end to end: http://www.oracle.com/technology/obe/11gr1_owb/owb11g_update_extend_knowledge/less5_modeling_target/less 5_modeling_target.htm Upon successful completion of the tutorial in question, the following objects should be present in the target schema:
SQL> connect sample_tgt Enter password: Connected. SQL> col object_name format a30 SQL> set lines 200 SQL> select object_name, object_type, status from user_objects; OBJECT_NAME -----------------------------TIME TIME_SEQ TIME_DIMENSION_KEY_PK TIME TIME_V TIME_MAP TIME_MAP 7 rows selected. OBJECT_TYPE ------------------TABLE SEQUENCE INDEX DIMENSION VIEW PACKAGE PACKAGE BODY STATUS ------VALID VALID VALID VALID VALID VALID VALID

Page 10 of 10

Installing 11g OWB

2/9/2008