ITCAM for Microsoft Applications 6.2.0 - Microsoft Hyper-V Server Agent - User's Guide.pdf

Tivoli IBM Tivoli Monitoring for Microsoft Applications, V6.2.0 Interim Feature 1:Microsoft Hyper-V Server Agent V6.2.0.1

Users Guide

SC27-2319-01

NoteBefore using this information and the product it supports, read the information in Appendix D, Notices, on page 243.

This edition applies to version 6.2.0.1 of IBM Tivoli Monitoring for Microsoft Applications: Microsoft Hyper-VServer Agent (product number 5724-U17) and to all subsequent releases and modifications until otherwise indicatedin new editions.

Copyright International Business Machines Corporation 2008, 2009.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

ContentsTables . . . . . . . . . . . . . . . v

Chapter 1. Overview of the MonitoringAgent for Microsoft Hyper-V Server . . . 1IBM Tivoli Monitoring overview. . . . . . . . 1Features of the monitoring agent . . . . . . . 1Functions of the monitoring agent . . . . . . . 1New in this release . . . . . . . . . . . . 2Components of the IBM Tivoli Monitoringenvironment . . . . . . . . . . . . . . 5User interface options . . . . . . . . . . . 6

Chapter 2. Requirements andagent-specific installation andconfiguration information for themonitoring agent . . . . . . . . . . . 7Requirements for the monitoring agent . . . . . 7Installing language packs . . . . . . . . . . 9

Windows systems. . . . . . . . . . . . 9UNIX or Linux systems. . . . . . . . . . 9

Agent-specific installation and configuration . . . 10Configuration values . . . . . . . . . . 10Remote installation and configuration . . . . 10

Chapter 3. Workspaces reference . . . 11About workspaces . . . . . . . . . . . . 11More information about workspaces . . . . . . 11Cross-linked workspaces . . . . . . . . . . 11Predefined workspaces . . . . . . . . . . 14Agent Navigator items . . . . . . . . . . 15

Microsoft Hyper-V Server Navigator item . . . 15Availability Navigator item . . . . . . . . 17Disk Navigator item . . . . . . . . . . 18Event Log Navigator item . . . . . . . . 18Hypervisor Navigator item . . . . . . . . 19Memory Navigator item . . . . . . . . . 19Network Navigator item . . . . . . . . . 19Processor Navigator item . . . . . . . . . 20Virtual Machine Navigator item . . . . . . 22

Chapter 4. Attributes reference . . . . 23About attributes . . . . . . . . . . . . . 23More information about attributes . . . . . . . 23Attribute groups and attributes for the MonitoringAgent for Microsoft Hyper-V Server . . . . . . 23Availability attribute group . . . . . . . . . 26Disk attribute group . . . . . . . . . . . 30Enterprise Hyper-V Summary attribute group . . . 33Event Log attribute group . . . . . . . . . 35Hyper-V Hypervisor Logical Processor attributegroup . . . . . . . . . . . . . . . . 37Hyper-V Hypervisor Partition attribute group . . . 43Hyper-V Hypervisor Root Partition attribute group 45

Hyper-V Hypervisor Root Virtual Processorattribute group . . . . . . . . . . . . . 47Hyper-V Hypervisor Root Virtual Processor Moreattribute group . . . . . . . . . . . . . 53Hyper-V Hypervisor Virtual Processor attributegroup . . . . . . . . . . . . . . . . 70Hyper-V Hypervisor Virtual Processor Moreattribute group . . . . . . . . . . . . . 76Hyper-V Legacy Network Adapter attribute group 93Hyper-V Summary attribute group . . . . . . 95Hyper-V Task Manager Detail attribute group . . . 97Hyper-V Task Manager Recent Time attributegroup . . . . . . . . . . . . . . . . 109Hyper-V Virtual IDE Controller attribute group 122Hyper-V Virtual Machine Bus attribute group . . 124Hyper-V Virtual Machine Health Summaryattribute group . . . . . . . . . . . . . 126Hyper-V Virtual Machine Summary attribute group 127Hyper-V Virtual Network Adapter attribute group 132Hyper-V Virtual Switch attribute group . . . . 135Hyper-V Virtual Switch Port attribute group . . . 139Hyper-V VM IO APIC attribute group . . . . . 143Hypervisor attribute group . . . . . . . . . 144Memory attribute group . . . . . . . . . . 145Performance Object Status attribute group. . . . 148Processor attribute group . . . . . . . . . 152Thread Pool Status attribute group . . . . . . 155Virtual Machine attribute group . . . . . . . 158Virtual Switch attribute group . . . . . . . . 161VLAN Endpoint attribute group . . . . . . . 164Disk capacity planning for historical data . . . . 166

Chapter 5. Situations reference. . . . 169About situations . . . . . . . . . . . . 169More information about situations . . . . . . 169Predefined situations . . . . . . . . . . . 170Microsoft Hyper-V Server Navigator item . . . . 171Availability Navigator item. . . . . . . . . 171

KHV_Image_Mgmt_Service_Down situation . . 171KHV_Network_Service_Down situation . . . 172KHV_VM_Mgmt_Service_Down situation . . . 172

Disk Navigator item . . . . . . . . . . . 173KHV_VM_Disk_HealthState situation . . . . 173

Event Log Navigator item . . . . . . . . . 173KHV_HV_PDisk_Usage_Crit situation . . . . 173

Hypervisor Navigator item . . . . . . . . . 174KHV_HV_PNW_Utilization_Warn situation . . 174KHV_HV_PNW_Utilization_Crit situation . . . 174KHV_HV_PCPU_Utilization_Warn situation . . 175KHV_HV_PCPU_Utilization_Crit situation . . 176KHV_HV_PMemory_Available_Warn situation 176KHV_HV_PMemory_Available_Crit situation 177KHV_HV_PDisk_Latency_Crit situation . . . 177KHV_HV_PDisk_Latency_Warn situation . . . 178

Memory Navigator item. . . . . . . . . . 178

Copyright IBM Corp. 2008, 2009 iii

KHV_VM_Memory_HealthState situation . . . 178Network Navigator item . . . . . . . . . 179

KHV_VM_Switch_HealthState situation . . . 179KHV_HV_NWAdapter_FramesDroppedsituation . . . . . . . . . . . . . . 179KHV_HV_VSwitch_PacketsFlooded situation 180

Processor Navigator item . . . . . . . . . 180KHV_VM_ProcessorLoad_Crit situation . . . 180KHV_VM_Processor_Warn situation . . . . . 181KHV_HV_LP_Utilization_Warn situation . . . 182KHV_HV_LP_Utilization_Crit situation. . . . 182KHV_HV_LP_ContextSwitches situation . . . 183KHV_HV_RVP_Utilization_Warn situation . . 183KHV_HV_RVP_Utilization_Crit situation . . . 184KHV_HV_VP_Utilization_Crit situation . . . 184KHV_HV_VP_Utilization_Warn situation . . . 185

Virtual Machine Navigator item . . . . . . . 185KHV_VM_Heartbeat_Crit situation . . . . . 185

Chapter 6. Take Action commandsreference . . . . . . . . . . . . . 187About Take Action commands. . . . . . . . 187More information about Take Action commands 187Predefined Take Action commands . . . . . . 187Start Hyper-V Image Management Service action 188Start Hyper-V Networking Management Serviceaction . . . . . . . . . . . . . . . . 188Start Hyper-V Virtual Machine action . . . . . 189Start Hyper-V Virtual Machine ManagementService action . . . . . . . . . . . . . 190Stop Hyper-V Image Management Service action 191Stop Hyper-V Networking Management Serviceaction . . . . . . . . . . . . . . . . 191Stop Hyper-V Virtual Machine action . . . . . 191Stop Hyper-V Virtual Machine ManagementService action . . . . . . . . . . . . . 192

Chapter 7. Policies reference. . . . . 195About policies . . . . . . . . . . . . . 195More information about policies . . . . . . . 195Predefined policies . . . . . . . . . . . 195

Chapter 8. Troubleshooting . . . . . 197

