odi11g_ setting up an odi agent
TRANSCRIPT
-
7/28/2019 ODI11g_ Setting Up an ODI Agent
1/11
/06/12 ODI11g: Setting Up an ODI Agent
acle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_odi_agent/setup_odi_agent.ht
ODI11g: Setting Up an ODI Agent
This tutorial contains the following sections:
Purpose
Time to CompleteOverview
Scenario
Software and Hardware Requirements
Prerequisites
Incode ODI Agent Password
Create the ODI Physical and Logical Agents
Starting ODI Agent from the Command Line and Testing
Connection
Executing an ODI Object with ODI Agent
Summary
Resources
Purpose
This tutorial walks you through the s teps that are needed to set up and ins tall an Oracle Data Integrator (ODI) Agent
Time to Complete
Approximately 20 minutes
Overview
A common task that is performed using ODI is to set up and install ODI Agent. After the ODI scenarios are created, theycan be scheduled and orchestrated us ing an ODI Agent, which is a lightweight Java process that orchestrates theexecution of ODI scenarios. . This tutorial walks you through the s teps that are needed to set up and ins tall the ODI Agent. For this example, you use the ODI procedure that was created in the OBE titled Creating an ODI Procedure to Createand Populate a Relational Table. You also verify the execution of the procedure within ODI Operator.
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 isrespons ible for data loading, transformation, and validation. To begin working on her projects, Linda created the newMaster repository and Work repository. Linda als o created the project and the procedure to create a relational table andpopulate it with data. Now Linda needs to set up and ins tall an ODI Agent as a s ervice.
Software and Hardware Requirements
The following is a list of software requirements:
The system s hould include the following ins talled products:
Oracle Database 11gOracle Data Integrator 11gR1
If not done before, start the services and components for Oracle Database 11g
Prerequisites
Before you s tart the tasks, make sure that your system environment meets the following requirements:
-
7/28/2019 ODI11g_ Setting Up an ODI Agent
2/11
/06/12 ODI11g: Setting Up an ODI Agent
acle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_odi_agent/setup_odi_agent.ht
1 . Have ins talled Oracle Database 11g. If not done before, start the services and components for Oracle Database 11g
2 . Have ins talled 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.
To access this OBE, click HERE.ODI11g: Creating an ODI Project and Procedure to Create and Populate a Relational Tab le.
To access these OBEs, click HERE.
Incode ODI Agent Password
Before creating an ODI agent, you must run the encode password command to generate an encrypted password and
paste it into the odiparams .bat parameter file. To do so, perform the following steps:
1. Navigate to the ODI_HOME directory, where ODI is installed and open the agent\bin sub-directory: (
C:\Oracle\Middleware\Oracle_ODI1\oracledi\agent\bin). Navigate to the odiparams.bat file, right-click this file and
select Edit to open it with a text editor. Leave this editor open; you will run a batch file from a Comm and window
and return to this text editor to copy the results into the odiparams.bat file.
Explanation: You need to edit the odiparams.bat file to set the repository connection information for the ODI Agent
to use. The pass word information is stored as an encrypted string. You will generate the encrypted string in a
Command window.
2. Leave the text editor open, and open the Command window (Start -> Run -> cmd) and change the directory to the
-
7/28/2019 ODI11g_ Setting Up an ODI Agent
3/11
/06/12 ODI11g: Setting Up an ODI Agent
acle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_odi_agent/setup_odi_agent.ht
ODI_HOME\agent\bin directory:
C:\Oracle\Middleware\Oracle_ODI1\oracledi\agent\bin
3. To generate the encrypted password string, you will be using the agent command: encode . Because
your password is the word oracle1, enter and execute the following command in the Comm and window:
encode oracle1
Keep the Command window open, as you will be returning to it after editing the odiparams.bat file.
4. Copy the generated encrypted password from the Command window (from the Command windows pull-down
menu, select Edit > Mark, then highlight the pass word with your mous e) and insert it into the odiparams .bat file as
the value for the ODI_MASTER_ENCODED_PASS parameter. Verify and, if necessary, edit settings forother
parameters from the table below, save the odiparams.batfile, and then close it. The agents connectivity is now set
up.
Parameter Value
ODI_MASTER_DRIVER oracle.jdbc.OracleDriver
ODI_MASTER_URL jdbc:oracle:thin:@localhost:1521:orcl
ODI_MASTER_USER snpm1
ODI_MASTER_ENCODED_PASS Insert your encoded password.
ODI_SECU_WORK_REP WORKREP1
ODI_SUPRVISOR_ECODED_PASS Leave the default value.
ODI_USER Leave the default value.
ODI_ENCODED_PASS Leave the default value.
-
7/28/2019 ODI11g_ Setting Up an ODI Agent
4/11
/06/12 ODI11g: Setting Up an ODI Agent
acle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_odi_agent/setup_odi_agent.ht
ODI_JAVA_HOME C:\jdk1.6.0_18
Notes:
Usersnpm1 is RDBMS schema/user (Oracle 11g) for Master repos itory. It was created for this and subs equent
OBEs in OBE "Creating and Connecting to ODI Master and Work Repositories".
Work Repository name is WORKREP.
Because each time when you encode the password, it gets different values, your encoded password will di ffer
from the one provided in the screenshot.
Do notchange the default value of the ODI_USER and ODI_ENCODED_PASS parameters. Those parameters
were pre-coded during ODI installation.
-
7/28/2019 ODI11g_ Setting Up an ODI Agent
5/11
/06/12 ODI11g: Setting Up an ODI Agent
acle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_odi_agent/setup_odi_agent.ht
Create the ODI Physical and Logical Agents
Now that you have generated an encoded password and pas ted it into the odiparams.bat file, you need to create the ODI
physical and logical agent definitions.
1. If not started, start Oracle Data Integrator: Start > Programs > Oracle > Oracle dat Integrator > ODI Studio. Click
Connect To Repository. Select WORKREP1 from the LoginName drop-down lis t. For Pass word, enter:
SUNOPSIS. Click OK.
-
7/28/2019 ODI11g_ Setting Up an ODI Agent
6/11
/06/12 ODI11g: Setting Up an ODI Agent
acle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_odi_agent/setup_odi_agent.ht
2. Click Topology tab. In Topology, select the Physical Architecture panel. Right-click the Agents node. Select New
Agent.
-
7/28/2019 ODI11g_ Setting Up an ODI Agent
7/11
/06/12 ODI11g: Setting Up an ODI Agent
acle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_odi_agent/setup_odi_agent.ht
3. Fill in the following fields :
Name: localagent
Host: Network name or IP address of the machine the agent has been launched on. Verify that this parameter
is s et to localhost.
Port: Listening port used by the agent. By default, this port is 20910. Leave the default value.
Web Application Context: Name of the web application corresponding to the J2EE agent deployed on anapplication server. For standalone agents , this field should be set to oraclediagent.
Set Maximum num ber of sess ions s upported by this agent to 250.
Click Save button.
4. Now you have to insert a logical agent in Logical Architecture, and map it to the newly created Physical agent. Click
the LogicalArchitecturetab. Right-clickAgents and select New LogicalAgent. On the screen that follows, set theName to localagent. Set Physical Agents to localagent . From file menu click Save, and then close the Logical
Agent tab.
-
7/28/2019 ODI11g_ Setting Up an ODI Agent
8/11
/06/12 ODI11g: Setting Up an ODI Agent
acle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_odi_agent/setup_odi_agent.ht
Starting ODI Agent from the Command Line and Testing Connection
Now that you have created the agent and defined the ODI physical and logical agents, you can start the agent directly
from the comm and line. You also tes t connection to your ODI standalone agent.
1. Switch back to the Commandwindow you left open at the ODI_HOME\agent\bin directory (
C:\Oracle\Middleware\Oracle_ODI1\oracledi\agent\bin). Execute the agent.bat file using the following command:
agent -NAME=localagent
The agent is now starting. Verify that ODI Agent is successfully started. Minimize the window Command Prompt
agent-NAME=localagent.
Note : This command window should remain open during all labs.
-
7/28/2019 ODI11g_ Setting Up an ODI Agent
9/11
/06/12 ODI11g: Setting Up an ODI Agent
acle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_odi_agent/setup_odi_agent.ht
2. In ODI, click Test icon to verify connection of the ODI agent localagent. Click OK.
You successfully created and connected to ODI agent.
Executing an ODI Object with ODI Agent
With ODI Agent, expand project you 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. In the window that
appears, click the Agent drop-down list and select localagent. Click OK to execute the job with the localagent
agent. When the Information screen shows the "Session started" message, click OK.
-
7/28/2019 ODI11g_ Setting Up an ODI Agent
10/11
/06/12 ODI11g: Setting Up an ODI Agent
acle.com/webfolder/technetwork/tutorials/obe/fmw/odi/odi_11g/setup_odi_agent/setup_odi_agent.ht
2. Click the ODI Operator tab to open ODI Operator. In ODI Operator, click the Session List tab, and then click the
-
7/28/2019 ODI11g_ Setting Up an ODI Agent
11/11
/06/12 ODI11g: Setting Up an ODI Agent
Refresh icon. Expand: Physical Agent > localagent -1> PRD_CREATE_POPULATE_TABLE, and view the execution
results for the PRD-create-populate-table procedure. Verify that procedure PRD-create-populate-table executed
successfully.
Summary
In this tutorial, you have learned how to:
Verify the Prerequisi tes
Encode ODI Password
Set up the ODI AgentExecute an ODI Object with the ODI Agent
ResourcesOracle Data Intergator 11g Documentation
To learn more about , refer to additional OBEs in the Learning Library.
About Oracl e|Oracle and Sun| |Careers|Contact Us|Site Maps|Legal Notices|Terms of Use|Your Privacy Rights