Tivoli IBM Tivoli Monitoring for Virtual Servers: VMware ESX Agent

(1)

Tivoli

®

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

User’s

Guide

Version6.1.0 SC32-9475-00

(2)

(3)

Tivoli

®

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

User’s

Guide

Version6.1.0 SC32-9475-00

(4)

Note

Beforeusingthisinformationandtheproductitsupports,readtheinformationinAppendixD,“Notices,”onpage99.

FirstEdition(March2006)

Thiseditionappliestoversion6.1.0ofIBMTivoliMonitoringforVirtualServers:VMwareESXAgentandtoall subsequentreleasesandmodificationsuntilotherwiseindicatedinneweditions.

(5)

Tables

.

. v

About

this

guide

.

. vii

Whoshouldreadthisguide. . . vii

Whatthisguidecontains. . . vii

Publications . . . viii

Prerequisitepublications. . . viii

Relatedpublications . . . viii

Accessingterminologyonline . . . ix

Accessingpublicationsonline . . . ix

Orderingpublications . . . ix

Accessibility . . . ix

Tivolitechnicaltraining. . . x

Supportinformation. . . x

Conventionsusedinthisguide . . . x

Typefaceconventions . . . x

Operatingsystem-dependentvariablesandpaths x

Chapter

1. Overview

of

the

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

.

. 1

IBMTivoliMonitoringoverview. . . 1

FeaturesofIBMTivoliMonitoringforVirtualServers: VMwareESXAgent . . . 1

IBMTivoliMonitoringforVirtualServers:VMware ESXAgentfunctions. . . 1

ComponentsofIBMTivoliMonitoringforVirtual Servers:VMwareESXAgent . . . 2

Userinterfaceoptions . . . 3

Chapter

2. Requirements

for

the

monitoring

agent

.

. 5

Chapter

3. How

to

use

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

.

. 11

Viewreal-timedataaboutVMwareESXServer . . 11

Investigateanevent . . . 12

Recovertheoperationofaresource . . . 12

Customizeyourmonitoringenvironment . . . . 13

Monitorwithcustomsituationsthatmeetyour requirements . . . 14

Collectandviewhistoricaldata . . . 15

Chapter

4. Workspaces

reference

.

. 17

Aboutworkspaces . . . 17

Moreinformationaboutworkspaces . . . 17

Predefinedworkspaces . . . 18

VMwareESXNavigatoritem . . . 18

AvailabilityNavigatoritem . . . 18

CPUNavigatoritem . . . 19

DiskNavigatoritem . . . 19

MemoryNavigatoritem . . . 20

NetworkNavigatoritem . . . 20

VirtualMachinesNavigatoritem . . . 21

Chapter

5. Attributes

reference

.

. 23

Aboutattributes. . . 23

Moreinformationaboutattributes. . . 23

AttributegroupsandattributesforIBMTivoli MonitoringforVirtualServers:VMwareESXAgent . 23

Availabilityattributegroup . . . 24

CPUBaseattributegroup. . . 27

CPULoadAverageattributegroup . . . 28

CPUVMattributegroup . . . 29

DiskBaseattributegroup. . . 30

DiskUsageattributegroup . . . 32

DiskVMattributegroup . . . 33

MemoryBaseattributegroup . . . 35

MemoryperVMattributegroup . . . 36

MemoryVMattributegroup . . . 37

NetworkBaseattributegroup . . . 39

NetworkVMattributegroup . . . 40

PerformanceObjectStatusattributegroup . . . . 42

Systemattributegroup . . . 44

SystemCPUattributegroup. . . 45

VirtualMachinesattributegroup . . . 45

VMFileSystemattributegroup . . . 47

Diskcapacityplanningforhistoricaldata . . . . 47

Chapter

6. Situations

reference

.

. 49

Aboutsituations. . . 49

Moreinformationaboutsituations. . . 49

Predefinedsituations . . . 50

VMwareESXNavigatoritem . . . 51

AvailabilityNavigatoritem . . . 51

KQV_VMware_ESX_Server_Downsituation . . 51

CPUNavigatoritem . . . 51

KQV_VMKernel_Not_Loadedsituation . . . . 51

KQV_CPU_Phy_Utilization_Highsituation . . . 52

KQV_CPU_Avg_Underutilizedsituation. . . . 52

KQV_CPU_Avg_Overutilizedsituation . . . . 53

DiskNavigatoritem . . . 53

KQV_Filesystem_Freespace_Lowsituation . . . 53

KQV_DiskRead_Activity_Highsituation. . . . 54

KQV_DiskWrite_Activity_Highsituation. . . . 54

MemoryNavigatoritem . . . 55

KQV_Memory_Used_COS_Highsituation . . . 55

KQV_Memory_Available_Lowsituation . . . . 55

NetworkNavigatoritem . . . 56

KQV_NetworkTX_Activity_Highsituation . . . 56

KQV_NetworkRX_Activity_Highsituation . . . 56

VirtualMachinesNavigatoritem . . . 57

KQV_Virtual_Machine_Offsituation . . . 57

KQV_Virtual_Machine_Stucksituation . . . . 57

KQV_Virtual_Machine_Unknownsituation . . . 58

KQV_Virtual_Machine_Suspendedsituation . . 58

(6)

Chapter

7. Take

Action

commands

reference

.

. 61

AboutTakeActioncommands . . . 61

MoreinformationaboutTakeActioncommands . . 61

PredefinedTakeActioncommands . . . 61

ConfigureSSHWindowsaction . . . 62

StartVirtualMachineaction . . . 62

StopVirtualMachineaction . . . 63

Chapter

8. Policies

reference

.

. 65

Aboutpolicies . . . 65

Moreinformationaboutpolicies . . . 65

Appendix

A. IBM

Tivoli

Enterprise

Console

event

mapping

.

. 67

Appendix

B. Problem

determination

.

. 73

GatheringproductinformationforIBMSoftware Support . . . 73

Built-inproblemdeterminationfeatures . . . 73

Problemclassification . . . 74

Tracelogging. . . 74

Overviewoflogfilemanagement . . . 74

Examplesoftracelogging . . . 75

Principaltracelogfiles . . . 75

SettingRAStraceparameters . . . 78

Problemsandworkarounds . . . 80

Installationandconfigurationproblem determination . . . 80

Agentproblemdetermination . . . 83

Problemdeterminationforremotedeployment 84 Workspaceproblemdetermination. . . 84

Situationproblemdetermination . . . 86

Supportinformation . . . 89

Searchingknowledgebases . . . 89

Obtainingfixes . . . 90

Receivingweeklysupportupdates . . . 90

ContactingIBMSoftwareSupport . . . 91

Informational,warning,anderrormessages . . . 93

Messageformat . . . 93

IBMTivoliMonitoringforVirtualServers: VMwareESXAgentmessages . . . 94

Appendix

C. Accessibility

.

. 97

Navigatingtheinterfaceusingthekeyboard . . . 97

Magnifyingwhatisdisplayedonthescreen . . . 97

Appendix

D. Notices

.

. 99

Trademarks . . . 101

(7)

Tables

1. Viewreal-timedataaboutVMwareESXServer 11 2. Investigatinganevent . . . 12 3. Recovertheoperationofaresource . . . . 13 4. Customizingyourmonitoringenvironment 13 5. Monitorwithcustomsituations . . . 15 6. Collectandviewhistoricaldata. . . 16 7. Capacityplanningforhistoricaldataloggedby

componentVMware . . . 48 8. InformationtogatherbeforecontactingIBM

SoftwareSupport . . . 73 9. Tracelogfilesfortroubleshootingagents 76 10. Problemsandsolutionsforinstallationand

configuration . . . 81

11. Generalproblemsandsolutionsfor

uninstallation . . . 82 12. Agentproblemsandsolutions . . . 83 13. Remotedeploymentproblemsandsolutions 84 14. Workspaceproblemsandsolutions. . . 85 15. Generalsituationproblemsandsolutions 86 16. Problemswithconfiguringsituationsthatyou

solveintheSituationEditor . . . 87 17. Problemswithconfigurationofsituationsthat

yousolveintheWorkspacearea . . . 88 18. TakeActioncommandsproblemsand

solutions . . . 89

(8)

(9)

About

this

guide

IBM TivoliMonitoringforVirtualServers:VMwareESXAgent User’sGuideprovides informationaboutinstallingandusingIBMTivoliMonitoringforVirtualServers: VMwareESXAgent.

