Product SiteDocumentation Site

11.2. Populate the ISO Domain

Once an ISO storage domain is defined for a data center, CD-ROM images or ISO images must be uploaded for the virtual machines to use. Red Hat Enterprise Virtualization provides an ISO uploader tool that ensures that the images are uploaded into the correct directory path, with the correct user permissions. While an example is provided here, for full usage information see Section C.3, “ISO Uploader”.
The creation of ISO images from physical media is not described in this document. It is assumed that you have access to the images required for your environment.
  1. Copy the required ISO image to a temporary directory on the system running Red Hat Enterprise Virtualization Manager.
  2. Log in to the system running Red Hat Enterprise Virtualization Manager as the root user.
  3. Use the rhevm-iso-uploader command to upload the ISO image. This action will take some time, the amount of time varies depending on the size of the image being uploaded and available network bandwidth.
    Example 11.1. ISO Uploader Usage
    In this example the ISO image RHEL6.iso is uploaded to the ISO domain called ISODomain using NFS. The command will prompt for an administrative username and password. The username must be provided in the form username@domain.
    # rhevm-iso-uploader --iso-domain=ISODomain upload RHEL6.iso

Result:
The ISO image is uploaded and appears in the ISO storage domain specified. It is also available in the list of available boot media when creating virtual machines in the data center which the storage domain is attached to.

11.2.1. Uploading the VirtIO and Guest Tool Image Files

When a local ISO storage domain is configured during installation the virtio-win ISO and Virtual Floppy Drive (VFD) images, containing the VirtIO drivers for Windows virtual machines, are automatically copied to the new storage domain. The rhev-tools-setup ISO, containing the Red Hat Enterprise Virtualization Guest Tools for Windows virtual machines are also copied to the domain.
These image files provide software that can be installed on guest operating systems to improve the performance and usability of the virtual machine. The most recent virtio-win and rhev-tools-setup images are referred to by the following symbolic links on the filesystem of the Red Hat Enterprise Virtualization Manager:
  • /usr/share/virtio-win/virtio-win.iso
  • /usr/share/virtio-win/virtio-win.vfd
  • /usr/share/rhev-guest-tools-iso/rhev-tools-setup.iso
These image files must be manually uploaded to ISO storage domains that were not created locally by the installation process. You must use the rhevm-iso-uploader command to upload these images to your ISO storage domain. Once the image files have been uploaded they can be attached to, and used by, virtual machines.
Example 11.2. Upload of VirtIO and Guest Tool Image Files
In this example the virtio-win.iso, virtio-win.vfd, and rhev-tools-setup.iso image files are uploaded to the ISODomain ISO storage domain.
# rhevm-iso-uploader --iso-domain=ISODomain upload /usr/share/virtio-win/virtio-win.iso /usr/share/virtio-win/virtio-win.vfd /usr/share/rhev-guest-tools-iso/rhev-tools-setup.iso