208759373 soa admin guide

7/13/2019 208759373 SOA Admin Guide

1/154

RISENSHINETECHNOLOGIESFlat#403,KoushikSaiRamaResidency,BesideICICIBankLane,SRNagar.

Ph:04065574999,9010505808

www.risenshinetechnologies.com www.weblogicandsoaadmin.blogspot.in

SOA11gAdminGuide

By

Venkat

7/13/2019 208759373 SOA Admin Guide

2/154


Ph:04065574999,9010505808


Chapter1:Introduction

Chapter2:SOAInstallation

1)InstallationOverview

1.1OracleSOASuiteComponents

1.2Oracle

SOA

Suite

Installation

Roadmap

2)PrerequisitesChecking:

a) MemoryandDiskSpaceRequirements

b) Checkyourbrowser

c) CheckyourJDK

3)Installations

a) Installthedatabase

b) InstallWeblogicserver

c)

Installdatabase

schema

using

RCU

d) InstallSOASuiteBaseComponents

4)CreateaSOADomain

4.1UsingDefaultSettingsforManagedServers

4.2OracleBPMSuite

4.3OracleBPMSuiteforDevelopers

4.4OracleSOASuite

4.5OracleSOASuiteforDevelopers

4.6OracleBusinessActivityMonitoring

4.6.1 ManualConfigurationforOracleBAM

4.6.2ConfiguringOracleBAMwithCustomPortNumbers

4.7ApplyingJavaRequiredFiles(JRF)

4.8ProtectingUpdatestoYourSOAConfiguration

5)StartingtheServers

6) StartingNodeManager

7) VerifyingtheInstallationandConfiguration

Chapter3:NavigationofSOAInfrastructure

a)NavigatetheSOAInfrastructureHomePageandMenu

b)NavigatetheSOACompositeApplicationHomePageandMenu

c)NavigatingThroughthePartitionHomePageandMenu

7/13/2019 208759373 SOA Admin Guide

3/154


Ph:04065574999,9010505808


d)NavigatingtoDeployedJavaEEApplications

e)NavigatingtotheOracleWLServerAdminConsoleandOtherPages

f)NavigatingtoSOAInfraorSOACompositeApplicationHomePage

g)LoggingOutofOracleEnterpriseManager

Chapter4:

SOA

Infrastructure

Partitions

a) CreatingandDeletingPartitions

b)PerformingBulkLifecycleMgmt.TasksonCompositeinPartitions

Chapter5:ConfiguringLogFiles

Chapter6:DeployingSOAApplications

a)DeploymentofSOAApplications

b)RedeployingSOAApplications

c)UndeployingSOAApplications

Chapter7:

Testing

the

Web

Service

Chapter8:HumanWorkflow

Chapter9:OracleBAM

WhatisBAM?

HowdoesBAMinterfacewithotherSOAapplications?

Stepstoimplementusecase:

1.CreateEmployeeDataObject

2.CreateBAMReport

3.ConfigureBAMAdapter

4.DeploytheBAMApplication

Chapter10:OracleServiceBUS

Chapter11:AdministeringBPELProcessServiceComponentsandEngines

a)ConfiguringBPELProcessServiceComponentsandEngines

i)ConfiguringBPELProcessServiceEngineProperties

ii)ConfiguringAutomaticRecoveryforBPELProcessManager

iii)ConfigAutoRecoveryAttemptsforInvokeandCallbackMsgs

iv)SettingtheAuditLevelattheBPELProcessServiceLevel

b) MonitoringBPELProcessServiceComponentsandEngines

c) MonitoringBPELProcessServiceComponentInstancesandFaults

7/13/2019 208759373 SOA Admin Guide

4/154

Oracle F

acquired,

products

hasmana

OracleFu

categorie

1. D

d

2. B

a

3. U

s

4. I

c

e

It is imp

independ

preinteg

Given t

Middlew

OracleSO

Suiteand

Oracle B

based de

building

Flat#40

www.rise

sion Middle

that will hel

underonero

gedtodoit

sionMiddle

s:

ata and App

atabases,leg

usinessProc

pplicationla

serInterface

pportingmu

entityMana

n easily pl

nvironment.

ortant to n

ently. But m

rated,creatin

e no. of

re:Business

A Suite11g

theirdescrip

EL Process

clarative lan

lock of thes

R

,KoushikSa

nshinetechn

areconsist

p build end

of.Withrec

rettywell.

areprovide

lication Laye

acy/custom

ssLayer:Pr

ertocreate

Layer:Prod

ltipledeliver

gementLaye

gin authen

te that mo

ajorvalue a

ggreatersy

products i

Processlaye

is the produ

tiongivenb

Manager: B

guage that

e processes

ISENSHIN

iRamaResid

h:0406557

logies.com

Chapter1

of several

to end solut

ntreleaseo

fullyintegra

r: Products

pplications

ducts inthi

eusableorc

ctsinUILay

ychannelss

r:Thisisthe

ication, aut

t of the pr

dition of Fu

ergyandre

nvolved, th

.

ct set for B

low:

EL stands f

can be used

is a service,

ETECHNOL

ency,Beside

4999,90105

www.weblo

:Introduc

Oracle prod

ions. Oracle

OracleFusi

tedproducts

in this categ

ndERPprod

categoryut

hestratedse

erwillassist

chasweb,

securitybac

horization in

oducts in e

sion Middle

usability.

is blog fo

siness Layer

rBusinessP

implement

which could

OGIES

ICICIBankLa

5808

icandsoaad

ion

cts, built o

has been at

nMiddlewa

thatcanbe

ory help bui

ucts.

ilizetheinte

vices.

increatings

obileetc.,

kboneofent

standalone

ch of thes

are is that

uses on t

. Individual

rocessExecu

end to end

be a web s

ne,SRNagar

in.blogspot.

er the year

empting to

re11gR1,I

dividedinto

ld integratio

grationsbuil

phisticated

ireFusionM

and/or dist

layers can

ost of thes

he backbo

constituents

tionLanguag

business pr

rvice. BPEL

.

in

s and recent

bring all the

ustsaythat

ourimporta

n with vario

inthedata

userinterfac

iddleware.

ributed serv

also be us

products a

e of Fusi

of OracleS

e. It is a X

ocesses. Bas

tilizes vario

ly

se

it

nt

s

&

es

e

er

d

re

n

A

L

ic

s

7/13/2019 208759373 SOA Admin Guide

5/154


Ph:04065574999,9010505808


adapters to service enable legacy and custom applications before consuming them in processes.

BPELalsoprovideshumanworkflowthathasvarietyofuses.

OracleServiceBus:OSBisanenterpriselevelservicebusthatwasoriginallypartofWeblogicbefore

acquisition. OSB offers very useful features for service virtualization, canonical models and very

efficient payload transformations. OSB is normally used to complement Oracle BPEL Process

Manager.

OracleBusinessActivityMonitoring:BAMisarealtimeservicemonitoringtoolthatcanbeusedto

trackanendtoendprocesscreatedbyBPEL/OSB.BAMoffersrealtimedashboardsthatcanbehelp

diagnosepotentialbottlenecks intheprocessesbeforetheyoccur.BAMcanbeeasilyplugged into

BPELPMusingsimpleintegration.

OracleBusinessRules:Asthenamesuggests,itsaproducttocreateandusebusinessrules.Thiscan

actascentral repository forvariousruleartefactsandthus facilitate greater reusability. Itcanbe

easilyintegratedwithrestofFusionMiddlewareproducts.

Oracle

B2B

Integration:

Used

to

connect

with

trading

partners

using

industry

standard

protocols

suchasRosettaNet,EDIFACTetc.,itcaninterfacewithEBusinessSuiteusingXMLGatewayandrest

ofFusionMiddlewareusingIPQueues.

Together,aboveproductscanbeusedtodefineandimplementServiceOrientedArchitecture.

7/13/2019 208759373 SOA Admin Guide

6/154


Ph:04065574999,9010505808


Chapter2:SOAInstallation

1InstallationOverview

OracleSOASuiteisamiddlewarecomponentofOracleFusionMiddleware.OracleSOASuiteenables

services to be created, managed, and orchestrated into SOAcomposite applications. Composites

enableyou

to

easily

assemble

multiple

technologycomponents

into

one

SOA

composite

application.

OracleSOASuiteplugs intoheterogeneous infrastructuresandenablesenterprisesto incrementally

adoptSOA.

OracleBusinessProcessManagementSuiteprovidesacompletesetoftoolsforcreating,executing,

andoptimizingbusinessprocesses.

Thischapterincludesthefollowingsections:

1.1OracleSOASuiteComponents 1.2OracleSOASuiteInstallationRoadmap

1.1Oracle

SOA

Suite

Components

OracleSOASuitecontainsthefollowingcomponents:

Oracle Business Process Execution Language (BPEL) Process Manager (PM), withMediator, Rules,

B2B,and Human WorkflowOracle BPEL is an XMLbased language for enablingtask sharing across

multipleenterprisesusingacombinationofWebservices.BPELisbasedontheXMLschema;simple

objectsaccessprotocol(SOAP),andWebservicesdescriptionlanguage(WSDL).

OracleBPELProcessManagerprovidesaframeworkforeasilydesigning,deploying,monitoring,and

