IBM Tivoli Composite Application Manager for Microsoft
Applications: Microsoft Hyper-V Server Agent
vNext
User's Guide - Beta 1 Draft
IBM Tivoli Composite Application Manager for Microsoft
Applications: Microsoft Hyper-V Server Agent
vNext
User's Guide - Beta 1 Draft
Note
Before using this information and the product it supports, read the information in “Notices” on page 355.
This edition applies to vNext of IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Hyper-V Server Agent (product number 5724-U18) and to all subsequent releases and modifications until otherwise indicated in new editions.
Contents
Tables
. . . v
Chapter 1. Overview of the agent . . . . 1
IBM Tivoli Monitoring . . . 1
Functions of the monitoring agent . . . 1
New in this release . . . 2
Components of the IBM Tivoli Monitoring environment . . . 3
Agent Management Services . . . 4
User interface options . . . 4
Data sources . . . 5
Chapter 2. Agent installation and
configuration
. . . 7
Requirements . . . 7
Language pack installation . . . 7
Installing language packs on Windows systems . . 7
Installing language packs on UNIX or Linux systems . . . 8
Silent installation of language packs on Windows, UNIX, or Linux systems . . . 8
Running as a non-administrator user . . . 10
Prerequisites checking . . . 11
Agent-specific installation and configuration . . . 11
Configuration values . . . 11
Remote installation and configuration . . . . 12
Chapter 3. Workspaces reference . . . 13
Cross-linked workspaces . . . 13
Predefined workspaces . . . 16
Workspace descriptions . . . 17
Microsoft Hyper-V Server Navigator item . . . 17
Availability Navigator item . . . 19
Disk Navigator item . . . 20
Event Log Navigator item . . . 20
Hypervisor Navigator item . . . 20
Memory Navigator item . . . 21
Migration Navigator item . . . 21
Network Navigator item . . . 21
Processor Navigator item . . . 22
Virtual Machine Navigator item . . . 23
VM Modification Navigator item . . . 24
Chapter 4. Attributes reference . . . . 25
Attribute groups for the monitoring agent . . . . 25
Attributes in each attribute group . . . 28
Availability attribute group . . . 29
Director attribute group . . . 34
Disk attribute group . . . 35
Enterprise Hyper-V Summary attribute group . . 38
Event Log attribute group . . . 41
Hyper V Dynamic Memory Balancer attribute group . . . 43
Hyper V Dynamic Memory VM attribute group 45 Hyper-V Hypervisor Logical Processor attribute group . . . 49
Hyper-V Hypervisor Partition attribute group . . 56
Hyper-V Hypervisor Root Partition attribute group . . . 59
Hyper-V Hypervisor Root Virtual Processor attribute group . . . 61
Hyper-V Hypervisor Root Virtual Processor More attribute group . . . 68
Hyper-V Hypervisor Virtual Processor attribute group . . . 89
Hyper-V Hypervisor Virtual Processor More attribute group . . . 97
Hyper-V Legacy Network Adapter attribute group . . . 118
Hyper-V Summary attribute group . . . 120
Hyper-V Task Manager Detail attribute group 123 Hyper-V Task Manager Recent Time attribute group . . . 138
Hyper-V Virtual IDE Controller attribute group 154 Hyper-V Virtual IDE Controller Filter attribute group . . . 156
Hyper-V Virtual IDE Controller Win2K12 attribute group . . . 158
Hyper-V Virtual Machine Bus attribute group 160 Hyper-V Virtual Machine Health Summary attribute group . . . 163
Hyper-V Virtual Machine Summary attribute group . . . 164
Hyper-V Virtual Network Adapter attribute group . . . 169
Hyper-V Virtual Storage Device attribute group 174 Hyper-V Virtual Switch attribute group . . . 176
Hyper-V Virtual Switch Port attribute group . . 181
Hyper-V VM Association with Virtual Network attribute group . . . 186
Hyper-V VM IO APIC attribute group . . . . 187
Hyper-V VM Vid Partition attribute group . . 188
Hypervisor attribute group . . . 190
Memory attribute group . . . 192
Memory in Percentage attribute group . . . . 195
Migration attribute group . . . 196
Performance Object Status attribute group . . . 197
Processor attribute group . . . 202
Resource Metering attribute group . . . 205
Thread Pool Status attribute group . . . 208
Virtual Machine attribute group . . . 211
Virtual Switch attribute group . . . 216
VLAN Endpoint attribute group . . . 220
VM Mig WO Cluster attribute group . . . . 222
VM Modification attribute group . . . 224
Disk capacity planning for historical data . . . . 225
Chapter 5. Situations reference. . . . 229
Situation descriptions. . . 231
Microsoft Hyper-V Server Navigator item . . . 231
Availability Navigator item . . . 231
Disk Navigator item . . . 233
Event Log Navigator item . . . 233
Hypervisor Navigator item . . . 234
Memory Navigator item . . . 237
Migration Navigator item . . . 238
Network Navigator item . . . 238
Processor Navigator item . . . 239
Virtual Machine Navigator item . . . 243
VM Modification Navigator item . . . 244
Chapter 6. Take Action commands
reference . . . 247
Predefined Take Action commands . . . 247
Take Action command descriptions . . . 248
Enable VM Resource Metering action . . . . 248
Start Hyper-V Image Management Service action . . . 248
Start Hyper-V Networking Management Service action . . . 249
Start Hyper-V Virtual Machine action . . . . 250
Start Hyper-V Virtual Machine Management Service action . . . 251
Stop Hyper-V Image Management Service action . . . 252
Stop Hyper-V Networking Management Service action . . . 252
Stop Hyper-V Virtual Machine action . . . . 253
Stop Hyper-V Virtual Machine Management Service action . . . 254
Chapter 7. Policies reference. . . 257
Predefined policies . . . 257
Policy descriptions . . . 257
Chapter 8. Tivoli Common Reporting
for the monitoring agent
. . . 259
Cognos-based report packages. . . 259
Prerequisites. . . 259
Importing Cognos report packages . . . 261
Cognos data models and reports . . . 262
Chapter 9. Troubleshooting . . . 271
Trace logging . . . 272
Using KHVEventReader to retrieve events. . . 272
Overview of log file management . . . 273
Principal trace log files . . . 273
Examples: Using trace logs . . . 276
RAS trace parameters . . . 277
Dynamic modification of trace settings . . . . 279
Setting trace parameters for the Tivoli Enterprise Console server . . . 282
Problems and workarounds . . . 283
Installation and configuration troubleshooting 283 Remote deployment troubleshooting . . . . 287
Agent troubleshooting . . . 288
Workspace troubleshooting . . . 294
Situation troubleshooting . . . 298
Take Action commands troubleshooting . . . 301
Tivoli Common Reporting troubleshooting . . 301
Support information . . . 303
Informational, warning, and error messages overview . . . 303
Message format . . . 303
Agent messages . . . 304
Appendix A. Event mapping . . . 309
Appendix B. Discovery Library
Adapter for the Microsoft Hyper-V
Server agent . . . 341
DLA data model class types represented in CDM 341 DLA data model classes for Microsoft Hyper-V Server agent . . . 341 OperatingSystem class . . . 342 WindowsComputerSystem class . . . 342 ComputerSystem class . . . 343 StorageExtent class . . . 344 LocalFileSystem class . . . 345
Appendix C. Integration with Tivoli
Business Service Manager
. . . 347
Components for integrating with Tivoli Business Service Manager . . . 347
Tasks to integrate the agent with Tivoli Business Service Manager . . . 348
Installing the Discovery Library Toolkit on the Tivoli Business Service Manager . . . 348
Configuring the Tivoli Event Integration Facility (EIF) probe to enrich events . . . 348
Creating a service in Tivoli Business Service Manager . . . 349
Creating a data source mapping for each data source . . . 350
Configuring additional IBM Tivoli Monitoring web services. . . 350
Viewing data in the Tivoli Enterprise Portal . . 350
Appendix D. Documentation library
351
Prerequisite publications. . . 351Related publications . . . 352
Other sources of documentation . . . 352
Notices . . . 355
Trademarks . . . 357
Tables
1. Mechanisms used to gather attributes . . . . 5 2. Cross-linked workspaces within the Hyper-V
agent. . . 14 3. Cross-linked workspaces to the Cluster Server
agent. . . 15 4. Cross-linked workspaces to the Windows OS
agent. . . 15 5. Cross-linked workspaces to the Linux OS
agent. . . 16 6. Capacity planning for historical data logged
by the Microsoft Hyper-V Server agent . . . 226 7. Hyper-V Server Agent Reports Prerequisite
Scanner report . . . 263 8. Top N Hyper-V Server Utilization report 263 9. Heartbeat Availability for Virtual Machine
report . . . 264 10. Hyper-V Service Availability report . . . . 266 11. Top N Virtual Machines report. . . 267
12. Hyper-V Service Virtual Size and Working Set Size report . . . 267 13. Information to gather before contacting IBM
Software Support . . . 271 14. Trace log files for troubleshooting agents 274 15. Problems and solutions for installation and
configuration . . . 283 16. General problems and solutions for
uninstallation . . . 285 17. Remote deployment problems and solutions 287 18. Agent problems and solutions . . . 288 19. Workspace problems and solutions . . . . 295 20. Situation problems and solutions . . . 298 21. Take Action commands problems and
solutions . . . 301 22. Tivoli Common Reporting for Microsoft
Chapter 1. Overview of the agent
The IBM®Tivoli® Composite Application Manager for Microsoft Applications: Microsoft Hyper-V Server Agent provides you with the capability to monitor Microsoft Hyper-V Server. You can also use the agent to take basic actions with the Microsoft Hyper-V Server.
IBM Tivoli Monitoring is the base software for the Microsoft Hyper-V Server agent. The Microsoft Hyper-V Server agent monitors the following areas:
v Availability and resources v Error and event log v Performance v Historical data
IBM Tivoli Monitoring
IBM Tivoli Monitoring provides a way to monitor the availability and performance of all the systems in your enterprise from one or several designated workstations. It also provides useful historical data that you can use to track trends and to troubleshoot system problems.
You can use IBM Tivoli Monitoring to achieve the following tasks:
v Monitor for alerts on the systems that you are managing by using predefined situations 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 take actions, schedule work, and automate manual tasks.
The Tivoli Enterprise Portal is the interface for IBM Tivoli Monitoring products. You can use the consolidated view of your environment as seen in the Tivoli Enterprise Portal to monitor and resolve performance issues throughout the enterprise.
See the IBM Tivoli Monitoring publications listed in “Prerequisite publications” on page 351 for complete information about IBM Tivoli Monitoring and the Tivoli Enterprise Portal.
Functions of the monitoring agent
Availability Monitoring
Monitors the following services: v Hyper-V Image Management Service v Hyper-V Networking Management Service v Hyper-V Virtual Machine Management Service
Configuration Information
Provides information about Hyper-V configuration and virtual machine configuration, such as the number of virtual machines, the state of the virtual machines, the number of allocated virtual disks, the allocated virtual memory, the number of allocated virtual processors, and so on.
Performance Monitoring
v Root Virtual Processor v Virtual Processor v Logical Processor
v Hypervisor Root Partition v Hypervisor Partition v Virtual Machine v Virtual Disk v Virtual Memory v Dynamic Memory v Virtual Network Enterprise Dashboard
Displays the enterprise level information for all the Hyper-V systems in the following areas: v Physical Processor Utilization
v Memory Utilization v Network Utilization v Disk Operations Rate v Logical Processor Utilization v Virtual Processor Utilization
Actions
Provides actions to start and stop the Hyper-V services and virtual machines.
High Availability Monitoring
Monitors the high availability of virtual machines. The agent uses the following crosslinks and workspaces to monitor the high availability of virtual machines:
v Cluster Migration Summary cross-link that is available on the Microsoft Hyper-V Server navigator item to provide information about the active node where the clustered virtual machines are present.
v Cluster Dashboard cross-link that is available on the Migration navigator item to provide information about the cluster and it is resource capacity.
v VM Modification and Migration workspaces to provide information about clustered virtual machines.
Dynamic Navigation View
Provides the dynamic navigation view, that dynamically populates itself with the Hyper-V Server agents that are currently available. This view organizes the agents according to their domain.
IBM Systems Director Integration
Provides integration with the IBM Systems Director. With the IBM Systems Director, you can open the VM control web page from the Tivoli Enterprise Portal and manage the physical and virtual machines.
New in this release
For the Microsoft Hyper-V Server agent, the following enhancements were made since version 6.3, including the fix packs:
v New attribute groups: – VM Mig WO Cluster v New or changed situations:
– HV_VMMigrate_WO_Cluster_Info
v Added support for the IBM Prerequisite Scanner, which is a stand-alone prerequisite checking tool that analyzes system environments before the installation or upgrade of a Tivoli product or IBM solution. v Added new Cognos data models and reports
v Added the Prerequisite Scanner report to verify the availability of tables and views in the Tivoli Data Warehouse for the predefined reports
Components of the IBM Tivoli Monitoring environment
After you install and set up the Microsoft Hyper-V Server agent, you have an environment that contains the client, server, and monitoring agent implementation for Tivoli Monitoring.
This Tivoli Monitoring environment contains the following components:
Tivoli Enterprise Portal client
The portal has a user interface based on Java™for viewing and monitoring your enterprise.
Tivoli Enterprise Portal Server
The portal server is placed between the client and the Tivoli Enterprise Monitoring Server and enables retrieval, manipulation, and analysis of data from the monitoring agents. The Tivoli Enterprise Portal Server is the central repository for all user data.
Tivoli Enterprise Monitoring Server
The monitoring server acts as a collection and control point for alerts received from the monitoring agents, and collects their performance and availability data. The Tivoli Enterprise Monitoring Server is also a repository for historical data.
Tivoli Enterprise Monitoring Agent, Microsoft Hyper-V Server agent
This monitoring agent collects data and distributes the data to the Tivoli Enterprise Monitoring Server, Tivoli Enterprise Portal Server, Tivoli Enterprise Portal, Tivoli Data Warehouse, and Tivoli Integrated Portal.
IBM Tivoli Netcool/OMNIbus
Tivoli Netcool/OMNIbus is an optional component and the recommended event management component. The Netcool/OMNIbus software is a service level management (SLM) system that delivers real-time, centralized monitoring of complex networks and IT domain events. Event information is tracked in a high-performance, in-memory database and presented to specific users through individually configurable filters and views. The software includes automation functions that you can use to perform intelligent processing on managed events. You can use this software to forward events for Tivoli Monitoring situations to Tivoli Netcool/OMNIbus.
IBM Tivoli Enterprise Console
The Tivoli Enterprise Console is an optional component that acts as a central collection point for events from various sources, including events from other Tivoli software applications, Tivoli partner applications, custom applications, network management platforms, and relational database systems. You can view these events through the Tivoli Enterprise Portal (by using the event viewer), and you can forward events from Tivoli Monitoring situations to the Tivoli Enterprise Console component. If you do not already use Tivoli Enterprise Console and need an event management component, you can choose to use IBM Tivoli Netcool/OMNIbus.
IBM Tivoli Common Reporting
Tivoli Common Reporting is a separately installable feature available to users of Tivoli software that provides a consistent approach to generating and customizing reports. Some individual products provide reports that are designed for use with Tivoli Common Reporting and have a consistent look and feel.
IBM Tivoli Application Dependency Discovery Manager (TADDM)
IBM Tivoli Business Service Manager
The Tivoli Business Service Manager component delivers real-time information to help you respond to alerts effectively based on business requirements. Optionally, you can use this component to meet service-level agreements (SLAs). Use the Tivoli Business Service Manager tools to help build a service model that you can integrate with Tivoli Netcool/OMNIbus alerts or optionally integrate with data from an SQL data source. Optional components provide access to data from other IBM Tivoli applications such as Tivoli Monitoring and TADDM.
Agent Management Services
You can use IBM Tivoli Monitoring Agent Management Services to manage the Microsoft Hyper-V Server agent.
Agent Management Services is available for the following IBM Tivoli Monitoring OS agents: Windows, Linux, and UNIX. The services are designed to keep the Microsoft Hyper-V Server agent available, and to provide information about the status of the product to the Tivoli Enterprise Portal. For more information about Agent Management Services, see Agent Management Services in the IBM Tivoli Monitoring
Administrator's Guide. IBM Tivoli Monitoring V6.2.2, Fix Pack 2 or later provides support for Agent
Management Services. .
User interface options
Installation of the base IBM Tivoli Monitoring software and other integrated applications provides various interfaces that you can use to work with your resources and data.
The following interfaces are available:
Tivoli Enterprise Portal user interface
You can run the Tivoli Enterprise Portal as a desktop application or a browser application. The client interface is a graphical user interface (GUI) based on Java on a Windows or Linux
workstation. The browser application is automatically installed with the Tivoli Enterprise Portal Server. The desktop application is installed by using the Tivoli Monitoring installation media or with a Java Web Start application. To start the Tivoli Enterprise Portal browser client in your Internet browser, enter the URL for a specific Tivoli Enterprise Portal browser client installed on your Web server.
Command-line interface
You can use Tivoli Monitoring commands to manage the Tivoli Monitoring components and their configuration. You can also run commands at the Tivoli Enterprise Console event server or the Tivoli Netcool/OMNIbus ObjectServer to configure event synchronization for enterprise situations.
Manage Tivoli Enterprise Monitoring Services window
You can use the window for the Manage Tivoli Enterprise Monitoring Services utility to configure the agent and start Tivoli services not designated to start automatically.
IBM Tivoli Netcool/OMNIbus event list
You can use the Netcool/OMNIbus event list to monitor and manage events. An event is created when the Netcool/OMNIbus ObjectServer receives an event, alert, message, or data item. Each event is made up of columns (or fields) of information that are displayed in a row in the ObjectServer alerts.status table. The Tivoli Netcool/OMNIbus web GUI is also a web-based application that processes network events from one or more data sources and presents the event data in various graphical formats.
IBM Tivoli Enterprise Console
integrates system, network, database, and application management. If you do not already use Tivoli Enterprise Console and need an event management component, you can choose to use Tivoli Netcool/OMNIbus.
IBM Tivoli Common Reporting
Use the Tivoli Common Reporting web user interface for specifying report parameters and other report properties, generating formatted reports, scheduling reports, and viewing reports. This user interface is based on the Tivoli Integrated Portal.
IBM Tivoli Application Dependency Discovery Manager
The Discovery Management Console is the TADDM client user interface for managing discoveries.
IBM Tivoli Business Service Manager
The Tivoli Business Service Manager console provides a graphical user interface that you can use to logically link services and business requirements within the service model. The service model provides an operator with a second-by-second view of how an enterprise is performing at any moment in time or how the enterprise performed over a time period.
Data sources
The Microsoft Hyper-V Server agent collects data from the following sources:
WMI By using WMI (Windows Management Instrumentation), you can monitor and control managed resources throughout the network. Resources include hard drives, file systems, operating system settings, processes, services, shares, registry settings, networking components, event logs, users, and groups. WMI is built into clients with Windows 2000 or later, and can be installed on any 32-bit Windows client.
Perfmon
Use the Windows Performance Monitor, or Perfmon, to view various system and application performance metrics for collection and use by management applications. You typically view system metrics on a Windows system through the 'perfmon' application.
Scripts
The agent uses application-specific commands and interfaces to gather metrics.
Windows Event Log
The agent collects Windows Event Log entries related to the monitored resource and forwards them to IBM Tivoli Monitoring.
Table 1. Mechanisms used to gather attributes
Attribute group Collection source
Availability Operating system
Performance Object Status Operating system
Hypervisor WMI
Hyper-V Summary WMI
Director IBM Director Environment variable
Hyper-V Dynamic Memory Balancer Perfmon
Hyper-V Dynamic Memory VM Perfmon
Virtual Machine WMI
Hyper-V Virtual Machine Summary Perfmon
Hyper-V Virtual Machine Health Summary Perfmon
Hyper-V Virtual Machine Bus Perfmon
Table 1. Mechanisms used to gather attributes (continued)
Attribute group Collection source
Hyper-V Task Manager Recent Time Perfmon
Hyper-V Hypervisor Root Partition Perfmon
Disk WMI
Hyper-V Virtual IDE Controller Perfmon
Hyper-V Virtual Storage Device Perfmon
Memory WMI
Hyper-V VM Vid Partition Perfmon
Processor WMI
Hyper-V Hypervisor Logical Processor Perfmon
Hyper-V Hypervisor Root Virtual Processor Perfmon Hyper-V Hypervisor Root Virtual Processor More Perfmon
Hyper-V Hypervisor Virtual Processor Perfmon
Hyper-V Hypervisor Virtual Processor More Perfmon
Hyper-V VM IO APIC Perfmon
Virtual Switch WMI
VLAN Endpoint WMI
Hyper-V Legacy Network Adapter Perfmon
Hyper-V Virtual Switch Perfmon
Hyper-V Virtual Switch Port Perfmon
Hyper-V Virtual Network Adapter Perfmon
Hyper-V VM Association with Virtual Network WMI
Migration WMI
Memory in Percentage Script
Event Log Windows Event Log
VM Modification Windows Event Log
Hyper-V Virtual IDE Controller Win2K12 Perfmon
Hyper-V Virtual IDE Controller Filter Hyper-V Virtual IDE Controller and Hyper-V Virtual IDE Controller Win2K12 attribute groups.
Resource Metering PowerShell
VM Mig WO Cluster CDP
VM Storage Migration CDP
Chapter 2. Agent installation and configuration
Agent installation and configuration requires the use of the IBM Tivoli Monitoring Installation and Setup
Guide and agent-specific installation and configuration information.
To install and configure the Microsoft Hyper-V Server agent, use the Installing monitoring agents procedures in the IBM Tivoli Monitoring Installation and Setup Guide along with the agent-specific installation and configuration information.
If you are installing silently by using a response file, see Performing a silent installation of IBM Tivoli
Monitoring in the IBM Tivoli Monitoring Installation and Setup Guide.
With the self-describing agent capability, new or updated IBM Tivoli Monitoring agents using IBM Tivoli Monitoring V6.2.3 or later can become operational after installation without having to perform additional product support installation steps. To take advantage of this capability, see Enabling self-describing agent
capability at the hub monitoring server in the IBM Tivoli Monitoring Installation and Setup Guide. Also, see Self-describing monitoring agents in the IBM Tivoli Monitoring Administrator's Guide.
Requirements
Before installing and configuring the agent, make sure your environment meets the requirements for the IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Hyper-V Server Agent.
For information about requirements, see the Prerequisites topic for the agent in the IBM Tivoli Composite Application Manager for Microsoft Applications Information Center (http://publib.boulder.ibm.com/ infocenter/tivihelp/v24r1/topic/com.ibm.itcamms.doc_6.3/welcome_msapps63.html).
Language pack installation
The steps for installing language packs depend on which operating system and mode of installation you are using.
To install a language pack for the agent support files on the Tivoli Enterprise Monitoring Server, the Tivoli Enterprise Monitoring Agent, and the Tivoli Enterprise Portal Server, make sure that you installed the product in the English language. Then use the steps for the operating system or mode of installation you are using:
v “Installing language packs on Windows systems”
v “Installing language packs on UNIX or Linux systems” on page 8
v “Silent installation of language packs on Windows, UNIX, or Linux systems” on page 8
Installing language packs on Windows systems
You can install the language packs on a Windows system.
Before you begin
First, make sure that you installed the product in the English language.
Procedure
1. On the language pack CD, double-click the lpinstaller.bat file to start the installation program. 2. Select the language of the installer and click OK.
4. Click Add/Update and click Next.
5. Select the folder where the National Language Support package (NLSPackage) files are located. Typically, the NLSPackage files are located in the nlspackage folder where the installer executable file is located.
6. Select the language support for the agent of your choice and click Next. To make multiple selections, press Ctrl and select the language that you want.
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. After installation completes, click Finish to exit the installer.
10. Restart the Tivoli Enterprise Portal, Tivoli Enterprise Portal Server, and Eclipse Help Server if any of these components are installed.
Installing language packs on UNIX or Linux systems
You can install the language packs on a UNIX or Linux system.
Before you begin
First, make sure that you installed the product in the English language.
Procedure
1. Enter the mkdir command to create a temporary directory on the computer, for example, mkdir
dir_name. Make sure that the full path of the directory does not contain any spaces. 2. Mount the language pack CD to the temporary directory that you created.
3. Enter the following command to start the installation program: cd dir_name lpinstaller.sh -c
install_dirwhere install_dir is where you installed IBM Tivoli Monitoring. Typically, the directory name is /opt/IBM/ITM for UNIX and Linux systems.
4. Select the language of the installer and click OK. 5. In the Introduction panel, click Next.
6. Click Add/Update and click Next.
7. Select the folder where the National Language Support package (NLSPackage) files are located. Typically, the NLSPackage files are located in the nlspackage folder where the installer executable file is located.
8. Select the language support for the agent of your choice and click Next. To make multiple selections, press Ctrl and select the language that you want.
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. After installation completes, click Finish to exit the installer.
12. Restart the Tivoli Enterprise Portal, Tivoli Enterprise Portal Server, and Eclipse Help Server if any of these components are installed.
Silent installation of language packs on Windows, UNIX, or Linux
systems
You can use the silent-mode installation method to install the language packs. In silent mode, the installation process obtains the installation settings from a predefined response file. It does not prompt you for any information.
Before you begin
Procedure
1. Copy and paste the ITM_Agent_LP_silent.rsp response file template as shown in “Response file example.”
2. Change the following parameter settings:
NLS_PACKAGE_FOLDER
Folder where the National Language Support package (NLSPackage) files are located. Typically, the NLSPackage files are located in the nlspackage folder, for example: NLS_PACKAGE_FOLDER = //tmp//LP//nlspackage.
PROD_SELECTION_PKG
Name of the language pack to install. Several product components can be included in one language package. You might want to install only some of the available components in a language pack.
BASE_AGENT_FOUND_PKG_LIST
Agent for which you are installing language support. This value is usually the same as
PROD_SELECTION_PKG.
LANG_SELECTION_LIST
Language you want to install.
3. Enter the command to install the language pack with a response file (silent installation): v For Windows systems:
lpinstaller.bat -f path_to_response_file
v For UNIX or Linux systems:
lpinstaller.sh -c candle_home -f path_to_response_file
where candle_home is the IBM Tivoli Monitoring base directory.
Response file example
# IBM Tivoli Monitoring Agent Language Pack Silent Installation Operation #
#This is a sample response file for silent installation mode for the IBM Tivoli #Monitoring Common Language Pack Installer.
#.
#This file uses the IBM Tivoli Monitoring Common Agent Language Pack with the #install package as an example.
#Note:
#This response file is for the INSTALLATION of language packs only.
#This file does not support UNINSTALLATION of language packs in silent mode. #---#To successfully complete a silent installation of the the example of Common Agent #localization pack, complete the following steps:
#
#1.Copy ITM_Agent_LP_silent.rsp to the directory where lpinstaller.bat or #lpinstaller.sh is located (IBM Tivoli Monitoring Agent Language Pack build #location).
#
#2.Modify the response file so that it is customized correctly and completely for #your site.
# Complete all of the following steps in the response file. #
#3.After customizing the response file, invoke the silent installation using the #following command:
#For Windows:
# lpinstaller.bat -f <path_to_response_file> #For UNIX and Linux:
# lpinstaller.sh -c <candle_home> -f <path_to_response_file> #Note:<candle_home> is the IBM Tivoli Monitoring base directory.
#---#Force silent install mode.
#---INSTALLER_UI=silent
#---#Run add and update actions.
#---CHOSEN_INSTALL_SET=ADDUPD_SET
#---#NLS Package Folder, where the NLS Packages exist.
#For Windows:
# Use the backslash-backslash(\\) as a file separator (for example, #C:\\zosgmv\\LCD7-3583-01\\nlspackage).
#For UNIX and Linux:
# Use the slash-slash (//) as a file separator (for example, #//installtivoli//lpsilenttest//nlspackage).
#---#NLS_PACKAGE_FOLDER=C:\\zosgmv\\LCD7-3583-01\\nlspackage
NLS_PACKAGE_FOLDER=//tmp//LP//nlspackage
#---#List the packages to process; both variables are required.
#Each variable requires that full paths are specified. #Separate multiple entries with a semicolon (;). #For Windows:
# Use the backslash-backslash(\\) as a file separator. #For Unix and Linux:
# Use the slash-slash (//) as a file separator.
#---#PROD_SELECTION_PKG=C:\\zosgmv\\LCD7-3583-01\\nlspackage\\KIP_NLS.nlspkg #BASE_AGENT_FOUND_PKG_LIST=C:\\zosgmv\\LCD7-3583-01\\nlspackage\\KIP_NLS.nlspkg PROD_SELECTION_PKG=//tmp//LP//nlspackage//kex_nls.nlspkg;//tmp//LP//nlspackage// koq_nls.nlspkg BASE_AGENT_FOUND_PKG_LIST=//tmp//LP//nlspackage//kex_nls.nlspkg;// tmp//LP//nlspackage//koq_nls.nlspkg #---#List the languages to process.
#Separate multiple entries with semicolons.
#---LANG_SELECTION_LIST=pt_BR;fr;de;it;ja;ko;zh_CN;es;zh_TW
Running as a non-administrator user
You can run the monitoring agent for Hyper-V Server as a non-administrator user; however, some
functionality is unavailable. To create a non-administrator user, create a new user (non-administrator) and set up registry permissions for the new user as follows:
v Full access to the HKEY_LOCAL_MACHINE\SOFTWARE\Candle directory
v Read access to the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib directory
v Full access to the CANDLE_HOME directory
If you define these permissions for a non-administrator user, data is displayed for all the Perfmon-based attribute groups.
v Processor v Virtual Switch v VLAN Endpoint
v VM Association with Virtual Network
Prerequisites checking
The prerequisite checker utility verifies whether all the prerequisites that are required for the agent installation are met. The prerequisite checker creates a log file that contains a report of all the prerequisites checks when the prerequisite checker was run.
For the Microsoft Hyper-V Server agent, the prerequisite checker verifies the following requirements: v Memory
v Disk
v Operating systems
v Microsoft Hyper-V Server versions
Additionally, the prerequisite checker verifies whether the user, who installs the agent, is a member of the Administrators group.
For detailed information about installation prerequisites, see the Prerequisites topic for the agent in the IBM Tivoli Composite Application Manager for Microsoft Applications Information Center
(http://publib.boulder.ibm.com/infocenter/tivihelp/v24r1/topic/com.ibm.itcamms.doc_6.3/ welcome_msapps63.html).
You can run the prerequisite checker in stand-alone mode or remotely. For more information about the prerequisite checker, see "Prerequisite Checking for IBM Tivoli Monitoring Agents" in the IBM Tivoli
Monitoring Installation and Setup Guide.
Agent-specific installation and configuration
In addition to the installation and configuration information in the IBM Tivoli Monitoring Installation and
Setup Guide, use this agent-specific installation and configuration information to install the Microsoft
Hyper-V Server agent.
No special setup is necessary to manage this application.
Configuration values
For both local and remote configuration, you provide the configuration values for the agent to operate.
When you are configuring an agent, a panel is displayed so you can enter each value. When a default value exists, this value is pre-entered into the field. If a field represents a password, two entry fields are displayed. You must enter the same value in each field. The values you type are not displayed to help maintain the security of these values.
The configuration for this agent is organized into the following groups:
IBM Systems Director configuration (IBM_DIRECTOR_CONFIGURATION)
Null Description for section.
The configuration elements defined in this group are always present in the agent's configuration. This group defines information that applies to the entire agent.
IBM Systems Director Server Port Number (KHV_DIRECTOR_PORT)
The type is numeric. This value is optional. Default value: None
IBM Systems Director Server Host Name (KHV_DIRECTOR_SERVER)
Host name or IP address of the IBM Systems Director Server that is managing the environment.
The type is string. This value is optional. Default value: None
Authenticate using Tivoli Enterprise Portal credentials (KHV_TEP_CREDENTIAL)
Indicates whether or not to authenticate to the IBM Systems Director Server using the Tivoli Enterprise Portal userid and password.
The type is one of the following values: "Yes", "No". This value is optional.
Default value: Yes
Remote installation and configuration
You can install the monitoring agent remotely from the Tivoli Enterprise Portal or from the command line.
When installing the agent remotely, you must provide the configuration values for the agent to operate. See “Configuration values” on page 11.
To install from the portal, see the IBM Tivoli Monitoring Installation and Setup Guide.
To remotely install or configure an agent through the Tivoli Enterprise Portal, you must have installed the application support for that agent (Tivoli Enterprise Monitoring Server, Tivoli Enterprise Portal Server, and Tivoli Enterprise Portal). You must also have installed the agent bundle into the Remote Deploy Depot.
For information about displaying the configuration options that are available to use with the
configureSystemor addSystem commands see "tacmd describeSystemType" in the IBM Tivoli Monitoring
Command Reference.
If you are using the command line, the following command is an example of remote installation and configuration for Windows operating systems:
tacmd addSystem -t HV -n Primary:sample.node.name:NT -p IBM_DIRECTOR_CONFIGURATION.KHV_DIRECTOR_PORT=value
Chapter 3. Workspaces reference
A workspace is the working area of the Tivoli Enterprise Portal application window. The Navigator tree contains a list of the workspaces provided by the agent.
About workspaces
Use the Navigator tree to select the workspace you want to see. As part of the application window, the status bar shows the Tivoli Enterprise Portal Server name and port number to which 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 is displayed. The Workspace item contains a list of workspaces for that Navigator item. Each workspace has at least one view. Some views have links to other workspaces. You can also use the Workspace Gallery tool as described in the Tivoli Enterprise Portal
User's Guide to open workspaces.
The workspaces in the Navigator are displayed in a Physical view that shows your enterprise as a physical mapping or a dynamically populated logical view that is agent-specific. You can also create a Logical view. The Physical view is the default view.
To select the dynamically populated logical view, select Hyper-V from the View list in the Navigator. To view the dynamically populated Hyper-V logical view, you must log in to the Tivoli Enterprise Portal as a system administrator.
This monitoring agent provides predefined workspaces. You cannot modify or delete the predefined workspaces, but you can create new workspaces by editing them and saving the changes with a different name.
Workspace views can be any combination of query-based views, event views, and special purpose views.
Additional information about workspaces
For more information about creating, customizing, and working with workspaces, see "Using workspaces" in the Tivoli Enterprise Portal User's Guide.
For a list of the predefined workspaces for this monitoring agent and a description of each workspace, see Predefined workspaces and the information about each individual workspace.
Some attribute groups for this monitoring agent might not be represented in the predefined workspaces or views for this agent. For a full list of the attribute groups, see “Attribute groups for the monitoring agent” on page 25.
Cross-linked workspaces
Table 2. Cross-linked workspaces within the Hyper-V agent Link name Source navigator item Source workspace name Source view name Target
workspace name Filter Availability Microsoft Hyper-V
Server Hyper-V Services and Virtual Machine Details Hyper-V Services Status
Availability Service Name
IDE Controller Microsoft Hyper-V Server Hyper-V Services and Virtual Machine Details Virtual Machines State
IDE Controller Virtual Machine Name
Virtual Disk Microsoft Hyper-V Server Hyper-V Services and Virtual Machine Details Virtual Machines State
Virtual Disk Virtual Machine Name Virtual Processor Load Microsoft Hyper-V Server Hyper-V Services and Virtual Machine Details Virtual Machines State Hyper-V Virtual Processor Load Virtual Machine Name VM Virtual Processor Details Microsoft Hyper-V Server Hyper-V Services and Virtual Machine Details Virtual Machines State VM Virtual Processor Details Virtual Machine Name Virtual Machine Partition Microsoft Hyper-V Server Hyper-V Services and Virtual Machine Details Virtual Machines State
Partition Virtual Machine Name
Virtual Memory Microsoft Hyper-V Server Hyper-V Services and Virtual Machine Details Virtual Machines State
Table 2. Cross-linked workspaces within the Hyper-V agent (continued) Link name Source navigator item Source workspace name Source view name Target
workspace name Filter Logical Processor Load Microsoft Hyper-V Server Local Hyper-V Dashboard Top 3 Logical Processors Having High Processor Usage Hyper-V Logical Processor Load Logical Processor Name Logical Processor Load Microsoft Hyper-V Server Local Hyper-V Dashboard Bottom 3 Logical Processors Having Low Processor Usage Hyper-V Logical Processor Load Logical Processor Name Virtual Processor Load Microsoft Hyper-V Server Local Hyper-V Dashboard Top 3 Virtual Processors Having High Processor Usage Hyper-V Virtual Processor Load Virtual Processor Name Virtual Processor Load Microsoft Hyper-V Server Local Hyper-V Dashboard Bottom 3 Virtual Processors Having Low Processor Usage Hyper-V Virtual Processor Load Virtual Processor Name Virtual Machine Details
Virtual Machine Virtual Machine Summary Virtual Machine Health Summary Virtual Machine Details N.A.
Virtual Network Microsoft Hyper-V Server Hyper-V Services and Virtual Machine Details Virtual Machine State VM Association with Virtual Network Virtual Machine Name IBM Systems Director
Virtual Machine Virtual Machine Virtual Machine Details IBM Systems Director linkIsEnabled, URL IBM Systems Director
Hypervisor Hypervisor Hyper-V
System Load Details
IBM Systems Director
linkIsEnabled, URL
Table 3. Cross-linked workspaces to the Cluster Server agent
Link name Source navigator item Source workspace name Source view name Target workspace name Filter Cluster Migration Summary Microsoft Hyper-V Server
N.A. N.A. Resource Group
Associations
N.A. Cluster
Dashboard
Migration Migration Cluster Virtual machine
Cluster Dashboard
Cluster Name
Table 4. Cross-linked workspaces to the Windows OS agent
Link name Source navigator item Source workspace name Source view name Target workspace name Filter
Windows OS Virtual Machine Virtual Machine Virtual Machine Details
Table 5. Cross-linked workspaces to the Linux OS agent
Source navigator item
Source workspace
name Source view name
Target workspace
name Filter
Linux OS Virtual Machine Virtual Machine Details
Linux OS N.A.
Predefined workspaces
The Microsoft Hyper-V Server agent provides predefined 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
– IBM Systems Director 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
– Virtual Storage Device Details workspace v Event Log Navigator item
– Event Log workspace v Hypervisor Navigator item
– Hypervisor workspace v Memory Navigator item
– Dynamic Memory workspace – Memory workspace
– VM VID Partition workspace v Migration Navigator item
– Migration workspace v Network Navigator item
– Legacy Network Adapter workspace – Network workspace
– Virtual Network Adapter workspace – Virtual Switch Port workspace – VLAN EndPoint workspace
– VM Association with Virtual Network workspace v Processor Navigator item
– 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 – Resource Metering
v VM Modification Navigator item – VM Modification workspace
Workspace descriptions
Each workspace description provides information about the workspace such as the purpose and a list of views in the workspace.
Workspaces are listed under Navigator items.
Microsoft Hyper-V Server Navigator item
The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Microsoft Hyper-V Server workspace
This workspace displays the details of the Microsoft Hyper-V services and the state of the virtual machine.
This workspace contains the following views:
Hyper-V Services Status
Displays the status of the Hyper-V services.
Virtual Machines State
Displays the state of the virtual machines.
Hyper V Details
Displays the version and the statistical information about the hypervisor.
Virtual Machine Summary
Displays the statistical information about the hypervisor management services.
Enterprise Dashboard workspace
This workspace displays the details of the physical resources that are utilized by the all the Hyper-V systems in the enterprise.
This workspace contains the following views:
Situation Event Console
Displays the details of all situations that are triggered.
Enterprise Hyper-V Details
Displays the details of the physical resource that is utilized by the Hyper-V system.
Top 5 Hyper-V Systems Having High Processor Usage
Displays the percentage of the five Hyper-V systems that have maximum processor utilization.
Top 5 Hyper-V System Memory Usage
Displays the percentage of the five Hyper-V systems that have maximum memory utilization.
Top 5 Hyper-V System Network Utilization Percentage
Top 5 Hyper-V System Disk Read Rate
Displays five Hyper-V systems that have maximum disk read rate.
Enterprise Disk Dashboard workspace
This workspace displays the latencies for read and write disk operations for all the Hyper-V systems in the enterprise.
This workspace contains the following views:
Disk Read Write Details
Displays the latency for the read and write disk operations, in milliseconds.
Top 5 Hyper-V System Disk Read Rate
Displays five Hyper-V systems that have maximum disk read rate.
Top 5 Hyper-V System Disk Write Rate
Displays five Hyper-V systems that have maximum disk write rate.
Enterprise Memory Dashboard workspace
This workspace displays the details of the memory utilized by all the Hyper-V systems in the enterprise.
This workspace contains the following views:
Hyper-V System Memory Details
Displays the details of the memory utilized by all the Hyper-V systems in the enterprise.
Top 5 Hyper-V System Memory Usage
Displays the percentage of the five Hyper-V systems that have maximum memory utilization.
Bottom 5 Hyper-V System Memory Usage
Displays the percentage of the five Hyper-V systems that have minimum memory utilization.
Enterprise Network Utilization Dashboard workspace
This workspace displays the details of the network utilized by all the Hyper-V systems in the enterprise.
This workspace contains the following views:
Hyper-V Network Utilization Details
Displays the details of the network utilized by all the Hyper-V systems in the enterprise.
Top 5 Hyper-V System Network Utilization
Displays the percentage of the five Hyper-V systems that have maximum network utilization.
Bottom 5 Hyper-V System Network Utilization
Displays the percentage of the five Hyper-V systems that have minimum network utilization.
Enterprise Processor Dashboard workspace
This workspace displays the details of the processor utilized by all the Hyper-V systems in the enterprise.
This workspace contains the following views:
Top 5 Hyper-V Systems Having High Processor Usage
Displays the percentage of the five Hyper-V systems that have maximum physical processor utilization.
Bottom 5 Hyper-V Systems Having Low Processor Usage
Displays the percentage of the five Hyper-V systems that have minimum physical processor utilization.
Top 5 Logical Processors Having High Processor Usage
Displays the percentage of the five Hyper-V systems that have maximum logical processor utilization.
Top 5 Virtual Processors Having High Processor Usage
Displays the percentage of the five Hyper-V systems whose virtual machines have maximum virtual processor utilization.
IBM Systems Director workspace
This workspace contains the following view:
IBM Systems Director
Displays the IBM Systems Director console if the Director parameters are correctly configured with the agent and IBM Tivoli Monitoring (IBM) version is 6.2.2 or later.
Local Hyper-V Dashboard workspace
This workspace displays the details of the physical resources that are utilized by the Hyper-V system.
This workspace contains the following views:
Hyper-V System Details
Displays the details of the physical resource that is utilized by the Hyper-V system.
Top 3 Logical Processors Having High Processor Usage
Displays the percentage of the three logical processors that have maximum processor utilization.
Bottom 3 Logical Processors Having Low Processor Usage
Displays the percentage of the three logical processors that have minimum processor utilization.
Top 3 Virtual Processors Having High Processor Usage
Displays the percentage of the three virtual processors that have maximum processor utilization.
Bottom 3 Virtual Processors Having Low Processor Usage
Displays the percentage of the three virtual processors that have minimum processor utilization.
Availability Navigator item
The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Availability workspace
The Availability workspace displays the overall health of the application. This workspace contains the following views:
Availability
Displays the state of each component in the application. Each service is displayed using a descriptive name, the short name of the service, and the state of the service (UP, DOWN, or UNKNOWN). The state is UP if the service is running, DOWN if the service exists but is not running. UNKNOWN indicates that the service is not installed, so these elements are filtered from the view. When the state of the component is DOWN (for a process, or service) it is highlighted with a red background.
Processor
Displays the amount of CPU used by each process that is a component of the application. This displays the 2 main components of CPU usage, privileged time which is time spent in the kernel on behalf of the process and user mode time, which is the time spent running the process code.
Threads
Displays the number of threads used by each process that is a component of the application.
Memory
Displays the amount of memory being consumed by each process that is a component of the application. This total (virtual) size of the process and the size of the process in memory (working set) are displayed.
Performance Object Status workspace
This workspace displays the overall health of the application. This workspace contains the following view:
Performance Object Status
the other views contain no data, then this view will isolate the cause of the failure. Object name displays the data source object class name such as script name, WMI class, and so on.
Disk Navigator item
The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Disk workspace
This workspace displays the details of hard drives within a virtual machine. This workspace contains the following views:
Disk Allocated
Displays the total disk space in GB, assigned to the virtual disk for the virtual machine.
Virtual Disk Details
Displays the details of the hard drive within a virtual machine.
IDE Controller workspace
This workspace displays the details about the IDE controller of the virtual machine. This workspace contains the following views:
IDE Controller Details
Displays the details of the disks that are attached to the IDE controller.
Bytes Displays the number of bytes read from and written to the disks that are attached to the IDE controller.
Sectors
Displays the number of sectors read from and written to the disks that are attached to the IDE controller.
Virtual Storage Device Details workspace
This workspace displays the details of the virtual storage device. This workspace contains the following views:
Virtual Storage Device Details
Displays the details of the virtual storage device.
Error Count
Displays the total number of errors that occurred on the virtual storage device.
Bytes Displays the total number of bytes that are read and written per second on the virtual storage device.
Event Log Navigator item
The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Event Log workspace
This workspace displays the details of the critical, error, and warning events that are specific to the Hyper-V system.
This workspace contains the following view:
Event Log
Displays the details of the critical, error, and warning events that are specific to the Hyper-V system.
Hypervisor Navigator item
The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Hypervisor workspace
This workspace displays the Hyper-V system details. This workspace contains the following views:
Hyper-V System Details
Displays the version and the statistical information about the hypervisor.
Hyper-V System Load Details
Memory Navigator item
The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Dynamic Memory workspace
This workspace displays information about Dynamic Memory. This workspace contains the following views:
Dynamic Memory VM
Displays information about the Dynamic Memory of VMs.
Pressure in Virtual Machines
Displays pressure in the VMs.
Dynamic Memory Balancer
Displays data that is gathered from the Hyper-V Dynamic Memory Balancer.
Available Memory
Displays the total amount of memory that is available on the Hyper-V Server, and the memory that is available on the balancer node but not allocated to the VMs.
Memory workspace
This workspace displays the details of the memory currently allocated to a virtual machine. This workspace contains the following views:
Maximum Memory Allocated
Displays the virtual memory in MB, allocated to the virtual machine.
Virtual Memory Details
Displays the details of memory currently allocated to a virtual machine.
VM VID Partition workspace
This workspace displays the total guest address space and additional memory that is required by the VID to manage the virtual machine.
This workspace contains the following view:
VM VID Partition
Displays the total number of guest pages and VID pages that are required to manage the virtual machine and NUMA nodes.
Migration Navigator item
The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Migration workspace
This workspace displays the summary of the migration task that is performed on the virtual machine.
This workspace contains the following views:
VM Migration Tasks
Displays the total number of tasks that are completed and are in progress.
VM Migration Time Taken
Displays the time taken for the recent migration task.
Clustered Virtual Machines
Displays the list of clustered virtual machines and their current owners.
Network Navigator item
The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Legacy Network Adapter workspace
This workspace displays the details of the Ethernet controller of the virtual machine. This workspace contains the following views:
Legacy Network Adapter Details
Displays the details of the Ethernet controller of the virtual machine.
Frames
Displays the total number of frames sent and received per second on the network adapter.
Network workspace
This workspace displays the attributes that show the details of the virtual switch and the data transferred on that switch.
This workspace contains the following views:
Virtual Switch Details
Displays the details of the virtual switch.
Network Utilization Details
Displays the statistics for the virtual switch.
Packets
Displays the details of the packets received and sent on the virtual switch.
Bytes Displays the details of the bytes received and sent on the virtual switch.
Virtual Network Adapter workspace
This workspace displays the statistical details of the virtual network adapter. This workspace contains the following views:
Virtual Network Adapter
Displays the statistical details of the virtual network adapter.
Bytes Displays the total number of bytes that traversed the network adapter per second.
Packets
Displays the total number of packets that traversed the network adapter per second.
Virtual Switch Port workspace
This workspace displays the statistical details of the virtual switch port. This workspace contains the following views:
Virtual Switch Port
Displays the statistical details of the virtual switch port.
Bytes Displays the total number of bytes that traversed the virtual switch port per second.
Packets
Displays the total number of packets that traversed the virtual switch port per second.
VLAN EndPoint workspace
This workspace displays the details of the VLAN endpoint of a switch port. This workspace contains the following view:
VLAN EndPoint Details
Displays the details of VLAN endpoint of a switch port.
VM Association with Virtual Network workspace
This workspace displays the virtual machine association with virtual network. This workspace contains the following view:
VM Association with Virtual Network
Displays the virtual machine association with virtual network.
Processor Navigator item
The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Hyper V Logical Processor Load workspace
This workspace displays the details of the logical processor of the hypervisor. This workspace contains the following views:
Logical Processor Details
Displays the details of the logical processor of the hypervisor.
Total Interrupts
Processor Run Time
Displays the percentage of time for which the guest code and hypervisor code run on a virtual processor.
Processor workspace
This workspace displays the top five virtual machines that show the highest utilization of the virtual and physical processors.
This workspace contains the following views:
Top 5 VMs Having High Virtual Processor Load
Displays the top five virtual machines with a high virtual processor load on the virtual processor.
Top 5 VMs Utilizing High Physical Processor
Displays the top five virtual machines that show the highest utilization of the physical processor.
Root Virtual Processor Load workspace
This workspace displays the details of the root virtual processor of the hypervisor. This workspace contains the following views:
Root Virtual Processor Details
Displays the details of the root virtual processor of the hypervisor.
Virtual Interrupts
Displays the rate of all virtual interrupts that are delivered to the virtual processor.
Processor Run Time
Displays the percentage of time for which the guest virtual processor runs in the non-hypervisor and hypervisor code on a logical processor.
VM Virtual Processor Details workspace
This workspace displays the details of the virtual processor that is assigned to each virtual machine.
This workspace contains the following views:
Virtual Processor Details
Displays the current percentage of the total processing power that is consumed by the virtual machine.
Assertions
Displays the information about the number of interrupt assertions that the I/O APIC device sent to the virtual machine.
VM Virtual Processor Load workspace
This workspace displays the load details of the virtual processor that is assigned to each virtual machine.
This workspace contains the following views:
Virtual Processor Load
Displays the virtual processor load that is assigned to each virtual machine.
Virtual Interrupts
Displays the rate of all virtual interrupts that are delivered to the virtual processor.
Processor Run Time
Displays the percentage of time for which the guest virtual processor runs in the non-hypervisor and hypervisor code on a logical processor.
Virtual Machine Navigator item
The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
Partition workspace
This workspace displays the details of the root partition and the hypervisor partition. This workspace contains the following views:
Root Partition
Hypervisor Partition
Displays the details of the hypervisor partition.
Resource Metering workspace
This workspace provides information about the data that is related to the Resource Metering of all the virtual machines that are hosted on the Hyper-V server.
This workspace contains the following view:
Resource Metering
Displays detailed information about the resources that are used by each virtual machine.
Task Manager Details workspace
This workspace displays the statistics for the Virtual Machine Management service and the Task Manager.
This workspace contains the following views:
Virtual Machine Resources Task
Displays the details of resource tasks of the virtual machine.
Disk Task
Displays the details of the disk tasks.
Service Settings Tasks
Displays the details of the service settings tasks.
Virtual Machine Management Task
Displays the details of the virtual machine management tasks.
Virtual Machine Startup Task
Displays the details of the virtual machine startup tasks.
Virtual Machine Snapshot Tasks
Displays the details of the virtual machine snapshot tasks.
Virtual Machine workspace
This workspace displays the details of all virtual machines. This workspace contains the following view:
Virtual Machine Details
Displays the attributes that show the virtual machine details, status, and health.
Virtual Machine Summary workspace
This workspace displays the statistical details of the virtual machine management service. This workspace contains the following views:
Virtual Machine Health Summary
Displays the health details of the Virtual Machine Management Service.
Virtual Machine Bus
Displays the statistics of the virtual machine bus.
Virtual Machine Summary
Displays the statistical details of the virtual machine management service.
VM Modification Navigator item
The workspace descriptions are organized by the Navigator item to which the workspaces are relevant.
VM Modification workspace
This workspace displays the information about the modification tasks that are performed on the virtual machine.
This workspace contains the following view:
VM Modification
Chapter 4. Attributes reference
Attributes are the application properties that are being measured and reported by the IBM Tivoli Composite Application Manager for Microsoft Applications: Microsoft Hyper-V Server Agent.
About attributes
Attributes are organized into attribute groups. Attributes in an attribute group relate to a single object such as an application, or to a single kind of data such as status information.
Attributes in a group can be used in queries, query-based views, situations, policy workflows, take action definitions, and launch application definitions. Chart or table views and situations are two examples of how attributes in a group can be used:
v Chart or table views
Attributes are displayed in chart and table views. The chart and table views use queries to specify which attribute values to request from a monitoring agent. You use the Properties editor to apply filters and set styles to define the content and appearance of a view based on an existing query.
v Situations
You use attributes to create situations that monitor the state of your operating system, database, or application. A situation describes a condition you want to test. When you start a situation, the values you assign to the situation attributes are compared with the values collected by the Microsoft Hyper-V Server agent and registers an event if the condition is met. You are alerted to events by indicator icons that are displayed in the Navigator.
Additional information about attributes
For more information about using attributes and attribute groups, see the Tivoli Enterprise Portal User's
Guide.
For a list of the attribute groups, a list of the attributes in each attribute group, and descriptions of the attributes for this monitoring agent, see “Attribute groups for the monitoring agent” and “Attributes in each attribute group” on page 28.
Attribute groups for the monitoring agent
The Microsoft Hyper-V Server agent contains the following attribute groups. The table name depends on the maximum table name limits of the target database being used for the Tivoli Data Warehouse. If the maximum name is 30 characters, any warehouse table name longer than 30 characters is shortened to 30 characters.
v Attribute group name: Availability – Table name: KHVAVAIL
– Warehouse table name: KHV_AVAILABILITY or KHVAVAIL v Attribute group name: Director
– Table name: KHVDIRECTO
– Warehouse table name: KHV_DIRECTOR or KHVDIRECTO v Attribute group name: Disk
– Table name: KHVGETDIS0
