Skip to main content

Reads from Hyper-V KV on a Linux guest

Project description

hyperkv

Get Hyper-V Key Value Pairs on Linux Guest

Simple parser of the files made by hv_kvp_daemon on a Linux guest. This allows a guest to determine its name, the host's name, etc. Learn more about Hyper-V Data Exchange here.

Install

pip install hyperkv

Usage

hyperkv

will write the contents as a JSON to standard out like this:

{
  "HostName": "thehost.example.com",
  "HostingSystemEditionId": "8",
  "HostingSystemNestedLevel": "0",
  "HostingSystemOsMajor": "10",
  "HostingSystemOsMinor": "0",
  "HostingSystemProcessorArchitecture": "9",
  "HostingSystemProcessorIdleStateMax": "0",
  "HostingSystemProcessorThrottleMax": "100",
  "HostingSystemProcessorThrottleMin": "5",
  "HostingSystemSpMajor": "0",
  "HostingSystemSpMinor": "0",
  "PhysicalHostName": "THEHOST",
  "PhysicalHostNameFullyQualified": "thehost.example.com",
  "VirtualMachineDynamicMemoryBalancingEnabled": "0",
  "VirtualMachineId": "461B2364-3901-4349-B3C2-FA4821CBEEFE",
  "VirtualMachineName": "my-guest-vm"
}

By default, this script reads from /var/lib/hyperv/.kvp_pool_3, but you can specify a different path with -f

hyperkv -f /var/lib/hyperv/.kvp_pool_2

Requirements

hv_kvp_daemon must be installed and working. If it is working, you will find files in /var/lib/hyperv.

Ubuntu

apt-get install linux-azure linux-azure-tools
grub-update

At boot time, you need to pick advanced startup and make sure it boots with the newly installed Azure kernel. To make that more permanent, you can open /etc/default/grub, add the line GRUB_SAVEDEFAULT=true, and change GRUB_DEFAULT=0 to GRUB_DEFAULT=saved. The next time you boot, choose the Azure kernel and that will become the default until you pick a different one at the GRUB menu.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hyperkv-0.1.1.tar.gz (3.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page