Oracle® Fusion Middleware

Installing Data Service Integrator

12c (12.1.3)

E47945-01

May 2014

Oracle Fusion Middleware Installing Data Service Integrator, 12c (12.1.3)

E47945-01

Copyright © 2009, 2014, Oracle and/or its affiliates. All rights reserved.

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

- Audience

- Documentation Accessibility

- Related Documents

- Conventions

1 Preparing to Install Oracle Data Service Integrator

- 1.1 Installation Overview

- 1.2 Verifying Certification and System Requirements

- 1.3 Understanding Oracle Data Service Integrator Install Versions

- 1.4 Understanding the Oracle Data Service Integrator Installation Topologies

- 1.4.1 Single (Managed) Server Mode

- 1.4.2 Multiple Managed Servers in a Cluster

2 Installing Oracle Data Service Integrator Using Oracle Universal Installer

- 2.1 Starting the Installation Program

- 2.2 Navigating the Oracle Data Service Integrator Installation Screens

- 2.3 Next Steps

3 Installing Oracle Data Service Integrator Using Silent Mode

- 3.1 Using Silent Mode

- 3.2 Creating a Response File

- 3.3 Next Steps

4 Post-Installation Tasks

- 4.1 Verifying the Installation

- 4.1.1 Reviewing Installation Log Files

- 4.1.2 Checking the Directory Structure

- 4.2 Creating a Sample Domain in WebLogic Server

- 4.2.1 Create a Sample Domain in Compact Mode

- 4.2.2 Create a Sample Domain in Expanded Mode

- 4.3 Post-Installation Tasks for Oracle Eclipse

- 4.4 Starting the Development of a Data Integration Solution

5 Deinstalling Oracle Data Service Integrator

6 Upgrading Oracle Data Service Integrator 10gR3 Dataspaces to 12.1.3

- 6.1 Upgrading the Runtime Environment from 10gR3 Dataspaces to 12.1.3

- 6.2 Upgrading the Development Environment from 10gR3 Dataspaces to 12.1.3

A Understanding the Oracle Data Service Integrator Distribution

Preface

This document contains information about installing Oracle Data Service Integrator.

Audience

This document is intended for users who want to work with Oracle Data Service Integrator.

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 more information, see the following documents in the Oracle Data Service Integrator documentation set:

- Oracle Fusion Middleware Data Service Integrator Developer's Guide

- Oracle Fusion Middleware Administering Data Service Integrator

- Oracle Fusion Middleware Developing Data Service Integrator Applications

- Oracle® Fusion Middleware Using Data Service Integrator XQuery Engine

Conventions

The following text conventions are used in this document:

Convention

Meaning

boldface

Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.

italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

monospace

Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

1 Preparing to Install Oracle Data Service Integrator

Before you install Oracle Data Service Integrator, verify that your system meets minimum requirements. This chapter provides information about supported platforms, system hardware and software requirements, and installation prerequisites. It also provides an overview of the Oracle Data Service Integrator components that get installed.

The following sections are included:

- Section 1.1, "Installation Overview"

- Section 1.2, "Verifying Certification and System Requirements"

- Section 1.3, "Understanding Oracle Data Service Integrator Install Versions"

- Section 1.4, "Understanding the Oracle Data Service Integrator Installation Topologies"

Note:

Oracle Data Service Integrator was originally known as Liquid Data and AquaLogic Data Services Platform (ALDSP). Some instances of the original names remain in the product, installation path, and components.

1.1 Installation Overview

This section provides an overview of the tasks required to install Oracle Data Service Integrator.

Task 1: Prepare to Install

1. Check the supported platforms and databases, and verify that you have the installation prerequisites in place. For more information, see Section 1.2, "Verifying Certification and System Requirements."

2. Uninstall any previous versions of Oracle Data Service Integrator. For details see Chapter 5, "Deinstalling Oracle Data Service Integrator."

Note:

The uninstall option does not remove any Oracle Data Service Integrator or other Oracle WebLogic Server projects that you have created.

3. Add an entry for the JDK bin directory (for example, JDK170_40/bin) to your PATH environment variable. Java is a required software for running Oracle Data Service Integrator. The current release of Oracle Data Service Integrator requires the JDK version JDK170_40 or later.

4. Install WebLogic Server 12c (12.1.3) with JRF or WebLogic Server 12c (12.1.3) with JRF and JDBC. Oracle Data Service Integrator IDE runs as a WebLogic Server plugin and requires one of these WebLogic Server products to be installed.
Install WebLogic Server into the directory in which you are installing Oracle Data Service Integrator. Installing either of these WebLogic Server products will create an Oracle Middleware home (<ORACLE_HOME>). An (<ORACLE_HOME>) is required for installing Oracle Data Service Integrator.