administeringprocessesbasedonBPELstandards.

OracleBusiness

Activity

Monitoring

(BAM):

Oracle BAM provides a framework for creating dashboards that display realtimedata inflow and

creatingrulestosendalertsunderspecifiedconditions.

OracleBusinessProcessManagementSuite(BPM):

Thisproductprovidesasetoftoolsforcreating,executing,andoptimizingbusinessprocesses.

1.2OracleSOASuiteInstallationRoadmap

Figure11showsthedirectorystructureofasimpleOracleSOASuite installationonasinglehost,

usingall

of

the

default

values.

7/13/2019 208759373 SOA Admin Guide

7/154


Ph:04065574999,9010505808


Figure11DirectoryStructureofOracleSOASuiteInstallation

2PrerequisitesChecking:

a) MemoryandDiskSpaceRequirementsThesoftwarerequiresaminimumof3GBavailablememorytorun,butmore isrecommended. If

you have less, separate the installation of the database, servers, and JDeveloper to different

machines.IfyouinstallSOASuitewithoutOracleServiceBus,youneedabout4.81GBofdiskspace

to download the install files plus about 5.15 GB to install everything. Your database takes an

additional5GB

(or

so,

depending

on

your

configuration).

OracleServiceBuswilladdabout1.2GBofdiskspace.

b) CheckyourbrowserEnterpriseManagerrequiresFirefox3,Safari4+orIE7+.

BAMrequiresIE7or8

IE 7 without special plugins (theres a Prosearch plugin and Microsoft Internet Explorer

KnowledgeBaseUpdate(KB2416400)thatcausesproblems).

IE6hasafewUIissues.Firefoxdoesnotwork.

c) CheckyourJDKTheWeblogicserver installationexe ispackagedwithaJDK.TheJDeveloperexealsocomeswitha

JDK.

7/13/2019 208759373 SOA Admin Guide

8/154


Ph:04065574999,9010505808


If you aregoing to install Weblogic server and JDeveloper on the samemachine, youuse the JDK

fromWeblogic for JDevelopertoo.However, ifyouaregoingto installonseparatemachines,you

need to have JDK 6.0 Update 24 for Windows for Developer, available at

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

3)Installation:

NowyouhaveallofthefilesrequiredfortheinstallationofSOASuite11.1.1.5.0,exceptpossiblythe

database.Thefirststepistoconfirmyourdatabaseinstallationandinstalladatabaseifnecessary.

a) Installthedatabase

Determinewhichdatabaseversionyouhavealready,ifany,andthendecidewhichdatabase

versionyouwilluseforyourSOAinstallation.

OracleDatabaseistherecommendeddatabaseforSOASuitedeployments.

Oracle ExpressEdition (XE) 10.2.0.1 does notmeet the minimum version requirement for

supporteduse,butwillgenerallyworkinapersonaldevelopmentenvironment.

Youneedoneof

XEUniversal

or

Standard

database

version

10.2.0.1,

or

Oracle10gdatabaseversion10.2.0.4+or

Oracle11gdatabaseversion11.1.0.7+or11.2.0.1+

YoumayseeproblemswithinstallingXEwhenyoualreadyhave10ginstalledonWindows.

TheWindowsregistrysometimesgetsthedatabasefile locationsconfused. Ifyouneedto

uninstalladatabase,youshouldfollowtheinstructions.

IfyouneedtouninstallXE,besuretofollowtheseinstructions

OracleDatabase

Express

Edition

Installation

Guide

10gRelease2(10.2)forMicrosoftWindows

PartNumberB2514303,Section7DeinstallingOracleDatabaseXE.

7/13/2019 208759373 SOA Admin Guide

9/154


Ph:04065574999,9010505808


7/13/2019 208759373 SOA Admin Guide

10/154


Ph:04065574999,9010505808


7/13/2019 208759373 SOA Admin Guide

11/154


Ph:04065574999,9010505808


7/13/2019 208759373 SOA Admin Guide

12/154


Ph:04065574999,9010505808


WhenyouareusingOracleXE,youmustupdatedatabaseparameters ifyouhaveneverdonethis

for your database installation. You only have to do this once after installing. Set the processes

parameterto>=300asfollows.

Theshutdowncommandcantakeafewminutes.Sometimestheshutdown/startupcommandfails.

Inthatcase,simplyrestarttheXEservice intheControlPanel/AdministrativeTools/Servicesdialog

aftersettingyourparameters.

7/13/2019 208759373 SOA Admin Guide

13/154


Ph:04065574999,9010505808


b) InstallWeblogicserver

7/13/2019 208759373 SOA Admin Guide

14/154


Ph:04065574999,9010505808


Onceyour

database

is

ready,

you

can

install

the

next

step,

the

Weblogic

server.

If you have installed SOA 11g before and want to install again in the same location, you must

uninstallthepreviousonefirst.Seethesectionattheendofthisdocumentonuninstalling.

You can choose whether to install Weblogic Server without OEPE, or to install the version that

includesOEPE,dependingonyourusecase.

Whenyouarereadytoinstall,completethefollowing.

Openacommandwindowandenter

cd c:\stageFMW wls1035_win32.exe or wls1035_oepe111172_win32.exe (For OSB and OEPE

installation)

When

the

install

wizard

comes

up,

click

next

7/13/2019 208759373 SOA Admin Guide

15/154


Ph:04065574999,9010505808


SelectcreateanewMiddlewareHomeandenterD:\Middleware_SOA

ClickNext

Enter email to register for security alerts or deselect the checkbox and decline whichever you

prefer,clickNext

7/13/2019 208759373 SOA Admin Guide

16/154


Ph:04065574999,9010505808


Selectcustom,clickNext

7/13/2019 208759373 SOA Admin Guide

17/154


Ph:04065574999,9010505808


Review installation directories (when installing OEPE, there will be a third directory Oracle

EnterprisePack

for

Eclipse)

7/13/2019 208759373 SOA Admin Guide

18/154


Ph:04065574999,9010505808


ClickNext

SelectNodeManagerServiceasNo,clickNext

ClickNext

SelectAllUsersStartMenufolder,clickNext

Reviewsummary

7/13/2019 208759373 SOA Admin Guide

19/154


Ph:04065574999,9010505808


Whentheinstalliscomplete,deselectRunQuickstartcheckboxandclickDone.

7/13/2019 208759373 SOA Admin Guide

20/154


Ph:04065574999,9010505808


c)

Install

database

schema

using

RCU

Nowitistimetosetupthedatabaseschema.

If you have installed SOA 11g before and you are not upgrading, you must drop your existing

database schema before reinstalling or create a second schema for this installation. You cannot

reuse an existing schema. See the section in this document on uninstalling to drop an existing

schema.Afteryoudroptheexistingschema,comebackheretoconfigurethenewschema.

VERYIMPORTANTNOTE!!!!!!!

If you are using Oracle XE as your database, you need to set the RCU_JDBC_TRIM_BLOCKS

environmentvariabletoTRUEpriortorunningRCU.

setRCU_JDBC_TRIM_BLOCKS=TRUEecho%RCU_JDBC_TRIM_BLOCKS%

If you dont do this, you will run into problems that you might only realize when you start your

implementation.

ConfigureSchema

Nowcreatethenewschema.Openacommandwindowandenterthefollowing.

7/13/2019 208759373 SOA Admin Guide

21/154


Ph:04065574999,9010505808


cdc:\stageFMW\RCU\rcuHome\BINrcu.bat

TheRepositoryCreationUtilityopens.

Onthewelcomescreen,clickNextandselectCreate

ClickNextandEnterthedatabaseinformation

7/13/2019 208759373 SOA Admin Guide

22/154


Ph:04065574999,9010505808


ClickNext

IfyouareusingXE,youwillseeoneortwowarningswhenyouinstalltheschemathatthisversionis

toooldandisusingthewrongcharacterset.

You can safely ignore these warnings for your evaluation installation. If you wish to use extended

charactersetsyoumustuseXEUniversal.

Theprerequisitesarereviewed.

Whencomplete,clickOK.Theutilitymovestothenextpagewithaslightdelay,justwaitforit.

On

the

Select

Components

screen,

enter

DEV

in

the

field

for

creating

a

new

prefix.

SelectthecomponentSOAandBPMInfrastructure.Dependentschemasareselectedautomatically.

Ifyouchoosetoselectothercomponents,theseinstallinstructionsmaynotmatchyourexperience.

Also,youmayhavetoincreaseprocessesinXE(youwillgetamessagetellingyouwhatisrequired).

7/13/2019 208759373 SOA Admin Guide

23/154


Ph:04065574999,9010505808


ClickNext

Theprerequisitesforthissteparechecked.Whencompleted,clickOK.

7/13/2019 208759373 SOA Admin Guide

24/154


Ph:04065574999,9010505808


SelecttheradiobuttontoUsethesamepasswordforallschemas.Enteraschemapassword.The

passwordwelcome1isassumedinthisdocument,butyoushouldchooseyourownsecurepassword

or a different one for each schema and be sure to record your passwords as you will need them

later.

ClickNext

Reviewthe

tablespaces

and

schema

owners

for

the

components

7/13/2019 208759373 SOA Admin Guide

25/154


Ph:04065574999,9010505808


