Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring...

70
Oracle ® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers and system administrators that describes how to install and configure Oracle Service Bus.

Transcript of Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring...

Page 1: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Oracle® Fusion MiddlewareInstalling and Configuring Oracle Service Bus

12c (12.2.1)

E57276-05

October 2016

Documentation for installers and system administrators thatdescribes how to install and configure Oracle Service Bus.

Page 2: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Oracle Fusion Middleware Installing and Configuring Oracle Service Bus, 12c (12.2.1)

E57276-05

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

Primary Author: Ingrid Snedecor

This software and related documentation are provided under a license agreement containing restrictions onuse and disclosure and are protected by intellectual property laws. Except as expressly permitted in yourlicense 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. Reverseengineering, disassembly, or decompilation of this software, unless required by law for interoperability, isprohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. Ifyou 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 onbehalf of the U.S. Government, then 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 theprograms, 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.

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 thatmay create a risk of personal injury. If you use this software or hardware in dangerous applications, then youshall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure itssafe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of thissoftware or hardware in dangerous applications.

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

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks areused 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 MicroDevices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products,and services from third parties. Oracle Corporation and its affiliates are not responsible for and expresslydisclaim all warranties of any kind with respect to third-party content, products, and services unlessotherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliateswill not be responsible for any loss, costs, or damages incurred due to your access to or use of third-partycontent, products, or services, except as set forth in an applicable agreement between you and Oracle.

Page 3: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Contents

Preface ................................................................................................................................................................. v

Audience ........................................................................................................................................................ v

Related Documents....................................................................................................................................... v

Conventions................................................................................................................................................... v

1 About the Oracle Service Bus Installation

1.1 Using the Standard Installation Topology as a Starting Point .................................................. 1-1

1.1.1 About the Oracle Service Bus Standard Installation Topology ..................................... 1-1

1.1.2 About Elements in the Standard Installation Topology Illustration ............................ 1-2

1.2 Understanding Insight Integration with Oracle Service Bus .................................................... 1-3

1.3 About Secondary Topologies ......................................................................................................... 1-4

1.4 Using This Document to Extend an Existing Domain................................................................ 1-4

2 Preparing to Install and Configure Oracle Service Bus

2.1 Roadmap for Installing and Configuring a Standard Installation Topology ......................... 2-1

2.2 Roadmap for Verifying Your System Environment ................................................................... 2-2

2.2.1 Verifying Certification, System, and Interoperability Requirements ........................... 2-3

2.2.2 Selecting an Installation User ............................................................................................. 2-4

2.2.3 Understanding Directories for Installation and Configuration..................................... 2-7

2.2.4 Understanding JDK Requirements for an Oracle Fusion Middleware Installation . 2-11

2.2.5 Understanding Database Requirements for an Oracle Fusion Middleware

Installation ................................................................................................................................. 2-11

2.3 About Product Distributions........................................................................................................ 2-13

3 Installing the Oracle Service Bus Software

3.1 Verifying the Installation Checklist............................................................................................... 3-1

3.2 Starting the Installation Program .................................................................................................. 3-3

3.3 Navigating the Installation Screens .............................................................................................. 3-4

3.4 Verifying the Installation................................................................................................................ 3-5

3.4.1 Reviewing the Installation Log Files ................................................................................. 3-5

3.4.2 Checking the Directory Structure ...................................................................................... 3-5

3.4.3 Viewing the Contents of the Oracle Home....................................................................... 3-5

iii

Page 4: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

4 Configuring the Oracle Service Bus Domain

4.1 Creating the Database Schemas..................................................................................................... 4-1

4.1.1 Installing and Configuring a Certified Database............................................................. 4-2

4.1.2 Starting the Repository Creation Utility ........................................................................... 4-2

4.1.3 Navigating the Repository Creation Utility Screens to Create the Schemas ............... 4-2

4.2 Configuring the Domain................................................................................................................. 4-5

4.2.1 Starting the Configuration Wizard .................................................................................... 4-5

4.2.2 Navigating the Configuration Wizard Screens to Create and Configure the

Domain ......................................................................................................................................... 4-6

4.3 Starting the Servers........................................................................................................................ 4-17

4.3.1 Starting Node Manager ..................................................................................................... 4-18

4.3.2 Starting the Administration Server.................................................................................. 4-18

4.3.3 Starting the Managed Servers........................................................................................... 4-19

4.4 Verifying the Configuration......................................................................................................... 4-19

5 Next Steps After Configuring the Domain

5.1 Performing Basic Administrative Tasks....................................................................................... 5-1

5.2 Performing Additional Domain Configuration Tasks ............................................................... 5-2

5.3 Preparing Your Environment for High Availability .................................................................. 5-2

6 Deinstalling or Reinstalling Oracle Service Bus

6.1 About Product Deinstallation ........................................................................................................ 6-2

6.2 Stopping Oracle Fusion Middleware............................................................................................ 6-2

6.3 Removing Your Database Schemas............................................................................................... 6-2

6.4 Deinstalling the Software ............................................................................................................... 6-3

6.4.1 Starting the Deinstallation Program .................................................................................. 6-3

6.4.2 Selecting the Product to Deinstall ...................................................................................... 6-3

6.4.3 Navigating the Deinstallation Screens .............................................................................. 6-4

6.5 Removing the Oracle Home Directory Manually ....................................................................... 6-4

6.6 Removing the Program Shortcuts on Windows Operating Systems ....................................... 6-5

6.7 Removing the Domain and Application Data ............................................................................. 6-5

6.8 Reinstalling the Software................................................................................................................ 6-5

A Oracle Service Bus and Oracle Enterprise Scheduler Topology

A.1 Oracle Service Bus and Oracle Enterprise Scheduler Topology .............................................. A-5

iv

Page 5: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Preface

This document describes how to install and configure Oracle Service Bus.

Audience

Related Documents

Conventions

AudienceThis document is intended for system administrators or application developers whoare installing and configuring Oracle Service Bus. It is assumed that readers arefamiliar with web technologies and have a general understanding of Windows andUNIX platforms.

Related DocumentsFor more information, see the following documents in the Oracle Fusion Middlewarelibrary:

• Planning an Installation of Oracle Fusion Middleware

• Installing and Configuring the Oracle Fusion Middleware Infrastructure

• Developing Services with Oracle Service Bus

• High Availability Guide

• WLST Command Reference for SOA Suite

ConventionsThe following text conventions are used in this document:

Convention Meaning

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

italic Italic type indicates book titles, emphasis, or placeholder variables forwhich you supply particular values.

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

v

Page 6: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers
Page 7: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

1About the Oracle Service Bus Installation

The standard installation for Oracle Service Bus described in this guide creates thestandard topology, which represents a sample starting topology for this product.

Using the Standard Installation Topology as a Starting PointThe standard installation topology is a flexible topology that you can useas a starting point in production environments.

Understanding Insight Integration with Oracle Service BusYou can configure an Oracle Real-Time Integration Business Insight(Insight) agent with Oracle Service Bus to collect metrics.

About Secondary TopologiesSecondary topologies include configurations with components thatrequire additional installation or configuration steps on top of thestandard topology.

Using This Document to Extend an Existing DomainThe procedures in this guide describe how to create a new domain. Theassumption is that no other Oracle Fusion Middleware products areinstalled on your system.

1.1 Using the Standard Installation Topology as a Starting PointThe standard installation topology is a flexible topology that you can use as a startingpoint in production environments.

The information in this guide helps you to create a standard installation topology forOracle Service Bus. If appropriate and required, you can later extend the standardinstallation topology to create a secure and highly available production environment(see Next Steps After Configuring the Domain).

The standard installation topology represents a sample topology for this product. It isnot the only topology this product supports. For more information, see About theStandard Installation Topology in Planning an Installation of Oracle Fusion Middleware.

About the Oracle Service Bus Standard Installation TopologyThis topology represents a standard WebLogic Server domain thatcontains an Administration Server and one or more clusters containingone or more Managed Servers.

About Elements in the Standard Installation Topology IllustrationThe standard installation topology typically includes common elements.

1.1.1 About the Oracle Service Bus Standard Installation TopologyThis topology represents a standard WebLogic Server domain that contains anAdministration Server and one or more clusters containing one or more ManagedServers.

About the Oracle Service Bus Installation 1-1

Page 8: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

The following figure shows the standard installation topology for Oracle Service Bus.

See Table 1-1 for information on elements of this topology.

For configuration instructions, see Configuring the Oracle Service Bus Domain.

1.1.2 About Elements in the Standard Installation Topology IllustrationThe standard installation topology typically includes common elements.

The following table describes all elements of the topology illustration:

Table 1-1 Description of Elements in Standard Installation Topologies

Element Description and Links to Related Documentation

APPHOST A standard term used in Oracle documentation to referto the machine that hosts the application tier.

DBHOST A standard term used in Oracle documentation to referto the machine that hosts the database.

WebLogic Domain A logically related group of Java components (in thiscase, the Administration Server, Managed Servers, andother related software components).For more information, see What Is an Oracle WebLogicServer Domain? in Understanding Oracle FusionMiddleware.

Using the Standard Installation Topology as a Starting Point

1-2 Installing and Configuring Oracle Service Bus

Page 9: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table 1-1 (Cont.) Description of Elements in Standard Installation Topologies

Element Description and Links to Related Documentation

Administration Server Central control entity of a WebLogic domain. Itmaintains configuration objects for that domain anddistributes configuration changes to Managed Servers.For more information, see What Is the AdministrationServer? in Understanding Oracle Fusion Middleware.

Enterprise Manager The Oracle Enterprise Manager Fusion MiddlewareControl is a primary tool used to manage a domain.For more information, see Oracle Enterprise ManagerFusion Middleware Control in Understanding OracleFusion Middleware.

Cluster A collection of multiple WebLogic Server instancesrunning simultaneously and working together.For more information, see Overview of ManagedServers and Managed Server Clusters in UnderstandingOracle Fusion Middleware.

Machine A logical representation of the computer that hosts oneor more WebLogic Server instances (servers). Machinesare also the logical glue between the Managed Serversand the Node Manager. In order to start or stop theManaged Servers using the Node Manager, associatethe Managed Servers with a machine.

Managed Server A host for your applications, application components,web services, and their associated resources.For more information, see Overview of ManagedServers and Managed Server Clusters in UnderstandingOracle Fusion Middleware.

Infrastructure A collection of services that include the following:• Metadata repository (MDS) Contains metadata for

Oracle Fusion Middleware components, such as theOracle Application Developer Framework. Formore information, see What Is the MetadataRepository? in Understanding Oracle FusionMiddleware.

• Oracle Application Developer Framework (OracleADF)

• Oracle Web Services Manager (OWSM)

1.2 Understanding Insight Integration with Oracle Service BusYou can configure an Oracle Real-Time Integration Business Insight (Insight) agentwith Oracle Service Bus to collect metrics.

Note: Insight is available only if you have applied the 12c (12.2.1) Oracle Real-Time Integration Business Insight install patches released in March 2016. Formore information, see the Release Notes.

Insight allows business users to model, collect, and monitor business-level metricsusing web-based dashboards and reports, without the need to modify their already-deployed integrations and applications. Insight is collocated with the BAM Managed

Understanding Insight Integration with Oracle Service Bus

About the Oracle Service Bus Installation 1-3

Page 10: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Server. The business metrics are collected by Insight agents that are co-located withOracle SOA Suite or Oracle Service Bus Managed Servers and made available to thecentral application, viewed using BAM dashboards and reports.

To include an Insight agent with Oracle Service Bus, you select the Insight Service BusAgent template in the Configuration Wizard. See Selecting the ConfigurationTemplates for Oracle Service Bus.

For more information about Insight, see:

• Understanding Oracle Real-Time Integration Business Insight

• Getting Started with Oracle Real-Time Integration Business Insight

• Using Oracle Real-Time Integration Business Insight

• Administering Oracle Real-Time Integration Business Insight

• Understanding the Oracle Real-Time Integration Business Insight StandardInstallation Topology in Installing and Configuring Oracle SOA Suite and BusinessProcess Management

1.3 About Secondary TopologiesSecondary topologies include configurations with components that require additionalinstallation or configuration steps on top of the standard topology.

This is a test of using a variable for an xref from a shared topic to a shared topic:

The main sections of this guide describe how to install and configure a standardinstallation topology. The secondary topologies contain several products that are notidentified or included in the standard installation topologies.

For guidelines to install and configure secondary topologies, see Oracle Service Busand Oracle Enterprise Scheduler Topology.

1.4 Using This Document to Extend an Existing DomainThe procedures in this guide describe how to create a new domain. The assumption isthat no other Oracle Fusion Middleware products are installed on your system.

If you have installed and configured other Oracle Fusion Middleware products onyour system (for example, Fusion Middleware Infrastructure, with a domain that is upand running), use the same instructions to extend your existing domain. If you chooseextend an existing domain, read Installing Multiple Products in the Same Domain fordetailed information.

About Secondary Topologies

1-4 Installing and Configuring Oracle Service Bus

Page 11: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

2Preparing to Install and Configure Oracle

Service Bus

To prepare for your Oracle Service Bus installation, verify that your system meets thebasic requirements, then obtain the correct installation software.

Roadmap for Installing and Configuring a Standard Installation TopologyThis roadmap provides all the steps required to install and configure astandard Oracle Service Bus installation topology.

