Red Hat Enterprise Virtualization 3.1

Installation Guide

Installing Red Hat Enterprise Virtualization Environments

Edition 5

Andrew Burden

Steve Gordon

Tim Hildred

Legal Notice

Copyright © 2012 Red Hat, Inc.
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack Logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.

Abstract

Note: This document is under development, is subject to substantial change, and is provided only as a preview. The included information and instructions should not be considered complete, and should be used with caution.
Preface
1. Document Conventions
1.1. Typographic Conventions
1.2. Pull-quote Conventions
1.3. Notes and Warnings
2. Getting Help and Giving Feedback
2.1. Do You Need Help?
2.2. We Need Feedback!
I. Before you Begin
1. Introduction
1.1. Red Hat Enterprise Virtualization Architecture
1.2. Red Hat Enterprise Virtualization System Components
1.3. Red Hat Enterprise Virtualization Resources
1.4. Red Hat Enterprise Virtualization API Support Statement
1.5. Introduction to Virtual Machines
1.6. Supported Virtual Machine Operating Systems
1.7. Red Hat Enterprise Virtualization Installation Workflow
2. System Requirements
2.1. Workflow Progress — System Requirements
2.2. Hardware Requirements
2.2.1. Red Hat Enterprise Virtualization Hardware Requirements Overview
2.2.2. Red Hat Enterprise Virtualization Manager Hardware Requirements
2.2.3. Virtualization Host Hardware Requirements
2.3. Software Requirements
2.3.1. Red Hat Enterprise Virtualization Operating System Requirements
2.3.2. Red Hat Enterprise Virtualization Manager Client Requirements
2.3.3. Red Hat Enterprise Virtualization Manager Software Channels
2.3.4. Directory Services
2.3.5. Firewall Configuration
2.3.6. Required User Accounts and Groups
II. Installing Red Hat Enterprise Virtualization Manager
3. Manager Installation
3.1. Workflow Progress — Installing Red Hat Enterprise Virtualization Manager
3.2. Manager Installation Overview
3.3. Subscribing to the Red Hat Enterprise Virtualization Channels
3.3.1. Subscribing to the Red Hat Enterprise Virtualization Manager Channels using Subscription Manager
3.3.2. Subscribing to the Red Hat Enterprise Virtualization Manager Channels using RHN Classic
3.4. Installing the Red Hat Enterprise Virtualization Manager Packages
3.5. Configuring Red Hat Enterprise Virtualization Manager
3.6. Connecting to the Administration Portal
3.7. Removing Red Hat Enterprise Virtualization Manager
4. Data Collection Setup and Reports Installation
4.1. Workflow Progress — Data Collection Setup and Reports Installation
4.2. Data Collection Setup and Reports Installation Overview
4.3. Installing and Configuring the History Database
4.4. Installing and Configuring Red Hat Enterprise Virtualization Manager Reports
5. Updating Red Hat Enterprise Virtualization between Minor Releases
5.1. Checking for Red Hat Enterprise Virtualization Manager Updates
5.2. Updating Red Hat Enterprise Virtualization Manager
5.3. Updating Red Hat Enterprise Virtualization Manager Reports
5.4. Updating Red Hat Enterprise Virtualization Hypervisors
5.5. Updating Red Hat Enterprise Linux Virtualization Hosts
6. Upgrading to Red Hat Enterprise Virtualization 3.1
6.1. Upgrading to Red Hat Enterprise Virtualization Manager 3.1
6.2. Changing the Cluster Compatibility Version
6.3. Changing the Data Center Compatibility Version
III. Installing Virtualization Hosts
7. Introduction to Virtualization Hosts
7.1. Workflow Progress — Installing Virtualization Hosts
7.2. Introduction to Virtualization Hosts
8. Installing Red Hat Enterprise Virtualization Hypervisor Hosts
8.1. Red Hat Enterprise Virtualization Hypervisor Installation Overview
8.2. Installing the Red Hat Enterprise Virtualization Hypervisor Packages
8.3. Preparing Hypervisor Installation Media
8.3.1. Preparing USB Hypervisor Installation Media
8.3.2. Preparing Optical Hypervisor Installation Media
8.3.3. Booting from Hypervisor Installation Media
8.4. Installing the Hypervisor
8.4.1. Hypervisor Menu Actions
8.4.2. Installing the Hypervisor Interactively
8.5. Configuring the Hypervisor
8.5.1. Logging into the Hypervisor
8.5.2. Selecting Hypervisor Keyboard
8.5.3. Viewing Hypervisor Status
8.5.4. Configuring Hypervisor Network
8.5.5. Configuring Hypervisor Security
8.5.6. Configuring Hypervisor Logging
8.5.7. Configuring Hypervisor Simple Network Management Protocol (SNMP)
8.5.8. Configuring Hypervisor Kernel Dumps
8.5.9. Configuring Hypervisor Remote Storage
8.5.10. Configuring Hypervisor Common Information Model (CIM)
8.5.11. Configuring Hypervisor for Red Hat Network
8.6. Attaching the Hypervisor to the Red Hat Enterprise Virtualization Manager
8.6.1. Configuring Hypervisor Management Server
8.6.2. Using the Hypervisor
8.6.3. Approving a Hypervisor
9. Installing Red Hat Enterprise Linux Hosts
9.1. Red Hat Enterprise Linux Hosts
9.2. Host Compatibility Matrix
9.3. Preparing a Red Hat Enterprise Linux Host
9.3.1. Installing Red Hat Enterprise Linux
9.3.2. Subscribing to Required Channels using Subscription Manager
9.3.3. Subscribing to Required Channels using RHN Classic
9.3.4. Configuring Virtualization Host Firewall
9.3.5. Configuring Virtualization Host sudo
9.3.6. Configuring Virtualization Host SSH
9.4. Adding a Red Hat Enterprise Linux Host
IV. Environment Configuration
10. Planning your Data Center
10.1. Workflow Progress — Planning your Data Center
10.2. Planning your Data Center
10.3. Data Centers
10.3.1. Data Centers in Red Hat Enterprise Virtualization
10.3.2. Creating a New Data Center
10.4. Clusters
10.4.1. Clusters in Red Hat Enterprise Virtualization
10.4.2. Creating a New Cluster
11. Network Setup
11.1. Workflow Progress — Network Setup
11.2. Networking in Red Hat Enterprise Virtualization
11.3. Logical Networks
11.3.1. Creating a New Logical Network in a Data Center or Cluster
11.3.2. Editing Host Network Interfaces and Adding Logical Networks to Hosts
11.3.3. Designating a Logical Network for a Specific Traffic Type in Red Hat Enterprise Virtualization Manager
11.4. Bonds
11.4.1. Bonding Modes
11.4.2. Creating a Bond Device using the Administration Portal
11.4.3. Switch Configuration for Bonding
12. Storage Setup
12.1. Workflow Progress — Storage Setup
12.2. Introduction to Storage in Red Hat Enterprise Virtualization
12.3. Adding Storage to the Environment
12.3.1. Adding NFS Storage
12.3.2. Adding iSCSI Storage
12.3.3. Adding FCP Storage
12.3.4. Adding Local Storage
12.3.5. Adding POSIX Compliant File System Storage
12.4. Populating the ISO Domain
12.4.1. Populating the ISO Storage Domain
12.4.2. VirtIO and Guest Tool Image Files
12.4.3. Uploading the VirtIO and Guest Tool Image Files to an ISO Storage Domain
A. Log Files
A.1. Red Hat Enterprise Virtualization Manager Installation Log Files
A.2. Red Hat Enterprise Virtualization Manager Service Activity Log Files
A.3. Red Hat Enterprise Virtualization Host Log Files
B. Additional Utilities
B.1. Domain Management Tool
B.1.1. What is the Domain Management Tool?
B.1.2. Syntax for the Domain Management Tool
B.1.3. Adding Domains to Configuration
B.1.4. Editing a Domain in the Configuration
B.1.5. Deleting a Domain from the Configuration
B.1.6. Validating Domain Configuration
B.1.7. Listing Domains in Configuration
B.2. Configuration Tool
B.2.1. Configuration Tool
B.2.2. Syntax for rhevm-config Command
B.3. Image Uploader
B.3.1. Virtual Machine Image Uploader
B.3.2. Syntax for the rhevm-image-uploader Command
B.3.3. Creating an OVF Archive That Is Compatible with the Image Uploader
B.3.4. Basic rhevm-image-uploader Usage Examples
B.4. ISO Uploader
B.4.1. ISO Uploader
B.4.2. Syntax for rhevm-iso-uploader Command
B.4.3. Usage Examples
B.5. Log Collector
B.5.1. Log Collector
B.5.2. Syntax for rhevm-log-collector Command
B.5.3. Basic Log Collector Usage
B.5.4. Collecting Logs
C. Revision History