ConVirt 2.0 Setup for Fedora/RHEL/CentOS


Note These are instructions tested on RHEL/CentOS 5.4. 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 socat
  • Setup ConVirt repository
 cd /etc/yum.repos.d
 wget --no-cache
 For rhel 6.x
 wget --no-cache
  • 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.0.1.tar.gz

  • 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.0.1.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 .

Have more questions? Submit a request


Adding comment, please wait....

Provide Feedback on Article: