Chapter 10. Registering the Hypervisor and Virtual Machine

1. Register the KVM hypervisor

   Register the KVM Hypervisor by running the subscription-manager register [options] command in a terminal as the root user on the host physical machine. More options are available using the # subscription-manager register --help menu. In cases where you are using a user name and password, use the credentials that are known to the Subscription Manager application. If this is your very first time subscribing and you do not have a user account, contact customer support. For example to register the VM as 'admin' with 'secret' as a password, you would send the following command:

   [root@rhel-server ~]# subscription-manager register --username=admin --password=secret --auto-attach

2. Install the virt-who packages

   Install the virt-who packages, by running the following command on the host physical machine:

   # yum install virt-who

3. Create a virt-who configuration file

   For each hypervisor, add a configuration file in the /etc/virt-who.d/ directory. At a minimum, the file must contain the following snippet:

   [libvirt]
   type=libvirt
   

   For more detailed information on configuring virt-who, see Section 10.1.1, “Configuring virt-who”.

4. Start the virt-who service

   Start the virt-who service by running the following command on the host physical machine:

   # systemctl start virt-who.service
   # systemctl enable virt-who.service

5. Confirm virt-who service is receiving guest information

   At this point, the virt-who service will start collecting a list of domains from the host. Check the /var/log/rhsm/rhsm.log file on the host physical machine to confirm that the file contains a list of the guest VMs. For example:

   2015-05-28 12:33:31,424 DEBUG: Libvirt domains found: [{'guestId': '58d59128-cfbb-4f2c-93de-230307db2ce0', 'attributes': {'active': 0, 'virtWhoType': 'libvirt', 'hypervisorType': 'QEMU'}, 'state': 5}]
   

Procedure 10.1. Managing the subscription on the customer portal

1. Subscribing the hypervisor

   As the virtual machines will be receiving the same subscription benefits as the hypervisor, it is important that the hypervisor has a valid subscription and that the subscription is available for the VMs to use.

   1. Log in to the Customer Portal

      Provide your Red Hat account credentials at the Red Hat Customer Portal to log in.

   2. Click the Systems link

      Go to the Systems section of the My Subscriptions interface.

   3. Select the hypervisor

      On the Systems page, there is a table of all subscribed systems. Click the name of the hypervisor (for example localhost.localdomain). In the details page that opens, click Attach a subscription and select all the subscriptions listed. Click Attach Selected. This will attach the host's physical subscription to the hypervisor so that the guests can benefit from the subscription.

2. Subscribing the guest virtual machines - first time use

   This step is for those who have a new subscription and have never subscribed a guest virtual machine before. If you are adding virtual machines, skip this step. To consume the subscription assigned to the hypervisor profile on the machine running the virt-who service, auto subscribe by running the following command in a terminal on the guest virtual machine.

   [root@virt-who ~]# subscription-manager attach --auto

3. Subscribing additional guest virtual machines

   If you just subscribed a virtual machine for the first time, skip this step. If you are adding additional virtual machines, note that running this command will not necessarily re-attach the same subscriptions to the guest virtual machine. This is because removing all subscriptions then allowing auto-attach to resolve what is necessary for a given guest virtual machine may result in different subscriptions consumed than before. This may not have any effect on your system, but it is something you should be aware about. If you used a manual attachment procedure to attach the virtual machine, which is not described below, you will need to re-attach those virtual machines manually as the auto-attach will not work. Use the following command to first remove the subscriptions for the old guests, and then use the auto-attach to attach subscriptions to all the guests. Run these commands on the guest virtual machine.

   [root@virt-who ~]# subscription-manager remove --all
   [root@virt-who ~]# subscription-manager attach --auto

4. Confirm subscriptions are attached

   Confirm that the subscription is attached to the hypervisor by running the following command on the guest virtual machine:

   [root@virt-who ~]# subscription-manager list --consumed

   Output similar to the following will be displayed. Pay attention to the Subscription Details. It should say 'Subscription is current'.

   [root@virt-who ~]# subscription-manager list --consumed
   +-------------------------------------------+
      Consumed Subscriptions
   +-------------------------------------------+
   Subscription Name:	Awesome OS with unlimited virtual guests
   Provides: 		Awesome OS Server Bits
   SKU: 			awesomeos-virt-unlimited
   Contract: 		0
   Account: 		######### Your account number #####
   Serial: 		######### Your serial number ######
   Pool ID: 		XYZ123                                             
   Provides Management: 	No
   Active: 		True
   Quantity Used: 		1
   Service Level:
   Service Type:
   Status Details:		Subscription is current                       
   Subscription Type:
   Starts: 		01/01/2015
   Ends: 			12/31/2015
   System Type: 		Virtual
   

   	The ID for the subscription to attach to the system is displayed here. You will need this ID if you need to attach the subscription manually.
   	Indicates if your subscription is current. If your subscription is not current, an error message appears. One example is Guest has not been reported on any host and is using a temporary unmapped guest subscription. In this case the guest needs to be subscribed. In other cases, use the information as indicated in Section 10.5.2, “I have subscription status errors, what do I do?”.

5. Register additional guests

   When you install new guest VMs on the hypervisor, you must register the new VM and use the subscription attached to the hypervisor, by running the following commands on the guest virtual machine:

   # subscription-manager register
   # subscription-manager attach --auto
   # subscription-manager list --consumed