Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 5. Configuring virt-who for Microsoft Hyper-V

You create a virt-who configuration for Microsoft Hyper-V by using the Satellite web UI or the CLI on Satellite Server.

Then, you deploy the generated script or Hammer command on the Satellite Server, Capsule Server, or on a dedicated Red Hat Enterprise Linux server.

5.1. Creating a virt-who configuration
Copy link

You can create a virt-who configuration for Microsoft Hyper-V by using the Satellite web UI.

To create a virt-who configuration by using the CLI, see CLI procedure.

The virt-who configuration creates a virt_who_reporter_1 user with the Virt-who Reporter role, which provides minimal permissions for virt-who reporting to Satellite Server. This user cannot be manually configured or used to log in to Satellite Server.

Local configuration values are stored in the /etc/virt-who.d/conf_name.conf file. These values apply only to the hypervisor.

Global configuration values are stored in the /etc/sysconfig/virt-who file These values, which include Interval, Enable debugging output, HTTP Proxy, and Ignore Proxy, apply to all virt-who configurations on the same server. Redeploying a virt-who configuration on the same server overwrites these values.

Prerequisites

Procedure

  1. In the Satellite web UI, navigate to Infrastructure > Virt-who Configurations.
  2. Click Create Config.

  3. Complete the following fields:

    • Name: Configuration name.
    • Hypervisor Type: Select Microsoft Hyper-V (hyperv).
    • Interval: Virtual machine information reporting interval.
    • Satellite Server FQDN.
    • Hypervisor ID: Select Hostname or UUID.

  4. Optional: Filtering. Select one of the following options for querying hypervisors:

    • Unlimited (default): All hypervisors are queried.
    • Whitelist: Specific hypervisors are included.

    • Blacklist: Specific hypervisors are excluded.

      • Filter hosts: Comma-separated list of included hypervisors.

      • Exclude hosts: Comma-separated list of excluded hypervisors.

        Specify the host name or UUID according to the hypervisor ID you selected.

        Host names

        • You can use wildcards, regular expressions, and special characters in the host name.
        • If you use regular expressions, you must escape the backslashes.
        • If you use special characters, you must enclose the host name in quotation marks.

  5. You can configure the following logging and proxy options:

    • Enable debugging output: Enables debug logging for virt-who.

    • HTTP Proxy. Example: http://proxy.example.com:3128.

      To use no proxy, leave this field blank; this has the same result as entering * in the Ignore Proxy field.

    • Ignore Proxy: Comma-separated list of host names, IP addresses, or domains to bypass existing proxy settings.
  6. Click Submit.

CLI procedure

  • On Satellite Server, enter the hammer virt-who-config create command: 

    $ hammer virt-who-config create \
--name My_virt-who_Configuration \
--organizations "My_Organization" \
--interval 720 \
    1 
    
--filtering-mode none \
    2 
    
--hypervisor-id hostname \
    3 
    
--hypervisor-type hyperv \
--hypervisor-server hypervisor.example.com \
    4 
    
--hypervisor-username virt_who_user \
    5 
    
--hypervisor-password <password>
--proxy 'http://proxy.example.com:3128' \
    6 
    
--satellite-url satellite.example.com
1
Optional: Specify the virtual machine information reporting interval, in minutes.
2
Specify none for no filtering of hypervisors for virt-who queries. Specify whitelist or blacklist to include or exclude hypervisors for virt-who queries.
3
Specify hostname, uuid, or hwuuid for the hypervisor ID format.
  • You can use uuid to avoid duplication if you rename a hypervisor.

  • You can use hwuuid for configurations that apply to a virtualization manager instead of an individual hypervisor.

    Note

    You cannot change hwuuid to another option after virt-who starts running because this might cause duplicate entries in Subscription Manager.

4
Specify the FQDN or IP address of the hypervisor.
5
Specify the name of the virt-who user you created on the hypervisor.
6
Optional.

Microsoft Hyper-V virt-who configuration example

type=hyperv
hypervisor_id=hostname
owner=Default_Organization
env=Library
server=hypervisor.example.com
username=virt_who_user
encrypted_password=$cr_password
rhsm_hostname=satellite.example.com
rhsm_username=virt_who_reporter_1
rhsm_encrypted_password=$user_password
rhsm_prefix=/rhsm

You can deploy a virt-who configuration for Microsoft Hyper-V on Satellite Server.

Global configuration values apply to all virt-who configurations on this server and are overwritten if you deploy a new virt-who configuration.

Procedure

  1. In the Satellite web UI, navigate to Infrastructure > Virt-who Configurations.
  2. Click a virt-who configuration.
  3. Click the Deploy tab.
  4. Under Hammer command, click Copy to clipboard.
  5. Log in to Satellite Server, paste the Hammer command into your terminal, and then run the command.

You can deploy a virt-who configuration for Microsoft Hyper-V on Capsule Server.

Global configuration values apply to all virt-who configurations on this server and are overwritten if you deploy a new virt-who configuration.

Procedure

  1. In the Satellite web UI, navigate to Infrastructure > Virt-who Configurations.
  2. Click a virt-who configuration.
  3. Click the Deploy tab.
  4. Under Configuration script, click Download the script.

  5. Copy the script from Satellite Server to Capsule Server: 

    $ scp deploy_virt_who_config_1.sh root@capsule.example.com:

  6. Log in to Capsule Server and make the script executable: 

    $ chmod +x deploy_virt_who_config_1.sh

  7. Run the script: 

    $ sh deploy_virt_who_config_1.sh

  8. After the deployment is complete, delete the script: 

    $ rm deploy_virt_who_config_1

You can deploy a virt-who configuration for Microsoft Hyper-V on a dedicated Red Hat Enterprise Linux server. The server can be physical or virtual.

Global configuration values apply to all virt-who configurations on this server and are overwritten if you deploy a new virt-who configuration.

Prerequisites

Procedure

  1. Log in to the Red Hat Enterprise Linux server.

  2. Add a TCP port for communication between virt-who and Satellite Server to the runtime configuration: 

    $ firewall-cmd --add-port="5985/tcp"

  3. Add a TCP port for communication between virt-who and Satellite Server to the permanent configuration: 

    $ firewall-cmd --add-port="5985/tcp" --permanent
  4. In the Satellite web UI, navigate to Infrastructure > Virt-who Configurations.
  5. Click a virt-who configuration.
  6. Click the Deploy tab.
  7. Under Configuration script, click Download the script.

  8. Copy the script from Satellite Server to the Red Hat Enterprise Linux server: 

    $ scp deploy_virt_who_config_1.sh root@server.example.com:

  9. Log in to the Red Hat Enterprise Linux server and make the script executable: 

    $ chmod +x deploy_virt_who_config_1.sh

  10. Run the script: 

    $ sh deploy_virt_who_config_1.sh

  11. After the deployment is complete, delete the script: 

    $ rm deploy_virt_who_config_1
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red HatBack to top