Gathering product information for IBM SoftwareSupport . . . . . . . . . . . . . . . 197Built-in troubleshooting features . . . . . . . 197Problem classification. . . . . . . . . . . 198Trace logging . . . . . . . . . . . . . 198

Using KHVEventReader to retrieve events. . . 198Overview of log file management . . . . . 199Principal trace log files . . . . . . . . . 199Setting RAS trace parameters . . . . . . . 202

Problems and workarounds . . . . . . . . 204Installation and configuration troubleshooting 205Remote deployment troubleshooting . . . . 206Agent troubleshooting . . . . . . . . . 207Workspace troubleshooting . . . . . . . . 208Situation troubleshooting . . . . . . . . 210Take Action commands troubleshooting . . . 213

Support information . . . . . . . . . . . 213Informational, warning, and error messages . . . 214

Message format . . . . . . . . . . . 214Monitoring Agent for Microsoft Hyper-V Servermessages . . . . . . . . . . . . . . 215

Appendix A. IBM Tivoli EnterpriseConsole event mapping . . . . . . . 219

Appendix B. Documentation library 237Monitoring Agent for Microsoft Hyper-V Serverlibrary. . . . . . . . . . . . . . . . 237Prerequisite publications. . . . . . . . . . 237Related publications . . . . . . . . . . . 238Other sources of documentation . . . . . . . 238

Appendix C. Accessibility . . . . . . 241Navigating the interface using the keyboard . . . 241Magnifying what is displayed on the screen . . . 241

Appendix D. Notices . . . . . . . . 243Trademarks . . . . . . . . . . . . . . 245

Index . . . . . . . . . . . . . . . 247

iv Monitoring Agent for Microsoft Hyper-V Server: Users Guide

Tables1. Supported operating system and application

versions . . . . . . . . . . . . . . 72. Cross-linked workspaces to the Hyper-V agent 123. Cross-linked workspaces to the Cluster Server

agent. . . . . . . . . . . . . . . 144. Capacity planning for historical data logged

by IBM Tivoli Monitoring for MicrosoftApplications, V6.2.0 Interim Feature 1:Microsoft Hyper-V Server Agent V6.2.0.1 . . 167

5. Information to gather before contacting IBMSoftware Support . . . . . . . . . . 197

6. Trace log files for troubleshooting agents 2007. Problems and solutions for installation and

configuration . . . . . . . . . . . 205

8. General problems and solutions foruninstallation . . . . . . . . . . . 206

9. Remote deployment problems and solutions 20710. Agent problems and solutions . . . . . . 20711. Workspace problems and solutions . . . . 20912. General situation problems and solutions 21113. Problems with configuring situations that you

solve in the Situation Editor. . . . . . . 21114. Problems with configuration of situations that

you solve in the Workspace area . . . . . 21315. Take Action commands problems and

solutions . . . . . . . . . . . . . 213

Copyright IBM Corp. 2008, 2009 v

vi Monitoring Agent for Microsoft Hyper-V Server: Users Guide

Chapter 1. Overview of the Monitoring Agent for MicrosoftHyper-V Server

The Monitoring Agent for Microsoft Hyper-V Server provides you with thecapability to monitor Microsoft Hyper-V Server, and to perform basic actions withMicrosoft Hyper-V Server. This chapter provides a description of the features,components, and interface options for the Monitoring Agent for Microsoft Hyper-VServer.

IBM Tivoli Monitoring overviewIBM Tivoli Monitoring is the base software for the Monitoring Agent for MicrosoftHyper-V Server. IBM Tivoli Monitoring provides a way to monitor the availabilityand performance of all the systems in your enterprise from one or severaldesignated workstations. It also provides useful historical data that you can use totrack trends and to troubleshoot system problems.

You can use IBM Tivoli Monitoring to perform the following tasks:v Monitor for alerts on the systems that you are managing by using predefinedsituations or custom situations.

v Establish your own performance thresholds.v Trace the causes leading to an alert.v Gather comprehensive data about system conditions.v Use policies to perform actions, schedule work, and automate manual tasks.

The Tivoli Enterprise Portal is the interface for IBM Tivoli Monitoring products. Byproviding a consolidated view of your environment, the Tivoli Enterprise Portalpermits you to monitor and resolve performance issues throughout the enterprise.

See the IBM Tivoli Monitoring publications listed in Prerequisite publications onpage 237 for complete information about IBM Tivoli Monitoring and the TivoliEnterprise Portal.

Features of the monitoring agentThe Monitoring Agent for Microsoft Hyper-V Server software can identify, notifyyou of, and correct common problems with the application that it monitors. Thesoftware includes the following features:v Monitoringv Data gatheringv Operations management

Functions of the monitoring agentThe Monitoring Agent for Microsoft Hyper-V Server provides the followingfunctions:

Availability MonitoringMonitors the following services:v Hyper-V Image Management Service

Copyright IBM Corp. 2008, 2009 1

v Hyper-V Networking Management Servicev Hyper-V Virtual Machine Management Service

Configuration InformationProvides Hyper-V configuration and virtual machine configurationinformation such as the number of virtual machines, the state of the virtualmachines, the number of allocated virtual disks, the allocated virtualmemory, the number of allocated virtual processors, and so on.

Performance MonitoringCollects performance attributes in the following areas, providing situationswhere appropriate:v Event Logv Root Virtual Processorv Virtual Processorv Logical Processorv Hypervisor Root Partitionv Hypervisor Partitionv Virtual Machinev Virtual Diskv Virtual Memoryv Virtual Network

Enterprise DashboardDisplays the enterprise level information for all the Hyper-V systems in thefollowing areas:v Physical Processor Utilizationv Memory Utilizationv Network Utilizationv Disk Operations Ratev Logical Processor Utilizationv Virtual Processor Utilization

ActionsProvides actions to start and stop the Hyper-V services and virtualmachines.

High Availability MonitoringMonitors the high availability of virtual machines. The agent uses thefollowing crosslink and attributes to monitor the high availability of virtualmachines:v Cluster Migration Summary crosslink that is available on the MicrosoftHyper-V Server navigator item to provide information about the activenode, where the clustered virtual machines are present.

v The following attributes in the Task Manager Details workspace: Migrate Virtual Machine Tasks Completed Migrate Virtual Machine Tasks In Progress Migrate Virtual Machine Tasks Recent Time

New in this releaseFor version 6.2.0.1 of the Monitoring Agent for Microsoft Hyper-V Server, thefollowing enhancements have been made since version 6.2:

2 Monitoring Agent for Microsoft Hyper-V Server: Users Guide

v Additional supported operating systems as listed in Requirements for themonitoring agent on page 7

v New attribute groups Hyper-V Summary Event Log Hyper-V Hypervisor Hyper-V Virtual Machine Summary Hyper-V Virtual IDE Controller Hyper-V Hypervisor Partition Hyper-V Hypervisor Root Partition Hyper-V Hypervisor Logical Processor Hyper-V Hypervisor Virtual Processor Hyper-V Hypervisor Virtual Processor More Hyper-V VM IO APIC Hyper-V Hypervisor Root Virtual Processor Hyper-V Hypervisor Root Virtual Processor More Hyper-V Virtual Machine Health Summary Hyper-V Virtual Machine Bus Hyper-V Task Manager Detail Hyper-V Task Manager Recent Time Hyper-V Legacy Network Adapter Hyper-V Virtual Switch Hyper-V Virtual Switch Port Hyper-V Virtual Network Adapter

v New workspaces Enterprise Dashboard Enterprise Memory Dashboard Enterprise Disk Dashboard Enterprise Network Utilization Dashboard Enterprise Processor Dashboard Hyper-V Dashboard Event Log IDE Controller Partition VM Virtual Processor Load Root Virtual Processor Load Hyper-V Logical Processor Load Virtual Machine Summary Task Manager Details Legacy Network Adapter Virtual Switch Port Virtual Network Adapter Hypervisor

v New views Situation Event Console

Chapter 1. Overview of the Monitoring Agent for Microsoft Hyper-V Server 3