Roadmap for Verifying Your System EnvironmentBefore you begin the installation and configuration process, you mustverify your system environment.

About Product DistributionsYou create the initial Oracle Service Bus domain using the Oracle FusionMiddleware Infrastructure distribution, which contains both OracleWebLogic Server software and Oracle Java Required Files (JRF)software.

2.1 Roadmap for Installing and Configuring a Standard InstallationTopology

This roadmap provides all the steps required to install and configure a standardOracle Service Bus installation topology.

Table 2-1 Standard Installation Roadmap

Task Description Documentation

Verify your systemenvironment

Before beginning the installation,verify that the minimum systemand network requirements aremet.

See Roadmap for Verifying Your System Environment.

Check for anymandatory patchesthat will berequired before orafter theinstallation

Review the Oracle FusionMiddleware Infrastructure releasenotes to see if there are anymandatory patches required forthe software products you areinstalling.

See Install and Configure in Release Notes for OracleFusion Middleware Infrastructure.

Obtain theappropriatedistributions

Obtain the Oracle FusionMiddleware Infrastructure andOracle Service Bus distributions.

See About Product Distributions.

Preparing to Install and Configure Oracle Service Bus 2-1

Page 12: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table 2-1 (Cont.) Standard Installation Roadmap

Task Description Documentation

Determine yourinstallationdirectories

Verify that the installer can accessor create the required installerdirectories. Also, verify that thedirectories exist on systems thatmeet the minimum requirements.

See What Are the Key Oracle Fusion MiddlewareDirectories? in Understanding Oracle Fusion Middleware.

Install prerequisitesoftware

Install Oracle Fusion MiddlewareInfrastructure to create the Oraclehome directory for Oracle ServiceBus.

For Oracle Fusion Middleware Infrastructure, see Installing and Configuring the Oracle Fusion MiddlewareInfrastructure. You only need to perform theinstallation for Infrastructure. You do not need toconfigure a domain for Infrastructure.

Install the software Run the Oracle Universal Installerto install Oracle Service Bus.

Installing the software transfersthe software to your system andcreates the Oracle home directory.

See Installing the Oracle Service Bus Software.

Select a databaseprofile and reviewany requiredcustom variables.

Before you install requiredschemas in the database, reviewthe information about any customvariables you will need to set forthe Oracle Service Bus schemas.

See Understanding Database Requirements for anOracle Fusion Middleware Installation.

Create the schemas Run the Repository CreationUtility to create the schemasrequired for configuration.

See Creating the Database Schemas.

Create a WebLogicdomain

Use the Configuration Wizard/Assistant to create and configurethe WebLogic domain.

See Configuring the Domain for creating the standardtopology for Oracle Service Bus .

Administer andprepare yourdomain for highavailability

Discover additional tools andresources to administer yourdomain and configure yourdomain to be highly available.

See Next Steps After Configuring the Domain.

2.2 Roadmap for Verifying Your System EnvironmentBefore you begin the installation and configuration process, you must verify yoursystem environment.

The following table identifies important tasks and checks to perform to ensure thatyour environment is properly prepared for installing and configuring Oracle ServiceBus.

Table 2-2 Roadmap for Verifying Your System Environment

Task Description Documentation

Verify certification and systemrequirements

Verify that your operating system iscertified and properly configuredfor installation and configuration.

See Verifying Certification, System,and Interoperability Requirements.

Roadmap for Verifying Your System Environment

2-2 Installing and Configuring Oracle Service Bus

Page 13: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table 2-2 (Cont.) Roadmap for Verifying Your System Environment

Task Description Documentation

Identify a proper installation user Verify that the installation user hasthe proper permissions to installand configure the software.

See Selecting an Installation User.

Select the installation andconfiguration directories on yoursystem

Verify that you can create thenecessary directories for installationand configuration, according to therecommended directory structure.

See Understanding Directories forInstallation and Configuration.

Install a certified JDK The installation program for thedistribution requires a certified JDKpresent on your system.

See Understanding JDKRequirements for an Oracle FusionMiddleware Installation.

Install and configure a database formid-tier schemas

To configure your WebLogicdomain, you must have access to acertified database that is properlyconfigured for schemas required byOracle Service Bus.

See Understanding DatabaseRequirements for an Oracle FusionMiddleware Installation.

Verifying Certification, System, and Interoperability RequirementsOracle recommends that you use the certification matrix and systemrequirements documents with each other to verify that yourenvironment meets the requirements for installation.

Selecting an Installation UserThe user who performs installation and configuration on your systemrequires sufficient permissions and privileges.

Understanding Directories for Installation and ConfigurationDuring the installation and domain configuration process, you mustplan on providing the locations for these directories: Oracle Home,Domain Home, and the Application Home.

Understanding JDK Requirements for an Oracle Fusion Middleware InstallationMost Fusion Middleware products are in .jar file format. Thesedistributions do not include a JDK. To run a .jar distribution installer,you must have a certified JDK already installed on your system.

Understanding Database Requirements for an Oracle Fusion MiddlewareInstallation

Many Oracle Fusion Middleware products require database schemasprior to configuration. If you do not already have a database where youcan install these schemas, you must install and configure a certifieddatabase.

2.2.1 Verifying Certification, System, and Interoperability RequirementsOracle recommends that you use the certification matrix and system requirementsdocuments with each other to verify that your environment meets the requirementsfor installation.

1. Verifying your environment meets certification requirements

Roadmap for Verifying Your System Environment

Preparing to Install and Configure Oracle Service Bus 2-3

Page 14: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

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

Oracle has tested and verified the performance of your product on all certifiedsystems and environments. Whenever new certifications occur, they are added tothe proper certification document right away. New certifications can be releasedat any time. Therefore, the certification documents are kept outside thedocumentation libraries and are available on Oracle Technology Network.

2. Using the system requirements document to verify certification

Oracle recommends that you use the Oracle Fusion Middleware System Requirementsand Specifications document to verify that the certification requirements are met.For example, if the certification document indicates that your product is certifiedfor installation on 64-Bit Oracle Linux 6.5, use this document to verify that yoursystem meets the required minimum specifications. These include disk space,available memory, specific platform packages and patches, and other operatingsystem-specific items. System requirements can change in the future. Therefore,the system requirement documents are kept outside of the documentationlibraries and are available on Oracle Technology Network.

3. Verifying interoperability among multiple products

See Oracle Fusion Middleware 12c Interoperability and Compatibility inUnderstanding Interoperability and Compatibility to learn how to install and runmultiple Fusion Middleware products from the same release or mixed releaseswith each other.

2.2.2 Selecting an Installation UserThe user who performs installation and configuration on your system requiressufficient permissions and privileges.

Understanding User PermissionsThe user who installs a Fusion Middleware product owns the files andhas certain permissions on the files.

Understanding Non-Default User Permissions on UNIX Operating SystemsChanging the default permissions setting reduces the security of theinstallation and possibly your system. Oracle does not recommendchanging default permission settings.

Verifying the Installation User has Administrator Privileges on WindowsOperating Systems

To update the Windows Registry, you must have Administratorprivileges.

2.2.2.1 Understanding User PermissionsThe user who installs a Fusion Middleware product owns the files and has certainpermissions on the files.

• Read and write permissions on all non-executable files (forexample, .jar, .properties, or .xml). All other users in the same group as thefile owner have read permissions only.

Roadmap for Verifying Your System Environment

2-4 Installing and Configuring Oracle Service Bus

Page 15: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

• Read, write, and execute permissions on all executable files (forexample, .exe, .sh, or .cmd). All other users in the same group as the file ownerhave read and execute permissions only.

This means that someone other than the person who installs the software can use theinstalled binaries in the Oracle home to configure a domain or set of FusionMiddleware products.

During configuration, the files generated by the configuration process are owned bythe user who ran the Configuration Wizard, with the same permissions as describedabove for the installation user. However, security-sensitive files are not created withgroup permissions. Only the user that created the domain has read and writepermissions and can administer the domain.

Consider the following examples:

• Example 1: A Single User Installs the Software and Configures the Domain

This example shows the permissions if the same user installs the software andconfigures the domain.

To ensure the proper permissions and privileges for all files, Oracle recommendsthat the same owner perform both tasks: install the Oracle Fusion Middlewareproduct and configure the WebLogic Server domain using the ConfigurationWizard.

The Oracle home is created by User1 during product

installation. User1 has read/write/execute permissions

on all executable files, and read/write permissions on all

other files. All other users in User1’s group have

read/execute permissions on all executable files, and

read permissions on all other files.

product

Oracle Home

(Oracle_Home)

Application Home (applications)

oracle

home

Domain Home(domains)

configThe Domain home and Application home are created by

User1 during product installation. User1 has

read/write/execute permissions on all executable files,

and read/write permissions on all other files. All other

users in User1’s group have read/execute permissions

on all executable files, and read permissions on all

other files.

If the user who creates the domain is different than the user who installed thesoftware, then both users must have the same privileges, as shown in the nextexample.

• Example 2: The Oracle Home and Domain are Created by Different Users

This example shows the permissions where one user creates the Oracle home andanother user configures the domain.

Roadmap for Verifying Your System Environment

Preparing to Install and Configure Oracle Service Bus 2-5

Page 16: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

The Oracle home is created by User1 during product

installation. User1 has read/write/execute permissions on

all executable files, and read/write permissions on all

other files. All other users in User1’s group have

read/execute permissions on all executable files, and read

permissions on all other files.

product

Oracle Home

(Oracle_Home)

Application Home (applications)

oracle

home

Domain Home(domains)

configThe Domain home and Application home are created by

User2 during product installation. User2 has

read/write/execute permissions on all executable files,

and read/write permissions on all other files. All other

users in User2’s group (including User1) have

read/execute permissions on all executable files, and read

permissions on all other files.

Note: Certain domain files do not have group permissions. For example,cwallet.sso.

Consider the following items before running the installer:

• On UNIX operating systems, Oracle recommends that you set umask to 027 onyour system before you install the software. This ensures that file permissions areset properly during installation. Use the following command:

umask 027

You must enter this command in the same terminal window from which you planto run the product installer.

• On UNIX operating systems, do not run the installation program as the root user.If you run the installer as a root user, the startup validation may fail and youcannot continue the installation.

• When you manage a product installation (for example, applying patches or startingmanaged Servers), use the same user ID that you used to install the product.

• On Windows operating systems, you must have Administrative privileges to installthe product. See Verifying the Installation User has Administrator Privileges onWindows Operating Systems for more information.

2.2.2.2 Understanding Non-Default User Permissions on UNIX Operating SystemsChanging the default permissions setting reduces the security of the installation andpossibly your system. Oracle does not recommend changing default permissionsettings.

If other users require access to particular files or executable, consider using the UNIXsudo command (or other similar command) in lieu of changing file permissions.

Refer to your UNIX operating system Administrator's Guide or contact your operatingsystem vendor if you need further assistance.

Roadmap for Verifying Your System Environment

2-6 Installing and Configuring Oracle Service Bus

Page 17: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

2.2.2.3 Verifying the Installation User has Administrator Privileges on WindowsOperating SystemsTo update the Windows Registry, you must have Administrator privileges.

By default, members with the Administrator privilege sign in to the system withregular privileges, but can request elevated permissions to perform administrativetasks.

To perform a task with elevated privileges:

1. Find the Command Prompt item, either from the Start menu or the Windows iconin the lower-left hand corner.

2. Right-click Command Prompt and select Run as administrator.

This opens a new command prompt window, and all actions performed in thiswindow will be done with administrator privileges.

Note: If you have User Access Control enabled on your system, you may seean additional window asking you to confirm this action. Confirm andcontinue with this procedure.

3. Perform the desired task.

For example, to start the product installer:

For a jar file, enter:

java —jar distribution_name.jar

For an executable (.exe, .bin, or .sh file), enter:

distribution_name.exe

2.2.3 Understanding Directories for Installation and ConfigurationDuring the installation and domain configuration process, you must plan onproviding the locations for these directories: Oracle Home, Domain Home, and theApplication Home.

The following sections provide information to help you decide where you want tocreate these directories:

Understanding the Recommended Directory StructureOracle recommends specific locations for the Oracle Home, DomainHome, and Application Home.

About the Oracle Home DirectoryWhen you install any Oracle Fusion Middleware product, you must usean Oracle home directory.

About the Domain Home DirectoryThe Domain home is the directory where domains that you configure arecreated.

About the Application Home DirectoryThe Application home is the directory where applications for domainsyou configure are created.

Roadmap for Verifying Your System Environment

Preparing to Install and Configure Oracle Service Bus 2-7

Page 18: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Installing Multiple Products in the Same DomainThere are two methods for installing and configuring multiple productsin one domain.

Preparing for Shared StorageOracle Fusion Middleware enables you to configure multiple OracleWebLogic Server domains from a single Oracle home. This allows you toinstall the Oracle home in a single location on a shared volume andreuse the Oracle home for multiple host installations.

2.2.3.1 Understanding the Recommended Directory StructureOracle recommends specific locations for the Oracle Home, Domain Home, andApplication Home.

Oracle recommends a directory structure similar to the one shown in Figure 2-1.

Figure 2-1 Recommended Oracle Fusion Middleware Directory Structure

This area contains binary

files laid down by the

product installer. Runtime

processes will not write to

this area.

product

Oracle Home

(Oracle_Home)

Application Home

(applications)

oracle

home

Domain Home

(Domains)

configThis area contains

configuration and

