057344

8/2/2019 057344

1/37

An Oracle White Paper

September 2009

Installing AIA on an Oracle SOA Suite ClusterDeployment

8/2/2019 057344

2/37

Installing AIA on an Oracle SOA Suite Cluster Deployments

Introduction ........................................................................................ 1Scope of this document ..................................................................... 3Software pre-requisites ...................................................................... 5

Document References ................................................................... 5Topologies considered in this document ............................................ 6

Topology A .................................................................................... 6Topology B .................................................................................... 8Oracle Service Registry Topology Considerations ......................... 9

Ensuring that the SOA is setup correctly .......................................... 12Setting SOA parameters .............................................................. 12Verifying SOA Cluster setup ........................................................ 14

Preparing the APPHOSTn and WEBHOSTn for AIA deployment ..... 16Setting up APPHOSTn ................................................................. 17Setting up WEBHOSTn ................................................................ 19

Steps for Deployment of AIA FP to the SOA cluster ......................... 20On APPHOST2 ............................................................................ 20On WEBHOSTn (Applicable only to Topology A) ......................... 21On APPHOST1 ............................................................................ 22

Post Install actions for AIA FP installation on SOA cluster ............... 23Steps for Deployment of AIA PIPS on AIA FP clustered deployment 27

On APPHOST2 ............................................................................ 27On WEBHOSTn (Applicable only to Topology A) ......................... 29On APPHOST1 ............................................................................ 29

Post Install actions for PIP deployments on AIA FP cluster .............. 32Upgrading AIA installations on SOA cluster ..................................... 33Conclusion ....................................................................................... 34

8/2/2019 057344

3/37


1

IntroductionOracle Application Integration Architecture (AIA) Foundation Pack is a comprehensive

SOA based integration product from Oracle that not only provides an architecture blueprint for true SOA based integration of enterprise applications, but also provides pre-built

standards-based content required for integration and Programming Models to achieve

superior performance, scalability, extensibility, security etc. In addition, AIA Foundation

Pack (AIA FP) contains inbuilt tools for SOA governance, Integration validation, error

handling etc making it a comprehensive Integration Product for enterprises to jump start

on Integration initiatives. AIA FP runs on Oracle Fusion Middleware (FMW) SOA Suite.

AIA Process Integration Packs (AIA PIPs) are pre-built end-to-end integrations built on

AIA Foundation Pack. PIPs are products that implement a specific set of business

process between a specific set of Applications (Oracle E-Business Suite, Siebel, SAP

etc). Besides providing immediate functional value, PIPs derive all the principles and

infrastructure from FP, there by delivering a complete SOA implementation along with

superior ownership experience.

Figure1: AIA products and their relationships

AIA FP and PIPs are installable products that can be installed against installations of

SOA Suite, Database, OSR and participating Applications (eg. Siebel, PeopleSoft). AIA

Installation/deployment ensures all AIA pre-packaged content is delivered at the end of

8/2/2019 057344

4/37


2

the installation along with establishing connectivity and configuration, so that FP and

PIPs are ready to use.

Deploying AIA to a highly available enterprise deployment provides the following distinctadvantages.

Because AIA integrates business-critical Enterprise software, it is important to ensure

that there is no single point of failure and that system maintenance and failure recovery

can happen without impacting the business.

Workload can be distributed effectively to multiple nodes allowing for optimal usage of

resources.

New resources can be added or removed easily. For example, an Order to Cash

Integration could need more resources during a specific season of the year

Specific process flows can be provisioned with more resources than other flows based

on the kind of operation they perform and the frequency of usage.

High availability is ensured at all levels (web tier, application tier and database tier).

Application and data tiers are also secured as they lie within firewalls.

This paper will give step-by-step instructions on installing AIA on a SOA Cluster along

with the explanation of the overall procedure, so that the same instructions can be used

to extrapolate the content of this paper to suit your own Topology.

8/2/2019 057344

5/37


3

Scope of this document

Asmentionedearlier,AIAFPrunscompletelyonOracleSOASuiteandtheunderlyingFMW

infrastructure.Forthisreason,AIAFPHighAvailabilityisdirectlyderivedfromtheunderlyingenterprisedeploymenttopologyimplementedforSOASuiteandthedatatier.PleasereferOracle

ApplicationServer10gR3EnterpriseDeploymentGuide tolearnmore.

Thiswhitepapercontainstwomajorsections.Thefirstoneexplainstheinstructionstoinstall

AIAFoundationPackonaSOAclusterandthesubsequentsectionexplainshowtoinstallany

PIPontopofanFPcluster.LastlythereisasectiononhowtoupgradeagivenAIAcluster

installtothelatestreleaseofAIA.

BothAIAFPandAIAPIPsarecomposedofseveralBPEL/ESBprocesses,configurations,

WSDLs/XSDs,queues,databaseobjects,J2EEapplicationsetc.allofwhichareartifactscreated

orconfiguredonFMW.

Sincetheseartifactsarelargeinnumberandhavedependencies,forsinglenodeinstallations,

AIAprovidesawizard-basedInstallerthatcollectsthesoftwareinformationandkicksoffseveral

installscriptsandtoolstodeployandconfigurealltheseartifactsautomatically,therebyproviding

anout-of-the-boxexperienceforcustomers.

HoweverHAtopologiescanwidelyvarydependingontherequirementandsothestepsto

deployAIAFPtoHighlyAvailabletopologies,theunderlyinginstallscriptsneedtobeexecuted

manuallybasedonthedesiredtopology.

AIA FP runs completely on Oracle SOA Suite and the underlying FMW infrastructure. For this reason, AIA FP High

Availability is directly derived from the underlying enterprise deployment topology implemented for SOA Suite and the

data tier

This whitepaper applies to SOA Suite 10.1.3.4 and above running on Oracle Application Server 10gR3 (OC4J). The applicable

AIA version is the latest generally available version of AIA
http://download.oracle.com/docs/cd/E10291_01/core.1013/e10294.pdfhttp://download.oracle.com/docs/cd/E10291_01/core.1013/e10294.pdf

8/2/2019 057344

6/37


4

TherearesomespecialconsiderationswhendeployingAIAtotheSOAHAdeployment.These

