Chapter 5. Deploying a virt-who Configuration

After you create a virt-who configuration, Satellite provides a script to automate the deployment process. The script installs virt-who and creates the individual and global virt-who configuration files.

For Red Hat products, you must deploy each configuration file on the hypervisor specified in the file. For other products, you must deploy the configuration files on Satellite Server, Capsule Server, or a separate Red Hat Enterprise Linux server that is dedicated to running virt-who.

5.1. Deploying a virt-who Configuration on a Hypervisor

Use this procedure to deploy a virt-who configuration on the Red Hat hypervisor that you specified in the file. Global values apply only to this hypervisor.

You can also use this procedure to deploy a vCenter or Hyper-V virt-who configuration on Capsule Server. Global configuration values apply to all virt-who configurations on the same Capsule Server, and are overwritten each time a new virt-who configuration is deployed.

Prerequisites

  • Register the hypervisor to Red Hat Satellite.
  • If you are using Red Hat Virtualization Host (RHVH), update it to the latest version so that the minimum virt-who version is available. Virt-who is available by default on RHVH, but cannot be updated individually from the rhel-7-server-rhvh-4-rpms repository.
  • Create a read-only virt-who user on the hypervisor.
  • Create a virt-who configuration for your virtualization platform.

Procedure

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

  5. Copy the script to the hypervisor: 

    # scp deploy_virt_who_config_1.sh root@hypervisor.example.com:

  6. Make the deployment script executable and run it: 

    # chmod +x deploy_virt_who_config_1.sh
# sh deploy_virt_who_config_1.sh

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

    # rm deploy_virt_who_config_1

5.2. Deploying a virt-who Configuration on Satellite Server

Use this procedure to deploy a vCenter or Hyper-V virt-who configuration on Satellite Server.

Global configuration values apply to all virt-who configurations on Satellite Server, and are overwritten each time a new virt-who configuration is deployed.

Prerequisites

  • Create a read-only virt-who user on the hypervisor or virtualization manager.
  • If you are deploying a Hyper-V virt-who configuration, enable remote management on the Hyper-V hypervisor.
  • Create a virt-who configuration for your virtualization platform.

Procedure

  1. In the Satellite web UI, navigate to Infrastructure > Virt-who configurations.
  2. Click the name of the virt-who configuration.
  3. Under Hammer command, click Copy to clipboard.
  4. On Satellite Server, paste the Hammer command into your terminal.

5.3. Deploying a virt-who Configuration on a Separate Red Hat Enterprise Linux Server

Use this procedure to deploy a vCenter or Hyper-V virt-who configuration on a dedicated Red Hat Enterprise Linux 7 server. The server can be physical or virtual.

Global configuration values apply to all virt-who configurations on this server, and are overwritten each time a new virt-who configuration is deployed.

Prerequisites

  • Create a read-only virt-who user on the hypervisor or virtualization manager.
  • If you are deploying a Hyper-V virt-who configuration, enable remote management on the Hyper-V hypervisor.
  • Create a virt-who configuration for your virtualization platform.

Procedure

  1. On the Red Hat Enterprise Linux server, install Satellite Server’s CA certificate: 

    # rpm -ivh http://satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm

  2. Register the Red Hat Enterprise Linux server to Satellite Server: 

    # subscription-manager register \
--org=organization_label \
--auto-attach

  3. Open a network port for communication between virt-who and Satellite Server: 

    # firewall-cmd --add-port="443/tcp"
# firewall-cmd --add-port="443/tcp" --permanent

  4. Open a network port for communication between virt-who and each hypervisor or virtualization manager:

    • VMware vCenter: TCP port 443
    • Microsoft Hyper-V: TCP port 5985
  5. In the Satellite web UI, navigate to Infrastructure > Virt-who configurations.
  6. Click the name of the virt-who configuration file.
  7. Click the Deploy tab.
  8. Under Configuration script, click Download the script.

  9. Copy the script to the Red Hat Enterprise Linux server: 

    # scp deploy_virt_who_config_1.sh root@rhel.example.com:

  10. Make the deployment script executable and run it: 

    # chmod +x deploy_virt_who_config_1.sh
# sh deploy_virt_who_config_1.sh

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

    # rm deploy_virt_who_config_1