application data created

by user.

A base location (Oracle base) should be established on your system (for example, /home/oracle) and from there, two separate branches should be created. Theproduct directory should contain the product binary files and all of the Oracle homedirectories. The config directory should contain your domain and application data.

Oracle recommends that you do not keep your configuration data anywhereunderneath the Oracle home; if you upgrade your product to another major release,you will be required to create a new Oracle home for binaries. You must also makesure that your configuration data exist in a location to which the binaries in the Oraclehome have access.

The /home/oracle/product (for the Oracle home) and /home/oracle/config(for the application and configuration data) directories are used in examplesthroughout the documentation; be sure to replace these directories with the actualdirectories on your system.

2.2.3.2 About the Oracle Home DirectoryWhen you install any Oracle Fusion Middleware product, you must use an Oraclehome directory.

Roadmap for Verifying Your System Environment

2-8 Installing and Configuring Oracle Service Bus

Page 19: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

This directory is a repository for common files that are used by multiple FusionMiddleware products installed on the same machine. These files are essential toensuring that Fusion Middleware operates correctly on your system. They facilitatechecking of cross-product dependencies during installation. For this reason, you canconsider the Oracle home directory a central support directory for all Oracle FusionMiddleware products installed on your system.

Fusion Middleware documentation refers to the Oracle home directory asORACLE_HOME.

Oracle Home Considerations

Keep the following in mind when creating the Oracle home directory and installingFusion Middleware products:

• Do not include spaces in the name of your Oracle home directory; the installergives you an error message if your Oracle home directory path contains spaces.

• You can install only one instance of each Oracle Fusion Middleware product in asingle Oracle home directory. If you need to maintain separate versions of aproduct on the same machine, each version must be in its own Oracle homedirectory.

Although you can have several different products in a single Oracle home, onlyone version of each product can be in the Oracle home.

Multiple Home Directories

Although in most situations, a single Oracle home directory is sufficient, it is possibleto create more than one Oracle home directory. For example, you need to maintainmultiple Oracle home directories in the following situations:

• You prefer to maintain separate development and production environments, with aseparate product stack for each. With two directories, you can update yourdevelopment environment without modifying the production environment untilyou are ready to do so.

• You want to maintain two different versions of a Fusion Middleware product at thesame time. For example, you may want to install a new version of a product whilekeeping your existing version intact. In this case, you must install each productversion in its own Oracle home directory.

• You need to install multiple products that are not compatible with each other. See Oracle Fusion Middleware 12c (12.2.1) Interoperability and Compatibility inUnderstanding Interoperability and Compatibility for more information.

Note: If you create more than one Oracle home directory, you must providenon-overlapping port ranges during the configuration phase for each product.

2.2.3.3 About the Domain Home DirectoryThe Domain home is the directory where domains that you configure are created.

The default Domain home location is ORACLE_HOME/user_projects/domains/domain_name. However, Oracle strongly recommends that you do not use thisdefault location. Put your Domain home outside of the Oracle home directory, forexample, in /home/oracle/config/domains. The config directory shouldcontain domain and application data. Oracle recommends a separate domain directory

Roadmap for Verifying Your System Environment

Preparing to Install and Configure Oracle Service Bus 2-9

Page 20: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

so that new installs, patches, and other operations update the ORACLE_HOME only, notthe domain configuration.

See Understanding the Recommended Directory Structure for more about therecommended directory structure and locating your Domain home.

Fusion Middleware documentation refers to the Domain home directory asDOMAIN_HOME and includes all folders up to and including the domain name. Forexample, if you name your domain exampledomain and locate your domain data inthe /home/oracle/config/domains directory, the documentation would useDOMAIN_HOME to refer to /home/oracle/config/domains/exampledomain.

2.2.3.4 About the Application Home DirectoryThe Application home is the directory where applications for domains you configureare created.

The default Application home location is ORACLE_HOME/user_projects/applications/domain_name. However, Oracle strongly recommends locatingyour Application home outside of the Oracle home directory; if you upgrade yourproduct to another major release, you must create a new Oracle home for binaries.

See Understanding the Recommended Directory Structure for more about therecommended directory structure and locating your Application home.

Fusion Middleware documentation refers to the Application home directory asAPPLICATION_HOME and includes all folders up to and including the domain name.For example, if you name your domain exampledomain and you locate yourapplication data in the /home/oracle/config/applications directory, thedocumentation uses APPLICATION_HOME to refer to /home/oracle/config/applications/exampledomain.

2.2.3.5 Installing Multiple Products in the Same DomainThere are two methods for installing and configuring multiple products in onedomain.

• Method 1.

Install and configure Product A, including creating the schemas and starting allservers in the domain to verify a successful domain configuration.

This is the method used in all installation guides in the Fusion Middleware library.You can repeat this process for as many products as necessary. It allows you tovalidate one product at a time and add more products incrementally.

To install Product B, you stop the Administration Server to prevent any updates tothe domain while you are adding the new product. Then, follow instructions in theinstallation guide for Product B, including creating the necessary schemas. Finally,extend the Product A domain to include Product B before starting all of the serversagain.

• Method 2.

Install all of the necessary products, then create the schemas for all of the products.After creating the schemas, configure the domain using all of the necessary producttemplates, then start all the servers.

This method of creating a multi-product domain may be slightly faster; however,the installation guides in the Fusion Middleware library do not provide specificinstructions for this method of domain creation. You will need to refer to thesupporting documentation as appropriate.

Roadmap for Verifying Your System Environment

2-10 Installing and Configuring Oracle Service Bus

Page 21: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

2.2.3.6 Preparing for Shared StorageOracle Fusion Middleware enables you to configure multiple Oracle WebLogic Serverdomains from a single Oracle home. This allows you to install the Oracle home in asingle location on a shared volume and reuse the Oracle home for multiple hostinstallations.

If you plan to use shared storage in your environment, see Using Shared Storage inHigh Availability Guide for more information.

For configuration requirements specific to Managed File Transfer, see HighAvailability Properties in Using Oracle Managed File Transfer

2.2.4 Understanding JDK Requirements for an Oracle Fusion Middleware InstallationMost Fusion Middleware products are in .jar file format. These distributions do notinclude a JDK. To run a .jar distribution installer, you must have a certified JDKalready installed on your system.

Make sure that the JDK is installed outside of the Oracle home. If you install the JDKunder the Oracle home, you will encounter problems when you try to perform tasks inthe future. Oracle Universal Installer validates that the Oracle home directory isempty; the install will not progress until you specify an empty directory. Oraclerecommends that you locate your JDK installation in the /home/oracle/products/jdk directory.

Some products (such as Oracle HTTP Server and Oracle JDeveloper) are availableas platform-specific distributions. Platform-specific distributions have a .bin (forUNIX operating systems) or .exe (for Windows operating systems) installer; in thesecases, a platform-specific JDK is in the distribution and you do not need to install aJDK separately. However, you may need to upgrade this JDK to a more recent version,depending on the JDK versions that are certified.

Always verify the required JDK version by reviewing the certification information onthe Oracle Fusion Middleware Supported System Configurations page.

To download the required JDK, navigate to the following URL and download the JavaSE JDK:

http://www.oracle.com/technetwork/java/javase/downloads/index.html

2.2.5 Understanding Database Requirements for an Oracle Fusion MiddlewareInstallation

Many Oracle Fusion Middleware products require database schemas prior toconfiguration. If you do not already have a database where you can install theseschemas, you must install and configure a certified database.

To find a certified database for your operating system, see the certification documentfor your release on the Oracle Fusion Middleware Supported System Configurations page.

To make sure your database is properly configured for schema creation, see"Repository Creation Utility Requirements" in the Oracle Fusion Middleware SystemRequirements and Specifications document.

After your database is properly configured, you use the Repository Creation Utility(RCU) to create product schemas in your database. This tool is available in the Oraclehome for your Oracle Fusion Middleware product. For more information about the

Roadmap for Verifying Your System Environment

Preparing to Install and Configure Oracle Service Bus 2-11

Page 22: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

RCU, see Understanding Repository Creation Utility in Creating Schemas with theRepository Creation Utility.

About the Custom Variables Required for the SOA Suite SchemasWhen you install the Oracle SOA Suite schemas, you are prompted to settwo custom variables, which affect the way in which these schemas arecreated in the database.

2.2.5.1 About the Custom Variables Required for the SOA Suite SchemasWhen you install the Oracle SOA Suite schemas, you are prompted to set two customvariables, which affect the way in which these schemas are created in the database.

These variables are explained further in the following sections:

About the Database Profile Custom VariableThe Database Profile custom variable on the Repository Creation Utility(RCU) Custom Variables screen allows you to identify the predicted sizeor "profile" of the database on which you are installing the SOAInfrastructure schema.

About the Healthcare Integration Custom VariableThe Healthcare Integration custom variable helps to activate theHealthcare Integration User Interface for Oracle SOA Suite. The interfaceis not supported for Oracle Business Process Management.

2.2.5.1.1 About the Database Profile Custom Variable

The Database Profile custom variable on the Repository Creation Utility (RCU)Custom Variables screen allows you to identify the predicted size or "profile" of thedatabase on which you are installing the SOA Infrastructure schema.

To estimate the size of the database required for your Oracle SOA Suite configuration,consider the information in Developing a Database Growth Management Strategy inAdministering Oracle SOA Suite and Oracle Business Process Management Suite.

If you enter SMALL or MEDIUM as the database profile, the RCU performs nospecial actions when the schema is created. The SMALL and MEDIUM optionsshould be entered for informational purposes only.

If you enter LARGE as the database profile, the RCU creates the SOA Infrastructureschema using an Oracle database feature called Interval Partitioning. Intervalpartitioning improves the efficiency of the database when large numbers of compositeapplications must be processed. When you select the LARGE database profile, theRCU creates the interval partitioned tables in a manner supported by the Oracle SOASuite purging scripts and guidelines.

For more information about database partitioning, see the following sections of theOracle Database VLDB and Partitioning Guide:

• Partitioning Concepts

• Interval Partitioning

Roadmap for Verifying Your System Environment

2-12 Installing and Configuring Oracle Service Bus

Page 23: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

2.2.5.1.2 About the Healthcare Integration Custom Variable

The Healthcare Integration custom variable helps to activate the HealthcareIntegration User Interface for Oracle SOA Suite. The interface is not supported forOracle Business Process Management.

If you are not planning to use the Healthcare Integration User Interface for Oracle SOASuite, then set the value of the Healthcare Integration custom variable to NO. If youare planning to use the Healthcare Integration User Interface for Oracle SOA Suite, setit to YES. Otherwise, the Healthcare Integration User Interface will not functionproperly after it is installed and configured.

When set to YES, the RCU creates additional materialized views in the database,which are required by the Healthcare Integration User Interface. When set to NO, youcan perform these additional schema configuration tasks later by running thefollowing SQL script on the database. This script is installed in the Oracle FusionMiddleware Oracle home when you select the Healthcare with B2B installation type:

ORACLE_HOME/common/sql/soainfra/sql/oracle/b2b_mv.sql

For more information, see Using the Oracle SOA Suite for Healthcare Integration UserInterface in Healthcare Integration User's Guide for Oracle SOA Suite.

2.3 About Product DistributionsYou create the initial Oracle Service Bus domain using the Oracle Fusion MiddlewareInfrastructure distribution, which contains both Oracle WebLogic Server software andOracle Java Required Files (JRF) software.

Oracle JRF software consists of:

• Oracle Web Services Manager

• Oracle Application Development Framework (Oracle ADF)

• Oracle Enterprise Manager Fusion Middleware Control

• Repository Creation Utility (RCU)

• Other libraries and technologies required to support Oracle Fusion Middlewareproducts

Installing Oracle Fusion Middleware Infrastructure is a prerequisite to installingOracle Service Bus.

About Product Distributions

Preparing to Install and Configure Oracle Service Bus 2-13

Page 24: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

About Product Distributions

2-14 Installing and Configuring Oracle Service Bus

Page 25: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

3Installing the Oracle Service Bus Software

Follow the steps in this section to install the Oracle Service Bus software.

Before beginning the installation, ensure that you have verified the prerequisites andcompleted all steps covered in Preparing to Install and Configure Oracle Service Bus.

Verifying the Installation ChecklistThe installation process requires specific information.

Starting the Installation ProgramBefore running the installation program, you must verify the JDK andprerequisite software is installed.

Navigating the Installation ScreensThe installer shows a series of screens where you verify or enterinformation.

Verifying the InstallationAfter you complete the installation, verify it was successful bycompleting a series of tasks.

3.1 Verifying the Installation ChecklistThe installation process requires specific information.

Table 3-1 lists important items that you must know before, or decide during, OracleService Bus installation.

Table 3-1 Installation Checklist

Information Example Value Description

JAVA_HOME /home/Oracle/Java/

jdk1.8.0_60

Environment variable thatpoints to the Java JDK homedirectory.

Database host examplehost.exampledom

ain

Name and domain of the hostwhere the database isrunning.

Database port 1521 Port number that thedatabase listens on. Thedefault Oracle database listenport is 1521.

Database service name orcl Oracle databases require aunique service name. Thedefault service name is orcl.

Installing the Oracle Service Bus Software 3-1

Page 26: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table 3-1 (Cont.) Installation Checklist

Information Example Value Description

DBA username SYS Name of user with databaseadministration privileges.The default DBA user onOracle databases is SYS.