areexplainedinthesectionTopologiesconsideredinthispaper

Thispaperprovidesstep-by-stepinstructionstodeployAIAFPandanySOASuitebasedPIP

onagivenHAdeploymentofSOASuite.Whenprovidingthestepswewillconstantlyreferto

thetopologyandAIAconsiderationssectionstherebyallowinguserstoextrapolatethe

instructionsiftheyhaveadifferenttopology.

8/2/2019 057344

7/37


5

Software pre-requisites

ThefollowingarethebasicSoftwareapplicationsrequiredforanAIAInstallation.

OracleSOASuite10gR3(10.1.3.4)OracleSOASuite,J2EEserver,HTTPServer

OracleDatabase(10.2.0.1)ReferApplicationServercertificationmatrixtoknowall

supporteddatabaseversions

OracleServiceRegistry10.3.0.0-Optional

TheaboveinformationisdependentontheversiononAIAFoundationPackthatisbeing

installed.ReferAIAInstallationGuideonOracleMetalinktoknowtheexactsoftware

requirements

PleasereviewChapter1andChapter2oftheAIAInstallationGuidetounderstandthebasicsof

AIAInstallation.

ItisrequiredthatyouhavesetuptheSOASuiteClusteraspertheEnterpriseDeployment

Guidebeforeattemptingthestepsprovidedinthispaper.Alternativelyyoucansetupasimpler

topologyasmentionedintheTopologysectionofthispaper.

Document References

OracleAIAInstallationGuide:AvailableonOracleMyOracleSupport(Metalink)

OracleApplicationServer10gR3:EnterpriseDeploymentGuide-

http://download.oracle.com/docs/cd/E10291_01/core.1013/e10294.pdf

Thispaperdoesnotaddressclusteringatdata-tier,Securityconsiderations,disasterrecoveryetc.

ThisisbecausetherearenoAIAconsiderationsorspecialrecommendationsrequired.More

informationonthesetopicscanbefoundattherespectiveproductdocumentationlocations:

SecurityinClusters:http://download.oracle.com/docs/html/A96687_01/manage.htm

Databaseclustering:

http://www.oracle.com/technology/products/database/clustering/index.html

DisasterRecovery:

http://download.oracle.com/docs/cd/B14100_14/install.1012/install/ha_dr.htm
http://download.oracle.com/docs/cd/E10291_01/core.1013/e10294.pdfhttp://download.oracle.com/docs/cd/E10291_01/core.1013/e10294.pdfhttp://download.oracle.com/docs/html/A96687_01/manage.htmhttp://download.oracle.com/docs/html/A96687_01/manage.htmhttp://www.oracle.com/technology/products/database/clustering/index.htmlhttp://download.oracle.com/docs/cd/B14100_14/install.1012/install/ha_dr.htmhttp://download.oracle.com/docs/cd/B14100_14/install.1012/install/ha_dr.htmhttp://download.oracle.com/docs/cd/B14100_14/install.1012/install/ha_dr.htmhttp://www.oracle.com/technology/products/database/clustering/index.htmlhttp://download.oracle.com/docs/html/A96687_01/manage.htmhttp://download.oracle.com/docs/cd/E10291_01/core.1013/e10294.pdf

8/2/2019 057344

8/37


6

Topologies considered in this document

TheEnterpriseDeploymentGuide(EDG)providesareferencetopologythatensuresthatthe

SOAdeploymentishighlyavailableatalltiers(Webtier,ApplicationServerTier,DatatierandSecuritytier).

AstheEDGrightlypointsoutthereareseveralvariationspossibletotheproposedtopology

dependinguponuserrequirement.

Forthepurposeofthispaper,wewouldprovide2variations

Topology AHighAvailabilityatalltiers(referencetopologyusedinEDG)

Topology BHighAvailabilityonlyattheApplicationtier

Installationstepswouldbealmostsimilarforbothtopologiesandwhereverthereisvarianceit

willbehighlighted.

Foranyothertopologyapartfromtheabove,youcaneasilyextrapolatetherequiredstepsbased

ontheexplanation.

Topology A

Inthistopologytheloadbalanceracceptsexternalrequestsandinturnredirectsrequeststo

OracleHTTPservers(ApacheServers).TheseHTTPserversinturnpointtooneofthe

ApplicationServernodesthathostBPEL/ESBandotherJ2EEapplications.TheApplication

SevernodesinturnpointtoanOracleRACdatabase.

Pleasereferfigure2,toseeacompleterepresentationofthistopology.Inaddition,thefigurealsoprovidessummaryinformationofdifferentAIAartifactstobeinstalledateachtier

Load BalancerBalancesexternalrequeststooneoftheOracleHTTPServers

(WEBHOSTn).Therewouldbetwovirtualhostsoneforexternalrequeststhatuse

HTTPS:443calledthesoa.mycompany.comandaninternalvirtualhost

soainternal.mycompany.com

Note:IfyoudonothaveHTTPSrequirementtoallowexternalaccesstoyoursystem,

youwouldonlyusetheinternalvirtualhost

WEBHOST1/WEBHOST2 ServersthatrunOracleHTTPserversintheirOracleHomes.RequestsareredirectedtotheAPPHOSTn

ThisiswhereAIAEnterpriseobjectlibraryartifactslikeEBO,EBSetc(whichare

XSDsandWSDLs)reside.

8/2/2019 057344

9/37


7

APPHOST1/APPHOST2 -ServersthathostOracleSOASuiteApplicationsandthe

underlyingJ2EEserverinfrastructure.

InthispaperwewillconsideronlyBPELandESBapplicationsofSOASuite.Forother

applicationssuchasOWSM,therearenoAIAartifactstobedeployed.Sopleaserefer

theEnterpriseDeploymentGuidedirectlyandfollowSOASuitebestpractices.

ThistierhostsAIAdeliveredBPEL/ESBprocesses,J2EEapplications,datasource

configurationsetc.AIAHomewillbemadeavailableineachhost.AIAHomeismore

ofadesigntimerepositoryofcontentsthataredeployedtotheOracleASOracleHome