Whentheprerequisitesforthissteparecompleted,clickOK

7/13/2019 208759373 SOA Admin Guide

26/154


Ph:04065574999,9010505808


ClickCreatetocreatethetables.

7/13/2019 208759373 SOA Admin Guide

27/154


Ph:04065574999,9010505808


d) InstallSOASuiteBaseComponents

Oncetheschemahasbeencreated,youarereadytoinstalltheSOAserver.

LocatetheJDKdirectorypathwithinthe installedmiddlewarehome.Youusethispath inthenext

command.TheJDKlocationisjdk160_24.

Inacommandwindowenter

cdc:\stageFMW\SOA\Disk1setupjreLocD:\Middleware_SOA\jdk160_24

Whentheinstallwizardwelcomescreencomesup,clickNext

SelectSkipSoftwareUpdatesandclickNext

7/13/2019 208759373 SOA Admin Guide

28/154


Ph:04065574999,9010505808


Waitfor

the

pre

requisite

check

to

complete

(its

quick!)

ClickNext

OntheSpecifyInstallationLocationscreen,selecttheMiddlewarehome:D:\Middleware_SOA

Accept the default Oracle home: Oracle_SOA1 If you use a different Oracle home then adjust

accordinglywhenOracle_SOA1isreferencedthroughoutthisdocument.

7/13/2019 208759373 SOA Admin Guide

29/154


Ph:04065574999,9010505808


ClickNext

Acceptthe

default

on

the

Application

Server

page

and

click

Next

Reviewsummary

ClickInstall

Waitfortheinstalltocomplete

7/13/2019 208759373 SOA Admin Guide

30/154


Ph:04065574999,9010505808


ClickNext

7/13/2019 208759373 SOA Admin Guide

31/154


Ph:04065574999,9010505808


4)CreateaSOADomain:

ConfigurationInstructions

Afterthe installation iscomplete,youmustconfigureanewWeblogicdomain,andchoose

theproductsthatyouwanttoconfigureinthatdomain.

IfyouareusingOracleWeblogicServerasyourapplicationserver,youcreateadomainby

runningtheOracleFusionMiddlewareConfigurationWizard.

Dependingontheoptionsyouchooseduringconfiguration,thisnewdomainwillcontainthe

Administration

Server

and

may

contain

other

Managed

Servers.After

you

have

created

a

new domain, you can later extend that domain if you want toadd more products to that

domain.

Note:OnceyouhaveconfiguredadomainforOracleBusinessProcessManagement,youcan

no longercreateanotherdomain in thesameOraclehomethatcontainsOracleSOASuite

only. An OracleSOA Suite domain that does not contain Oracle Business

ProcessManagement cannot share the same Oracle home as an OracleBusiness Process

Managementdomain.

4.1Using

Default

Settings

for

Managed

Servers

Duringtheconfiguration,theOracleFusionMiddlewareConfigurationWizardautomatically

createsManagedServersinthedomaintohosttheFusionMiddlewaresystemcomponents.

Oracle recommends that you use the default configurationsettings for these Managed

Servers. If you modify the default configuration settings, then you will have to perform

7/13/2019 208759373 SOA Admin Guide

32/154


Ph:04065574999,9010505808


some manual configuration steps before the Fusion Middleware environment can be

started.

Depending on your selections, the following Managed Servers (default names shown)are

created:

soa_server1

Hosts

Oracle

SOA

bam_server1 HostsOracleBAM

ManagedServerpropertiescanbeconfiguredontheConfigureManagedServersscreen.

OnUNIXoperatingsystems:cdSOA_ORACLE_HOME/common/bin

./config.sh

OnWindowsoperatingsystems:cdSOA_ORACLE_HOME\common\bin

config.cmd

ConfigurationLogFiles

To create a log file for your configuration session, use the log=log_filenameparameter when you

starttheConfigurationWizard.

OnUNIXoperatingsystems:./config.shlog=log_filename

OnWindowsoperatingsystems:config.cmdlog=log_filename

LogfilesofyourconfigurationsessionarecreatedinthelogsdirectoryinsideyourMiddlewarehome.

Whenthe

configuration

wizard

welcome

screen

comes

up,

select

Create

anew

WebLogic

domain,

clickNext

7/13/2019 208759373 SOA Admin Guide

33/154


Ph:04065574999,9010505808


4.2OracleBPMSuite

To create a domain configured with Oracle BPM Suite, start the Configuration Wizardand select

OracleBPMSuite 11.1.1.0[SOA_ORACLE_HOME]ontheSelectDomainSourcescreen:

7/13/2019 208759373 SOA Admin Guide

34/154


Ph:04065574999,9010505808


Thefollowingtemplatesareselectedasdependencies:

OracleSOASuite 11.1.1.0[SOA_ORACLE_HOME]

OracleWSMPolicyManager 11.1.1.0[oracle_common]

OracleJRF 11.1.1.0[oracle_common]

Thefollowingserversarecreated:

AdministrationServer

soa_server1

4.3OracleBPMSuiteforDevelopers

TocreateadomainconfiguredwithOracleBPMSuitefordevelopers,starttheConfigurationWizard

andselectOracleBPMSuitefordevelopers 11.1.1.0[SOA_ORACLE_HOME]ontheSelectDomain

Sourcescreen:


OracleSOA

Suite

for

developers

11.1.1.0

[SOA_ORACLE_HOME]



7/13/2019 208759373 SOA Admin Guide

35/154


Ph:04065574999,9010505808


ThesetemplatesdonotcreateanManagedServers;onlyasingleAdministrationServeriscreatedfor

thedomain.

4.4OracleSOASuite

To create a domain configured with Oracle SOA Suite, start the Configuration Wizardand select

OracleSOA

Suite

11.1.1.0

[SOA_ORACLE_HOME]

on

the

Select

DomainSource

screen:






soa_server1

4.5OracleSOASuiteforDevelopers

TocreateadomainconfiguredwithOracleSOASuitefordevelopers,starttheConfigurationWizard

andselectOracleSOASuitefordevelopers 11.1.1.0[SOA_ORACLE_HOME]ontheSelectDomain

Sourcescreen:

7/13/2019 208759373 SOA Admin Guide

36/154


Ph:04065574999,9010505808





ThesetemplatesdonotcreateanManagedServers;onlyasingleAdministrationServeriscreatedfor

thedomain.

4.6OracleBusinessActivityMonitoring

To

create

a

domain

configured

with

Oracle

Business

Activity

Monitoring,

start

theConfiguration

Wizard and select Oracle Business Activity Monitoring 11.1.1.0[SOA_ORACLE_HOME] on the

SelectDomainSourcescreen:

7/13/2019 208759373 SOA Admin Guide

37/154


Ph:04065574999,9010505808







bam_server1

ClickNext

Enterthedomainname,e.g.SOAOSBPS4Domainandchoosealocationofyourchoice

7/13/2019 208759373 SOA Admin Guide

38/154


Ph:04065574999,9010505808


ClickNext

Enterusernameweblogicandapassword.Thepasswordwelcome01isassumedinthisdocument,

butyoushouldchooseyourownsecurepasswordandrememberitforlaterinthedocumentwhen

thepasswordisreferenced.

ClickNext

Select the Sun SDK and leave Development Mode checked (we recommend the Sun SDK fordevelopmentonWindowsasitprovidesfasterstartuptimes).

7/13/2019 208759373 SOA Admin Guide

39/154


Ph:04065574999,9010505808


ClickNext

On the Configure JDBC Component Schema screen, you select the components that you want to

change,andthenenterthepropertyvalueforthosecomponents.

First,selectallofthecomponentsand enterwelcome1 forthepassword intheSchemaPassword

field. Or, if you used a different password when you created the schema with RCU, enter that

password.

Withallofthecheckboxesstillselected,entertheService,Host,andPortvalues.

7/13/2019 208759373 SOA Admin Guide

40/154


Ph:04065574999,9010505808


Now,lookatthetable.ReviewtheSchemaOwnercolumnandconfirmthatthevaluesarethesame

aswhatyouconfiguredintheConfigureSchemasectionofthisdocumentwhenyourantheRCU.Gobackandreviewthescreenshotsinthatsectionofthisdocumentfortheschemaownersifyoudo

notrememberthem.

Completethefollowingstepsiftheschemaownersneedtobeupdated,e.g,MDS:

a.Deselectallthecomponentcheckboxes

b.SelectMDSSchemaonly.

c.EntertheSchemaOwner,MY_ORAMDS(orasappropriate)

d.Next,deselectMDSSchemaandselectthenextone.

e.Entertheschemaownersonebyonebyprependingthecorrectprefixtothedefaultedvalue.

f.Continueuntilallschemaownersareentered.

ClickNext.

Thedatasourceconnectionsarealltested.

7/13/2019 208759373 SOA Admin Guide

41/154


Ph:04065574999,9010505808


Ifallaresuccessful,clickNext,otherwiseclickPreviousandcorrectanyerrors.

Nowyoumustchoosewhethertohaveyourserverrunasamanagedserveror inasingleserver

configuration.

Aswehavechosenthedevelopersconfiguration,therewillbeoneadminserverandone(optional)

managedserverforBAM.

DontcheckanyoftheboxeshereandclickNext,unlessyouwanttomakechangestothedefault