DBA password myDBApw957 Password of the user withdatabase administrationprivileges.

ORACLE_HOME /home/Oracle/product/

ORACLE_HOME

Directory in which you willinstall your software.

This directory will includeOracle Fusion MiddlewareInfrastructure and OracleService Bus, as needed.

WebLogic Server hostname examplehost.exampledom

ain.com

Host name for OracleWebLogic Server and OracleService Bus consoles.

Console port 7001 Port for Oracle WebLogicServer and Oracle ServiceBus consoles.

DOMAIN_HOME /home/Oracle/config/

domains/osb_domain

Location in which yourdomain data is stored.

APPLICATION_HOME /home/Oracle/config/

applications/

osb_domain

Location in which yourapplication data is stored.

Administrator user name foryour WebLogic domain

weblogic Name of the user with OracleWebLogic Serveradministration privileges.The default administratoruser is weblogic.

Administrator user password myADMpw902 Password of the user withOracle WebLogic Serveradministration privileges.

FTP Port 7021 Port for embedded FTPserver.

RCU ORACLE_HOME/

oracle_common/bin

Path to the RepositoryCreation Utility (RCU).

RCU schema prefix OSB Prefix for names of databaseschemas used by OracleService Bus.

Verifying the Installation Checklist

3-2 Installing and Configuring Oracle Service Bus

Page 27: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table 3-1 (Cont.) Installation Checklist

Information Example Value Description

RCU schema password myRCUpw674 Password for the databaseschemas used by OracleService Bus.

Configuration utility ORACLE_HOME/

oracle_common/

common/bin

Path to the ConfigurationWizard for domain creationand configuration.

$FTP_ROOT $DOMAIN_HOME/product/

ftp_root

Embedded FTP server rootdirectory.

3.2 Starting the Installation ProgramBefore running the installation program, you must verify the JDK and prerequisitesoftware is installed.

To start the installation program:

1. Sign in to the host system.

2. If you have not already done so, verify that a certified JDK is installed on yoursystem: enter java -version on the command line. For 12c (12.2.1), the certifiedJDK is 1.8.0_60 and later.

For more information, see:

• Oracle Fusion Middleware Supported System Configurations

• Installing a JDK in Planning an Installation of Oracle Fusion Middleware.

3. Verify that you have installed all prerequisite software, such as Oracle FusionMiddleware Infrastructure.

4. Go to the directory where you downloaded the installation program.

5. Start the installation program by running the java executable from the JDKdirectory. For example:

• (UNIX) /home/Oracle/Java/jdk1.8.0_60/bin/java —jarfmw_12.2.1.0.0_osb.jar

• (Windows) C:\home\Oracle\Java\jdk1.8.0_60\bin\java -jarfmw_12.2.1.0.0_osb.jar

Note:

You can also start the installer in silent mode using a saved response fileinstead of launching the installer screens. For more about silent or commandline installation, see Using the Oracle Universal Installer in Silent Mode inInstalling Software with the Oracle Universal Installer.

When the installation program appears, you are ready to begin the installation.

Starting the Installation Program

Installing the Oracle Service Bus Software 3-3

Page 28: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

3.3 Navigating the Installation ScreensThe installer shows a series of screens where you verify or enter information.

The following table lists the order in which installer screens appear. If you needadditional help with an installation screen, click Help.

Table 3-2 Oracle Service Bus Install Screens

Screen Description

InstallationInventorySetup

On UNIX operating systems, this screen opens if this is the first time you areinstalling any Oracle product on this host. Specify the location where youwant to create your central inventory. Make sure that the operating systemgroup name selected on this screen has write permissions to the centralinventory location.

For more about the central inventory, see Understanding the Oracle CentralInventory in Installing Software with the Oracle Universal Installer.

This screen does not appear on Windows operating systems.

Welcome On this screen, review the information to make sure that you have met all theprerequisites, then click Next

AutoUpdates

On this screen, select to skip automatic updates, select patches, or search forthe latest software updates, including important security updates, throughyour My Oracle Support account.

InstallationLocation

Use this screen to specify your Oracle home directory location.

This Oracle home should already contain Oracle Fusion MiddlewareInfrastructure and any other12c (12.2.1)products that have been installed.

You can click View to verify and ensure that you are installing Oracle ServiceBus in the correct Oracle home. See Understanding Directories for Installationand Configuration.

InstallationType

Select Service Bus.

PrerequisiteChecks

This screen verifies that your system meets the minimum necessaryrequirements.

To view the list of tasks that gets verified, select View Successful Tasks. Toview log details, select View Log. If any prerequisite check fails, then an errormessage appears at the bottom of the screen. Fix the error and click Rerun totry again. To ignore the error or the warning message and continue with theinstallation, click Skip (not recommended).

InstallationSummary

Use this screen to verify installation options you selected. If you want to savethese options to a response file, click Save Response File and enter theresponse file location and name. The response file collects and stores all theinformation that you have entered, and enables you to perform a silentinstallation (from the command line) at a later time.

Click Install to begin the installation.

Navigating the Installation Screens

3-4 Installing and Configuring Oracle Service Bus

Page 29: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table 3-2 (Cont.) Oracle Service Bus Install Screens

Screen Description

InstallationProgress

This screen shows the installation progress.

When the progress bar reaches 100% complete, click Finish to dismiss theinstaller, or click Next to see a summary.

InstallationComplete

This screen displays the Installation Location and the Feature Sets that areinstalled. Review this information and click Finish to close the installer.

3.4 Verifying the InstallationAfter you complete the installation, verify it was successful by completing a series oftasks.

Reviewing the Installation Log FilesReview the contents of the installation log files to make sure that theinstaller did not encounter any problems.

Checking the Directory StructureThe contents of your installation vary based on the options you selectedduring the installation.

Viewing the Contents of the Oracle HomeYou can view the contents of the Oracle home using theviewInventory script.

3.4.1 Reviewing the Installation Log FilesReview the contents of the installation log files to make sure that the installer did notencounter any problems.

By default, the installer writes logs files to the Oracle_Inventory_Location/logs (on UNIX operating systems) or Oracle_Inventory_Location\logs (onWindows operating systems) directory.

For a description of the log files and where to find them, see Installation Log Files inInstalling Software with the Oracle Universal Installer.

3.4.2 Checking the Directory StructureThe contents of your installation vary based on the options you selected during theinstallation.

For more information about the directory structure after installation, see What Are theKey Oracle Fusion Middleware Directories? in Understanding Oracle Fusion Middleware.

3.4.3 Viewing the Contents of the Oracle HomeYou can view the contents of the Oracle home using the viewInventory script.

For more information, see Viewing the Contents of an Oracle Home in InstallingSoftware with the Oracle Universal Installer.

Verifying the Installation

Installing the Oracle Service Bus Software 3-5

Page 30: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Verifying the Installation

3-6 Installing and Configuring Oracle Service Bus

Page 31: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

4Configuring the Oracle Service Bus Domain

After you have installed Oracle Service Bus, you can configure the domain, which youcan also extend for high availability.

The configuration steps presented here assume that you have completed theinstallation steps covered in:

• Preparing to Install and Configure Oracle Service Bus

• Installing the Oracle Service Bus Software

Refer to the following sections to create the database schemas, configure a WebLogicdomain, and verify the configuration:

Creating the Database SchemasBefore you can configure an Oracle Service Bus domain, you must installrequired schemas on a certified database for use with this release ofOracle Fusion Middleware.

Configuring the DomainUse the Configuration Wizard to create and configure a domain.

Starting the ServersAfter configuration is complete, start Node Manager, then the WebLogicAdministration Server and Managed Servers.

Verifying the ConfigurationAfter completing all configuration steps, you can perform additionalsteps to verify that your domain is properly configured.

4.1 Creating the Database SchemasBefore you can configure an Oracle Service Bus domain, you must install requiredschemas on a certified database for use with this release of Oracle Fusion Middleware.

Installing and Configuring a Certified DatabaseBefore creating the database schemas, you must install and configure acertified database, and verify that the database is up and running.

Starting the Repository Creation UtilityStart the Repository Creation Utility (RCU) after verifying that a certifiedJDK is installed on your system.

Navigating the Repository Creation Utility Screens to Create the SchemasEnter required information in the RCU screens to create the databaseschemas.

Configuring the Oracle Service Bus Domain 4-1

Page 32: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

4.1.1 Installing and Configuring a Certified DatabaseBefore creating the database schemas, you must install and configure a certifieddatabase, and verify that the database is up and running.

For more information, see Understanding Database Requirements for an OracleFusion Middleware Installation.

4.1.2 Starting the Repository Creation UtilityStart the Repository Creation Utility (RCU) after verifying that a certified JDK isinstalled on your system.

To start the RCU:

1. Verify that a certified JDK already exists on your system by running java -version from the command line. For 12c (12.2.1), the certified JDK is 1.8.0_60 andlater. For more information, see Understanding JDK Requirements for an OracleFusion Middleware Installation .

2. Ensure that the JAVA_HOME environment variable is set to the location of thecertified JDK. For example:

• (UNIX) setenv JAVA_HOME /home/Oracle/Java/jdk1.8.0_60

• (Windows) set JAVA_HOME=C:\home\Oracle\Java\jdk1.8.0_60

3. Go to the /oracle_common/bin directory :

• (UNIX) ORACLE_HOME/oracle_common/bin

• (Windows) ORACLE_HOME\oracle_common\bin

4. Enter the following command:

• (UNIX) ./rcu

• (Windows) rcu.bat

4.1.3 Navigating the Repository Creation Utility Screens to Create the SchemasEnter required information in the RCU screens to create the database schemas.

Introducing the RCUThe Welcome screen is the first screen that appears when you start theRCU.

Selecting a Method of Schema CreationUse the Create Repository screen to select a method to create and loadcomponent schemas into the database.

Providing Database Connection DetailsOn the Database Connection Details screen, provide the databaseconnection details for the RCU to connect to your database.

Specifying a Custom Prefix and Selecting SchemasOn the Select Components screen, specify a custom prefix and select theproduct database schema.

Creating the Database Schemas

4-2 Installing and Configuring Oracle Service Bus

Page 33: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Specifying Schema PasswordsOn the Schema Passwords screen, specify how you want to set theschema passwords on your database, then enter and confirm yourpasswords.

Specifying Custom VariablesOn the Custom Variables screen, specify the custom variables for theSOA Infrastructure schema.

Completing Schema CreationNavigate through the remaining RCU screens to complete schemacreation.

4.1.3.1 Introducing the RCUThe Welcome screen is the first screen that appears when you start the RCU.

Click Next.

4.1.3.2 Selecting a Method of Schema CreationUse the Create Repository screen to select a method to create and load componentschemas into the database.

On the Create Repository screen:

• If you have the necessary permission and privileges to perform DBA activities onyour database, select System Load and Product Load. This procedure assumes thatyou have SYSDBA privileges.

• If you do not have the necessary permission or privileges to perform DBA activitiesin the database, you must select Prepare Scripts for System Load on this screen.This option generates a SQL script that you can give to your databaseadministrator. See Understanding System Load and Product Load in CreatingSchemas with the Repository Creation Utility.

• If the DBA has already run the SQL script for System Load, select Perform ProductLoad.

4.1.3.3 Providing Database Connection DetailsOn the Database Connection Details screen, provide the database connection detailsfor the RCU to connect to your database.

Note:

If you are unsure of the service name for your database, you can obtain it fromthe SERVICE_NAMES parameter in the initialization parameter file of thedatabase. If the initialization parameter file does not contain theSERVICE_NAMES parameter, then the service name is the same as the globaldatabase name, which is specified in the DB_NAME and DB_DOMAINparameters.

For example:

Database Type: Oracle DatabaseName: examplehost.exampledomain.comPort: 1521

Creating the Database Schemas

Configuring the Oracle Service Bus Domain 4-3

Page 34: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Service Name: Orcl.exampledomain.comUser Name: sysPassword: ******Role: SYSDBA

Click Next to proceed, then click OK in the dialog window that confirms a successfuldatabase connections.

4.1.3.4 Specifying a Custom Prefix and Selecting SchemasOn the Select Components screen, specify a custom prefix and select the productdatabase schema.

Select Create new prefix, specify a custom prefix, then select SOA Suite schema. Thiswill automatically select SOA Infrastructure, along with the following schemas asdependencies:

• User Messaging Service

• Metadata Services

• WebLogic Services

• Oracle Platform Security Services

• Audit Services

• Audit Services Append

• Audit Services Viewer

Tip:

Make a note of the custom prefix you choose to enter here; you will need thislater on during the domain creation process.

A schema called Common Infrastructure Services is also automatically created; thisschema is grayed out (you can’t select it or deselect it). This schema enables you toretrieve information from the RCU during domain configuration. For moreinformation, see Understanding the Service Table Schema in Creating Schemas with theRepository Creation Utility.

The custom prefix logically groups these schemas together for use in this domain only;you must create a unique set of schemas for each domain as schema sharing acrossdomains is not supported.

See Also:

For more information, see the following topics in Creating Schemas with theRepository Creation Utility:

• Understanding Custom Prefixes

• Planning Your Schema Creation

Click Next to proceed, then click OK to confirm that prerequisite checking for schemacreation was successful.

Creating the Database Schemas

4-4 Installing and Configuring Oracle Service Bus

Page 35: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

