Hyper-V discovery

Microsoft Hyper-V is a virtualization application that is included with the Windows Server 2008 operating system.

About Hyper-V

A physical machine running Hyper-V is divided into partitions (virtual machines), including a parent partition running Windows Server 2008 and child partitions running supported guests. The parent partition manages the virtual machines with the Hyper-V Manager application. On Windows Server 2008 this is done through the Microsoft Management Console (MMC) service. On Windows 7, use the Remote Server Admin tools.

Hyper-V supports the following functionality:
  • Failover clustering: Failover is managed with Failover Cluster Manager.
  • Live migration: Virtual machines can be moved between failover cluster nodes without bringing down the virtual machine.

Required roles

Users with the itil and asset roles can access Hyper-V configuration item (CI) records. To run discovery on Hyper-V servers, users must have the discovery_admin role.

Supported versions

Discovery is supported for these Hyper-V Server versions:
  • 2008
  • 2012
  • 2012 R2 (Helsinki release only)

Support for discovery of Hyper V instances running on Windows 2016 is not supported.

Credentials

Configure Windows credentials with Domain administrator rights. You should also Enable PowerShell for the MID Server used to discover Hyper-V servers and instances.

Hyper-V architecture

Table Purpose

Hyper-V Server [cmdb_ci_hyper_v_server]

Contains data about the physical machine running the Hyper-V server. This table has a reference relationship with the existing Windows Server [cmdb_ci_win_server] table.

Hyper-V Virtual Machine Instance [cmdb_ci_hyper_v_instance]

Contains data about Hyper-V instances.

Hyper-V Virtual Network [cmdb_ci_hyper_v_network]

Contains data about Hyper-V networks.

Hyper-V Cluster [cmdb_ci_hyper_v_cluster]

Contains data about Hyper-V clusters. This table has a reference relationship with the existing Windows Cluster [cmdb_ci_win_cluster] table.

Hyper-V Resource Pool [cmdb_ci_hyper_v_resource_pool]

Contains data about Hyper-V resource pools.

Hyper-V Resource Pool Component [cmdb_ci_hyper_v_rpool_comp]

Contains groups of Hyper-V resource pools.

Hyper-V Object [cmdb_ci_hyper_v_object]

Base class for all Hyper-V objects.

The ServiceNow ITSA Suite modifies these tables for use with multiple virtualization products:

Table Purpose

Virtualization Server [cmdb_ci_virtualization_server]

Contains data on all discovered virtualization servers.

Virtual Machine Instance [cmdb_ci_vm_instance]

Contains data on all discovered virtual machine instances.

Virtual Machine Object [cmdb_ci_vm_object]

Contains data about various objects associated with a Hyper-V server, such as partitions, networks, resource pools, and clusters.

Figure 1. Hyper-V Schema Diagram

Hyper-V data collected by Discovery

When Discovery detects the Hyper-V process running on a host machine, it launches exploration probes that return the typical Windows server data and the following data on the Hyper-V instances.
Label Field Name Data Description Stored in Table
State state
  • On
  • Off
  • Suspended
  • Changing
  • Stuck
cmdb_ci_vm_instance
CPUs cpus Count cmdb_ci_vm_instance
Memory memory Quantity in MB cmdb_ci_vm_instance
Network adapters nics Count cmdb_ci_vm_instance
Disks disks Count * cmdb_ci_vm_instance
Disks size disks_size Capacity in GB * cmdb_ci_vm_instance
Virtual Base Board Serial Number baseboard_serial Virtual serial number cmdb_ci_hyper_v_instance
BIOS Serial Number bios_serial Virtual serial number cmdb_ci_hyper_v_instance
Chassis Serial Number chassis_serial Virtual serial number cmdb_ci_hyper_v_instance
BIOS GUID bios_guid Globally unique identifier (GUID) cmdb_ci_hyper_v_instance

* Discovery can only return this information if the virtual machine is running.

Label Field Stored in table
Name name cmdb_ci_hyper_v_server
Chassis type chassis_type cmdb_ci_hyper_v_server
Short description short_description cmdb_ci_hyper_v_server
OS Address Width (bits) os_address_width cmdb_ci_hyper_v_server
Operating System os cmdb_ci_hyper_v_server
Host name hostname cmdb_ci_hyper_v_server
IP Address ip_address cmdb_ci_hyper_v_server
OS Version os_version cmdb_ci_hyper_v_server
OS Service Pack os_service_pack cmdb_ci_hyper_v_server
Is virtual virtual cmdb_ci_hyper_v_server
Label Field Name Data Description Stored in Table
Name name Name of the virtual network cmdb_ci
ID object_id Globally unique identifier (GUID) cmdb_ci_vm_object
Label Field Name Data Description Stored in Table
ID object_id Globally unique identifier (GUID) cmdb_ci_vm_object
Capacity capacity Maximum amount of the appropriate allocation unit cmdb_ci_hyper_v_resource_pool
Allocation units allocation_units Units of measurement used (for example, MB or GB) cmdb_ci_hyper_v_resource_pool
Resource type resource_type Type of resource discovered (for example, memory, or hard drive space) cmdb_ci_hyper_v_resource_pool
Label Field Name Data Description Stored in Table Reference Table
Windows Cluster win_cluster Reference field displaying the Windows Cluster on which the Hyper-V cluster resides. cmdb_ci_hyper_v_cluster cmdb_ci_win_cluster