Professional Documents
Culture Documents
July 2014
Documentation for product installers and system
administrators that describes how to install and configure
Oracle Service Bus.
Oracle Fusion Middleware Installing and Configuring Oracle Service Bus, 12c (12.1.3)
E48383-02
Copyright 2014, Oracle and/or its affiliates. All rights reserved.
Primary Author: Wortimla RS
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 America, 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 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.
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.
Contents
Installing and Configuring Oracle Service Bus i
Preface ................................................................................................................................................................. v
Audience.......................................................................................................................................................
Documentation Accessibility .....................................................................................................................
Related Documents .....................................................................................................................................
Conventions .................................................................................................................................................
v
v
v
v
iii
3.2
3.2.1
3.2.2
3.3
3.3.1
3.3.2
3.3.3
3.4
iv
Understanding the Oracle Service Bus and Oracle Enterprise Scheduler Topology ........A-1
Roadmap for Installing and Configuring the Oracle Service Bus and Oracle Enterprise
Scheduler Topology .........................................................................................................A-2
Configuration Options to Select for the Oracle Service Bus and Oracle Enterprise
Scheduler ..................................................................................................................A-3
Preface
This document describes how to install and configure Oracle Service Bus.
Audience
This document is intended for system administrators or application developers who
are installing Oracle Service Bus. It is assumed that readers are familiar with Web
technologies and have a general understanding of Windows and UNIX platforms.
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 12c (12.1.3) documentation
set:
Installing and Configuring Oracle SOA Suite Foundation and Business Process
Management
Conventions
The following text conventions are used in this document:
vi
Convention
Meaning
boldface
italic
monospace
1
Planning Your Oracle Service Bus
Installation
This chapter helps to prepare you for your Oracle Service Bus installation and domain
configuration.
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 contains the following sections:
Section 1.3, "Roadmap for Installing and Configuring the Standard Installation
Topology"
APPHOST
DBHOST
WebLogic Domain
Administration Server
Enterprise Manager
Cluster
Table 11 (Cont.) Description of the Elements in the Oracle Service Bus Standard
Installation Topologies
Element
Machine
Managed Server
Infrastructure
Task
Description
Documentation
Description
Documentation
See Chapter 2.
See Chapter 3 if
you are creating
the topology for
Oracle Service Bus.
See Chapter 4.
Task
Description
Documentation
Verify that your operating system is certified See "Verifying Certification and
and properly configured for installation and System Requirements" in Planning an
configuration.
Installation of Oracle Fusion
Middleware.
Identify a proper
installation user
Installation Checklist
Information
Example Value
Description
JAVA_HOME
/home/Oracle/jdk7_55/jdk1.7.0_55
Database hostname
examplehost.exampledomain
Database port
1521
orcl
DBA username
SYS
DBA password
ExamplePassword1
ORACLE_HOME
/home/Oracle/product/Oracle_Home
WebLogic Server
hostname
examplehost.exampledomain.com
Console port
7001
DOMAIN_HOME
/home/Oracle/config/domains/osb_
domain
APPLICATION_HOME
/home/Oracle/config/applications/o
sb_domain
Administrator user
name for your
WebLogic domain
weblogic
Administrator user
password
ExamplePassword1
$FTP_ROOT
${ORACLE_HOME}/osb/ftp_root
FTP Port
7021
RCU utility
ORACLE_HOME/oracle_common/bin
osb
RCU schema
password
ExamplePassword1
Config utility
ORACLE_HOME/oracle_
common/common/bin
2
Installing the Oracle Service Bus Software
This chapter describes how to install the Oracle Service Bus software.
Before you begin the installation process, ensure that you have already verified your
system environment (Section 1.4), and have installed Oracle Fusion Middleware
Infrastructure (Installing and Configuring the Oracle Fusion Middleware Infrastructure) in
an Oracle home.
By the end of this chapter, you would have installed the Oracle Service Bus software in
an Oracle home.
This chapter contains the following sections:
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.3) on the
Oracle Fusion Middleware Supported System Configurations page.
3.
4.
Launch the installation program by invoking the java executable from the JDK
directory on your system, as shown in the examples below.
On UNIX operating systems:
/home/Oracle/jdk7_55/jdk1.7.0_55/bin/java -jar fmw_12.1.3.0.0_osb.jar
Ensure that you replace the JDK location in these examples with the actual JDK
location on your system.
You can also launch the installer in silent mode to ensure that
no configuration options are displayed during the installation process.
For more information about silent or command line installation, see
"Using the Oracle Universal Installer in Silent Mode" in Installing
Software with the Oracle Universal Installer.
Note:
When the installation program appears, you are ready to begin the installation. See
Section 2.2 for a description of each installation program screen.
Screen
Description
Installation Inventory Setup On UNIX operating systems, 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 Central Inventory" in Installing
Software with the Oracle Universal Installer.
This screen will not appear on Windows operating systems.
Welcome
Installation Location
Installation Type
Description
Prerequisite Checks
necessary requirements.
If you want to stop the prerequisite checks at any point before it
completes, click Stop.
If you want to run the checks again after you have selected Stop,
click Rerun.
If you want to skip the prerequisite checks and move to the next
screen, click Skip. However, regardless of whether you skip the
checks or not, if your system does not meet the minimum
requirements, you will not be able to install the software; an
error message is displayed on the Installation Progress screen.
If you want to view the list of tasks that gets verified, select
View Successful Tasks. If you want to view the log details,
select View Log.
If there are any warning or error messages, you can refer to one
of the documents in Section 1.4.
Installation Summary
Installation Progress
Installation Complete
For a description of the log files and where to find them, see "Understanding
Installation Log Files" in Installing Software with the Oracle Universal Installer.
3
Configuring Your Oracle Service Bus Domain
This chapter describes how to create and configure your Oracle Service Bus domain.
Before you begin the configuration process, ensure that you have completed installing
the Oracle Service Bus software in the same Oracle home as Oracle Fusion Middleware
Infrastructure. For more information, see Chapter 2.
By the end of this chapter, you would have created database schemas for Oracle
Service Bus and configured an Oracle WebLogic domain with one cluster and two
managed servers on a single host.
This chapter contains the following sections:
2.
Make sure that the JAVA_HOME environment variable is set to the location of a
certified JDK on your system. The location should be up to but not including the
bin directory. For example, if your JDK is located in in /home/Oracle/JDK/jdk7_
55/jdk1.7.0_55:
On UNIX operating systems:
setenv JAVA_HOME /home/Oracle/JDK/jdk7_55/jdk1.7.0_55
Start RCU:
On UNIX operating systems:
./rcu
Database Type
Host Name
Port
Service Name
Username
Password
Role
Click Next to proceed, then click OK on the dialog window confirming that
connection to the database was successful.
Task 4 Specifying a Custom Prefix and Selecting Schemas
Select Create new prefix, specify a custom prefix, then select the SOA Suite schema.
This will automatically select SOA Infrastructure, along with the following schemas as
dependencies:
Metadata Services
Audit Services
WebLogic Services
Tip: 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.
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.
Tip: 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: For more information about the options on this screen, see
"Custom Variables" in Creating Schemas with the Repository Creation
Utility.
creation, see "Additional Tools for Creating, Extending, and Managing WebLogic
Domains" in Creating WebLogic Domains Using the Configuration Wizard.
Creating and configuring your domain includes the following:
Section 3.2.2, "Navigating the Configuration Wizard Screens to Create the Domain"
Note:
Tip: For more information about the options on this screen, see
"Templates" in Creating WebLogic Domains Using the Configuration
Wizard.
Field
Description
DBMS/Service
Host Name
Port
Schema Owner
Schema Password
Click Get RCU Configuration when you finish specifying the database connection
information. 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: For more information about the RCU Data option, see
"Understanding the Service Table Schema" in Creating Schemas with the
Repository Creation Utility.
For more information about the options on this screen, see "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.
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.
By default, the schema password for each schema component is the password you
have specified while creating your schemas. If you want different passwords for
different schema components, manually edit them by entering the desired password in
the Schema Password column, against each row. After specifying the passwords,
select the check box corresponding to the schemas that you have changed the
password in and test the connection again.
Tip: For more information about the options on this screen, see "Test
Component Schema" in Creating WebLogic Domains Using the
Configuration Wizard.
Administration Server
This is required to properly configure the listen address of the Administration
Server.
Node Manager
This is required to configure Node Manager.
Select Per Domain Default Location as the Node Manager type, then specify the Node
Manager credentials.
Tip: For more information about the options on this screen, see
"Node Manager" in Creating WebLogic Domains Using the Configuration
Wizard.
For more information about the types of Node Manager, see "Node
Manager Overview" in Administering Node Manager for Oracle WebLogic
Server.
Task 12 Configuring Managed Servers
On the Managed Servers screen, a new Managed Server named osb_server1 is
created:
1.
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. Verify that
OSB-MGD-SVRS-COMBINED is selected in the Server Group.
If you want to have OWSMPM in a different server from the OSB server, select
OSB-MGD-SVRS-ONLY. This targets only OSB but not OWSMPM to the server.
2.
Click Add and repeat this process to create a second Managed Server named osb_
server2.
Configuring a second Managed Server is one of the steps needed to configure the
standard topology for high availability. If you are not creating a highly available
environment, then this step is optional.
For more information about the high availability standard topology, see
"Understanding the Fusion Middleware Standard HA Topology" in High
Availability Guide.
For more information about the next steps to prepare for high availability after
your domain is configured, see Section 4.3.
These server names will be referenced throughout this document; if you choose
different names be sure to replace them as needed.
Tip: For more information about the options on this screen, see
"Managed Servers" in Creating WebLogic Domains Using the
Configuration Wizard.
Click Add.
2.
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, see
"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.
Tip: For more information about the options on this screen, see
"Clusters" in Creating WebLogic Domains Using the Configuration Wizard.
In the Clusters pane, select the cluster to which you want to assign the servers; in
this case, osb_cluster1.
2.
3.
Click once on osb_server1 to select it, then click on the right arrow to move it
beneath the selected cluster (osb_cluster1) in the Clusters pane.
Double-click on osb_server1 to move it beneath the selected cluster (osb_
cluster1) in the clusters pane.
Tip: For more information about the options on this screen, see
"Assign Servers to Clusters" in Creating WebLogic Domains Using the
Configuration Wizard.
Note:
See Table 42 for more information and next steps for configuring Coherence.
For Coherence licensing information, see "Oracle Coherence"
in Licensing Information.
Note:
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.
Note:
Tip: For more information about the options on this screen, see
"Machines" in Creating WebLogic Domains Using the Configuration
Wizard.
In the Machines pane, select the machine to which you want to assign the servers;
in this case, osb_machine1.
2.
3.
Click once on AdminServer to select it, then click on the right arrow to move it
beneath the selected machine (osb_machine1) in the Machines pane.
Double-click on AdminServer to move it beneath the selected machine (osb_
machine1) in the Machines pane.
Tip: For more information about the options on this screen, see
"Assign Servers to Machines" in Creating WebLogic Domains Using the
Configuration Wizard.
Task 19 Writing Down Your Domain Home and Administration Server URL
The Configuration Success screen will show the following items about the domain you
just configured:
Domain Location
You must make a note of both items as you will need them later; the domain location is
needed to access the scripts used to start the Node Manager and Administration
Server, and the URL is needed to access the Administration Server.
Click Finish to dismiss the configuration wizard.
Note:
In the preceding command, LOG_DIR is the location of directory in which you want to
store the log files.
On Windows operating systems, run:
startNodeManager.cmd
Note:
If you have selected Production Mode on the Domain Mode and JDK screen in Task 5
(Section 3.2.2), you will be prompted for the login credentials of the Administrator
user as provided on the Administrator Account screen in Task 4.
Tip: For more information about starting the Administration Server,
see "Starting and Stopping Administration Servers" in Administering
Oracle Fusion Middleware.
Note:
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.
The Administration Server host and port number were in the URL on the
Configuration Success screen (Task 19). The default Administration Server port
number is 7001.
The login credentials were provided on the Administrator Account screen (Task 4).
2.
From the "Target Navigation" pane, click the arrows to expand the domain until
the Managed Servers (osb_server1 and osb_server2) are visible.
3.
4.
5.
6.
In the Target Navigation page, select your domain name to see that all the servers
are up and running.
4
Next Steps After Configuring Your WebLogic
Domain
This chapter describes common tasks you might want to perform on a newly created
Oracle Service Bus domain.
The following sections are included in this chapter:
Task
Description
More Information
Learn how to keep track of the status See "Monitoring Oracle Fusion
Middleware" in Administering Oracle
of Oracle Fusion Middleware
Fusion Middleware.
components.
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.
Table 43
Task
Description
More Information
5
Deinstalling Oracle Service Bus
Task
Description
Documentation
Remove your
database schemas
5-1
Description
Remove the software Run the product deinstaller to remove Oracle Service Bus.
Documentation
See Section 5.4.
Note that if your Oracle home contains multiple products, you will
need to run the deinstaller multiple times; once for each product.
Remove the Oracle
home directory
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.
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.
On Unix
To start the deinstaller on a UNIX operating system, go to the ORACLE_
HOME/oui/bin directory and enter the following command:
./deinstall.sh
On Windows
Do one of the following:
From the Start menu, select All Programs, then select Oracle, then select
OracleHome, and then select Uninstall Oracle Middleware.
Note:
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.
If you want to save these options to a response file, click Save
Response File and provide the location and name of the
response file. Response files can be used later in a silent
deinstallation situation.For more information about silent or
command line deinstallation, see "Running the Oracle Universal
Installer for Silent Deinstallation" in Installing Software with the
Oracle Universal Installer.
Click Deinstall to begin removing the software.
Deinstallation Progress
Deinstallation Complete
5-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 osb_domain, find the following line and remove it:
<domain location="/home/Oracle/config/domains/osb_domain"/>
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.
5-5
A
Secondary Topology for Oracle Service Bus
Section A.1, "Understanding the Oracle Service Bus and Oracle Enterprise
Scheduler Topology"
Section A.2, "Roadmap for Installing and Configuring the Oracle Service Bus and
Oracle Enterprise Scheduler Topology"
Roadmap for Installing and Configuring the Oracle Service Bus and Oracle Enterprise Scheduler Topology
Managed Server
(osb_server1)
Infrastructure
Infrastructure
OSB
OSB
ESS
ESS
DBHOST
A.2 Roadmap for Installing and Configuring the Oracle Service Bus and
Oracle Enterprise Scheduler Topology
Table A1 describes the roadmap needed to configure this topology on your system.
Roadmap for Installing and Configuring the Oracle Service Bus and Oracle Enterprise Scheduler Topology
Table A1
Installation and Configuration Steps for Oracle Service Bus and Oracle Enterprise Scheduler
Task
Description
More Information
Special
Instructions
None.
Determine your
installation directories
None.
None.
See Chapter 2.
None.
See Chapter 3.
Follow the
instructions
provided for specific
screens in
Section A.2.1.
None.
Next steps after installing You can perform administrative as well as See Chapter 4.
and configuring Oracle
management tasks for the domain that
Service Bus and Enterprise you have just configured.
Schedule Services
None.
A.2.1 Configuration Options to Select for the Oracle Service Bus and Oracle Enterprise
Scheduler
Almost all of the screens and options that you must select while configuring Oracle
Service Bus and Enterprise Schedule Services are identical to the ones provided in
Roadmap for Installing and Configuring the Oracle Service Bus and Oracle Enterprise Scheduler Topology
Chapter 3. However, there are a couple of screens on which you must select different
options and Table A2 lists the key screens and options. Ensure that you select the
configuration options as provided on this table.
Table A2 Key Screens and Configuration Options for Oracle Service Bus and
Enterprise Schedule Services Topology
Screen
Description
Select Components
Templates
Managed Servers