configuration

7/13/2019 208759373 SOA Admin Guide

42/154


Ph:04065574999,9010505808


ClickonNext

ThisisthesummarypagefortheConfiguration.ClickCreatetocreatethedomain.

Waitforthecreatetofinishtakesjustaminute

ChecktheboxtostarttheadminserverandClickDone.Yourserverisnowinstalled

7/13/2019 208759373 SOA Admin Guide

43/154


Ph:04065574999,9010505808


4.6.1ManualConfigurationforOracleBAM

Dependingonyourconfigurationoptionsandenvironment,OracleBAMmayrequiresomecustom

configurationsteps,asdescribedinthissection.

4.6.2ConfiguringOracleBAMwithCustomPortNumbers

ThedefaultportnumberoftheOracleBAMmanagedserver(bam_server1)is9001.

If, during configuration, you changed this port number or specified a listen addressusing the

WebLogicConfigurationWizard,youmustmakethefollowingchanges:

1. Manually change the port number from 9001 to the new port number in the

SOA_ORACLE_HOME/bam/config/BAMICommandConfig.xml (on UNIX operatingsystems) or

SOA_ORACLE_HOME\bam\config\BAMICommandConfig.xml (onWindows operating systems) file.

Theparameterthatneedstobechangedisshownbelow:

9001

2. Oracle BAM singleinstance web application configuration information ismaintained in the

MW_HOME/user_projects/domains/domain_name/servers/BAM_server_name/tmp/_WL_user/ora

clebam_11.1.1/yhryfp/APPINF/classes/config (on UNIX operating systems)

orMW_HOME\user_projects\domains\domain_name\servers\BAM_server_name\tmp\_WL_user\o

raclebam_11.1.1\yhryfp\APPINF\classes\config (on Windows operating systems)directory. The

properties in these files can be modified by using the Mbeansexposed in the Oracle Enterprise

Manager Fusion MiddlewareControl. Theproperties exposed through MBeans are specific to each

server:

Note: The folder name under oraclebam_11.1.1 is randomlygenerated (in this case, it is yhryfp).

When

you

are

looking

for

thisdirectory

on

your

system,

be

aware

that

the

name

of

the

directory

onyoursystemmaynotmatchthenameofthedirectoryshowninthedocumentation.

a.ChangesinBAMCommonConfig.xml:

TheparametershouldcontainthenewURL.

b.ChangesinBAMServerConfig.xml:

localhost

9001

c.Changes

in

BAMWebConfig.xml:

localhost

9001

4.7ApplyingJavaRequiredFiles(JRF)

7/13/2019 208759373 SOA Admin Guide

44/154


Ph:04065574999,9010505808


Java RequiredFiles (JRF)consistsofthosecomponentsnot included intheOracleWebLogicServer

installationandthatprovidecommon functionality for Oraclebusinessapplicationsandapplication

frameworks.

JRF consists of a number of independently developed libraries and applications thatare deployed

intoacommon location(theOracleCommonHomeororacle_commondirectory).Thecomponents

thatare

considered

part

of

Java

Required

Files

include:

OracleApplicationDevelopmentFramework,OracleFusionMiddlewareAuditFramework,Dynamic

Monitoring Service, Infrastructure Security, Java Object Cache,Oracle Platform Security Services,

logging,MDS,OracleWebServices,andOracleWebServicesManager.

If you are creating or extending a domain and JRF is the only component selected onthe Select

DomainSourceScreenorSelectExtensionSourceScreen,youmustmanuallyapplyJRFtoaManaged

Serverorcluster.Todoso:

1. Start the Configuration Wizard (see Section 3.1.4, "Starting the Oracle FusionMiddleware

Configuration

Wizard").

2.WhenyoureachtheSelectOptionalConfigurationScreen,selectDeploymentsandServices.

3. On the Target Services to Servers or Clusters Screen, target the mdsowsm datasource to the

AdministrationServer(bydefault,itisnottargetedtoanyserver).

4.Finishthedomaincreationorextension.

4.8ProtectingUpdatestoYourSOAConfiguration

When the Administration Server is started, the contents of the config/soainfradirectory in your

DOMAIN_HOMEareoverwrittenbytheAdministrationServer.

However,sinceSOAconfigurationparametersareupdatedonlyonManagedServersandonaper

serverbasis,allupdatestotheSOAconfigurationarelostwhentheManagedServersarerestartedif

thesystemhostingtheAdministrationServerdoesnothaveanupdatedcopy.

The antsoautil.xml script in your SOA_ORACLE_HOME/bin directory can beused to resolve this

issue.Thescriptdoesthefollowing:

Note:ThescriptmustberunbeforeyoutrytostarttheAdministrationServeroranyoftheManaged

Servers.

Movestheconfig/soainfra(onUNIXoperatingsystems)orconfig\soainfra(onWindowsoperating

systems) to the DOMAIN_HOME/soa_backup/config/soainfra (on UNIX operating systems)

orDOMAIN_HOME\soa_backup\config\soainfra(onWindowsoperatingsystems)directory.

Replaces the startManagedWebLogic.sh (on UNIX operating systems)

orstartManagedWebLogic.cmd (on Windows operating systems) scripts withversions that prevent

theManagedServersfromstarting.

7/13/2019 208759373 SOA Admin Guide

45/154


Ph:04065574999,9010505808


5)StartingtheServers

To get your deployments up and running, you must start the Administration Serverand various

ManagedServers:

1. To start the Administration Server, run the startWebLogic.sh (on UNIXoperating systems) or

startWebLogic.cmd(on

Windows

operating

systems)script

in

the

directory

where

you

created

your

newdomain.

OnUNIXoperatingsystems:DOMAIN_HOME/startWebLogic.sh

OnWindowsoperatingsystems:DOMAIN_HOME\startWebLogic.cmd

YouenteredthedomainnameandlocationontheSpecifyDomainNameandLocationScreeninthe

ConfigurationWizard.

2.TostarttheManagedServers,runthestartManagedWebLogic.sh(onUNIXoperatingsystems)or

startManagedWebLogic.cmd (on Windows operatingsystems) script in the bin directory inside the

directory

where

you

created

yourdomain.

These

managed

servers

must

be

started

from

the

commandline.

Thiscommandalsorequiresthatyouspecifyaservername.Theserversthatneedtobestartedare:

soa_server1(OracleSOAServer)

bam_server1(OracleBAMServer)

Forexample,tostartOracleSOAServer

onaUNIXoperatingsystem:DOMAIN_HOME/bin/startManagedWebLogic.shsoa_server1

OnWindows

operating

systems:DOMAIN_HOME\bin\startManagedWebLogic.cmd

soa_server1

Beforethemanagedserverisstarted,youwillbepromptedfortheWebLogicServerusernameand

password.Thesewereprovided onthe ConfigureAdministratorUsername andPasswordScreen in

theConfigurationWizard.

If your Administration Server is using a nondefault port, or resides on a differenthost than your

managed servers (in a distributed environment), you must alsospecify the URL to access your

AdministrationServer.

OnUNIXoperatingsystems:

DOMAIN_HOME/bin/startManagedWebLogic.shsoa_server1http://admin_host:admin_port

OnWindowsoperatingsystems:

DOMAIN_HOME\bin\startManagedWebLogic.cmdsoa_server1http://admin_host:admin_port

7/13/2019 208759373 SOA Admin Guide

46/154


Ph:04065574999,9010505808


Instead of being prompted for the Administration Server user name and password, you can also

specifythemdirectlyfromthecommandlime.

OnUNIXoperatingsystems:

DOMAIN_HOME/bin/startManagedWebLogic.sh soa_server1 http://admin_host:admin_port

Dweblogic.management.username=user_nameDweblogic.management.password=password

OnWindowsoperatingsystems:

DOMAIN_HOME\bin\startManagedWebLogic.cmd soa_server1 http://admin_host:admin _port

Dweblogic.management.username=user_nameDweblogic.management.password=password

6) StartingNodeManager

NodeManagerisaJavautilitythatrunsasseparateprocessfromOracleWeblogicServerandallows

youtoperformcommonoperationsforaManagedServer,regardlessofitslocationwithrespectto

itsAdministrationServer.Forexample,NodeManagercanbeusedfor:

Startingserversonremotemachines(viatheConsole).

automaticallyrestartingfailedservers.

AutomaticServiceMigrationwhenusingconsensusbasedleasing.

WholeServerMigration.

While use of Node Manager is optional, it provides valuable benefits if your WebLogic Server

environmenthostsapplicationswithhighavailabilityrequirements.

7) VerifyingtheInstallationandConfiguration

Toverifytheinstallation,startyourbrowserandenterthefollowingURLs:

To

access

the

Administration

Server

console:

http://administration_server_host:administration_server_port/console

You will be prompted for the username and password credentials that you specified on the

ConfigureAdministratorUsernameandPasswordScreenoftheConfigurationWizard.

After you login to the console, click Servers in the "Environment" area inside "Domain

Configuration"section.InthetableontheSummaryofServerspage,verifythattheAdminServer,

bam_server1,andsoa_server1allhavethestatus"RUNNING"intheStatecolumn.

IfyouconfiguredyourAdministrationServertoacceptSSLconnection,usethefollowingURLto

