Red Hat Enterprise Virtualization 3.1

Administration Guide

Administrating Red Hat Enterprise Virtualization Environments.

Edition 1

Jodi Biddle

Andrew Burden

Zac Dover

Steve Gordon

Tim Hildred

Dayle Parker

Cheryn Tan

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

This book contains information and procedures relevant to Red Hat Enterprise Virtualization administrators.
Preface
1. Document Conventions
2. Getting Help and Giving Feedback
1. Using this Guide
1.1. Administration Guide Prerequisites
1.2. Administration Guide Layout
1.3. Example Workflows
2. Basics
2.1. Introduction
2.2. Using the Administration Portal Graphical Interface
I. Administering the Resources
3. Data Centers
3.1. Introduction to Data Centers
3.2. The Storage Pool Manager (SPM)
3.3. SPM Priority
3.4. Using the Events Tab to Identify Problem Objects in Data Centers
3.5. Data Center Tasks
3.6. Data Centers and Storage Domains
3.7. Data Centers and Permissions
4. Clusters
4.1. Introduction to Clusters
4.2. Cluster Tasks
4.3. Clusters and Permissions
5. Logical Networks
5.1. Introduction to Logical Networks
5.2. Port Mirroring
5.3. Required Networks, Optional Networks, and Virtual Machine Networks
5.4. Logical Network Tasks
6. Hosts
6.1. Introduction to Red Hat Enterprise Virtualization Hosts
6.2. Red Hat Enterprise Virtualization Hypervisor Hosts
6.3. Red Hat Enterprise Linux Hosts
6.4. Host Tasks
6.5. Hosts and Networking
6.6. Host Resilience
6.7. Hosts and Permissions
7. Storage
7.1. Introduction to Storage in Red Hat Enterprise Virtualization
7.2. Understanding Storage Domains
7.3. Storage Metadata Versions in Red Hat Enterprise Virtualization
7.4. Preparing and Adding File-based Storage
7.5. Adding POSIX Compliant File System Storage
7.6. Adding Block-based Storage
7.7. Storage Tasks
7.8. Red Hat Storage Volumes
7.9. Storage and Permissions
8. Virtual Machines
8.1. Introduction to Virtual Machines
8.2. Supported Virtual Machine Operating Systems
8.3. Virtual Machine Performance Parameters
8.4. Creating Virtual Machines
8.5. Using Virtual Machines
8.6. Shutting Down or Pausing Virtual Machines
8.7. Managing Virtual Machines
8.8. Virtual Machines and Permissions
8.9. Backing Up and Restoring Virtual Machines with Snapshots
8.10. Importing and Exporting Virtual Machines
8.11. Migrating Virtual Machines Between Hosts
8.12. Improving Uptime with Virtual Machine High Availability
8.13. Other Virtual Machine Tasks
9. Templates
9.1. Introduction to Templates
9.2. Template Tasks
9.3. Sealing Templates in Preparation for Deployment
9.4. Templates and Permissions
10. Pools
10.1. Introduction to Virtual Machine Pools
10.2. Virtual Machine Pool Tasks
10.3. Pools and Permissions
11. Virtual Machine Disks
11.1. Understanding Virtual Machine Storage
11.2. Understanding Virtual Disks
11.3. Shareable Disks in Red Hat Enterprise Virtualization
11.4. Creating Unassociated Virtual Machine Hard Disks
11.5. Explanation of Settings in the New Virtual Machine Disk and Edit Virtual Machine Disk Windows
11.6. Moving a Virtual Machine Hard Disk Between Data Domains
11.7. Virtual Disks and Permissions
II. Administering the Environment
12. Users and Roles
12.1. Introduction to Users
12.2. Directory Users
12.3. User Authorization
12.4. RHEVM User Properties and Roles
12.5. RHEVM User Tasks
12.6. User Role and Authorization Examples
13. Quotas
13.1. Introduction to Quota
13.2. Shared Quota and Individually-defined Quota
13.3. Quota Accounting
13.4. Enabling and Changing a Quota Mode in a Data Center
13.5. Creating a New Quota Policy
13.6. Explanation of Quota Threshold Settings
13.7. Assigning a Quota to an Object
13.8. Using Quota to Limit Resources by User
13.9. Editing Quotas
13.10. Removing Quotas
14. Event Notifications
14.1. Configuring Event Notifications
14.2. Parameters for event notifications in notifier.conf
14.3. Canceling Event Notifications
15. Updating the Red Hat Enterprise Virtualization Environment
15.1. Upgrades between Minor Releases
15.2. Upgrading to Red Hat Enterprise Virtualization 3.1
16. Reports, History Database Reports, and Dashboards
16.1. Reports
16.2. History Database Reports
16.3. Dashboards
A. Firewalls
A.1. Red Hat Enterprise Virtualization Manager Firewall Requirements
A.2. Virtualization Host Firewall Requirements
A.3. Directory Server Firewall Requirements
A.4. Database Server Firewall Requirements
B. VDSM and Hooks
B.1. VDSM
B.2. VDSM Hooks
B.3. Extending VDSM with Hooks
B.4. Supported VDSM Events
B.5. The VDSM Hook Environment
B.6. The VDSM Hook Domain XML Object
B.7. Defining Virtual Machine Custom Properties
B.8. Setting Virtual Machine Custom Properties
B.9. Evaluating Virtual Machine Custom Properties in a VDSM Hook
B.10. Using the VDSM Hooking Module
B.11. VDSM Hook Execution
B.12. VDSM Hook Return Codes
B.13. VDSM Hook Examples
C. Utilities
C.1. Managing Domains with the Domain Management Tool
C.2. Editing the Configuration of the Red Hat Virtualization Manager with the Configuration Tool
C.3. Uploading Virtual Machine Images with the Image Uploader Tool
C.4. Editing USB Filters with the USB Filter Editor
C.5. Collecting Logs with the Log Collector Tool
C.6. Uploading ISO Files with the ISO Uploader Tool
C.7. Guest Drivers and Agents
D. Backups
D.1. Backing Up the Engine Database Using the backup.sh Script
D.2. Restoring the Engine Database Using the restore.sh Script
D.3. Restoring Red Hat Enterprise Virtualization Manager Configuration Files
D.4. Backing Up and Restoring Manager Configuration Files
E. Using Search, Bookmarks, and Tags to Find Your Way Around
E.1. Search
E.2. Bookmarks
E.3. Tags
F. Revision History