Top 5 Hyper-V System CPU % Top 5 Hyper-V System Memory Usage % Top 5 Hyper-V Network Utilization % Top 5 Hyper-V Disk Read Rate Enterprise Hyper-V Details Bottom 5 Hyper-V Memory Usage % Hyper-V System Memory details Top 5 Hyper-V System Disk Read Rate % Top 5 Hyper-V System Disk Write Rate % Hyper-V System Disk Read Write details Top 5 Hyper-V System Network Utilization % Bottom 5 Hyper-V System Network Utilization % Hyper-V Network Utilization details Bottom 5 Hyper-V System CPU % Top 5 Hyper-V System Logical Processor CPU % Top 5 Hyper-V System Virtual Processor CPU % Hyper-V System CPU details Hyper-V System Details Top 3 Logical Processor CPU % Bottom 3 Logical Processor CPU % Top 3 Virtual Processor CPU % Bottom 3 Virtual Processor CPU % Event Log Bytes Sectors IDE Controller Details Hypervisor Partition Hypervisor Root Partition Virtual Processor Load Processor Run Time Virtual Interrupts Root Virtual Processor Details Processor Run Time Virtual Interrupts Logical Processor Details Total Interrupts Virtual Machine Health Summary Virtual Machine Summary Virtual Machine Bus Virtual Machine Management Task Virtual Machine Startup Task Virtual Machine Snapshot Task Virtual Machine Resources Task Disk Task Service Settings Task


Frames Legacy Network Adapter Details Virtual Switch Port Details Packets Virtual Network Adapter

v New situations HV_VP_Utilization_Crit HV_VP_Utilization_Warn HV_LP_Utilization_Warn HV_LP_Utilization_Crit HV_LP_ContextSwitches HV_RVP_Utilization_Warn HV_RVP_Utilization_Crit HV_VSwitch_PacketsFlooded HV_NWAdapter_FramesDropped HV_PDisk_Usage_Crit HV_PNW_Utilization_Warn HV_PNW_Utilization_Crit HV_PCPU_Utilization_Warn HV_PCPU_Utilization_Crit HV_PMemory_Available_Warn HV_PMemory_Available_Crit HV_PDisk_Latency_Warn HV_PDisk_Latency_Crit

v Updated khv.baroc file to support TEC event mappingv Other new function

Components of the IBM Tivoli Monitoring environmentAfter you install and set up the Monitoring Agent for Microsoft Hyper-V Server,you have an environment that contains the client, server, and monitoring agentimplementation for IBM Tivoli Monitoring that contains the following components:v Tivoli Enterprise Portal client with a Java-based user interface for viewing andmonitoring your enterprise.

v Tivoli Enterprise Portal Server that is placed between the client and the TivoliEnterprise Monitoring Server and enables retrieval, manipulation, and analysisof data from the monitoring agents. The Tivoli Enterprise Portal Server is thecentral repository for all user data.

v Tivoli Enterprise Monitoring Server that acts as a collection and control point foralerts received from the monitoring agents, and collects their performance andavailability data. The Tivoli Enterprise Monitoring Server is also a repository forhistorical data.

v IBM Tivoli Enterprise Console is an optional component, which acts as a centralcollection point for events from a variety of sources, including those from otherTivoli software applications, Tivoli partner applications, custom applications,network management platforms, and relational database systems. You can viewthese events through the Tivoli Enterprise Portal (using the event viewer), andyou can forward events from IBM Tivoli Monitoring situations to the IBM TivoliEnterprise Console component.

Chapter 1. Overview of the Monitoring Agent for Microsoft Hyper-V Server 5

User interface optionsInstallation of the base software and other integrated applications provides thefollowing interfaces that you can use to work with your resources and data:

Tivoli Enterprise Portal browser client interfaceThe browser client interface is automatically installed with the TivoliEnterprise Portal Server. To start the Tivoli Enterprise Portal browser clientin your Internet browser, enter the URL for a specific Tivoli EnterprisePortal browser client installed on your Web server.

Tivoli Enterprise Portal desktop client interfaceThe desktop client interface is a Java-based graphical user interface (GUI)on a Windows or Linux workstation.

IBM Tivoli Enterprise ConsoleAn event management application that integrates system, network,database, and application management to help ensure the optimalavailability of an IT services for an organization.

Manage Tivoli Enterprise Monitoring Services windowThe window for the Manage Tivoli Enterprise Monitoring Services utility isused for configuring the agent and starting Tivoli services not alreadydesignated to start automatically.


Chapter 2. Requirements and agent-specific installation andconfiguration information for the monitoring agent

This chapter contains information about the requirements for the Monitoring Agentfor Microsoft Hyper-V Server, and agent-specific information related to installationand configuration of the agent.

To install and configure the Monitoring Agent for Microsoft Hyper-V Server, usethe procedures for installing monitoring agents in the IBM Tivoli MonitoringInstallation and Setup Guide along with the information in this chapter.

If you are performing a silent installation using a response file, see the informationabout performing a silent installation in the IBM Tivoli Monitoring Installation andSetup Guide.

Requirements for the monitoring agentIn addition to the requirements described in the IBM Tivoli Monitoring Installationand Setup Guide, the Monitoring Agent for Microsoft Hyper-V Server has thefollowing requirements:v The monitoring agent runs on any of these operating systems:Table 1. Supported operating system and application versions

Operating system versions Microsoft Hyper-V 2008

Windows Web Edition 2003 (32 bit) withService Pack 1

No

Windows Server 2003 SE (32 bit) with ServicePack 1 or Service Pack 2

No

Windows Server 2003 EE (32 bit) with ServicePack 1 or Service Pack 2

No

Windows Server 2003 Datacenter Edition (32bit) with Service Pack 1

No

Windows Server 2003 SE (64 bit) with ServicePack 1 or Service Pack 2

No

Windows Server 2003 EE (64 bit) with ServicePack 1 or Service Pack 2

No


No

Windows Server 2003 on Itanium2 (IA64)with Service Pack 2

No


No

Windows Server 2008 SE (32 bit) with ServicePack 1

No

Windows Server 2008 EE (32 bit) with ServicePack 1

No


No


Table 1. Supported operating system and application versions (continued)Operating system versions Microsoft Hyper-V 2008


No

Windows Server 2008 SE (64 bit) with ServicePack 2

Yes

Windows Server 2008 EE (64 bit) with ServicePack 2

Yes


Yes

Windows Server 2008 on Itanium2 (IA64)with Service Pack 1

No

Windows Server 2008 Datacenter on Itanium2(IA64)

No

Microsoft Hyper-V Server 2008 (64 bit) Yes

Required Microsoft OS hotfixes

The following Microsoft OS hotfix must be installed to support the agent andretrieve the data for the perfmon-based attribute groups:http://support.microsoft.com/kb/960751

The following OS hotfix is required to support the Hyper-V Summaryattribute group: http://support.microsoft.com/kb/961730

The operating system user account must have administrative privileges. Theagent service runs under the operating system user account.

Note: For the most current information about the operating systems that aresupported, see http://www-306.ibm.com/software/sysmgmt/products/support/Tivoli_Supported_Platforms.html.

v This agent monitors the following versions: Microsoft Hyper-V Server 2008

v A single computer that hosts the hub monitoring server, portal server, and amonitoring agent requires approximately 300 MB of space. A computer thathosts only the monitoring agent requires approximately 30 MB of space,including the specific enablement code for the monitoring agent. More space isrequired for each additional monitoring agent that you deploy on themonitoring computer.

v The monitoring agent must be connected to the following software: IBM Tivoli Monitoring V6.2.0 Fix Pack 1 or later.After you install the prerequisite software, install the following software, whichis required for the Monitoring Agent for Microsoft Hyper-V Server to operate: Monitoring Agent for Microsoft Hyper-V Server Monitoring Agent for Microsoft Hyper-V Server for Tivoli Enterprise

Monitoring Server support Monitoring Agent for Microsoft Hyper-V Server for Tivoli Enterprise Portal

Server support Monitoring Agent for Microsoft Hyper-V Server for Tivoli Enterprise Portal

Desktop Client support Monitoring Agent for Microsoft Hyper-V Server for Tivoli Enterprise Portal

Browser Client support