accessthe

Administration

Server

console

in

secure

mode:

https://administration_server_host:secure_administration_server_port/console

ToaccessEnterpriseManager:

http://administration_server_host:administration_server_port/em

7/13/2019 208759373 SOA Admin Guide

47/154


Ph:04065574999,9010505808


Chapter3:NavigationofSOAInfrastructure

a) NavigatingThroughtheSOAInfrastructureHomePageandMenuYou cannavigatetoOracleSOA Suiteand OracleBPMSuiteadministrationtasksthroughtheSOA

Infrastructure home page and menu. The SOA Infrastructure provides you with access to all

deployed

SOA

composite

applications,

service

engines,

service

components,

business

events,

and

otherelements.

TonavigatethroughtheSOAInfrastructurehomepageandmenu:

1. ExpandSOA>soainfrainthenavigator.This displays all SOA composite applications running in the SOA Infrastructure for that managed

server.Thesecompositesaregroupedintothepartitioninwhichtheyaredeployed.

Descriptionoftheillustrationsca_soamenu2.gif

2. Clicksoainfra.ThisdisplaystheDashboardpageoftheSOAInfrastructure.Clickthehelpiconatthetopofthispage

toaccesstheResourceCentrefortheentireOracleSOASuite.Theupperpartofthepagedisplays

detailsaboutrecentlydeployedSOAcompositeapplication instances,deployedcomposites,recent

faults,andrejectedmessages.YoucanclickaspecificSOAcompositeapplicationnameor instance

IDtoaccessadditionaldetails.YoucanalsoclickShowAllatthebottomofeachsectiontoseemore

informationaboutallitems.

7/13/2019 208759373 SOA Admin Guide

48/154


Ph:04065574999,9010505808


Descriptionoftheillustrationgs_soahomepage.gif

The lower part of the page displays details about the service engines provided by the SOA

Infrastructure and a graphical representation of the number of instances and faults for all SOA

compositeapplicationshostedintheSOAInfrastructure.Youmustexpandthesesectionstoseethis

information.Clickaserviceenginenametoaccessmorespecificdetails.

3. NotethattheSOAInfrastructuremenuappearsbelowthesoainfranameatthetopofthepage.

Note:

Dependinguponyourcurrentlocation,thecontextofthismenuchangestoprovideyouwith

theadministrativeoptionsmost relevantto yourcurrent location. Forexample,whenyou

arewithinthepagesofaSOAcompositeapplication,theSOACompositemenuisdisplayed

or when you are on the home page of a specific partition, the SOA Partition menu is

displayed.

4. SelecttheSOAInfrastructuremenu.

7/13/2019 208759373 SOA Admin Guide

49/154


Ph:04065574999,9010505808


Descriptionoftheillustrationsca_menu2.gif

Theseadministrativeoptionsenableyoutoperformthefollowingtasks:

Option Description

Home This option displays the following details of the SOA Infrastructure Dashboard

page:

o RecentSOAcompositeapplicationinstances.o Deployed SOA composite details (status, instance, and fault

counts).

o Recent faults and rejected messages in all SOA compositeapplication instances, including whether the instance is

recoverable.

o Number ofcomponentshosted by service engines and the faultsinthosecomponents.

o GraphicalrepresentationofthenumberofinstancesandfaultsforallSOAcompositeapplicationshostedintheSOAInfrastructure.

Monitoring Thisoptiondisplaysthefollowingdetails:

o AsummaryofperformancestatisticsintheSOAinfrastructure.o Requestprocessingdetailsthatshowthebreakupoftimespentin

7/13/2019 208759373 SOA Admin Guide

50/154


Ph:04065574999,9010505808


Option Description

handshaking requests between the binding components, service

infrastructure,andserviceengines.

Logs

This

option

enables

you

to

view

and

configure

the

logging

levels

for

runtime

loggers.

SOA

Deployment

This option enables you to deploy, undeploy, or redeploy SOA composite

applications.

Manage

Partitions

This option enables you to logically group your SOA Infrastructure into separate

sections known as partitions in which you deploy your SOA composite

applications.Thishelpsyoutologicallygroupcompositessothatyoucanperform

bulklifecyclemanagementtasksonlargenumbersofcomposites.

ServiceEngines This option provides access to monitoring and management tasks for the BPEL

process, Oracle BPMN, Oracle Mediator, human workflow, and business rules

serviceengines.

Bindings This option displays details about recently active document types and trading

partners,andinboundandoutboundendpointsforOracleB2B.

Services and

References

Thisoptiondisplaysmessageprocessingmetricsforserviceandreferencebinding

componentsinallSOAcompositeapplications.

BusinessEvents

This

option

displays

available

business

events,

current

event

subscribers,

and

fault

details.

SOA

Administration

This option provides access to the following configuration tasks for the SOA

Infrastructureandeachserviceengine:

o CommonProperties:ForsettingpropertiesthatimpacttheentireSOA Infrastructure, such as viewing and setting the SOA

Infrastructure audit level, capturing the state of the SOA

compositeapplicationinstance,enablingthepayloadvalidationof

incoming messages, specifying the callback server and server

URLs,

setting

Universal

Description,

Discovery

and

Integration

(UDDI)registryproperties,viewingthedatasourceJNDIlocations,

setting the nonfatal connection retry count, setting web service

binding properties, and optimizing the loading performance of

pages.

7/13/2019 208759373 SOA Admin Guide

51/154


Ph:04065574999,9010505808


Option Description

o BPEL Properties: For setting the audit trail size, maximumdocumentsizeforavariable,payloadvalidationfor incomingand

outgoing messages, audit trail level, BPEL monitor and sensor

disabling

status,

and

dispatcher

thread

level

for

invoke

message

threads,systemthreads,andserviceenginethreads.

o BPMN Properties: For setting the audit trail size, maximumdocumentsizeforavariable,payloadvalidationfor incomingand

outgoing messages, audit trail level, and dispatcher thread level

for invoke message threads, system threads, and service engine

threads.

o Mediator Properties: For setting the audit level, metrics level,number of parallel worker threads, number of maximum rows

retrieved

for

parallel

processing,

parallel

thread

sleep

values,

error

thread sleep values, container ID refresh time, and container ID

leasetimeoutvalues.

o Workflow Notification Properties: For setting the workflowservicenotificationmodeandactionableemailaddressvalue.

o Workflow Task Service Properties: For setting the actionableemail account, adding the worklist application URL, selecting the

pushbackassignee,addingportalrealmmapping,andaddingthe

taskautoreleaseconfigurationpriority.

o B2B Server Properties: For enabling Dynamic Monitoring Service(DMS)metrics.

o CrossReferences:Forselectingcrossreferencevalues.Security Thisoptiondisplaysthefollowingselections:

o Application Policies: For creating application policies that anapplicationreliesuponforcontrollingaccesstoresources.

o ApplicationRoles:Forcreatingapplicationrolesforapplications.This

option

is

available

for

all

deployed

Java

EE

applications,

including

the

SOA

Infrastructure (soainfra) application. Note that these options do not configure

securitypoliciesforSOAcomposites.

Administration Thisoptiondisplaysthefollowingselections:

7/13/2019 208759373 SOA Admin Guide

52/154


Ph:04065574999,9010505808


Option Description

o MDS Connections: For managing metadata service (MDS)connections.

o TopLink Sessions: For managing cache for the Oracle TopLinkpersistenceframework.

o SystemMBeanBrowser:Foradvancedconfigurationofpropertiesacrossapplicationsandcomponents.

In addition to configuring the System MBean Browser from Oracle Enterprise

Manager Fusion Middleware Control, you also can invoke SOA configuration

MBeanoperationswiththeWebLogicScriptingTool(WLST).

Note: The System MBean Browser includes an MBean for Oracle BPMN, even if

OracleBPMSuiteisnot installed.IfOracleBPMSuite isnot installed,thisMBean

cannot

be

used,

and

should

be

ignored.

The

presence

of

this

MBean

does

not

impacttheruntimebehaviorofotherOracleSOASuitecomponents.

General

Information

This option displays general details about the SOA Infrastructure, such as the

OracleEnterpriseManagerFusionMiddlewareControlversion,Oraclehome,and

Oracleinstance.

Note:

Starting

with

11g

Release

1

(11.1.1.4.0),

you

can

no

longer

stop

and

start

the

SOAInfrastructurefromtheSOAInfrastructuremenu.

5. SelectaspecificSOAcompositeapplicationfromthesoainfralistshowninStep1.TheSOAInfrastructuremenuisnowdisplayedabovethenavigator,providingyouwithaccesstothe

same highlevel administrative options, even when you are within the pages of a SOA composite

application.Thismenuchangespositionswhenyouselectacompositeapplication.

7/13/2019 208759373 SOA Admin Guide

53/154


Ph:04065574999,9010505808


Descriptionoftheillustrationsoainfra_menu2.gif

6. Rightclicksoainfrainthenavigator.Themenuthatisdisplayedprovidesyouwithaccesstothe

same

administrative

options

that

appear

in

the

SOA

Infrastructure

menu.

b) NavigatingThroughtheSOACompositeApplicationHomePageandMenuYou can navigate directly to Oracle SOA Suite and Oracle BPM Suite administration tasks for a

