ODI11g - Deploying and Configuring The ODI Agent As A Java EE Application

ODI11g:Deploying and Configuring the ODI Agent as a Java EE Applic...
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/o...
Print Preview
ODI11g: Deploying and a Java EE Application Configuring the ODI Agent as a Java EE Application
This tutorial contains the following sections: Purpose Time 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
ODI11g: Deploying and Configuring the ODI Agent as
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 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.
Viewing Screenshots
Click icon to hide all screenshots Note: Alternatively, you can click an individual icon (or image) associated with each step to view (or hide) the screenshot associated with that step.
Software and Hardware Requirements

The following is a list of software requirements: The system should include the following installed products: Oracle Database 11g Oracle Data Integrator 11gR1 Oracle 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 compon 2 . Have installed Oracle Data Integrator 11gR1 3 . Before attempting this OBE, you should have successfully completed the following OBEs
ODI11g: Creating and Connecting to ODI Master and Work Repositories ODI11g: Creating an ODI Project: Developing an ODI XML to Database Transformation Us Constraint. Note: Alternatively you may have your own ODI interface created and used for 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
1 of 27
11/07/2013 11:37 AM
Print Preview
ODI11g: Deploying and Configuring the ODI Agent as a Java EE Application

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 do so, perform the following steps: 1. To deploy and configure domains with WLS, you start the config.bat from within the OD shell and change directory to: <WLS-HOME>\common\bin, for example: C:\oracle\Middlewa \common\bin. Execute config command. The Configuration Wizard starts.
Viewing Screenshots
2. In Welcome screen, select Create a new WebLogic domain, and click Next. In the Select click Next.
2 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
3. In Specify Domain Name and Location screen, enter ODI-DOMAIN for Domain name. Leave d Click Next. In the screen that follows, enter Administrator user password: "welcome1". Leave Us "weblogic". Click Next. In the next screen, leave default location for available JDKs. Leave other shown on the screenshot and click Next.
3 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
4 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
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. In the scre Add to add a new managed server. It will be used later to depoy ODI JEE agent.
5 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
5 . In the Configure Managed Server screen, in the Name field enter: odi_server1. In the Listen Por shown on the screenshot. Click Next. In the screen that follows, click Next.
6 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
6 . In the Configure Machines screen, click Next. In Configuration Summary screen, click Create. W created, click Done. Note: Don't select "Start Admin server" yet. It will be done later.
7 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
8 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
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 to deploy and configure ODI JEE agent with this domain.
1. If not started, start ODI and connect to ODI Work repository (WORKREP1). For user SUPERVIS password: SUNOPSIS. Open Topology Navigator, open Physical architecture and then create a Name this agent OracleDIAgent. Set the port to 8001 and Host to localhost . Verify that the We 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 shown in the
9 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
1 . In the Logical architecture, create a new logical agent with the same name as your new physica OracleDIAgent . Link this logical agent to the physical agent OracleDIAgent in Global context, as logical agent OracleDIAgent, and close the tab.
10 of 27
11/07/2013 11:37 AM
Print Preview

2. Open the Command Prompt window again. If necessary, change directory to: <WLS-HOME>\c config command. The Configuration Wizard starts.
Screenshot for Step
3. In the Welcome screen, select: Extend an existing WebLogic domain. Click Next. In the scre the domain ODI-DOMAIN, as shown on the screenshot. Click Next.
Viewing Screenshots
11 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
4 . In the screen that follows, select Oracle Data Integrator Agent 11.1.1.1 (Oracle JRF will th leave this option selected). Click Next. In the screen that follows, click OK to replace the existin odi_server1, that was created earlier.
12 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
5 . The wizard will set up the ODI repository connection within the domain server. During the wizard 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 table. the test was successful (if not, correct any connectivity settings). Click Next. Database Connection (Master Repository) Parameter Vendor Driver Schema Owner Schema Password DBMS/Service Host Name Port Value Oracle Oracles driver (Thin) for Instance connections snpm1 oracle1 orcl localhost 1521
13 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
6 . In the next screen, select Managed Servers, Clusters and Machines. Click Next. Verify that 8001 for managed server odi_server1. Click Next. In the Configure Clusters screen, click
14 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
15 of 27
11/07/2013 11:37 AM
Print Preview

