ConVirtMain Page | About | Help | FAQ | Special pages | Log in

Printable version | Disclaimers | Privacy policy

Installation

From ConVirt

Download, Install & Set Up ConVirt

Setting up the ConVirt 1.1 environment involves:

( For ConVirt 1.0 use instructions given here.)

To make the installation process as easy as possible, Convirture hosts a repository of ConVirt packages that include distribution-specific dependencies.

Contents


Before you begin

You should take the following steps to prepare for installing and using ConVirt:

  python-gtk2 python-glade2 python-vte

ConVirt Download and Installation

To set up ConVirt, you need get the appropriate repository for your operating environment distribution, then use a native package manager like yum or apt-get to download,check for dependencies and install the package. For specific instructions for your distribution, see one of the following sections:


CentOS/Red Hat Enterprise Linux 5.x

To install on CentOS or Red Hat Linux 5.x:

For example:

  cd /etc/yum.repos.d
  wget --no-cache http://www.convirture.com/repos/definitions/rhel/5.x/convirt.repo
  yum install convirt
  convirt

SUSE Enterprise Linux Server (SLES 10.x)

To install on SUSE Enterprise Linux Server 10.x:

For example:

  zypper sa http://www.convirture.com/repos/convirt/SLES/10.x convirt
  zypper sa http://www.convirture.com/repos/deps/SLES/10.x convirt-dep
  zypper install convirt
  convirt

For SLES 11 use :

zypper ar http://www.convirture.com/repos/convirt/SLES/10.x convirt
zypper ar http://www.convirture.com/repos/deps/SLES/10.x convirt-dep

Debian 5.0

To install on Debian Linux 5.0:

For example :

  cd /tmp
  wget --no-cache http://www.convirture.com/repos/convirture_packaging_pub_key
  apt-key add convirture_packaging_pub_key
  cd /etc/apt/sources.list.d
  wget --no-cache http://www.convirture.com/repos/definitions/debian/5.x/convirt.list
  apt-get update
  apt-get install convirt
  convirt

Note : If you have this machine (where you just installed ConVirt) already setup for Virtualization (KVM), you should run the convirt-tool to make necessary changes for managing this server as a localhost.

For example:

   /usr/share/convirt/install/managed_server/scripts/convirt-tool setup

Ubuntu 8.10 / 9.04

To install on Ubuntu 8.10/9.04:

For example Ubuntu 8.10:

  cd /tmp
  wget --no-cache http://www.convirture.com/repos/convirture_packaging_pub_key
  apt-key add convirture_packaging_pub_key
  cd /etc/apt/sources.list.d
  wget --no-cache http://www.convirture.com/repos/definitions/ubuntu/8.x/convirt.list
  apt-get update
  apt-get install convirt
  convirt

For example Ubnutu 9.04:

  cd /tmp
  wget --no-cache http://www.convirture.com/repos/convirture_packaging_pub_key
  apt-key add convirture_packaging_pub_key
  cd /etc/apt/sources.list.d
  wget --no-cache http://www.convirture.com/repos/definitions/ubuntu/9.x/convirt.list
  apt-get update
  apt-get install convirt
  convirt

Note : If you have this machine (where you just installed ConVirt) already setup for Virtualization (KVM), you should run the convirt-tool to make necessary changes for managing this server as a localhost.

For example:

   /usr/share/convirt/install/managed_server/scripts/convirt-tool setup

Other Linux distributions and Installation from the tarball

For other Linux distributions and versions, you can follow the steps given below.

Download the ConVirt package

Download the ConVirt software package from the Convirture Web site. For example, go to:

 http://www.convirture.com/downloads/convirt

Download and install the required dependencies

Convirt depends on a bunch of other packages. This section outlines detail about installing them. You will need to be a logged in as root to install them.

The python-paramiko along with socat are required to run ConVirt. The python-paramiko package itself depends on the python-crypto package so you would have to install that first.
To install them on Debian or Ubuntu, use the following command:
 apt-get install python-paramiko socat
For other platforms try the native package manager (yum/yast etc.) first. If the package is not available, download the install them from one of the following locations.
Note : Pick the right package for your distributions and architecture (32 bit or 64 bit)


The table below outlines required packages for various distributions. In most cases, they should be available in the distribution or can be installed using the native package manager, such as yum, apt-get, zypper, or yast2. If not, visit the dependencies area hosted by Convirture: Dependencies
Distributions with corresponding package dependencies
Distribution Packages
SUSE/SLES xen xen-tools xen-libs python xml python-gtk vte uml-utilities bridge-utils dnsmasq
Fedora/RHEL/CentOS xen pygtk2 vte vnc tunctl dnsmasq bridge-utils
Ubuntu ssh python-xen-3.3 libxen3 vncviewer uml-utilities dnsmasq bridge-utils
Debian ssh xen-utils vncviewer uml-utilties dnsmasq bridge-utils


