9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

Overview

Purpose
Inthistutorial,youlearnhowtomonitorandtroubleshootaloadplanthatdoesnotexecutesuccessfullyinConfigurationManager.This
tutorialusesadomainonlyloadplanasanexample,butthemonitoringandtroubleshootingstepsapplytoanyfailedloadplanin
ConfigurationManager.

TimetoComplete
Approximately1hour

Introduction
InmostcasesyouwillworkwithOracleSupporttomonitor,troubleshoot,diagnose,andfixloadplanissues.Thistutorialcoverssomeofthe
tasksthatyoumaybeexpectedtoperformaspartoftheoveralltroubleshootinganddiagnosticprocess.Implementersandcustomersare
authorizedtouseConfigurationManagerandODIConsoletomonitorandtroubleshootloadplans.

Scenario
ThegoalofthetutorialsinthisseriesistoenableuserswithanimplementerroletoconfigureanddeployOracleTransactionalBusiness
IntelligenceEnterpriseforHumanCapitalManagementCloudService11.1.1.8.1.Animplementerisresponsibleforperformingtheinitial
setupandconfigurationofOracleTransactionalBusinessIntelligenceEnterpriseforHumanCapitalManagementCloudService.The
implementerrolemaybeperformedbythecustomerorbyanimplementationpartner.

Prerequisites
Thistutorialassumesthatyouhavealreadydefined,generated,andexecutedaloadplaninConfigurationManager,andtheloadplan
returnedanerrorstatusinsteadofacompletedstatus.Formoreinformationaboutmanagingloadplans,refertothefollowingOBEsinthis
series:
ManagingaDomainOnlyLoadPlaninOTBIEnterpriseforHCMCloudService
ManaginganInitialLoadPlaninOTBIEnterpriseforHCMCloudService

MonitoringtheExecutionStatusofaLoadPlan

1.OpenabrowserandentertheURLprovidedbyOracleCloudOpstoopenConfigurationManager.Forexample,https://host
name/biacm.
2.SigninwiththecredentialsprovidedbyOracleCloudOpstoopenConfigurationManager.

3.IntheTaskspaneofConfigurationManager,underLoadPlansAdministration,selectManageLoadPlans.

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

1/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

4.TheManageLoadPlanspageisdisplayed.

5.IntheLoadPlansmasterlist,selecttheloadplanthatyouwanttomonitor.

6.OntheLoadPlanstoolbar,clicktheShowExecutionStatusDetails
screen.

icontodisplaytheOracleDataIntegrator(ODI)Consolesignin

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

2/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

7.ConfirmthatWorkRepositoryisselectedandclickProceed.Ifpromptedtosignin,signintotheOracleDataIntegratorConsoleusing
thesamecredentialsyouusedtosignintoConfigurationManagerandFunctionalSetupManager.

8.TheODIConsoleisdisplayedintherightpaneofConfigurationManager.Ifdesired,clicktheCollapsePanearrow tohidetheTasks
navigationpaneontheleft.

9.WithintheODIConsole,noticethattheLoadPlanExecutionpagefortheselectedloadplanisdisplayedintherightpane.TheLoad
PlanExecutionpagedisplaystheloadplanexecutionnameandloadplandetails.YoucanusetheLoadPlanExecutionpagetoview
detailedinformationaboutthedefinitionandexecutionstatusoftheloadplan.
http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

3/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

detailedinformationaboutthedefinitionandexecutionstatusoftheloadplan.

10.NoticethatthetoppanelintheLoadPlanExecutionpageisExecution.Thispaneldisplaysinformationabouttheloadplanrun,
includingtheinstanceID,loadplanexecutionname,startandendtime,executionstatus,andanyerrormessages.

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

4/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

11.Iftheexecutionstatusshowsanerror,youmustworkwithOracleSupporttotroubleshootanddiagnosetheissuesthatcausedtheload
plantofail.Troubleshootingiscoveredinmoredetailintheremainderofthistutorial.

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

5/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

12.ScrolldowntotheDefinitionpanel.Thispaneldisplaysinformationabouttheloadplandefinition,suchastheparentfolder,
description,andlogdetails.

13.ScrolldowntotheRelationshipspanel.Thispaneldisplaysinformationaboutstepsincludedintheloadplan,variablesassociatedwith
theloadplan,andsessionsincludedintheloadplan,includingstartandenddates.

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