7 . In the Configure Machines screen, click Next. The Assign Servers to Machines screen will alre odi_server1 assigned to localODImachine. Click Next. Review the Configuration Summary, and When the domain is created, click Done .
Viewing Screenshots
16 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
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\M
17 of 27
11/07/2013 11:37 AM
Print Preview
\domains\ODI_DOMAIN\bin . Execute the startweblogic command.

Viewing Screenshots
2. Security must be set up for the JAVA EE application to have access to the ODI repository. The e within the credential store, which will allow the JAVA EE Agent to authenticate itself to be able to resources. This user should be a user that is already set up in the ODI Security. In this practice, SUPERVISOR. To do this, you execute Web Logic Scripting Tool (WLST), connect to our r add the credential store. To start WLST, in the new command window, change directory bin - C:\Oracle\Middleware\oracle_common\common\bin, and then execute the command
18 of 27
11/07/2013 11:37 AM
Print Preview

3 . To connect to the running Admin server, execute the following command: connect('weblogic','welcome1','t3://localhost:7001')
Viewing Screenshots
19 of 27
11/07/2013 11:37 AM
Print Preview

4 . Execute the following command to add the correct credential store for ODI Supervisor (map="oracle.odi.credmap", key="SUPERVISOR", user="SUPERVISOR", password="S desc="ODI SUPERVISOR Credential"). Note: All commands are case-sensitive! You can copy commands from the text file provided
Viewing Screenshots
20 of 27
11/07/2013 11:37 AM
Print Preview

5 . IAlso execute the command to add the correct credential store for the domain ODI-DOMA createCred (map="oracle.odi.credmap", key="ODI-DOMAIN", user="weblogic", passwo desc="ODI-DOMAIN Credential"). To exit WLST, execute the command exit() .
Viewing Screenshots
21 of 27
11/07/2013 11:37 AM
Print Preview

6 . To start managed server odi_server_1, change directory to WLS Home - C:\Oracle\Middleware \domains\ODI-DOMAIN\bin , and use the execute command: StartManagedWeblogic odi_server1. For Username, enter weblogic . For the password, en that your managed server is started in RUNNING mode.
Viewing Screenshots
22 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
7 . From ODI Designer, click Test icon to test connectivity of your configured ODI Java EE agent. C OracleDIAgent tab.
23 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots 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 Execute appears, click the Agent drop-down list and select localagent. Click OK to execute the job with agent. When the Information screen shows the "Session started" message, click OK.
24 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
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_POPULATE_TA execution results for the PRD-create-populate-table procedure. Verify that procedure PRD-crea executed successfully.
3 . To stop managed WebLogic server odi_server1 and then WebLogic server, change director C:\Oracle\Middleware\user_projects\domains\ODI-DOMAIN\bin, and then execute the follo stopManagedWebLogic odi_server1. For Username, enter weblogic . For the password, en To stop WebLogic server, execute the command: stopWebLogic.
25 of 27
11/07/2013 11:37 AM
Print Preview

Viewing Screenshots
26 of 27
11/07/2013 11:37 AM
Print Preview
ODI11g: Deploying and Configuring the ODI Agent Summary as a Java EE Application In this tutorial, you have learned how to:
About Oracle |Oracle and Sun | | Careers |
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
Resources
Oracle Data Intergator 11g Documentation To learn more about , refer to additional OBEs in the Learning Library.
Contact Us | Site Maps | Legal Notices | Terms of Use | Your Privacy Rights
Viewing Screenshots
27 of 27
11/07/2013 11:37 AM

ODI11g - Deploying and Configuring The ODI Agent As A Java EE Application

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

ODI11g - Deploying and Configuring The ODI Agent As A Java EE Application

Transféré par

Droits d'auteur :

Formats disponibles

ODI11g:Deploying and Configuring the ODI Agent as a Java EE Applic...