OracleDataIntegrator12cCreatingaCollocatedAgent

Overview

Purpose
ThistutorialwalksyouthroughthestepsthatareneededtouseOracleDataIntegratorStudio(ODIStudio)graphicaltoolstocreateanagentcollocatedwithWLStosupport(amongother
things)schedulingofprocedures.

TimetoComplete
Approximately40minutes.

Introduction
AcommontaskthatisperformedusingODIistosetupandinstallanODIAgent.AftertheODIscenariosarecreated,theycanbescheduledandorchestratedusinganODIAgent,whichis
alightweightJavaprocessthatorchestratestheexecutionofODIscenarios.ThistutorialwalksyouthroughthestepsthatareneededtosetupandinstalltheODIAgent.
ThisisthethirdinaseriesoffourOBEsintheOracleDataIntegrator12c:GettingStartedseries.

Scenario
LindaworksasadatabaseadministratorforExampleEnterpriseCorp(http://www.example.com).InExampleEnterprise,Lindaisresponsibleforperformingdatabasemanagementand
integrationtasksonvariousresourceswithintheorganization.Inparticular,Lindaisresponsiblefordataloading,transformation,andvalidation.Tobeginworkingonherprojects,Linda
createdthenewMasterrepositoryandWorkrepository.Lindaalsocreatedtheprojectandtheproceduretocreatearelationaltableandpopulateitwithdata.NowLindaneedstosetup
andinstallanODIAgentasaservice.ThisagentwillbeusedinthenextOBEtoschedulealaterrunoftheprocedure.Agentsareusedformanyothertasksinadditiontoscheduling.

HardwareandSoftwareRequirements
Thefollowingisalistofsoftwarerequirements:
Asupportedoperatingsystem(theOSshownhereis64bitOracleEnterpriseLinuxrelease5.6(Carthage),otherversionssuchasWindowsaresupportedaswell)
OracleDatabase(theversionshownhereisEnterpriseEdition12.1.0,otherversionsaresupportedaswell)
OracleWebLogicServer(WLS)12c(otherversionsaresupportedaswell).ThisOBErequiresthatWebLogicServer(WLS)isinstalled.IfyoudonothaveWLSinstalled,see
alternateOBEhere.
OracleDataIntegrator12cinstalledasODIEnterprise(theversionshownhereis12.1.2)
ThefollowingisalistofOPTIONALsoftware:
OracleSQLDeveloper12c(includedwithDatabase12cinstall)
IfWLSispresent,itmustbeinthesameMiddlewareHOMEdirectoriesasODI.

Prerequisites
Beforestartingthistutorial,youshouldhave:
StartedOracleDatabaseservicesandcomponentssuchastheListener.
ADatabaseuserwithDBAroleprivilegessuchastheSYSorSYSTEMaccount.
InstalledtheHRschemaincludedintheOracleDatabase.TheSampleSchemasInstallationGuideispartoftheOracleDatabasedocumentationset,andisalsoavailableonlineat:
http://otn.oracle.com.
AlreadyinstalledandconfiguredODIMasterandWorkrepositories(instructionsonhowtodothisarecontainedinthefirstoffourOBEsintheGettingStartedseries).
AlreadycreatedanODIprojectandmappingforaflatfiletoarelationaltable(instructionsonhowtodothisarecontainedinthesecondoffourOBEsintheGettingStartedseries).

1.CreatingtheDomainfortheStandaloneCollocatedAgent

TheagentinthisOBErunsinadomainthatisverysimilarto(butnotdependenton)WebLogicServer(WLS)domains.TheGUIConfigurationWizardusestemplatestodeterminewhich
componentsareneededtosupportthefunctionoftheagent.Therearethreepossiblekindsofagents:
completelystandaloneagent(noWLSinstalled)
standalonecollocatedagent(WLSisinstalled,butisnotbeingused.Theagentisstartedasitsownbinary.ThisOBEusesthiskindofagent.)
JEEagent(WLSinstalledandused.Thedomain,adminserver,managedservers,nodemanagers,andsoonarestartedinthenormalWLSway.Theagentisoneofmanypossible
JEEappsrunninginthedomain.)
TocreatethedomainusingCAM,performthefollowingsteps:

1.1BasicConfiguration
1.StarttheFusionMiddleware(FMW)ConfigurationWizardtocreateadomainfortheagent.ThisistheCommonAdministrationModel(CAM),thoughyoumaynotseethat
termusedanywhere.ItbearsastrikingresemblancetotheWebLogicServer(WLS)domainconfigurator.
OSPrompt
[myuser@myhost~]$cd$ODI_HOME/common/bin
[myuser@myhostbin]$pwd
/u01/app/oracle/Middleware/Oracle_Home/odi/common/bin
[myuser@myhostbin]$ll
total44
rwxrx1oracleoinstall483Feb609:14clonedunpack.sh
rwr1oracleoinstall210Jul1104:37commonslogging.properties
rwxrx1oracleoinstall471Dec192012config.sh
rwxrx1oracleoinstall2312Jul1104:37generate_agent_wls_template.cmd
rwxrx1oracleoinstall1980Jul1104:37generate_agent_wls_template.sh
rwr1oracleoinstall286Jul1104:37jrfportconfig.properties
rwr1oracleoinstall5412Jul1104:37ODIloggingconfig.xml
rwxrx1oracleoinstall467Dec192012pack.sh
rwxrx1oracleoinstall471Dec192012unpack.sh
rwxrx1oracleoinstall1748Dec192012wlst.sh
[myuser@myhostbin]$./config.sh

Notethatthereareotherdifferentversionsofconfig.shinotherFMWdirectories,butthisistheoneyouwantforcreatinganODIagent.Thesplashscreendisplaysbriefly.

2.FormostofthenonAdvancedconfiguration,thedefaultsareadequate.OntheConfigurationTypepanel,leavethedefaults.
IfyoudonotyethaveaWLSdomain,thenthefirstonecreatedwillbecalledbase_domainbydefault.Youcanrenameittosomethingsuchasodi_agentormydomain99,just
makesurethatitremainsin$FMW_HOME/user_projects/domains/.Ifyoualreadyhaveadomainnamedbase_domain,thenyoucannot"create"anotherone,youwould
havetorenameittobase_domain2orsomethingelse,oryoucouldUpdateanexistingdomain.Theparticularsaboutupdatinganexistingdomainareoutsidethescopeof
thisOBE,andarecoveredintheWLScurriculum.

Click Next tocontinue.

3.OntheTemplatespanel,selectOracleDataIntegratorStandaloneCollocatedAgent.ItisstandaloneinthesensethatitdoesnotuseWLS,butitiscollocatedinthe
sensethatWLSisinstalled.Selectingthisoneoptioncausesseveralotheroptionstobeselectedforyou.
CAUTION!DoNOTselectOracleDataIntegratorAgentoritwillnotwork!

Click Next tocontinue.

4.OntheAdministratorAccountpanel,enteryourpasswordtwice.Standardpasswordcomplexityisexpectedandenforced(seenoteinthemessageboxbelowabout8
alphanumericcharacterswithatleastonenumberorspecialcharacter.Forexample,Welcome1wouldqualify.)

Click Next tocontinue.

5.OntheDomainModeandJDKpanel,leavethedefaults.

Click Next tocontinue.

6.OntheDatabaseConfigurationTypepanel,changetheServicetothedatabaseservice(notdatabaseinstance),suchasorcl.us.oracle.com.ChangetheHostName
tolocalhost,changetheSchemaPasswordtothepasswordforDEV_STBthatyoupickedwhenyouranRCU.

Click GetRCUConfiguration tocontinue,stayingonthispanel.

TheConnectionResultLogshouldendwithSuccessfullyDone.Click Next tocontinue.

7.OntheJDBCComponentSchemapanel,leavethedefaults.

Click Next tocontinue.

8.OntheJDBCComponentSchemaTestpanel,leavethedefaults.

TheConnectionResultLogshouldendwithTestSuccessful!Click Next tocontinue.

Insummary,youhavecompletedthefirsthalf,thebasicpartoftheconfiguration.Youmustcontinuewiththesecondhalf,theadvancedconfiguration.

1.2AdvancedConfiguration
1.OntheAdvancedConfigurationpanel,selectSystemComponents.Thedefaultsarefine,butyoudohavetogothroughthepanelstomakethemapply.

Click Next tocontinue.

2.OntheSystemComponentspanel,leavethedefaults.

Click Next tocontinue.

3.OntheODIServerConfigurationpanel,makeanoteofthePort(youwillneedthatnumberlater),andchangetheSupervisorPasswordtothepasswordyoupickedwhen
youranRCU.

Click Next tocontinue.

4.OntheMachinespanel,leavethedefaults.

Click Next tocontinue.

5.OntheAssignSystemComponentstoMachinespanel,leavethedefaults.

Click Next tocontinue.

6.OntheConfigurationSummarypanel,leavethedefaults.

Click Create tomakethedomainandcontinue.

7.OntheConfigurationProgresspanel,thereisnothingtodo.Justmakesurethatitendswiththeprogressbarat100%,andwiththemessage,DomainCreated
Successfully!

Click Next tocontinue.

8.OntheConfigurationSuccesspanel,thereisnothingtodo.

Click Finish toendtheConfigurationWizardandreturntotheOSprompt.

Insummary,youcompletedbothhalvesofthedomainconfiguration.Thiscreatedseveraldirectorieswithconfigurationfilesandscripts.

2.CreatingaPhysicalAgent

ThephysicalagentisabackgroundOSprocessthatcommunicateswithODIviaTCP/IPports.
Tocreate,start,andtestthephysicalagent,performthefollowingsteps:

2.1CreatingaPhysicalAgent
1.StartODIStudiobyrunningodi.sh.
OSPrompt
[myuser@myhost~]$cd$ODI_HOME/studio
[myuser@myhoststudio]$pwd
/u01/app/oracle/Middleware/Oracle_Home/odi/studio
[myuser@myhoststudio]$./odi.sh
OracleFusionDataIntegratorStudio12c
Copyright(c)1997,2013,Oracleand/oritsaffiliates.Allrightsreserved.

Thesplashscreenandprogressbardisplaysbriefly.

2.OntheDesignerorTopologytab,clickConnectToRepository...

OntheEnterWalletPassworddialogbox,enterthepasswordyouchosewhenyouinstalledODI.

Click OK tocontinue.
OntheOracleDataIntegratorLogindialogbox,entertheSupervisor'spasswordyouchosewhenyouinstalledODI.Itmaybeprepopulatedforyou.

Click OK tocontinue.
3.OntheTopologytab,expand

PhysicalArchitecture,thenexpand

Agents.RightclickAgentsandselectNewAgent.

AnunnamedAgentpanelopensontheright.
4.OntheAgentpanel,ontheDefinitiontab,inName,enterthenamethatmatchestheagentyoucreatedwiththeearlierdomainwizard:OracleDIAgent1.
InPort,entertheportthatmatchestheagentyoucreatedwiththeearlierdomainwizard:20910.
VerifythatHostiscorrect.

Saveyourworkbyclicking

,butdonotclosethepanel.Leavethepanelopen.

5.YoushouldnowseethenewagentdisplayontheleftunderTopology>PhysicalArchitecture>Agents.

Insummary,youcreatedthephysicalagentconfigurationforwithinODI.ThispointstotheexecutablescreatedinthepreviousCAMsteps.

2.2StartingtheBackgroundProcess
1.Changetothedirectoryofthedomainthatcontainsthebinaryfiles.Starttheagentusingtheagentnamefromthedomain.Leavethatwindowrunning(perhapsminimizedor
senttothebackofthedesktop.)
OSPrompt
[myuser@myhost~]$cd$FMW_HOME/user_projects/domains/base_domain/bin
[myuser@myhostbin]$pwd
/u01/app/oracle/Middleware/Oracle_Home/user_projects/domains/base_domain/bin
[myuser@myhostbin]$ls
agent.shserver_migrationstartNodeManager.sh
agentstop.shservice_migrationstartscen.sh
diagsetDomainEnv.shstartWebLogic.sh
internalsetODIDomainEnv.shstopComponent.sh
nodemanagersetStartupEnv.shstoploadplan.sh
odi_credtool.shstartcmd.shstopManagedWebLogic.sh
oracledfw0.tmpstartComponent.shstopsession.sh
restartloadplan.shstartloadplan.shstopWebLogic.sh
restartsession.shstartManagedWebLogic.sh
[myuser@myhostbin]$./agent.shNAME=OracleDIAgent1PORT=20910

Theveryfirsttimeyourunthis,youwillgetLOTSofoutputasJavainitializes.Subsequentruntimesthemessageswillbefewer.ThePORTparameterisoptionalbut
recommended.
OSPrompt

/u01/app/oracle/Middleware/Oracle_Home/odi/agent/internal/bin/commODIEnv.sh:line111:
/u01/app/oracle/Middleware/Oracle_Home/odi/agent/../../wlserver/modules/com.oracle.weblogic.security.encryption_1.0.0.0.jar:Permissiondenied
/u01/app/oracle/Middleware/Oracle_Home/odi/agent/internal/bin/commODIEnv.sh:line114:
/u01/app/oracle/Middleware/Oracle_Home/odi/agent/../../oracle_common/modules/com.oracle.webservices.orasaajapi_12.1.2.jar:Permissiondenied
/u01/app/oracle/Middleware/Oracle_Home/odi/agent/internal/bin/commODIEnv.sh:line117:
/u01/app/oracle/Middleware/Oracle_Home/odi/agent/../../wlserver/server/lib/wlthint3client.jar:Permissiondenied
2013080220:54:24.897NOTIFICATIONNewdatasource:
[DEV_ODI_REPO/*******@jdbc:oracle:thin:@localhost:1521/ORCL.US.ORACLE.COM]
2013080220:54:27.058NOTIFICATIONODI1128AgentOracleDIAgent1isstarting.
Container:STANDALONE.AgentVersion:12.1.211/07/2013.Port:20910.JMXPort:21910.
Allowing:127.0.0.1,10.216.4.175,127.0.0.1
2013080220:54:33.457NOTIFICATIONNewdatasource:
[DEV_ODI_REPO/*******@jdbc:oracle:thin:@(description=(address=(host=localhost)(protocol=tcp)(port=1521))(connect_data=(service_name=ORCL.US.ORACLE.COM)(server=dedi
2013080220:54:34.186NOTIFICATIONODI1111AgentOracleDIAgent1started.Agentversion:12.1.211/07/2013.Port:20910.JMXPort:21910.
2013080220:54:34.187NOTIFICATIONODI1136StartingSchedulersonAgentOracleDIAgent1.
2013080220:54:35.678NOTIFICATIONODI1137SchedulerstartedforworkrepositoryworkreponAgentOracleDIAgent1.

Youwanttoseeatthebottomthattheschedulerhasstartedforthecorrectworkrepository.
Insummary,youhavestartedtheexternalprocessassociatedwiththeODIphysicalagent.

2.3TestingthePhysicalAgent
1.YoushouldhavelefttheOracleDIAgent1Agentpanelopenfromstep2.1.4.

Click Test totesttheagentnowthattheprocessisrunningoutsideofODI.

2.TheODIInformationdialogboxshouldsay,AgentTestSuccessful.

Click OK tocontinue.YoumaynowclosetheOracleDIAgent1tab.

Click OK tocontinue.YoumaynowclosetheOracleDIAgent1tab.
Insummary,youhaveconfiguredandstartedaphysicalagent.

3.CreatingaLogicalAgent

MostcomponentsinODIhaveaphysicalandlogicalsidetothem.Youalreadycreatedthephysicalagentwithportsandnames,thelogicalagentismuchsimplerandshorter.
Tocreatealogicalagentthatcorrespondswiththepreviousphysicalagent,performthefollowingsteps:

3.1CreatingaLogicalAgent
1.OntheTopologytab,expand

LogicalArchitecture,thenexpand

Agents.RightclickAgentsandselectNewLogicalAgent.

AnunnamedLogicalAgentpaneldisplaysontheright.
2.OntheLogicalAgentpanel,ontheDefinitiontab,inName,enterMyAgent.InthePhysicalAgentspulldown,selectOracleDIAgent1.

Saveyourworkbyclicking

3.YoushouldnowseethenewagentdisplayontheleftunderTopology>LogicalArchitecture>Agents.

Youcanclosealltheopentabsontheright.
Insummary,youcreatedalogicalagenttomatchthepreviousphysicalagent.

Summary

Inthistutorial,youshouldhavelearnedhowto:
UseCAMtocreateadomainfromatemplateforastandalonecollocatedagent
UseODIStudiotocreateaphysicalagent
StartthephysicalagentbackgroundprocessfromtheOSprompt
UseODIStudiotocreatealogicalagentthatcorrespondstothephysicalagent

Resources
ThefollowingareconceptualorproceduralHelptopicsrelevanttothetopicofthistutorial:
Onlinedocumentation,viewlets,samples,andOLNURLsonOTN:
Currentversion:here
Olderversions:here
Thefollowingspecificcourses:
D82167GC10OracleDataIntegrator12c:IntegrationandAdministration
(replacesD64974GC20OracleDataIntegrator11g:IntegrationandAdministrationEd2)
D82171GC10OracleDataIntegrator12c:NewFeatures
ExternalWebsitesforrelatedinformation:
www.oracle.com/goto/odi

www.oracle.com/goto/odi
OTNCommunityForums
TolearnmoreaboutOracleDataIntegrator12c,refertoadditionalOBEsintheOracleLearningLibrary,orontheODIStudioStartPage.

Credits
LeadCurriculumDeveloper:SteveFriedberg
OtherContributors:ViktorTchemodanov,AlexKotopoulis,JulienTestut