Procedure 2.1. To Enable Red Hat Storage in Red Hat Enterprise Virtualization Manager

1. Install Red Hat Enterprise Virtualization Manager
   The Red Hat Enterprise Virtualization Manager is the control center of the Red Hat Enterprise Virtualization environment. Ensure that Red Hat Enterprise Virtualization Manger is installed and configured.
   Install and configure Red Hat Enterprise Virtualization Manager. See the Manager Installation chapter of the Red Hat Enterprise Virtualization Installation Guide for more information.
2. Install Hosts
   Install the virtual machine hosts using either Red Hat Enterprise Virtualization Hypervisor or Red Hat Enterprise Linux as hosts. Before beginning the installation process, ensure that all virtualization hosts meet the hardware requirements and that the installation of Red Hat Enterprise Virtualization Manager is complete.
   You can use the following hypervisors as hosts:
   • Red Hat Enterprise Virtualization Hypervisor 3.4
   • Red Hat Enterprise Linux 6.3
   • Red Hat Enterprise Linux 6.4
   • Red Hat Enterprise Linux 6.5
   During installation, set the fully qualified domain name (FQDN) and IP address for the server in order to avoid network conflicts. See the Installing Red Hat Enterprise Virtualization Hypervisor Hosts chapter of the Red Hat Enterprise Virtualization Installation Guide for information on installing the hypervisor.

   Note

   You must install Red Hat Enterprise Linux 6.3, Red Hat Enterprise Linux 6.4 Server or Red Hat Enterprise Linux 6.5 on a system to use it as a virtualization host in a Red Hat Enterprise Virtualization environment. See the Installing Red Hat Enterprise Linux Hosts chapter of the Red Hat Enterprise Virtualization Installation Guide or the Red Hat Enterprise Linux 6 Installation Guide for detailed instructions.
   Subscribe to the channels
   Red Hat Enterprise Linux hosts need to be registered and subscribed to a number of entitlements using either Subscription Manager or Red Hat Network Classic. For more information, see section Subscribing to Required Channels using RHN Classic in the chapter Installing Red Hat Enterprise Linux Hosts in the Red Hat Enterprise Virtualization Installation Guide.
   Subscribe Red Hat Enterprise Linux 6.3, 6.4, and 6.5 hosts to the channels listed below:
   • rhel-x86_64-server-6
   • rhel-x86_64-rhev-mgmt-agent-6
   Apart from the above channels, you must also subscribe to the Red Hat Storage 3 Native Client channels to get the latest version:
   Run the rhn-channel --add --channel command to subscribe the system to the correct Red Hat Storage Native Client channel:
   • For Red Hat Enterprise Linux 7.x clients using Red Hat Satellite Server:

     # rhn-channel --add --channel= rhel-x86_64-server-rh-common-7

   • For Red Hat Enterprise Linux 6.x clients:

     # rhn-channel --add --channel=rhel-x86_64-server-rhsclient-6

   • For Red Hat Enterprise Linux 5.x clients:

     # rhn-channel --add --channel=rhel-x86_64-server-rhsclient-5

   See Installing Native Client in Red Hat Storage Administration Guide for information on how to install native clients.
3. Configure the Hypervisor
   • Red Hat Enterprise Virtualization Hypervisor host
     Install Red Hat Enterprise Virtualization Hypervisor 3.4 on bare metal. See Configuring the Hypervisor and Attaching the Hypervisor to the Red Hat Enterprise Virtualization Manager in the Installing the Red Hat Enterprise Virtualization Hypervisor chapter of the Red Hat Enterprise Virtualization Installation Guide for more information.
   • Red Hat Enterprise Linux 6.3, Red Hat Enterprise Linux 6.4 or Red Hat Enterprise Linux 6.5 host
     A Red Hat Enterprise Linux virtualization host must be registered and subscribed to a number of entitlements using either Subscription Manager or Red Hat Network Classic. See Subscribing to Required Channels using RHN Classic in the Installing Red Hat Enterprise Linux Hosts chapter of the Red Hat Enterprise Virtualization Installation Guide for more information.
     Subscribe to the Red Hat Storage Native Client from the Additional Services Channels to ensure the server has the latest clients installed:

     # yum install glusterfs-fuse glusterfs

     See the Installing Native Client section in the Red Hat Storage Administration Guide for more information.
