Chapter 3. 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.
- To deploy the files on a hypervisor or Capsule Server, see Section 3.1, “Deploying a virt-who configuration on a hypervisor”.
- To deploy the files on Satellite Server, see Section 3.2, “Deploying a virt-who configuration on Satellite Server”.
- To deploy the files on a separate Red Hat Enterprise Linux server, see Section 3.3, “Deploying a virt-who configuration on a separate Red Hat Enterprise Linux server”.
3.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
- In the Satellite web UI, navigate to Infrastructure > Virt-who configurations.
- Click the name of the virt-who configuration.
- Click the Deploy tab.
- Under Configuration script, click Download the script.
Copy the script to the hypervisor:
# scp deploy_virt_who_config_1.sh root@hypervisor.example.com:
Make the deployment script executable and run it:
# chmod +x deploy_virt_who_config_1.sh # sh deploy_virt_who_config_1.sh
After the deployment is complete, delete the script:
# rm deploy_virt_who_config_1
3.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
- In the Satellite web UI, navigate to Infrastructure > Virt-who configurations.
- Click the name of the virt-who configuration.
- Under Hammer command, click Copy to clipboard.
- On Satellite Server, paste the Hammer command into your terminal.
3.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
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
Register the Red Hat Enterprise Linux server to Satellite Server:
# subscription-manager register \ --org=organization_label \ --auto-attach
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
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
- In the Satellite web UI, navigate to Infrastructure > Virt-who configurations.
- Click the name of the virt-who configuration file.
- Click the Deploy tab.
- Under Configuration script, click Download the script.
Copy the script to the Red Hat Enterprise Linux server:
# scp deploy_virt_who_config_1.sh root@rhel.example.com:
Make the deployment script executable and run it:
# chmod +x deploy_virt_who_config_1.sh # sh deploy_virt_who_config_1.sh
After the deployment is complete, delete the script:
# rm deploy_virt_who_config_1