You are on page 1of 20

Tech Note: Oracle BAM ODI Integration Installation Supported Version: Oracle BAM 11.1.1.2.

0 Oracle Data Integrator 10.1.3.5 Overview: This document illustrates the steps required to install the Oracle BAM ODI integration configuration. Prerequisites Complete installed version of Oracle BAM. Understanding Oracle BAM concepts.
ODI Installation on Linux

To install Oracle Data Integrator: 1. Download ODI 10.1.3.5.0 software from OTN, the link is http://www.oracle.com/technology/software/products/odi/index.html 2. Unzip software 3. Open a terminal and run the following command
cd <unzip_location>/setup/Linux/Disk1/install

4. Enter the following command to start installation


chmod 755 runIntaller unzip ./runInstaller

The Welcome screen appears 5. Click Next. The Select a Product To Install screen appears. 6. Select the Oracle Data Integrator 10.1.3.5.0 to install.

TechNote_BAM-ODI_Installation.doc Page 1 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

7. Click Next. The Select Installation Type screen appears.

TechNote_BAM-ODI_Installation.doc Page 2 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

8. Select Complete installation Type, then click Next. 9. In the Home Details screen select the Oracle home name and directory path where you want to install ODI

TechNote_BAM-ODI_Installation.doc Page 3 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

10. Click Next, the Summary Window appears.

TechNote_BAM-ODI_Installation.doc Page 4 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

11. Click Install to start installation. 12. Click Exit when the installaton finishes.
BAM ODI configuration

Setting JAVA_HOME Environment Variable This step is mandatory when ODI is integrated with Oracle BAM. ODI by default uses JDK 1.4 shipped with the ODI 10.1.3.5 release as its Java runtime. It will not work with Oracle BAM where the jar files are compiled in JDK 1.6. So make sure that the JAVA_HOME environment variable is pointed to a JDK1.5 or above version. Instead of setting the JAVA_HOME environment variable, you can also edit ODIHome/oracledi/bin/odiparams.sh and set ODI_JAVA_HOME directly. - Find this line: if "%ODI_JAVA_HOME%" == "" set ODI_JAVA_HOME=%JAVA_HOME%
TechNote_BAM-ODI_Installation.doc Page 5 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation - Add a line like this immediately above it: set ODI_JAVA_HOME=C:\jdk1.5.0_06

Configuring Master and Work Repositories in ODI


There are two types of repositories: Master Repository - Data structure containing information on the topology of the company's IT resources, on security and on version management of projects and data models. Work Repository - Data structure containing information on data models, projects, and their use. To configure Master and Work Repositories, please follow the steps below

STEP 1 - Creating Repository Schemas


Create a schema ODI_M to host the Master repository and a schema ODI_W to host the work repository. These schemas can be created by the following SQL commands: SQL> create user <MY_SCHEMA> identified by <MY_PASS> default tablespace <MY_TBS> temporary tablespace <MY_TEMP>; SQL> grant connect, resource to <MY_SCHEMA>; Where: <MY_SCHEMA> corresponds to the name of the schema you want to create <MY_PASS> corresponds to the password you have given it <MY_TBS> the Oracle tablespace where the data will be stored <MY_TEMP> temporary default tablespace

STEP 2 - Creating the Master Repository Run $ODIHOME\oracledi\bin\repcreate.sh script in a terminal. Specify the following Database connection details. Driver: URL: oracle.jdbc.driver.OracleDriver jdbc:oracle:thin:@<host>:<port>:<oracle instance> eg: jdbc:oracle:thin:@localhost:1521:ORCL User: ODI_M Password: Your password Technology: Oracle [Be sure to test the connection before clicking OK.]

TechNote_BAM-ODI_Installation.doc Page 6 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

STEP 3 - Connecting to the Master Repository 1. Run $ODIHOME\oracledi\bin\topology.sh 2. Click the New button to create a new connection, then enter the following information. Data Integrator Connection (Login Name is really a Connection Name) Login Name: Oracle Master User: SUPERVISOR Password: SUNOPSIS Database Connection User: ODI_M Password: Your password Drivers List: Oracle JDBC Driver Driver Name: oracle.jdbc.driver.OracleDriver Url: jdbc:oracle:thin:@localhost:1521:ORCL Set as the default connection All names and passwords are case-sensitive. [Be sure to test the connection before clicking OK.]

TechNote_BAM-ODI_Installation.doc Page 7 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