specificSOAcompositeapplication.

TonavigatethroughtheSOAcompositeapplicationhomepageandmenu:

1. ExpandSOA>soainfrainthenavigator.2. Expandthepartitions.

ThisdisplaysallSOAcompositeapplicationsrunninginthepartitionsoftheSOAInfrastructure.

Descriptionoftheillustrationsca_soamenu2.gif

7/13/2019 208759373 SOA Admin Guide

54/154


Ph:04065574999,9010505808


3. SelectaspecificSOAcompositeapplication.ThisdisplaysthehomepagefortheselectedSOAcompositeapplication.Theupperpartofthepage

displaysdetailsaboutrecentinstancesandfaultsandrejectedmessages.Thispartofthepagealso

providesyouwithaccesstoimportantadministrativeandconfigurationtasksatthecompositelevel.

Descriptionoftheillustrationsoaapp_upper_helloworld.gif

4. ClickShowAllatthebottomofeachsectiontoseemoreofthese items.Youcanalsoclicklinkstoaccessmoredetailsaboutaspecificcompositeinstanceorfault.

The lowerpartofthepagedisplaysdetails abouttheservice components (inthis example, Oracle

Mediator, BPEL process, and human workflow) and binding components (services and references)

includedin

the

SOA

composite

application.

You

can

click

aspecific

service

component

or

service

or

referencebindingcomponentintheNamecolumntoaccessmorespecificdetails.

7/13/2019 208759373 SOA Admin Guide

55/154


Ph:04065574999,9010505808


Descriptionoftheillustrationsoaapp_lower_helloworld.gif

WhenyouarewithinthepagesofaSOAcompositeapplication,theSOACompositemenuappears

belowthe

application

name

at

the

top

of

the

page.

This

menu

provides

you

with

administrative

tasks

specifictothecurrentcompositeapplication.

5. SelecttheSOACompositemenu.

Descriptionoftheillustrationsca_compositelist.gif

Theseadministrativeoptionsenableyoutoperformthefollowingtasks.

Option Description

Home ThisoptiondisplaysthefollowingdetailsfortheSOAcompositeapplicationhome

page.

7/13/2019 208759373 SOA Admin Guide

56/154


Ph:04065574999,9010505808


Option Description

o Recentinstances.o Recent faults and rejected messages, including whether the

instanceisrecoverable.

o ServicecomponentsincludedintheSOAcompositeapplication.o Services and references included in the SOA composite

application.

Monitoring This option displays the performance summary statistics for the selected SOA

compositeapplication.

SOADeployment ThisoptionenablesyoutoundeployorredeploythisSOAcompositeapplication,

ordeployanotherSOAcompositeapplication.

Export ThisoptionenablesyoutoexportarunningSOAcompositeapplicationtoaJAR

file.

TestService This option enables you to manually initiate an instance of this deployed SOA

compositeapplicationthroughtheTestWebServicepage.

UnitTests Thisoptionenablesyoutoruntestcasesthatsimulatethe interactionbetween

the current SOA composite application and its web service partners before

deployment to a production environment. This generates test instances of the

composite.

Policies ThisoptionenablesyoutoviewandattachordetachpoliciestoorfromtheSOA


SOA

Infrastructure

ThisoptiontakesyoutotheSOAInfrastructurehomepage.

SOA

Infrastructure

Common

Properties

Thisoptionenablesyoutoviewandsettheaudit level,capturethestateofthe

SOA composite application instance, enable the payload validation of incoming

messages, set UDDI registry properties, specify the callback server and server

URLs, view the data source JNDI locations, set the nonfatal connection retry

counts, set web service binding properties, and optimize the loading

performance of pages. The SOA composite application typically inherits the

settingsdefinedattheSOAInfrastructurelevel.

7/13/2019 208759373 SOA Admin Guide

57/154


Ph:04065574999,9010505808


Option Description

Service/

Reference

Properties

This option enables you to configure WSDL file properties for the service and

referencebindingcomponentsincludedintheSOAcompositeapplication.

General

Information

ThisoptiondisplaysgeneraldetailsaboutthisSOAcompositeapplication,suchas

Oracle Enterprise Manager Fusion Middleware Control version, Oracle home,

Oracleinstance,andpartitioninwhichthecompositeisdeployed.

6. RightclickthenameofaSOAcompositeapplication inthenavigator.Amenu isdisplayedthat provides you with access to the same administrative options that appear in the SOA

Compositemenu.

c)

Navigating

Through

the

Partition

Home

Page

and

Menu

YoucannavigatetoadministrativetasksforaspecificpartitionintheSOAInfrastructure.

Tonavigatethroughthepartitionhomepageandmenu:

1. ExpandSOA>soainfrainthenavigator.2. Clickaspecificpartition.

Descriptionoftheillustrationsca_partitionmenu2.gif

3. Atthetopofthepage,selecttheSOAPartitionmenu.

Descriptionoftheillustrationsca_partitionmenu.gif

Theseadministrativeoptionsenableyoutoperformthefollowingtasks:

7/13/2019 208759373 SOA Admin Guide

58/154


Ph:04065574999,9010505808


Option Description

Home Thisoptiondisplaysthefollowingdetailsforthepartitionhomepage:

o SOAcompositeapplicationsinthispartition.o StatusoftheSOAcompositeapplicationsinthispartition(eitherUp

(on)orDown(off)).

o ModeoftheSOAcompositeapplications inthispartition (activeorretired).

o Total number of instances and faulted instances of the SOAcompositeapplicationsinthispartition.

o TimeatwhichtheSOAcompositeapplicationsinthispartitionwerelastdeployed,redeployed,orreconfigured.

Composites

Control

Thisoptiondisplaysthefollowingbulklifecyclemanagementtasks:

o Start Up All: Invokes a dialog for starting all composites in thispartition.

o ShutDownAll:Invokesadialogforshuttingdownallcompositesinthispartition.

o Activate All: Invokes a dialog for activating all composites in thispartition.

oRetire

All:

Invokes

a

dialog

for

retiring

all

composites

in

this

partition.

SOA

Deployment

Thisoptiondisplaysthefollowingmanagementtasks.

o DeployToThisPartition:InvokestheDeploySOACompositewizardforselectingacompositetodeployinthispartition.

o UndeployAllFromThisPartition: Invokesadialog forundeployingallcompositesinthispartition.

o Redeploy: Invokes the Redeploy SOA Composite wizard to selectcomposites

to

redeploy

in

this

partition.

Delete This

Partition

Thisoption invokesadialogtodeletethispartition.Allcomposites inthepartition

areautomatically undeployedbeforethepartitionisdeleted.

7/13/2019 208759373 SOA Admin Guide

59/154


Ph:04065574999,9010505808


Option Description

General

Information

Thisoptiondisplaysgeneraldetailsaboutthepartitionsuchasthepartition(target)

name,theOracleFusionMiddlewareversion,theOracle FusionMiddlewarehome

directory,domainhomedirectory,hostname,anddeployedserver.

4. Rightclickthenameofapartition inthenavigator.Amenu isdisplayedthatprovidesyouwithaccesstothesameadministrativeoptionsthatappearintheSOAPartitionmenu.

Note:

YoucanalsoaccessthepartitionhomepagefromtheRelatedTopicsmenuonthehomepageofa

SOAcompositeapplication.

d) NavigatingtoDeployedJavaEEApplicationsYou can navigate to deployed Java EE applications related to Oracle SOA Suite and (if installed)

OracleBPM

Suite

components.

These

applications

are

Java

EE

applications

that

represent

the

SOA

systemcomponents,suchasthetechnologyadapters,OracleB2B,OracleBPMWorklist,andsoon.

You can deployaweb service and see it listed here. You can also click individualapplications (for

example,thedeployedwebservice),andmanageandtestthatyoucandeployWARandEARfiles

fromhere.IfyouhavedeployedyourownJavaEEapplications,theyalsodisplayhere.

TonavigatetodeployedJavaEEapplications:

1. ExpandApplicationDeploymentsinthenavigator.2. ExpandInternalApplications.3. ExpandResourceAdapters.

AlistofdeployedJavaEEapplicationsrelatedtoOracleSOASuiteandOracleBPMSuitecomponents

appears.

7/13/2019 208759373 SOA Admin Guide

60/154


Ph:04065574999,9010505808


Descriptionoftheillustrationsca_deployapp.gif

NotethatOracleB2B(b2bui)appearsintheInternalApplicationsfolder,whileOracleBPMWorklist

(worklistapp)appearsinthetoplevelApplicationDeploymentsfolder.

4. Clickaspecificapplication(forthisexample,worklistappisselected).Thepagedisplaysdetailsaboutapplicationperformance.

7/13/2019 208759373 SOA Admin Guide

61/154


Ph:04065574999,9010505808


Descriptionoftheillustrationsca_deployapp2.gif

Note that while Oracle Enterprise Manager Fusion Middleware Control displays the URLs for all

deployedmodules,youcannotdirectlyinvokethemfromthispage.

e) NavigatingtotheOracleWeblogicServerAdministrationConsoleandOtherPagesMostpagesinOracleEnterpriseManagerFusionMiddlewareControlincludeaRelatedLinksmenu

in the upper righthand corner. Depending upon your current location, the context of the menu