(calledSOAHOMEhere).Therearesomerun-timedependencieswithAIAHomeas

well,makingitnecessarytobeoneachserver.

DBHOST1/DBHOST2ServersthathosttheinstancesoftheRACdatabase.Thisis

usedasadehydrationstoreforSOA.ThesamedatabasecanalsostoreAIAspecific

datalikeXREF,CAVS/BSRdata,AIAQueuesetc.

OIDisnotconsideredinthistopology,astherearenoAIAspecificconsiderations.PleasefollowtheSOASuitebestpractices.

DBHOST3/DBHOST4ItisnotnecessarytousetheSOAdatabaseforAIA

schema/dataalso.UserscanoptionallychoosetouseanotherdatabasetostoreAIA

specificdatalikeXREF,CAVS/BSRdata,AIAQueuesetc.

8/2/2019 057344

10/37


8

Figure 2: Topology A for AIA Foundation Pack deployment

Topology B

Inthistopologytheloadbalanceracceptsexternalrequestsandinturnredirectsrequeststo

serversthathostbothOracleHTTPServerandBPEL/ESBapplicationsinthesameOracle

Home.TheApplicationSevernodesinturnpointstoasingleOracledatabasethatstoresboth

AIAandSOAdata.TheLoadbalancerhasonevirtualhosttoredirectincomingrequeststoone

ofthetwoservers

8/2/2019 057344

11/37


9

Figure 3: Topology B for AIA Foundation Pack deployment

Oracle Service Registry Topology Considerations

AsapartofAIAInstallationAIAservices(EBO,EBS,ABCSetc)arepublishedtoBSR

(BusinessServiceRepository).DetailsofOSR(OracleServiceRegistry)iscollectedduring

installation,andAIAserviceshavetobemanuallypublishedtoOSRasapostinstallactivityas

detailedintheAIAInstallationGuide.

BSRisanAIAdeliveredrepositoryandisAIAskeyvaluepropositionforSOAgovernance.

BSRprovidesbothdesigntimeandruntimeinformationaboutservices,andmodelstheir

interdependenciestorepresentAIAprocessflowsandPIPs.

BSRinfrastructureiscomposedofJ2EEapplicationsandDatabaseartifacts.AIAFoundationPacksEBO/EBSarerepresentedinthisinfrastructureandPIPswilluseBSRtopublish

metadataaboutPIPspecificservicesandtheirinter-dependencies.

InstallationofBSRinfrastructureismandatoryandisautomaticallyinstalledwithAIA

FoundationPackinstallation.

8/2/2019 057344

12/37


10

OSRontheotherhandisaseparateOracleproductthatisusedtopublishrun-timeinformation

aboutrawservicesthatmakeupAIA.Servicesthuspublishedcanbediscoveredacrossthe

enterprise.OSRwillcontaininformationofallEBSandABCSserviceimplementations.

OSRisdeployedasanapplicationinoracleSOASuite.TherearethreeoptionsAIAinstallation

provideseveninasingleserverinstallation.

No OSR InstallationAIAhasnorun-timedependencyonOSR

HenceitispossibletoinstallandrunAIAwithouthavinganOSRinstallation.AIA

InstallerprovidestheoptiontoskipthescreenwhereOSRdetailsarecollected.

Note:Atanylaterpoint,ifadecisiontoincludeOSRismade,AIAservicescanbe

publishedtothatOSR.AdditionalInformationisavailableintheAIACore

InfrastructureComponentsGuide.

OSR can be installed in the same Application Server thathostsAIABPEL/ESB

processes

Figure 4: OSR in the same APPHOST as AIA

OSR can be installed in a completely different Application server.Thisis

importantwhenAIAservicesaretobepublishedinanenterprise-wideserviceregistry

Installation of BSR infrastructure is mandatory and is automatically installed with AIA Foundation Pack installation.

OSR on the other hand is a separate Oracle product that is used to publish run-time information about raw services

that make up AIA.

8/2/2019 057344

13/37


11

thatisalsobeingusedtopublishnon-AIAservices.(PublishingAIAservicestoremote

serversissupportedfromFPrelease2.2.1onwards)

Figure 5: OSR in a different APPHOST than AIA

Inaddition,OracleServiceRegistryproductalsoprovideswaystoachieveclusteredOSR

implementationstherebyprovidinghighavailabilityforregistryaccess.Thisagainisoptional.

Moreinformationisavailableat

http://www.oracle.com/technology/tech/soa/uddi/osr_cluster_config.pdf
http://www.oracle.com/technology/tech/soa/uddi/osr_cluster_config.pdfhttp://www.oracle.com/technology/tech/soa/uddi/osr_cluster_config.pdf

8/2/2019 057344

14/37


12

Ensuring that the SOA is setup correctly

SinceAIAisanapplicationrunningcompletelyonSOASuiteitisimportanttoensurethatSOA

setupwasperformedcorrectly,beforeproceedingwithAIAInstallation

Setting SOA parameters

ThefollowingareSOASuiteparameterstobesetupcorrectlytoensureasmoothAIA

installation.

1. Memory Settings

LogintoOracleEnterpriseManager.PerformthebelowstepsonbothAPPHOSTs

Clickoc4j_soa.

ClickAdministrationtab.

ClickServerPropertiesandadjustsettingsonthispageasfollows:

o InitialHeapSize:Setto1024M

o MaxHeapSize:Setto1024M

UnderOptions,ensurethatthefollowingparameterisupdatedorset:

o -XX:MaxPermSize=512M

o -XX:MaxNewSize=614m

o -XX:NewSize=614m

o -XX:AppendRatio=3

o -XX:SurvivorRatio=6

Note: Thesearerecommendedvalues.Actualvaluesthatyousetdependonyour

systemconfigurations.Whenrunningondedicatedhosts,youcansettheJVMheap

sizeashighaspossible.Howeverthisnumberisconstrainedbytheoperating

system'saddressablememoryspace.

2. Order of Restart

Important: Itisnotnecessarytoperformrestartrightnow.WheneverSOA

Servershavetostoppedorstartedinthelatersectionsofthispaper,ensurethat

youfollowthemethodbelow.

Alwaysrestartcontainersseparatelyinthefollowingmanner

OnAPPHOST1

8/2/2019 057344

15/37


13

OnAPPHOST2,

Toknowthestatusoftheclusterexecutethefollowingfromthenodethatisalive

Fromthefolder/opmn/binexecutethefollowingcommandtoseethe

status(linux)

3. Opentheserver.xmlfromORACLE_HOME/j2ee/oc4j_soa/configandmakesure

thatthelinesbeginningwithfollowingareinthegivenorder.

IfBPEL+ESBRTisinstalledinadifferentcontainerotherthanoc4j_soa,thepath

toserver.xmlreflectsthatcontainernameinsteadofoc4j_soa.Performtheabove

changesinbothAPPHOSTs

4. OpenthefileSOA_HOME/integration/esb/config/esb_config.ini

Addthefollowinglinesattheendofthefile(ThiswillensurethattheESBDT

startsupcorrectly)

PerformtheabovechangesinbothAPPHOSTs.RestartSOAusingthecommands

instep2.

./opmnctl shutdown (this is to stop all containers)

./opmnctl start (this starts the opmn)

./opmnctl startproc process-type=HTTP_Server

./opmnctl startproc process-type=ADMIN (or whichever is your admin node name)

./opmnctl startproc process-type=oc4j_esbdt (or whichever is the name of the ESB DT container)

./opmnctl startproc process-type= oc4j_soa (or whichever is the name of the BPEL and ESBRT container)

./opmnctl shutdown (this is to stop all containers)

./opmnctl start (this starts the opmn)

./opmnctl startproc process-type=HTTP_Server

./opmnctl startproc process-type= oc4j_soa (or whichever is the name of the BPEL and ESBRT container)

./opmnctl @cluster status

PingInterval=30

PingCount=30

8/2/2019 057344

16/37


14

Verifying SOA Cluster setup

Thefollowingarebasicverificationsteps(notcomprehensive)toensurethatyourSOAclusteris

setupcorrectlyaspertheEDG.

NavigatingtotheBPEL,ESBconsolessuccessfullyusingtheexternalLoadBalancerURLaswellaseachoftheinternalvirtualhost.

EnsuringthattheEMconsoleshowsallparticipatingnodesinactivestate.Theremust

beonlyoneActiveDesigntime.

EnsurethatESBDesign-timeiscompletelyupandrunningbyaccessingthefollowing

URL

http://host:port/esb/dtStatus.jsp.Thispageshouldreturnatrue

DeployingasampleBPELprocess(shippedwithBPEL)andasampleESBprocess

(againshippedwithESB)andensuringthatitissuccessfullydeployedontheSOA

cluster(availableonbothAPPHOST1andAPPHOST2) CreateasamplesystemfromESBConsole.

Afteryoucomplete,remembertoundeploythesamplesanddeletethepreviously

createdsystem.

VerifythatyoudonthaveanyexistingapplicationsinyourSOAclusterstartingwith

default_

ForexampleifyouhaddeploytheLoanFlowdemo,itwouldvecreatedsuch

applications.Tocheckthis

o OpentheEMConsole

o Navigatetothecontainer

o IntheApplicationstab,drilldownfromBPEL>orabpel.

o Selectanyapplicationstartingwithdefault_andundeploy

UseHTTPmonitoringtoensurethatbothHTTPServersserverequests

AccessingRACdatabaseusingatoollikeTOADtoperformsuccessfulquery,insert

operations(usingindividualDBHOSTTNSentriesaswellasRACTNSentry)

Ensurethatallotherconfiguration(likeupdatingESBmetadata,Configuringslide

repositoryetc)isperformedcorrectlyaspertheEnterpriseDeploymentGuide.

AspertheEnterprisedeploymentguideensurethatthesoapServerURLissettointernalvirtualhosthttp://soainternal.mycompany.comandthesoapCallbackUrltoexternal

virtualhosthttp://soa.mycompany.com

IfyouarenotusingSSLforexternalaccess,boththesepropertiesshouldpointto

http://soainternal.mycompany.com

8/2/2019 057344

17/37


15

Ensurethattheclusterflagissettotrue

8/2/2019 057344

18/37


16

Preparing the APPHOSTn and WEBHOSTn for AIA deployment

Attheendofthissection,youwillmakeavailableallthenecessaryAIAsoftwareinthe

APPHOSTnandsetuptheconfigurationrequiredtoperformthemanualdeploymentdetailedinthenextsection(usingtheinstallscriptsdeliveredthroughthissection)

Tobeginwith,theSOAclusterthatyousetupshouldhaveAPPHOST1,2andWEBHOST1,2

(applicableinthecaseofTopologyAonly)upandrunning.YourESBDTcontainershouldbe

downononeAPPHOSTandshouldbealiveintheotherAPPHOST.RefersectionEnsuring

thattheSOAissetupcorrectlyforthecorrectstepstoquerystatusoftheSOAServer.

Figure 6: opmn status for Topology A

8/2/2019 057344

19/37


17

Figure 7: opmn status for Topology B

Setting up APPHOSTn

Important:ThefollowingstepshavetobeperformedinbothAPPHOST1andAPPHOST2

1. LaunchtheAIAinstallerasperinstructionsintheAIAInstallationGuide.Provide

theAIAHomedirectoryandchoosetheoptionCopyAIASoftwareOnlyoption

ChoosingthisoptionandclickingNextandInstall,shoulddirectlycopyonlythe

contenttotheselectedAIAHomewithoutpromptingforSOAServer,Database

orServiceRegistryinformation.

2. ThepreviousstepwilldeliverAIA_HOME(containingallFPcontentandscripts)

onAPPHOSTn.

3. Copythedeploy.properties.tmplfiletemplatefrom

AIA_HOME/Infrastructure/install/templatesfoldertothelocation,

AIA_HOME/configandrenameittodeploy.properties

4. Inthisdeploy.propertiesfile,

o Forthehttp.host/http.portprovidetheinternalvirtualhostdetails

(soainternal.mycompany.com)

o Forthej2ee.hostnameprovidetheinformationofAPPHOST1/APPHOST2

o ForthedatabaseprovidethedetailsoftheDatabasethatyouwanttohostAIA

