ViPR SRM 3.6 – SolutionPack for Microsoft Hyper-V Summary Sheet

Table of Contents

Overview

Learn how to install and configure SolutionPack for Microsoft Hyper-V. The SolutionPack for Microsoft Hyper-V generates real-time and historical reports so you understand Hyper-V performance through global and detailed status of Hyper-V hosts and underlying virtual machines.

SolutionPack for Microsoft Hyper-V

SolutionPack for Microsoft Hyper-V

Back to Top

Technical specifications

Main reports

Inventory
Displays the inventory of devices, parts and metrics from Hypervisors and Virtual Machines
Virtual Disk Use Analysis
Tool to analyze the utilization profile of Virtual Hard Disk images
All Hosts | All Virtual Machines
Displays all available performance graphs for Hypervisors and Virtual Machines
Global Status
Shows the global status of all hosts and running virtual machines in the environment, detailed by component type
SLA Detailled View
Shows the current and forecasted SLA values for Hypervisors and Virtual Machines
Virtual Machines Running On Snapshot Disks
Shows all virtual machines running on snapshot disks. They impact disk performance and impact storage performance when it is time to commit changes on the original virtual disk.

Supported collection interfaces

For information about supported collection interfaces, refer to the ViPR SRM Support Matrix.

Back to Top

Where to find the latest SolutionPack software

Install the latest core software update for your product suite. SolutionPacks distributed with core software have a 30-day free evaluation period. If you plan to use the software longer than 30 days, you must install a SolutionPack license before the trial period ends.

This 30-day free evaluation only applies to new installations and is not available for upgraded installations. If you upgrade the core software and want to try a new SolutionPack, you must request a license for that SolutionPack.

Back to Top

Configuring credentials for SolutionPack for Microsoft Hyper-V

Back to Top

Requirements for data collection

In order to collect data from Microsoft Hyper-V hosts, the environment needs to meet the following requirements:

Back to Top

Installing the SolutionPack

Before you begin

Procedure

  1. Click Administration.
  2. Click Centralized Management.
  3. Click SolutionPacks.
  4. Click SolutionPack Center.
  5. Select the SolutionPack in the Browse and Install SolutionPacks window.
  6. Click Install.
  7. Type the instance name.
  8. Assign a server for each component.
    In a typical four server deployment, the recommended servers are selected automatically.
  9. Click Next.
    The window displays data collection details.
  10. From the Data collection drop-down menu, select existing settings that have been specified for other components, or select Add a new data collection.
    If you select Add a new data collection, type information about the data collection. In Hostname or IP address to send data to, use localhost on port 2020, which is the Collector host where the Load Balancer Connector is installed.
  11. Click Next.
    The window displays reports settings.
  12. In Administration Web-Service Instance, select an existing instance or create a custom instance.
  13. Click Install.
  14. Click Ok when the installation is complete.
  15. Click Discovery Center > Devices Management.
  16. Click Microsoft Hyper-V.
  17. Click Add new device.
  18. Select the server and collector instance where you want to store the configuration details for this device, and then enter the hostname or IP address of the host, supply the login credentials, and specify the appropriate configuration settings.
    Clicking the Test button results in a warning message that can be ignored.
  19. Click OK.
  20. Click Save.
Back to Top

Using a test script to query WMI objects

The Test feature located in the Discovery Center under the Centralized Management UI is not supported for the SolutionPack for Microsoft Hyper-V. Instead, use the test method presented in this topic.

The SolutionPack for Microsoft Hyper-V provides a script that can be used to check if is possible to query all required WMI objects using the provided user. The script is in the folder <APG_FOLDER>/Collecting/XML-Collector/<SolutionPack_instance_name>/conf/. You must execute the script from the Collect SolutionPack Block machine. Use the following syntax to run the script: 

TestWMI.ps1 -Computer <ip-or-hostname> 
          -Username <domain-or-machine\username>
          -Password <password> [-NoPing]
-Computer
Remote Hyper-V host IP address or hostname
-Username
Username used to perform remote WMI queries, in the format DOMAIN\username for domain users or MACHINE\username for local users
-Password
Password of the user specified with the -Username parameter
-NoPing
(optional) If the remote Hyper-V host is blocking ping requests, you must use this parameter to skip connectivity tests

Back to Top

Confirming report creation

After you install a SolutionPack, you can view its reports.

To view the reports:

Procedure

  1. Go to User Interface > Report Library.
  2. Click the SolutionPack to view its reports.

Results

It may take up to an hour to display all relevant information in these reports.

Back to Top

Troubleshooting

Report display problems

Back to Top

What to do if data does not appear in any reports

Procedure

  1. After the completion of at least three collection cycles, verify if data is populating into the reports. If there is still no data in the reports, continue to the next step.
  2. Run the scheduled task to import data into reports. If there is still no data in the reports, continue to the next step.
  3. To view the log files for errors, go to Centralized Management and click Collecting > Collector-Manager::<instance name> > Log Files.
Back to Top

Running a scheduled task to import data into reports

After you push a new configuration into a collector, a scheduled task runs and populates the reports with new data. You can manually run the scheduled task to import the data more quickly.

Before you begin

Allow at least three polling cycles to pass before manually running the scheduled task.

Procedure

  1. Click Administration.
  2. Click Centralized Management.
  3. Expand Scheduled Tasks.
  4. Click Database.
  5. Select the import-properties-Default task.
  6. Click Run Now.
  7. Confirm success in running the task in the Last Result and Last Result Time columns.
Back to Top

What to do if data does not appear in some reports

Procedure

  1. Run the scheduled task to import data into reports. If there is still no data in the reports, continue to step 2.
  2. Search for the metric in the database.
  3. To view the log files for errors, go to Centralized Management and click Collecting > Collector-Manager::<instance name> > Log Files.
Back to Top

Searching for metrics in the database

You can verify that a metric is being collected and used for reporting when you search and find the metric in the database.

Procedure

  1. Go to the Administration page.
  2. Under Modules, click Management of Database Modules.
  3. On the Metric Selection page, create the filter, type the number of results, and select the properties to display for the metric.
    For example, to list up to 100 results of the SignalWait Time metric with the properties of device and IP, type name=='SignalWaitTime' in the Filter field, 100 in the Maximum results field, and select device and IP for the Properties to show.
  4. Click Query.
    A list of the metric results appears. If nothing displays, the metric is not being collected.
Back to Top

Viewing collector errors in the Collector-Manager log files

Review the Collector-Manager log files to troubleshoot problems with data collection.

Procedure

  1. Click Administration.
  2. Click Centralized Management.
  3. Expand Collecting.
  4. Click the Collector-Manager for your collector instance.
    Collector-Manager::<Collector-Manager instance> - <physical_host_ID>
  5. Expand Log Files and click the View File icon to review the configuration error messages.
Back to Top