Documente Academic
Documente Profesional
Documente Cultură
November 2013
Documentation for installers and system administrators that
describes how to install and configure Oracle Data Integrator.
Oracle Fusion Middleware Installing and Configuring Oracle Data Integrator 12c (12.1.2)
E39433-02
Copyright 2013, Oracle and/or its affiliates. All rights reserved.
Primary Author: Kevin Hwang
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it
on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data
delivered to U.S. Government customers are "commercial computer software" or "commercial technical data"
pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As
such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and
license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of
the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software
License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
This software or hardware is developed for general use in a variety of information management
applications. It is not developed or intended for use in any inherently dangerous applications, including
applications that may create a risk of personal injury. If you use this software or hardware in dangerous
applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other
measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages
caused by use of this software or hardware in dangerous applications.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks
of their respective owners.
This software and documentation may provide access to or information on content, products, and services
from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all
warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and
its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of
third-party content, products, or services.
Contents
Preface ................................................................................................................................................................ vii
Audience...................................................................................................................................................... vii
Documentation Accessibility .................................................................................................................... vii
Related Documents .................................................................................................................................... vii
Conventions ............................................................................................................................................... viii
2-1
2-1
2-2
2-2
2-3
iii
3 Creating the Oracle Data Integrator Master and Work Repository Schema
3.1
3.2
3.3
6.4
Starting the Servers and Standalone Agent .........................................................................
6.4.1
Starting the Administration Server ................................................................................
6.4.2
Starting the Colocated Standalone Agent .....................................................................
6.4.2.1
Starting the Agent Using Node Manager ..............................................................
6.4.2.1.1
Starting the Node Manager...............................................................................
6.4.2.1.2
Starting the Agent ..............................................................................................
6.4.2.2
Starting the Agent Without Node Manager ..........................................................
6.5
Performing Next Steps ............................................................................................................
6-12
6-12
6-13
6-13
6-13
6-14
6-14
6-14
7-1
7-2
7-2
7-3
8-1
8-2
8-2
8-2
8-2
8-3
8-3
8-3
8-3
8-4
8-4
8-5
8-5
B-1
B-2
B-2
B-2
vi
Preface
This document describes how to use the Oracle Data Integrator installation program to
install the Oracle data Integrator software and configure a WebLogic domain.
If you are an existing Oracle Data Integrator user, your path to obtain the most recent
version of the software will depend on the version of your existing software. For more
information, refer to the Oracle Fusion Middleware Download, Installation, and
Configuration Readme Files for the steps you need to take to update or upgrade your
existing software.
Audience
This guide is intended for administrators who are responsible for installing and
configuring components of Oracle Data Integrator. It is assumed that readers are
comfortable running some system administration operations, such as creating users
and groups, adding users to groups, and installing operating system patches on the
computer where your products will be installed. Users in UNIX systems who are
installing need root access to run some scripts.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle
Accessibility Program website at
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.
Access to Oracle Support
Oracle customers have access to electronic support through My Oracle Support. For
information, visit
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are
hearing impaired.
Related Documents
For important information about Oracle Fusion Middleware products, see the
following manuals:
This book introduces the common terms and concepts in an Oracle Fusion
Middleware environment.
For important information about updating or upgrading your existing Oracle Data
Integrator software to the latest version, see the following manual:
For more information about related Oracle Data Integrator products and services, see
the following manuals:
Getting Started with SAP ABAP ERP Adapter for Oracle Data Integrator
This book describes how to use Oracle Data Integrator with the SAP ABAP ERP
Adapter, including configuration, loading a Data Warehouse with data from SAP
ERP systems, and validating data quality.
Getting Started with SAP ABAP BW Adapter for Oracle Data Integrator
This book describes how to use Oracle Data Integrator with the SAP ABAP BW
Adapter, including configuration, loading a Data Warehouse with data from SAP
BW systems, and validating data quality.
Conventions
The following text conventions are used in this document:
viii
Convention
Meaning
boldface
italic
Convention
Meaning
monospace
ix
1
Planning Your Oracle Data Integrator
Installation
This chapter helps to prepare you for your Oracle Data Integrator installation.
Various topics are covered that should be reviewed thoroughly to help ensure that you
do not encounter any problems either during or after the product installation and
domain configuration.
This chapter includes the following sections:
Tip:
1-2
For more information about the contents of the Oracle Data Integrator distribution, see
Appendix A.
Note: If you only want to use ODI studio and do not wish to
configure a domain, you can skip the domain creation instructions in
this guide. ODI Studio is available for use after the Enterprise
Installation install type is completed and database schemas are
created.
A roadmap describing the necessary steps to arriving at these topologies can be found
in Section 1.6.
1.5.1 Understanding the Standard Installation Topology for the Java EE Agent
Figure 11 shows the standard installation topology for Oracle Data Integrator Java EE
agent.
1-4
Cluster (ODI_cluster1)
Machine (ODI_machine1)
Managed Server
(ODI_server1)
Infrastructure
Java EE Agent
(OracleDIAgent)
DBHOST
Element
APPHOST
DBHOST
WebLogic Domain
Administration Server
Enterprise Manager
Cluster
Machine
Managed Server
Infrastructure
Java EE Agent
1.5.2 Understanding the Standard Installation Topology for the Standalone Agent
Figure 12 shows the standard installation topology for the standalone agent.
1-6
DBHOST
Element
APPHOST
DBHOST
Standalone Domain
System Component
1.5.3 Understanding the Standard Installation Topology for the Colocated Standalone
Agent
Figure 13 shows the standard installation topology for the colocated standalone
agent.
APPHOST
WebLogic Domain
Administration Server
Enterprise Manager
Machine (ODI_machine1)
System Component
(OracleDIAgent1)
DBHOST
APPHOST
DBHOST
Administration Server
Enterprise Manager
Machine
1-8
System Component
Task
Description
Documentation
Determine your
installation directories
Verify that the directories that will need to be created See "Understanding the
can be created or accessed by the installer, and exist
Recommended Directory
on systems that meet the minimum requirements.
Structure" in Planning an
Installation of Oracle Fusion
Middleware.
See Chapter 3.
important tasks and checks to perform to make sure your environment is properly
prepared for installing and configuring Oracle Data Integrator.
Table 15
Task
Description
Documentation
Tip:
The distribution contains the products and feature sets described in Appendix A.
For information on how to obtain the distribution, see "Obtaining Product
Distributions" in Planning an Installation of Oracle Fusion Middleware.
1-10
2
Installing Oracle Data Integrator
This chapter describes how to install and configure Oracle Data Integrator.
Post-installation configuration parameters are also provided.
The following topics are covered:
Section 2.2, "Navigating the Installation Screens to Install Oracle Data Integrator"
2.
The installer requires that a certified JDK already exists on your system. For more
information, see the appropriate certification document for 12c (12.1.2) on the
Oracle Fusion Middleware Supported System Configurations page.
3.
4.
Launch the installation program by invoking java -jar from the JDK directory
on your system, as shown in the example below:
/home/Oracle/jdk7_15/jdk1.7.0_15/bin/java -jar odi_121200_generic.jar
2-1
Table 21
Screen
Description
Installation Inventory Setup This screen will appear if this is the first time you are installing
any Oracle product on this host. Specify the location where you
want to create your central inventory. Make sure that the
operating system group name selected on this screen has write
permissions to the central inventory location.
For more information about the central inventory, see
"Understanding the Oracle Inventory" in Installing Software with
the Oracle Universal Installer.
Welcome
Installation Location
Installation Type
Prerequisite Checks
Installation Summary
Installation Progress
Installation Complete
2-3
2-4
3
Creating the Oracle Data Integrator Master
and Work Repository Schema
This chapter describes how to create the Master and Work Repository (ODI_REPO)
database schemas using the Repository Creation Utility (RCU).
This step is required before any domain is configured for your Oracle Data Integrator
agent.
The following topics are covered in this chapter:
Start RCU.
On UNIX operating systems:
./rcu
Creating the Oracle Data Integrator Master and Work Repository Schema
3-1
Tip:
3-2
If you are running RCU from an Enterprise installation, you will see the following:
You must make a note of the custom prefix you choose to enter
here; you will need this later on during the domain creation process.
Tip:
Click Next to proceed, then click OK on the dialog window confirming that
prerequisite checking for schema creation was successful.
Task 5 Specifying Schema Passwords
Specify how you want to set the schema passwords on your database, then specify and
confirm your passwords.
You must make a note of the passwords you set on this screen;
you will need them later on during the domain creation process.
Tip:
Creating the Oracle Data Integrator Master and Work Repository Schema
3-3
Tip:
3-4
4
Configuring the Standard Installation
Topology for the Java EE Agent
This chapter describes how to create and configure the domain for the Java EE agent
standard installation topology.
Before you continue, make sure that you have completed the Enterprise Installation
install type (Chapter 2). This install type contains ODI Studio, and also the necessary
files to create and configure a WebLogic Domain.
The following topics are covered:
Section 4.2, "Configuring Your WebLogic Domain for Your Java EE Agent"
Section 4.3, "Creating a Java EE Agent in the Master Repository Using ODI Studio"
4-1
./config.sh
Tip:
Tip:
4-3
Tip:
Tip:
Description
DBMS/Service
Host Name
Port
Schema Owner
Schema Password
4-4
Click Get RCU Configuration when you are finished specifying the database
connection information. The following output in the Connection Result Log indicates
that the operation succeeded:
Connecting to the database server...OK
Retrieving schema data from database server...OK
Binding local schema components with retrieved data...OK
Successfully Done.
Tip:
More information about the other options on this screen can be found
in Datasource Defaults in Creating WebLogic Domains Using the
Configuration Wizard
Task 7 Specifying JDBC Component Schema Information
Verify that the values on the JDBC Component Schema screen are correct for all
schemas. If you selected RCU Data on the previous screen, the schema table should
already be populated appropriately.
For high availability environments, see the following sections in
High Availability Guide for additional information on configuring data
sources for Oracle RAC databases:
Tip:
More information about the other options on this screen can be found
in JDBC Component Schema in Creating WebLogic Domains Using the
Configuration Wizard.
Task 8 Testing the JDBC Connections
Use the JDBC Component Schema Test screen to test the datasource connections you
have just configured.
4-5
A green check mark in the Status column indicates a successful test. If you encounter
any issues, see the error message in the Connection Result Log section of the screen, fix
the problem, then try to test the connection again.
More information about the other options on this screen can be
found in Test Component Schema in Creating WebLogic Domains Using
the Configuration Wizard
Tip:
2.
A key for the Supervisor user already exists. Modify the credential as follows:
a.
Specify SUPERVISOR (all CAPS) as the user name. This is the default name
initially assigned to the Supervisor account and cannot be changed unless you
create a new Supervisor account.
b.
The password must be the same password specified on the Custom Variables
screen in RCU during schema creation (see Task 6 in Section 3.3).
b.
In the Key Name field, enter the name of this domain as the key.
c.
In the Username and Password fields, provide the Administrator users user
name and password.
d.
Administration Server
This is required to properly configure the listen address of the Administration
Server.
Node Manager
This is required to configure Node Manager.
4-6
Tip:
In the Listen Address drop-down list, select the IP address of the host on which
the Managed Server will reside. Do not use "All Local Addresses."
2.
In the Server Groups drop-down list, select JRF-MAN-SVR. This server group
ensures that the Oracle JRF services are targeted to the Managed Servers you are
creating.
Server groups target Fusion Middleware applications and services to one or more
servers by mapping defined application service groups to each defined server
group. A given application service group may be mapped to multiple server
groups if needed. Any application services that are mapped to a given server
group are automatically targeted to all servers that are assigned to that group. For
more information, see "Application Service Groups, Server Groups, and
Application Service Mappings" in Domain Template Reference.
These server names and will be referenced throughout this document; if you choose
different names be sure to replace them as needed.
Note: You must make a note of the IP address and port number for
the Managed Server. You will need this information when you
configure the ODI agent.
Tip:
2.
4-7
3.
By default, server instances in a cluster communicate with one another using unicast.
If you want to change your cluster communications to use multicast, refer to
"Considerations for Choosing Unicast or Multicast" in Administering Clusters for Oracle
WebLogic Server.
New clusters can also be created using Fusion Middleware Control. In such cases,
cluster communication (unicast or multicast) can be configured when the new cluster
is created. For more information, see "Create and configure clusters" in Oracle WebLogic
Server Administration Console Online Help
More information about the options on this screen can be found
in Clusters in Creating WebLogic Domains Using the Configuration
Wizard.
Tip:
In the Clusters pane, select the cluster to which you want to assign the servers; in
this case, ODI_cluster1.
2.
Click once on ODI_server1 to select it, then click on the right arrow to move it
beneath the selected cluster (ODI_cluster1) in the Clusters pane.
Double-click on ODI_server1 to move it beneath the selected cluster (ODI_
cluster1) in the clusters pane.
Tip:
4-8
Note: Setting the unicast listen port to 0 creates an offset for the
Managed Server port numbers. The offset is 5000, meaning the
maximum allowed value that can be assigned to a Managed Server
port number is 60535, instead of 65535.
See Table 72 for more information and next steps for configuring Coherence.
Note: For Coherence licensing information, refer to "Oracle
Coherence" in Licensing Information.
Tip:
1.
2.
3.
In the Node Manager Listen Address field, select the IP address of the machine
where the Managed Servers are being configured.
You must select a specific interface and not "localhost." This allows Coherence
cluster addresses to be dynamically calculated.
4.
Tip:
4-9
In the Machines pane, select the machine to which you want to assign the servers;
in this case, ODI_machine1.
2.
3.
Click once on AdminServer to select it, then click on the right arrow to move it
beneath the selected machine (ODI_machine1) in the Machines pane.
Double-click on AdminServer to move it beneath the selected machine (ODI_
machine1) in the Machines pane.
Tip:
Tip:
Task 20 Writing Down Your Domain Home and Administration Server URL
The Configuration Success screen will show the Domain home location and URL of the
Administration Server you just configured:
4-10
You must make a note of both items as you will need them to start the servers in your
domain.
Click Finish to dismiss the configuration wizard.
4.3 Creating a Java EE Agent in the Master Repository Using ODI Studio
A physical agent corresponds to a single standalone agent or a Java EE agent. A
physical agent should have a unique name in the topology.
As part of its startup sequence, an agent connects to the Master Repository to see if
there is a physical agent defined with its name. If it finds its entry, the agent continues
with startup and, once started, it reads all the scheduled jobs of itself from the
repository and starts processing.
If there is no physical agent entry for an agent, then the agent startup fails.
ODI Studio can be used to create the agent:
Go to the Oracle home where you have installed Oracle Fusion Middleware
Infrastructure and the Enterprise Installation type.
2.
3.
4-11
For more information, refer to the topics in the ODI Studio Help
menu.
Task 1 Getting Started
From the ODI Studio menu, select File, then select New.
On the New gallery screen, select Create a New ODI Repository Login, then click OK.
Task 2 Creating a Login
On the Oracle Data Integrator Login screen, click the plus sign (+) icon to create a new
login. On the Repository Connection Information screen:
4-12
Password: Specify the password defined for the Supervisor user on both the
RCU Custom Variables screen and also the Credentials screen in the
Configuration Wizard.
User: Specify the schema user name for the Master repository. This should be
prefix_ODI_REPO as specified on the Select Components screen in RCU.
Password: Specify the schema password for the Master repository. This was
specified on the Schema Passwords screen in RCU.
Driver List: Select the appropriate driver for your database from the
drop-down list.
URL: Specify the connection URL. Click on the magnifying glass icon for more
information about the connection details for your driver.
Click Test to test the connection, and fix any errors. After the test is successful, click
OK to create the connection.
Task 3 Specifying a New Wallet Password
If you want to keep your Oracle Data Integrator and repository passwords encrypted,
select Store passwords in secure wallet, then specify and confirm a new wallet
password on the New Wallet Password screen.
If you do not want to encrypt your credentials, select Store passwords without secure
wallet.
Task 4 Logging in to the Master Repository
After you have successfully created a new login, you are returned to ODI Studio.
Select Connect to Repository and, when prompted, provide your new wallet
password.
After providing your wallet password, the Oracle Data Integrator Login screen
appears. Provide the following information to log in:
1.
In the drop-down menu in the Login Name field, select the name of the new login
you just created.
2.
3.
4-13
When you are logged in, follow the instructions in Section 4.3.3 to create the Java EE
agent.
Description
Name
Host
Enter the IP address or name of the machine where the agent is running.
Do not use "localhost."
Port
4-14
4-15
./startWebLogic.sh
If you selected Production Mode on the Domain Mode and JDK screen in Task 5, you
will be prompted for the login credentials of the Administrator user as provided on
the Administrator Account screen in Task 4.
For more information about starting the Administration Server,
see "Starting and Stopping Administration Servers" in Administering
Oracle Fusion Middleware.
Tip:
For more information about how to use the Administration Console, see "Getting
Started Using Oracle WebLogic Server Administration Console" in Administering
Oracle Fusion Middleware.
The Administration Server host and port number were in the URL on the
Configuration Success screen (Task 20). The default Administration Server port
number is 7001.
The login credentials were provided on the Administrator Account screen (Task 4).
4-16
2.
From the "Target Navigation" pane, click the arrows to expand the domain until
the Managed Servers (ODI_server1) is visible.
3.
4.
5.
In the Target Navigation page, select your domain name to see that all the servers
are up and running.
Tip:
4-17
Section 7.2 contains additional domain configuration tasks that take advantage of
additional Oracle Fusion Middleware products and features.
Section 7.3 contains common tasks to help prepare your Oracle Data Integrator
environment for development.
Section 7.4 contains important tasks to help prepare your environment to move to a
highly available environment.
4-18
5
Configuring the Standalone Installation
Topology for the Standalone Agent
This chapter describes how to create and configure your domain for the standalone
agent.
Before you continue, make sure that you have completed the following:
Section 5.2, "Configuring Your Standalone Domain for the Standalone Agent"
Section 5.3, "Creating a Standalone Agent in the Master Repository Using ODI
Studio"
Section 5.2.2, "Navigating the Configuration Wizard Screen to Create the Domain"
Configuring the Standalone Installation Topology for the Standalone Agent 5-1
Tip:
More information about the other options on this screen can be found
in Configuration Type in Creating WebLogic Domains Using the
Configuration Wizard.
5-2
Description
DBMS/Service
Host Name
Port
Schema Owner
Schema Password
Configuring the Standalone Installation Topology for the Standalone Agent 5-3
Click RCU Data when you are finished specifying the database connection
information. The following output in the Connection Result Log indicates that the
operation succeeded:
Connecting to the database server...OK
Retrieving schema data from database server...OK
Binding local schema components with retrieved data...OK
Successfully Done.
Tip:
More information about the other options on this screen can be found
in Datasource Defaults in Creating WebLogic Domains Using the
Configuration Wizard
Task 5 Specifying JDBC Component Schema Information
Verify that the values on the JDBC Component Schema screen are correct for all
schemas. If you selected RCU Data on the previous screen, the schema table should
already be populated appropriately.
For high availability environments, see the following sections in
High Availability Guide for additional information on configuring data
sources for Oracle RAC databases:
Tip:
More information about the other options on this screen can be found
in JDBC Component Schema in Creating WebLogic Domains Using the
Configuration Wizard.
Task 6 Testing the JDBC Connections
Use the JDBC Component Schema Test screen to test the datasource connections you
have just configured.
A green check mark in the Status column indicates a successful test. If you encounter
any issues, see the error message in the Connection Result Log section of the screen, fix
the problem, then try to test the connection again.
More information about the other options on this screen can be
found in Test Component Schema in Creating WebLogic Domains Using
the Configuration Wizard
Tip:
5-4
1.
Under System Component, you can either use the default ODI component
(OracleDIAgent1) name, or specify a name of your choice.
2.
Under Component Type, ensure that ODI is selected from the drop-down list.
Tip:
Description
System Component
Specify the IP address of the server where the ODI server should
listen. Do not use "localhost."
Supervisor Username
Supervisor Password
Preferred Datasource
Tip:
Select Per Domain as the Node Manager type, then specify the Node Manager
credentials. You will be asked for these credentials when starting your system
component with the startComponent command.
Configuring the Standalone Installation Topology for the Standalone Agent 5-5
Tip:
Tip:
Go to the Oracle home where you have installed Oracle Fusion Middleware
Infrastructure and the Enterprise Installation type.
2.
3.
5-6
For more information, refer to the topics in the ODI Studio Help
menu.
Task 1 Getting Started
From the ODI Studio menu, select File, then select New.
On the New gallery screen, select Create a New ODI Repository Login, then click OK.
Task 2 Creating a Login
On the Oracle Data Integrator Login screen, click the plus sign (+) icon to create a new
login. On the Repository Connection Information screen:
Password: Specify the password defined for the Supervisor user on both the
RCU Custom Variables screen and also the Credentials screen in the
Configuration Wizard.
User: Specify the schema user name for the Master repository. This should be
prefix_ODI_REPO as specified on the Select Components screen in RCU.
Password: Specify the schema password for the Master repository. This was
specified on the Schema Passwords screen in RCU.
Driver List: Select the appropriate driver for your database from the
drop-down list.
URL: Specify the connection URL. Click on the magnifying glass icon for more
information about the connection details for your driver.
Configuring the Standalone Installation Topology for the Standalone Agent 5-7
Click Test to test the connection, and fix any errors. After the test is successful, click
OK to create the connection.
Task 3 Specifying a New Wallet Password
If you want to keep your Oracle Data Integrator and repository passwords encrypted,
select Store passwords in secure wallet, then specify and confirm a new wallet
password on the New Wallet Password screen.
If you do not want to encrypt your credentials, select Store passwords without secure
wallet.
Task 4 Logging in to the Master Repository
After you have successfully created a new login, you are returned to ODI Studio.
Select Connect to Repository and, when prompted, provide your new wallet
password.
After providing your wallet password, the Oracle Data Integrator Login screen
appears. Provide the following information to log in:
5-8
1.
In the drop-down menu in the Login Name field, select the name of the new login
you just created.
2.
3.
When you are logged in, follow the instructions in Section 5.3.3 to create the
standalone agent.
Description
Name
Host
Enter the IP address or name of the machine where the agent is running.
Do not use "localhost."
Port
Configuring the Standalone Installation Topology for the Standalone Agent 5-9
./startComponent.sh OracleDIAgent1
You will be prompted for the Administrator password for the domain.
To verify that your agent was started, go to the following URL in your browser:
http://examplehost.exampledomain.com:port/oraclediagent
The -NAME parameter must be entered in all CAPS and the name of the agent (in this
case, OracleDIAgent1) is also case-sensitive.
5-11
5-12
6
Configuring the Standard Installation
Topology for the Colocated Standalone
Agent
6
This chapter describes how to create and configure your domain for the colocated
standalone agent.
Before you continue, make sure that you have completed the Enterprise Installation
install type (Chapter 2). This is for obtaining ODI Studio, which is only available with
this install type, and also for obtaining the files necessary to configure a WebLogic
domain and colocated standalone agent.
The following topics are covered in this chapter:
Configuring the Standard Installation Topology for the Colocated Standalone Agent 6-1
6-2
Tip:
Tip:
Description
DBMS/Service
Host Name
Port
Configuring the Standard Installation Topology for the Colocated Standalone Agent 6-3
Field
Description
Schema Owner
Schema Password
Click Get RCU Configuration. The following output in the Connection Result Log
indicates that the operating succeeded:
Connecting to the database server...OK
Retrieving schema data from database server...OK
Binding local schema components with retrieved data...OK
Successfully Done.
Tip:
Tip:
More information about the other options on this screen can be found
in JDBC Component Schema in Creating WebLogic Domains Using the
Configuration Wizard.
6-4
Tip:
Administration Server
This is required to properly configure the listen address of the Administration
Server.
Node Manager
This is required to configure Node Manager.
1.
2.
System Components
This is required to configure the standalone agent.
Configuring the Standard Installation Topology for the Colocated Standalone Agent 6-5
Note: This screen will only appear if you selected Node Manager in
Task 8:
After the Node Manager and agent are configured, you start the
agent using the instructions in Section 6.4.2.1.
If you chose not to configure Node Manager, start the agent using
the instructions in Section 6.4.2.2.
Select Per Domain as the Node Manager type, then specify the Node Manager
credentials.
More information about the options on this screen can be found
in Node Manager in Creating WebLogic Domains Using the Configuration
Wizard.
Tip:
Value
System Component
Enter the host name or IP address of the system on which the agent
resides. Do not use "localhost."
Supervisor Username
Supervisor Password
Preferred Datasource
Note: Oracle recommends that you write down the host name and
port number of the agent; you will need this later when you create the
agent in the master repository (Section 6.3).
6-6
Tip:
Tip:
Configuring the Standard Installation Topology for the Colocated Standalone Agent 6-7
Tip:
Task 16 Writing Down Your Domain Home and Administration Server URL
The Configuration Success screen will show the Domain home location and URL of the
Administration Server you just configured:
When domain creation is complete, click Finish to dismiss the configuration wizard.
6-8
For more information, refer to the topics in the ODI Studio Help
menu.
Task 1 Getting Started
From the ODI Studio menu, select File, then select New.
On the New gallery screen, select Create a New ODI Repository Login, then click OK.
Task 2 Creating a Login
On the Oracle Data Integrator Login screen, click the plus sign (+) icon to create a new
login. On the Repository Connection Information screen:
Password: Specify the password defined for the Supervisor user on both the
RCU Custom Variables screen and also the Credentials screen in the
Configuration Wizard.
User: Specify the schema user name for the Master repository. This should be
prefix_ODI_REPO as specified on the Select Components screen in RCU.
Password: Specify the schema password for the Master repository. This was
specified on the Schema Passwords screen in RCU.
Driver List: Select the appropriate driver for your database from the
drop-down list.
URL: Specify the connection URL. Click on the magnifying glass icon for more
information about the connection details for your driver.
Configuring the Standard Installation Topology for the Colocated Standalone Agent 6-9
Click Test to test the connection, and fix any errors. After the test is successful, click
OK to create the connection.
Task 3 Specifying a New Wallet Password
If you want to keep your Oracle Data Integrator and repository passwords encrypted,
select Store passwords in secure wallet, then specify and confirm a new wallet
password on the New Wallet Password screen.
If you do not want to encrypt your credentials, select Store passwords without secure
wallet.
Task 4 Logging in to the Master Repository
After you have successfully created a new login, you are returned to ODI Studio.
Select Connect to Repository and, when prompted, provide your new wallet
password.
After providing your wallet password, the Oracle Data Integrator Login screen
appears. Provide the following information to log in:
6-10
1.
In the drop-down menu in the Login Name field, select the name of the new login
you just created.
2.
3.
When you are logged in, follow the instructions in Section 6.3.3 to create the
standalone agent.
Description
Name
Host
Enter the IP address or name of the machine where the agent is running.
Do not use "localhost."
Port
Configuring the Standard Installation Topology for the Colocated Standalone Agent
6-11
If you selected Production Mode on the Domain Mode and JDK screen in Task 4, you
will be prompted for the login credentials of the Administrator user as provided on
the Administrator Account screen in Task 3.
For more information about starting the Administration Server,
see "Starting and Stopping Administration Servers" in Administering
Oracle Fusion Middleware.
Tip:
6-12
You can verify that the Administration Server is up and running by access the
Administration Server Console. The URL is provided on the Configuration Success
screen in Task 16.
Note: Make sure that the database hosting your product schemas is
up and running and accessible by the Administration Server.
http://administration_server_host:administration_server_port/console
For more information about how to use the Administration Console, see "Getting
Started Using Oracle WebLogic Server Administration Console" in Administering
Oracle Fusion Middleware.
If you chose to configure a Node Manager (Task 10), use the instructions in
Section 6.4.2.1 to start your standalone agent.
If you want to start your standalone agent without Node Manager, use the
instructions in Section 6.4.2.2.
6.4.2.1.1 Starting the Node Manager To start your per-domain Node Manager, go to the
DOMAIN_HOME/bin directory.
On UNIX operating systems, start the Node Manager as shown below, using nohup
and nm.out as an example output file:
nohup ./startNodeManager.sh > nm.out&
Configuring the Standard Installation Topology for the Colocated Standalone Agent
6-13
You will be prompted for the Administrator password for the domain.
To verify that your agent was started, go to the following URL in your browser:
http://examplehost.exampledomain.com:port/oraclediagent
The -NAME parameter must be entered in all CAPS and the name of the agent (in this
case, OracleDIAgent1) is also case-sensitive.
6-14
7
Next Steps After Configuring an Oracle Data
Integrator Domain
This chapter describes common tasks you might want to perform on a newly created
domain for Oracle Data Integrator.
The following sections are included in this chapter:
Task
Description
More Information
7-1
Task
Description
More Information
Deploying Applications
Adding a Web Tier front-end to your Oracle Web Tier hosts Web pages
domain
(static and dynamic), provides
security and high performance along
with built-in clustering, load
balancing, and failover features. In
particular, the Web Tier contains
Oracle HTTP Server.
7-2
Table 73
Task
Description
More Information
Administer your
repositories
Task
Description
More Information
7-3
7-4
8
Deinstalling Oracle Data Integrator
Task
Description
Documentation
Remove your
database schemas.
Remove the software. Run the product deinstaller to remove Oracle Fusion Middleware
Infrastructure.
8-1
Description
Documentation
The deinstaller does not remove all files and folders from the Oracle
home directory. After the deinstaller is finished, you must manually
remove the Oracle home to complete your product removal.
Remove your
domain and
application data.
The deinstaller does not remove data contained in your Domain home
or Application home directories, even if they are located inside the
Oracle home. You must remove these directories manually.
Remove Oracle
Fusion Middleware
Infrastructure.
In you created the topology for Java EE agents, you can also remove
the Oracle Fusion Middleware Infrastructure software from your
system.
8-2
If you want to perform a silent (command-line) deinstallation, see "Running the Oracle
Universal Installer for Silent Deinstallation" in Installing Software with the Oracle
Universal Installer.
2.
From the command line, go to the ORACLE_HOME\oui\bin and enter the following
command:
deinstall.cmd
3.
From the Start menu, select All Programs, then select Oracle, then select
OracleHome, then select Uninstall Oracle Middleware.
Screen
Description
Welcome
Deinstallation Summary
This screen shows the Oracle home directory and its contents
that will be deinstalled. Verify that this is the correct directory.
Click Deinstall to begin removing the software.
Deinstallation Progress
Deinstallation Complete
8-3
Backup the domain_registry.xml file in your Oracle home, then edit the file and
remove the line associated with the domain you are removing. For example, to
remove the odi_domain, find the following line and remove it:
<domain location="/home/Oracle/config/domains/odi_domain"/>
8-4
Installing in an existing Oracle home that contains the same feature sets.
The installer will warn you that the Oracle home you specified during the
installation already contains the same software you are trying to install. Your
options are to:
a.
Select a different installation type. In this case, only the feature sets that do not
already exist in the Oracle home directory will be installed.
b.
Deinstall your software from the Oracle home as described in this chapter, and
then remove the Oracle home directory. After this is complete, you can
reinstall and reuse the same Oracle home location, using the instructions in
Chapter 2. Any domain or application data that was in the Oracle home will
have to be re-created.
b.
8-5
8-6
A
Understanding the Oracle Data Integrator
Distribution
This appendix describes the products and feature sets available in the Oracle Data
Integrator distribution.
The Oracle Data Integrator distribution contains the products and feature sets
described in Table A1. Unless otherwise noted, all products and feature sets are
available with both Standalone Installation and Enterprise Installation types.
Table A1
Product
Feature Set
Description
Oracle Data
Integrator features
ODI SDK
ODI Studio
ODI J2EE
Feature Set
Description
Internal Features
Apache Ant
FMW Upgrade
This is the upgrade assistant that can be used to upgrade your 11g
Oracle Data Integrator software to 12c.
For more information, see Upgrading Oracle Data Integrator.
OPatch
The OPatch utility is a tool that allows the application and rollback
of interim patches to Oracle products.
Repository Creation
Utility
B
Troubleshooting Oracle Data Integrator
This appendix describes solutions to common problems that you might encounter
when installing Oracle Data Integrator.
The following sections are included:
Read the Oracle Fusion Middleware Release Notes for the latest updates. The most
current version of the release notes is available on Oracle Technology Network:
http://www.oracle.com/technetwork/documentation/index.html#middlewa
re
Verify your system and configuration is certified. Refer to the System Requirements
and Supported Platforms for Oracle Fusion Middleware 11gR1 document on the Oracle
Fusion Middleware Supported System Configurations page:
http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-c
ertification-100350.html
Verify your system meets the minimum system requirements. Refer to the System
Requirements and Specifications document:
http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-r
equirements-100147.html
2.
3.
4.
B-1
Repository Version
12c (12.1.2)
05.01.01.16
04.03.04.02
04.03.04.02
If you are unable to find a solution for your problem, open a service request.