Step 1a: Preliminary Requirements for CentOS/RHEL/SL

Depending on how you configured your CentOS Distro at install time you may need to install extra packages:

EPEL Requirements

You need to install this repo in order to access certain packages that are required by Baruwa.

rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm

Run the following command to install the required packages.

# install the necessary tools compiling
yum install gcc git gcc-c++ svn curl patch -y

System Libraries

You will also need to make sure certain system libraries are installed. Running the following command will install any libraries that are missing.

# install the necessary libraries for compiling
yum install install libxml2-devel libxslt-devel Cython postgresql-devel \
    freetype-devel libjpeg-devel zlib-devel openldap-devel openssl-devel swig \
    cracklib-devel GeoIP-devel mysql-devel perl-CPAN make -y

NOTE: You need to install libmemcached from source as the version shipped in the repositories is too old, You need atleast version 0.32 or newer

Python Requirements

Baruwa supports Python 2.x versions 2.6 and up. CentOS/RHEL 6.x ships with Python 2.6, so you should be OK with the system default as a base for your operations.

Now you can proceed with Step 2: Installing Setuptools.

Step 1b: Preliminary Requirements for Debian/Ubuntu

You have to install the required tools and python libraries.

# install the necessary tools compiling
sudo apt-get install gcc g++ git subversion curl patch

# install the necessary libraries for compiling
sudo apt-get install libjpeg62-dev libxml2-dev libxslt1-dev cython \
     libpq-dev libfreetype6-dev libldap2-dev libssl-dev \
     swig libcrack2-dev libmemcached-dev libgeoip-dev \
     python-dev libsasl2-dev libmysqlclient-dev -y

Now you can proceed with Step 2: Installing Setuptools.

Step 1c: Preliminary Requirements for FreeBSD

TODO

Now you can proceed with installing Setuptools and Virtualenv as below.

Step 2: Installing Setuptools

The Python setuptools package is what we’ll use to automate the rest of the installation of Python packages.

If you’re using a package manager to handle your Python installation, you can use your package manager to install setuptools (0.6c9 or higher), like so:

CentOS/RHEL/SL:

yum install python-setuptools -y

Debian/Ubuntu:

sudo apt-get install python-setuptools -y

FreeBSD:

pkg_add py-setuptools

Others, in the main Baruwa package directory, there is an install script to help get setuptools installed for you.

# Run the setuptools install script in your Baruwa directory:
sudo python ez_setup.py

Step 3: Installing Virtualenv

First, check if you have virtualenv installed:

# Check if you have virtualenv installed:
python -c 'import virtualenv'

If you get no error, virtualenv is already installed. You can skip the rest of this step and proceed to Community Edition installation;

If you get an error like the following, you’ll need to install virtualenv:

Traceback (most recent call last):
  File "<string>", line 1, in <module>
ImportError: No module named virtualenv

If you’re using a package manager to handle your Python installation, you can use your package manager to install virtualenv, like so:

CentOS/RHEL/SL:

yum install python-virtualenv -y

Debian/Ubuntu:

sudo apt-get install python-virtualenv -y

FreeBSD:

cd /usr/ports/devel/py-virtualenv && make install clean

Others, you can get setuptools to automatically install virtualenv for you:

# Install virtualenv via setuptools:
sudo easy_install virtualenv

Proceed to Community Edition installation