Topology Manager can now connect to the master repository. STEP 4 Creating a work repository 1. From within ODI Topology Manager, find the Repositories View. If it is not visible, select it from the menu: Windows -> Show View -> Repositories 2. Go to Repositories, then right-click Work Repositories>choose Insert Work Repository. First define the connection to the work repository by clicking the Definition tab, then enter: Name: WorkConnection1 Technology: Oracle Instance/dblink: <leave null> User: ODI_W Password: Your password In JDBC tab JDBC Driver: oracle.jdbc.driver.OracleDriver JDBC Url: jdbc:oracle:thin:@hostname:port:sid e.g. jdbc:oracle:thin:@localhost:1521:ORCL
TechNote_BAM-ODI_Installation.doc Page 8 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

Click Apply 3. A work repository window will pop up. Specify ID, type and name as follows, ID: (any value from 1 to 998 is fine) Type: Development Name: WORK_DEV

4. Click Apply. This will take a few minutes as ODI creates and populates the work repository tables. Now the Work Repository has been created. Next we will use ODI Designer to connect to the new Work Repository. STEP 5 - Connecting to the Work repository

1. Click the Designer button . The Data Integrator Login window appears 2. Create a new connection (Click the New button). In the Work Repository Connection window, specify the connection details as follows, Data Integrator Connection (Login Name is really a Connection Name) Login Name: Oracle Work Dev User: SUPERVISOR Password: SUNOPSIS Database Connection (for the Master Repository) User: ODI_M Password: ODI_M Drivers List: Oracle JDBC Driver Driver Name: oracle.jdbc.driver.OracleDriver Url: jdbc:oracle:thin:@localhost:1521:ORCL Work Repository Repository Name Click the Repositories list button; choose WORK_DEV from the list Set as the default connection [Be sure to test the connection before clicking OK]

TechNote_BAM-ODI_Installation.doc Page 9 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

3. Click OK to connect Designer to the Work Repository 4. Now Designer should open and connect to the Work Repository. You are ready to start using Oracle Data Integrator 10.1.3.5

Configuring BAM ODI Using Scripts Use the installation script when you have Oracle Data Integrator and Oracle BAM installed on the same system or the same network file system. A log file called utility.log is created if there is a problem with the installation. To install the integration files: 1. Start Oracle BAM Server if it is not running. 2. On the Oracle BAM host, go to the ORACLE_HOME\bam\config directory and edit the bam_odi_configuration.properties file. ORACLE_HOME is the directory where SOA/BAM is installed.
TechNote_BAM-ODI_Installation.doc Page 10 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation 3. Set ODI_HOME and WL_SERVER property values ODI_HOME - This property identifies the path to the Oracle Data Integrator home directory. WL_SERVER - This property identifies the Oracle WebLogic Server folder name on the Oracle BAM system. The default value is wlserver_10.3.
4. Installation logging is INFO by default. If there are any problems with the install,

the logging level can be changed in ORACLE_HOME\bam\bin\utility.logging.properties file. The logs are by default written to ORACLE_HOME\bam\bin\utility.log file. 5. Run ORACLE_HOME\bam\bin\bam_odi_configuration.sh Enter the values as prompted by the script. You must have the Oracle Data Integrator Master and Oracle Data Integrator Work repository account credentials to complete the script execution. Note that the prompts displayed with [value] have default values in the brackets. Press Enter to choose the default. If there is no bracketed default value displayed, an input value is required, or the script stops. Here is the sample input.
create_eds_in_bam: Please provide BAM credentials: Input BAM UserName [OracleSystemUser].......................:weblogic Input BAM User login password ..............................:

Creating Enterprise Data Sources in BAM Please input connection information for ODI repositories Input db instance host name or IP address [localhost].......:pwang02.au.oracle.com Input db instance port number [1521]........................:1523 Input db instance ID/SID [ORCL].............................:soa11 Creating ODI Master External Data Source: Input Master repository login name [ODI_M]............: Input Master repository login password....................: Importing from file "/opt/oracle/Middleware/Oracle_SOA1/bam/config/icommand_temp25801 20805443955471.xml". External Data Source "ODI_Master" imported successfully. "1" items imported successfully.

TechNote_BAM-ODI_Installation.doc Page 11 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation


Creating ODI Work External Data Source: Input Work repository login name [ODI_W]............: Input Work repository login password....................:

The script creates the resources required in the Oracle BAM web applications, sets the Oracle BAM configuration properties in Oracle Data Integrator, generates a Oracle WebLogic Server client Java Archive (JAR) to deploy to the Oracle Data Integrator system, and copies all of the required files into the appropriate Oracle Data Integrator directories. 6. The BUILD SUCCESSFUL message in the end indicates the installation is successful.

