Beruflich Dokumente
Kultur Dokumente
Time to Complete
Approximately 20 minutes
Overview
A common task that is performed using ODI is to deploy and configure an ODI Java EE Agent.
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, Linda is
responsible for performing database management and integration tasks on various resources
within the organization. In particular, Linda is responsible for data loading, transformation, and
validation. To begin working on her projects, Linda created the new Master repository and Work
repository. Linda also created the project and the procedure to create a relational table and
populate it with data. Now Linda needs to deploy and configure an ODI Java EE Agent to be
able monitor the agent activity via WebLogic server console.
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 components for
Oracle Database 11g
2 . Have installed Oracle Data Integrator 11gR1
3 . Before attempting this OBE, you should have successfully completed the following OBEs:
2. In Welcome screen, select Create a new WebLogic domain, and click Next. In the Select Domain
Source screen, just click Next.
3. In Specify Domain Name and Location screen, enter ODI-DOMAIN for Domain name. Leave
default Domain location. Click Next. In the screen that follows, enter Administrator user
password: "welcome1". Leave User name as "weblogic". Click Next. In the next screen, leave
default location for available JDKs. Leave other default settings, as shown on the screenshot and
click Next.
4. In the Select Optional Configuration screen, select: Administration Server, Managed Servers,
Clusters and Machines. Click Next. In the screen that follows, verify that Listen port is set to
7001. Click Next. In the screen that follows, click Add to add a new managed server. It will be
used later to depoy ODI JEE agent.
5 . In the Configure Managed Server screen, in the Name field enter: odi_server1. In the Listen Port
field, enter: 8001, as shown on the screenshot. Click Next. In the screen that follows, click Next.
6 . In the Configure Machines screen, click Next. In Configuration Summary screen, click Create.
When the domain is created, click Done.
Note: Don't select "Start Admin server" yet. It will be done later.
Note: The agent name is case-sensitive! Use the exact name OracleDIAgent, as shown in the
screenshot.
1 . In the Logical architecture, create a new logical agent with the same name as your new physical
agent, OracleDIAgent . Link this logical agent to the physical agent OracleDIAgent in Global
context, as shown below. Save logical agent OracleDIAgent, and close the tab.
2. Open the Command Prompt window again. If necessary, change directory to: <WLSHOME>\common\bin. Execute config command. The Configuration Wizard starts.
3. In the Welcome screen, select: Extend an existing WebLogic domain. Click Next. In the screen
that follows, select the domain ODI-DOMAIN, as shown on the screenshot. Click Next.
4 . In the screen that follows, select Oracle Data Integrator Agent 11.1.1.1 (Oracle JRF will
then also be selected; leave this option selected). Click Next. In the screen that follows, click
OK to replace the existing component odi_server1, that was created earlier.
5 . The wizard will set up the ODI repository connection within the domain server. During the
wizard configuration, the repository connection information must be supplied. Click the check
boxes next to ODI Master schema, and next to ODI Work schema. Configure the JDBC
component schema as shown in the following table. Click Next. Verify that the test was
successful (if not, correct any connectivity settings). Click Next.
Database Connection (Master Repository)
Parameter
Value
Vendor
Oracle
Driver
Oracles driver (Thin) for Instance connections
Schema Owner
snpm1
Schema Password
oracle1
DBMS/Service
orcl
Host Name
localhost
Port
1521
6 . In the next screen, select Managed Servers, Clusters and Machines. Click Next. Verify that
Listen port is set to 8001 for managed server odi_server1. Click Next. In the Configure Clusters
screen, click Next.
7 . In the Configure Machines screen, click Next. The Assign Servers to Machines screen will
already have the odi_server1 assigned to localODImachine. Click Next. Review the
Configuration Summary, and then click Extend. When the domain is created, click Done.
2. Security must be set up for the JAVA EE application to have access to the ODI repository. The
entry will be created within the credential store, which will allow the JAVA EE Agent to
authenticate itself to be able to use the required resources. This user should be a user that is
already set up in the ODI Security. In this practice, we use user SUPERVISOR. To do this, you
execute Web Logic Scripting Tool (WLST), connect to our running Admin server and add the
credential store. To start WLST, in the new command window, change directory to the
WLS_HOME common bin - C:\Oracle\Middleware\oracle_common\common\bin, and then
execute the command wlst.
4 . Execute the following command to add the correct credential store for ODI Supervisor :
createCred (map="oracle.odi.credmap", key="SUPERVISOR", user="SUPERVISOR",
password="SUNOPSIS", desc="ODI SUPERVISOR Credential").
Note: All commands are case-sensitive! You can copy commands from the text file provided
HERE.
5 . IAlso execute the command to add the correct credential store for the domain ODI-DOMAIN :
createCred (map="oracle.odi.credmap", key="ODI-DOMAIN", user="weblogic",
password="welcome1", desc="ODI-DOMAIN Credential").
To exit WLST, execute the command exit() .
6 . To start managed server odi_server_1, change directory to WLS Home C:\Oracle\Middleware\user_projects\domains\ODI-DOMAIN\bin , and use the execute
command:
StartManagedWeblogic odi_server1. For Username, enter weblogic . For the password, enter
welcome1 . Verify that your managed server is started in RUNNING mode.
7 . From ODI Designer, click Test icon to test connectivity of your configured ODI Java EE agent.
Click OK. Close OracleDIAgent tab.
2. Click the ODI Operator tab to open ODI Operator. In ODI Operator, click the Session List tab,
and then click the Refresh icon. Expand: Physical Agent > OracleDIAgent -1>
PRD_CREATE_POPULATE_TABLE, and view the execution results for the PRD-createpopulate-table procedure. Verify that procedure PRD-create-populate-table executed
successfully.
3 . To stop managed WebLogic server odi_server1 and then WebLogic server, change directory to
WLS Home - C:\Oracle\Middleware\user_projects\domains\ODI-DOMAIN\bin, and then
execute the following command: stopManagedWebLogic odi_server1. For Username, enter
weblogic . For the password, enter welcome1 .
To stop WebLogic server, execute the command: stopWebLogic.
Summary
In this tutorial, you have learned how to: