6.0

VMware, Inc. 53
Chapter A Web Services for Management Perl Library
AfteryouhaveinstalledvSphereSDKforPerl,thefollowingartifactsandsamplesareinthevSphereSDKfor
Perlinstallationdirectory:
Sample Scripts
Youcanrunthesamplescriptsasis.YoucanalsousethescriptsasthestartingpointforwritingyourownPerl
scriptstoobtainCIMdatafromtheserver.IfyouacceptedthedefaultsduringvSphereSDKforPerl
installation,thesamplesareinthefollowinglocationona
Windowssystem:
C:\Program Files\VMware\VMware VI CLI\Perl\samples\WSMan
Whenyourunthesamples,youmustspecifyconnectionoptions.See“vSphereSDKforPerlCommon
Options”onpage 12.Forexample,youcanspecifyconnectionoptionsonthecommandlineasfollows:
perl <scriptname.pl> --server <servername> --username <username> --password <password>
Forexample:
perl firmwarerevisions.pl --server my.FQDN.esx35server.com --username root --password root_pass
If--serverisnotspecified,itdefaultstolocalhost.Ifyouareconnectingtoaremotehostanddonotspecify
ausernameandpassword,youareprompted.
TheCIMOMservicelistensforrequestsonport80.
TheWS‐ManagementlibraryconsistsoftheWSMan::BasicandWSMan::GenericOpsclasses,and
the
StubOps.pmobject‐orientedwrapperforgenericoperations.Thefollowingsectionsdiscusseachlibrary
component.
SOAP Message Construction with WSMan::WSBasic
YoucanusetheWSMan::WSBasicclasstoconstructSOAPmessagesforcommunicatingwiththe
WS‐Managementserver.ThePerlmoduleislocatedinPerl/lib/WSMan/WSBasic.pm.Alloperationsinthis
classreturndeserializedSOAP::SOMobjectsfromwhichyoucanextractthefaultcodeortheSOAPreplies.
Youusuallydonotusethis
moduledirectly.Instead,youusetheGenericOpsmodulebuiltontopofWSBasic.
GenericOpssupportsgenericoperationsasdefinedbytheDMTFstandards.See“GenericCIMOperations
withWSMan::GenericOps”onpage 57.IfyouwanttousetheSOAP::SOMlibrarydirectly,seetheCPAN
documentationforSOAP::SOM.
TheWSMan::WSBasicmodulerequires
thefollowingPerlmodules:
 SOAP::Lite–WSMan::WSBasicrequiresVersion0.65orlatertoformSOAPmessagesandtoparseXML
repliesthatarereceivedfromtheWS‐Managementserver.
Table A-1. Components and Locations
Path Description
Perl/samples/WSMan SamplePerlscriptsthatusetheWS‐Managementlibrarytoobtaininformationthroughthe
CIMOMofanESX/ESXiorvCenterServersystem.Sampleprogramsletyouchecksensor
health,obtainfirmwarerevisionlevels,listfield‐replaceableunits,andlistpowersupply
details.SeeTable A‐2,“WSManSampleScripts,”onpage 53.
Perl/lib/WSMan WS‐ManagementinterfacePerlmodules.
Table A-2. WSMan Sample Scripts
Script Description
checksensorhealth.pl Returnsalistofsensorsassociatedwithallsystemdevices.
firmwarerevisions.pl Obtainsalistoffirmwarerevisionsonthesystem.
listfrus.pl Returnsalistofallfield‐replaceableunitsonthesystem.
listpowersupplies.pl Obtainsstatusofdiscretesensorsassociatedwithallpowersupplies.Demonstrates
traversingassociationsandusingGetInstance.