For more information about WebLogic Server and downloads, see this URL:

http://www.oracle.com/us/products/middleware/cloud-app-foundation/weblogic/enterprise-edition/overview/index.html

5. Install Oracle Enterprise Pack for Eclipse (OEPE) version 12.1.3 (or later) if you will be using Eclipse to model dataspaces. The Developer installation of Oracle Data Service Integrator installs Eclipse plugins.
For more information about OEPE and downloads, see this URL:

http://www.oracle.com/technetwork/developer-tools/eclipse/overview/index.html

Task 2: Install Oracle Data Service Integrator

You can install Oracle Data Service Integrator in either of the following modes on Windows, Linux, or UNIX systems:

- Oracle Universal Installer—Features an easy-to-use graphical installer application. For more information about using Oracle Universal Installer, see Chapter 2, "Installing Oracle Data Service Integrator Using Oracle Universal Installer."

- Silent mode—Reads an installer response file to determine the install options. For more information about using Silent mode, see Chapter 3, "Installing Oracle Data Service Integrator Using Silent Mode."

Task 3: Perform Post-installation Tasks

After installation, you can verify that the installation was successful and perform post-installation tasks for integration with WebLogic Server and Eclipse. For more information, see Chapter 4, "Post-Installation Tasks."

- If you will be using Oracle Data Service Integrator with WebLogic Server, you can install either the Developer or the Runtime version of the product, then create a preconfigured sample domain. See Section 4.2, "Creating a Sample Domain in WebLogic Server."

- If you will be using Oracle Data Service Integrator with Oracle Eclipse, you must install the Developer version of the product, and then complete some post-installation tasks. See Section 4.3, "Post-Installation Tasks for Oracle Eclipse."

1.2 Verifying Certification and System Requirements

The certification matrix and system requirements documents should be used in conjunction with each other to verify that your environment meets the necessary requirements for installation.

Step 1 Verify Your Environment Meets Certification Requirements

Make sure that you are installing your product on a supported hardware or software configuration. For more information, see the certification document for your release on the Oracle Fusion Middleware Supported System Configurations page.

Oracle has tested and verified the performance of your product on all certified systems and environments; whenever new certifications occur, they are added to the proper certification document right away. New certifications can occur at any time, and for this reason the certification documents are kept outside of the documentation libraries and are available on Oracle Technology Network.

Step 2 Using the System Requirements Document to Verify Certification

The Oracle Fusion Middleware System Requirements and Specifications document should be used to verify that the requirements of the certification are met. For example, if the certification document indicates that your product is certified for installation on 64-Bit Oracle Linux 5, this document should be used to verify that your Oracle Linux 5 system has met the required minimum specifications, like disk space, available memory, specific platform packages and patches, and other operating system-specific items. System requirements can be updated at any time, and for this reason the system requirement documents are kept outside of the documentation libraries and are available on Oracle Technology Network.

1.3 Understanding Oracle Data Service Integrator Install Versions

You can install either the Development version or the Runtime version of Oracle Data Service Integrator.

- Runtime version allows you to import, export, deploy, and administer Oracle Data Service Integrator deployment JARs.

- Development version provides all of the functionality as the Runtime version and also includes plugins for Oracle Eclipse. You can use the Eclipse environment to create and modify dataspaces and artifacts in data services.

1.4 Understanding the Oracle Data Service Integrator Installation Topologies

The following sections describe the topologies into which you can install Oracle Data Service Integrator.

- Single (Managed) Server Mode

- Multiple Managed Servers in a Cluster

1.4.1 Single (Managed) Server Mode

In this scenario, the WebLogic domain contains Machine 1, which contains the Administration Server, the Node Manager and Managed Server 1. Oracle Data Service Integrator is deployed in the Managed Server.

This scenario is illustrated in Figure 1-1. The elements in the illustration are described in Table 1-1.

Figure 1-1 Single (Managed) Server Mode

1.4.2 Multiple Managed Servers in a Cluster

In this scenario, the WebLogic Domain contains Machine 1 and Machine 2. Machine 1 contains the Administration Server, the Node Manager and Managed Server 1 within Cluster 1. Oracle Data Service Integrator is deployed in the Managed Server.

Machine 2 contains a Node Manager and Oracle Data Service Integrator deployed on Managed Server 2. Managed Server 2 is also contained in Cluster 1. The cluster is under the control of the Administration Server on Machine 1.

This scenario is illustrated in Figure 1-2. The elements in the illustration are described in Table 1-1.

Figure 1-2 Multiple Managed Servers in a Cluster

Table 1-1 Description of the Elements in the Oracle Data Service Integrator Installation Topology

Element

Description and Links to Additional Documentation

WebLogic Domain

