A.10. Shutting down Red Hat Enterprise Linux 6 Guests on a Red Hat Enterprise Linux 7 Host

Procedure A.4. Workaround for Red Hat Enterprise Linux 6 guests

1. Install the acpid package

   The acpid service listens and processes ACPI requests.
   Log into the guest virtual machine and install the acpid package on the guest virtual machine:
   Copy to Clipboard Toggle word wrap

   # yum install acpid

2. Enable the acpid service on the guest

   Set the acpid service to start during the guest virtual machine boot sequence and start the service:
   Copy to Clipboard Toggle word wrap

   # chkconfig acpid on
   # service acpid start

3. Prepare guest domain XML

   Edit the domain XML file to include the following element. Replace the virtio serial port with org.qemu.guest_agent.0 and use your guest's name instead of the one shown. In this example, the guest is guest1. Remember to save the file.
   Copy to Clipboard Toggle word wrap

   
   <channel type='unix'>
      <source mode='bind' path='/var/lib/libvirt/qemu/guest1.agent'/>
      <target type='virtio' name='org.qemu.guest_agent.0'/>
   </channel>
       
   
   

   Figure A.1. Guest XML replacement

4. Install the QEMU guest agent

   Install the QEMU guest agent (QEMU-GA) and start the service as directed in the Red Hat Enterprise Linux 6 Virtualization Administration Guide.

5. Shut down the guest

   1. List the known guest virtual machines so you can retrieve the name of the one you want to shutdown.
      Copy to Clipboard Toggle word wrap

      # virsh list --all
         Id Name              State
      ----------------------------------
        14 guest1             running
      

   2. Shut down the guest virtual machine.
      Copy to Clipboard Toggle word wrap

      # virsh shutdown guest1
      
      guest virtual machine guest1 is being shutdown
      

   3. Wait a few seconds for the guest virtual machine to shut down. Verify it is shutdown.
      Copy to Clipboard Toggle word wrap

      # virsh list --all
       Id Name                 State
      ----------------------------------
       14 guest1               shut off
      

   4. Start the guest virtual machine named guest1, with the XML file you edited.
      Copy to Clipboard Toggle word wrap

      # virsh start guest1

   5. Shut down the acpi in the guest1 guest virtual machine.
      Copy to Clipboard Toggle word wrap

      # virsh shutdown --mode acpi guest1

   6. List all the guest virtual machines again, guest1 should still be on the list, and it should indicate it is shut off.
      Copy to Clipboard Toggle word wrap

      #  virsh list --all
         Id Name                 State
      ----------------------------------
         14 guest1               shut off
      

   7. Start the guest virtual machine named guest1, with the XML file you edited.
      Copy to Clipboard Toggle word wrap

      # virsh start guest1

   8. Shut down the guest1 guest virtual machine guest agent.
      Copy to Clipboard Toggle word wrap

      # virsh shutdown --mode agent guest1

   9. List the guest virtual machines. guest1 should still be on the list, and it should indicate it is shut off.
      Copy to Clipboard Toggle word wrap

      # virsh list --all
         Id Name                 State
      ----------------------------------
         guest1                shut off