artifacts.ThiscanbethesameasSOAdatabaseoraseparatedatabaseasmentionedintheTopologiesSectionofthispaper.

IfyouareusingRACprovidetheinformationofoneoftheinstancesthatisa

partoftheRAC.Forexampleindeploy.propertiesofAPPHOST1use

8/2/2019 057344

20/37


18

DBHOST1SIDandforAPPHOST2useDBHOST2.Laterwewillmodify

referencesofdata-sourcesandconnectionpoolstopointtoRAC.

IfyouareusingXAandDistributedTransactionProcessing(DTP)providethe

correspondingDTPservicenameforeachAPPHOST

FormoreinformationonDTPandXAforSOASuite,refer

http://www.oracle.com/technology/tech/soa/pdf/oracle-soa-suite-xa-rac-

guide.pdf

o Theportinformationshouldbeavailablefromtheruntimeportinformation

onemconsole

o Useoc4j_soafortheinstancename.(Note:Thismustbetheinstance

runningBPEL)

o Fortheserviceregistrydetails,youcanprovidetheinformationofthelocal

nodeoraremoteserverorskipthefields.ReferOracleServiceRegistry

TopologyConsiderationsformoreinformation.Ifyouwanttocompletelyskip

publishingAIAartifactstoserviceregistryleavethesefieldsempty

5. Intheant-orabpel.propertiesfile(foundinthedirectory

/bpel/utilities)ensurethat:

o hostname=soainternal.mycompany.com

o http.port=7777(internalLBRport)

o cluster=false

o oc4jinstancename=theOC4JinstancewhereBPELisinstalled.Example

oc4j_soaforthistopology.ThisshouldNOTbethesoa_groupOC4J

containerofthecluster

o j2ee.hostname=ThehostnameofAPPHOST1/APPHOST2

o asinstancename=(thissettingshouldnothaveavalue.Itshouldbeblank.)

6. Completethefollowingsteps.

o Openthefileaiaenv.sh(aiaenv.batinthecaseofWindows)under

AIA_HOME/bin.

o Setthevaluesforallpropertieslikeaia_home,ant_home,oracle_home,

java_home,oracle_registry_home,aia_instance