A logically related group of Java components (in this case, the administration Server, Managed Servers, and other related software components).

For more information, see "What is an Oracle WebLogic Server Domain" in Understanding Oracle Fusion Middleware.

Administration Server

The central control entity of a domain which maintains the domain's configuration objects and distributes configuration changes to Managed Servers.

For more information, see "What is the Administration Server" in Understanding Oracle Fusion Middleware.

Node Manager

A Java utility that runs as a separate process from Oracle WebLogic Server and allows you to perform common operations for a Managed Server, regardless of its location with respect to its Administration Server, and for system components

For more information, see "What Is Node Manager" in Understanding Oracle Fusion Middleware.

Cluster

A collection of multiple WebLogic Server instances running simultaneously and working together.

For more information, see "Understanding Managed Servers and Managed Server Clusters" in Understanding Oracle Fusion Middleware.

Machine

Logical representation of the computer that hosts one or more WebLogic Server instances (servers). Machines are also the logical glue between WebLogic Managed Servers and the Node Manager; in order to start or stop a Managed Server with Node Manager, the Managed Server must be associated with a machine.

Managed Server

Host for your applications, application components, Web services, and their associated resources.

For more information, see "Understanding Managed Servers and Managed Server Clusters" in Understanding Oracle Fusion Middleware.

Oracle Data Service Integrator

Oracle Data Service Integrator is deployed on the Managed Servers.

2 Installing Oracle Data Service Integrator Using Oracle Universal Installer

This chapter describes how to install Oracle Data Service Integrator using Oracle Universal Installer. The Oracle Universal Installer can be used on Microsoft Windows and supported UNIX and Linux-based platforms.

This chapter has the following sections:

- Section 2.1, "Starting the Installation Program."

- Section 2.2, "Navigating the Oracle Data Service Integrator Installation Screens"

- Section 2.3, "Next Steps"

2.1 Starting the Installation Program

To install Oracle Data Service Integrator using Oracle Universal Installer:

1. Ensure that all installation prerequisites are met. See Section 1.1, "Installation Overview."

2. Log in to the target system.

3. The installer requires that a certified JDK already exists on your system. For more information, see the appropriate certification document for 12c (12.1.3) on the Oracle Fusion Middleware Supported System Configurations page.

4. Launch the Oracle Universal Installer.

1. Open a command prompt and navigate to the folder where you downloaded the Oracle Data Service Integrator installer odsi_generic.jar.

Note:

On Windows systems, you must have administrator privileges. On Linux or UNIX systems, you do not need administrator privileges.

2. Execute the JAR file by using the java -jar command. For example:

java -jar odsi_generic.jar

The Oracle Universal Installer Welcome screen appears. Click Next to begin installing Oracle Data Service Integrator.

2.2 Navigating the Oracle Data Service Integrator Installation Screens

The installation program displays a series of screens, in the order listed in Table 2-1.

If you need additional help with any of the installation screens, click the screen name.

Table 2-1 Oracle Data Service Integrator Install Screens

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

This screen introduces you to the product installer.

Installation Location

Use this screen to specify the location of your Oracle home directory.

The Oracle Home directory serves as the central support directory for Oracle Data Service Integrator. Enter the name of the directory in the Oracle Home field, or choose a directory from the drop-down list. You must install Oracle Data Service Integrator in the same home directory where you installed WebLogic Server 12c (12.1.3) with JRF. Once you select a directory, you can click View to display the Oracle features installed at that location.

For more information, see "Selecting Directories for Installation and Configuration" in Planning an Installation of Oracle Fusion Middleware.

Installation Type

Use this screen to select the type of installation and consequently, the products and feature sets you want to install.

In the Installation Type screen, choose whether you want to install the Developer version of Oracle Data Service Integrator or the Runtime version.

The Developer version installs these components:

- Data Services Runtime

- Eclipse Plugins

- Samples

- SOA Common Components

The Runtime version also installs these components, with the exception of the Eclipse Plugins. For more detail on the installed components, see Appendix A, "Understanding the Oracle Data Service Integrator Distribution."

Prerequisite Checks

This screen verifies that your system meets the minimum necessary requirements.

The screen displays checks for the operating system certification, physical memory, and Java version. At any time you can stop the prerequisite checks, rerun the checks, and skip the checks by clicking Stop, Rerun, and Skip, respectively. Click View Log to display the results of the checks.

Installation Summary

The Installation Summary screen displays the components that will be installed and their installation locations.

Click Save Response File to save a copy of the installation details in the location of your choice. For examples of responce files, see Section 3.2, "Creating a Response File."

Installation Progress

This screen allows you to see the progress of the installation. Click View Messages to view installation messages at the bottom of the screen. Click View Log to view detailed messages sent to the logger in a separate progress dialog box.