changestoprovidelinkstorelevantpages.Forexample,whenyouareontheBPELprocessservice

enginepage,theRelatedLinksmenuprovides linkstotheSOAInfrastructurehomepage,theBPEL

process

configurationproperties

page,

the

Oracle

WebLogic

Server

Administration

Console,

and

a

pageforserviceenginelogfiles.Figure21providesdetails.Youcanalsoclicksoainfraatthetopof

theBPELserviceenginepagetogodirectlytotheSOAInfrastructurehomepage.

Figure21RelatedLinksMenuforaSOACompositeApplication

7/13/2019 208759373 SOA Admin Guide

62/154


Ph:04065574999,9010505808


Descriptionof"Figure21RelatedLinksMenuforaSOACompositeApplication"

When you are on the page of a service component of a SOA composite application, several

navigationalmenusandlinksareavailable:

The

Related

Links

menu

provides

links

to

the

SOA

Infrastructure

home

page

and

the

applicableserviceenginehomepage.Figure22providesdetails.

BreadcrumbsaredisplayedintheupperlefthandcornerasyoutraversefurtherintoaSOAcompositeapplication.

WithinanySOAcompositeapplicationpage (includingtheservicecomponentpages), linkstotheSOAInfrastructurepagesalsoremainavailablethroughtheSOAInfrastructuremenu

thatisdisplayednexttotheFarmmenuabovethenavigator.Forexample,thisenablesyou

togofromthehomepageofaspecificBPELservicecomponentdirectlytotheBPELservice

engineconfigurationpropertiespage.

Names at the top of the page can be clicked to navigate to parent pages. For example,clickingthenameofacompositeattheverytopofaservicecomponentpageenablesyouto

gotothecompositethatincludesthatcomponent.

Figure22RelatedLinksMenuforaServiceComponentofaSOACompositeApplication

Description of "Figure 22 Related Links Menu for a Service Component of a SOA Composite

Application"

7/13/2019 208759373 SOA Admin Guide

63/154


Ph:04065574999,9010505808


Theserviceengines,SOAadministration(suchastheSOAInfrastructureCommonPropertiespage),

andbusinesseventpagesallprovideaccesstoOracleWebLogicServerAdministrationConsolefrom

theRelatedTopicslist.SelectingWebLogicServerConsoleopensanewbrowserpageandtakesyou

to the login prompt for the Oracle WebLogic Server Administration Console. Your current page in

OracleEnterpriseManagerFusionMiddlewareControlisnotlost.Afterloggingin,thehomepageis

displayed.Figure23providesdetails.

Figure23OracleWebLogicServerAdministrationConsole

Descriptionof"Figure23OracleWeblogicServerAdministrationConsole"

YoucanperformthefollowingOracleSOASuitetasks fromOracleWeblogicServerAdministration

Console:

Configureadapterconnectionsforcompositereferences. Createandmanagedatasourcesutilizedbyadapters. CreateandmanageJMSresourcesutilizedbyadapters. ManageSOAInfrastructuredatasources(forexample,modifyingconnectionpoolsettings). Administersecurityofhumanworkflowusers. Manage Oracle Weblogic Server transaction (JTA) settings (for example, the transaction

timeoutvalue).

7/13/2019 208759373 SOA Admin Guide

64/154


Ph:04065574999,9010505808


Deployhumantaskuserinterfaces.f) NavigatingtotheSOAInfrastructureorSOACompositeApplicationHomePage

YoucanaccessthehomepageoftheSOAInfrastructure,aspecificSOApartition,oraspecificSOA

compositeapplicationfromtheFarmhomepage.

TonavigatetotheSOAInfrastructureorSOAcompositeapplicationhomepage:

1. In the Deployments section of the Farm home page, click soainfra or a specific SOAcompositeapplication(forexample,SimpleApproval).

Descriptionoftheillustrationsca_menu3.gif

Thehomepageforyourselectionisdisplayed.

g) LoggingOutofOracleEnterpriseManagerFusionMiddlewareControlThissectiondescribeshowtologoutofOracleEnterpriseManagerFusionMiddlewareControl.

TologoutofOracleEnterpriseManagerFusionMiddlewareControl:

1. Notethefollowingdetailsaboutloggingout.o Ifmultiplepagesareopen(forexample,thehelpdialog,topologyviewer,andflow

trace), logging out of any page logs you out of the entire application in all open

pages.

7/13/2019 208759373 SOA Admin Guide

65/154


Ph:04065574999,9010505808


o If you log out with any unsaved configuration changes, you receive no warningmessageandyourchangesarelost.

2. Intheupperrighthandcornerofanypage,clicktheLogOutlink.

7/13/2019 208759373 SOA Admin Guide

66/154


Ph:04065574999,9010505808


Chapter4:SOAInfrastructurePartitions

YoucandeploySOAcompositeapplicationsintoseparatesectionsoftheSOAInfrastructureknown

as partitions. Deploying to partitions enables you to logically group SOA composites and perform

bulk lifecycle management tasks on all SOA composite applications within a specific partition.

Partitionsaresimilartothedomainfeaturethatwaspartof10.1.xreleasesofOracleBPELProcess

Manager.However,notethatyoucannotperformspecificconfigurationtasksonpartitions,suchas

restricting login access to a specific partition or configuring partitions (such as configuring

threading).

At least one partition is required for deploying SOA composite applications. A default partition

nameddefaultisautomaticallyincludedwithOracleSOASuite.

Youcanmanagepartitioningfromeitheroftwopages:

FromtheManagePartitionspageoftheSOAInfrastructure,whichletsyoucreatepartitions,delete partitions, and perform bulk lifecycle management tasks on all SOA composite

applicationsin

aspecific

partition

From the partition home page, which also enables you to perform bulk lifecyclemanagementtasksonallSOAcompositeapplicationsinaspecificpartition

Note:

IfSOAcompositeapplicationsusingthesameinboundresourcearedeployedtodifferentpartitions,

itcannotbeguaranteedwhichpartitionpicksupthemessageforprocessing.

Forexample,assumeyouareusingthefileadapterand/home/Directory1 isthe inbounddirectory

forthecompositeSOAComposite1.IfthiscompositeisdeployedtobothPartition1andPartition2,

whenafile

is

placed

in

/home/Directory1,

either

the

composite

in

Partition1

or

Partition2

may

pick

upthefile.

With the socket adapter, however, there is a limitation that does not permit you to deploy any

compositethatusesthesameinboundport.Inthatcase,anexceptionisthrownindicatingthatthe

inboundportisinuse.

Table82providesmorespecificdetailsonthetasksyoucanperformfrombothpages.

Table82PartitionManagementActions

Action

Perform on the

ManagePartitions

Page?

Perform on the Partition Home

Page?

Createapartition Yes No

7/13/2019 208759373 SOA Admin Guide

67/154


Ph:04065574999,9010505808


Action

Perform on the

ManagePartitions

Page?

Perform on the Partition Home

Page?

Deleteapartition Yes Yes. Select the SOA Partition menu,

andthen

select

Delete

This

Partition.

Note:Youcanalsodeleteapartition

by rightclicking it in the navigator

andselectingDeleteThisPartition.

Performbulklifecyclemanagementtasks

on all composites deployed to a specific

partition:

Startall Shutdownall Retireall Activateall Undeployall

Yes Yes

Notes:

Partitionsarenotassociatedwith aparticularstatesuch as started,stopped,activated,orretired. Only the composites within the partition are associated with a particular state.

Therefore,youcannotstart,stop,activate,orretireapartition.

After the SOA Infrastructure is started, it may not be completely initialized to administerincoming requests until all deployed composites are loaded. During SOA Infrastructure

initialization, a warning message is displayed at the top of the Manage Partitions and

Partitions home pages. Do not perform operations such as composite deployment,

compositeUndeployment,andotherswhilethismessageisdisplayed.

a) CreatingandDeletingPartitionsYou can create and delete partitions on the Manage Partitions page. A default partition named

default isautomatically includedwithOracleSOASuite.Youcandeletethedefaultpartition.Note

thatyoucannotrenameexistingpartitions;onlycreationanddeletionofpartitionsissupported.

1. Accessthispagethroughoneofthefollowingoptions:

7/13/2019 208759373 SOA Admin Guide

68/154


Ph:04065574999,9010505808


FromtheSOAInfrastructureMenu... FromtheHomePageofaSpecificPartition...

a. Select ManagePartitions.

b. From the Related Links list of a specificpartition,selectManagePartitions.

TheManagePartitionspagedisplaysthefollowingdetails:

o The name of each partition, the number of active and retired SOA compositeapplication revisions in each partition, the name of the composites contained in

each partition (under the View link), and the total number of running and faulted

instancesineachpartition.

o Autility for searching for a specificpartition. Enter a fullor partial partitionnameandclicktheSearchiconorpresstheReturnkey.Thesearchisnotcasesensitive.

Descriptionoftheillustrationsoaadmin_partition4.gif

Toaddapartition,clickCreate.

TheCreateNewSOAPartitiondialogisdisplayed.

Descriptionoftheillustrationsoaadmin_createpartition.gif

7/13/2019 208759373 SOA Admin Guide

69/154


Ph:04065574999,9010505808


. IntheNamefield,enterapartitionname,andclickCreate.Note:

Thenamemustconformtothefollowingconventions:

ASCII

letters

and

numbers

are

permitted.

Underscores(_)arepermitted. Hyphens()arepermitted(exceptasthefirstcharacter). NonASCIIlettersarepermitted. Spacesarenotpermitted.

Examplesofvalidnamesaremypartition,partition2,depta,customer_services,and

22.Examplesofinvalidnamesarepart2,/partition,andnulloremptynames.

Youcannot

rename

an

existing

partition

or

later

transfer

the

composite

applications

you

deployed

to

ittoadifferentpartition.

ThenewpartitionisdisplayedinboththenavigatorundersoainfraandtheSOAPartitioncolumnof

theManagePartitionspage.YoucannowdeploycompositestothispartitionbyselectingDeployto

This Partition from the Deployment dropdown list or rightclicking a specific partition in the

navigatorandclickingDeploytoThisPartition.

Whenacomposite isdeployedtoapartition, it isdisplayedbeneaththepartition inthenavigator.

Oncedeployed,acompositecannotbetransferredtoadifferentpartition.

Descriptionoftheillustrationsoaadmin_createpartition2.gif

Todeleteapartition,selectaspecificpartitionandclickDelete.Notethatyoucanalsoright

clickaspecificpartitioninthenavigatorandclickDeleteThisPartition.

7/13/2019 208759373 SOA Admin Guide

70/154


Ph:04065574999,9010505808


TheDeleteSOAPartitiondialogisdisplayed.Notethefollowing:

o Ifyouwanttorecreatesomeofyourcompositedeployments inanotherpartition,youcanexportthosecompositestoaJARfilebeforeyoudeletethispartition.

o Beforedeletingtheselectedpartition,allSOAcompositeapplicationrevisionsinthepartition

are

undeployed.

The

states

of

all

undeployed

instances

of

these

revisions

becomestale.

Note:

Youmusthaveat leastonepartition. Ifyoudeleteallpartitions,youcannotdeployaSOA


Descriptionoftheillustrationsoaadmin_deletepartition.gif

b. ClickDelete(UndeployAllComposites).All composites that were deployed in the partition are undeployed and no longer appear in the

navigator.

The

partition

is

then

deleted

from

both

the

navigator

under

soa

infra

and

the

SOA

PartitioncolumnoftheManagePartitionspage.

b) PerformingBulkLifecycleManagementTasksonCompositesinPartitions

7/13/2019 208759373 SOA Admin Guide

71/154


Ph:04065574999,9010505808


You can perform bulk lifecycle management tasks on all SOA composite applications in a specific

partition on the Manage Partitions page, on the home page of a specific partition, and from the

menuthatisdisplayedwhenyourightclickapartitioninthenavigator.

Bulklifecyclemanagementtasksimpactnotone,butmany,compositesatonce.Ifacompositehas

running instancesanda lifecyclechangingoperation isperformedonthecomposite,the instances

maynot

complete.

To

perform

bulk

lifecycle

management

tasks

on

all

SOA

composite

applications

in

aspecificpartition:

1. Accesseitherpagethroughoneofthefollowingoptions:FromtheSOAInfrastructureMenu... FromtheSOAFolderintheNavigator...

a. SelectManagePartitions. b. Under soainfra, select a specificpartition.

Note:

Asashortcut,youcanalsorightclickaspecificpartitioninthenavigatortodisplayamenu

forselectingthebulklifecyclemanagementactionsdescribedinthissection.

Two dropdown lists that are displayed on either page enable you to perform bulk lifecycle

managementactions:

o CompositesControllisto Deploymentlist

Onthehomepageofaspecificpartition,theselistsaredisplayedatthetopofthepage.

Descriptionoftheillustrationsoaadmin_partition3.gif

OntheManagePartitionspage,theselistsaredisplayedabovetheSOAPartitiontable:

7/13/2019 208759373 SOA Admin Guide

72/154


Ph:04065574999,9010505808


Descriptionof

the

illustration

soaadmin_partition4.gif

Note:

You can also select to deploy composites to a partition and perform bulk lifecycle

management tasks by selecting the SOA Partition menu at the top of the partition home

page.

To perform one of the following bulk lifecycle management tasks for all SOA composite

applicationscontainedintheselectedpartition,selecttheCompositesControllist:

oStart

all

composites.

o Shutdownallcomposites.o Activateallcomposites.o Retireallcomposites.

Descriptionoftheillustrationsoaadmin_comp_control.gif

d. Selectanoperationtoperform.Adialogisdisplayedthatpromptsyoutoconfirmyourselection.Whentheoperationcompletes,a

confirmationmessageisdisplayedatthetopofthepage.

Toperformoneofthefollowingmanagementtasks,selecttheDeploymentlist:

o Specify a composite to deploy to this partition. This selection invokes the DeploySOACompositewizardwhereyouspecifyacompositerevisiontodeploy.

o Undeployallcompositesinthispartition.Adialogisdisplayedthatpromptsyoutoconfirmyourselection.Whentheoperationcompletes,a

confirmationmessageisdisplayedatthetopofthepage.

7/13/2019 208759373 SOA Admin Guide

73/154


Ph:04065574999,9010505808


Descriptionoftheillustrationsoaadmin_deployment.gif

7/13/2019 208759373 SOA Admin Guide

74/154


Ph:04065574999,9010505808


Chapter5:ConfiguringLogFiles

OracleSOASuitecomponentsgeneratelogfilescontainingmessagesthatrecordalltypesofevents,

includingstartupandshutdowninformation,errors,warningmessages,accessinformationonHTTP

requests,andadditionalinformation.

Toconfigure

log

files:

1. Accessthispagethroughoneofthefollowingoptions:FromtheSOAInfrastructureMenu... FromtheSOAFolderintheNavigator...

a. SelectLogs>LogConfiguration. b. Rightclicksoainfra.c. SelectLogs>LogConfiguration.

TheLogConfigurationpagedisplaysthefollowingdetails:

o AViewlistforselectingthetypeofloggersforwhichtoviewinformation: Persistent:Loggersthatbecomeactivewhenacomponent isstarted.Their

configuration details are saved in a file and their log levels are persisted

acrosscomponentrestarts.

Activeruntime:Loggersthatare automaticallycreated during runtime andbecome active when a particular feature area is exercised (for example,

oracle.soa.b2bororacle.soa.bpel).Their log levelsarenotpersistedacross

componentrestarts.

o A table that displays the logger name, Oracle Diagnostic Logging (ODL) level forsettingtheamountandtypeofinformationtowritetoalogfile,thelogfile,andthe

loglevelstate.

7/13/2019 208759373 SOA Admin Guide

75/154


Ph:04065574999,9010505808


Descriptionoftheillustrationsca_logconfig.gif

Performthefollowinglogfiletasksonthispage:

. In the Logger Name column, expand a logger name. This action enables you tospecifymorespecificlogginglevelswithinacomponent.

a. In the Oracle Diagnostic Logging Level columns, select the level and type ofinformationtowritetoalogfile.

b. In the Log File column, click a specific log file to create and edit log fileconfigurations.

FormoreinformationaboutODLlogfilesandthelevelandtypeoflogginginformationtowritetoa

logfile,seeOracleFusionMiddlewareAdministrator'sGuide.ClicktheLogFilestab.

Thispageenablesyoutocreateandeditlogfileconfigurations,includingthelogfileinwhichthelog

messages are logged, the format of the log messages, the rotation policies used, and other

parametersbasedonthelogfileconfigurationclass.

Descriptionoftheillustrationsca_logfiles.gif

7/13/2019 208759373 SOA Admin Guide

76/154


Ph:04065574999,9010505808


Chapter6:DeployingSOAApplications

a)DeploymentofSOAApplications

You

can

deploy

SOA

composite

applications

from

Oracle

Enterprise

Manager

Fusion

MiddlewareControlConsolewiththeDeploySOACompositewizard.UsetheDeploySOACompositewizardto

deployanyofthefollowing:

AnewSOAcompositeapplicationforthefirsttime A new revision (for example, 2.0) alongside an older revision (for example, 1.0) without

impacting the latter. The revision deployed last becomes the new default revision of that

composite(unlessyouspecifyotherwiseatalaterstepduringdeployment).

Deployment extracts and activates the composite application in the SOA Infrastructure. Once an

application is deployed, you can perform administration tasks, such as creating instances,

configuring

properties,

monitoring

performance,

managing

instances,

and

managing

policies

and

faults.

Todeployapplications:

1. AccesstheDeploySOACompositewizardthroughoneofthefollowingoptions:FromtheSOAInfrastructureMenu...

1. SelectSOADeployment>Deploy.FromtheSOAFolderintheNavigator...

2. Rightclicksoainfra.3. SelectSOADeployment>Deploy.

FromtheSOAInfrastructureHomePage...

1. ClicktheDeployedCompositestab.2. AbovetheCompositetable,clickDeploy.

FromtheSOACompositeMenu...

3. SelectSOADeployment>DeployanotherComposite.Note:

You can also access the Deploy SOA Composite wizard by selectingDeploy to This Partitionfrom

theDeploymentdropdown listoftheManagePartitionspageorhomepageofaspecificpartition,

208759373 soa admin guide

Documents