Editing User Guide/Preface

== About This Guide ==

This guide is meant to provide comprehensive information on OpenVZ — high-end server virtualization software for Linux-based computers. The issues discussed in this guide cover the necessary theoretical conceptions as well as practical aspects of working with OpenVZ. The guide will familiarize you with the way to create and administer ''containers'' (sometimes also called ''Virtual Environments'', or ''VEs'') on OpenVZ-based Hardware Nodes and to employ the command line interface for performing various tasks.

Familiarity with Red Hat Linux Operating System and certain Linux administrator’s skills are desirable for a person reading the guide. You can obtain some useful information regarding OS installation issues from http://www.redhat.com/docs/manuals/linux/.

== Who Should Read This Guide ==

The primary audience for this book is anyone responsible for administering one or more systems running OpenVZ. To fully understand the guide, you should have strong Linux system administration habits. Attending Linux system administration training courses might be helpful. Still, no more than superficial knowledge of Linux OS is required in order to comprehend the major OpenVZ notions and learn to perform the basic administrative operations.

== Organization of This Guide ==

Chapter 2, [[../OpenVZ Philosophy/]], is a must-read chapter that helps you grasp the general principles of OpenVZ operation. It provides an outline of OpenVZ architecture, of the way OpenVZ stores and uses configuration information, of the things you as administrator are supposed to perform, and the common way to perform them.

Chapter 3, [[../Installation and Preliminary Operations/]], dwells on all those things that must be done before you are able to begin the administration proper of OpenVZ. Among these things are a customized installation of Linux on a dedicated computer (Hardware Node, in OpenVZ terminology), OpenVZ installation, preparation of the Hardware Node for creating Virtual Private Servers on it, etc.

Chapter 4, [[../Operations on Virtual Private Servers/]], covers those operations that you may perform on a container as on a single entity: creating and deleting Virtual Private Servers, starting and stopping them, etc.

Chapter 5, [[../Managing Templates/]], shows you the way to handle OpenVZ templates properly – create and install templates and template updates on the Hardware Node, add them to and remove from containers, etc.

Chapter 6, [[../Managing Resources/]], zeroes in on configuring and monitoring the resource control parameters for different containers. These parameters comprise disk quotas, CPU and system resources. Common ways of optimizing your containers configurations are suggested at the end of the chapter.

Chapter 7, [[../Advanced Tasks/]], enumerates those tasks that are intended for advanced system administrators who would like to obtain deeper knowledge about OpenVZ capabilities.

Chapter 8, [[../Troubleshooting/]], suggests ways to resolve common inconveniences should they occur during your work with the OpenVZ software.

Chapter 9, [[../Reference/]], is a complete reference on all OpenVZ configuration files and Hardware Node command-line utilities. You should read this chapter if you do not understand a file format or looking for an explanation of a particular configuration option, if you need help for a particular command or looking for a command to perform a certain task.

== Documentation Conventions ==

Before you start using this guide, it is important to understand the documentation conventions used in it. For information on specialized terms used in the documentation, see the [[../Glossary/]] at the end of this document.

=== Typographical Conventions ===

The following kinds of formatting in the text identify special information.

{| class="wikitable"
!| Formatting convention || Type of information || Example
|-
| '''Bold'''
| Items you must select, such as menu options, command buttons, or items in a list.
| Go to the '''QoS''' tab.
|-
| ''Italics''
| Used to emphasize the importance of a point or to introduce a term.
| Such servers are called ''Hardware Nodes''.
|}

=== Shell Prompts in Command Examples ===

Command line examples throughout this guide presume that you are using the Bourne-again shell (bash). Whenever a command can be run as a regular user, we will display it with a dollar sign prompt. When a command is meant to be run as root, we will display it with a hash mark prompt:

{| class="wikitable"
| Ordinary user shell prompt || $
|-
| Root shell prompt || #
|}

=== General Conventions ===

Be aware of the following conventions used in this book. 

* Chapters in this guide are divided into sections, which, in turn, are subdivided into subsections. For example, Documentation Conventions is a section, and General Conventions is a subsection.

* When following steps or using examples, be sure to type double-quotes ("), left single-quotes (`), and right single-quotes (') exactly as shown.

* The key referred to as RETURN is labeled ENTER on some keyboards.

The root path usually includes the /bin, /sbin, /usr/bin and /usr/sbin directories, so the steps in this book show the commands in these directories without absolute path names. Steps that use commands in other, less common, directories show the absolute paths in the examples.

== Feedback ==

If you spot a typo in this guide, or if you have thought of a way to make this guide better, we would love to hear from you!

If you have a suggestion for improving the documentation (or any other relevant comments), try to be as specific as possible when formulating it. If you have found an error, please include the chapter/section/subsection name and some of the surrounding text so we can find it easily.

Please submit a report by e-mail to userdocs@openvz.org.