Installation Complete

This screen appears when the installation is complete. Review the information on this screen, then click Finish to dismiss the installer.

You have successfully installed an instance of Oracle Data Service Integrator. If you selected the Automatically Launch Configuration Utility checkbox, then the Configuration Wizard launches.

2.3 Next Steps

See Section 4.1, "Verifying the Installation" for information on how to verify that Oracle Data Service Integrator installed correctly.

You can integrate Oracle Data Service Integrator with WebLogic Server and with Oracle Eclipse. For more information, see Section 4.2, "Creating a Sample Domain in WebLogic Server" and Section 4.3, "Post-Installation Tasks for Oracle Eclipse."

3 Installing Oracle Data Service Integrator Using Silent Mode

This chapter describes how to install Oracle Data Service Integrator using Silent mode. Silent mode is ideal for remote installations or when incorporating the installation as part of a script. The Windows, UNIX, and Linux versions of the installer provide a noninteractive, or silent-mode installation, that you can use in cases when you want to install Oracle Data Service Integrator without needing to supply information from the keyboard during the installation process. Instead, the installer gets the required information from a response file that you provide.

Before launching a silent-mode installation, make sure that all installation prerequisites are met and that all the information in the response file is correct. After the silent installer is started, it proceeds in the background and does not report exceptions. Some exceptions are ignored.

However, if a previously installed copy of Oracle Data Service Integrator is detected, a dialog box appears asking if you want to override the old version. Other exceptions cause the installer to fail. For example, if the specified Oracle home directory &beahome; or the specified Oracle Data Service Integrator install directory do not exist or are incorrect, the installer fails.

Note:

On UNIX systems, the installer displays the message Installation Complete when it finishes. This message does not necessarily indicate that the installer was successful; it means only that the process has finished running.

If a fatal exception occurs during installation, the installer displays a message and no changes are made to the system.

The chapter includes the following sections:

- Section 3.1, "Using Silent Mode"

- Section 3.2, "Creating a Response File"

- Section 3.3, "Next Steps"

3.1 Using Silent Mode

This section describes how to install Oracle Data Service Integrator on Windows and UNIX systems using Silent Mode.

To install using silent mode:

1. Ensure that all installation prerequisites are met. See Section 1.1, "Installation Overview."

2. Provide the appropriate installer response file.
When you run the Oracle Data Service Integrator installer in silent mode, you must provide a response file for the installation program. The response file specifies the location of the ORACLE_HOME and the type of installation you want to perform (either Developer or Runtime). For more information, see Section 3.2, "Creating a Response File."

3. Open a command window with Administrator privileges.

4. Navigate to the directory containing the Oracle Data Service Integrator installer, odsi_generic.jar.

5. Enter the following command to run the installer in silent mode. The command has the following format:

java -jar odsi_generic.jar -silent -responseFile<response_file_absolute_path> -waitForCompletion

where response_file_absolute_path represents the absolute path to the response file.

6. Run the installer application, specifying the response file and the log file name as options.
The message Preparing to Install is displayed. After the installer decompresses the required files, the installation proceeds with the information specified in the response file. When the process is successful, Installation Complete is displayed.

3.2 Creating a Response File

Silent mode typically uses a response file (.rsp) that contains the installation parameters as name=value pairs. An easy way to create a response file is to run the installer in graphical mode and then save the installation parameters to a response file at the Installation Summary screen. Use the saved file to replicate the installation on other computers or modify the file to change the installation as required.

If you must write your own response file, it must contain the parameters described in Table 3-1. The response file must be saved with the extension ".rsp".

Table 3-1 Response File Parameters

Parameter

Description

Response File Version

The version of the response file for this version of Oracle Data Service Integrator. For the current release, the value must be 1.0.0.0.0.

ORACLE_HOME

The value must be an absolute path. If the directory does not exist, the installer creates the directory. If the directory already exists, it must be empty or it must be an existing valid ORACLE_HOME.

INSTALL_TYPE

The version of Oracle Data Service Integrator that you are installing. Valid values are either ODSI Developer Installation or ODSI Runtime Installation.

Example 3-1 illustrates the contents of a response file for a Developer installation.

Example 3-1 Sample Contents of a Developer Response File

[ENGINE]

#DO NOT CHANGE THIS.
Response File Version=1.0.0.0.0

[GENERIC]

#The oracle home location. This can be an existing Oracle Home or a new Oracle Home
ORACLE_HOME=/scratch/aaa/bbbb

#Set this variable value to the Installation Type selected. e.g. ODSI Developer Installation, ODSI Runtime Installation.
INSTALL_TYPE=ODSI Developer Installation

Example 3-2 illustrates the contents of a response file for a Runtime installation.

