Parallels Virtual Automation
6.1
Installation Guide for Windows
April 08, 2014
Copyright © 1999-2014 Parallels IP Holdings GmbH and its affiliates. All rights reserved.
Parallels IP Holdings GmbH.
c/o Parallels International GmbH.
Parallels International GmbH
Vordergasse 49
CH8200 Schaffhausen
Switzerland
Tel: + 41 526320 411
Fax: + 41 52672 2010
www.parallels.com
Copyright © 1999-2014 Parallels IP Holdings GmbH and its affiliates. All rights reserved.
This product is protected by United States and international copyright laws. The product’s underlying technology,
patents, and trademarks are listed at http://www.parallels.com/trademarks.
Microsoft, Windows, Windows Server, Windows NT, Windows Vista, and MS-DOS are registered trademarks of Microsoft
Corporation.
Apple, Mac, the Mac logo, Mac OS, iPad, iPhone, iPod touch, FaceTime HD camera and iSight are trademarks of Apple
Inc., registered in the US and other countries.
Linux is a registered trademark of Linus Torvalds.
All other marks and names mentioned herein may be trademarks of their respective owners.
Contents
Introduction ............................................................................................................... 4
About This Guide ............................................................................................................ 4
Organization of This Guide .......................................................................................................4
Documentation Conventions ....................................................................................................5
Getting Help .................................................................................................................... 5
Feedback ........................................................................................................................ 6
Parallels Virtual Automation Overview ...................................................................... 7
Parallels Virtual Automation Components ......................................................................... 7
Planning Your Parallels Virtual Automation Management System ...................................... 9
Parallels Licensing Policy ............................................................................................... 12
Parallels Virtual Automation System Requirements ............................................... 13
Hardware Requirements ................................................................................................ 13
Software Requirements ................................................................................................. 14
Installing Parallels Virtual Automation .................................................................... 15
Attended Installation ...................................................................................................... 15
Configuring Installation Settings ............................................................................................. 16
Unattended Installation .................................................................................................. 17
Installer Options ..................................................................................................................... 18
Installing Parallels Virtual Automation in Containers ............................................. 19
Uninstalling Parallels Virtual Automation ................................................................ 20
Glossary ................................................................................................................... 21
Index ........................................................................................................................ 23
Feedback ............................................................................................................... 6
C
HAPTER
1
Introduction
Parallels Virtual Automation is a flexible and easy-to-use administration tool designed for managing
physical servers with Parallels Virtuozzo Containers, Parallels Server Bare Metal, and Parallels
Cloud Server. With Parallels Virtual Automation, you can create groups of physical servers and
perform both collective and individual administration operations on these groups. Moreover, you
can also manage the virtual environments residing on the registered physical servers: their
productivity and resources, system tasks and processes, configuration, and much more. To work
with the registered physical servers and their virtual environments, you will need a standard Web
browser running on any platform.
You can read more about Parallels Virtual Automation and its functionality in the Parallels Virtual
Automation Administrator's Guide.
In This Chapter
About This Guide ................................................................................................... 4
Getting Help ........................................................................................................... 5
About This Guide
This guide is aimed at a wide range of users who are new to Parallels Virtual Automation or just
want to make sure they are doing everything right.
The present document is just as easy to use, as the product itself. However, we also provide
complete information about the structure and peculiarities of the guide in the following topics.
Organization of This Guide
The structure of the present guide is quite transparent and consists of the following elements:
• Preface (p. 4) provides basic information about the product and this guide.
• PVA Overview (p. 7) describes the basics of the Parallels Virtual Automation infrastructure
concept and explains the PVA components structure.
• PVA System Requirements (p. 13) provides information about the system requirements your
physical servers should meet to ensure successful installation.
• Installation Methods (p. 15) describes different installation methods.
Introduction
• Attended Installation describes how to manually start and perform the installation.
Preformatted
Saves parameters for Container 101
Preformatted Bold
# rpm -V virtuozzo-release
• Unattended Installation (p. 17) describes how to automatically install Parallels Virtual
Automation.
• Installing Parallels Virtual Automation in Containers instructs you how to install Parallels
Virtual Automation in Containers.
• Uninstalling Parallels Virtual Automation instructs you how to uninstall the product or its
components from a given computer.
Documentation Conventions
Before you start using this guide, it is important to understand the documentation conventions used
in it.
Formatting conventions used in this guide:
Font Meaning Example
Special Bold
Italics
Monospace
Key+Key Key combinations. Ctrl+P, Alt+F4
Selectable entities such as menu
options, buttons, or list items.
Titles of chapters, sections and
subsections.
Important points, terms, guide titles,
command variables.
Names of commands, files, and
directories.
On-screen console output in
command line sessions, source
code.
What you type as contrasted with onscreen console output.
Go to the Resources tab.
Read the Basic Administration chapter.
These are the so-called EZ templates.
To destroy a Container, type vzctl destroy
CT_ID.
Use vzctl start to start a Container.
Besides the formatting conventions, you should also know about the common document structure
shared by all guides for Parallels products: chapters consist of sections, which, in turn, consist of
subsections. For example, About This Guide is a section, and Documentation Conventions is a
subsection.
Getting Help
Parallels Virtual Automation offers several options for accessing necessary information:
5
Introduction
Parallels Virtual Automation Documentation
• Parallels Virtual Automation Administrator's Guide. Contains extensive information about
Parallels Virtual Automation, its usage, and troubleshooting. To access the PDF version of
the document, go to the Support link in the left pane and then click the Downloads pane.
You can download any document of the Parallels Virtual Automation documentation bundle
from the Parallels website.
• Parallels Virtual Automation Installation Guides for Linux/Bare Metal and Windows. Contain
extensive information on system requirements for physical computers as well as instructions
on how to install Parallels Virtual Automation on such computers.
• Getting Started With Parallels Virtual Automation. Contains the basic information how to
install, launch, and manage Parallels Virtual Automation.
• Parallels Power Panel User's Guide. Contains extensive information about Parallels Power
Panel.
• Parallels Virtual Automation Agent XML API Reference. A complete reference on all Parallels
Virtual Automation configuration files and physical server command-line utilities.
The documentation is available for download at
http://www.parallels.com/products/pva/documents/.
Parallels Knowledgebase
Visit http://kb.parallels.com/ for helpful articles on Parallels Virtual Automation, Parallels Virtuozzo
Containers, Parallels Server Bare Metal, and Parallels Cloud Server.
Feedback
If you want to report typos, share comments, suggestions or ideas on improving this guide, please
use the Parallels documentation feedback page at http://www.parallels.com/en/support/usersdoc/.
6
Parallels Licensing Policy ........................................................................................ 12
it. Thus, you are able to interact with the remote
C
HAPTER
2
Parallels Virtual Automation Overview
With Parallels Virtual Automation, you can easily deploy an effectively functioning virtual
infrastructure that can help you greatly reduce costs as well as save time and resources. While
Parallels software virtualization products enable you to create complex formations of virtual
environments, you may find it difficult to manage such formations using different management
tools. Being a universal management solution, Parallels Virtual Automation can handle this
challenging task with ease.
The PVA Management Server component can be used to manage servers running Parallels
Virtuozzo Containers for Linux 4.0, 4.6 and 4.7, Parallels Virtuozzo Containers for Windows 4.6,
Parallels Containers for Windows 6.0, Parallels Server Bare Metal 5.0, and Parallels Cloud Server
6.0.
Parallels Virtual Automation enables you to manage complex groups of virtual environments, as well
as single Containers and virtual machines. Using Parallels Virtual Automation, you can organize
physical servers and virtual environments into groups, schedule backups and other tasks, start,
stop, and configure virtual environments, and much more. For more details about Parallels Virtual
Automation functionality, see the Parallels Virtual Automation Administrator's Guide.
In This Chapter
Parallels Virtual Automation Components ................................................................ 7
Planning Your Parallels Virtual Automation Management System ............................. 9
Parallels Virtual Automation Components
Before you start installing Parallels Virtual Automation, you should learn about its components and
their role in the management process. Parallels Virtual Automation consists of several components
and an auxiliary tool. The main Parallels Virtual Automation components are:
Component Where to Install Description
PVA Management Server
On any clean physical server
without any software virtualization
technology, or on a Container.*
The physical server with PVA
Management Server component
installed is called Master Server.
This component ensures the communication
between the slave physical servers and their
virtual environments.
PVA Control Center
It is a part of the PVA Management Server
component and is always installed together with
Parallels Virtual Automation Overview
physical servers and have means to observe your
virtual infrastructure.
It is the PVA front-end that you see in the
browser window after logging in to Parallels
Virtual Automation. When talking about the
Parallels Virtual Automation interface, we are
actually talking about the Control Center
interface.
PVA Agent for Parallels Server
PVA Agent for Virtuozzo
SNMP
Parallels Power Panel
On a dedicated physical server that
has Parallels Server Bare Metal
installed.
Such server is also called a Slave
Server.
On a dedicated physical server that
has either of the following software
installed:
Parallels Virtuozzo Containers
for Linux, or
Parallels Virtuozzo Containers
for Windows.
Such server is also called a Slave
Server.
On a dedicated physical server that
has Parallels Virtuozzo Containers
for Windows/Linux installed. Such
server is also called a Slave Server.
On a dedicated physical server
together with the PVA Agent
component (PVA Agent for
Virtuozzo or for Parallels Server).
The component ensures the interaction between
this physical server, the Master Server and your
client computer. Without this component, a
physical server cannot be registered in Master
Server.
This component ensures the interaction between
this physical server, the Master Server and your
client physical computer. Without this
component, a physical server cannot be
registered in Master Server.
The PVA Agent for Virtuozzo on Windows
physical servers includes the SNMP protocol
distributive that is installed alongside with the
Agent. On Linux physical servers, SNMP should
be installed separately before the Agent
component installation.
An auxiliary tool designed for managing a single
virtual machine or a single Container. It can be
installed only together with the PVA Agent
component.
* The PVA Management Server component cannot be installed directly on a Parallels Server Bare
Metal physical server due to the virtualization software already installed on this server. The
workaround solution is to create a Container on the PSBM physical server and to launch the PVA
installation there. A Container is free from any virtualization technologies, so you can easily install
PVA Management Server on it. To ensure a successful installation, the Container should be created
on the basis of the ve-vswap.2048MB.conf-sample template.
8
Note: During the Parallels Power Panel
installation, an auxiliary Service
Container 1 is created. It ensures proper
Parallels Power Panel functioning.
SOAP
The Soap Agent part is installed alongside with
the Power Panel component. Rejecting Power
Panel installation, you will not be able to manage
virtual environments via SOAP.
Parallels Virtual Automation Overview
The PVA Management Server component cannot be as well installed on a dedicated Mac, Linux, or
Windows-based physical server. However, creating a virtual environment on this physical server
allows you to launch the PVA Management Server component installation inside it. Create a
Container on Linux or Windows server, and a virtual machine with any OS on a Mac server.
For instructions on creating Containers, refer to the Parallels Virtuozzo Containers for Linux User
Guide or Parallels Virtuozzo Containers for Windows User Guide.
For instructions on creating virtual machines, refer to the Parallels Server Bare Metal
documentation.
Planning Your Parallels Virtual Automation Management System
From the previous section, you know what components Parallels Virtual Automation consists of.
Now you can pass on to creating your own management system.
Please pay attention to the following scheme. This is an example of a possible Parallels Virtual
Automation management system. Of course, your management system may vary from the scheme
below but nevertheless it will help you to understand the Parallels Virtual Automation basics more
clearly.
9
Parallels Virtual Automation Overview
So, let us analyze the Parallels Virtual Automation management system displayed on the scheme. It
consists of:
Master Server
Master Server is a physical server where all other subordinate physical servers are registered. On
this physical server, PVA Management Server component should be installed.
Note: PVA Management Server component is always installed together with the PVA Control Center
component.
What physical server can be used as a Master Server?
• A clean physical server with Linux, Windows or Mac operating system. This server should have
no Parallels virtualization software installed. PVA Management Server component is installed
directly on the physical server.
10
Parallels Virtual Automation Overview
• A Linux or Windows-based physical server running Parallels Virtuozzo Containers or a
Windows-based server running Parallels Containers for Windows. As such physical server
already has a software virtualization technology installed, you cannot install PVA Management
Server component directly on it. First, you should create a Container by means of Parallels
Virtuozzo Containers software and then install the PVA component inside the Container. In this
case, the physical server can act as a Master Server and a Slave Server at the same time.
• A bare-metal physical server with Parallels Server Bare Metal or Parallels Cloud Server installed.
This case is much alike the previous one. First, you should create a Container and then install
the PVA Management Server component into it. The physical server also can act as a Master
Server and a Slave Server at the same time.
Slave Server
A Slave Server is a dedicated physical server that has one of the Parallels software virtual
technologies installed. On this physical server, PVA Agent for Parallels Server and/or PVA Agent for
Virtuozzo should be installed depending on the software virtualization technology the server already
has. For example, a bare metal computer with Parallels Server Bare Metal allows you to install both
PVA Agents, thus to have Containers and virtual machines on one and the same physical server.
A Slave Server should also have the Power Panel component installed. This ensures that a
customer can manage the private virtual environment residing on the hosting physical server.
Note: PVA Agent component is installed by default together with the PVA Power Panel component.
What physical servers can be used as a Slave Server?
• Linux-based physical servers running Parallels Virtuozzo Containers for Linux 4.7.
• Windows-based physical servers running Parallels Virtuozzo Containers for Windows 4.6 or
Parallels Containers for Windows 6.0.
• Bare-metal physical servers running Parallels Server Bare Metal 5.0 or Parallels Cloud Server
6.0.
Note: After you install all the necessary components on the physical servers, you should register
your slave servers on Master Server. Registering a slave server is a management operation. You
can learn about management operations from the Parallels Virtual Automation Administration
Guide.
Customer's Computer
Any computer can serve as a customer's computer provided that it has a stable network
connection and a Web browser supported by Parallels Virtual Automation. A customer's computer
does not need any PVA components to be installed. The connection between the customer's
computer and the PVA Slave Server's virtual environments is provided by the Parallels Power Panel
installed on the Slave server.
11
Parallels Virtual Automation Overview
Note: Parallels Power Panel allows working with a single private computer and does not provide access
to the whole Slave Server or PVA management system.
Parallels Licensing Policy
Parallels team provides flexible and easy-to-use solutions, which also applies to its licensing policy.
As such, Parallels Virtual Automation doesn't have a license of its own, and you can download and
install it without accepting a license agreement. Instead, Parallels sticks to the per-server licensing
policy, which means that you can use Parallels Virtual Automation only if you have a valid license for
the Parallels virtualization software installed on your computer.
12
Software Requirements .......................................................................................... 14
C
HAPTER
3
Parallels Virtual Automation System Requirements
This subsection focuses on the software and hardware requirements for the Windows-based
physical servers where you are going to install the Parallels Virtual Automation components. The
modern Parallels software virtualization technologies allow you to effectively use Windows-based
computers in the Parallels Virtual Automation management system. A Windows-based computer
can take various roles in the management system:
• It can be used as a Master Server (p. 9) and should meet the system requirements for the PVA
Management Server component.
• It can be used as a Slave Server (p. 9) and should meet the requirements for the PVA Agent
for Virtuozzo component.
• It can be used as a Client computer (p. 9) and doesn't need any Parallels Virtual Automation
component to be installed, but still has some software requirements.
This subsection focuses on the software and hardware requirements for the Windows-based
physical computers where you are going to install the Parallels Virtual Automation components.
In This Chapter
Hardware Requirements ......................................................................................... 13
Hardware Requirements
The basic hardware requirements for both Master and Slave servers are as follows:
• an Intel Celeron or AMD Athlon CPU or better;
• at least 1 GB of RAM;
• at least 15 GB of free disk space;
• a network card.
Parallels Virtual Automation System Requirements
Software Requirements
A Windows-based Master Server must have:
• No software virtualization technology installed. (One exception is Parallels Virtuozzo Containers
or Parallels Containers for Windows. In this case, you will need to create a Container and install
PVA there. For instructions on how to create a Container, see the Parallels Containers for
Windows User's Guide.)
• One of the following operating systems:
• Windows Server 2008 R2 SP1,
• Windows Server 2012.
• An Internet connection or installed Microsoft .NET Framework 3.5.
If a Windows-based computer serves as a Slave Server where virtual environments will be stored
and managed, then Parallels Virtual Automation will call for more complex requirements, as the
creation and management of containers and virtual machines demand more complex software
resources. So, in choosing an appropriate Windows-based computer, you should be guided by the
Parallels Virtuozzo Containers system requirements. For the detailed and more concrete information
on the requirements, see Parallels Virtuozzo Containers for Linux and Parallels Virtuozzo Containers
for Windows user guides.
Note: The software requirements above serve as additional requirements and are true for the proper
functioning of Parallels Virtual Automation only. The correct work of Containers is guaranteed by adhering
to the system requirements of the Parallels Virtuozzo Containers product.
If a computer serves as a Client Server (p. 9), it should have one of the supported Web-browser
clients:
• Internet Explorer 9.x, 10.x, 11.x,
• Firefox 26.x or newer,
• Safari 5.x or newer,
• Chrome 31.x and newer.
Note: Other browsers will likely work as well. However, only those listed above have been tested for
compatibility with Parallels Virtual Automation.
14
Unattended Installation ........................................................................................... 17
C
HAPTER
4
Installing Parallels Virtual Automation
You can install Parallels Virtual Automation in either the attended or unattended mode using
autoinstaller or installation archive.
• The autoinstaller is a lightweight executable file that downloads necessary components of
Parallels Virtual Automation from a remote repository based on the environment it is run in.
Parallel's public repository is used by default.
• The installation archive contains all Parallels Virtual Automation components, but you still need
to download different archives for Master and Slave server roles.
In This Chapter
Attended Installation ............................................................................................... 15
Attended Installation
To run an attended installation of Parallels Virtual Automation on your Windows-based physical
server, do the following:
1 Download the autoinstaller or installation archive from the download page to the target physical
server.
2 If you are installing Parallels Virtual Automation from the archive, unpack it.
3 Start the installer by double-clicking it.
In the Welcome window, click Next to proceed with the installation.
4 In the Choose Setup Type window, choose the installation type. The components for the
default installation may differ. This depends upon whether the physical server is clean or already
has any software virtualization technology installed on it.
Installing Parallels Virtual Automation
• Choose Default installation to automatically install the necessary components.
• If you want to change the list of components to be installed or change the destination folder,
choose Custom installation.
5 Click Next to start the installation.
Configuring Installation Settings
In the PVA setup window, you should set up the following parameters
16
Installing Parallels Virtual Automation
• Repository URL: the URL of the server storing the repository with the product installation files.
• Repository login: the user name to log in to the repository.
• Repository password: the password of the user specified in the Repository login field.
• Download directory: the directory on your server where the installation files will be
downloaded on.
To edit the settings, click the text field, type or edit the text, and click OK.
Unattended Installation
You can install Parallels Virtual Automation in the unattended mode using either autoinstaller or
installation archive. To do that, you will need to specify components to install as described below.
The command you should run to install PVA Agent for Virtuozzo on a Windows-based computer
running Parallels Virtuozzo Containers is the following:
C:\Users\Administrator>pva-setup --install -c "PVA Agent for Virtuozzo"
If you want to install the PVA Agent for Virtuozzo and PVA Power Panel components, execute the
following command:
C:\Users\Administrator>pva-setup --install -c "PVA Agent for Virtuozzo, PVA Power
Panel"
17
Installing Parallels Virtual Automation
To install only the PVA Management Server component, execute the following command:
local
-u
C:\Users\Administrator>pva-setup --install -c "PVA Management Server"
Installer Options
The installer has a set of options you can use to tailor installation to your needs. All available options
are provided in the table below.
Option Description
-r, --repository <repo_address|local> Specifies the remote repository to download the required files from.
Use
, if you have already downloaded the installation files.
-d, --downloaddir <dir>
-l,--logdir <dir>
--os_distributive_path <path>
--install [-c <components>] [-u <version>]
<components>
<version>
--list
--uninstall
-h, --help
-v, --verbose
Specifies the local directory, to which the installation files will be
downloaded during installation.
Specifies the path to the local folder where the installation logs will be
stored.
Specifies the path to the distribution set of your operating system.
Installs (-c) the specified Parallels Virtual Automation components or
updates (
A quoted, comma-separated list of components to install or update.
The version to which to update Parallels Virtual Automation.
) Parallels Virtual Automation to the specified version.
Note: The update mechanism is still in development.
Prints a list of updates and components you can install on the given
computer.
Uninstalls Parallels Virtual Automation and all its components.
Shows installer help.
Prints verbose output.
18
C
HAPTER
5
Installing Parallels Virtual Automation in Containers
You will need to install PVA on a Container in the following situation: you have a physical server with
a software virtualization technology installed (a Parallels Server Bare Metal or Parallels Cloud Server
physical server or Windows/Linux-based physical server with Parallels Virtuozzo Containers
software installed). It means that the physical server already has a software virtualization
technology, and you cannot convert this server into a Master Server. But you can create a
Container, that has no software virtualization technology, and use this Container to install the
Management Server component of PVA, thus you convert the whole physical server into a Master
Server.
C
HAPTER
6
Uninstalling Parallels Virtual Automation
You can uninstall any of the Parallels Virtual Automation components from a given computer using
either the GUI wizard, or the command-line options.
To uninstall Parallels Virtual Automation with the wizard, do the following:
1 Log in as Administrator.
2 Go down to the installation files directory and open pva-setup-gui.exe to start the
installation wizard.
3 In the Welcome window, click Next to proceed to the next step.
4 In the next window, select Uninstall and click Next.
To uninstall Parallels Virtual Automation using command line, do the following:
1 Log in as Administrator.
2 Go down to the installation files directory and enter the following:
C:\Users\Administrator>pva-setup --uninstall
Note: Unlike the install command, the uninstall command doesn't require any options and
uninstalls all PVA components from the given computer.
C
HAPTER
7
Glossary
Container is a virtual private server, which is functionally identical to an isolated standalone server,
with its own IP addresses, processes, files, its own users database, its own configuration files,
applications, system libraries, and so on. Containers on one and the same physical server (or
Hardware node) share one OS kernel. However, they are isolated from each other.
EZ template is built up from separate chunks of code that are uploaded from the web every time
you pick an EZ template to install in the Container. This means, that an EZ template is not an
independent package but rather a unit containing all the necessary information about repositories
from where the necessary packages will be uploaded to the physical server.
Hardware Node is a physical server where the Parallels software is installed for hosting virtual
environments. The Hardware Node term is used in the product interface, while in technical
documentation, you will find the term physical server.
Master Server is a physical server where the Parallels Virtual Automation Management Server
component is installed.
Parallels Virtual Automation is a tool designed for managing the physical server and all virtual
environments residing on them with the help of a standard Web browser on any platform.
Parallels Power Panel is an easy-to-use web-based tool designed for administering a single
personal virtual environment. With Power Panel, a user with administrative access to a virtual
environment can easily perform many critical management tasks, while not requiring access rights
to the physical server.
Parallels Virtuozzo Containers (or Parallels Containers) is a complete server automation and
software virtualization solution allowing you to create multiple isolated Containers on a single
physical server to share hardware, licenses, and management effort with maximum efficiency.
Software Virtualization, in Parallels Virtual Automation documentation, stands for the Parallels
software virtualization products, such as Parallels Virtuozzo Containers for Linux and Windows,
Parallels Server Bare Metal, Parallels Cloud Server, etc.
Parallels Containers and Parallels Server license is a special license that you should install on
the Hardware Node to be able to start using the virtual environments software. Every Hardware
Node shall have its own unique Server license.
Virtual Machine is an emulation of a physical computer by means of Parallels Server virtualization
technology. It is functionally identical to an isolated standalone server. A virtual machine has its own
virtual hardware and requires an operating system to control its hardware. The installed operating
Glossary
system and its applications are isolated inside the virtual machine and share physical hardware
resources of the physical server where the virtual machine resides.
Virtual Environment is a generic name for virtual machines and Containers.
22
Index
Index
A
About This Guide - 4
Attended Installation - 15
C
Configuring Installation Settings - 16
D
Documentation Conventions - 5
F
Feedback - 6
G
Getting Help - 5
Glossary - 21
H
Hardware Requirements - 13
I
Installer Options - 18
Installing Parallels Virtual Automation - 15
Installing Parallels Virtual Automation in
Containers - 19
Introduction - 4
S
Software Requirements - 14
U
Unattended Installation - 17
Uninstalling Parallels Virtual Automation - 20
O
Organization of This Guide - 4
P
Parallels Licensing Policy - 12
Parallels Virtual Automation Components - 7
Parallels Virtual Automation Overview - 7
Parallels Virtual Automation System
Requirements - 13
Planning Your Parallels Virtual Automation
Management System - 9
Loading...