4.1.3.5 Specifying Schema PasswordsOn the Schema Passwords screen, specify how you want to set the schema passwordson your database, then enter and confirm your passwords.

Tip:

You must make a note of the passwords you set on this screen; you will needthem later on during the domain creation process.

4.1.3.6 Specifying Custom VariablesOn the Custom Variables screen, specify the custom variables for the SOAInfrastructure schema.

For the Oracle SOA Suite standard installation topology, accept both default values forDatabase Profile (Small) and Healthcare Integration (No).

For more information, see About the Custom Variables Required for the SOA SuiteSchemas.

Tip:

For more information about the options on this screen, see Custom Variablesin Creating Schemas with the Repository Creation Utility.

4.1.3.7 Completing Schema CreationNavigate through the remaining RCU screens to complete schema creation.

On the Map Tablespaces screen, the Encrypt Tablespace check box appears only if youenabled TDE (Transparent Data Encryption) in the database (Oracle or Oracle EBR)when you start the RCU. Select the Encrypt Tablespace check box if you want toencrypt all new tablespaces that the RCU will create.

When you reach the Completion Summary screen, click Close to dismiss the RCU.

4.2 Configuring the DomainUse the Configuration Wizard to create and configure a domain.

For information on other methods to create domains, see Additional Tools forCreating, Extending, and Managing WebLogic Domains in Creating WebLogic DomainsUsing the Configuration Wizard.

Starting the Configuration WizardStart the Configuration Wizard to begin configuring a domain.

Navigating the Configuration Wizard Screens to Create and Configure theDomain

Enter required information in the Configuration Wizard screens to createand configure the domain for the topology.

4.2.1 Starting the Configuration WizardStart the Configuration Wizard to begin configuring a domain.

To start the Configuration Wizard:

1. Go to the /oracle_common/common/bin directory:

Configuring the Domain

Configuring the Oracle Service Bus Domain 4-5

Page 36: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

(UNIX) ORACLE_HOME/oracle_common/common/bin

(Windows) ORACLE_HOME\oracle_common\common\bin

where ORACLE_HOME is your 12c (12.2.1) Oracle home.

2. Enter the following command:

(UNIX) ./config.sh

(Windows) config.cmd

4.2.2 Navigating the Configuration Wizard Screens to Create and Configure the DomainEnter required information in the Configuration Wizard screens to create andconfigure the domain for the topology.

Note:

You can use this procedure to extend an existing domain. If your needs do notmatch the instructions in the procedure, be sure to make your selectionsaccordingly, or see the supporting documentation for more details.

Selecting the Domain Type and Domain Home LocationYou must select a Domain home directory location, optimally outsidethe Oracle home directory.

Selecting the Configuration Templates for Oracle Service BusUse the Templates screen to select the templates you require.

Selecting the Application Home LocationUse the Application Location screen to select the location to storeapplications associated with your domain, also known as the Applicationhome directory.

Configuring the Administrator AccountUse the Administrator Account screen to specify the user name andpassword for the default WebLogic Administrator account for thedomain.

Specifying the Domain Mode and JDKUse the Domain Mode and JDK screen to specify the domain mode andJava Development Kit (JDK).

Specifying the Database Configuration TypeUse the Database Configuration type screen to specify details about thedatabase and database schema.

Specifying JDBC Component Schema InformationUse the JDBC Component Schema screen to verify or specify detailsabout the database schemas.

Testing the JDBC ConnectionsUse the JDBC Component Schema Test screen to test the data sourceconnections.

Configuring the Domain

4-6 Installing and Configuring Oracle Service Bus

Page 37: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Selecting Advanced ConfigurationUse the Advanced Configuration screen to complete the domainconfiguration.

Configuring the Administration Server Listen AddressUse the Administration Server screen to select the IP address of the host.

Configuring Node ManagerUse the Node Manager screen to select the type of Node Manager youwant to configure, along with the Node Manager credentials.

Configuring Managed Servers for Oracle Service BusUse the Managed Servers screen to configure Managed Servers.

Configuring the Administration Server as the Oracle Service Bus Runtime ServerBeginning with 12c (12.1.3), you can configure the administrator serveras the Oracle Service Bus runtime server if you require a standaloneOracle Service Bus domain.

Configuring a Cluster for Oracle Service BusUse the Clusters screen to create a new cluster.

Assigning Oracle Service Bus Managed Servers to the ClusterUse the Assign Servers to Clusters screen to assign Managed Servers tothe new cluster.

Configuring Coherence ClustersUse the Coherence Clusters screen to configure the Coherence cluster.

Creating a New Oracle Service Bus MachineUse the Machines screen to create new machines in the domain. Amachine is required so that Node Manager can start and stop servers.

Assigning Servers to Oracle Service Bus MachinesUse the Assign Servers to Machines screen to assign the AdministrationServer and Managed Servers to the new machine you just created.

Reviewing Your Configuration Specifications and Configuring the DomainThe Configuration Summary screen shows detailed configurationinformation for the domain you are about to create.

Writing Down Your Domain Home and Administration Server URLThe Configuration Success screen shows information about the domainyou just configured.

4.2.2.1 Selecting the Domain Type and Domain Home LocationYou must select a Domain home directory location, optimally outside the Oracle homedirectory.

Oracle recommends that you locate your Domain home in accordance with thedirectory structure in What are the Key Oracle Fusion Middleware Directories? inUnderstanding Oracle Fusion Middleware, where the Domain home is located outside theOracle home directory. This directory structure helps avoid issues when you need toupgrade or reinstall software.

Configuring the Domain

Configuring the Oracle Service Bus Domain 4-7

Page 38: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Note:

If you want to use an Oracle Real-Time Integration Business Insight agent(Insight Service Bus agent) to collect business metrics:

• Insight must be co-located in the same domain as BAM. See UnderstandingInsight Integration with Oracle Service Bus.

• If you configure BAM and Insight in a separate domain from the OracleService Bus domain, then the Oracle Service Bus domain cannot alsoinclude BAM. If Oracle Service Bus and BAM are co-located in the samedomain, then the BAM data source entries must reference the local SOAschema. Insight agents (in the SOA and Oracle Service Bus domains) accessthe remote BAM/Insight domain’s SOA schema through the BAM datasource entries. However, if the BAM data source must reference the localSOA schema for BAM to work in the Oracle Service Bus domain, then theInsight agents cannot access the remote BAM/Insight domain’s SOAschema.

• If you configure an Oracle Service Bus domain to include an Insight ServiceBus agent that communicates with a remote BAM/Insight domain, thenyou will need to manually edit the BAM data source entries to referencethe SOA schema of the BAM/Insight domain. For more information, see Specifying JDBC Component Schema Information.

• If BAM and Insight are co-located in the same domain as Oracle ServiceBus, then the BAM data source entries reference the correct SOA schema(in the Oracle Service Bus domain), and no manual updates are necessary.

To specify the Domain type and Domain home directory:

1. On the Configuration Type screen, select Create a new domain.

Note: You can also extend your existing Oracle Service Bus domain to includean Insight agent by selecting Update an existing domain. For informationabout extending a domain, see Enterprise Deployment Guide for Oracle SOASuite. When an existing domain is extended to include the Insight Service BusAgent template, you will need to repack and unpack the domain in all themachines that host the servers of that cluster.

2. In the Domain Location field, specify your Domain home directory.

For more about other options on this screen, see Configuration Type in CreatingWebLogic Domains Using the Configuration Wizard.

4.2.2.2 Selecting the Configuration Templates for Oracle Service BusUse the Templates screen to select the templates you require.

On the Templates screen, make sure Create Domain Using Product Templates isselected, then select the following templates:

• Oracle Service Bus - 12.2.1.0 [osb]

Selecting this template automatically selects the following as dependencies:

Configuring the Domain

4-8 Installing and Configuring Oracle Service Bus

Page 39: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

– WebLogic Advanced Web Services for JAX-RPC Extension

– ODSI XQuery 2004 Components

– Oracle Enterprise Manager

– Oracle WSM Policy Manager

– Oracle JRF

– WebLogic Coherence Cluster Extension

• Insight Service Bus Agent - 12.2.1.0 [osb] if you want to include an Oracle Real-Time Integration Business Insight agent with Oracle Service Bus.

For more information, see Understanding Insight Integration with Oracle ServiceBus.

Tip:

For more information about this screen, see Templates in Creating WebLogicDomains Using the Configuration Wizard.

4.2.2.3 Selecting the Application Home LocationUse the Application Location screen to select the location to store applicationsassociated with your domain, also known as the Application home directory.

Oracle recommends that you locate your Application home in accordance with thedirectory structure in What Are the Key Oracle Fusion Middleware Directories? inUnderstanding Oracle Fusion Middleware, where the Application home is located outsidethe Oracle home directory. This directory structure helps avoid issues when you needto upgrade or re-install your software.

Tip:

For more about the Application home directory, see About the ApplicationHome Directory.

For more information about this screen, see Application Location in CreatingWebLogic Domains Using the Configuration Wizard.

4.2.2.4 Configuring the Administrator AccountUse the Administrator Account screen to specify the user name and password for thedefault WebLogic Administrator account for the domain.

Oracle recommends that you make a note of the user name and password that youenter on this screen; you need these credentials later to boot and connect to thedomain's Administration Server.

4.2.2.5 Specifying the Domain Mode and JDKUse the Domain Mode and JDK screen to specify the domain mode and JavaDevelopment Kit (JDK).

On the Domain Mode and JDK screen:

• Select Production in the Domain Mode field.

• Select the Oracle HotSpot JDK in the JDK field.

Configuring the Domain

Configuring the Oracle Service Bus Domain 4-9

Page 40: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Tip:

For more information about this screen, see Domain Mode and JDK in CreatingWebLogic Domains Using the Configuration Wizard.

4.2.2.6 Specifying the Database Configuration TypeUse the Database Configuration type screen to specify details about the database anddatabase schema.

On the Database Configuration type screen, select RCU Data. This option instructs theConfiguration Wizard to connect to the database and Service Table (STB) schema toautomatically retrieve schema information for schemas needed to configure thedomain.

Note:

If you select Manual Configuration on this screen, you must manually fill inparameters for your schema on the next screen.

After selecting RCU Data, fill in the following fields:

Field Description

DBMS/Service Enter the database DBMS name, or service name if you selected aservice type driver.

Example: orcl.exampledomain.com

Host Name Enter the name of the server hosting the database.

Example: examplehost.exampledomain.com

Port Enter the port number on which the database listens.

Example: 1521

Schema Owner

Schema Password

Enter the username and password for connecting to the database'sService Table schema. This is the schema username and passwordentered for the Service Table component on the Schema Passwordsscreen in the RCU (see Specifying Schema Passwords).

The default username is prefix_STB, where prefix is the customprefix that you defined in the RCU.

Click Get RCU Configuration when you finish specifying the database connectioninformation. The following output in the Connection Result Log indicates that theoperation succeeded:

Connecting to the database server...OKRetrieving schema data from database server...OKBinding local schema components with retrieved data...OK

Successfully Done.

Configuring the Domain

4-10 Installing and Configuring Oracle Service Bus

Page 41: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Tip:

For more information about the schema installed when the RCU is run, see Understanding the Service Table Schema in Creating Schemas with theRepository Creation Utility.

For more information about this screen, see Database Configuration Type inCreating WebLogic Domains Using the Configuration Wizard.

4.2.2.7 Specifying JDBC Component Schema InformationUse the JDBC Component Schema screen to verify or specify details about thedatabase schemas.

Verify that the values on the JDBC Component Schema screen are correct for allschemas. Review the following to understand when the schema table may not bepopulated correctly for BAM:

• If you configure an Oracle Service Bus domain to include an Insight Service Busagent that communicates with a remote BAM/Insight domain, then you will needto manually edit the BAM data source entries to reference the SOA schema of theBAM/Insight domain. The data sources that you will need to edit are:

– BamDataSource (SOAINFRA schema)

– BamJobSchedDataSource (WLS schema)

– BamLeasingDataSource (WLS_RUNTIME schema)

– BamNonJTADataSource (SOAINFRA schema)

– mds-bam (MDS schema)

• If BAM and Insight are collocated in the same domain as Oracle Service Bus, thenthe BAM data source entries reference the correct SOA schema (in the OracleService Bus domain), and no manual updates are necessary.

Tip:

For high availability environments, see the following sections in HighAvailability Guide for additional information on configuring data sources forOracle RAC databases:

• Configuring GridLink Data Sources with Oracle RAC

• Configuring Multi Data Sources

For more information about this screen, see JDBC Component Schema inCreating WebLogic Domains Using the Configuration Wizard.

4.2.2.8 Testing the JDBC ConnectionsUse the JDBC Component Schema Test screen to test the data source connections.

A green check mark in the Status column indicates a successful test. If you encounterany 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 youspecified while creating your schemas. If you want different passwords for differentschema components, manually edit them in the previous screen (JDBC Component

Configuring the Domain

Configuring the Oracle Service Bus Domain 4-11

Page 42: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Schema) by entering the password you want in the Schema Password column, againsteach row. After specifying the passwords, select the check box corresponding to theschemas that you changed the password in and test the connection again.

Tip:

For more information about this screen, see JDBC Component Schema Test inCreating WebLogic Domains Using the Configuration Wizard .

4.2.2.9 Selecting Advanced ConfigurationUse the Advanced Configuration screen to complete the domain configuration.

On the Advanced Configuration screen, select:

• Administration Server