Installing language packsTo install a language pack for the agent support files on the Tivoli EnterpriseMonitoring Server, the Tivoli Enterprise Monitoring Agent, and the TivoliEnterprise Portal Server, first make sure that you have already installed theproduct in English, then perform the following steps depending on whichoperating system you are using.

Windows systems1. Double-click lpinstaller.bat in the language pack CD to launch the installation

program.2. Select the language of the installer and click OK.3. Click Next on the Introduction panel.4. Click Add/Update and click Next.5. Select the folder in which the National Language Support package

(NLSPackage) files are located.

Note: Usually the NLSPackage files are located in the nlspackage folderwhere the installer executable is located.

6. Select the language support for the agent of your choice and click Next.

Note: Hold down the Ctrl key for multiple selections.7. Select the languages that you want to install and click Next.8. Examine the installation summary page and click Next to begin installation.9. Click Finish after installation completes to exit the installer.

10. Restart Tivoli Enterprise Portal Desktop Client, Tivoli Enterprise Portal Server,and Eclipse Help Server if any of these components are installed.

UNIX or Linux systems1. Run the following command to create a temporary directory on the computer.

Make sure that the full path of the directory does not contain any spaces:mkdir dir_name

2. Mount the language pack CD to the temporary directory you just created.3. Run the following command to launch the installation program:

cd dir_namelpinstaller.sh -c ITM Home Directory

Where ITM Home Directory is where you installed IBM Tivoli Monitoring.Usually it is /opt/IBM/ITM for AIX and Linux.

4. Select the language of the installer and click OK.5. Click Next on the Introduction panel.6. Click Add/Update and click Next.7. Select the folder in which the National Language Support package

(NLSPackage) files are located.

Note: Usually, the NLSPackage files are located in the nlspackage folderwhere the installer executable is located.

8. Select the language support for the agent of your choice and click Next.

Note: Hold down the Ctrl key for multiple selections.

Chapter 2. Requirements and agent-specific installation and configuration information for the monitoring agent 9

9. Select the languages that you want to install and click Next.10. Examine the installation summary page and click Next to begin installation.11. Click Finish after installation completes to exit the installer.12. Restart Tivoli Enterprise Portal Desktop Client, Tivoli Enterprise Portal Server,

and Eclipse Help Server if any of these components are installed.

Agent-specific installation and configurationIn addition to the installation and configuration information in the IBM TivoliMonitoring Installation and Setup Guide, use the information in this section to installand configure the Monitoring Agent for Microsoft Hyper-V Server.

No special setup is necessary to manage this application.

Configuration valuesFor both local and remote configuration, provide the configuration values for theagent to operate. When configuring an agent, a panel is displayed so you can entereach value. When there is a default value, this value is pre-entered into the field. Ifa field represents a password, two entry fields are displayed. You must enter thesame value in each field. The values you type are not displayed to help maintainthe security of these values.

Remote installation and configurationWhen installing the agent remotely, you must provide the configuration values forthe agent to operate. See Configuration values.

See the tacmd describeSystemType section in the IBM Tivoli Monitoring CommandReference for information on displaying the configuration options that are availableto use with the configureSystem or addSystem commands.

You can install the monitoring agent remotely from the Tivoli Enterprise Portal orfrom the command line. To install from the portal, see the IBM Tivoli MonitoringInstallation and Setup Guide.

If using the command line, the following command is an example of remoteinstallation and configuration for Windows operating systems:tacmd addSystem -t HV -n Primary:sample.node.name:NT-p


Chapter 3. Workspaces referenceThis chapter contains an overview of workspaces, references for detailedinformation about workspaces, and descriptions of the predefined workspacesincluded in this monitoring agent.

About workspacesA workspace is the working area of the Tivoli Enterprise Portal applicationwindow. At the left of the workspace is a Navigator that you use to select theworkspace you want to see. As part of the application window, the right side ofthe status bar shows the Tivoli Enterprise Portal server name and port number towhich the displayed information applies, and the ID of the current user.

When you select an item in the Navigator tree, a default workspace is displayed.When you right-click a Navigator item, a menu that includes a Workspace item isdisplayed. The Workspace item contains a list of workspaces for that Navigatoritem. Each workspace has at least one view. Some views have links to otherworkspaces.

This monitoring agent provides predefined workspaces. You cannot modify ordelete the predefined workspaces, but you can create new workspaces by editingthem and saving the changes with a different name.

A table view within a workspace corresponds to a group of attributes; the columnsin the table view show some or all of the attributes available in the attribute group.

More information about workspacesFor more information about creating, customizing, and working with workspaces,see the IBM Tivoli Monitoring Users Guide.

For a list of the predefined workspaces for this monitoring agent and a descriptionof each workspace, refer to the Predefined workspaces section in this chapter andthe information in that section for each individual workspace.

Some attribute groups for this monitoring agent might not be represented in thepredefined workspaces or views for this agent. For a full list of the attributegroups, see the Attributes reference section.

Cross-linked workspacesThis section contains cross-links from the Hyper-V Server agent navigator itemsand workspaces to the Hyper-V Server and Cluster Server agent workspaces.Table 2 on page 12 and Table 3 on page 14 contains source, target, and filteringcriteria for the cross-linked workspaces.


Table 2. Cross-linked workspaces to the Hyper-V agentSourcenavigatoritem

Sourceworkspacename

Source viewname

TargetNavigatorItem

Targetworkspacename Filter

MicrosoftHyper-VServer

Hyper-VServices andVirtualMachineDetails

Hyper-VServicesStatus

Availability Availability Service Name



VirtualMachinesState

Disk IDEController

VirtualMachineName




Disk Virtual Disk VirtualMachineName




Processor Hyper-VLogicalProcessorLoad

VirtualMachineName




Processor VM VirtualProcessorLoad

VirtualMachineName




VirtualMachine

Partition VirtualMachineName




Memory VirtualMemory

VirtualMachineName


EnterpriseDashboard

EnterpriseHyper-VDetails


LocalHyper-VDashboard

N.A


EnterpriseNetworkUtilizationDashboard

Hyper-VNetworkUtilizationdetails



N.A


EnterpriseMemoryDashboard

Hyper-VSystemMemorydetails



N.A


EnterpriseDiskDashboard

Hyper-VSystem DiskRead Writedetails



N.A


Table 2. Cross-linked workspaces to the Hyper-V agent (continued)Sourcenavigatoritem

Sourceworkspacename

Source viewname

TargetNavigatorItem



EnterpriseProcessorDashboard

Hyper-VSystemProcessordetails



N.A



Hyper-VSystemDetails

Processor VM VirtualProcessorDetails

N.A





N.A




Processor Root VirtualProcessorLoad

N.A





N.A



Top 3 LogicalProcessorsHaving HighProcessorUsage


LogicalProcessorName



Bottom 3LogicalProcessorsHaving LowProcessorUsage


LogicalProcessorName



Top 3 VirtualProcessorsHaving HighProcessorUsage


VirtualProcessorName



Bottom 3VirtualProcessorsHaving LowProcessorUsage


VirtualProcessorName

VirtualMachine

VirtualMachineSummary

VirtualMachineHealthSummary

VirtualMachine

VirtualMachine

N.A.

Chapter 3. Workspaces reference 13

Table 3. Cross-linked workspaces to the Cluster Server agentSourcenavigatoritem

Sourceworkspacename

Source viewname

TargetNavigatorItem



N.A. N.A. ResourceGroups

ResourceGroupAssociations

N.A.

Predefined workspacesThe Monitoring Agent for Microsoft Hyper-V Server provides the followingpredefined workspaces, which are organized by Navigator item.v Microsoft Hyper-V Server Navigator item Microsoft Hyper-V Server workspace Enterprise Dashboard workspace Enterprise Disk Dashboard workspace Enterprise Memory Dashboard workspace Enterprise Network Utilization Dashboard workspace Enterprise Processor Dashboard workspace Local Hyper-V Dashboard workspace

v Availability Navigator item Availability workspace Performance Object Status workspace

v Disk Navigator item Disk workspace IDE Controller workspace

v Event Log Navigator item Event Log workspace

v Hypervisor Navigator item Hypervisor workspace

