Date post: | 20-Jul-2016 |
Category: |
Documents |
Upload: | nareshreddyguntaka |
View: | 16 times |
Download: | 3 times |
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 1/33
ODI11g: Deploying and 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 WebLogicServer
Deploy and configure the ODI Java EE agent on theexisting WebLogic domain, ODI-DOMAIN.
Connecting to the WebLogic server and managed serverodi_server1 .
Executing an ODI Object with ODI Java EE Agent
Summary
Resources
Purpose
This tutorial walks you through the steps that are needed to deploy and configure an Oracle Data Integrator (ODI) JavaEE 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 RuntimeAgent can now be deployed as a Java EE component within an application server. It benefits in this configuration fromthe application server layer features such as clustering and connection pooling for large configurations. This Java EEAgent exposes an MBeans interface enabling lifecycle operations (start/stop) from the application server console andmetrics 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 performingdatabase management and integration tasks on various resources within the organization. In particular, Linda isresponsible 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 procedure to create a relational table andpopulate it with data. Now Linda needs to deploy and configure an ODI Java EE Agent to be able monitor the agentactivity via WebLogic server console.
Software and Hardware Requirements
The following is a list of software requirements:
The system should include the following installed products:Oracle Database 11gOracle Data Integrator 11gR1Oracle WebLogic Server 11gR1
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 2/33
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 Database11g
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 RepositoriesODI11g: Creating an ODI Project: Developing an ODI XML to Database Transformation Using Interface withODI Constraint. Note: Alternatively you may have your own ODI interface created and used for testing ODI JEEagent . 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
Oracle Data Integrator provides a wizard to automatically generate templates for deploying Java EE agents in OracleWebLogic Server. Such a template includes the Java EE Agent and its configuration, and can optionally include the JDBCdatasources definitions required for this agent as well as the drivers and libraries files for these datasources to work. Byusing the Oracle WebLogic Configuration Wizard, domain administrators can extend their domains or create a newdomain for the Oracle Data Integrator Java EE runtime agents. The ODI 11g Java EEAgent can be deployed to an existingdomain or deployed automatically when creating a new domain. For the purpose of this lab we will first create the WLSdomain, and then extend the domain by depying the Java EE agent. Before creating an ODI JEE agent, you create a newWLS 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 ODI Home Install. Startcommand shell and change directory to: <WLS-HOME>\common\bin, for example:C:\oracle\Middleware\Oracle_ODI2\common\bin. Execute config command. The Configuration Wizard starts.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 3/33
2. In Welcome screen, select Create a new WebLogic domain, and click Next. In the Select Domain Source screen,just click Next.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 4/33
3. In Specify Domain Name and Location screen, enter ODI-DOMAIN for Domain name. Leave default Domainlocation. Click Next. In the screen that follows, enter Administrator user password: "welcome1". Leave User nameas "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.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 5/33
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 6/33
4. In the Select Optional Configuration screen, select: Administration Server, Managed Servers, Clusters andMachines. Click Next. In the screen that follows, verify that Listen port is set to 7001. Click Next. In the screen thatfollows, click Add to add a new managed server. It will be used later to depoy ODI JEE agent.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 7/33
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 8/33
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.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 9/33
6 . In the Configure Machines screen, click Next. In Configuration Summary screen, click Create. When the domain iscreated, click Done.
Note: Don't select "Start Admin server" yet. It will be done later.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 10/33
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 11/33
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 agentwith this domain.
1. If not started, start ODI and connect to ODI Work repository (WORKREP1). For user SUPERVISOR, eneterpassword: SUNOPSIS. Open Topology Navigator, open Physical architecture and then create a new ODI Agent.Name this agent OracleDIAgent. Set the port to 8001 and Host to localhost . Verify that the Web application context
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 screenshot.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 12/33
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.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 13/33
2. Open the Command Prompt window again. If necessary, change directory to: <WLS-HOME>\common\bin. Executeconfig command. The Configuration Wizard starts.
3. In the Welcome screen, select: Extend an existing WebLogic domain. Click Next. In the screen that follows, selectthe domain ODI-DOMAIN, as shown on the screenshot. Click Next.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 14/33
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 15/33
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 componentodi_server1, that was created earlier.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 16/33
5 . The wizard will set up the ODI repository connection within the domain server. During the wizard configuration, therepository connection information must be supplied. Click the check boxes next to ODI Master schema, and next toODI Work schema. Configure the JDBC component schema as shown in the following table. Click Next. Verify thatthe 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
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 17/33
Port 1521
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 18/33
6 . In the next screen, select Managed Servers, Clusters and Machines. Click Next. Verify that Listen port is set to8001 for managed server odi_server1. Click Next. In the Configure Clusters screen, click Next.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 19/33
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 20/33
7 . In the Configure Machines screen, click Next. The Assign Servers to Machines screen will already have theodi_server1 assigned to localODImachine. Click Next. Review the Configuration Summary, and then click Extend.When the domain is created, click Done.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 21/33
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 22/33
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 WebLogicserver and managed server odi_serevr1.
1. In the command shell, change directory to the directory of the WLS Home -C:\Oracle\Middleware\user_projects\domains\ODI_DOMAIN\bin . Execute the startweblogic command.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 23/33
2. Security must be set up for the JAVA EE application to have access to the ODI repository. The entry will be createdwithin the credential store, which will allow the JAVA EE Agent to authenticate itself to be able to use the requiredresources. This user should be a user that is already set up in the ODI Security. In this practice, we use userSUPERVISOR. To do this, you execute Web Logic Scripting Tool (WLST), connect to our running Admin server andadd the credential store. To start WLST, in the new command window, change directory to the WLS_HOMEcommon bin - C:\Oracle\Middleware\oracle_common\common\bin, and then execute the command wlst.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 24/33
3 . To connect to the running Admin server, execute the following command:connect('weblogic','welcome1','t3://localhost:7001')
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 25/33
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="ODISUPERVISOR Credential").
Note: All commands are case-sensitive! You can copy commands from the text file provided HERE.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 26/33
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() .
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 27/33
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 . Verifythat your managed server is started in RUNNING mode.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 28/33
7 . From ODI Designer, click Test icon to test connectivity of your configured ODI Java EE agent. Click OK. CloseOracleDIAgent tab.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 29/33
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 arelational table. This procedure was created in the OBE titled Creating an ODI Procedure to Create and Populate aRelational Table. To access this OBE, click HERE.
1. In ODI designer, right-click the PRGcreate-populate_table procedure and select Execute. In the window thatappears, click the Agent drop-down list and select localagent. Click OK to execute the job with the OracleDIAgentagent. When the Information screen shows the "Session started" message, click OK.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 30/33
2. Click the ODI Operator tab to open ODI Operator. In ODI Operator, click the Session List tab, and then click theRefresh icon. Expand: Physical Agent > OracleDIAgent -1> PRD_CREATE_POPULATE_TABLE, and view theexecution results for the PRD-create-populate-table procedure. Verify that procedure PRD-create-populate-tableexecuted successfully.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 31/33
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.
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 32/33
Summary
In this tutorial, you have learned how to:
Verify the PrerequisitesDeploy and configure the ODI Java EE agent on the WebLogic domainConnect to WebLogic Admin server and Managed serverTest ODI java EE agent by executing an ODI object
7/15/2014 ODI11g:Deploying and Configuring the ODI Agent as a Java EE Application
http://www.oracle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_jee_agent/setup_jee_agent.htm?print=preview&imgs=visible 33/33
ResourcesOracle Data Intergator 11g DocumentationTo 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