3

Installing Oracle Service Bus 11g

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Objectives
After completing this lesson, you should be able to:
Identify Oracle Service Bus (OSB) 11g installation
requirements
Install Oracle Service Bus 11g
Create database schemas by using the Repository
Creation Utility (optional feature)
Create an OSB WebLogic domain
Extend an OSB WebLogic domain (optional feature)

3-2

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Administrative Stages in Setting Up OSB

Administrative stages include:
Planning resources for the OSB
Installing the OSB software
Designing the enterprise service bus
Functional testing
Operational tuning

3-3

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Road Map

Installation
Supported configurations
Repository Creation Utility (RCU)
Installation Wizard

3-5

OSB domain

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Installing Oracle Service Bus 11g

1
Start

Using
Reporting
feature or
OWSM
Policies?

2A

Install Oracle WebLogic Server with

Oracle Enterprise Pack for Eclipse.

3
No

Create and configure a

WebLogic
domain for OSB.

Install OSB 11g.

Start the
administration server and
managed servers.

Yes
Finish

Create schemas
by using RCU.

3-6

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Preparing for Installation

Before you start installing Oracle Server Bus 11g:
Plan your installation as appropriate to business
requirement
Ensure that your platform and environment have sufficient
resources
Install Oracle WebLogic Server 10.3.3 and Oracle
Enterprise Pack for Eclipse (optional)
Install and configure a supported database with the
following schemas (optional)
User Messaging Service for reporting feature
Metadata Services for OWSM support

3-7

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Supported Platforms

OSB can be installed in two ways, depending on your

platform:
Graphical user interface (GUI) mode
Console mode

OSB supports a number of platforms including:

Microsoft Windows XP Server 2003, XP (client only)
Oracle Enterprise Linux 4.6/ Oracle VM Supported (OVM),
5.0/ OVM
Red Hat Enterprise Linux 4, 5
Sun Solaris 9, 10
HP-UX 11i, 11iV2, 11iV3

3-8

Contact Oracle for additional platform support.

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Supported Software Platforms

Supported platforms:

Linux
Solaris
HP-UX
Windows XP SP2 (Win32 platforms only), Windows 2003,
Windows 2008, Windows Vista
IBM AIX 5.3, IBM AIX 6.1

Supported JDKs:
Sun JDK (32-bit and 64-bit)
JRockit

Supported browsers:
Enterprise Manager requires Firefox 3 or IE 7+

3-9

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Preparing the Installation

Before starting OSB11g installation, you should have
Installed:
Database (optional)
Oracle WebLogic Server

Created a staging area

with product software or
have access to the
installation CDs

Staged Software
Oracle
Service
Bus
11.1.1.3

stage

RCU

rcuHome
osb

Preinstalled Software

Oracle XE
home

/usr/lib/oracle/xe/app/oracle/product/10.2.0/server
/u01/app/oracle/product/fmw/11.1.1.3/wlserver_10.3

3 - 10

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

WLS
home

Checking and Configuring the Database

Supported databases include:

Oracle Database 10g (10.2.0.4 or later)
Oracle Database 11g (11.1.0.7 or later)

After starting Oracle Database, use SQL*Plus to:

Set the processes parameter to >=300
Set the sessions parameter to >= 200

Note: Restart the database for these changes to become

active before you install Oracle Service Bus11g.
SQL>
SQL>
SQL>
SQL>

3 - 11

ALTER SYSTEM SET processes=300 scope=spfile;

ALTER SYSTEM SET sessions=200 scope=spfile;
shutdown immediate
startup

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Checking WebLogic Server

WebLogic Server installation creates the Middleware home and
WebLogic Server home directory:
FMW_HOME: /u01/app/oracle/product/fmw/11.1.1.3)
Oracle Middleware home

jdk160_18
jrockit_160_17_R28.x.x
modules
wlserver_10.3
user_projects

3 - 12

WebLogic Server
home
The WebLogic Server domains are
created in a user_projects subfolder,
when you configure the domain.

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Repository Creation Utility (RCU): Overview

The RCU:
Is used to create and manage Oracle FMW database
schemas in your database
Provides a graphical interface and a command-line
interface (CLI), which can be launched:
Locally from the CD or disk
Remotely

Supports creating:
Custom schemas and tablespaces

In a single database instance

Across multiple databases in a distributed fashion

Multiple component schemas identified by custom prefixes

3 - 13

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

RCU Requirements

Supported platforms: Linux and Windows

Supported databases
Component

Supported Databases

SOA Infrastructure

Oracle, Microsoft SQL Server, IBM DB2

User Messaging Service

Oracle, Microsoft SQL Server, IBM DB2

Required privileges: To create schemas on an Oracle

database, you must have one of the following SYSDBA
privileges:
SYS user with SYSDBA role
A database user who has been granted the SYSDBA role