Note If you are only managing the KVM virtualization platform, you can ignore all *xen* dependencies.

Install and perform the post install steps for ConVirt

For the .rpm file, run the following as root :

 rpm -Uvh convirt-1.1-1.fedora.noarch.rpm

For the .deb file, run as root :

 dpkg -i convirt-1.1_1_all.deb

For the compressed tarball file, run:

 tar -xzf convirt-1.1.tar.gz

For example, run the following command to check the version of paramiko installed:

 python -c 'import paramiko; print paramiko.__version__'

If the version returned is < 1.7.2, then you need to patch paramiko using following commands.

For the .rpm or .deb package, run as root:
 cd /usr/share/convirt/install/common/patches
 ./patch_paramiko
For tarball, run as root:
 cd <convirt_install_dir>/install/common/patches
 ./patch_paramiko

If you have this machine (where you just installed ConVirt) already setup for Virtualization (KVM), you should run the convirt-tool to make necessary changes for managing this server as a localhost.

For example:

   <convirt-install-directory>/install/managed_server/scripts/convirt-tool setup

Start ConVirt

For .rpm and .deb you can start ConVirt with superuser privileges :

 sudo convirt

or login as a root user and run

 convirt

For tarball :

 cd <convirt_install_dir> 
 ./ConVirt

Preparing Managed Servers

Before you start managing a remote server using ConVirt, you need to ensure that it's properly configured. This can be done easily in a few quick steps.

Here are some tips and pointers :
For Xen on CentOS/RHEL : Select the Virtualization option at the time of installation.
For Xen on SLES  : Select Xen Virtual Machine Host Server option. Here is a good link. Novell Doc
For KVM on Debian lenny/Ubuntu 8.10/9.04: apt-get install ssh kvm socat dnsmasq uml-utilities lvm2 should do the trick.
For Xen and KVM ConVirt 1.1 required dnsmasq and tunctl utilities for managing virtual networks on the managed server. The tunctl utility comes in tunctl package on Fedora/CentOS/RHEL while is part of uml-utilities<tt> package on rest of the linux distributions.
For KVM <tt>socat is required ( For rpms : rpm.pbone.net)
Here are few links that might be also be useful for finding dependencies. Dependencies, Virtualization KVM, KVM downloads
 http://www.convirture.com/downloads/convirture-tools/1.1/
 tar -xzf convirture-tools-1.1.tar.gz

For example:

  cd ./convirture-tools/install/managed_server/scripts
To view the usage message, run:
  ./convirt-tool -h
To validate the platform without making any changes, run:
  ./convirt-tool --detect_only setup
To configure the server, run:
  ./convirt-tool setup
For the Xen platform, running this command configures the Xend Server to listen on port 8006 and opens port 8002 for migration. The command also detects the default bridge and writes a summary of its operations to the /var/cache/convirt/server_info file.
For the KVM platform, the command detects the bridge and writes a summary of its operations to the /var/cache/convirt/server_info file. The convirt-tool version 1.1 also creates public bridge for KVM.
If you are using a firewall on Debian/Ubuntu you should verify that TCP port 8002 is open to allow migration (for both KVM and Xen), and TCP port 8006 is open in case of Xen to allow ConVirt to talk to the xend server.

Adding a Managed Server to ConVirt

Once the managed server is prepared,

The new managed server would show up under the Server Pool. Now you can use ConVirt to create and manage complete life cycle of Virtual Machines on this server. Refer to documentation for more details.

Public Bridge setup for KVM

Note : convirt-tool 1.1 already creates public bridge and hence rest of the section can be ignored. After the convirt-tool setup is run, you should see a br0 bridge containing your physical interface.


Although setting up a bridge is optional, it is required if you want Virtual Machines to communicate with each other or to access services provided by VM from other machines.

The steps for setting up a public bridge are distribution-specific. You should consult the documentation for the distribution you are using. For example, see https://help.ubuntu.com/community/KVM/Networking for information about setting up the bridge on Ubuntu.

For more general instructions about setting up a bridge, see the steps described under "public bridge" section in http://www.linux-kvm.org/page/Networking under with the following caveats.

Once the bridge setup is done, run the convirt-tool again. This will set the bridge name in the /var/cache/convirt/server_info file.

To use the bridge, from ConVirt UI, you will select a VM, choose "Edit Settings", and set network_mode to tap in the Miscellaneous tab. You will also have to shutdown and start the VM again for this setting to take effect.

Retrieved from "http://www.convirture.com/wiki/index.php?title=Installation"

This page has been accessed 122,244 times. This page was last modified on 7 February 2012, at 19:38.


Find

Browse
Wiki Home
Installation
Documentation
HOWTOs
FAQ
Developer Resources
Forums
Blog
Website
Recent changes
Wiki Editing Help
Edit
View source
Editing help
This page
Discuss this page
New section
Printable version
Context
Page history
What links here
Related changes
My pages
Log in / create account
Special pages
New pages
File list
Statistics
More...