v Memory Navigator item Memory workspace

v Network Navigator item Legacy Network Adapter workspace Network workspace Virtual Network Adapter workspace Virtual Switch Port workspace VLAN EndPoint workspace

v Processor Navigator item Hyper V Logical Processor Load workspace Processor workspace Root Virtual Processor Load workspace VM Virtual Processor Details workspace VM Virtual Processor Load workspace

v Virtual Machine Navigator item


Partition workspace Task Manager Details workspace Virtual Machine workspace Virtual Machine Summary workspace

Agent Navigator itemsThis section contains descriptions of predefined workspaces. The workspaces areorganized by the Navigator item to which the workspaces are relevant.

Microsoft Hyper-V Server Navigator itemMicrosoft Hyper-V Server workspace

This workspace displays the details of the Microsoft Hyper-V services andthe state of the virtual machine.

This workspace contains the following views:

Hyper-V Services StatusDisplays the status of the Hyper-V services.

Virtual Machines StateDisplays the state of the virtual machines.

Hyper V DetailsDisplays the version and the statistical information about thehypervisor.

Virtual Machine SummaryDisplays the statistical information about the hypervisormanagement services.

Enterprise Dashboard workspaceThis workspace displays the details of the physical resources that areutilized by the all the Hyper-V systems in the enterprise.


Situation Event ConsoleDisplays the details of all situations that are triggered.

Enterprise Hyper-V DetailsDisplays the details of the physical resource that is utilized by theHyper-V system.

Top 5 Hyper-V Systems Having High Processor UsageDisplays the percentage of the five Hyper-V systems that havemaximum processor utilization.

Top 5 Hyper-V System Memory UsageDisplays the percentage of the five Hyper-V systems that havemaximum memory utilization.

Top 5 Hyper-V System Network Utilization PercentageDisplays the percentage of the five Hyper-V systems that havemaximum network utilization.

Top 5 Hyper-V System Disk Read RateDisplays five Hyper-V systems that have maximum disk read rate.


Enterprise Disk Dashboard workspaceThis workspace displays the latencies for read and write disk operationsfor all the Hyper-V systems in the enterprise.


Disk Read Write DetailsDisplays the latency for the read and write disk operations, inmilliseconds.

Top 5 Hyper-V System Disk Read RateDisplays five Hyper-V systems that have maximum disk read rate.

Top 5 Hyper-V System Disk Write RateDisplays five Hyper-V systems that have maximum disk write rate.

Enterprise Memory Dashboard workspaceThis workspace displays the details of the memory utilized by all theHyper-V systems in the enterprise.


Hyper-V System Memory DetailsDisplays the details of the memory utilized by all the Hyper-Vsystems in the enterprise.

Top 5 Hyper-V System Memory UsageDisplays the percentage of the five Hyper-V systems that havemaximum memory utilization.

Bottom 5 Hyper-V System Memory UsageDisplays the percentage of the five Hyper-V systems that haveminimum memory utilization.

Enterprise Network Utilization Dashboard workspaceThis workspace displays the details of the network utilized by all theHyper-V systems in the enterprise.


Hyper-V Network Utilization DetailsDisplays the details of the network utilized by all the Hyper-Vsystems in the enterprise.

Top 5 Hyper-V System Network UtilizationDisplays the percentage of the five Hyper-V systems that havemaximum network utilization.

Bottom 5 Hyper-V System Network UtilizationDisplays the percentage of the five Hyper-V systems that haveminimum network utilization.

Enterprise Processor Dashboard workspaceThis workspace displays the details of the processor utilized by all theHyper-V systems in the enterprise.


Top 5 Hyper-V Systems Having High Processor UsageDisplays the percentage of the five Hyper-V systems that havemaximum physical processor utilization.

Bottom 5 Hyper-V Systems Having Low Processor UsageDisplays the percentage of the five Hyper-V systems that haveminimum physical processor utilization.


Top 5 Logical Processors Having High Processor UsageDisplays the percentage of the five Hyper-V systems that havemaximum logical processor utilization.

Top 5 Virtual Processors Having High Processor UsageDisplays the percentage of the five Hyper-V systems whose virtualmachines have maximum virtual processor utilization.

Local Hyper-V Dashboard workspaceThis workspace displays the details of the physical resources that areutilized by the Hyper-V system.


Hyper-V System DetailsDisplays the details of the physical resource that is utilized by theHyper-V system.

Top 3 Logical Processors Having High Processor UsageDisplays the percentage of the three logical processors that havemaximum processor utilization.

Bottom 3 Logical Processors Having Low Processor UsageDisplays the percentage of the three logical processors that haveminimum processor utilization.

Top 3 Virtual Processors Having High Processor UsageDisplays the percentage of the three virtual processors that havemaximum processor utilization.

Bottom 3 Virtual Processors Having Low Processor UsageDisplays the percentage of the three virtual processors that haveminimum processor utilization.

Availability Navigator itemAvailability workspace

The Availability workspace displays the overall health of the application.


AvailabilityDisplays the state of each component in the application. Eachservice is displayed using a descriptive name, the short name ofthe service, and the state of the service (UP, DOWN, orUNKNOWN). The state is UP if the service is running, DOWN ifthe service exists but is not running. UNKNOWN indicates that theservice is not installed, so these elements are filtered from the view.When the state of the component is DOWN (for a process, orservice) it is highlighted with a red background.

ProcessorDisplays the amount of CPU used by each process that is acomponent of the application. This displays the 2 maincomponents of CPU usage, privileged time which is time spent inthe kernel on behalf of the process and user mode time, which isthe time spent running the process code.

ThreadsDisplays the number of threads used by each process that is acomponent of the application.


MemoryDisplays the amount of memory being consumed by each processthat is a component of the application. This total (virtual) size ofthe process and the size of the process in memory (working set)are displayed.

Performance Object Status workspaceThis workspace displays the overall health of the application.

This workspace contains the following view:

Performance Object StatusDisplays the status of the data collection from the application.Usually this will display NO ERROR indicating that the agent iscollecting application data correctly. If some of the other viewscontain no data, then this view will isolate the cause of the failure.Object name displays the data source object class name such asscript name, WMI class, and so on.

Disk Navigator itemDisk workspace

This workspace displays the details of hard drives within a virtualmachine.


Disk AllocatedDisplays the total disk space in GB, assigned to the virtual disk forthe virtual machine.

Virtual Disk DetailsDisplays the details of the hard drive within a virtual machine.

IDE Controller workspaceThis workspace displays the details about the IDE controller of the virtualmachine.


IDE Controller DetailsDisplays the details of the disks that are attached to the IDEcontroller.

Bytes Displays the number of bytes read from and written to the disksthat are attached to the IDE controller.

SectorsDisplays the number of sectors read from and written to the disksthat are attached to the IDE controller.

Event Log Navigator itemEvent Log workspace

This workspace displays the details of the critical, error, and warningevents that are specific to the Hyper-V system.


Event LogDisplays the details of the critical, error, and warning events thatare specific to the Hyper-V system.


Hypervisor Navigator itemHypervisor workspace

This workspace displays the Hyper-V system details.


Hyper-V System DetailsDisplays the version and the statistical information about thehypervisor.

Hyper-V System Load DetailsDisplays the information about the physical resource utilization bythe Hyper-V system.

Memory Navigator itemMemory workspace

This workspace displays the details of the memory currently allocated to avirtual machine.


Maximum Memory AllocatedDisplays the virtual memory in MB, allocated to the virtualmachine.

Virtual Memory DetailsDisplays the details of memory currently allocated to a virtualmachine.

Network Navigator itemLegacy Network Adapter workspace

This workspace displays the details of the Ethernet controller of the virtualmachine.


Legacy Network Adapter DetailsDisplays the details of the Ethernet controller of the virtualmachine.

Bytes Displays the total number of bytes sent and received per second onthe network adapter.

FramesDisplays the total number of frames sent and received per secondon the network adapter.

Network workspaceThis workspace displays the attributes that show the details of the virtualswitch and the data transferred on that switch.


Virtual Switch DetailsDisplays the details of the virtual switch.

Network Utilization DetailsDisplays the statistics for the virtual switch.


PacketsDisplays the details of the packets received and sent on the virtualswitch.

Bytes Displays the details of the bytes received and sent on the virtualswitch.

Virtual Network Adapter workspaceThis workspace displays the statistical details of the virtual networkadapter.


Virtual Network AdapterDisplays the statistical details of the virtual network adapter.

Bytes Displays the total number of bytes that traversed the networkadapter per second.

PacketsDisplays the total number of packets that traversed the networkadapter per second.

Virtual Switch Port workspaceThis workspace displays the statistical details of the virtual switch port.


Virtual Network AdapterDisplays the statistical details of the virtual switch port.

Bytes Displays the total number of bytes that traversed the virtual switchport per second.

PacketsDisplays the total number of packets that traversed the virtualswitch port per second.

VLAN EndPoint workspaceThis workspace displays the details of the VLAN endpoint of a switchport.


VLAN EndPoint DetailsDisplays the details of VLAN endpoint of a switch port.

Processor Navigator itemHyper V Logical Processor Load workspace

This workspace displays the details of the logical processor of thehypervisor.


Root Virtual Processor DetailsDisplays the details of the logical processor of the hypervisor.

Total InterruptsDisplays the number of interrupts that the logical processorprocesses.

Processor Run TimeDisplays the percentage of time for which the guest code andhypervisor code run on a virtual processor.


Processor workspaceThis workspace displays the top five virtual machines that show thehighest utilization of the virtual and physical processors.


Top 5 VMs Having High Virtual Processor LoadDisplays the top five virtual machines with a high virtualprocessor load on the virtual processor.

Top 5 VMs Utilizing High Physical ProcessorDisplays the top five virtual machines that show the highestutilization of the physical processor.

Root Virtual Processor Load workspaceThis workspace displays the details of the root virtual processor of thehypervisor.


Root Virtual Processor DetailsDisplays the details of the root virtual processor of the hypervisor.

Virtual InterruptsDisplays the rate of all virtual interrupts that are delivered to thevirtual processor.

Processor Run TimeDisplays the percentage of time for which the guest virtualprocessor runs in the non-hypervisor and hypervisor code on alogical processor.

VM Virtual Processor Details workspaceThis workspace displays the details of the virtual processor that is assignedto each virtual machine.


Virtual Processor DetailsDisplays the current percentage of the total processing power thatis consumed by the virtual machine.

AssertionsDisplays the information about the number of interrupt assertionsthat the I/O APIC device sent to the virtual machine.

VM Virtual Processor Load workspaceThis workspace displays the load details of the virtual processor that isassigned to each virtual machine.


Virtual Processor LoadDisplays the virtual processor load that is assigned to each virtualmachine.

Virtual InterruptsDisplays the rate of all virtual interrupts that are delivered to thevirtual processor.

Processor Run TimeDisplays the percentage of time for which the guest virtualprocessor runs in the non-hypervisor and hypervisor code on alogical processor.


Virtual Machine Navigator itemPartition workspace

This workspace displays the details of the root partition and the hypervisorpartition.


Root PartitionDisplays the details of the root partition.

Hypervisor PartitionDisplays the details of the hypervisor partition.

Task Manager Details workspaceThis workspace displays the statistics for the Virtual Machine Managementservice and the Task Manager.


Virtual Machine Resources TaskDisplays the details of resource tasks of the virtual machine.

Disk TaskDisplays the details of the disk tasks.

Service Settings TasksDisplays the details of the service settings tasks.

Virtual Machine Management TaskDisplays the details of the virtual machine management tasks.

Virtual Machine Startup TaskDisplays the details of the virtual machine startup tasks.

Virtual Machine Snapshot TasksDisplays the details of the virtual machine snapshot tasks.

Virtual Machine workspaceThis workspace displays the details of all virtual machines.


Virtual Machine DetailsDisplays the attributes that show the virtual machine details,status, and health.

Virtual Machine Summary workspaceThis workspace displays the statistical details of the virtual machinemanagement service.


Virtual Machine Health SummaryDisplays the health details of the Virtual Machine ManagementService.

Virtual Machine BusDisplays the statistics of the virtual machine bus.

Virtual Machine SummaryDisplays the statistical details of the virtual machine managementservice.


Chapter 4. Attributes referenceThis chapter contains an overview of attributes, references for detailed informationabout attributes, and descriptions of the attributes for each attribute groupincluded in this monitoring agent.

About attributesAttributes are the application properties being measured and reported by theMonitoring Agent for Microsoft Hyper-V Server.

Attributes are organized into groups according to their purpose. The attributes in agroup can be used in the following two ways:v Chart or table viewsAttributes are displayed in chart and table views. The chart and table views usequeries to specify which attribute values to request from a monitoring agent.You use the Query editor to create a new query, modify an existing query, orapply filters and set styles to define the content and appearance of a view basedon an existing query.

v SituationsYou use attributes to create situations that monitor the state of your operatingsystem, database, or application. A situation describes a condition you want totest. When you start a situation, the Tivoli Enterprise Portal compares the valuesyou have assigned to the situation attributes with the values collected by theMonitoring Agent for Microsoft Hyper-V Server and registers an event if thecondition is met. You are alerted to events by indicator icons that are displayedin the Navigator.

More information about attributesFor more information about using attributes and attribute groups, see the IBMTivoli Monitoring Users Guide.

For a list of the attributes groups, a list of the attributes in each attribute group,and descriptions of the attributes for this monitoring agent, see the Attributegroups and attributes section in this chapter.

Attribute groups and attributes for the Monitoring Agent for MicrosoftHyper-V Server

This monitoring agent contains the following attribute groups. The table namedepends on the maximum table name limits of the target database being used forthe Tivoli Data Warehouse. If the maximum name is 30 characters, then anywarehouse table name longer than 30 characters is shortened to the table name.v Attribute group name: Availability Table name: KHVAVAIL Warehouse table name: KHV_AVAILABILITY or KHVAVAIL

v Attribute group name: Disk Table name: KHVGETDIS0 Warehouse table name: KHV_DISK or KHVGETDIS0


v Attribute group name: Enterprise Hyper-V Summary Table name: KHVVHYPERV Warehouse table name: KHV_ENTERPRISE_HYPER-V_SUMMARY or

KHVVHYPERVv Attribute group name: Event Log Table name: KHVEVTLOG Warehouse table name: KHV_EVENT_LOG or KHVEVTLOG

v Attribute group name: Hyper-V Hypervisor Logical Processor Table name: KHVHYLPROC Warehouse table name: KHV_HYPER-

V_HYPERVISOR_LOGICAL_PROCESSOR or KHVHYLPROCv Attribute group name: Hyper-V Hypervisor Partition Table name: KHVHYPART Warehouse table name: KHV_HYPER-V_HYPERVISOR_PARTITION or

KHVHYPARTv Attribute group name: Hyper-V Hypervisor Root Partition Table name: KHVHYRPART Warehouse table name: KHV_HYPER-V_HYPERVISOR_ROOT_PARTITION or

KHVHYRPARTv Attribute group name: Hyper-V Hypervisor Root Virtual Processor Table name: KHVHYRPROC Warehouse table name: KHV_HYPER-

V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR or KHVHYRPROCv Attribute group name: Hyper-V Hypervisor Root Virtual Processor More Table name: KHVHYRPROM Warehouse table name: KHV_HYPER-

V_HYPERVISOR_ROOT_VIRTUAL_PROCESSOR_MORE or KHVHYRPROMv Attribute group name: Hyper-V Hypervisor Virtual Processor Table name: KHVHYVPROC Warehouse table name: KHV_HYPER-

V_HYPERVISOR_VIRTUAL_PROCESSOR or KHVHYVPROCv Attribute group name: Hyper-V Hypervisor Virtual Processor More Table name: KHVHYVPROM Warehouse table name: KHV_HYPER-

V_HYPERVISOR_VIRTUAL_PROCESSOR_MORE or KHVHYVPROMv Attribute group name: Hyper-V Legacy Network Adapter Table name: KHVLEGNWAD Warehouse table name: KHV_HYPER-V_LEGACY_NETWORK_ADAPTER or

KHVLEGNWADv Attribute group name: Hyper-V Summary Table name: KHVHYPERV Warehouse table name: KHV_HYPER-V_SUMMARY or KHVHYPERV

v Attribute group name: Hyper-V Task Manager Detail Table name: KHVTASKMD Warehouse table name: KHV_HYPER-V_TASK_MANAGER_DETAIL or

KHVTASKMDv Attribute group name: Hyper-V Task Manager Recent Time


Table name: KHVTASKMDR Warehouse table name: KHV_HYPER-V_TASK_MANAGER_RECENT_TIME

or KHVTASKMDRv Attribute group name: Hyper-V Virtual IDE Controller Table name: KHVVIDECON Warehouse table name: KHV_HYPER-V_VIRTUAL_IDE_CONTROLLER or

KHVVIDECONv Attribute group name: Hyper-V Virtual Machine Bus Table name: KHVVMBUS Warehouse table name: KHV_HYPER-V_VIRTUAL_MACHINE_BUS or

KHVVMBUSv Attribute group name: Hyper-V Virtual Machine Health Summary Table name: KHVVMHESUM Warehouse table name: KHV_HYPER-

V_VIRTUAL_MACHINE_HEALTH_SUMMARY or KHVVMHESUMv Attribute group name: Hyper-V Virtual Machine Summary Table name: KHVVMSUMMA Warehouse table name: KHV_HYPER-V_VIRTUAL_MACHINE_SUMMARY

or KHVVMSUMMAv Attribute group name: Hyper-V Virtual Network Adapter Table name: KHVVIRNWAD Warehouse table name: KHV_HYPER-V_VIRTUAL_NETWORK_ADAPTER or

KHVVIRNWADv Attribute group name: Hyper-V Virtual Switch Table name: KHVVIRSWIT Warehouse table name: KHV_HYPER-V_VIRTUAL_SWITCH or

KHVVIRSWITv Attribute group name: Hyper-V Virtual Switch Port Table name: KHVVIRSWPO Warehouse table name: KHV_HYPER-V_VIRTUAL_SWITCH_PORT or

KHVVIRSWPOv Attribute group name: Hyper-V VM IO APIC Table name: KHVVMIOAPI Warehouse table name: KHV_HYPER-V_VM_IO_APIC or KHVVMIOAPI

v Attribute group name: Hypervisor Table name: KHVHYPERVI Warehouse table name: KHV_HYPERVISOR or KHVHYPERVI

v Attribute group name: Memory Table name: KHVGETMEM0 Warehouse table name: KHV_MEMORY or KHVGETMEM0

v Attribute group name: Performance Object Status Table name: KHVPOBJST Warehouse table name: KHV_PERFORMANCE_OBJECT_STATUS or

KHVPOBJSTv Attribute group name: Processor Table name: KHVGETPRO0 Warehouse table name: KHV_PROCESSOR or KHVGETPRO0

Chapter 4. Attributes reference 25

v Attribute group name: Thread Pool Status Table name: KHVTHPLST Warehouse table name: KHV_THREAD_POOL_STATUS or KHVTHPLST

v Attribute group name: Virtual Machine Table name: KHVGETVIR0 Warehouse table name: KHV_VIRTUAL_MACHINE or KHVGETVIR0

v Attribute group name: Virtual Switch Table name: KHVMSVMVI4 Warehouse table name: KHV_VIRTUAL_SWITCH or KHVMSVMVI4

v Attribute group name: VLAN Endpoint Table name: KHVMSVMVI5 Warehouse table name: KHV_VLAN_ENDPOINT or KHVMSVMVI5

The remaining sections of this chapter contain descriptions of these attributegroups, which are listed alphabetically. The following information is provided foreach attribute group:

Historical groupWhether the attribute group is a historical type that you can roll off to adata warehouse

Attribute descriptionsDescription and type for each attribute in the attribute group

Some attributes are designated as key attributes. A key attribute is anattribute that is used in warehouse aggregation to identify rows of datathat represent the same object.

Availability attribute groupThe Availability attribute group contains the availability data for all processes andservices that make up this application. If the warehouse default setting is enabled,data for this attribute group is stored in Tivoli Data Warehouse.

Historical groupThis attribute group is part of the default historical group, and is eligible for usewith Tivoli Data Warehouse.

Attribute descriptionsThe following list contains information about each attribute in the Availabilityattribute group:

Node attribute - This attribute is a key attribute.

DescriptionThe managed system name of the agent.

Type String

Timestamp attribute

DescriptionThe local time at the agent when the data was collected.

Type String

Application Component attribute - This attribute is a key attribute.


DescriptionThe descriptive name of a part of the application.

Type String

Name attribute

DescriptionThe name of the process, service, or functionality test. This namematches the executable name of the process, the service short nameor the name of the process used to test the application.

Type String with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v N/A (N/A)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

Status attribute

DescriptionThe status of the application component.v For processes UP, DOWN, WARNING, orPROCESS_DATA_NOT_AVAILABLE:PROCESS_DATA_NOT_AVAILABLE is displayed for a processwhen the matching process is running but the resource useinformation cannot be collected for that process.

v For services UP, DOWN, or UNKNOWN: UNKNOWN isdisplayed when the service is not installed.

v For functionality tests: PASSED or FAILED is displayed.Type Integer with enumerated values. The strings are displayed in the

Tivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v DOWN (0)v UP (1)v WARNING (2)v UNKNOWN (3)v PASSED (4)v FAILED (5)v PROCESS_DATA_NOT_AVAILABLE (6)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

Full Name attribute

DescriptionThe full name of the process including the path.



Type attribute

DescriptionThe type of the application component. Components are processes,services, or functionality tests.

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v PROCESS (0)v SERVICE (1)v FUNCTIONALITY_TEST (2)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

Virtual Size attribute

DescriptionThe virtual size (in MB) of the process.

Type Integer (Gauge)

Page Faults per Sec attribute

DescriptionThe rate of page faults for the process measured in faults persecond. This attribute only contains valid data for processes.


Working Set Size attribute

DescriptionThe working set size of the process in MB. This attribute onlycontains valid data for processes.


Thread Count attribute

DescriptionThe number of threads currently allocated by this process. Thisattribute only contains valid data for processes.


PID attribute

DescriptionThe process ID associated with the process. This attribute onlycontains valid data for processes.


Percent Privileged Time attribute

DescriptionThe percentage of the available CPU time that is being used by thisprocess for privileged operation.


Percent User Mode Time attribute


DescriptionThe percentage of the available CPU time that is being used by thisprocess for user mode operation.


Percent Processor Time attribute

DescriptionThe percentage of the elapsed time that this process used theprocessor to execute instructions.


Command Line attribute

DescriptionThe program name and any arguments specified on the commandline when the process was started. This has the value N/A if this isa Service, or Functionality test.


Functionality Test Status attribute

DescriptionThe return code of the functionality test. When the monitoredapplication is running correctly, SUCCESS is displayed.NOT_RUNNING is displayed when it is not running correctly.N/A is displayed when the row does not represent afunctionality test.

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v SUCCESS (0)v N/A (1)v GENERAL_ERROR (2)v WARNING (3)v NOT_RUNNING (4)v DEPENDENT_NOT_RUNNING (5)v ALREADY_RUNNING (6)v PREREQ_NOT_RUNNING (7)v TIMED_OUT (8)v DOESNT_EXIST (9)v UNKNOWN (10)v DEPENDENT_STILL_RUNNING (11)v INSUFFICIENT_USER_AUTHORITY (12)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

Functionality Test Message attribute


DescriptionThe text message that corresponds to the Functionality Test Status.This is only valid for functionality tests.


Disk attribute groupThe Disk attribute group represents a hard drive within a virtual machine. If thewarehouse default setting is enabled, data for this attribute group is stored inTivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Disk attributegroup:



Type String

Timestamp attribute


Type String

Virtual Machine Name attribute

DescriptionName of the virtual machine

Type String

Availability attribute

DescriptionStatus of the device

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v Other (1)v Unknown (2)v Running/Full Power (3)v Warning (4)v In_Test (5)


