한국어 English (US) Français 日本語 Português
Login/Register
 
 
Back to top
 
Other links
 
  1. Persistent Support
  2. Convirture Product Manuals
  3. Convirt Manuals
 
 

Download, Install & Set Up ConVirt 1.1

Setting up the ConVirt 1.1 environment involves:

  • Installing ConVirt software on at least one computer.
  • Preparing each Managed Server to be managed by ConVirt. If ConVirt is only used to manage virtual machines on the local computer, you can skip this step.
  • Starting ConVirt and discovering the managed servers you have prepared.

( 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:

  • Identify the type of configuration scenario you want to support:
    • Basic configuration in which the Xen or KVM virtualization platform is on the local computer where ConVirt is installed.
    • Advanced configuration in which one ConVirt Workstation manages virtual machines running on one or more remote servers.
  • Check whether the host computer where you plan to install ConVirt is a certified Linux platform. ConVirt can be installed and run on most Linux platforms, but is only tested and certified on a subset of the Linux platforms available. Check out the following.
  • If you plan to manage virtual machines on the local ConVirt Workstation, you should also verify that computers include a supported version of Xen hypervisor (Xen) or a Kernel-based Virtual Machine (KVM).
  • Verify the ConVirt Workstation has X server installed to enable it to display the ConVirt console.
  • Verify the ConVirt Workstation can connect to its remote managed servers using SSH.
  • Check that any remote computer where you plan to manage virtual machines includes a supported version of Xen hypervisor (Xen) or the Kernel-based Virtual Machine (KVM).
  • If you are upgrading from ConVirt 1.0, please backup the convirt.conf file as well as the image store. These are usually located at /etc/convirt.conf and /var/cache/convirt/image_store respectively. Once you install new version, you can replace these files back.
  • Note : After installation, check out patches page and apply any relevant patches published over there.
  • On Ubuntu 9.04, the following packages are required by not dependent on the convirt package. This may apply to other platforms as well 
  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:

  • Log on or switch to the root user.
  • Change to the yum.repos.d directory.
  • Get the ConVirt repository definition from Convirture.
  • Run the install command.
  • Start ConVirt.

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:

  • Log on or switch to the root user.
  • Get the ConVirt repository definition from Convirture.
  • Run the install command.
  • Start ConVirt.

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:

  • Log on or switch to the root user.
  • Change to the /tmp directory.
  • Get the packaging key for the ConVirt repository from Convirture.
  • Install the key.
  • Change to the /etc/source.list.d directory.
  • Get the repository for ConVirt from Convirture.
  • Run the install commands.
  • Start ConVirt.

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/debian_5x_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:

  • Log on or switch to the root user.
  • Change to the /tmp directory.
  • Get the packaging key for the ConVirt repository from Convirture.
  • Install the key.
  • Change to the /etc/source.list.d directory.
  • Get the repository for ConVirt from Convirture.
  • Run the install commands.
  • Start ConVirt.

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/ubuntu_8x_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/ubuntu_9x_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 ConVirt package (.rpm, .deb or tarball)
  • Download and install required dependencies
  • Install and perform post install steps for ConVirt
  • Start ConVirt

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.

  • python-paramiko and socat
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)


  • Check and install other required packages:
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

  • Run the appropriate command to install the package.

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
  • Check and patch paramiko,

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
  • Run convirt-tool for KVM

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.

  • Install (if necessary) and configure Xen (3.0.4 or higher) or KVM (kvm-70 or higher) on the managed server. Note: chances are your linux distribution already includes either Xen or KVM. Almost all modern distributions do.
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.
  • Install required dependencies
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
  • From your ConVirt workstation (the machine where you installed ConVirt), verify that you can log on to the managed server using ssh.
  • Download the convirture-tools tar ball from: 
 http://www.convirture.com/downloads/convirture-tools/1.1/
  • Extract the contents of the archive into a directory. For example: 
 tar -xzf convirture-tools-1.1.tar.gz
  • Apply the patches for convirt-tool published on here
  • Change to the <install_dir>/convirture-tools/install/managed_server/scripts directory, then use the convirt-tool command to check or configure the managed server. You will need to login as root user.

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,

  • Start ConVirt
  • Select the Server Pool to which you'd like to add the new managed server. For example : QA Pool
  • Right mouse click to get to the context menu and select 'Add Server'.
  • Select the virtualization platform.
  • Provide the IP address or hostname of the managed server prepared in the previous section. Also provide ssh credentials and press ok.

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.

  • You may need to install tunctl, if it is not included in your distribution.
  • You should set the name of the bridge as br0 instead of switch.
  • You should remove the /sbin/sudo as the ConVirt-generated qemu command line is not compatible with the use of sudo.

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.

 
Created By : Administrator -

댓글