Professional Documents
Culture Documents
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.
1.2AdvancedConfiguration
1.OntheAdvancedConfigurationpanel,selectSystemComponents.Thedefaultsarefine,butyoudohavetogothroughthepanelstomakethemapply.
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 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