virt-who(8) - Linux man page

Name

Synopsis

Options

-h, --help

show this help message and exit

-d, --debug

Enable debugging output

-b, --background

Run in the background and monitor virtual guests

-o, --one-shot

Send the list of guest IDs and exit immediately

-i INTERVAL, --interval=INTERVAL

Acquire and send list of virtual guest each N seconds

--libvirt

Use libvirt to list virtual guests [default]

--vdsm

Use vdsm to list virtual guests

--esx

Register ESX machines using vCenter

--rhevm

Register guests using RHEV-M

--hyperv

Register guests using Hyper-V

vCenter/ESX options

Use this options with --esx

--esx-owner=OWNER

Organization who has purchased subscriptions of the products

--esx-env=ENV

Environment where the vCenter server belongs to

--esx-server=SERVER

URL of the vCenter server to connect to

--esx-username=USERNAME

Username for connecting to vCenter

--esx-password=PASSWORD

Password for connecting to vCenter

RHEV-M options

Use this options with --rhevm

--rhevm-owner=OWNER

Organization who has purchased subscriptions of the products

--rhevm-env=ENV

Environment where the RHEV-M belongs to

--rhevm-server=SERVER

URL of the RHEV-M server to connect to

--rhevm-username=USERNAME

Username for connecting to RHEV-M

--rhevm-password=PASSWORD

Password for connecting to RHEV-M

Hyper-V options

Use this options with --hyperv

--hyperv-owner=OWNER

Organization who has purchased subscriptions of the products

--hyperv-env=ENV

Environment where the Hyper-V belongs to

--hyperv-server=SERVER

URL of the Hyper-V server to connect to

--hyperv-username=USERNAME

Username for connecting to Hyper-V

--hyperv-password=PASSWORD

Password for connecting to Hyper-V

Environment

Usage

Mode

1. one-shot mode

# virt-who -o

In this mode virt-who just sends list of guest UUIDs to the server and exits.

2. interval mode

# virt-who

This is default mode. virt-who will check and send list of guest UUIDs once per hour. This interval can be changed using "-i INTERVAL" option where INTERVAL is number of seconds how often it should check and send the list.

3. background mode

# virt-who -b

This mode is similar to interval mode but it monitors events from libvirt and update list of guest UUIDs as soon as possible. It also does the interval check (interval can be altered by "-i INTERVAL" option).

NOTE: virt-who don't print anything to terminal in this mode

NOTE: monitoring for events requires libvirt backend, but this mode can be used with all backends.

Backend

virt-who can use couple of virtualization backends.

1. libvirt

# virt-who

# virt-who --libvirt

Use libvirt as virtualization backend. This is default.

NOTE: virt-who can monitor for events only in this mode.

2. vdsm

# virt-who --vdsm

Use vdsm as virtualization backend.

3. ESX

# virt-who --esx --esx-owner=ESX_OWNER --esx-env=ESX_ENV --esx-server=ESX_SERVER --esx-username=ESX_USERNAME

-

-

esx-password=ESX_PASSWORD

Use ESX (vCenter) as virtualization backend and specify option required to connect to ESX server.

4. RHEV-M

# virt-who --rhevm --rhevm-owner=RHEVM_OWNER --rhevm-env=RHEVM_ENV --rhevm-server=RHEVM_SERVER --rhevm-username=RHEVM_USERNAME

-

-

rhevm-password=RHEVM_PASSWORD

Use RHEV-M as virtualization backend and specify option required to connect to RHEV-M server.

5. Hyper-V

# virt-who --hyperv --hyperv-owner=HYPERV_OWNER --hyperv-env=HYPERV_ENV --hyperv-server=HYPERV_SERVER

-

-

hyperv-username=HYPERV_USERNAME --hyperv-password=HYPERV_PASSWORD

Use Hyper-V as virtualization backend and specify option required to connect to Hyper-V server.

Logging

virt-who can be started with option "-d" in all modes and with all backends. This option will enable verbose output with more information.

Author