(/j2ee//applications)o Executethefollowingcommand

source aiaenv.sh (linux)

aiaenv.bat (windows)
http://www.oracle.com/technology/tech/soa/pdf/oracle-soa-suite-xa-rac-guide.pdfhttp://www.oracle.com/technology/tech/soa/pdf/oracle-soa-suite-xa-rac-guide.pdfhttp://www.oracle.com/technology/tech/soa/pdf/oracle-soa-suite-xa-rac-guide.pdfhttp://www.oracle.com/technology/tech/soa/pdf/oracle-soa-suite-xa-rac-guide.pdfhttp://www.oracle.com/technology/tech/soa/pdf/oracle-soa-suite-xa-rac-guide.pdf

8/2/2019 057344

21/37


19

o Executethefollowingcommand

Setting up WEBHOSTn

Thefollowingstepshavetobedoneonallwebhosts.

1. EnabledirectorybrowsingintheApacheserverofbothWEBHOST1and

WEBHOST2byeditingthehttpd.conffile.Thisfileisat

/Apache/Apache/conf/httpd.conf.

2. Toeditthehttpd.conffile:

o Openthefileusingatexteditor,suchasvi.

o SearchforOptionsFollowSymLinksMultiViews.Therearetwooccurrences.

o AddthewordIndexestotheendofOptionsFollowSymLinksMultiViewsfor

thesecondoccurrence.

o Afteraddingit,thetextlookslikethis:OptionsFollowSymLinksMultiViews

Indexes

3. RestartHTTPApacheserver.Important:Thefollowingstepshavetobeperformed

inbothAPPHOST1andAPPHOST2

Note:ifyouprefertohaveyourwebtierlightweightanddontwantAPPHOSTstoaccess

yourwebtieracrosstheDMZtoretrievethecontent,youcanlaterbundleupalltheAIA

contentasseparate.earfileanddeployittoyourAPPHOSTnandsetredirections

accordingly.Thispaperwillnotelaboratefurtheronthisapproachandwillconsiderthe

contenttobeinWEBHOST.

IncaseofTopologyB,therearenoseparateWEBHOSTs.Sofollowthesamestepsabove

inAPPHOST1andAPPHOST2

cd ANT_HOME/bin

chmod 775

8/2/2019 057344

22/37

8/2/2019 057344

23/37


21

5. Nextweneedtocreate/deployDatasources,Connectionpools,AIAj2ee

application/servletandErrorhandlingMDB.

6. Executethefollowingscriptsoneaftertheother,whilebeinginthe

AIA_Home/Insfrastructure/install/scriptsdirectory

7. YoushouldseeconnectionPools,datasources,MDBetc

8. ThiscompletesstepEofsection4.

9. NowwhenyouchecktheEMconsole,noconfigurations(connectionpools,

datasources,MDBetc.)shouldhavebeencreatedforAPPHOST1

10. Incaseyouseeanyofthem,manuallyundeploythemusingtheundeployactions

onEM.

11. NowbringdownSOAserveronAPPHOST2

On WEBHOSTn (Applicable only to Topology A)

ThestepsbelowareonlyapplicabletoTopologyA.IfyouareusingTopologyB,skipthis

section.

WewillcopytheHTTPcontentcreatedintheApachefolderonAPPHOST2,totherealApache

foldersonWEBHOST1andWEBHOST2.

1. Fromthedirectory/Apache/Apache/htdocsonAPPHOST2,

copyrecursively(includeallsubfoldersandtheircontents)tothesamedirectory

structureunderWEBHOST1.Ifaskedtooverwriteanyfileschoosetheoptionto

overwrite.

Ant --noconfig -buildfile FPCommonConfig.xml CreateCommonDatasources

ant --noconfig -buildfile FPCAVSInstall.xml createSchedulerDataSource

ant --noconfig -buildfile FPErrorHandlingInstall.xml DeployESBErrorListenerMDB

ant --noconfig -buildfile FPCAVSInstall.xml DeployAIAUI

8/2/2019 057344

24/37


22

2. Similarly,fromAPPHOST2,copythecontentsfromthedirectory

/Apache/Apache/htdocsrecursively(includeallsubfoldersand

theircontents)tothesamedirectorystructureunderWEBHOST2.Ifaskedto

overwriteanyfileschoosetheoptiontooverwrite.

3. RestarttheHTTPserverofbothWEBHOST1andWEBHOST2

On APPHOST1

ThefollowingstepshavetobefollowedonAPPHOST1

1. EnsurethatAPPHOST2isdown.

2. AlsoensurethatAPPHOST1andWEBHOST1,2(inthecaseofTopologyAonly)

isupandrunning.

3. InAPPHOST1createanemptyfilecalledhttpd.confinthefolder/Apache/Apache/htdocs

ThisstepisrequiredonlyinthecaseofTopologyA

4. FromAIAHOMEdirectoryonAPPHOST1,navigatetothefolder

Infrastructure/install/scripts

5. Fromthecommandlineexecutethecommand

6. VerifyifallAIAprocessesweredeployedasperAIAinstallationguideverification

chapters.VerifyifAIAConnectionpoolsandAIAdatasourcesarecreated.

7. NowbringupAPPHOST2.ThisshouldpropagateallBPELprocessto

APPHOST2.

8. VerifythattheAIAdatasourcesandAIAconnectionpoolexistonAPPHOST2.

ThiscompletesthedeploymentofAIAFPonaSOAcluster.

Completethestepsprovidedinthesectionbelow,PostInstallActionsforPIPdeploymentson

AIAFPcluster

source /bin/aiaenv.sh

ant --noconfig buildfile FPInstall.xml > FPInstall.log

8/2/2019 057344

25/37


23

Post Install actions for AIA FP installation on SOA cluster

ThefollowingarethepostinstallactionstobeperformedaftertheinstallationofAIAFPon

SOACluster.ThesestepshavetobeperformedforAIAtoworkcorrectlyandarerequiredtobedonebeforePIPsareinstalledonthecluster.

1. InAPPHOST2sEMconsole,ifyoudrilldownintotheoc4j_soacontainer,you

wouldNOTfindtheTaskformsdeployed.

2. NowonAPPHOST2,executethefollowingcommandfromAIA_HOME/bin

directory

3. OpentheAIAErrorTaskAdminstrationProcessfolderunder

AIA_HOME/Infrastructure/ErrorHandlingfolder.

4. Executefromthesamefolder

5. ThisshoulddeploytwotaskformprocessesonAPPHOST2.

6. OnAPPHOST1,navigatetotheAIAReadJMSNotificationprocessfolderunder

AIA_HOME/Infrastructure/ErrorHandling

7. InthebpelfolderopentheconsumeFaultMsg.wsdl,addthefollowingtag,afterDestinationName="java:comp/resource/AIA_ERROR_JMS/Topics/AIA.AIA_E

RROR_TOPIC"

8. Openthefile,

AIA_HOME/Infrastructure/Errorhnadling/AIAReadJMSNotificationProcess/bpe

l/bpel.xml.AddtheboldedlineintheactivationAgentsexistingsnippet.Thestring

forclusterGroupIdcanbeanything.

source aiaenv.sh

ant noconfig deploytaskform

DurableSubscriber="AIAReadJMSNotificationAgent"

8/2/2019 057344

26/37


24

9. RepeatlastthreestepsonAPPHOST2

10. OpentheESBConsoleandverifythedetailsofeachofthesystems(AIASystem,

DefaultSystemandBPELSystem).

TheValuesmustbeasfollows.Ifnot,pleasechangeasfollowsandpressApply

Cluster Name:ThevaluedefinedforClusterNamein

/integration/esb/config/esb_config.iniorthevaluein

/j2ee//applications/esb-rt/META-INF/orion-application.xml

Virtual Host:LoadBalancerURL

Port:LoadBalancerPortnumber

Topic Location and Connection Factory Location:ThevalueforJMSTopic

shouldbethesameastheonethatissetasDEFERRED_TOPICin

ESB_PARAMETERtableDT_OC4J_HOST.

Normally,thesevalueswouldbeESBTopics/Topics/ESB_JAVA_DEFERRED

andthefactoryisOracleOJMS/XATCF

Number of Listeners: Thevaluewouldbe111. IfyouwereusingRACdatabase,thenyouneedtoensurethatAIArelated

datasourcesandconnectionpoolspointtotheRACURL

OntheEMconsole,navigatetotheJDBCresourcesoftheoc4j_soacontainerand

modifyAIAConnectionpoolinformationasfollows.

ChangetheJDBCURLtoRACformat.Typicallythiswouldbeoftheformat

PerformthisonbothAPPHOSTs

Additionally,intheAIAConfigurationProperties.xmlfile)foundin

AIA_HOME/config)makesurethattheEH.AQ.DB.XXdetailsaresetasthe

individualnodesoftheRAC.

Consume_Message_ptt

MyCluster

Jdbc:oracle:thin:@(DESCRIPTION=(LOAD_BALANCE=on) (ADDRESS=(PROTOCOL=TCP)(HOST=host1)

(PORT=1521)) (ADDRESS=(PROTOCOL=TCP)(HOST=host2)(PORT=1521))

(CONNECT_DATA=(SERVICE_NAME=service_name)))

8/2/2019 057344

27/37


25

SoinAPPHOST1setittoonenodeoftheRAC.InthesamefileinAPPHOST2

setthepropertiestotheothernodeoftheRAC.

IfyouareusingXAandDistributedTransactionProcessing(DTP)providethe

correspondingDTPservicenameforeachAPPHOSTinthe

AIAConfigurationProperties.xmlfile.AlsointheConnectionpooloneach

APPHOSTprovidethecorrespondingDTPservicenameinsteadofmodifyingto

theRACURLabove.



guide.pdf

12. InbothAPPHOST1andAPPHOST2,verifythefollowingvalues

Intheant-orabpel.propertiesfile(foundinthedirectory

/bpel/utilities)ensurethat:



o cluster=false

o local.oc4jinstancename=theOC4JinstancewhereBPELisinstalled.