Example 3-2 Sample Contents of a Runtime Response File

[ENGINE]

#DO NOT CHANGE THIS.
Response File Version=1.0.0.0.0

[GENERIC]

#The oracle home location. This can be an existing Oracle Home or a new Oracle Home
ORACLE_HOME=/scratch/aaa/bbbb

#Set this variable value to the Installation Type selected. e.g. ODSI Developer Installation, ODSI Runtime Installation.
INSTALL_TYPE=ODSI Runtime Installation

3.3 Next Steps

See Section 4.1, "Verifying the Installation" for information on how to verify that Oracle Data Service Integrator installed correctly.

You can integrate Oracle Data Service Integrator with WebLogic Server and with Oracle Eclipse. For more information, see Section 4.2, "Creating a Sample Domain in WebLogic Server" and Section 4.3, "Post-Installation Tasks for Oracle Eclipse."

4 Post-Installation Tasks

This chapter describes tasks you can perform after installing an instance of Oracle Data Service Integrator, including verifying the installation, starting development of applications, and exploring Windows shortcuts and UNIX paths.

The chapter includes the following sections:

- Section 4.1, "Verifying the Installation"

- Section 4.2, "Creating a Sample Domain in WebLogic Server"

- Section 4.3, "Post-Installation Tasks for Oracle Eclipse"

- Section 4.4, "Starting the Development of a Data Integration Solution"

4.1 Verifying the Installation

After you complete the installation, you can verify it by successfully completing the following tasks:

- Reviewing Installation Log Files

- Checking the Directory Structure

4.1.1 Reviewing Installation Log Files

Review the contents of the installation log files to make sure that no problems were encountered. The installation and configuration log files can contain useful information to help troubleshoot any issues you may encounter. For more information about these log files and their contents, see "Configuring Installation and Configuration Log Files" in Installing Software with the Oracle Universal Installer.

4.1.2 Checking the Directory Structure

The contents of your Oracle Data Service Integrator installation vary based on the options you selected during the installation.

For more information about the directory structure you should see after installation, see "What are the Key Oracle Fusion Middleware Directories?" in Understanding Oracle Fusion Middleware.

4.2 Creating a Sample Domain in WebLogic Server

This section describes the two modes in which you can configure Oracle Data Service Integrator to work with a sample WebLogic Server domain. It also describes how to start the WebLogic Servers.

- Create a Sample Domain in Compact Mode—In this configuration, the sample domain contains only an administration server.

- Create a Sample Domain in Expanded Mode—In this configuration, the sample domain contains an administration server and a managed server.

Note:

- Managed Servers should always be assigned to the server-group ODSI-MGD-SVRS to get the Oracle Data Service Integrator specific domain configurations.

- For a detailed description of WebLogic Server domains and the domain configuration script, see Creating WebLogic Domains Using the Configuration Wizard. For more information on starting WebLogic Servers, see "Starting and Stopping Servers" in Administering Server Startup and Shutdown for Oracle WebLogic Server.

4.2.1 Create a Sample Domain in Compact Mode

In Compact Mode, the sample domain contains only an administration server. In this case, you can use the WebLogic Server Quickstart domain configuration scripts. The Quickstart scripts can be found under $ODSI_HOME/common/bin. Run the create_sample_domain.sh script for the Linux or UNIX platform; create_sample_domain.cmd for Windows platforms.

The create_sample_domain script invokes the Configuration wizard. In the wizard, specify the domain location, the port, and the WebLogic Server user name and password. The create_sample_domain script will also inherit the samples domain template and create a pre-configured samples domain in the location you specify.

To create an Oracle Data Service Integrator sample domain using the Quickstart configuration scripts, follow these steps:

1. Ensure that you have set the Middleware home (MW_HOME) environment variable.

2. Navigate to the odsi/common/bin folder, for example:

cd $MW_HOME/odsi/common/bin

3. Run the create_sample_doman script, for example:
./create_sample_domain.sh (Linux or UNIX) or,

create_sample_domain.cmd (Windows)

This script launches the Weblogic Server Domain Configuration Wizard. For a detailed description of WebLogic Server domains and the domain configuration script, see Creating WebLogic Domains Using the Configuration Wizard.

4. Once you have completed the wizard and created the domain, start the domain by invoking the startWebLogic script under <DOMAIN_HOME>/bin.

5. Deploy the sample dataspace to the newly created domain.
Use the odsiconsole to import the sample dataspace, MediatorSamples.jar, from the $MW_HOME/odsi/samples/wlstscripts folder.

4.2.2 Create a Sample Domain in Expanded Mode

In Expanded Mode, the sample domain contains an administration server on port 7001 and a managed server (Oracle Data Service Integrator server) on port 15501.

