Professional Documents
Culture Documents
Purpose
This tutorial walks you through the steps that are needed to set up and install an Oracle Data Integrator (ODI) Agent
Time to Complete
Approximately 20 minutes
Overview
Acommon task that is performed using ODI is to set up and install ODI Agent. After the ODI scenarios are created, they can be scheduled and orchestrated using an ODI Agent, which is a lightweight Java process that orchestrates the execution of ODI scenarios. . This tutorial walks you through the steps that are needed to set up and install the ODI Agent . For this example, you use the ODI procedure that was created in the OBE titled Creating an ODI Procedure to Create and 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 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 set up and install an ODI Agent as a service.
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: 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 Table. To access these OBEs, click HERE.
to use. The password 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 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 <password>. Because your password is the word oracle1, enter and execute the following command in the Command 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 password with your mouse) and insert it into the odiparams.bat file as the value for the ODI_MASTER_ENCODED_PASS parameter. Verify and, if necessary, edit settings for other parameters from the table below, save the odiparams.batfile, and then close it. The agents connectivity is now set up. Parameter ODI_MASTER_DRIVER ODI_MASTER_URL ODI_MASTER_USER ODI_MASTER_ENCODED_PASS ODI_SECU_WORK_REP Value oracle.jdbc.OracleDriver jdbc:oracle:thin:@localhost:1521:orcl snpm1 Insert your encoded password. WORKREP1
ODI_SUPRVISOR_ECODED_PASS Leave the default value. ODI_USER Leave the default value.
converted by Web2PDFConvert.com
User snpm1 is RDBMS schema/user (Oracle 11g) for Master repository. It was created for this and subsequent 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 differ from the one provided in the screenshot. Do not change the default value of the ODI_USER and ODI_ENCODED_PASS parameters. Those parameters were pre-coded during ODI installation.
converted by Web2PDFConvert.com
2. Click Topology tab. In Topology, select the Physical Architecture panel. Right-click the Agents node. Select New Agent.
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 set 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 an application server. For standalone agents, this field should be set to oraclediagent. Set Maximum number of sessions supported by this agent to 250. Click Save button.
converted by Web2PDFConvert.com
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 the Name to localagent. Set Physical Agents to localagent . From file menu click Save, and then close the Logical Agent tab.
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 command line. You also test 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
converted by Web2PDFConvert.com
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.
2. In ODI, click Test icon to verify connection of the ODI agent localagent. Click OK.
converted by Web2PDFConvert.com
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 > 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
<Include a short summary of what users accomplished by following all the steps. You may also include additional information that you think is relevant and helpful, optional additional exercises for the user to learn more about related functionality, and related topics links, as described in the Resources section below.>
converted by Web2PDFConvert.com
In this tutorial, you have learned how to: Verify the Prerequisites Encode ODI Password Set up the ODI Agent Execute an ODI Object with the ODI Agent
Resources
Oracle Data Intergator 11g Documentation To learn more about , refer to additional OBEs in the Learning Library.
| Careers | Contact Us | Site Maps | Legal Notices | Terms of Use | Your Privacy Rights
converted by Web2PDFConvert.com