v Not_Applicable (6)v Power_Off (7)v Off_Line (8)v Off_Duty (9)v Degraded (10)v Not_Installed (11)v Install_Error (12)v Power_Save_-_Unknown (13)v Power_Save_-_Low_Power_Mode (14)v Power_Save_-_Standby (15)v Power_Cycle (16)v Power_Save_-_Warning (17)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

HealthState attribute

DescriptionThe current health of the element

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v Healthy (5)v Non-Functional (30)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

EnabledState attribute

DescriptionThe enabled and disabled states of an element

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v Unknown (0)v Other (1)v Enabled (2)v Disabled (3)v Shutting_Down (4)v Not_Applicable (5)v Enabled_but_Offline (6)v In_Test (7)v Deferred (8)v Quiesce (9)v Starting (10)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

MaxDiskAllocated attribute


DescriptionThe total disk space in GB, assigned to the virtual disk for thevirtual machine.This is equal to (NumberOfBlocks*BlockSize)/1073741824

Type Integer (Numeric Property) with enumerated values. The stringsare displayed in the Tivoli Enterprise Portal. The warehouse andqueries return the values shown in parentheses. The followingvalues are defined:v Value_Exceeds_Maximum (2147483647)v Value_Exceeds_Minimum (-2147483648)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

DefaultBlockSize attribute

DescriptionThe default block size, in bytes, for the device

Type Integer (Numeric Property) with enumerated values. The stringsare displayed in the Tivoli Enterprise Portal. The warehouse andqueries return the values shown in parentheses. The followingvalues are defined:v Value_Exceeds_Maximum (2147483647)v Value_Exceeds_Minimum (-2147483648)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

LoadTime attribute

DescriptionThe amount of time that the media takes, from loading until beingable to read or write to media, in milliseconds

Type Integer (Gauge) with enumerated values. The strings are displayedin the Tivoli Enterprise Portal. The warehouse and queries returnthe values shown in parentheses. The following values are defined:v Value_Exceeds_Maximum (2147483647)v Value_Exceeds_Minimum (-2147483648)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

TotalMountTime attribute

DescriptionFor removable media, the total time in seconds required for datatransfer or to clean the device and for non removable media, thisproperty is not applicable and must be set to 0

Type Integer (Counter) with enumerated values. The strings aredisplayed in the Tivoli Enterprise Portal. The warehouse andqueries return the values shown in parentheses. The followingvalues are defined:v Value_Exceeds_Maximum (2147483647)v Value_Exceeds_Minimum (-2147483648)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.


FreePhysicalDisk attribute

DescriptionThe free physical disk space available, in GB


Virtual Machine ID attribute - This attribute is a key attribute.

DescriptionThe unique identifier for the virtual machine

Type String

Device ID attribute - This attribute is a key attribute.

DescriptionThe unique identifier for the disk drive

Type String

Enterprise Hyper-V Summary attribute groupProvides the data that is contained in the Hyper-V Summary attribute group for allthe monitored Microsoft Hyper-V Server systems in the enterprise. The data iscollected from each agent in the environment every 10 minutes. The Hyper-VSummary attribute group provides information about the physical resourceutilization by the Hyper-V system. If the warehouse default setting is enabled, datafor this attribute group is not stored in Tivoli Data Warehouse.

Historical groupThis attribute group is not part of the default historical group, and is eligible foruse with Tivoli Data Warehouse.

Attribute descriptionsThe following list contains information about each attribute in the EnterpriseHyper-V Summary attribute group:



Type String

Timestamp attribute


Type String

SystemProcessorUtilization attribute


DescriptionThe percentage of the processor that is utilized by the Hyper-Vsystem.


MemoryAvailable attribute

DescriptionThe memory available in percentage on the Hyper-V system.


MemoryUtilized attribute

DescriptionThe percentage of memory that is utilized by the Hyper-V system.


DiskReadLatency attribute

DescriptionThe latency of the read operations on the disk, in milliseconds.


DiskWriteLatency attribute

DescriptionThe latency of the write operations on the disk, in milliseconds.

Type Integer (Gauge) with enumerated values. The strings are displayed


in the Tivoli Enterprise Portal. The warehouse and queries returnthe values shown in parentheses. The following values are defined:v Value_Exceeds_Maximum (2147483647)v Value_Exceeds_Minimum (-2147483648)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

NetworkUtilization attribute

DescriptionMaximum network utilization by the network interface


MaxLogicalProcessor attribute

DescriptionThe maximum processor utilization in percentage by the logicalprocessor.


MaxVirtualProcessor attribute

DescriptionThe maximum virtual processor utilization in percentage by thevirtual machine.


Event Log attribute groupThe Event Log attribute group provides information about the critical, error, andwarning events that are specific to the Hyper-V system. If the warehouse defaultsetting is enabled, data for this attribute group is not stored in Tivoli DataWarehouse.


Historical groupThis attribute group is not part of the default historical group, and is eligible foruse with Tivoli Data Warehouse.

Attribute descriptionsThe following list contains information about each attribute in the Event Logattribute group:



Type String

Timestamp attribute


Type String

Log Name attribute

DescriptionThe name of the event log for a specific application.

Type String

Event Source attribute

DescriptionThe event source that is defined by the Hyper-V server role.

Type String

Event ID attribute

DescriptionThe ID of the event.


Event Type attribute

DescriptionThe type of the event, for example, Critical, Error, and Warning.

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v Critical (1)v Error (2)v Warning (3)v Information (4)


Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

Event Category attribute

DescriptionThe task category of the event.

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v None (0)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

Time Generated attribute

DescriptionThe time when the event is generated.

Type String

Message attribute

DescriptionThe description of the event.

Type String

Hyper-V Hypervisor Logical Processor attribute groupThe Hyper-V Hypervisor Logical Processor attribute group provides informationabout the logical processors of the hypervisor. If the warehouse default setting isenabled, data for this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Hyper-VHypervisor Logical Processor attribute group:



Type String

Timestamp attribute


Type String

Percent C1 Time attribute

DescriptionThe percentage of time for which the processor is in the C1low-power idle state.


Type Real number (Gauge) with 2 decimal places of precision withenumerated values. The strings are displayed in the TivoliEnterprise Portal. The warehouse and queries return the valuesshown in parentheses. The following values are defined:v Value_Exceeds_Maximum (2147483647)v Value_Exceeds_Minimum (-2147483648)Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.







Percent Guest Run Time attribute

DescriptionThe percentage of time that the guest code takes to run on a logicalprocessor.


Percent Hypervisor Run Time attribute


DescriptionThe percentage of time that the hypervisor takes to run on a logicalprocessor.


Percent Idle Time attribute

DescriptionThe percentage of time for which the logical processor is idle.


Percent Total Run Time attribute

DescriptionThe percentage of the total runtime on each virtual processor,where total runtime is the sum of the Percentage Guest Time andthe Percentage Hypervisor Runtime attributes.


C1 Transitions Per Sec attribute

DescriptionThe rate at which the processor entered the C1 low-power idlestate.









Context Switches Per Sec attribute

DescriptionThe rate at which the virtual processor switches context.


Hardware Interrupts Per Sec attribute

DescriptionThe rate of hardware interrupts (excluding the hypervisorinterrupts) to the processor.

Type Real number (Gauge) with 2 decimal places of precision withenumerated values. The strings are displayed in the TivoliEnterprise Portal. The warehouse and queries return the valuesshown in parentheses. The following values are defined:v Value_Exceeds_Maximum (2147483647)v Value_Exceeds_Minimum (-2147483648)


Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

Inter Processor Interrupts Per Sec attribute

DescriptionThe rate at which the processor sends the interprocessor interrupts.


Inter Processor Interrupts Sent Per Sec attribute

DescriptionThe rate at which the hypervisor inter-processor interrupts aredelivered to the processor.

Type Real

Date post:	13-Oct-2015
Category:	Documents
Upload:	linkspirit
View:	32 times
Download:	0 times

ITCAM for Microsoft Applications 6.2.0 - Microsoft Hyper-V Server Agent - User's Guide.pdf

Documents