Red Hat Enterprise Virtualization 3.3

Installation Guide

Installing Red Hat Enterprise Virtualization Environments

Legal Notice

Copyright © 2014 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

A comprehensive guide to installing Red Hat Enterprise Virtualization environments.
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. Installing the Red Hat Enterprise Virtualization Manager
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. Passwords in Red Hat Enterprise Virtualization Manager
3.7. Preparing a PostgreSQL Database for Use with Red Hat Enterprise Virtualization Manager
3.8. Configuring the Manager to Use a Manually Configured Local or Remote PostgreSQL Database
3.9. Connecting to the Administration Portal
3.10. Removing Red Hat Enterprise Virtualization Manager
4. Self-Hosted Engine
4.1. About the Self-Hosted Engine
4.2. Limitations of the Self-Hosted Engine
4.3. Installing the Self-Hosted Engine
4.4. Configuring the Self-Hosted Engine
4.5. Migrating to a Self-Hosted Environment
4.6. Installing Additional Hosts to a Self-Hosted Environment
4.7. Maintaining the Self-Hosted Engine
5. Data Collection Setup and Reports Installation
5.1. Workflow Progress — Data Collection Setup and Reports Installation
5.2. Data Collection Setup and Reports Installation Overview
5.3. Installing and Configuring the History Database
5.4. Installing and Configuring Red Hat Enterprise Virtualization Manager Reports
6. Updating the Red Hat Enterprise Virtualization Environment
6.1. Upgrades between Minor Releases
6.1.1. Checking for Red Hat Enterprise Virtualization Manager Updates
6.1.2. Updating Red Hat Enterprise Virtualization Manager
6.1.3. Troubleshooting for Upgrading Red Hat Enterprise Virtualization Manager
6.1.4. Updating Red Hat Enterprise Virtualization Manager Reports
6.1.5. Updating Red Hat Enterprise Virtualization Hypervisors
6.1.6. Updating Red Hat Enterprise Linux Virtualization Hosts
6.1.7. Updating the Red Hat Enterprise Virtualization Guest Tools
6.2. Upgrading to Red Hat Enterprise Virtualization 3.3
6.2.1. Red Hat Enterprise Virtualization Manager 3.3 Upgrade Overview
6.2.2. Red Hat Enterprise Virtualization 3.3 Upgrade Considerations
6.2.3. Upgrading to Red Hat Enterprise Virtualization Manager 3.3
6.3. Upgrading to Red Hat Enterprise Virtualization Manager 3.2
6.3.1. Upgrading to Red Hat Enterprise Virtualization Manager 3.2
6.4. Upgrading to Red Hat Enterprise Virtualization Manager 3.1
6.4.1. Upgrading to Red Hat Enterprise Virtualization Manager 3.1
6.5. Post-upgrade Tasks
6.5.1. Features Requiring a Compatibility Upgrade to Red Hat Enterprise Virtualization 3.3
6.5.2. Changing the Cluster Compatibility Version
6.5.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
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 Simple Network Management Protocol
8.5.7. Configuring Hypervisor Common Information Model
8.5.8. Configuring Logging
8.5.9. Configuring the Hypervisor for Red Hat Network
8.5.10. Configuring Hypervisor Kernel Dumps
8.5.11. Configuring Hypervisor Remote Storage
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
9.5. Explanation of Settings and Controls in the New Host and Edit Host Windows
9.5.1. Host General Settings Explained
9.5.2. Host Power Management Settings Explained
9.5.3. SPM Priority Settings Explained
9.5.4. Host Console Settings Explained
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
10.4.3. Enabling Gluster Processes on Red Hat Storage Nodes
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. Explanation of Settings and Controls in the General Tab of the New Logical Network and Edit Logical Network Windows
11.3.4. Editing a Logical Network
11.3.5. Designate a Specific Traffic Type for a Logical Network with the Manage Networks Window
11.3.6. Explanation of Settings in the Manage Networks Window
11.3.7. Adding Multiple VLANs to a Single Network Interface Using Logical Networks
11.3.8. Multiple Gateways
11.4. Using the Networks Tab
11.4.1. Importing Networks from External Providers
11.4.2. Limitations to Importing Networks from External Providers
11.5. Bonds
11.5.1. Bonding Logic in Red Hat Enterprise Virtualization
11.5.2. Bonding Modes
11.5.3. Creating a Bond Device Using the Administration Portal
11.5.4. Example Uses of Custom Bonding Options with Host Interfaces
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 pNFS Storage
12.3.3. Adding iSCSI Storage
12.3.4. Adding FCP Storage
12.3.5. Adding Local Storage
12.3.6. 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 Log Files
A.3. Red Hat Enterprise Virtualization Host Log Files
A.4. Remotely Logging Host Activities
A.4.1. Setting Up a Virtualization Host Logging Server
A.4.2. Configuring Logging
A.4.3. Configuring Logging
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 engine-config Command
B.3. Image Uploader
B.3.1. Virtual Machine Image Uploader
B.3.2. Syntax for the engine-image-uploader Command
B.3.3. Creating an OVF Archive That is Compatible with the Image Uploader
B.3.4. Basic engine-image-uploader Usage Examples
B.4. ISO Uploader
B.4.1. ISO Uploader
B.4.2. Syntax for engine-iso-uploader Command
B.4.3. Usage Examples
B.5. Log Collector
B.5.1. Log Collector
B.5.2. Syntax for engine-log-collector Command
B.5.3. Basic Log Collector Usage
B.6. SPICE Proxy
B.6.1. SPICE Proxy Overview
B.6.2. SPICE Proxy Machine Setup
B.6.3. Turning on SPICE Proxy
B.6.4. Turning Off a SPICE Proxy
B.7. Squid Proxy
B.7.1. Installing and Configuring a Squid Proxy
C. Revision History