3 - 15

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Creating Schemas with RCU

To start RCU, execute the following commands in a terminal
window :
$ cd /home/oracle/stage/rcuHome/bin
$ ./rcu.sh

When the RCU application starts, do the following to create

schemas:
1. Provide database connection details.
2. Specify a schema prefix and select the components for
which you want to create schemas in the database.
3. Specify the passwords for your schema owners.
4. Configure the desired tablespace mapping for the
schemas you want to create.
3 - 16

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Specifying a Schema Prefix

and Selecting Components

3 - 17

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Specifying the Passwords for Schema Owners

3 - 18

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Mapping Tablespaces

Click the default tablespace to

see the drop-down list of
additional tablespace names.

3 - 19

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Installing Oracle Service Bus 11g 11.1.1.3

To start the installer, run the appropriate command:
UNIX:
$ cd osb_installer_folder
./runInstaller jreLoc JRE_LOCATION

Windows:

cd osb_installer_folder
setup.exe jreLoc JRE_LOCATION

Course example:

$ cd /home/oracle/stage/osb/Disk1
$ ./runInstaller jreLoc $JAVA_HOME

Where JAVA_HOME=/u01/app/oracle/product/fmw/
11.1.1.3/jrockit_160_17_R28.0.0679
3 - 20

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Components to Install

Development
Environment

Production
Environment

3 - 21

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Specifying Installation Location

Development
Environment

Production
Environment
3 - 22

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Post-Installation Directory Structure

The Middleware home directory after the Oracle Service Bus
installation:
FMW_home

modules
logs
Oracle_common
Oracle_OSB1

Oracle Common home

OSB Oracle home

oepe_11gR1PS2
wlserver_10.3

OSB IDE home

(Eclipse home)

registry.dat/registry.xml

3 - 23

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Installation Log Files

The installer writes log files to the directory:

Oracle_Inventory_Location/log (UNIX)
Oracle_Inventory_Location\logs (Windows)

The install log files include:

Installdate-time_stamp.log: The main log file
Installdate-time_stamp.out: Contains the output and error
streams during the installation
installActionsdate-time_stamp.log: Contains internal information
installProfiledate-time_stamp.log: Contains the overall
statistics as well as configuration, memory, and CPU details
oraInstalldate-time_stamp.log: Contains the output stream
of the copy session

3 - 24

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Quiz
Which of the following statements are true? (Select all that
apply.)
a. RCU provides a flexible way to create custom schemas
and tablespaces in a database.
b. WebLogic Server installation creates only the WebLogic
Server home directory.
c. Installing and configuring a supported database with
Oracle Service Bus is optional.
d. Oracle Enterprise Pack for Eclipse is a mandatory
component while installing Oracle Server Bus 11g.

3 - 25

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Road Map

Installation
OSB domain
Overview of OSB domain
Domain templates
Creating a domain

3 - 26

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Review: Configuring a Domain

Use the Configuration Wizard to create a domain that acts

as a service bus.
When you create a domain, you define a collection of
resources, such as:

3 - 27

Managed servers and clusters

Start/stop scripts
Database connections
Security realm
Shared application libraries
Java EE applications
Database schemas

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Domain Topology: OSB Single Admin Server

OSB support a single domain topology with an administration
server and OSB server executing within a single JVM
WLS Console

Domain

Admin Server

OSB Console

OSB Libraries
OSB Applications
OSB JMS Module

Service
Producers and
Consumers

3 - 29

OSB Data Source

OSB Security Realm

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

OSB Database

Domain Topology: OSB Single Managed Server

OSB supports a single domain topology with an administration
server and a single OSB managed server
WLS Console

Domain
Admin Server
OSB Server
(Managed Server)

OSB Console

OSB Libraries
OSB Applications

Service
Producers and
Consumers

OSB JMS Module

OSB Data Source

OSB Database

OSB Security Realm

3 - 30

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Domain Topology: OSB Single Cluster

OSB supports a single domain topology with an administration
server and a single OSB cluster.
WLS Console

Domain
Admin Server

OSB Console

Service
Producers and
Consumers

3 - 31

OSB Managed
Server
OSB Managed
Server

OSB Database

OSB Cluster

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Domain Topology: OSB Multiple Clusters,

Managed Servers
OSB does not support a single domain with multiple service
bus managed servers or multiple clusters.
Domain
OSB Managed Server

WLS Console
Admin Server

OSB Cluster 1

OSB Console

Service
Producers and
Consumers

3 - 32

OSB Managed Server

OSB Managed Server

OSB Managed Server

OSB Managed Server

OSB Managed Server

OSB Cluster 2

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Domain Topology: OSB Coexistence

All OSB topologies can coexist with any other clusters or

managed servers.
For production, having SOA and OSB in separate clusters is
recommended.
Domain