Exampleoc4j_soaforthistopology.ThisshouldNOTbethesoa_group

OC4Jcontainerofthecluster

Note: This property should be manually added

o oc4jinstancename=Thisshouldbethesoa_groupOC4Jcontainerofthecluster

o j2ee.hostname=ThehostnameofAPPHOST1ORAPPHOST2

o asinstancename=(thissettingshouldnothaveavalue.Itshouldbeblank.)

Indeploy.propertiesfile(foundinthedirectory/config)

ensurethat:



o

j2ee.hostname=APPHOST1ORAPPHOST213. EnsurethatthesoapServerURLissettointernalvirtualhost

http://soainternal.mycompany.comandthesoapCallbackUrltoexternalvirtual

hosthttp://soa.mycompany.cominbothAPPHOST1andAPPHOST2

8/2/2019 057344

28/37


26

IfyouarenotusingSSLforexternalaccess,boththesepropertiesshouldpointto

http://soainternal.mycompany.com

Ensurethattheclusterflagissettotrue

14. Restartbothnodes.

15. VerifythattheESBDTcontainerisdowninonenodeandupintheother.

ThiscompletestheinstallationofAIAFoundationpackonaSOAcluster.

8/2/2019 057344

29/37


27

Steps for Deployment of AIA PIPS on AIA FP clustereddeployment

EnsurethatyouhavecompletedinstallingAIAFPontheSOAclusterbeforeproceedingwiththissection

Thefollowingisthehighlevelstepsthatwewillbeperformingtocompletethedeploymentof

anygivenPIPonanAIAFPclusterinstallation(performedabove)andisapplicableforboth

TopologyAandTopologyB

Wewouldexecuteafewinstallscriptstocompletetheinstallationoneachnode.

OnAPPHOST2,wewouldexecutetheinstallationscriptsmanually.Thescriptswe

executewouldcorrespondtostepsAandDofsection2.

OnWEBHOST2andWEBHOST1wewouldcopytherequiredHTTPcontentintothese

hosts,coveringstepAofsection2ineachnode.

ThisstepisrequiredonlyinthecaseofTopologyA

OnAPPHOST1,wewouldagaincopyalltheAIAcontentandtheinstallscriptstothe

disk.WewouldusetheAIAInstallertocoverallsteps(A,B,C,DandE)mentionedin

section4.

Important:Youneedtofollowtheaboveactionsinthesamesequence

On APPHOST2


1. ShutdownSOAServeronAPPHOST1.

2. EnsurethatAPPHOST2andWEBHOST1,2(inthecaseofTopologyAonly)is

upandrunning.

3. Inthedeploy.propertiesfileunderAIA_HOME/config,

ProvideallinformationoftheparticipatingapplicationsthatyourPIPuses.For

exampleforO2CyouwillbeprovidingSiebelandE-BusinessSuite

information

Retainallotherinformation,asitexists.

4. IfyouareinstallingaPIPXYZ,modifythefollowingfilesin

AIA_HOME/PIPS/Core/Setup/Install/XYZ

Executethefollowingcommand

8/2/2019 057344

30/37


28

Intheresultifyouseehttp.hostnameuseaneditortochangeitto

j2ee.hostname.Forexample

5. FromAIA_HOME/bindirectoryexecutethefollowingcommand.(linux)

6. Executethefollowingscriptsoneaftertheother,whilebeinginthedirectory

AIA_HOME/PIPS/Core/Setup/Install/XYZ.

7. ThiscompletesstepAofsection2.

8. NowwewillcompletestepDofsection2

9. YoushouldseeconnectionPools,datasourcesthatarespecifictoyourPIP.

10. ThiscompletesstepDofsection4.

11. OnAPPHOST1,whenyouchecktheEMconsole,noconfigurations(connection

pools,datasourcesetc.)shouldhavebeencreated.

12. Incaseyouseeanyofthem,manuallyundeploythemusingtheundeployactions

onEM.

13. NowbringdownAPPHOST2

grep "opmn:" *.xml

name="deployer.uri"

value="deployer:oc4j:opmn://${http.hostname}:${opmn.port}/${iasinstancename}/${oc4jinstancename}

name="deployer.uri"

value="deployer:oc4j:opmn://${j2ee.hostname}:${opmn.port}/${iasinstancename}/${oc4jinstancename}

source aiaenv.sh

Ant --noconfig -buildfile Install.xml CopyAIAComponents.xml

Ant --noconfig -buildfile Install.xml ConfigDataSources.xml

ant --noconfig -buildfile Install.xml ConnectionFactory.xml

8/2/2019 057344

31/37


29

On WEBHOSTn (Applicable only to Topology A)

WewillcopytheHTTPcontentcreatedintheApachefolderonAPPHOST2,totherealApache

foldersonWEBHOST1andWEBHOST2.

1. Fromthedirectory/Apache/Apache/htdocs/AIAComponents/onAPPHOST2,copythefolderstothesamedirectorystructureunder

WEBHOST1.

ApplicationObjectLibrary>/

ExtensionServiceLibrary

UtilityArtifacts

Transformations,ApplicationBusinessServiceLibrary

2. Repeattheabove2stepsforWEBHOST2

3. RestarttheHTTPserverofbothWEBHOST1andWEBHOST2

On APPHOST1


1. ShutdownSOAServeronAPPHOST2

2. EnsurethatAPPHOST1andWEBHOST1,2(inthecaseofTopologyAonly)is

upandrunning.

3. Inthedeploy.propertiesfileunderAIA_HOME/config,

ProvideallinformationoftheparticipatingapplicationsthatyourPIPuses.For

exampleforO2CyouwillbeprovidingSiebelandE-BusinessSuite

information

Retainallotherinformationasitexists.

4. IfyouareinstallingaPIPXYZ,modifythefollowingfilesin

AIA_HOME/PIPS/Core/Setup/Install/XYZ

Executethefollowingcommand

Intheresultifyouseehttp.hostnameuseaneditortochangeitto

j2ee.hostname.Forexample

Grep "opmn:" *.xml

8/2/2019 057344

32/37


30

5. Performthefollowingsteps.

NavigatetothefolderAIA_HOME/util/DeployTool/BpelCopy