6/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

14.ClicktheSessionstab.Thistabdisplaysinformationaboutthestatusoftheindividualsessionsincludedintheloadplan,includingstart
andenddates.

TroubleshootingaFailedSessioninaLoadPlan

InmostcasesyouwillworkwithOracleSupporttotroubleshoot,diagnose,andfixloadplanissues.ThistopicshowsyouhowtouseODI
Consoletolocatedetailedinformationaboutafailedsessioninaloadplan.Insomecasesyoumaybeaskedtosharethisinformationwith
OracleSupport.Pleasenotethescreenshotsinthissectionarefordemonstrationpurposesonly.YourODIConsolecontentwillvary
dependingontheresultsofyourloadplanexecution.
1.IntheStatuscolumnoftheSessionstab,clicktheSortDescendingarrow.

2.Ifthereareanyerrors,usingSortDescendingwilldisplaysessionswithErrorstatusatthetopofthelist.

3.Ifthereareerrors,clickthesessionnameintheSessionNamefieldtonavigatetotheSessionDetailspage.

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

7/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

4.OntheSessionsDetailspage,noticethattheerrorisdisplayedintheExecutionStatisticssection.

5.ScrolltotheRelationshipsareaandselecttheSessionStepstab.

6.Notethestep(s)thatfailed.

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

8/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

7.ClickthefailedstepnametonavigatetotheSessionStepDetailpage.

8.TheSessionStepDetailpageisdisplayed.

9.ScrolldowntotheRelationshipspanel.

10.IntheSessionTaskslist,locatethesessiontaskwitherrorstatus.

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

9/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

11.IntheSessionTaskslist,clicktheTaskTypelinkforthesessiontaskwitherrorstatustonavigatetotheSessionTaskDetailpage.

12.NoticethattheSessionTaskDetailpageprovidesdetailedinformationaboutthefailedtask,includinganycommandssenttothe
source.ThisisinformationthatOracleSupportmayaskyoutoprovidewhentroubleshootingafailedloadplan.

13.Clickthereturnarrow intheupperleftcornertoreturntotheLoadPlanExecutionpage.

14.Ifnecessary,repeatthestepsinthissectiontoreviewthedetailsforanyotherfailedsessions.

SettingtheStatusforaFailedSessiontoMarkasComplete
http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

10/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

InsomecasesyoumaybeaskedbyOracleSupporttouseODIConsoletomarkastepascomplete.Whenyoumarkaloadplanstepas
complete,itensuresthatwhentheloadplanisrestarted,themarkedstepisnotexecuted.Typically,youwanttoworkwithOracleSupportto
identifyandfixthecauseofanerrorandensurethatthecompleteloadplanrunssuccessfully.Therefore,youshouldnotuseMarkas
CompleteunlessinstructedtodosobyOracleSupport.Again,thescreenshotsinthissectionarefordemonstrationpurposesonly.YourODI
Consolecontentwillvarydependingontheresultsofyourloadplanexecution.
1.Ifnecessary,clickthearrow intheupperleftcornertoreturntotheLoadPlanExecutionpage.

2.Ifdesired,clicktheCollapsePanearrowatthebottomleftofthepagetohidetheBrowse/Managementnavigationpaneontheleft.

3.ScrolltotheRelationshipssectionandclicktheStepstab.

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

11/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

4.RightclickthewhitespaceintheStatusfieldnexttothehigheststepinthehierarchy(StartLoadPlan)andselectCollapseAllBelow.

5.Onlythehigheststepinthehierarchy(StartLoadPlan)isvisible.

6.IntheStepsHierarchyfield,beginbyexpandingStartLoadPlan,andnoticethatasyoudrillintothestepshierarchy,thestatusfor
somestepsismarkedasDone andforothersasError .IftheloadplanhasbeenrestartedsomestepsmaybemarkedasDone
inPreviousExecution .Whenlowerlevelstepsfailinthestepshierarchy,relatedhigherlevelstepsarealsomarkedwithanError
status.

7.ContinuetoexpandthestepsmarkedaserroruntilyoureachthestepthatOracleSupporthasinstructedyoutomarkascomplete.

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

12/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