Admin Server

OSB Managed Server

OSB Managed Server
OSB Cluster

Other Managed Server

Other Managed Server

SOA Managed Server

SOA Managed Server
SOA Cluster

3 - 33

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Review: Domain Templates

A domain template (.jar) defines the full set of resources

within a domain.
Template extensions are used to add resources to, or
modify resources in, an existing domain.
You can create custom domain templates from an existing
domain using:
Domain Template Builder
WLS pack/unpack utilities

3 - 34

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Creating a Domain
To start the FMW Configuration Wizard on UNIX, run one of the
following commands:
Graphical mode
Middleware_Home/oracle_common/common/bin/
config.sh
Console mode
Middleware_Home/oracle_common/common/bin/
config.sh mode=console
Example
$cd /u01/app/oracle/product/fmw/11.1.1.3/oracle_common/
common/bin
$./config.sh

3 - 36

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Selecting the Domain Source

3 - 37

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Customizing Advanced Configuration

3 - 39

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Configuring the Managed Servers

3 - 40

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Creating Machines

3 - 41

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Assigning Servers to Machines

3 - 42

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Extending a Domain

Extend a domain if you:

Already have an existing WebLogic domain, and you want it
to support OSB functions
Choose not to configure all of the components in OSB while
creating your domain, but you want to add these
components at a later date by extending your domain

The Configuration Wizard uses extension templates to

extend an existing WebLogic domain.

3 - 43

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Using WLST to Create or Update an OSB Domain

create_osb_domain.py:

Start with base WLS or a

custom template.

readTemplate('wls.jar')
setOption('JAVA_HOME','${FMW_HOME}/jdk160_05')
setOption('ServerStartMode','prod')
cd('Security/mydomain/User/weblogic')
cmo.setPassword('weblogic')
writeDomain('${FMW_HOME}/user_projects/domains/mydomains')
closeTemplate()
readDomain('${FMW_HOME}/user_projects/domains/ mydomains')
addTemplate('wls_webservice.jar')
Add template extensions to
addTemplate('wlsb.jar')
the new domain.
updateDomain()
closeDomain()
exit()

3 - 44

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Post-Configuration Directory Structure

The Middleware home directory after domain creation:
FMW_home

du
mo

s
le

n
mo
1
m
SB
o
O
c
_
_
le
le
c
c
a
a
Or
Or

Oracle Common home

wl

rv
se

er

OSB Oracle home

3
0.
1
_

s
il
t
u

s
ct
e
oj
pr
_
er
us

s
in
a
m
do

ame
n
_
ain
m
o
d

3 - 45

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

ap

s
on
i
t
ca
i
pl

me
a
n
in_
a
m
do

OSB Domain Directory Structure

user_projects

Directory

3 - 46

domains

domain_name

Description

autodeploy

Autodeployment of applications in development mode

bin

Server start/stop scripts

config

Domain configuration repository, including config.xml

lib

JAR files automatically added to server classpath

rmfilestore

Default persistent file store for OSB JMS server

security

Domain-wide LDAP and other security files

servers/myserver

Folder for each server in the domain

servers/myserver
/logs

Server log files

WseeFileStore

Default persistent file store for WLS reliable web

services

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Starting Servers
To start the administration server and various managed servers,
navigate to the domain bin folder as in this example :
$ cd $FMW_HOME/user_projects/domains/domain_name/bin

To start the administration server, run:

startWebLogic.sh (UNIX)
startWebLogic.cmd (Windows)

To start managed servers, run:

startManagedWebLogic.sh server_name (UNIX)

startManagedWebLogic.cmd server_name (Windows)
$ cd/u01/app/oracle/product/fmw/11.1.1.3/user_projects
/domains/osb_domain/bin
$ ./startWebLogic.sh
$ ./startManagedWebLogic.sh osb_server1

3 - 48

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Quiz
The _________ directory stores the domain configuration
repository, including the config.xml file.
a. DOMAIN_HOME/lib
b. DOMAIN_HOME/config
c. DOMAIN_HOME/security
d. DOMAIN_HOME/autodeploy

3 - 49

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Summary
In this lesson, you should have learned how to:
Identify Oracle Service Bus (OSB) 11g installation
requirements
Install Oracle Service Bus 11g
Create database schemas by using the Repository
Creation Utility (optional feature)
Create an OSB WebLogic domain
Extend an OSB WebLogic domain (optional feature)

3 - 50

Copyright 2011, Oracle and/or its affiliates. All rights reserved.

Practice Overview:
Install Oracle Service Bus 11g
This practice covers the following topics:
Installing the required OSB database schemas by using
the RCU utility
Installing Oracle Service Bus 11g software
Configuring an OSB WLS domain in production mode

3 - 51

Copyright 2011, Oracle and/or its affiliates. All rights reserved.