Use theconfigurationchapterinthisguidealongwith IBMTivoliMonitoring Installationand SetupGuidetoinstall andsetupthesoftware.

Use theinformationinthis guidealongwithIBMTivoliMonitoringUser’sGuideto monitor VMwareESXServer.

Who

should

read

this

guide

Thisguideisforsystemadministratorswho installandusetheIBMTivoli MonitoringforVirtualServers:VMwareESXAgenttomonitorandmanage VMwareESXServer resources.

Readers shouldbe familiarwiththefollowingtopics:

v TivoliEnterprise

™_Portal_interface

v IBM

®_Tivoli® _Monitoring_application _software

v IBMTivoliEnterpriseConsole

®_(optional)

v VMwareESXServer environments

What

this

guide

contains

Thisguidecontainsthefollowingchapters:

v Chapter1,“Overview oftheIBM TivoliMonitoringforVirtualServers:VMware

ESXAgent,”onpage1

ProvidesanintroductiontotheIBMTivoliMonitoringforVirtualServers: VMwareESXAgent.

v Chapter2,“Requirementsforthemonitoringagent,”onpage5

ProvidesinformationabouttherequirementsfortheIBMTivoliMonitoringfor VirtualServers:VMwareESXAgent.

v Chapter3,“HowtouseIBM TivoliMonitoringforVirtualServers:VMwareESX

Agent,”onpage11

Providesalistoftasks toachievewhenusingamonitoringagent,a listof proceduresforperformingeachtask,andreferencesforwheretofind informationabouttheprocedures.Aftercompletinginstallationand

configurationand becomingfamiliarwiththeinformationinChapter1ofthis guide,usethischaptertoseehowyoucanuseamonitoringagent.

v

Chapter4,“Workspaces reference,”onpage17

Providesanoverviewofworkspaces,referencestoadditionalinformationabout workspaces,and descriptionsofpredefinedworkspacesinthismonitoringagent.

v Chapter5,“Attributesreference,”onpage23

Providesanoverviewofattributes,referencestoadditionalinformationabout attributes,descriptionsoftheattributegroupsandattributesinthis monitoring agent,anddiskspacerequirementsforhistoricaldata.

v Chapter6,“Situationsreference,”onpage49

(10)

Providesanoverviewofsituations, referencestoadditionalinformationabout situations,anddescriptionsofthepredefined situationsinthismonitoringagent.

v Chapter7,“TakeActioncommandsreference,”onpage61

ProvidesdetailedinformationabouttheTakeAction commands,referencesto additionalinformationaboutTakeActioncommands,anddescriptionsofthe TakeActioncommandsprovidedinthis monitoringagent.

v Chapter8,“Policiesreference,”onpage65

Providesanoverviewofpolicies, referencesfordetailedinformationabout policies,anddescriptionsofthepredefinedpolicies includedinthis monitoring agent.

v AppendixA, “IBMTivoliEnterpriseConsoleevent mapping,”onpage67

ProvidesanoverviewoftheIBM TivoliEnterpriseConsoleeventmapping informationforthismonitoringagent.

v AppendixB,“Problemdetermination,” onpage73

Providesinformationabouttroubleshootingthevariouscomponentsof theIBM TivoliMonitoringforVirtualServers:VMwareESXAgent, informationaboutlog files,andinformationaboutyouroptionsforobtainingsoftwaresupport.

v

AppendixC,“Accessibility,” onpage97

ProvidesinformationabouttheaccessibilityfeaturesintheIBM Tivoli MonitoringforVirtualServers:VMwareESXAgent.

v AppendixD,“Notices,”onpage99

ProvidesIBMand Tivolinoticesandtrademarkinformationasitappliestothe IBMTivoliMonitoringforVirtualServers:VMwareESXAgent.

Publications

Thissectionlists publicationsrelevanttotheuseoftheIBM TivoliMonitoringfor VirtualServers:VMwareESXAgent. Italso describeshow toaccessthese

publicationsonline andhowtoorderthese publications.

Prerequisite

publications

Tousetheinformationinthisguideeffectively,youmusthavesomeknowledgeof IBM TivoliMonitoringproducts,whichyoucanobtainfromthefollowing

documentation:

v IBMTivoliMonitoringAdministrator’s Guide v IBMTivoliMonitoringInstallationand SetupGuide v IBMTivoliMonitoringProblemDeterminationGuide v IBMTivoliMonitoringUser’s Guide

v IBMTiivoliMonitoringReadmeFirst

publications

The followingdocuments alsoprovideusefulinformation:

v IBMTivoliEnterpriseConsoleAdaptersGuide

v IBMTivoliEnterpriseConsoleEventIntegrationFacilityUser’sGuide v IBMTivoliEnterpriseConsoleReference Manual

(11)

Accessing

terminology

online

TheTivoliSoftwareGlossary includesdefinitionsformanyofthetechnicalterms relatedtoTivolisoftware.TheTivoliSoftwareGlossaryisavailableat thefollowing Tivolisoftware libraryWebsite:

http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm

TheIBM TerminologyWebsiteconsolidatestheterminologyfromIBMproduct libraries inoneconvenientlocation.YoucanaccesstheTerminologyWebsiteatthe followingWebaddress:

http://www.ibm.com/ibm/terminology

Accessing

publications

online

ThedocumentationCDcontainsthepublicationsthatareintheproductlibrary. TheformatofthepublicationsisPDF, HTML,orboth.Refertothereadmefileon theCDforinstructions onhow toaccessthedocumentation.

IBM postspublicationsforthisand allotherTivoliproducts,astheybecome available andwhenevertheyareupdated,totheTivolisoftwareinformationcenter Website.AccesstheTivolisoftwareinformationcenterbyfirst goingtotheTivoli software libraryat thefollowingWebaddress:

http://www.ibm.com/software/tivoli/library

Click theTivoliproductmanuals link.IntheTivoliTechnicalProductDocuments Alphabetical Listingwindow,clickITMTivoliMonitoringtoaccessyourproduct libraryattheTivolisoftwareinformationcenter.

Note: IfyouprintPDFdocumentsonotherthanletter-sizedpaper,settheoption

intheFile→ PrintwindowthatallowsAdobeReadertoprintletter-sized pagesonyourlocalpaper.

Ordering

publications

YoucanordermanyTivolipublicationsonline atthefollowingWebsite: http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm Youcanalsoorderbytelephonebycallingoneofthese numbers:

v IntheUnitedStates:800-879-2755 v InCanada:800-426-4968

Inothercountries,contactyour softwareaccountrepresentativeto orderTivoli publications.

Accessibility

Accessibilityfeatureshelpuserswitha physicaldisability,suchasrestricted mobilityorlimited vision,tousesoftwareproductssuccessfully.Withthis product, youcanuseassistivetechnologiestohearand navigatetheinterface.Youcanalso usethekeyboardinsteadofthemousetooperatemostfeaturesofthegraphical user interface.

For additionalinformation,seeAppendixC,“Accessibility,” onpage97.

(12)

Tivoli

technical

training

For Tivolitechnicaltraininginformation,refertothefollowingIBMTivoli EducationWebsite:

http://www.ibm.com/software/tivoli/education/

Support

information

“Support information”onpage89describesthefollowingoptionsforobtaining support forIBMproducts:

v “Searchingknowledgebases”onpage89 v “Obtainingfixes”onpage90

v “ContactingIBMSoftwareSupport”onpage91

Conventions

used

in

this

guide

Thisguideusesseveralconventionsforspecialtermsandactions, andoperating system-dependent commandsandpaths.

Typeface

conventions

Thisguideusesthefollowingtypefaceconventions: Bold

v Lowercasecommandsandmixedcasecommandsthatareotherwise

difficulttodistinguishfromsurroundingtext

v Interfacecontrols(check boxes,pushbuttons,radiobuttons,spin

buttons,fields,folders,icons,listboxes, itemsinsidelistboxes,

multicolumnlists,containers, menuchoices,menu names,tabs,property sheets),labels(suchasTip:,andOperatingsystem considerations:)

v Keywordsandparametersintext

Italic v

Wordsdefinedintext v Emphasisofwords

v Newtermsintext(exceptina definitionlist) v Variablesand valuesyoumustprovide Monospace

v Examplesandcodeexamples

v Filenames,programming keywords,andotherelementsthataredifficult

todistinguishfromsurroundingtext

v Messagetextandprompts addressedtotheuser v

Textthattheusermust type

v Valuesforargumentsorcommandoptions

Operating

system-dependent

variables

and

paths

The directionoftheslash fordirectorypathsmight varyinthisdocumentation. No matterwhichtypeofslash youseeinthedocumentation,usethefollowing

guidelinesfora slash:

v IfusingUNIX

®_,_use_a _forward_slash ₍_/_).

v IfusingWindows

(13)

Thenamesof environmentvariablesarenotalwaysthesameinWindowsand UNIX.For example,%TEMP%inWindows isequivalentto$TMPDIR inUNIX. For environmentvariables,usethefollowingguidelines:

v IfusingUNIX,use$variable. v IfusingWindows,use%variable%.

Note: Ifyouare usingthebashshellonaWindows system,youcanusetheUNIX

conventions.

(14)

(15)

Chapter

1. Overview

of

the

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

TheIBM TivoliMonitoringforVirtualServers:VMwareESXAgentprovidesyou with thecapabilitytomonitorVMwareESXServer,andtoperform basicactions with VMwareESXServer.Thischapterprovidesa descriptionof thefeatures, components,andinterface optionsfortheIBM TivoliMonitoringforVirtual Servers:VMwareESXAgent.

IBM

Tivoli

Monitoring

overview

IBM TivoliMonitoringisthebasesoftwarefortheIBMTivoli Monitoringfor VirtualServers:VMwareESXAgent. IBMTivoliMonitoringprovidesaway to monitor theavailabilityandperformanceof allthesystemsinyour enterprisefrom oneor severaldesignatedworkstations.Italsoprovidesusefulhistorical datathat youcanusetotrack trendsand totroubleshootsystemproblems.

YoucanuseIBMTivoliMonitoringtodothefollowing:

v Monitorforalertsonthesystemsthatyouaremanagingbyusingpredefined

situationsorcustomsituations.

v Establishyourownperformance thresholds. v Tracethecausesleadingtoanalert.

v Gathercomprehensivedataaboutsystemconditions.

v Usepoliciestoperform actions,schedulework,andautomate manualtasks.

TheTivoliEnterprisePortalistheinterface forIBMTivoliMonitoringproducts.By providing aconsolidatedviewofyour environment,theTivoliEnterprisePortal permitsyoutomonitorand resolveperformanceissuesthroughouttheenterprise. See theIBM TivoliMonitoringpublicationslistedin“Prerequisitepublications”on pageviiiforcompleteinformationaboutIBM TivoliMonitoringand theTivoli EnterprisePortal.

Features

of

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

TheIBM TivoliMonitoringforVirtualServers:VMwareESXAgentsoftwarecan identify,notify youof,and correctcommonproblemswiththeapplicationthatit monitors.Thesoftwareincludesthefollowingfeatures:

v Monitoring v Datagathering v Eventmanagement v Operationsmanagement

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

functions

IBM TivoliMonitoringforVirtualServers:VMwareESXAgentprovidesthe followingfunctions:

(16)

Resource monitoring

Collect monitoringinformationformemory,CPU,system,disk and networkusagefortheVMwareESXServer.

Availability monitoring

Availabilityinformationwillbeprovidedseparatelyforthemonitored VMwareESXresource.Anapplication pingusingtheVMwareScripting APIswillbemadetodeterminewhethertheVMwareESXserveris

available.The VMwareServer beingunavailableshallindicateeitheroneof thefollowing-theserverisnolongerreachable;theVMPerl ScriptingAPIs are misconfigured;theVMwareESXserverhasgone offline.

Actions

Provideactionstostartand stopthevirtualmachinesinstalledonthe VMwareESXServer.

Historical data

Providea historyenablement filewhichgivestheusertheabilityto generatereportsforallmetricscollected.

Components

of

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

Afteryouinstallandset uptheIBM TivoliMonitoringforVirtualServers:VMware ESXAgent,youhaveanenvironmentthatcontainstheclient,server,and

monitoringagentimplementationfor IBMTivoliMonitoringthatcontainsthe followingcomponents:

v TivoliEnterprisePortalclientwith aJava-baseduserinterface forviewingand

monitoringyour enterprise.

v TivoliEnterprisePortalServer thatisplacedbetweentheclientandtheTivoli

EnterpriseMonitoringServerand enablesretrieval,manipulation, andanalysis ofdatafromthemonitoringagents.TheTivoliEnterprisePortalServer isthe centralrepositoryforalluserdata.

v TivoliEnterpriseMonitoringServer,whichactsasa collectionandcontrolpoint

foralertsreceivedfromthemonitoringagents,andcollectstheirperformance andavailabilitydata.TheTivoliEnterpriseMonitoringServer isalso arepository forhistoricaldata.

v Monitoringagent, IBMTivoliMonitoringforVirtualServers:VMwareESX

Agent,installedonthesystemsorsubsystemsthatyouwanttomonitor.This monitoringagentcollectsanddistributesdatatoaTivoliEnterprisePortal Server.

Note: Theagentcannotbe installedontheVMwareESXserver.Itshouldbe

installedremotelyonasupportedplatform.Formoreinformation,referto theChapter2, “Requirementsforthemonitoringagent,”onpage5

chapter.

IBM TivoliEnterpriseConsoleisanoptionalcomponent,whichacts asa central collection pointforeventsfromavarietyofsources,includingthosefromother Tivolisoftware applications,Tivolipartnerapplications,customapplications, networkmanagementplatforms, andrelationaldatabase systems.Youcanview these eventsthrough theTivoliEnterprisePortal(usingtheeventviewer),andyou canforwardeventsfromIBMTivoliMonitoringsituationstotheIBM Tivoli EnterpriseConsolecomponent.

(17)

User

interface

options

Installationofthebasesoftwareand otherintegratedapplicationsprovides the followinginterfacesthatyoucanusetoworkwithyourresources anddata: TivoliEnterprisePortalbrowserclientinterface

Thebrowserinterface isautomaticallyinstalledwithTivoliEnterprise Portal.TostartTivoliEnterprisePortalinyourInternet browser,enterthe URLforaspecific TivoliEnterprisePortalbrowserclientinstalledonyour Webserver.

TivoliEnterprisePortaldesktopclient interface

Thedesktopinterface isa Java-basedgraphicaluserinterface (GUI)ona Windows orLinux®workstation.

IBMTivoliEnterpriseConsole Event managementapplication

ManageTivoliEnterpriseMonitoringServiceswindow

Thewindow fortheManage TivoliEnterpriseMonitoringServicesutilityis usedforconfiguringtheagentandstartingTivoliservicesnotalready designatedtostart automatically.

(18)

(19)

Chapter

2. Requirements

for

the

monitoring

agent

ThischaptercontainsinformationabouttherequirementsfortheIBMTivoli MonitoringforVirtualServers:VMwareESXAgent.

InadditiontotherequirementsdescribedintheIBMTivoliMonitoringInstallation and SetupGuide,theIBMTivoliMonitoringforVirtualServers:VMwareESXAgent hasthefollowingrequirements:

v Themonitoringagentrunsontheseoperatingsystems:

– Windows 2000Server

– Windows 2000AdvancedServer

– Windows XPProfessional

– Windows 2003Server

– Windows 2003EnterpriseServer

– Red Hat2.1

– Red HatELAdvancedServer3.0

– Red HatELAdvancedServer4.0

– UnitedLinux1/SuSe8forIA32

– UnitedLinux1/SuSe9forIA32

Ifrunningthis agentonaWindows operatingsystem,theUser IDmust have Administratorprivileges.

v Monitorsthefollowingversions:

– VMwareESXServer2.1.2,2.5.1,2.5.2

v Asingle computerthathoststhehubmonitoringserver,portalserver,anda

monitoringagentrequiresapproximately300 MBofspace.Amonitored

computerthathostsonlythemonitoringagentrequiresapproximately30MBof space,includingthespecific enablementcodeforthemonitoringagent.More spaceisrequiredforeachadditional monitoringagentthatyoudeployonthe monitoredcomputer.

Becausethis agentisenabledforremotemanagement, multipleinstancesofthe VMwareESXServer canbe monitoredfroma singleagentsystem.

AfteryouinstalltheIBMTivoliMonitoringVersion6.1and theTivoliEnterprise Portal,youinstall thefollowingsoftwarethatisrequiredforIBMTivoliMonitoring forVirtualServers:VMwareESXAgenttooperate:

v IBMTivoliMonitoring6.1Fix Pack1 v

IBMTivoliMonitoringforVirtualServers:VMwareESXAgent

v IBMTivoliMonitoringforVirtualServers:VMwareESXAgentSupportfor

TivoliEnterpriseManagement Server

TivoliEnterprisePortalServer

TivoliEnterprisePortal

Thisagentcollectsdatafromthefollowingdatasources:

(20)

SNMP

Acronym forSimpleNetworkManagementProtocol.Thenetwork

management protocolusedalmost exclusivelyinTCP/IPnetworks.SNMP allows youtomonitorand controlnetworkdevices,andtomanage configurations,statisticscollection,performance,andsecurity.Forthis agent, SNMPV1isused.

The agentshouldnotbeinstalledontheVMwareESXserver.Itshouldbe installed remotelyona supportedplatform.Additionally,theagentrequirestheVmPerl ScriptingAPIstobeinstalledonthesystemwheretheagentruns.TheVmPerl ScriptingAPIsaredistributed byVMware. Theymaybe downloadedfrom www.vmware.comor installedfromtheVMwareESXServerCD.Installthe scriptingAPIsprior toinstallingtheVMwareESXagent.Theinstallation pathof thescriptingAPIsshouldbenotedbecause itwillbe neededduring the

configurationoftheVMwareESXagent.

Inadditiontotheagentconfiguration,anssh clientmustalso beinstalledand configured onthesystemwhere theagentruns.Installthessh clientpriorto installingtheVMwareESXagent.Theconfigurationstepsvaryslightlydepending ontheplatform.Exampleconfigurationstepsare asfollows.

Windows only-Sinceanssh clientisnotincludedaspart oftheWindowsbase installation,onemust beacquired.Therearefreeversionsavailable fordownload. IntheVMwaredocumentationthereisa referencetoa freeclientcalledplink.

1. Downloadand installthesshclient.Takenoteoftheinstallationdirectory

path.

2. InstalltheVMwareESXagent.

3. ConfiguretheVMwareESXagent.Duringthisprocessyouwillbe askedthe

fullyqualifiedpathwhere thessh clientwasinstalled.Enterthepathand include theexecutablefilenameoftheclient aspart ofthepath.

4. StarttheVMwareESXagent.

5. ExecutetheSSH_CONFIGURE_WINDOWSactionavailablefromtheTake

Action menu.Thistaskwillputnecessaryauthentication keysintotheregistry. Thisisrequiredinorderfordatacollectionto work.

Linuxonly-MostdistributionsofLinuxinclude ansshclient.Thisconfiguration procedureconfigurestheauthentication keysusedbetweenthesystemrunningthe agentandtheESXserver.Additionalinformationregardingthegenerationofkeys canbe foundinthemanpagesfortheutilityssh-keygen.

1. Logontothelinux systemwheretheVMwareESXagentwillbeinstalled. 2. Usethessh-keygenutility togeneratepublicandprivate keyswithno

paraphase.For example,thecommand″ssh-keygen -tdsa-f/root/mykey ″ generatesa setofpublicandprivatekeys.Pressenterwhenpromptedfora paraphase.The publickeygeneratedisstoredinthefile/root/mykey.puband theprivatekeyisstoredinthefile/root/mykey

3. TransferthefilecontainingthepublickeytotheVMwareESXserver.Thismay

be donewithutilitiessuchasftpand scp.

4. Appendthepublickeyfiletothecollectionof keysstoredontheESXserver.

Thestored keysarelocatedinthefile/root/.ssh/authorized_keys

5. AddthehostnameandkeyfortheVMwareESXServerin’known_hosts’file.

Thisisnormallylocatedin/root/.sshdirectory.Todo this-executethe commandssh″user″@″vmware_server_hostname″-i″private_keyfile″date.Enteryes

(21)

whenpromptedtocachethekeys.Thesuccessfulcompletionofthis command shalladdtheentrytotheknown_hostsfileforfutureconnections.

6. Configuretheagentonthesystemwheretheagentisinstalled.Duringthe

configurationyouwillbeprompted forthelocationofthefilethatcontainsthe privatekeys.Enterthefullyqualifiedpath.

TheIBM TivoliMonitoringforVirtualServers:VMwareESXAgentprovides optional functionalityformonitoringand managingthesystem-levelCPUusage and filesystemusageontheVMwaresystem.Tocollect thisdata,VMware

requiresanSSHclient.On Linux,an SSHclientisavailableaspartofthestandard LinuxRPMs. OnWindows,anSSH clientisseparatelyavailable fromPlinkatthe followinglocation:http://www.chiark.greenend.org.uk/~sgtatham/putty.

NOTICE:IBM MAKESNO REPRESENTATIONORWARRANTYREGARDING THEPERFORMANCEORCONTINUEDAVAILABILITYOFTHISOPTIONAL FUNCTIONALITY.PLINKIS“SEPARATELYLICENSEDCODE”ASSPECIFIEDIN THELICENSE INFORMATIONDOCUMENTOFTHEIBMLICENSE

AGREEMENT.

Ifyoudesirethisoptionalfunctionality,Youmayobtaina licenseforPlinkunder thetermsoftheapplicablethirdpartylicenseagreement(s)providedorreferenced at thePlinkwebsiteandnotthetermsofanyIBMagreement.Notwithstanding anyofthetermsinthePlinklicenseagreement,oranyotheragreementyoumay havewith IBM,thetermsofthePlinklicenseagreement(s)governyour useofthe Plinkcode,andnotthetermsof anyIBMagreement.Pleaserefertothe

“Separately LicensedCode”identifiedintheLicenseInformationdocumentofthe IBM licenseagreement.

IBM makesnorepresentationswhatsoeveraboutthePlinkproduct,VMware, nor anywebsitewhichyoumayaccesstoobtainPlink.Whenyouaccessanon-IBM Websiteorproduct,evenonethatmaycontaintheIBM-logo,pleaseunderstand thatit isindependentfromIBM,and thatIBMhasnocontroloverthecontent or productsavailable onthatWebsite. Inaddition,alinktoanon-IBMWebsiteor non-IBMproductdoesnotmeanthatIBMendorsesoracceptsanyresponsibility forthecontent,ortheuse,ofsuchWebsiteorproduct.Itisuptoyoutotake precautions toensurethatwhateveryouselectforyour useisfreeofsuchitemsas viruses, worms,trojan horsesandotheritemsofadestructivenature.

NotwithstandinganyofthetermsinthePlinklicenseor yourIBMlicense, orany otheragreementyoumayhavewith IBM:

v (a)IBMprovides thisinformationtoyouWITHOUT WARRANTIESOFANY

KIND;

v (b)IBMDISCLAIMSANYANDALLEXPRESSANDIMPLIED WARRANTIES

ANDCONDITIONSINCLUDING,BUTNOTLIMITED TO,THEWARRANTY OFTITLE,NON-INFRINGEMENTORINTERFERENCEANDTHEIMPLIED WARRANTIESANDCONDITIONSOFMERCHANTABILITYANDFITNESS FORAPARTICULARPURPOSE,WITHRESPECTTOTHESEPARATELY LICENSEDCODE;

v (c)IBM isnotliabletoyou,and willnotdefend,indemnify,orholdyou

harmlessforanyclaimsarising fromorrelatedtoyour useof Plink,theweb site,oranyotherhyper-linedwebsite;and

v (d)IBMisnotliablefor anydirect,indirect,incidental,special,exemplary,

punitiveorconsequentialdamagesincluding, butnotlimited to,lostdata,lost savings,and lostprofits, businessinterruption,lossofprogramsorotherdataon

(22)

yoursystemwith respecttoyouruseofPlink,thewebsite,oranyother hyper-linedwebsite, evenifweareexpresslyadvisedof thepossibilityofsuch damages.

IfyouobtainedtheIBMTivoliMonitoringforVirtualServers:VMwareESXAgent undertheIBMInternationalProgramLicenseAgreement(“IPLA”)orIBM

InternationalProgramLicenseAgreementforNonWarranted Program(“ILAN”) and youare theoriginallicenseeoftheProgram,and youdonotagreewiththe thirdpartylicenseagreement(s),youmayreturnthePrograminaccordancewith thetermsof,andwithinthespecifiedtimeframesstatedin,the“Money-back Guarantee”sectionof theIPLAorILAN.

The followingconfigurationvaluesmustbe providedfortheagenttooperate. Whenconfiguringanagent,apaneldisplaysthatallows youtotypein eachvalue. Whenthereisa defaultvalue,thiswillbepre-enteredintothefield.Ifa field represents apassword,therewillbe 2entryfields displayed.Youmust enterthe same valueineachfield.Thevaluesyoutype willnotbedisplayed.Thishelps maintain thesecurityofthesevalues.Thefollowingfieldsare definedforthis agent:

v Tab:SNMPServer v Field:CommunityName v

Type:password

Thecommunitynameusedtosend GETrequeststotheSNMP agent.

v Tab:SNMPServer v Field:Host v Type:string

Thehostnameorip addressoftheSNMPagent.

v Tab:SNMPServer v Field:Port

v Type:string

TheporttheSNMP agentusestoreceiverequests(normally161).

v Tab:VMwareESXConfiguration

v Field:SSHkeyfilelocation(Linuxplatforms only) v Type:string

ThefullyqualifiedpathwheretheSSHauthentication keyfileislocated.Thisis thekeyfileyougeneratedusingssh-keygen.Ensurethatyouhavestoredthe correspondingpublickeyontheVMwareESXServer.Thisisrequiredforlinux platformsonly.

v Tab:VMwareESXConfiguration

v Field:Fullyqualifiedfilename fortheSSHClient v

Type:string

ThefullyqualifiedpathincludingtheexecutablenameoftheSSHClient.For example/usr/bin/sshforLinuxandc:\\program files\\plink.exeforWindows.

v Tab:VMwareESXConfiguration v Field:VMwareServerAdminID v Type:string

TheadministratoruserIDfortheVMwareESXserverthatwillbe monitored.

v Tab:VMwareESXConfiguration v Field:VMwareServerAdminPassword v Type:password

(23)

ThepasswordoftheadministratoruserIDoftheVMwareESXserverthatwill bemonitored.

v Tab:VMwareESXConfiguration v Field:VMwareServer Hostname v Type:string

ThehostnameoftheVMwareservertobemonitored.

v Tab:VMwareESXConfiguration v

Field:FullyqualifiedpathfortheVmPerl ScriptingAPIs v Type:string

ThefullyqualifiedpathwheretheVMwareVmPerlScriptingAPIsareinstalled. Thevmware-cmdfilemustbe accessibleinthispath.

v Tab:VMwareESXConfiguration v Field:VmPerlPort

v Type:numeric

TheportnumberthattheVMwareScriptingAPIswillusetocommunicatewith theVMwareESXserver.Thedefaultis902 andthisshouldbe usedunlessyou configuredyourESXservertouseanotherport.

Wheninstallingtheagentremotely,theconfigurationvaluesmust beprovided.An example commandlinewouldbe:

tacmd addSystem -t QV -n sample.node.name:NT -p SNMP.SNMP_COMMUNITY=value SNMP.SNMP_HOST=value SNMP.SNMP_PORT=value VMWARE.SSH_KEYFILE=value VMWARE.SSH_LOC=value VMWARE.VMWARE_ADMINID=value VMWARE.VMWARE_ADMINPASSWORD=value VMWARE.VMWARE_SERVERHOSTNAME=value VMWARE.VMWARE_VMPERL_DIR=value VMWARE.VMWARE_VMPERL_PORT=value

(24)

(25)

Chapter

3. How

to

use

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

Afteryouhaveinstalledandconfigured IBMTivoliMonitoringforVirtualServers: VMwareESXAgent,andtheagentisrunning, youcanbeginusingthisagentto monitor yourresources.Thefollowingsourcesof informationare relevantto installationand configuration:

v IBMTivoliMonitoringInstallationand SetupGuide

v Chapter2,“Requirementsforthemonitoringagent,”onpage5 inthisuser’s

guideforinformationaboutinstallingand configuringIBMTivoliMonitoringfor VirtualServers:VMwareESXAgent

ThischapterprovidesinformationabouthowtouseIBMTivoliMonitoringfor VirtualServers:VMwareESXAgenttoachievethefollowingpurposes:

v “Viewreal-timedataaboutVMwareESXServer” v “Investigateanevent”onpage12

v

“Recovertheoperationofa resource”onpage12 v “Customizeyour monitoringenvironment”onpage13

v “Monitorwith customsituationsthatmeetyourrequirements” onpage14 v “Collectand viewhistoricaldata” onpage15

For eachofthesepurposes,thereisa listofproceduresthatyouperformto achievethepurpose.For theprocedures,thereisacross-referencetowhere you canfindinformationaboutperformingthatprocedure.Informationaboutthe proceduresislocatedinsubsequentchaptersof thisuser’sguideandinthe followingpublications:

v IBMTivoliMonitoringUser’s Guide v

IBMTivoliMonitoringAdministrator’s Guide

View

real-time

data

about

VMware

ESX

Server

AfteryouinstallandconfigureIBM TivoliMonitoringforVirtualServers:VMware ESXAgent,theagentbeginsmonitoring.

Table1 containsalistof theproceduresforviewingthereal-timedataabout VMwareESXServer thatthemonitoringagentcollectsthrough thepredefined situations. Thetablealsocontains across-referencetowhere youcanfind informationabouteachprocedure.

Table1.Viewreal-timedataaboutVMwareESXServer

Procedure Wheretofindinformation

Viewthehierarchyofyourmonitored resourcesfromasystempointofview (Navigatorvieworganizedbyoperating platform,systemtype,monitoringagents, andattributegroups).

IBMTivoliMonitoringUser’sGuide:

″Navigatingthroughworkspaces″(in

″Monitoring:Real-timeandEvent-based″ chapter)

Viewtheindicatorsofrealorpotential problemswiththemonitoredresources (Navigatorview).

(26)

Table1.Viewreal-timedataaboutVMwareESXServer (continued)

Viewchangesinthestatusoftheresources thatarebeingmonitored(Enterprise MessageLogview).

IBMTivoliMonitoringUser’sGuide:″Using workspaces″(in″Monitoring:Real-timeand Event-based″chapter)

Chapter4,“Workspacesreference,”onpage 17inthisguide

Viewthestatusofthemonitoringagentsin themanagedenterprisethatyouare monitoring(MonitoringAgentStatusview). Viewthenumberoftimesaneventhasbeen openedforasituationduringthepast24 hours(OpenedSituationsCountview).

IBMTivoliMonitoringUser’sGuide:″Using workspaces″(in″Monitoring:Real-timeand Event-based″chapter)

Chapter6,“Situationsreference,”onpage49 inthisguide

Manipulatetheviewsinaworkspace. IBMTivoliMonitoringUser’sGuide:″Using views″(in″Monitoring:Real-timeand Event-based″chapter)

Investigate

an

event

Whentheconditionsofa situationhavebeenmet,anevent indicatorisdisplayed in theNavigator.Whenaneventoccurs, youwanttoobtaininformationaboutthat event soyoucancorrecttheconditions andkeepyourenterpriserunning

smoothly.

Table2 containsa listof theproceduresforinvestigating aneventand a cross-reference towhereyoucanfind informationabouteachprocedure.

Table2.Investigatinganevent

Determinewhichsituationraisedtheevent andidentifytheattributesthathavevalues thatarecontributingtothealert.

IBMTivoliMonitoringUser’sGuide:″Opening theeventworkspace″(in″Monitoring: Real-timeandEvent-based″chapter,

″RespondingtoAlerts″section)

Reviewavailableadvice.

Notifyotherusersthatyouhavetaken ownershipoftheproblemrelatedtoan eventandareworkingonit.