4. Configure the data centers
   Define data centers and clusters to organize the virtualization hosts. The installation process creates a data center and associated cluster named Default.

   Note

   A server can be a Red Hat Enterprise Virtualization Hypervisor or a Red Hat Enterprise Linux host. A trusted storage pool requires a minimum of one storage host, and at least one active virtualization host is required to connect the system to a storage pool.
5. Install Red Hat Storage
   Install the latest version of RHS on the system.
   See section, "Prerequisites" of the Red Hat Storage Installation Guide for more information on obtaining the software. For information on installing Red Hat Storage from an ISO, see the Red Hat Storage Installation Guide.
6. Configure Storage
   Configure the Red Hat Storage installation for your requirements.
   For instructions on creating a Red Hat Storage Volume, see chapter Red Hat Storage Volume in the Red Hat Storage Administration Guide.
   Red Hat Enterprise Virtualization uses a centralized storage system for virtual machine disk images. Before adding storage, ensure that you have a working Red Hat Enterprise Virtualization Manager environment. You must be able to access the Administration Portal, and there must be at least one host connected with Up status.

   Note

   Red Hat Storage recommends that you use Replicate or Distributed Replicate volume type for hosting virtual machine disk images.
7. Attach Storage to Hypervisor
   Attach the Red Hat Storage volume as a storage domain.

1. Install the Tune daemon
   Install the tuned daemon that tunes the system settings dynamically.

   # yum install tuned

2. Edit the virtual-guest profile provided by the Tune daemon.
   Edit the /etc/tune-profiles/virtual-guest/ktune.sh
   Identify the line multiply_disk_readahead 4 and replace it with multiply_disk_readahead 16
3. Apply the virtual-guest profile on the virtual machines
   Activate the updated profile with the command:

   # tuned-adm profile virtual-guest

Procedure 3.1. To Configure Volumes Using the Command Line Interface

1. Configure the Red Hat Storage volume using the following command:

   # gluster volume set VOLNAME group virt

   Important

   After tagging the volume as group virt, use the volume for storing virtual machine images only and always access the volume through the glusterFS native client.
2. The gluster volume set <VOLNAME> group virt command configures the specified volume using the settings in the /var/lib/glusterd/groups/virt file. The following settings are the recommended defaults:

   quick-read=off
   read-ahead=off
   io-cache=off
   stat-prefetch=off
   eager-lock=enable
   remote-dio=on
   quorum-type=auto
   server-quorum-type=server

   Important

   When you upgrade to Red Hat Storage 3, a new virt file is created in /var/lib/glusterd/groups/virt.rpmnew. Ensure to apply the new virt file on the existing volumes by renaming the virt.rpmnew file to virt, along with the customized settings.
   All the performance-related settings other than cluster.eager-lock prevent caching within GlusterFS client stack, as it is the preferred mode for attaching disks to a virtual machine. The cluster.eager-lock option optimizes write performance with synchronous replication when there is a single writer to a file. For description on each of these performance-related settings, see chapter Configuring Volume Options in the Red Hat Storage Administration Guide.

   Note

   Server-Side and Client-Side Quorum are enabled by default in the /var/lib/glusterd/groups/virt file to minimize split-brain scenarios. If Server-Side Quorum is not met, then the Red Hat Storage volumes become unavailable causing the Virtual Machines (VMs) to move to a paused state. If Client-Side Quorum is not met, although a replica pair in a Red Hat Storage volume is available in the read-only mode, the VMs move to a paused state.

   Manual intervention is required to make the VMs resume the operations after the quorum is restored. Consistency is achieved at the cost of fault tolerance. If fault tolerance is preferred over consistency, disable server-side and client-side quorum with the commands:

   # gluster volume reset <vol-name> server-quorum-type
   # gluster volume reset <vol-name> quorum-type

   For more information on these configuration settings, see Managing Red Hat Storage Volumes in the Red Hat Storage Administration Guide.