Openthefilebuild.xmlandsearchforthestringProcessdeployment

targets.add,bsrPublishandsavethefile

NavigatetothetargetbsrPublishreplacehttp.hostnametoj2ee.hostname

IntheAIA_HOME/util/DeployTool/directory,openthefile

Tokenizer.properties

Inthisfile,providethevaluesforthefollowingthreepropertiesandsave

o aia.home=/PIPS

o ESB_COPY_FOLDER=/util/DeployTool/EsbCopy

o BPEL_COPY_PATH=/util/DeployTool/BpelCopy

Runthefollowingcommand

6. FromAIAHOMEdirectoryonAPPHOST1,navigatetothefolder

PIPS/Core/Setup/Install/XYZ

7. Fromthecommandline(windowsorunixbasedsystems)executethecommand

8. VerifyifallAIAprocessesweredeployedasperAIAinstallationguideverificationchapters.VerifyifAIAConnectionpoolsandAIAdatasourcesarecreated.

9. NowbringupAPPHOST2.RefertotheInstallingAIAFoundationPackon

OracleSOASuiteClusterDeploymentspaperonhowtostartupSOAserver.

ThisshouldpropagateallBPELprocesstoAPPHOST2.

name="deployer.uri"

value="deployer:oc4j:opmn://${http.hostname}:${opmn.port}/${iasinstancename}/${oc4jinstancename}

name="deployer.uri"

value="deployer:oc4j:opmn://${j2ee.hostname}:${opmn.port}/${iasinstancename}/${oc4jinstancename}

ant noconfig runbpel

(linux) source AIA_HOME/bin/aiaenv.sh

ant --noconfig f Install.xml > APPHOST1Install.log

8/2/2019 057344

33/37


31

10. VerifythattheAIAdatasourcesandAIAconnectionpoolexistonAPPHOST2.

Thiscompletesthedeployment.

CompletethestepsprovidedinthesectionbelowtoperformPostInstallActions

forPIPdeployment.

8/2/2019 057344

34/37


32

Post Install actions for PIP deployments on AIA FP cluster


1. IfyouwereusingRACdatabase,thenyouneedtoensurethatallAIArelated

datasourcesandconnectionpoolspointtotheRACURL.

ForexampleforO2C2,thisisEbizDB_Pool

OntheEMconsole,navigatetotheJDBCresourcesoftheoc4j_soacontainer

andmodifyourPIPspecificconnectionpoolinformationasfollows.

ChangetheJDBCURLtoRACformat.Typicallythiswouldbeoftheformat

RepeatthesamestepsforbothAPPHOSTs

Note: IfyouareusingXAandDistributedTransactionProcessing(DTP)provide

thecorrespondingDTPservicenameforeachAPPHOSTintheintheConnection

PooloneachAPPHOST.



guide.pdf

2. Restartbothnodes.

3. VerifythattheesbdtcontainerononeoftheAPPHOSTisdownandtherestall

areup.

Jdbc:oracle:thin:@(DESCRIPTION=(LOAD_BALANCE=on) (ADDRESS=(PROTOCOL=TCP)(HOST=host1)

(PORT=1521)) (ADDRESS=(PROTOCOL=TCP)(HOST=host2)(PORT=1521))

(CONNECT_DATA=(SERVICE_NAME=service_name)))

8/2/2019 057344

35/37


33

Upgrading AIA installations on SOA cluster

FPInstallationshouldbeupgradedfirstfollowedbyPIPupgrade.WhileFPupgradeisa

standardprocessPIPupgradehastobedoneonacase-by-casebasisdependingonthecontentoftheupgrade,customizationsperformedetc.

ThestepsforthePIPupgradecanbeextrapolatedfromtheexplanationinthispaper.Beloware

thestepstoupgradeAIAFPClusterinstallation.

Important:ThefollowingstepshavetobeperformedinbothAPPHOST1andAPPHOST2

1. LaunchtheAIAinstallerasperinstructionsintheAIAInstallationGuide.Providethe

AIAHomedirectoryoftheexistingAIAInstallation.

2. OnceyouprovidetheAIA_HOME,theInstallerwillautomaticallydetecttheexistence

ofa2.3FPInstallation.

3. ClickInstall.

4. FromthedirectoryAIA_HOME/bin,executethefollowingcommand

5. NavigatetoAIA_HOME/patchset/Infrastructure/upgrade/scripts

6. Execute

7. ThisshouldupgradeyourFoundationPackinstallationonbothAPPHOSTS.

source aiaenv.sh (linux)

aiaenv.bat (windows)

ant --noconfig -f FP23to24Upgrade.xml copyFP23FilesToAIAHome >$AIA_HOME/Infrastructure/install/logs/FP23to24Upgrade_files.log

ant --noconfig -f FP23to24Upgrade.xml DeployAIAFPCore >

$AIA_HOME/Infrastructure/install/logs/FP23to24Upgrade_deploy.log

8/2/2019 057344

36/37


34

Conclusion

HighAvailabilityisarequirementinmostcaseswhereAIAistobedeployedonproduction

servers.Whilethisguideattemptstoprovidestep-by-stepinstructionstodeployFPandPIPsto

aSOAcluster,thesestepscanbemodified/extrapolatedtosuityourrequirement.

ThestepsinthispaperprovidesrepeatableandautomatedwayofinstallingAIA

processes/artifactstoaSOAclusterinadditiontoensuringthatallSOAandAIAconfigurations

aresetupcorrectlyforasmoothfunctioningofAIAonaclusteredenvironment.

8/2/2019 057344

37/37

Installing AIA on Oracle SOA Suite Cluster

Deployments

Sep 2009

Author: Arvind Srinivasamoorthy, PurushothamKola

Oracle Corporation

World Headquarters

500 Oracle Parkway

Redwood Shores, CA 94065

U.S.A.

Worldwide Inquiries:

Copyright 2009, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only and

the contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other

warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or

fitness for a particular purpose. We specifically disclaim any liability with respect to this document and no contractual obligations are

formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any

means, electronic or mechanical, for any purpose, without our prior written permission.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be t rademarks of their respective

owners

057344

Documents