Back to top

ConVirt 2.0 Setup for Fedora/RHEL/CentOS

Note These are instructions tested on RHEL/CentOS RHEL 6. There might be slight variations on other distributions. We would appreciate your contribution in refining these instructions with distribution specific changes.

If you wish to create a virtual machine for installing ConVirt, use instructions here and then follow instructions below.


Installing and setting up ConVirt Management Server (CMS)

  • Login as root user.
  • Install wget
 yum install wget 
  • Setup ConVirt repository
 cd /etc/yum.repos.d
 wget --no-cache
 For rhel 6.x
 cd /etc/yum.repos.d
 wget --no-cache
  • Install socat
 yum install socat
  • Log in as a user account in which you wish to setup ConVirt management server. Lets call this CMS account. It is recommended not to use the root account for CMS installation.
  • Setup Proxy : If your organization has a proxy server to access internet, then make sure that you set the http_proxy variable as follows at the time of ConVirt installation and setup.
   export http_proxy="http://company-proxy-server:80" 
   NOTE The proxy port may be different. In this example, 80 is assumed. 
  • Download the packages from the Convirture website.
 wget --no-cache
 wget --no-cache
 wget --no-cache
  • Untar in the home directory. You will see the directory containing scripts to create TurboGerars2 (tg2) environment and ConVirt management server in the home directory.

 tar -xzf convirt-install-2.5.tar.gz
  • IMPORTANT INSTALL RELATED PATCH/CHANGE Due to change in some of the dependencies, we need to install specific version of virtualenv. To do so, please make the following change.
  In the following two files
  Change the line 
    $SUDO easy_install virtualenv 
    $SUDO easy_install virtualenv==1.11.6
   NOTE  Two equal-to signs before the version number.
  • Install dependencies either as root user or using sudo.
 cd convirt-install/install/cms/scripts/
 sudo ./install_dependencies 
 NOTE When prompted for mysql credentials for root, enter "convirt" (you can change this later.)
  • Setup innodb buffer and memory pool.
 In the mysql configuration file /etc/my.cnf under [mysqld] section. Please add the following two lines
 Restart mysqld
   /etc/init.d/mysqld restart

  • Install ConVirt. For this, log in as CMS user account.
* If required, setup Proxy again, as now you are logged in as CMS user account. (e.g. convirt)
   export http_proxy="http://company-proxy-server:80"
  • By default the CMS will get installed in the home directory like ~/convirt. If you wish it to be at any other location, please update CONVIRT_BASE varialbe in install/cms/scripts/install_config file.
   For example, change 
Now CMS will get installed under ~/cms/convirt

  • Untar the CMS tarball.
  source convirt-install/install/cms/scripts/install_config
  tar -xzf ./convirt-2.5.tar.gz -C $CONVIRT_BASE

* Setup TurboGears
* Setup ConVirt
Modify sqlalchemy.url in src/convirt/web/convirt/development.ini to reflect user and password for the mysql database.
  For example in the following url, username = root, password = convirt, server=localhost, database port = 3306 
  and database name is convirt (the one before '?' in the url)
and then execute :
     NOTE You would be prompted for password/passphrase for SSH identity for CMS server. You will be required to enter 
     the password/passphrase every time you start the ConVirt Management Server (CMS). You can choose to leave it blank.

Validating the CMS Setup

  • Start ConVirt Management Server
 cd ~/convirt  
 ./convirt-ctl start
NOTE You would be prompted for passphrase. Enter the same passphrase that you gave at the time of setting up ConVirt
  • If the firewall is enabled, configure it to allow TCP access to port 8081
 iptables -I INPUT -p tcp --dport 8081 -j ACCEPT
  • Find the IP address of the machine using,
 ifconfig eth0 
  • Stop server once you are done.
 cd ~/convirt
 ./convirt-ctl stop


Continue with rest of the setup procedure here .