ODI11g_Deploying and Configuring the ODI Agent as a Java EE Application

7/14/2019 ODI11g_Deploying and Configuring the ODI Agent as a Java EE Application

http://slidepdf.com/reader/full/odi11gdeploying-and-configuring-the-odi-agent-as-a-java-ee-application-56327caed0254 1/27

Print Preview

ODI11g: Deploying and

Configuring the ODI Agent

as a Java EE Application

This tutorial contains the following

sections:

PurposeTime to Complete

Overview

Scenario

Software and Hardware Requirements

Prerequisites

Deploy and Configure a New Domain

with WebLogic Server

Deploy and configure the ODI Java EE

agent on the existing WebLogic

domain, ODI-DOMAIN.

Connecting to the WebLogic server and

managed server odi_server1 .Executing an ODI Object with ODI Java

EE Agent

Summary

Resources

Viewing Screenshots

Click icon to hide all

screenshots

Note: Alternatively, you can click an

individual icon (or image) associated witheach step to view (or hide) the screenshot

associated with that step.

ODI11g: Deploying and Configuring the ODI Agent asa Java EE Application

Purpose

This tutorial walks you through the steps that are needed to deploy and configure an

Oracle Data Integrator (ODI) Java EE Agent

Time to Complete

Approximately 20 minutes

Overview

A common task that is performed using ODI is to deploy and configure an ODI Java EEAgent. With ODI 11g, the Runtime Agent can now be deployed as a Java EE component

within an application server. It benefits in this configuration from the application server

layer features such as clustering and connection pooling for large configurations. This

Java EE Agent exposes an MBeans interface enabling lifecycle operations (start/stop)

from the application server console and metrics that can be used by the application server

console to monitor the agent activity.

Scenario

Linda works as a database administrator for Global Enterprise. In Global Enterprise, Lindais responsible for performing database management and integration tasks on variousresources within the organization. In particular, Linda is responsible for data loading,transformation, and validation. To begin working on her projects, Linda created the newMaster repository and Work repository. Linda also created the project and the procedureto create a relational table and populate it with data. Now Linda needs to deploy andconfigure an ODI Java EE Agent to be able monitor the agent activity via WebLogic server

console.

Software and Hardware RequirementsThe following is a list of software requirements:

The system should include the following installed products:Oracle Database 11gOracle Data Integrator 11gR1Oracle WebLogic Server 11gR1

If not done before, start the services and components for Oracle Database 11g

Prerequisites

Before you start the tasks, make sure that your system environment meets the following

requirements:

1 . Have installed Oracle Database 11g. If not done before, start the services and compo

2 . Have installed Oracle Data Integrator 11gR1

3 . Before attempting this OBE, you should have successfully completed the following OB

ODI11g: Creating and Connecting to ODI Master and Work Repositories

ODI11g: Creating an ODI Project: Developing an ODI XML to Database Transfor

Constraint. Note: Alternatively you may have your own ODI interface created an

agent . In this case you don't have complete this OBE.

To access these OBEs, click HERE.

Deploy and Configure a New Domain with WebLogic Server

I11g:Deploying and Configuring the ODI Agent as a Java EE Applic... http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/o...

27 11/07/2013 11:37 AM



Oracle Data Integrator provides a wizard to automatically generate templates for deploying

Java EE agents in Oracle WebLogic Server. Such a template includes the Java EE Agent

and its configuration, and can optionally include the JDBC datasources definitions

required for this agent as well as the drivers and libraries files for these datasources to

work. By using the Oracle WebLogic Configuration Wizard, domain administrators can

extend their domains or create a new domain for the Oracle Data Integrator Java EE

runtime agents. The ODI 11g Java EEAgent can be deployed to an existing domain or

deployed automatically when creating a new domain. For the purpose of this lab we will

first create the WLS domain, and then extend the domain by depying the Java EE agent.

Before creating an ODI JEE agent, you create a new WLS domain, ODI-DOMAIN. To doso, perform the following steps:

1. To deploy and configure domains with WLS, you start the config.bat from within the O

shell and change directory to: <WLS-HOME>\common\bin, for example: C:\oracle\Mid

\common\bin. Execute config command. The Configuration Wizard starts.

2. In Welcome screen, select Create a new WebLogic domain, and click Next. In the Sel

click Next.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





27 11/07/2013 11:37 AM



3. In Specify Domain Name and Location screen, enter ODI-DOMAIN for Domain name.

Click Next. In the screen that follows, enter Administrator user password: "welcome1".

"weblogic". Click Next. In the next screen, leave default location for available JDKs. Le

shown on the screenshot and click Next.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





27 11/07/2013 11:37 AM



Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





27 11/07/2013 11:37 AM



4. In the Select Optional Configuration screen, select: Administration Server, Managed S

Click Next. In the screen that follows, verify that Listen port is set to 7001. Click Next. I

Add to add a new managed server. It will be used later to depoy ODI JEE agent.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





27 11/07/2013 11:37 AM



5 . In the Configure Managed Server screen, in the Name field enter: odi_server1. In the

shown on the screenshot. Click Next. In the screen that follows, click Next.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





27 11/07/2013 11:37 AM



6 . In the Configure Machines screen, click Next. In Configuration Summary screen, click

created, click Done.

Note: Don't select "Start Admin server" yet. It will be done later.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





27 11/07/2013 11:37 AM



Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





27 11/07/2013 11:37 AM



Deploy and configure the ODI Java EE agent on the existing

WebLogic domain, ODI-DOMAIN.

Now that you have created the WebLogic server domain ODI_DOMAIN, you need todeploy and configure ODI JEE agent with this domain.

1. If not started, start ODI and connect to ODI Work repository (WORKREP1). For user

password: SUNOPSIS. Open Topology Navigator, open Physical architecture and the