3. Set the brick permissions for vdsm and kvm. If you do not set the required brick permissions, creation of virtual machines fails.
   1. Set the user and group permissions using the following commands:

      # gluster volume set VOLNAME storage.owner-uid 36
      # gluster volume set VOLNAME storage.owner-gid 36

   2. If you are using QEMU/KVM as a hypervisor, set the user and group permissions using the following commands:

      # gluster volume set VOLNAME storage.owner-uid 107
      # gluster volume set VOLNAME storage.owner-gid 107

Procedure 3.2. To Add a Red Hat Storage Server for Virtualization Using Red Hat Enterprise Virtualization Manager

1. Create a data center:
   1. Select the Data Centers resource tab to list all data centers.
   2. Click New to open the New Data Center window.
      

      Figure 3.1. New Data Center Window

   3. Enter the Name and Description of the data center.
   4. Select the storage Type as Shared from the drop-down menu.
   5. Select the Quota Mode as Disabled.
   6. Click OK.
   The new data center is Uninitialized until you configure the cluster, host, and storage settings.
2. Create a cluster:
   1. Select the Clusters resource tab to list all clusters.
   2. Click New to open the New Cluster window.
      

      Figure 3.2. New Cluster Window

   3. Select a Data Center for the cluster from the drop-down menu.
   4. Enter a Name and Description for the cluster.
   5. Select the CPU Name and Compatibility Version from the drop-down menus.
   6. Check Enable Virt Service.
   7. Click OK.
3. Add hosts:
   1. Select the Hosts resource tab to view a list of all hosts in the system.
   2. Click New to open the New Host window.
      

      Figure 3.3. New Host Window

      Important

      A Red Hat Enterprise Linux hypervisor and Red Hat Enterprise Virtualization hypervisor on a single VDSM cluster accessing the same virtual machine image store is not supported.
   3. Select the Data Center and Host Cluster for the new host from the drop-down menus.
   4. Enter the Name, Address, and Root Password of the new hypervisor host.
   5. Check Automatically configure host firewall if required.
   6. Click OK.
   The new host appears in the list of hypervisor hosts with the status Installing. After the host is activated, the status changes to Up automatically.
4. Create and configure volumes on the Red Hat Storage cluster using the command line interface. For information on creating and configuring volumes, see Setting up Red Hat Storage Volumes in the Red Hat Storage Administration Guide and Section 3.1, “Configuring Volumes Using the Command Line Interface”.
5. Add a storage domain using Red Hat Enterprise Virtualization Manager:
   1. Select the Storage resource tab to list existing storage domains.
   2. Click New Domain to open the New Domain window.
      

      Figure 3.4. New Domain Window

   3. Enter a Name for the storage domain.
   4. Select a shared Data Center to associate with the storage domain.
   5. Select Data / glusterFS from the Domain Function/Storage Type drop-down menu.
   6. Select a host from the Use Host drop-down menu.
   7. Enter the Path of a Red Hat Storage server in the cluster. For example, RHS-Server:/VOLNAME
   8. Enter glusterfs as VFS Type. This selection is made by default if the data center is of type glusterFS.
   9. Enter the applicable Red Hat Storage native client Mount Options. Enter multiple mount options separated by commas. For more information on native client mount options, see Accessing Data - Setting up Clients in the Red Hat Storage Administration Guide.
   10. Click OK.
   11. Click Activate to activate the new Red Hat Storage domain.
       

       Figure 3.5. Activated Red Hat Storage Domain