Required to properly configure the listen address of the Administration Server.

• Node Manager

Required to configure Node Manager.

• Topology

Required to configure the Oracle Service Bus Managed Server.

Optionally, select other available options as required for your desired installationenvironment. The steps in this guide describe a standard installation topology, butyou may choose to follow a different path. If your installation requirements extend toadditional options outside the scope of this guide, you may be presented withadditional screens to configure those options. For information about all ConfigurationWizard screens, see Configuration Wizard Screens in Creating WebLogic Domains Usingthe Configuration Wizard.

4.2.2.10 Configuring the Administration Server Listen AddressUse the Administration Server screen to select the IP address of the host.

Select the drop-down list next to Listen Address and select the IP address of the hostwhere the Administration Server will reside, or use the system name or DNS namethat maps to a single IP address. Do not use All Local Addresses.

Do not specify any server groups for the Administration Server.

4.2.2.11 Configuring Node ManagerUse the Node Manager screen to select the type of Node Manager you want toconfigure, along with the Node Manager credentials.

Select Per Domain Default Location as the Node Manager type, then specify NodeManager credentials.

Tip:

For more information about this screen, see Node Manager in CreatingWebLogic Domains Using the Configuration Wizard.

For more about Node Manager types, see Node Manager Overview inAdministering Node Manager for Oracle WebLogic Server.

Configuring the Domain

4-12 Installing and Configuring Oracle Service Bus

Page 43: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

4.2.2.12 Configuring Managed Servers for Oracle Service BusUse the Managed Servers screen to configure Managed Servers.

On the Managed Servers screen, a new Managed Server named osb_server1 isautomatically created by default.

To configure Managed Servers for Oracle Service Bus:

1. In the Listen Address drop-down list, select the IP address of the host on which theManaged Server will reside or use the system name or DNS name that maps to asingle IP address. Do not use All Local Addresses.

2. In the Server Groups drop-down list, make sure that OSB-MGD-SVRS-COMBINED is selected. This server group ensures that Oracle Service Bus andOracle Web Services Manager (OWSM) services are targeted to the same ManagedServer.

• If you want to have OWSM Policy Manager in a different server from the OracleService Bus server, select OSB-MGD-SVRS-ONLY. This targets only OracleService Bus but not OWSM Policy Manager to the server.

• If you plan to configure a cluster that includes both SOA and Oracle Service BusManaged Servers on the same machine, you must assign both the OSB-MGD-SVRS-COMBINED and SOA-MGD-SVRS server groups to each ManagedServer. Otherwise, domain creation will fail.

3. Configuring a second Managed Server is one of the steps needed to configure thestandard topology for high availability. If you are not creating a highly availableenvironment, then this step is optional.

Click Add and select OSB-MGD-SVRS-COMBINED to create a second ManagedServer named osb_server2.

Note:

For more information about the high availability standard topology, see Understanding the Fusion Middleware Standard HA Topology in HighAvailability Guide.

For more information about the next steps to prepare for high availability afteryour domain is configured, see Preparing Your Environment for HighAvailability.

These server names are referenced throughout this document. If you choose differentnames be sure to replace them as needed.

Tip:

For more information about this screen, see Managed Servers in CreatingWebLogic Domains Using the Configuration Wizard.

4.2.2.13 Configuring the Administration Server as the Oracle Service Bus RuntimeServerBeginning with 12c (12.1.3), you can configure the administrator server as the OracleService Bus runtime server if you require a standalone Oracle Service Bus domain.

Configuring the Domain

Configuring the Oracle Service Bus Domain 4-13

Page 44: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

To use the administration server as the Oracle Service Bus runtime server, you mustcreate a compact domain. However, a compact domain is supported only in thedeveloper environment, not the production environment. Therefore, Oracle does notsupport Oracle Service Bus running in the administration server in production. Tocreate a compact domain in a testing and development environment, see Configuringa Compact Domain in Installing SOA Suite and Business Process Management Suite QuickStart for Developers.

Note: You can follow the steps in Installing SOA Suite and Business ProcessManagement Suite Quick Start for Developers to create a compact domain even ifyou did not use the Quick Start installation to install Oracle Service Bus.

4.2.2.14 Configuring a Cluster for Oracle Service BusUse the Clusters screen to create a new cluster.

On the Clusters screen:

1. Click Add.

2. Specify osb_cluster1 in the Cluster Name field.

3. Leave the Cluster Address field blank.

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 OracleWebLogic Server.

You can also create clusters using Fusion Middleware Control. In this case, you canconfigure cluster communication (unicast or multicast) when you create the newcluster. For more information, see "Create and configure clusters" in Oracle WebLogicServer Administration Console Online Help.

Tip:

For more information about this screen, see Clusters in Creating WebLogicDomains Using the Configuration Wizard.

4.2.2.15 Assigning Oracle Service Bus Managed Servers to the ClusterUse the Assign Servers to Clusters screen to assign Managed Servers to the newcluster.

On the Assign Servers to Clusters screen:

1. In the Clusters pane, select the cluster to which you want to assign the ManagedServers; in this case, osb_cluster1.

2. In the Servers pane, assign osb_server1 to osb_cluster1 by doing one of thefollowing:

• Click once on osb_server1 to select it, then click the right arrow to move itbeneath 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.

Configuring the Domain

4-14 Installing and Configuring Oracle Service Bus

Page 45: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

3. Repeat to assign osb_server2 to osb_cluster1.

The following image shows a generic example of the Clusters pane after ManagedServers are assigned to clusters.

Figure 4-1 Managed Servers Assigned to Clusters

Tip:

For more information about this screen, see Assign Servers to Clusters inCreating WebLogic Domains Using the Configuration Wizard.

4.2.2.16 Configuring Coherence ClustersUse the Coherence Clusters screen to configure the Coherence cluster.

Leave the default port number as the Coherence cluster listen port. Afterconfiguration, the Coherence cluster is automatically added to the domain.

Note:

Setting the unicast listen port to 0 creates an offset for the Managed Serverport numbers. The offset is 5000, meaning the maximum allowed value thatyou can assign to a Managed Server port number is 60535, instead of 65535.

See Table 5-2 for more information and next steps for configuring Coherence.

Note:

For Coherence licensing information, see Oracle Coherence Products inLicensing Information.

4.2.2.17 Creating a New Oracle Service Bus MachineUse the Machines screen to create new machines in the domain. A machine is requiredso that Node Manager can start and stop servers.

Configuring the Domain

Configuring the Oracle Service Bus Domain 4-15

Page 46: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Tip:

If you plan to create a high availability environment and know the list ofmachines your target topology requires, you can follow the instructions in thissection to create all the machines at this time. For more information, see Optional Scale Out Procedure in High Availability Guide.

To create a new Oracle Service Bus machine so that Node Manager can start and stopservers:

1. Select the Machine tab (for Windows) or the UNIX Machine tab (for UNIX), thenclick Add to create a new machine.

2. In the Name field, specify a machine name, such as osb_machine1.

3. In the Node Manager Listen Address field, select the IP address of the machine inwhich the Managed Servers are being configured.

You must select a specific interface and not localhost. This allows Coherencecluster addresses to be dynamically calculated.

4. Verify the port in the Node Manager Listen Port field.

5. Repeat these steps to add more machines, if required.

Note:

If you are extending an existing domain, you can assign servers to any existingmachine. It is not necessary to create a new machine unless your situationrequires it.

Tip:

For more information about this screen, see Machines in Creating WebLogicDomains Using the Configuration Wizard.

4.2.2.18 Assigning Servers to Oracle Service Bus MachinesUse the Assign Servers to Machines screen to assign the Administration Server andManaged Servers to the new machine you just created.

On the Assign Servers to Machines screen:

1. In the Machines pane, select the machine to which you want to assign the servers,such as osb_machine1.

2. In the Servers pane, assign AdminServer to the selected machine by doing one ofthe following:

• Click once on AdminServer to select it, then click the right arrow to move itbeneath the selected machine in the Machines pane.

• Double-click on AdminServer to move it beneath the selected machine in theMachines pane.

3. Repeat these steps to assign all Managed Servers to their respective machines.

Configuring the Domain

4-16 Installing and Configuring Oracle Service Bus

Page 47: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

The following figure shows a generic example of the Machines pane after ManagedServers for a product are assigned to machines.

Figure 4-2 Assign Managed Servers to Machines

Tip:

For more information about this screen, see Assign Servers to Machines inCreating WebLogic Domains Using the Configuration Wizard.

4.2.2.19 Reviewing Your Configuration Specifications and Configuring the DomainThe Configuration Summary screen shows detailed configuration information for thedomain you are about to create.

Review each item on the screen and verify that the information is correct. To make anychanges, go back to a screen by clicking the Back button or selecting the screen in thenavigation pane. Domain creation does not start until you click Create.

Tip:

For more information about this screen, see Configuration Summary inCreating WebLogic Domains Using the Configuration Wizard.

4.2.2.20 Writing Down Your Domain Home and Administration Server URLThe Configuration Success screen shows information about the domain you justconfigured.

Make a note of the following items because you need them later:

• Domain Location

• Administration Server URL

You need the domain location to access scripts that start Node Manager andAdministration Server, and you need the URL to access the Administration Server.

Click Finish to dismiss the Configuration Wizard.

4.3 Starting the ServersAfter configuration is complete, start Node Manager, then the WebLogicAdministration Server and Managed Servers.

Starting the Servers

Configuring the Oracle Service Bus Domain 4-17

Page 48: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Note:

For more information on additional tools you can use to manage your domain,see Overview of Oracle Fusion Middleware Administration Tools inAdministering Oracle Fusion Middleware.

Starting Node Manager

Starting the Administration Server

Starting the Managed Servers

4.3.1 Starting Node ManagerTo start the per-domain Node Manager:

1. Go to the DOMAIN_HOME/bin directory.

2. Enter the following command:

• (UNIX) Using nohup and nm.out as an example output file:

nohup ./startNodeManager.sh > LOG_DIR/nm.out&

where LOG_DIR is the location of directory in which you want to store the logfiles.

• (Windows) startNodeManager.cmd

Note:

On Windows operating systems, Oracle recommends that you configure NodeManager to run as a startup service. This allows Node Manager to start upautomatically each time the system is restarted.

See Running Node Manager as a Startup Service in Administering NodeManager for Oracle WebLogic Server.

4.3.2 Starting the Administration ServerTo start the Administration Server:

1. Go to the DOMAIN_HOME/bin directory.

2. Enter the following command:

• (UNIX)

./startWebLogic.sh

• (Windows)

startWebLogic.cmd

If you selected Production Mode on the Domain Mode and JDK screen when youcreated the domain, you see a prompt for the Administrator user login credentials asprovided on the Administrator Account screen.

Starting the Servers

4-18 Installing and Configuring Oracle Service Bus

Page 49: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Tip:

For more information about starting the Administration Server, see Startingand Stopping Administration Servers in Administering Oracle FusionMiddleware.

In production mode, a boot identity file can be created to bypass the need toprovide a user name and password when starting the Administration Server.For more information, see Creating a Boot Identity File for an AdministrationServer in Administering Server Startup and Shutdown for Oracle WebLogic Server.

