
Application Discovery Manager Administration Guide
60 VMware, Inc.
Sample Status Output
<SystemStatus>
<version>6.1.0-6013</version>
<uptime> 09:20:15 up 7 days, 18 min, 1 user, load average: 1.36, 2.17, 1.71</uptime>
<engine>Running</engine>
<listener>Not Running (Purposely Stopped)</listener>
<active_probe>Not Running (Purposely Stopped)</active_probe>
<oracle>Running</oracle>
<apache>Running</apache>
<watchdog>Running</watchdog>
</SystemStatus>
Asynch API
OperationsinADMʹsAPIareasynchronous.Theclienthastotracktheprogress(orlackthereof)ofthistask
andretrieveitsresults.
TasksareuniquelyidentifiedbyaUniversalUniqueIdentifier,whosestringrepresentationisreturnedupon
ataskcreation.Futurereferencestoataskmustbedoneusing
thissamestring.
Taskshavepredefinedparametersregardingtheirlife‐spanineverystate,forexample,afinishedtaskwaits
inthesystemfor24hoursbeforeitsresourcesarerecalledandthetaskisdeleted.Ataskcanhaveanyofthe
followingstates,whichyoucanretrievebyusing
getTaskState(Stringid):
PENDING:ThetaskiscreatedandinitializedandiswaitingtobeexecutedbyADM.
RUNNING:AgetTaskProgress()returnsanIntegerbetween0and100.
CANCELLED:Systemcancancelataskifittakestoolongtoexecute.
RUNNING:Thetaskisbeingexecuted.YoucantracktheprocessbycallinggetTaskProgress(Stringid).
Ataskcanbeinthisstateforalimitedamountoftime;systemcancelsalltheoffendingtasks.
FINISHED:Thetaskhasfinishedrunningsuccessfully,anditsproduceisreadyandwaitingtobe
collectedbytheclient.
ERROR/CANCEL:Thetaskhaseitherfailedorbeencanceled(usingcancelTask(Stringid)).
Dump API
TheDumpAPIprovidesyouwiththepossibilityofdumpingthecompletecontentsofatable(orsmallsetof
tables)thatcorrespondstoagivenentity(HOSTS,SERVICES,CONNECTIONS,andsoon.).InthisAPI,
flexibilityhasbeentradedforspeed,anditisintendedforthosecaseswherean
applicationintendstomirror
ADMʹsdata,andperiodicallysynchronizewithit.
TheDumpAPIworksasfollows:
1 Selectthetypeofentitiesthatitneedsandadiscoverydate(optional)forthoseentities.
2 Calldump( )withthoseparameters,andobtainthetaskUUIDinastringform.
3Tracktheprogressof
thetaskusingtheAsynchAPI(getTaskState( )andgetTaskProgress( )).
4RepeatStep 3untilthetaskreachestheFINISHEDorERRORstate.
5IfthetaskisintheFINISHEDstate,thenthefilescontainingthedumpeddatabasetablesarereadyand
waitingtobecollected(eitherusingSSHorintheFTPserverifsupplied).Thefilesarestoredina
subdirectorywhosenameisidenticaltothetaskID.
N
OTETheoperationswithinthecontextoftheweb‐serviceclientaresynchronic,thatis,thecallingofthe
functionthatdoesthe actualdeliveryofthequeryissynchronic,andtheclientblocksuntilthatoperationis
completed.
Commentaires sur ces manuels