Name this agent OracleDIAgent. Set the port to 8001 and Host to localhost . Verify th

is set to oraclediagent , as shown below. Save your new physical agent .

Note: The agent name is case-sensitive! Use the exact name OracleDIAgent, as sh

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





27 11/07/2013 11:37 AM



1 . In the Logical architecture, create a new logical agent with the same name as your ne

OracleDIAgent . Link this logical agent to the physical agent OracleDIAgent in Global

logical agent OracleDIAgent, and close the tab.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



2. Open the Command Prompt window again. If necessary, change directory to: <WLS-H

config command. The Configuration Wizard starts.

Screenshot for Step

3. In the Welcome screen, select: Extend an existing WebLogic domain. Click Next. I

the domain ODI-DOMAIN, as shown on the screenshot. Click Next.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



4 . In the screen that follows, select Oracle Data Integrator – Agent – 11.1.1.1 (Oracle

leave this option selected). Click Next. In the screen that follows, click OK to replace t

odi_server1, that was created earlier.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



5 . The wizard will set up the ODI repository connection within the domain server. During

repository connection information must be supplied. Click the check boxes next to ODI

ODI Work schema. Configure the JDBC component schema as shown in the following

the test was successful (if not, correct any connectivity settings). Click Next.

Database Connection (Master Repository)

Parameter Value

Vendor Oracle

Driver Oracle’s driver (Thin) for Instance connections

Schema Owner snpm1

Schema Password oracle1

DBMS/Service orcl

Host Name localhost

Port 1521

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



6 . In the next screen, select Managed Servers, Clusters and Machines. Click Next. V

8001 for managed server odi_server1. Click Next. In the Configure Clusters screen, c

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



7 . In the Configure Machines screen, click Next. The Assign Servers to Machines scree

odi_server1 assigned to localODImachine. Click Next. Review the Configuration Sum

When the domain is created, click Done.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



Connecting to the WebLogic server and managed server

odi_server1 .

Now that you have created and extended the WebLogic domain with the ODI JEE agent,

you need to connect to WebLogic server and managed server odi_serevr1.

1. In the command shell, change directory to the directory of the WLS Home - C:\Oracle\

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



\domains\ODI_DOMAIN\bin . Execute the startweblogic command.

2. Security must be set up for the JAVA EE application to have access to the ODI repositwithin the credential store, which will allow the JAVA EE Agent to authenticate itself to

resources. This user should be a user that is already set up in the ODI Security. In thi

SUPERVISOR. To do this, you execute Web Logic Scripting Tool (WLST), connect to

add the credential store. To start WLST, in the new command window, change directo

bin - C:\Oracle\Middleware\oracle_common\common\bin, and then execute the comm

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



3 . To connect to the running Admin server, execute the following command:

connect('weblogic','welcome1','t3://localhost:7001')

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



4 . Execute the following command to add the correct credential store for ODI Supervisor

(map="oracle.odi.credmap", key="SUPERVISOR", user="SUPERVISOR", pass

desc="ODI SUPERVISOR Credential").

Note: All commands are case-sensitive! You can copy commands from the text file pr

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



5 . IAlso execute the command to add the correct credential store for the domain ODI-DOcreateCred (map="oracle.odi.credmap", key="ODI-DOMAIN", user="weblogic"

desc="ODI-DOMAIN Credential").

To exit WLST, execute the command exit() .

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



6 . To start managed server odi_server_1, change directory to WLS Home - C:\Oracle\

\domains\ODI-DOMAIN\bin , and use the execute command:

StartManagedWeblogic odi_server1. For Username, enter weblogic . For the pas

that your managed server is started in RUNNING mode.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



7 . From ODI Designer, click Test icon to test connectivity of your configured ODI Java E

OracleDIAgent tab.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



Executing an ODI Object with ODI Java EE Agent

With ODI Agent, expand the project and execute the PRGcreate-populate_table

procedure that creates and populates a relational table. This procedure was created in

the OBE titled Creating an ODI Procedure to Create and Populate a Relational Table . To

access this OBE, click HERE.

1. In ODI designer, right-click the PRGcreate-populate_table procedure and select Ex

appears, click the Agent drop-down list and select localagent. Click OK to execute t

agent. When the Information screen shows the "Session started" message, click OK.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



2. Click the ODI Operator tab to open ODI Operator. In ODI Operator, click the Session L

Refresh icon. Expand: Physical Agent > OracleDIAgent -1> PRD_CREATE_POPU

execution results for the PRD-create-populate-table procedure. Verify that procedure

executed successfully.

3 . To stop managed WebLogic server odi_server1 and then WebLogic server, change di

C:\Oracle\Middleware\user_projects\domains\ODI-DOMAIN\bin, and then execute the

stopManagedWebLogic odi_server1. For Username, enter weblogic . For the pas

To stop WebLogic server, execute the command: stopWebLogic.

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





f 27 11/07/2013 11:37 AM



Summary

In this tutorial, you have learned how to:

Verify the Prerequisites

Deploy and configure the ODI Java EE agent on the WebLogic domain

Connect to WebLogic Admin server and Managed server

Test ODI java EE agent by executing an ODI object

ResourcesOracle Data Intergator 11g Documentation

To learn more about , refer to additional OBEs in the Learning Library.

About Oracle |Oracle and Sun | | Careers |

Contact Us | Site Maps | Legal Notices | Terms of Use

| Your Privacy Rights

Print Preview





sections:


Overview

Scenario


Prerequisites





domain, ODI-DOMAIN.



EE Agent

Summary

Resources

Viewing Screenshots


screenshots





ODI11g_Deploying and Configuring the ODI Agent as a Java EE Application

Documents

Transcript of ODI11g_Deploying and Configuring the ODI Agent as a Java EE Application