You can verify that the Administration Server is up and running by accessing theAdministration Server Console. The URL is provided on the Configuration Successscreen in Writing Down Your Domain Home and Administration Server URL(http://administration_server_host:administration_server_port/console). The default Administration Server port number is 7001.

Note:

Make sure that the database hosting your product schemas is up and runningand accessible by the Administration Server.

For more information about how to use the Administration Console, see GettingStarted Using Oracle WebLogic Server Administration Console in Administering OracleFusion Middleware.

4.3.3 Starting the Managed ServersTo start the Managed Servers:

1. Log in to Oracle Fusion Middleware Control:

http://administration_server_host:administration_server_port/em

The Administration Server host and port number were in the URL on the End ofConfiguration screen (Writing Down Your Domain Home and AdministrationServer URL). The default Administration Server port number is 7001.

The login credentials were provided on the Administrator Account screen(Configuring the Administrator Account).

2. The Enterprise Manager landing page lists the servers configured for this domainand displays their status (such as Running or Shutdown). For a newly configureddomain, only the AdminServer(admin) will be running.

Select the first Managed Server.

3. Next to the WebLogic Server menu, select Start Up.

4. Repeat Steps 3 and 4 to start all Managed Servers.

5. On the main landing page, verify that all the Managed Servers are up and running.

4.4 Verifying the ConfigurationAfter completing all configuration steps, you can perform additional steps to verifythat your domain is properly configured.

Verifying the Configuration

Configuring the Oracle Service Bus Domain 4-19

Page 50: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

To verify that the domain is configured properly, see Performing Additional DomainConfiguration Tasks.

Verifying the Configuration

4-20 Installing and Configuring Oracle Service Bus

Page 51: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

5Next Steps After Configuring the Domain

After configuring a product domain, there are additional tasks that you may want toperform.

Performing Basic Administrative TasksReview the administrative tasks you will likely want to perform on anew domain.

Performing Additional Domain Configuration TasksReview additional configuration tasks you will likely want to performon a new domain.

Preparing Your Environment for High AvailabilityScaling out for high availability requires additional steps.

5.1 Performing Basic Administrative TasksReview the administrative tasks you will likely want to perform on a new domain.

Table 5-1 Basic Administration Tasks for a New Domain

Task Description More Information

Getting familiar with FusionMiddleware administration tools

Get familiar with various tools thatyou can use to manage yourenvironment.

See Overview of Oracle FusionMiddleware Administration Toolsin Administering Oracle FusionMiddleware.

Starting and stopping products andservers

Learn how to start and stop OracleFusion Middleware, including theAdministration Server, ManagedServers, and components.

See Starting and Stopping OracleFusion Middleware in AdministeringOracle Fusion Middleware.

Configuring Secure Sockets Layer(SSL)

Learn how to set up securecommunications between OracleFusion Middleware componentsusing SSL.

See Configuring SSL in OracleFusion Middleware in AdministeringOracle Fusion Middleware.

Monitoring Oracle FusionMiddleware

Learn how to keep track of thestatus of Oracle Fusion Middlewarecomponents.

See Monitoring Oracle FusionMiddleware in Administering OracleFusion Middleware.

Understanding Backup andRecovery Procedures

Learn recommended backup andrecovery procedures for OracleFusion Middleware.

See Introduction to Backup andRecovery in Administering OracleFusion Middleware.

Next Steps After Configuring the Domain 5-1

Page 52: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table 5-1 (Cont.) Basic Administration Tasks for a New Domain

Task Description More Information

Getting familiar with databasepurging

Get familiar with scheduling andrunning purge jobs thatautomatically remove older flowinstances, adapter reports, and faultalerts data from the database.

See Managing Database Growth inAdministering Oracle SOA Suite andOracle Business Process ManagementSuite.

5.2 Performing Additional Domain Configuration TasksReview additional configuration tasks you will likely want to perform on a newdomain.

Table 5-2 Additional Domain Configuration Tasks

Task Description More Information

Deploying Applications Learn how to deploy yourapplications to Oracle FusionMiddleware.

See Deploying Applications inAdministering Oracle FusionMiddleware.

Adding a Web Tier front-end toyour domain

Oracle Web Tier hosts Web pages(static and dynamic), providessecurity and high performancealong with built-in clustering, loadbalancing, and failover features. Inparticular, the Web Tier containsOracle HTTP Server.

To install and configure OracleHTTP Server in the WebLogicServer domain, see ConfiguringOracle HTTP Server in a WebLogicServer Domain in Installing andConfiguring Oracle HTTP Server.

See also Installing MultipleProducts in the Same Domain forimportant information.

Tuning and configuring Coherencefor your topology

The standard installation topologyincludes a Coherence cluster thatcontains storage-enabled ManagedCoherence Servers. Thisconfiguration is a good startingpoint for using Coherence, butdepending upon your specificrequirements, consider tuning andreconfiguring Coherence toimprove performance in aproduction environment.

For more about Coherence clusters,see Configuring and ManagingCoherence Clusters in AdministeringClusters for Oracle WebLogic Server.

For information on tuningCoherence, see Performance Tuningin Administering Oracle Coherence.

For information on storing HTTPsession data in Coherence, see Using Coherence*Web withWebLogic Server in AdministeringHTTP Session Management withOracle Coherence*Web.

For more about creating anddeploying Coherence applications,see Getting Started in DevelopingOracle Coherence Applications forOracle WebLogic Server.

5.3 Preparing Your Environment for High AvailabilityScaling out for high availability requires additional steps.

Table 5-3 provides a list of tasks to perform if you want to scale out your standardinstallation environment for high availability.

Performing Additional Domain Configuration Tasks

5-2 Installing and Configuring Oracle Service Bus

Page 53: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table 5-3 Tasks Required to Prepare Your Environment for High Availability

Task Description More Information

Scaling out to multiple hostcomputers

To enable high availability, it is important toprovide failover capabilities to another hostcomputer. That way, if one computer goesdown, your environment can continue toserve the consumers of your deployedapplications.

See Scaling Out a Topology(Machine Scaleout) in the HighAvailability Guide.

Configuring high availabilityfor your Web Tiercomponents.

If you have added a Web tier front-end,then you must configure the Web Tier forhigh availability, as well as the WebLogicServer software.

See Configuring High Availabilityfor Web Tier Components in HighAvailability Guide.

Setting up a front-end loadbalancer

A load balancer can be used to distributerequests across servers more evenly.

See Server Load Balancing in aHigh Availability Environmentand Configuring Load BalancerVirtual Server Names and Ports inHigh Availability Guide.

Configuring Node Manager Node Manager enables you to start, shutdown, and restart the Administration Serverand Managed Server instances from aremote location. This document assumesyou have configured a per-domain NodeManager. Review the Node Managerdocumentation for information onadvanced Node Manager configurationoptions and features.

See Advanced Node ManagerConfiguration in AdministeringNode Manager for Oracle WebLogicServer.

Preparing Your Environment for High Availability

Next Steps After Configuring the Domain 5-3

Page 54: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Preparing Your Environment for High Availability

5-4 Installing and Configuring Oracle Service Bus

Page 55: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

6Deinstalling or Reinstalling Oracle Service

Bus

Follow the instructions in this section to deinstall or reinstall Oracle Service Bus.

Oracle recommends that you always use the instructions in this section to remove thesoftware. If you try to remove the software manually, you may encounter problemswhen you try to reinstall the software again at a later time. Following the proceduresin this section ensures that the software is properly removed.

About Product DeinstallationThe Oracle Fusion Middleware deinstaller removes the software fromthe Oracle home directory.

Stopping Oracle Fusion MiddlewareBefore running the deinstaller, Oracle recommends that you stop allservers and processes associated with the Oracle home you are going toremove.

Removing Your Database SchemasBefore you remove the Oracle home, Oracle recommends that you runthe Repository Creation Utility (RCU) to remove database schemasassociated with this domain.

Deinstalling the SoftwareFollow the instructions in this section to start the product deinstaller andremove the software.

Removing the Oracle Home Directory ManuallyAfter deinstalling the software, you must manually remove your Oraclehome directory and any existing subdirectories that the deinstaller didnot remove.

Removing the Program Shortcuts on Windows Operating SystemsOn Windows operating systems, you must also manually remove theprogram shortcuts; the deinstaller does not remove them for you.

Removing the Domain and Application DataAfter deinstalling the software, you must remove the domain andapplication data.

Reinstalling the SoftwareYou can reinstall your software into the same Oracle home as a previousinstallation only if you deinstalled the software by following theinstructions in this section, including manually removing the Oraclehome directory.

Deinstalling or Reinstalling Oracle Service Bus 6-1

Page 56: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

6.1 About Product DeinstallationThe Oracle Fusion Middleware deinstaller removes the software from the Oracle homedirectory.

The following table summarizes the deinstallation procedure and links to supportingdocumentation.

Table 6-1 Roadmap for Product Deinstallation

Task Description Documentation

Stop Oracle Fusion Middleware All servers and processes in yourdomain should be stopped beforerunning the deinstaller.

See Stopping Oracle FusionMiddleware.

Remove your database schemas Run Repository Creation Utility toremove your database schemas.

See Removing Your DatabaseSchemas.

Remove the software Run the product deinstaller toremove Oracle Fusion MiddlewareInfrastructure.

Note that if your Oracle homecontains multiple products, youmust run the deinstaller multipletimes, once for each product.

See Deinstalling the Software.

Remove the Oracle home directory The deinstaller does not remove allfiles and folders from the Oraclehome directory. After thedeinstaller is finished, you mustmanually remove the Oracle hometo complete your product removal.

See Removing the Oracle HomeDirectory Manually.

Remove your domain andapplication data

The deinstaller does not removedata contained in your Domainhome or Application homedirectories, even if they are locatedinside the Oracle home. You mustremove these directories manually.

See Removing the Domain andApplication Data.

6.2 Stopping Oracle Fusion MiddlewareBefore running the deinstaller, Oracle recommends that you stop all servers andprocesses associated with the Oracle home you are going to remove.

For more information, see Stopping an Oracle Fusion Middleware Environment inAdministering Oracle Fusion Middleware.

6.3 Removing Your Database SchemasBefore you remove the Oracle home, Oracle recommends that you run the RepositoryCreation Utility (RCU) to remove database schemas associated with this domain.

Each domain has its own set of schemas, uniquely identified by a custom prefix (see Understanding Custom Prefixes in Creating Schemas with the Repository Creation Utility).This set of schemas cannot be shared with any other domain (see Planning YourSchema Creation in Creating Schemas with the Repository Creation Utility).

About Product Deinstallation

6-2 Installing and Configuring Oracle Service Bus

Page 57: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

If there are multiple sets of schemas on your database, be sure to identify the schemaprefix associated with the domain you are removing.

For schema removal steps, see Dropping Schemas in Creating Schemas with theRepository Creation Utility.

6.4 Deinstalling the SoftwareFollow the instructions in this section to start the product deinstaller and remove thesoftware.

If you want to perform a silent (command-line) deinstallation, see Running the OracleUniversal Installer for Silent Deinstallation in Installing Software with the OracleUniversal Installer.

Starting the Deinstallation Program

Selecting the Product to Deinstall

Navigating the Deinstallation Screens

6.4.1 Starting the Deinstallation ProgramTo start the deinstaller:

• On UNIX

On the command line, enter the following commands:

cd $ORACLE_HOME/oui/bin./deinstall.sh

• On Windows

Do one of the following:

– Use a file manager window to navigate to the ORACLE_HOME\oui\bindirectory and double click on deinstall.cmd.

– Open a command prompt and enter the following commands:

cd %ORACLE_HOME%\oui\bindeinstall.cmd

– From the Start menu, select All Programs, then Oracle, then OracleHome, andthen Uninstall Oracle Software.

6.4.2 Selecting the Product to DeinstallBecause multiple products exist in the Oracle home, ensure that you are deinstallingthe correct product.

After you run the deinstaller, the Distribution to Uninstall screen opens. From thedrop-down list, select ServiceBus 12.2.1.0 and click Uninstall. The deinstallationprogram shows the screens listed in Navigating the Deinstallation Screens.

Deinstalling the Software

Deinstalling or Reinstalling Oracle Service Bus 6-3

Page 58: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Note:

You can deinstall Oracle Fusion Middleware Infrastructure after you deinstallOracle Service Bus software by running the deinstallation wizard again.Before doing so, make sure there are no other products using theInfrastructure; those products will no longer function once the Infrastructureis removed. You will not encounter the Distribution to Uninstall screen if noother software depends on Oracle Fusion Middleware Infrastructure. Fordeinstallation instructions, see Deinstalling Oracle Fusion MiddlewareInfrastructure in Installing and Configuring the Oracle Fusion MiddlewareInfrastructure.

6.4.3 Navigating the Deinstallation ScreensThe deinstaller shows a series of screens to confirm the deinstallation of the software.

If you need more help with a deinstallation screen listed in Table 6-2, click Help on thescreen.

Table 6-2 Deinstallation Screens and Descriptions

Screen Description

Welcome Introduces you to the product deinstaller.

DeinstallationSummary

Shows the Oracle home directory and its contents that will be deinstalled. Verify that thisis the correct directory.

If you want to save these options to a response file, click Save Response File and enter theresponse file location and name. You can use response file later during a silentdeinstallation. For more on silent or command line deinstallation, see Running the OracleUniversal Installer for Silent Deinstallation in Installing Software with the Oracle UniversalInstaller.

Click Deinstall to begin removing the software.

DeinstallationProgress

Shows the deinstallation progress.

DeinstallationComplete

Appears when the deinstallation is complete. Review the information on this screen, thenclick Finish to dismiss the deinstaller.

6.5 Removing the Oracle Home Directory ManuallyAfter deinstalling the software, you must manually remove your Oracle homedirectory and any existing subdirectories that the deinstaller did not remove.

For example, if your Oracle home directory is /home/Oracle/product/ORACLE_HOME on a UNIX operating system, enter the following commands:

cd /home/Oracle/product rm -rf ORACLE_HOME

On a Windows operating system, if your Oracle home directory is C:\Oracle\Product\ORACLE_HOME, use a file manager window and navigate to the C:\Oracle\Product directory, then right-click on the ORACLE_HOME folder and selectDelete.

Removing the Oracle Home Directory Manually

6-4 Installing and Configuring Oracle Service Bus

Page 59: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

6.6 Removing the Program Shortcuts on Windows Operating SystemsOn Windows operating systems, you must also manually remove the programshortcuts; the deinstaller does not remove them for you.

To remove the program shortcuts on Windows:

1. Go to the C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Oracle\ORACLE_HOME\Product directory.

2. If you only have one product installed in your Oracle home, delete theORACLE_HOME directory. If you have multiple products installed in your Oraclehome, delete all products before deleting the ORACLE_HOME directory.

6.7 Removing the Domain and Application DataAfter deinstalling the software, you must remove the domain and application data.

To remove the domain and application data:

1. Manually remove your Domain home directory. For example:

On a UNIX operating system, if your Domain home directory is /home/Oracle/config/domains/osb_domain, enter the following command:

cd /home/Oracle/config/domains rm -rf osb_domain

On a Windows operating system, if your Domain home directory is C:\Oracle\Config\domains\osb_domain, use a file manager window and navigate to theC:\Oracle\Config\domains directory, then right-click on the osb_domainfolder and select Delete.

2. Manually remove your Application home directory. For example:

On a UNIX operating system, if your Application home directory is /home/Oracle/config/applications/osb_domain, enter the following commands:

cd /home/Oracle/config/applications rm -rf osb_domain

On a Windows operating system, if your Application home directory is C:\Oracle\Config\applications\osb_domain, use a file manager windowand navigate to the C:\Oracle\Config\applications directory, then right-click on the osb_domain folder and select Delete.

3. Back up the domain_registry.xml file in your Oracle home, then edit the fileand remove the line associated with the domain you are removing. For example, toremove the osb_domain, find the following line and remove it:

<domain location="/home/Oracle/config/domains/osb_domain"/>

Save and exit the file when you are finished.

6.8 Reinstalling the SoftwareYou can reinstall your software into the same Oracle home as a previous installationonly if you deinstalled the software by following the instructions in this section,including manually removing the Oracle home directory.

Removing the Program Shortcuts on Windows Operating Systems

Deinstalling or Reinstalling Oracle Service Bus 6-5

Page 60: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

When you reinstall, you can then specify the same Oracle home as your previousinstallation.

Consider the following cases where the Oracle home is not empty:

• Installing in an existing Oracle home that contains the same feature sets.

The installer warns you that the Oracle home you specified during installationalready contains the same software you are trying to install.

Your options are:

– Select a different Oracle home directory.

– Select a different installation type. In this case, only the feature sets that do notexist in the Oracle home directory are installed.

– Select a different Oracle home directory.

• Installing in an existing, non-empty Oracle home.

For example, suppose that you chose to create your Domain home or Applicationhome somewhere inside your existing Oracle home. This data is not removedduring the deinstallation process, so if you try to reinstall into the same Oraclehome, the installer does not allow it. Your options are:

1. Deinstall your software from the Oracle home (as this section describes) andthen remove the Oracle home directory. After you deinstall the software andremove the Oracle home directory, you can reinstall and reuse the same Oraclehome location. Any domain or application data that was in the Oracle homemust be re-created.

2. Select a different Oracle home directory.

Reinstalling the Software

6-6 Installing and Configuring Oracle Service Bus

Page 61: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

AOracle Service Bus and Oracle Enterprise

Scheduler Topology

Use this topology to integrate the capabilities of Oracle Enterprise Scheduler withOracle Service Bus.

The topology is similar to the Oracle Service Bus standard installation topology,described in About the Oracle Service Bus Standard Installation Topology. However,in this topology, the Oracle Enterprise Scheduler software is targeted to the OracleWebLogic Server cluster, in addition to the Oracle Fusion Middleware Infrastructureand Oracle Service Bus software.

Oracle Service Bus and Oracle Enterprise Scheduler Topology A-1

Page 62: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

A-2 Installing and Configuring Oracle Service Bus

Page 63: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Roadmap for Installing and Configuring the Oracle Service Bus and OracleEnterprise Scheduler Topology

Table A-1 Installation and Configuration Steps for Oracle Service Bus and Oracle EnterpriseScheduler

Task Description More Information Special Instructions

Verify your systemenvironment

Before beginning theinstallation, verify that theminimum system andnetwork requirements aremet.

See Roadmap forVerifying Your SystemEnvironment.

None.

Obtain the appropriatedistribution

Both Oracle Service Busand Enterprise ScheduleServices require anexisting Oracle FusionMiddleware Infrastructureinstallation; when youinstall Oracle Service Bus,Enterprise ScheduleServices gets installed,too, and Oracle ServiceBus must be installed inthe same Oracle Home asOracle FusionMiddlewareInfrastructure.

See About ProductDistributions.

You must obtain bothOracle FusionMiddleware Infrastructureand Oracle Service Busdistributions.

Determine yourinstallation directories

Verify that the directoriesthat will need to becreated can be created oraccessed by the installer,and exist on systems thatmeet the minimumrequirements.

See What Are the KeyOracle FusionMiddlewareDirectories? inUnderstanding OracleFusion Middleware.

None.

Install Oracle FusionMiddleware Infrastructure

Install Oracle FusionMiddleware Infrastructureto create the Oracle homedirectory for OracleService Bus.

See Installing theInfrastructure Software inInstalling and Configuringthe Oracle FusionMiddleware Infrastructure.

None.

Install the software Install the Oracle ServiceBus software into theexisting InfrastructureOracle home. When youinstall Oracle Service Bus,Enterprise ScheduleServices gets installed too.

See Installing the OracleService Bus Software.

None.

Oracle Service Bus and Oracle Enterprise Scheduler Topology A-3

Page 64: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table A-1 (Cont.) Installation and Configuration Steps for Oracle Service Bus and Oracle EnterpriseScheduler

Task Description More Information Special Instructions

Create a WebLogicdomain

Use the configurationwizard to create andconfigure the WebLogicdomain. Ensure that youselect the appropriateoptions on theconfiguration screens.

See Configuring theOracle Service BusDomain.

Follow the instructionsprovided for specificscreens in Table A-2.

Start the servers Once you complete thedomain creation, start theAdministration andManaged Servers.

See Starting the Servers. Start the Managed serveron which wsm-pm istargeted before you startthe Managed Server onwhich Oracle EnterpriseScheduler is deployed.

Verify the configuration Verify to ensure that thedomain is configuredproperly.

See Verifying theConfiguration.

None.

Next steps after installingand configuring OracleService Bus andEnterprise ScheduleServices

You can performadministrative as well asmanagement tasks for thedomain that you have justconfigured.

See Next Steps AfterConfiguring the Domain.

None.

Configuration Options to Select for the Oracle Service Bus and OracleEnterprise Scheduler

Almost all of the screens and options that you must select while configuring OracleService Bus and Enterprise Schedule Services are identical to the ones providedin Configuring the Domain. However, there are a couple of screens on which youmust select different options. The following table lists the key screens and options.Ensure that you select the configuration options as provided on this table.

Table A-2 Key Screens and Configuration Options for Oracle Service Bus and Enterprise ScheduleServices Topology

Screen Description

Select Components This screen appears when you run RCU to createschemas.

In addition to the schema list provided in Specifying aCustom Prefix and Selecting Schemas, select OracleEnterprise Scheduler.

A-4 Installing and Configuring Oracle Service Bus

Page 65: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table A-2 (Cont.) Key Screens and Configuration Options for Oracle Service Bus and EnterpriseSchedule Services Topology

Screen Description

Templates This screen appears after you start the configurationwizard to create your domain.

In addition to the templates listed in Selecting theConfiguration Templates for Oracle Service Bus, selectthe following templates:

• Oracle Enterprise Scheduler Service Basic - 12.2.1.0[oracle_common]

• Oracle Enterprise Manager Plugin for ESS - 12.2.1.0[em]

Managed Servers On the Managed Servers screen (Configuring ManagedServers for Oracle Service Bus), two managedservers, osb_server1 and ess_server1, are created.Delete ess_server1 and create osb_server2. Ensure thatin the Listen Address drop-down list, you select the IPaddress of the host on which the Managed Server willreside. Do not use All Local Addresses.

In the Server Groups drop-down list, ensurethat osb_server1 and osb_server2are targeted to OSB-MGD-SVRS_COMBINED and ESS_MGD_SVRS.

Assign Servers to Clusters On this screen (Assigning Oracle Service Bus ManagedServers to the Cluster), assignboth osb_server1 and osb_server2 to osb_cluster1.

Assign Servers to Machine On this screen (Assigning Servers to Oracle Service BusMachines), assign the AdminServer, osb_server1 andosb_server2 to osb_machine1.

Oracle Service Bus and Oracle Enterprise Scheduler TopologyUse this topology to integrate the capabilities of Oracle EnterpriseScheduler with Oracle Service Bus.

A.1 Oracle Service Bus and Oracle Enterprise Scheduler TopologyUse this topology to integrate the capabilities of Oracle Enterprise Scheduler withOracle Service Bus.

The topology is similar to the Oracle Service Bus standard installation topology,described in About the Oracle Service Bus Standard Installation Topology; however, inthis topology, the Oracle Enterprise Scheduler software is targeted to the OracleWebLogic Server cluster, in addition to the Oracle Fusion Middleware Infrastructureand Oracle Service Bus software.

Oracle Service Bus and Oracle Enterprise Scheduler Topology

Oracle Service Bus and Oracle Enterprise Scheduler Topology A-5

Page 66: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Roadmap for Installing and Configuring the Oracle Service Bus and OracleEnterprise Scheduler Topology

Table A-3 Installation and Configuration Steps for Oracle Service Bus and Oracle EnterpriseScheduler

Task Description More Information Special Instructions

Oracle Service Bus and Oracle Enterprise Scheduler Topology

A-6 Installing and Configuring Oracle Service Bus

Page 67: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table A-3 (Cont.) Installation and Configuration Steps for Oracle Service Bus and Oracle EnterpriseScheduler

Verify your systemenvironment

Before beginning theinstallation, verify that theminimum system andnetwork requirements aremet.

See Roadmap forVerifying Your SystemEnvironment.

None.

Obtain the appropriatedistribution

Both Oracle Service Busand Enterprise ScheduleServices require anexisting Oracle FusionMiddleware Infrastructureinstallation; when youinstall Oracle Service Bus,Enterprise ScheduleServices gets installed,too, and Oracle ServiceBus must be installed inthe same Oracle Home asOracle FusionMiddlewareInfrastructure.

See About ProductDistributions.

You must obtain bothOracle FusionMiddleware Infrastructureand Oracle Service Busdistributions.

Determine yourinstallation directories

Verify that the directoriesthat will need to becreated can be created oraccessed by the installer,and exist on systems thatmeet the minimumrequirements.

See What are the KeyOracle FusionMiddlewareDirectories? inUnderstanding OracleFusion Middleware.

None.

Install Oracle FusionMiddleware Infrastructure

Install Oracle FusionMiddleware Infrastructureto create the Oracle homedirectory for OracleService Bus.

See Installing andConfiguring the OracleFusion MiddlewareInfrastructure.

None.

Install the software Install the Oracle ServiceBus software into theexisting InfrastructureOracle home. When youinstall Oracle Service Bus,Enterprise ScheduleServices gets installed too.

See Installing the OracleService Bus Software.

None.

Create a WebLogicdomain

Use the configurationwizard to create andconfigure the WebLogicdomain. Ensure that youselect the appropriateoptions on theconfiguration screens.

See Configuring theOracle Service BusDomain.

Follow the instructionsprovided for specificscreens in Table A-4.

Oracle Service Bus and Oracle Enterprise Scheduler Topology

Oracle Service Bus and Oracle Enterprise Scheduler Topology A-7

Page 68: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table A-3 (Cont.) Installation and Configuration Steps for Oracle Service Bus and Oracle EnterpriseScheduler

Start the servers Once you complete thedomain creation, start theAdministration andManaged Servers.

See Starting the Servers. Start the Managed serveron which wsm-pm istargeted before you startthe Managed Server onwhich Oracle EnterpriseScheduler is deployed.

Verify the configuration Verify to ensure that thedomain is configuredproperly.

See Verifying theConfiguration.

None.

Next steps after installingand configuring OracleService Bus andEnterprise ScheduleServices

You can performadministrative as well asmanagement tasks for thedomain that you have justconfigured.

See Next Steps AfterConfiguring the Domain.

None.

Configuration Options to Select for the Oracle Service Bus and OracleEnterprise Scheduler

Almost all of the screens and options that you must select while configuring OracleService Bus and Enterprise Schedule Services are identical to those providedin Configuring the Domain. However, there are a couple of screens on which youmust select different options. The following table lists the key screens and options.Ensure that you select the configuration options as provided on this table.

Table A-4 Key Screens and Configuration Options for Oracle Service Bus and Enterprise ScheduleServices Topology

Screen Description

Select Components This screen appears when you run RCU to createschemas.

In addition to the schema list provided in Specifying aCustom Prefix and Selecting Schemas, select OracleEnterprise Scheduler.

Templates This screen appears after you start the configurationwizard to create your domain.

In addition to the templates listed in Selecting theConfiguration Templates for Oracle Service Bus, selectthe following templates:

• Oracle Enterprise Scheduler Services Basic - 12.2.1[oracle_common]

• Oracle Enterprise Manager Plugin for ESS - 12.2.1[em]

Oracle Service Bus and Oracle Enterprise Scheduler Topology

A-8 Installing and Configuring Oracle Service Bus

Page 69: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Table A-4 (Cont.) Key Screens and Configuration Options for Oracle Service Bus and EnterpriseSchedule Services Topology

Managed Servers On this screen, two managed servers arecreated: osb_server1 and ess_server1.Delete ess_server1 and create osb_server2.

Ensure that in the Listen Address drop-down list, youselect the IP address of the host on which the ManagedServer will reside. Do not use All LocalAddresses.

In the Server Groups drop-down list, ensurethat osb_server1 and osb_server2 are targetedto OSB-MGD-SVRS_COMBINED and ESS_MGD_SVRS.

Assign Servers to Clusters On this screen, assignboth osb_server1 and osb_server2 toosb_cluster1.

Assign Servers to Machine On this screen, assign theAdminServer, osb_server1, andosb_server2 to osb_machine1.

Oracle Service Bus and Oracle Enterprise Scheduler Topology

Oracle Service Bus and Oracle Enterprise Scheduler Topology A-9

Page 70: Oracle Fusion Middleware · 2017-11-16 · Oracle® Fusion Middleware Installing and Configuring Oracle Service Bus 12c (12.2.1) E57276-05 October 2016 Documentation for installers

Oracle Service Bus and Oracle Enterprise Scheduler Topology

A-10 Installing and Configuring Oracle Service Bus