These instructions require the Repository Creation Utility (RCU). RCU is a Fusion Middleware tool which creates database-based repositories. Oracle Data Service Integrator does not have a repository by itself, but it relies on some Fusion Middleware schemas for WebLogic Server and JCF when using a full domain.

1. Run the RCU utility to create a JRF schema (this is required because Oracle Data Service Integrator depends on the JRF feature set).

1. Navigate to the oracle_common/bin folder, for example:

cd $MW_HOME/oracle_common/bin

2. Run the RCU utility, for example:

./rcu

2. Run Oracle Data Service Integrator configuration wizard.

1. Navigate to the WebLogic Server wlserver/common/bin folder, for example:

cd $MW_HOME/wlserver/common/bin

2. Run the WebLogic Server Configuration Wizard, for example:

./config.sh

3. Select Oracle Data Service Integrator base template from the list of available domain templates.

4. For RCU, provide the RCU schema details created in Step 1.

5. Accept the provided defaults for the Administration Server, Managed Server, Node Manager, and so on.

Start the WebLogic Servers

Once you have created the Oracle Data Service Integrator domain, follow these steps to start the Administration and Managed servers.

To Start the Administration Server:

1. Navigate to the $DOMAIN_HOME/bin folder, for example:

cd $DOMAIN_HOME/bin

2. Run the startWeblogic script to start the WebLogic Server Administration Server, for example:

- ./startWeblogic.cmd (Windows)

- ./startWeblogic.sh (Linux, UNIX)