Simple Oracle BAM-ODI Integration Test Define Topology Create Data Servers, Physical Schemas, and Logical Schemas (All in Topology). This will allow us to connect to the source data and target data that we will use in our transformations. Oracle Source Physical Architecture > Technologies > Oracle Right-click and Insert Data Server Data Server Definition tab Name: Oracle <machinename> Server (Data Server): <blank> User: <db user, like SYS> Password: <db pswd, like WELCOME> JDBC tab JDBC Driver: oracle.jdbc.driver.OracleDriver JDBC Url: jdbc:oracle:thin:@localhost:1521:ORCL

TechNote_BAM-ODI_Installation.doc Page 12 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

Click OK and the Physical Data Server window pop up automatically. Note: If you close the Physical Data Server window, you can reopen it by right-clicking the Data Server and Insert Physical Schema Physical Data Server Definition tab Schema (Schema): SCOTT Schema (Work Schema): SNP_TEMP SCOTT is an example. Choose any schema that contains data you want to
TechNote_BAM-ODI_Installation.doc Page 13 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation work with. Default installations of Oracle will have the user SCOTT already defined with four sample tables containing data, but the account will be locked out. Use Oracle Enterprise Manager to enable this account. Context tab Type in the name "ORACLE_SOURCE" as the name of a new Logical Schema. ODI will automatically create the Logical Schema.

TechNote_BAM-ODI_Installation.doc Page 14 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

Oracle BAM Target Physical Architecture > Technologies > Oracle BAM Right-click and Insert Data Server Data Server Definition tab Name: BAM Target Server (Data Server): <blank> User: weblogic Password: welcome JDBC tab JDBC Driver: any-text-will-do JDBC Url: instance1:localhost:9001 Modify the instance, machine name or port if needed for your Oracle BAM installation. (Note: the 4th parameter is true or false indicating whether clustering is used.)

TechNote_BAM-ODI_Installation.doc Page 15 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

Click OK and the Physical Data Server window pop up automatically. Note: If you close the Physical Data Server window, you can reopen it by right-clicking the Data Server and Insert Physical Schema Physical Schema Definition tab Modify the Local Object Mask to be just %OBJECT Context tab Type in the name "BAM_TARGET" as the name of a new Logical Schema. ODI will automatically create the Logical Schema.

TechNote_BAM-ODI_Installation.doc Page 16 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

Create a Project Go to Designer and Click on Projects Tab Right-click Projects and insert the Project ETL BAM INTEGRATION Import the Knowledge Modules Right click the Project (not the KM node) Import > Import Knowledge Modules Import some of the Knowledge Modules from C:\Program Files\Oracle\oracledi\oracledi\impexp
TechNote_BAM-ODI_Installation.doc Page 17 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation Use import type Duplication Choose these KMs: CKM Get Oracle BAM Metadata CKM Oracle IKM SQL to BAM (delete) IKM SQL to BAM (insert) IKM SQL to BAM (looksert natural) IKM SQL to BAM (looksert surrogate) IKM SQL to BAM (update) IKM SQL to BAM (upsert) IKM SQL Control Append LKM Get Source Metadata LKM Oracle BAM to SQL LKM SQL to Oracle RKM Oracle BAM

Create Models Insert the Model "Oracle BAM" Definition tab Technology: Oracle BAM - Target Logical Schema: BAM_TARGET Reverse tab
TechNote_BAM-ODI_Installation.doc Page 18 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation Context: Global (On the Reverse tab) Choose Customized reverse Choose the Knowledge Module RKM Oracle BAM Options may be left at default values. (Customer can update the value for "LOG_FILE_NAME". Check in the appropriate file if values are updated.) Click the Reverse button to begin reverse engineering.

Note: Because this reverse engineering was not done using a JDBC driver, it is not possible to right-click a data store and view its data. Check to see that the reverse engineering process is going well by viewing its progress in ODI Operator.

In the model in Designer you should now have metadata like this:

TechNote_BAM-ODI_Installation.doc Page 19 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

Tech Note: Oracle BAM ODI Integration Installation

At this point, you can create an interface. Execute the Interface and watch the results in the Operator window.

Reference:

Oracle Fusion Middleware Administrator's Guide for Oracle SOA Suite 11g Release 1 (11.1.1) Part Number E10226-01 http://download.oracle.com/docs/cd/E12839_01/integration.1111/e10226/part_bam.htm# sthref626

Questions & Clarifications: If you have any comments or need additional information, please communicate through the Oracle BAM forum at: http://forums.oracle.com/forums/forum.jspa?forumID=252

TechNote_BAM-ODI_Installation.doc Page 20 of 20 October 23, 09 (version 11.1.1.2.0) Document version (3) Oracle confidential, All rights reserved

You might also like