8.RightclickinsidetheStatusfieldforthefailedstepandselectMarkasComplete.

9.ThestatuschangesfromError toDone .Again,whenyoumarkaloadplanstepascomplete,itensuresthatwhentheloadplan

isrestarted,themarkedstepisnotexecuted.Typically,youwanttoworkwithOracleSupporttoidentifyandfixthecauseofanerror
andensurethatthecompleteloadplanrunssuccessfully.Therefore,youshouldnotuseMarkasCompleteunlessinstructedtodoso
byOracleSupport.

10.RepeattheprecedingstepstolocatetheotherfailedexecutionstepsandsetthestatustoMarkasComplete"asdirectedbyOracle
Support.

RestartingaLoadPlan

Insomecases,suchasaftermarkingasessionstepascomplete,youmaybeaskedbyOracleSupporttorestartafailedloadplan.Thistopic
showsyouhowtouseODIConsoletorestartafailedloadplan.
1.ReturntotheNavigationpaneandselecttheBrowsetab.Pleasenote:IfyoucollapsedtheBrowse/Managementnavigationpane
earlierinthistutorial,clicktheRestorePanearrowatthebottomleftofthepagetodisplaytheBrowse/Managementnavigationpane
ontheleft.

2.ExpandRuntime>Sessions/LoadPlanExecutions>LoadPlanExecutionsandselectthefailedloadplanthatyouwanttorestart.

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

13/15

9/8/2016

MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise

3.Whenyouselecttheloadplan,theNavigationTabtoolbardisplaysiconsfortheactionsavailableforthisobjectornode.Ifanactionis
notavailableforthisobject,theiconisgrayedout.

4.ClicktheRestarticon
loadplan.

inthetoolbar.TheRestartbuttonisdisplayedonlywhentheselectedloadplanisthemostrecentrunofthe

5.IntheRestartLoadPlanExecutiondialogbox,acceptthedefaultsandclickRestart.

6.ClickOKwhenyoureceivethemessageLoadPlanwasRestartedSuccessfully.
7.IntheRestartLoadPlanExecutiondialogbox,clickCancel.
8.ClickRefresh ontheNavigationTabtoolbartomonitortherestartedloadplan.Whenprocessingcompletesthestatusiconshould
turntoDone toindicatethattheloadplanexecutioncompletedsuccessfully.Noticethattherestartedloadplanexecutionnameis
incrementedby1.Ifyougetadifferentresult,pleaseretraceyoursteps.

9.ClicktheViewicon

toviewtheLoadPlanExecutiondetailsintherightpane.

10.IntheExecutionsection,confirmthattheexecutionstatusisDone .
http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

14/15

9/8/2016
MonitoringandTroubleshootingaLoadPlanforOTBIEnterprise
10.IntheExecutionsection,confirmthattheexecutionstatusisDone .

11.IntheRelationshipssection,confirmthatallstepshaveastatusofDoneinPreviousExecution

orDone .

12.Iftheloadplanfailsagain,workwithOracleSupporttorepeatthestepsinthistutorialtomonitor,troubleshoot,fix,andrestartthe
failedloadplan.

Summary

Inthistutorial,youlearnedtomonitorandtroubleshootaloadplanthatdoesnotexecutesuccessfullyinConfigurationManager.Inmost
casesyouwillworkwithOracleSupporttomonitor,troubleshoot,diagnose,andfixloadplanissues.Thistutorialcoveredsomeofthetasks
thatyoumaybeexpectedtoperformaspartoftheoveralltroubleshootinganddiagnosticprocess.Implementersandcustomersare
authorizedtouseConfigurationManagerandODIConsoletomonitorandtroubleshootloadplans.Inthistutorialyoulearnedhowto:
Monitortheexecutionstatusofaloadplan
Troubleshootafailedsessioninaloadplan
Setthestatusforafailedsessionto"MarkasComplete"
Restartaloadplan

Resources
TolearnmoreaboutOTBIEnterpriseforHCMCloudService,refertoadditionaldocumentationintheOTBIEnterpriseCloudLibrary.

Credits
LeadCurriculumDeveloper:JimSarokin

http://www.oracle.com/webfolder/technetwork/tutorials/obe/cloud/otbi_ent/v05/03/03_domain_only_load_plan_monitor.html

15/15