6.1

ManualsBrandsVMware ManualsApplicationsvCenter Application Discovery Manager

Table Of Contents

Application Discovery Manager Administration Guide

Administration Guide

60 VMware, Inc.

Sample Status Output

<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

OperationsinADMʹsAPIareasynchronous.Theclienthastotracktheprogress(orlackthereof)ofthistask

andretrieveitsresults.

TasksareuniquelyidentifiedbyaUniversalUniqueIdentifier,whosestringrepresentationisreturnedupon

ataskcreation.Futurereferencestoataskmustbedoneusing

thissamestring.

Taskshavepredefinedparametersregardingtheirlife‐spanineverystate,forexample,afinishedtaskwaits

inthesystemfor24hoursbeforeitsresourcesarerecalledandthetaskisdeleted.Ataskcanhaveanyofthe

followingstates,whichyoucanretrievebyusing

getTaskState(Stringid):

 PENDING—ThetaskiscreatedandinitializedandiswaitingtobeexecutedbyADM.

 RUNNING—AgetTaskProgress()returnsanIntegerbetween0and100.

 CANCELLED—Systemcancancelataskifittakestoolongtoexecute.

 RUNNING—Thetaskisbeingexecuted.YoucantracktheprocessbycallinggetTaskProgress(Stringid

).Ataskcanbeinthisstateforalimitedamountoftime;systemcancelsalltheoffendingtasks.

 FINISHED—Thetaskhasfinishedrunningsuccessfully,anditsproduceisreadyandwaitingtobe

collectedbytheclient.

 ERROR/CANCEL—Thetaskhaseitherfailedorbeencanceled(usingcancelTask(Stringid)).

Dump API

TheDumpAPIprovidesyouwiththepossibilityofdumpingthecompletecontentsofatable(orsmallsetof

tables)thatcorrespondstoagivenentity(HOSTS,SERVICES,CONNECTIONS,andsoon.).InthisAPI,

flexibilityhasbeentradedforspeed,anditisintendedforthosecaseswherean

applicationintendstomirror

ADMʹsdata,andperiodicallysynchronizewithit.

TheDumpAPIworksasfollows:

1 Selectthetypeofentitiesthatitneedsandadiscoverydate(optional)forthoseentities.

2 Calldump()withthoseparameters,andobtainthetaskUUIDinastringform.

3Tracktheprogress

ofthetaskusingtheAsynchAPI(getTaskState()andgetTaskProgress()).

4RepeatStep 3untilthetaskreachestheFINISHEDorERRORstate.

5IfthetaskisintheFINISHEDstate,thenthefilescontainingthedumpeddatabasetablesarereadyand

waitingtobecollected(eitherusingSSHorintheFTPserverifsupplied).Thefilesarestoredina

subdirectorywhosenameisidenticaltothetaskID.

OTETheoperationswithinthecontextoftheweb‐serviceclientaresynchronic,thatis,thecallingofthe

functionthatdoesthe actualdeliveryofthequeryissynchronic,andtheclientblocksuntilthatoperationis

completed.