″Acknowledginganevent″(in″Monitoring: Real-timeandEvent-based″chapter,

RemovetheeventfromtheNavigator. IBMTivoliMonitoringUser’sGuide:″Closing theeventworkspace″(in″Monitoring: Real-timeandEvent-based″chapter,

Recover

the

operation

of

a

resource

Whenyoufindoutthataresourceisnotoperatingasdesired,youcancontrolit manuallyorautomaticallyusingTakeActioncommands.

(27)

Table3 containsalistof theproceduresforrecoveringtheoperationof aresource and across-reference towhereyoucanfindinformationabouteachprocedure.

Table3.Recovertheoperationofaresource

Takeanactiononaresourcemanually. IBMTivoliMonitoringUser’sGuide:

v ″OtherViews″(in″CustomWorkspaces″ chapter,″WorkspaceViews″section)

v ″Takeaction–Reflexautomation″(in SituationsforEvent-basedMonitoring″ chapter,″Event-basedMonitoring Overview″section)

Chapter7,“TakeActioncommands reference,”onpage61inthisguide Takeanactiononasystemcondition

automaticallybysettingupasituationto runaTakeActioncommand.

″SituationsforEvent-basedMonitoring″ chapter

v ″CustomizeaSituation″ v ″CreateaSituation″ v ″Specifyanactiontotake″ v ″Distributethesituation″ Chapter7,“TakeActioncommands reference,”onpage61inthisguide Takemultipleactionsonsystemconditions

automaticallyusingapolicy.

IBMTivoliMonitoringUser’sGuide:″Policies forAutomation″chapter

v ″Creatingapolicy″ v

″MaintainingPolicies″ v

″WorkflowsWindow″

Chapter8,“Policiesreference,”onpage65in thisguide

Takeactionsacrosssystems,agents,or computersusingapolicy.

Customize

your

monitoring

environment

Youcanchangehowyour monitoringenvironmentlooksbycreatingnew workspaceswith oneormoreviewsinit.

Table4 containsalistof theproceduresforcustomizingyourmonitoring

environment andacross-reference towhereyoucanfind informationabouteach procedure.

Table4.Customizingyourmonitoringenvironment

Displaydataintablesorcharts(views)in TivoliEnterprisePortal.

v ″CustomWorkspaces″ v ″TableandChartViews″ Displayanoverviewofchangesinthestatus

ofsituationsforyourmonitoredresources (MessageLogView).

IBMTivoliMonitoringUser’sGuide:″Message LogView″(in″EventViews:MessageLog, EventConsoleandGraphic″chapter)

(28)

Table4.Customizingyourmonitoringenvironment (continued)

Specifywhichattributestoretrievefora tableorchartsoyoucanretrieveonlythe datayouwantbycreatingcustomqueries.

IBMTivoliMonitoringUser’sGuide:″Create CustomQueries″(in″TableandChart Views″chapter)

Chapter5,“Attributesreference,”onpage23 inthisguide

Buildlinksfromoneworkspacetoanother. IBMTivoliMonitoringUser’sGuide:

v ″LinkfromaWorkspace″(in″Custom Workspaces″chapter)

v ″LinkfromaTableorChart″(in″Table andChartViews″chapter)

Identifywhichpredefinedsituationsstarted runningautomaticallywhenyoustartedthe TivoliEnterpriseManagementServer.

IBMTivoliMonitoringUser’sGuide:″What theenterpriseworkspaceshows″(in

″Monitoring:Real-timeandEvent-based″ chapter,″UsingWorkspaces″section) Chapter6,“Situationsreference,”onpage49 inthisguide

Determinewhethertorunsituationsas defined,modifythevaluesinsituations,or createnewsituationstodetectpossible problems.

“Monitorwithcustomsituationsthatmeet yourrequirements”inthischapter

Monitor

with

custom

situations

that

meet

your

requirements

Whenyourenvironment requiressituationswithvaluesthataredifferentfrom those intheexistingsituations, orwhenyouneedtomonitor conditionsnot definedbytheexistingsituations, youcancreatecustomsituationstodetect problems withresourcesintwoways:

v Createanentirelynew situation

v Createasituationbycopyingand editingapredefined situation

Youcanspecifythefollowinginformationfor asituation:

v Name v

Attributegroupandattributes

v Qualificationtoevaluatemultiple rowswhena situationhasa multiple-row

attributegroup(displayitem)

v Formula

v TakeActioncommands v Runat startup

v Samplinginterval v Persistence

v Manualorautomaticstart v Severity

v

Clearingconditions v ExpertAdvice

v Whena truesituationcloses v AvailableManagedSystems

(29)

Table5 containsalistof theproceduresformonitoringyourresources withcustom situationsthatmeetyour requirementsand across-reference towhereyoucanfind informationabouteachprocedure.

Table5.Monitorwithcustomsituations

Createanentirelynewsituation. IBMTivoliMonitoringUser’sGuide:″Createa newsituation″(in″Situationsfor

Event-basedMonitoring″chapter,″Creating aSituation″section)

Createasituationbycopyingandeditinga predefinedsituation.

″CustomizeaSituation″(in″Situationsfor Event-basedMonitoring″chapter)

Runasituationonamanagedsystem. IBMTivoliMonitoringUser’sGuide:

″SituationsforEvent-basedMonitoring″ chapter

v ″AssociateSituationswithNavigator Items″

v ″DistributetheSituation″(in″Customizea Situation″section)

v ″Start,StoporDeleteaSituation″

Collect

and

view

historical

data

Whenyoucollect historicaldata,youspecifythefollowingconfiguration requirements:

v Attributegroupsforwhichtocollectdata v Collectioninterval

v

Roll-offinterval toadatawarehouse,ifany

v Wheretostorethecollecteddata(attheagentortheTivoliEnterprise

ManagementServer)

Table6 onpage16contains alistoftheproceduresforcollectingandviewing historical dataandacross-reference towhereyoucanfind informationabouteach procedure.

(30)

Table6.Collectandviewhistoricaldata

Configureandstartcollectingshort-term data(24hours).

″HistoricalReporting″(in″TableandChart Views″chapter)

IBMTivoliMonitoringAdministrator’sGuide Configureandstartcollectinglonger-term

data(morethan24hours).

ViewhistoricaldataintheTivoliEnterprise Portal.

Createreportsfromhistoricaldatausing third-partyreportingtools.

Filteroutunwanteddatatoseespecific areasofinterest.

(31)

Chapter

4. Workspaces

reference

Thischaptercontainsanoverviewof workspaces,referencesfordetailed informationaboutworkspaces,anddescriptionsofthepredefinedworkspaces includedinthismonitoringagent.

About

workspaces

AworkspaceistheworkingareaoftheTivoliEnterprisePortalapplication window.Attheleftoftheworkspaceisa Navigatorthatyouusetoselectthe workspaceyouwanttosee.

AsyouselectitemsintheNavigator,theworkspacepresentsviewspertinentto your selection.Eachworkspacehasat leastoneview.Everyworkspacehasaset of propertiesassociatedwithit.

Thismonitoringagentprovides predefinedworkspaces.Youcannotmodifyor deletethepredefined workspaces,butyoucancreatenewworkspacesbyediting themand savingthechangeswith adifferentname.

More

information

about

workspaces

For moreinformationaboutcreating,customizing,andworking withworkspaces, seeIBMTivoliMonitoringUser’sGuide.

For alistofthepredefined workspacesforthis monitoringagentanda description of eachworkspace,refertothePredefinedworkspacessectionbelow andthe informationinthatsection foreachindividualworkspace.

Some attributegroupsforthisagentmight notbe representedinthepredefined workspacesorviewsforthisagent. Fora fulllistoftheattributegroups,seethe Attributes referencesection.

Ifyouareusingremotemanagement,inordertonavigatetoyour systemsinthe TivoliEnterprisePortal,navigatefromthehostnameofthemachinewhereyou installedtheagent.

Whenyouaddanothervmware agentinstance toaconfigurationthatalreadyhas a vmwareagentinstance,thenewagentinstanceappearsdynamically intheTivoli EnterprisePortal.Eachinstance’snameispresentedintheTivoliEnterprisePortal whenmore thanoneinstance isreporting fromaspecific host.Toidentifyan instance,navigatefromthehostnameofthemachinewhereyouinstalledthe agent. Forexample,withoneinstance,youwillseehostnameand thecontained node isVMwareESX.Theworkspacesthatdisplaydataforthisapplicationare contained inVMwareESXnode.Whenyouaddanadditionalinstance,both instancesappearunderhostnameand anadditionallevelthatdisplays asthe hostname:QV.Inthenavigatorview,theinstancenameisonlyshownif thereare twoormoreinstances.

(32)

Predefined

workspaces

IBM TivoliMonitoringforVirtualServers:VMwareESXAgentprovidesthe followingpredefined workspaces,whichare organizedbyNavigatoritem:

v VMwareESXNavigatoritem

– VMwareESXworkspace v

AvailabilityNavigatoritem

– Availabilityworkspace v

CPUNavigatoritem

– CPU workspace

– CPU perVMworkspace v DiskNavigatoritem

– Diskworkspace

– DiskperVMworkspace v MemoryNavigatoritem

– Memoryworkspace

– MemoryperVMworkspace v

NetworkNavigatoritem

– Network workspace

v VirtualMachinesNavigatoritem

– VirtualMachinesworkspace

The remainingsectionsofthischaptercontaindescriptionsofeachofthese predefined workspaces.Theworkspacesare organizedbytheNavigatoritemto whichtheworkspacesarerelevant.

VMware

ESX

Navigator

item

VMwareESX workspace

Thisworkspacedisplays theoverallstateoftheVMwareESXServer. Thisworkspacecontains thefollowingviews:

SystemOverview

DisplaysthesystemoverviewoftheVMwareESXServer. Availability

DisplaystheavailabilityoftheVMwareESXServer. Virtual Machines

Displaysthestateof thevirtual machinesinstalledonVMware ESXServer.

Availability

Navigator

item

Availability workspace

TheAvailabilityworkspacedisplays theoverallhealth oftheapplication. Thisagentrunsthefollowingtestsonthemonitored application:

v VMwareESXServer Status(KQV_VMwareESX_Status.bat) v VMwareESXServer Status(KQV_VMwareESX_Status.sh)

(33)

Availability

Displaysthestateof eachcomponentintheapplication.An application-specificoperationisperformedtodeterminewhether VMwareESXServerisrunningcorrectly.Thisisdisplayedusing thedescriptivenameofthefunctiontestedandtheresultsofthe operation(PASSEDorFAILED).Whenthestateofthecomponent isFAILED(foratest)it willbe highlightedwitharedbackground. Data CollectionStatus

Displaysthestatusofthetablesthatrepresentperformancemetrics forthis application.Thisview allowstheusertoverifythatdatais beingcollectedforeachofthetables. Ifdataisnotbeingcollected, itwillprovideanerrorstatus.Thismayindicatethatthereare no instancestobereturned, oritmayindicatedaproblemtobe corrected.

CPU

Navigator

item

CPUworkspace

Provides CPUinformationabouttheVMwareESXServer. Thisworkspacecontains thefollowingviews:

CPUUtilizationperPhysical CPU

DisplaystheCPUUtilizationforeachphysicalCPU. CPULoadAverage-Five MinuteAverage

DisplaystheloadaveragefortheCPUsoverfiveminuteintervals. CPULoadAverages

DisplaystheloadaveragefortheCPUsoveroneminute,five minute andfifteenminuteintervals.

CPUperVMworkspace

Provides CPUinformationpervirtualmachine ontheVMWareESXServer. Thisworkspacecontains thefollowingviews:

CPUSharesperVM

DisplaystheCPUsharesperVMfortheVMwareESXServer. CPUUtilizationRate

DisplaysthepercentrateofCPU utilizationperVMforthe VMwareESXServer.

Disk

Navigator

item

Disk workspace

Provides diskinformationabouttheVMwareESXServermachine. Thisworkspacecontains thefollowingviews:

FilesystemOverview

Displaysanoverviewofthefilesystems mountedontheVMware ESXServer.

VMFSFilesystem Overview

DisplaysanoverviewofthefilesintheVMFSfilesystem. FilesystemPercentUsed

Displaysthepercentofblocksusedbyeachfilesystem mountedon theVMwareESXServer.

(34)

Disk perVMworkspace

Provides diskinformationpervirtualmachine ontheVMWareESXServer. Thisworkspacecontains thefollowingviews:

Shareof DiskBandwidthAllocatedperVM

DisplaystherelativediskbandwithallocatedtoeachVMonthe VMwareESXServer.

Disk Activity

DisplaysthediskactivityperVMontheVMwareESXServer. Disk UtilizationRate

DisplaysthediskutilizationperVMontheVMwareESXServer. Disk AdaptersinUseperVM

DisplaysthediskadaptersinuseperVMontheVMwareESX Server.

Memory

Navigator

item

Memory workspace

Provides memoryinformationfortheVMwareESXServer machineand theVirtualMachines.

Thisworkspacecontains thefollowingviews: FreeMemory Available

DisplaysthefreememoryavailableontheVMwareESXServer. Memory Usedby ConsoleOS

DisplaysthememoryusedbytheconsoleOS(COS)onthe VMwareESXServer.

TotalMemory Statistics

TotalMemoryStatisticsDisplaysinKBthetotalandavailable memoryfortheVMwareESXserver.

Memory perVMworkspace

Provides memoryinformationforthevirtual machinesinstalledonthe VMwareESXServer.

Thisworkspacecontains thefollowingviews: Memory Usageper VM

DisplaysthememoryusedperVMinKBfor eachVMinstalledon theVMwareESXServer.

Memory ConfiguredperVM

DisplaysthememoryconfiguredinMBforeachVMinstalledon theVMwareESXServer.

Memory Sharesper VM

DisplaystherelativememoryallocatedtoeachVMinstalledonthe VMwareESXServer.

Network

Navigator

item

Networkworkspace

Provides networkinformationabouttheVMwareESXServer machine. Thisworkspacecontains thefollowingviews:

(35)

NetworkActivity

Displaysthenetworkactivity perVMfortheVMwareESXServer. NetworkUsageRateper Adapter

Displaysthenetworkutilizationperadapterfor theVMwareESX Server.

NetworkAdaptersinUseper VM

Displaysthenetworkadapters inuseperVMfortheVMwareESX Server.

Virtual

Machines

Navigator

item

Virtual Machinesworkspace

Provides anoverviewofthevirtualmachinesinstalledontheVMwareESX Server machine.

Thisworkspacecontains thefollowingviews: Virtual MachineOverview

Displaysthemetricsrelatedtothevirtualmachinesonthe

VMwareESXServer.Itdisplaysthestateofthevirtualmachinesas well asthestateoftheguestoperatingsystem installedonthe virtual machine.Avalueof unknownintheVMGuestState columnalongwith avalue ofoffintheVMState columnindicates thattheVMisdownandtheguestOSisinshutdown state.Also, a valueofunknownintheVMGuestStateand avalueof onin theVMStatecolumnsignifiesthatnoguestOShasbeeninstalled onthevirtualmachine..

Memory Configuredper VM

Displaysthememoryconfiguredforthevirtualmachinesinstalled ontheVMwareESXServer.

(36)

(37)

Chapter

5. Attributes

reference

Thischaptercontainsanoverviewof attributes,referencesfordetailedinformation aboutattributes,and descriptionsoftheattributes foreachattributegroup

includedinthismonitoringagent.

About

attributes

Attributes aretheapplicationpropertiesbeingmeasuredandreportedbyIBM TivoliMonitoringforVirtualServers:VMwareESXAgent.

Attributes areorganized intogroupsaccordingtotheirpurpose. Theattributesina group canbe usedin thefollowingtwoways:

v Chartortableviews

Attributesaredisplayed inchartand tableviews.Thechartandtableviewsuse queriestospecifywhichattributevaluestorequestfromamonitoringagent. YouusetheQueryeditorto createa newquery,modifyan existingquery,or applyfiltersandsetstyles todefinethecontentand appearanceofaview based onan existingquery.

v Situations

Youuseattributestocreatesituationsthatmonitorthestateof youroperating system,database,orapplication.Asituationdescribes aconditionyouwantto test.Whenyoustarta situation,theTivoliEnterprisePortalcomparesthevalues youhaveassignedtothesituationattributeswiththevaluescollectedbyIBM TivoliMonitoringforVirtualServers:VMwareESXAgentandregistersanevent iftheconditionismet.Youarealertedtoeventsbyindicatoricons thatare displayedintheNavigator.

More

information

about

attributes

For moreinformationaboutusingattributesandattributegroups,seeIBMTivoli MonitoringUser’sGuide.

For alistoftheattributesgroups, alistoftheattributesineachattributegroup, and descriptionsoftheattributesforthismonitoringagent,refertotheAttribute groupsandattributessection inthischapter.

Attribute

groups

and

attributes

for

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

Thismonitoringagentcontains thefollowingattributegroups:

v

Availability v CPUBase

v CPULoadAverage v CPUVM

v DiskBase v DiskUsage v DiskVM v MemoryBase

(38)

v MemoryperVM v MemoryVM v NetworkBase v NetworkVM

v PerformanceObjectStatus v System

v

SystemCPU v VirtualMachines v VMFileSystem

The remainingsectionsofthischaptercontaindescriptionsofthese attribute groups, whicharelistedalphabetically.Thefollowinginformationisprovidedfor eachattributegroup:

Attributes

Listofattributesthatbelongtotheattributegroup Historical group

Whethertheattributegroup isa historicaltypethatyoucanrollofftoa datawarehouse

Attribute descriptions

Descriptionand typeforeachattributeintheattributegroup

Availability

attribute

group

Contains theavailability datafortheapplication. Thetableprovidesacommon formatforrepresentationof applicationavailability.Thisincludestherelevant informationforthreeaspectsofanapplication.Theseareprocesses,services (Windows only)and functionalitytests.Thisagentrunsthefollowingtestsonthe monitored application:

v VMwareESXServer Status(KQV_VMwareESX_Status.bat) v

VMwareESXServer Status(KQV_VMwareESX_Status.sh)

Ifthewarehousedefaultsettingisenabled,dataforthisattributegroupisstoredin thewarehouse.

Historical

group

Thisattributegroupispartofthedefaulthistoricalgroup.

Attribute

descriptions

The followinglistcontains informationabouteachattributeintheAvailability attributegroup:

Node attribute-Thisattributeisa keyattribute.

Description

Themanagedsystemnameoftheagent. Type String

Timestamp attribute

Description

Thelocaltimeattheagentwhenthedatawas collected.

(39)

Application Componentattribute-Thisattributeisakeyattribute.

Description

Thedescriptive nameofa partoftheapplication. Type String

Nameattribute

Description

Thenameoftheprocess,serviceorfunctionaltest.Thiswillmatch theexecutablenameof theprocess,theserviceshortnameorthe nameoftheprocessusedtotesttheapplication.

Type String Status attribute

Description

Thestatusoftheapplicationcomponent.

v For processesthisis’UP’,’DOWN’’WARNING’or

’PROCESS_DATA_NOT_AVAILABLE’.

’PROCESS_DATA_NOT_AVAILABLE’ willbe displayedfora process whenthematching processisrunningbut theresource useinformationcannotbe collectedforthatprocess.

v For servicesthisis’UP’,’DOWN’or’UNKNOWN’.

’UNKNOWN’willbedisplayed whentheserviceisnot installed.

v For functionalityteststhis is’PASSED’or’FAILED’

Type String Full Nameattribute

Description

Thefullnameof theprocess includingthepath. Type String

Typeattribute

Description

Identifiesthetypeof theapplication component.Componentsare processes,servicesorfunctionalitytests.

Type Integer(Gauge) Virtual Sizeattribute

Description

Thevirtual size(inMB)oftheprocess. Type Integer(Gauge)

Page FaultsPer Secattribute

Description

Therate ofpagefaultsfortheprocessmeasuredinfaultsper second.Thiswillonlycontainvaliddataforprocesses. Type Integer(Gauge)

WorkingSetSizeattribute

(40)

Description

Theworking setsizeoftheprocessinMB. Thiswillonlycontain validdataforprocesses.

Type Integer(Gauge) Thread Countattribute

Description

Thenumber ofthreadscurrentlyallocatedbythisprocess.This willonlycontainvaliddataforprocesses.

Type Integer(Gauge) PID attribute

Description

Theprocess idassociatedwiththeprocess.Thiswillonlycontain validdataforprocesses.

Type Integer(Gauge) PercentPrivilegedTimeattribute

Description

Thepercentageof theavailable CPUtimethatisbeingusedbythis process forprivilegedoperation.

Type Integer(Gauge) PercentUserModeTimeattribute

Description

Thepercentageof theavailable CPUtimethatisbeingusedbythis process forusermodeoperation.

Type Integer(Gauge) PercentProcessorTimeattribute

Description

Thepercentageof theelapsedtimethatthisprocessusedthe processor toexecuteinstructions.

Type Integer(Gauge) CommandLineattribute

Description

Theprogramnameandanyargumentsspecifiedonthecommand linewhentheprocesswasstarted.ThishasthevalueN/Aif thisis a ServiceorFunctionality test.

Type String

Functionality TestStatus attribute

Description

Thereturn codeofthefunctionalitytest.Whenthemonitored application isrunningcorrectly’SUCCESS’isdisplayed,

’NOT_RUNNING’whenitisnotrunningcorrectlyor’N/A’when therowdoesnotrepresentafunctionalitytest.

Type Integerwith enumeratedvalues.Thestringsaredisplayed inthe TivoliEnterprisePortal,thewarehouseand querieswillreturnthe numbers. Thedefinedvaluesare:N/A(1), SUCCESS(0),

(41)

DEPENDENT_NOT_RUNNING (6),ALREADY_RUNNING(6), PREREQ_NOT_RUNNING(7),TIMED_OUT(8), DESNT_EXIST(9) orUNKNOWN(10).Anyothervalueswilldisplaythenumeric value intheTivoliEnterprisePortal.

Functionality TestMessageattribute

Description

ThetextmessagethatcorrespondstotheFunctionalityTestStatus. Thisisonlyvalidforfunctionalitytests.

Type String

CPU

Base

attribute

group

Contains metricsforCPU utilizationfortheVMwareESXServer.Ifthewarehouse defaultsettingisenabled,dataforthisattributegroupisnotstoredinthe

warehouse.

Historical

group

Thisattributegroupisnotpart ofthedefaulthistoricalgroup.

Attribute

descriptions

Thefollowinglistcontains informationabouteachattributeintheCPUBase attributegroup:

Description

Thelocaltimeattheagentwhen thedatawas collected. Type String

CPUVMIDattribute-Thisattributeisa keyattribute.

Description

TheIDallocatedtoarunningvirtualmachinebythevmkernel. ThiscorrespondstotheVMIDinthevirtual machinetable.A VMIDof127generallyrepresentstheserviceconsole.

Type Integer(Counter) CPUShareattribute

Description

AmountofrelativeCPU shareallocatedtothisvirtual machineby thevmkernel.

Type Integer(Counter) CPUUtilizationRateattribute

Description

TheCPU utilizationinsecondsperVMtimeinterval.AVMtime intervaldoesnotmatchreal-worldtimeintervals. ThisCPU

(42)

utilizationwillnotmatchmonitorsrunninginsidetheVMbecause ofprocessesintheVMandtheCPUusedbyotherVMs.

Type

CPU

Load

Average

attribute

group

ThiscontainsmetricsfortheCPUloadaverageoverone,fiveand fifteenminutes intervalsfortheVMwareESXServer.Theseare calculatedbydividingthe

numbersreportedinthe/proc/vmware/sched/cpu-loadvcpusrow bythe number ofphysicalcpus.Ifthewarehousedefaultsettingisenabled,dataforthis attributegroupisstoredin thewarehouse.

Historical

group

Attribute

descriptions

The followinglistcontains informationabouteachattributeintheCPULoad Averageattributegroup:

Description

Thelocaltimeattheagentwhenthedatawas collected. Type String

Load AvgOneMinattribute

Description

TheCPU loadaveragefortheVMwareESXServer calculatedover a oneminuteinterval.

Type Floatingpoint Load AvgFiveMinattribute

Description

TheCPU loadaveragefortheVMwareESXServer calculatedover a fiveminuteinterval.

Type Floatingpoint Load AvgFifteenMinattribute

Description

TheCPU loadaverageforthetheVMwareESXServercalculated overafifteen minuteinterval.

(43)

CPU

VM

attribute

group

ThisattributegroupcontainsmetricsfortheCPUutilizationofthevirtual machinesontheVMwareESXServer.Ifthewarehousedefaultsettingisenabled, dataforthis attributegroupisstored inthewarehouse.

Historical

group

Attribute

descriptions

Thefollowinglistcontains informationabouteachattributeintheCPUVM attributegroup:

Description

Thelocaltimeattheagentwhen thedatawas collected. Type String

VMIndexattribute

Description

Thesnmpindex numberforthisvirtual machine. Type Integer(Counter)

VMNameattribute

Description

Thedisplaynameforthisvirtual machine. Type String

VMConfigFileattribute-Thisattributeisa keyattribute.

Description

Fully qualifiedconfigurationfilenameforthisvirtual machine. Type String

VMOSattribute

Description

Operatingsystemrunningonthisvirtualmachine. Type String

VMMemoryattribute

Description

Memoryconfiguredforthis virtualmachineinMB. Type Integer(Counter)

VMStateattribute

Description

Virtualmachinestate.

Tivoli IBM Tivoli Monitoring for Virtual Servers: VMware ESX Agent

Tivoli

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

User’s

Guide

Tivoli

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

User’s

Guide

Contents

Tables

.

.

.

.

.

.

.

.

.

.

.

.

.

.

. v

About

this

guide

.

.

.

.

.

.

.

.

.

. vii

Chapter

1.

Overview

of

the

IBM

Tivoli

Monitoring

for

Virtual

Servers:

VMware

ESX

Agent

.

.

.

.

.

.

.

.

.

.

.