The Administration Server starts in foreground mode with the default port 7001 (http://hostname:7001/console).

3. Open another web browser and connect to the Oracle Data Service Integrator Console by using the URL http://hostname:7001/odsiconsole.

To Start a Managed Server:

Note:

If the WebLogic Server domain is created in Expanded Mode, then a managed server is required. Otherwise, this is optional.

1. Navigate to the $DOMAIN_HOME/bin folder, for example:

cd $DOMAIN_HOME/bin

2. Run the startManagedWebLogic script to start the managed Oracle Data Service Integrator server, for example:

- ./startManagedWebLogic.sh ODSI_server1 (Windows)

- ./startManagedWebLogic.sh ODSI_server1 (Linux, UNIX)

In this example, ODSI_server1 is the name given to the managed Oracle Data Service Integrator server. The managed server starts in foreground mode with the default port 15501 (http://hostname:15501/ODSI_server1) with the associated administration server port 7001 (http://hostname:7001/console).

After startup, no dataspaces are deployed on the Oracle Data Service Integrator server. However, you can deploy dataspaces on the administration and managed servers. For example, for dataspaces deployed on managed servers that are Web Service enabled, you can access the endpoints from the managed server port.

4.3 Post-Installation Tasks for Oracle Eclipse

If you have installed the Developer version of Oracle Data Service Integrator, then you can integrate it as a plugin with Eclipse. To integrate with Eclipse, Oracle Data Service Integrator provides a script in the $MW_HOME/odsi/bin/directory to guide you through the integration process. The file is named:

- odsiconfig.cmd (Windows)

- odsiconfig.sh (Linux and UNIX)

1. Open a command prompt and run the odsiconfig executable for your platform.
The command starts a wizard to guide you through the integration process.

2. If the system detects that you do not have an Oracle inventory file, then the Installation Inventory Setup screen will appear. If your system detects that you do have an inventory file, then this screen will not appear and you can skip this step.
Enter (or browse for) the location of the directory where Oracle inventory files will be stored in the Inventory Directory field. Also, enter the name of the group that will have write permission to the inventory directory in the Operating System Group field. Click OK to start the Oracle Data Service Integrator Configuration Wizard.

Figure 4-1 Installation Inventory Setup Page

3. Click Next in the Oracle Data Service Integrator Configuration wizard Welcome page.

Figure 4-2 Welcome Page

4. Browse for the location of the Oracle Data Service Integrator Eclipse home in the Specify Eclipse Home page. Click Next.

Figure 4-3 Specify Eclipse Home Page

5. Review the configuration in the Configuration Summary screen.
If the Eclipse plugin is configured as you want it, click Next.If you need to make changes to the configuration, click Previous to return to the appropriate screen for the settings you want to change.

6. View the progress of the Eclipse plugin installation in the Configuration Progress screen.
When the process completes, click Next.

7. Review the Eclipse plugin installation results in the Configuration Complete screen. Click Finish.

You can use the Eclipse IDE to import the MediatorSamples.jar sample dataspace into your workspace. For more information, see "Sample Static Mediator Application" in Developing Data Service Integrator Applications.

4.4 Starting the Development of a Data Integration Solution

Developing your own data integration solution consists of a design phase and an implementation phase.

- When you are ready to start setting up and configuring your own data sources, refer to Administering Data Service Integrator.

- When you are ready to start mapping source and target XML schemas and constructing queries using WebLogic Server, refer to Data Service Integrator Developer's Guide.

- When your application developer is ready to access data services, see Developing Data Service Integrator Applications.

- For information on the XQuery engine, functions and the XQSE language see Using Data Service Integrator XQuery Engine.

5 Deinstalling Oracle Data Service Integrator

For most platforms you can automatically remove system-installed, unmodified Oracle Data Service Integrator artifacts from your system. After Oracle Data Service Integrator has been uninstalled, you can manually remove any extra files, such as modified samples or other user-created files, which were not removed automatically by the deinstaller.

You should undeploy any Oracle Data Service Integrator applications before deinstalling Oracle Data Service Integrator from your system. For information about undeploying, see "Undeploying an Application or Module" in Deploying Applications to Oracle WebLogic Server.

To deinstall Oracle Data Service Integrator using Oracle Universal Installer:

1. Back up any data you want to retain for use with a new installation.

2. Shut down your server.

3. Run the deinstaller.

- On Windows systems, choose the Uninstall Oracle Middleware option on the Windows Start Menu. The Uninstall Oracle Middleware option can be found on a path similar to the following:
Start > All Programs > Oracle > OracleHome > Uninstall Oracle Middleware

- You can also start the deinstallation process from the command line. Navigate to the <ORACLE_HOME>/oui/bin folder. Execute the deinstall.cmd command for Windows platforms or the deinstall.sh command for Linux or UNIX platforms.

The Distribution to Uninstall screen appears.

4. In the Distribution to Uninstall screen, ensure that Oracle Data Service Integrator appears in the Select Distribution to Uninstall field. If it does not, select it from the drop-down list.
Figure 5-1 illustrates the Distribution to Uninstall screen. The screen displays the Oracle Data Service Integrator components that will be uninstalled. Click Uninstall.

Figure 5-1 Oracle Data Service Integrator Uninstall Screen

5. The Oracle Universal Installer Deinstallation wizard opens and displays the Welcome screen.
Figure 5-2 illustrates the Welcome screen. Click Next.

Figure 5-2 Deinstallation Wizard Welcome Screen

6. The Deinstallation Summary screen displays the components that will be deinstalled and their location in the filesystem.
Figure 5-3 illustrates the Deinstallation Summary screen. Click Save Response File to save a record of the deinstallation process. Click Deinstall to start deinstallation.

Figure 5-3 Deinstallation Wizard Deinstallation Summary Screen

7. The Deinstallation Progress screen displays the progress of the deinstallation process.
Figure 5-4 illustrates the Deinstallation Progress screen. Click View Messages to display the detailed messages that are sent during deinstallation. Click View Log to display the deinstallation log. Click Next to proceed.

Figure 5-4 Deinstallation Wizard Deinstallation Progress Screen

8. The Deinstallation Complete screen displays the Oracle Data Service Integrator components that have been removed.
Figure 5-5 illustrates the Deinstallation Complete screen. Click Finish to dismiss the Deinstallation Wizard.

Figure 5-5 Deinstallation Wizard Deinstallation Complete Screen

6 Upgrading Oracle Data Service Integrator 10gR3 Dataspaces to 12.1.3

This chapter describes the steps to upgrade Oracle Data Service Integrator runtime and development environments from 10gR3 dataspaces to 12.1.3 dataspaces.

This chapter has the following sections:

- Section 6.1, "Upgrading the Runtime Environment from 10gR3 Dataspaces to 12.1.3"

- Section 6.2, "Upgrading the Development Environment from 10gR3 Dataspaces to 12.1.3"

6.1 Upgrading the Runtime Environment from 10gR3 Dataspaces to 12.1.3

Follow these steps to migrate the runtime (deployment) environment from 10.3 dataspaces to 12.1.3 dataspaces:

1. Use the Oracle Data Service Integrator Dataspace Export in the Oracle Data Service Integrator 10gR3 domain to export the entire dataspace to a JAR archive. Repeat this step for each dataspace.

1. In the Oracle Data Service Integrator Administration Console, click the System Administration Category and the dataspace that you want to export as a JAR.

2. Click the Export tab. In the Export tab, ensure that you select the Include configuration with artifacts checkbox.
For more information, see "Exporting Dataspace Artifacts" in Administering Data Service Integrator.

Notes:

- Before exporting the data sources, you must ensure that the underlying drivers are supported in 12.1.3 WebLogic Server. If they are not supported, then you must align them manually.

- The list of datasources that must be migrated for a given dataspace are obtained from the .sources file in the exported Oracle Data Service Integrator JAR archive.

2. Shutdown the Oracle Data Service Integrator 10gR3 domain.

3. Install Oracle Data Service Integrator 12.1.3 in a new Oracle Middleware Home.
For more information, see Chapter 2, "Installing Oracle Data Service Integrator Using Oracle Universal Installer" and Chapter 3, "Installing Oracle Data Service Integrator Using Silent Mode."

4. Create a new Oracle Data Service Integrator domain in 12.1.3. Recreate the 10gR3 topology in the 12c domain.
For more information, see Section 4.2, "Creating a Sample Domain in WebLogic Server."

5. Use the WebLogic Server Console or WLST to recreate all of the JNDI data sources that you used in your 10gR3 configuration in your 12c configuration.
** (You can also refer on how to export/import data source from a WLS guide)?

6. Import the 10gR3 dataspace into the new 12c domain.
For more information, see "Importing Dataspace Artifacts" in Administering Data Service Integrator.

7. Start the Oracle Data Service Integrator 12c domain.
For more information, see "Starting and Stopping WebLogic Server" and "Launching Oracle Data Service Integrator Administration Console" in Administering Data Service Integrator.

6.2 Upgrading the Development Environment from 10gR3 Dataspaces to 12.1.3

Follow these steps to migrate the development environment from 10.3 dataspaces to 12.1.3 dataspaces:

1. In the 10gR3 Eclipse environment, use the export tools in the Eclipse IDE to export the Oracle Data Service Integrator dataspace project.
For more information, see "Exporting Dataspace Projects or Project Folders" and "Generating a Data Service Definitions and Artifacts JAR" in Oracle Fusion Middleware Data Service Integrator Developer's Guide.

2. Download and install the 12.1.3 version of Oracle Enterprise Pack for Eclipse (OEPE).

3. Install 12.1.3 Oracle Data Service Integrator. Install the Developer version of the product. See Chapter 2, "Installing Oracle Data Service Integrator Using Oracle Universal Installer" and Chapter 3, "Installing Oracle Data Service Integrator Using Silent Mode".

4. Complete the post-installation tasks to integrate Oracle Data Service Integrator with Eclipse. For more information, see Section 4.3, "Post-Installation Tasks for Oracle Eclipse."

5. In the 12.1.3 Eclipse environment, use the import tools to import the Oracle Data Service Integrator dataspace project. See "Importing a Dataspace Project" in Oracle Fusion Middleware Data Service Integrator Developer's Guide.

A Understanding the Oracle Data Service Integrator Distribution

This appendix describes the components that are installed with the Oracle Data Service Integrator distribution. You can install the Developer version of the product or the Runtime version.

The following components are available:

- Oracle Data Service Integrator Runtime component is available if you install either the Developer or the Runtime version of Oracle Data Service Integrator. This component is a prerequisite for installing other components.

- Oracle Eclipse Plugins component is available only if you install the Developer version of Oracle Data Service Integrator. It is not available if you install the Runtime version.

- Oracle Data Service Integrator Samples component is available if you install either the Developer or the Runtime version of Oracle Data Service Integrator.

Table A-1 describes the contents of each component.

Table A-1 Oracle Data Service Integrator Installation Components

Component Name

Sub-components

Oracle Data Service Integrator Runtime

- Oracle Data Service Integrator runtime including the XQuery engine

- Oracle Data Service Integrator Administration Console

- Oracle Data Service Integrator base domain template

- OSB Common Components

Note: Oracle WebLogic Server 12c (12.1.3) with JRF (or JRF and JDBC) is a prerequisite for Oracle Data Service Integrator runtime.

Oracle Eclipse Plugins

Oracle Data Service Integrator Main Plug-in

Plugins:

- ODSI Applications plugin

- ODSI Common plugin

- ODSI Common Core plugin

- ODSI Common UI Palette COmponent

- ODSI Compiler Services plugin

- ODSI Eclipse IDE help

- ODSI External Libraries plugin

- ODSI Import Metadata plugin

- ODSI Main plugin

- ODSI Model plugin

- ODSI Refactor plugin

- ODSI Samples

- ODSI Serviceview Design Views

- ODSI Views Plugin

Oracle Data Service Integrator Samples

- ODSI sample domain template

- Sample Domain Creation scripts

- Sample Derby Datasource Pre-Configured Dump

- Sample Scripts for creating Derby Datasource

- Retail Dataspace Sample Application

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2014, Oracle and/or its affiliates. All rights reserved.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

License Restrictions Warranty/Consequential Damages Disclaimer

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.

Warranty Disclaimer

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.

Restricted Rights Notice

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 END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

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.

Third-Party Content, Products, and Services Disclaimer

This software or hardware 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.

Alpha and Beta Draft Documentation Notice

If this document is in preproduction status:

This documentation is in preproduction status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.