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 http://www.convirture.com/repos/definitions/rhel/5.x/convirt.repo

 For rhel 6.x
 wget --no-cache http://www.convirture.com/repos/definitions/rhel/6.x/convirt.repo

• 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 http://www.convirture.com/downloads/convirt/2.0.1/convirt-install-2.0.1.tar.gz
 wget --no-cache http://www.convirture.com/downloads/convirt/2.0.1/convirt-2.0.1.tar.gz
 wget --no-cache http://www.convirture.com/downloads/convirture-tools/2.0.1/convirture-tools-2.0.1.tar.gz

• 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
   innodb_buffer_pool_size=1G
   innodb_additional_mem_pool_size=20M

 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 

   CONVIRT_BASE=~ 

   To 

   CONVIRT_BASE=~/cms 

   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

   ./convirt-install/install/cms/scripts/setup_tg2

* 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)
  
  sqlalchemy.url=mysql://root:convirt@localhost:3306/convirt?charset=utf8

and then execute :

     ./convirt-install/install/cms/scripts/setup_convirt

     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 

• Point your browser at CMS : http://ip-address:8081/. The default credentials are admin/admin.

• Stop server once you are done.

 cd ~/convirt
 ./convirt-ctl stop

Continue

Continue with rest of the setup procedure here .