Manual » Installation

You can install VerliHub in two different ways: from source or using binary package for your distribution.

Installation from source

Here you can find step-by-step procedure how to install VerliHub from source code.

Extract the source

First of all, you need to get the source for VerliHub from the home page of this site or from Sourceforge.net hosting site. Download the file and save it in a folder of your file system (for example your home folder or /root).

Then use the following command to extract all files:

tar zxvf verlihub-xxx.tar.gz

where xxx indicates the selected version of VerliHub. This will extract the source in your own folder.

Option -z will filter the archive through gzip, option -x will extract all files, option -v will list verbosely processed files and option -f will use specified archive file.

Dependencies installation

There are some required libraries and programs that need to be installed before you attempt to compile Verlihub. Each Linux distribution has its own package management system and we provide base steps to install all dependencies with package management system. These are the required dependencies:

Remember that some packages are required to compile Verlihub core. Other libraries are for plugins that get compiled with the core.

In the following paragraphs it will explained how to install dependencies in Gentoo, Debian distributions and in CentOS. If you don't have one of the previous systems, you can use your favorite package manager or compile the libraries from source.

Gentoo

On Gentoo you can use Portage that is the official package management system. First you need to update the Portage package tree before installing any packages:

emerge sync

Then proceed with emerging these packages:

emerge -av cmake dev-db/mysql dev-libs/openssl sys-libs/zlib dev-libs/libpcre dev-libs/geoip sys-devel/gettext

if you also want to install Lua and Python plugins use:

emerge -av dev-lang/lua dev-lang/python

Note that some packages maybe already be installed on your system; don't worry you can exclude them for list or make Portage recompile them.

You can now follow overlay manual to install VerliHub on Gentoo with verlihub official overlay.

Debian based distributions

All distributions based on Debian use apt as package management system. To install VerliHub dependences use:

apt-get install libpcre3-dev libssl-dev mysql-server-5.1 libmysqlclient-dev mysql-client-5.1 g++ libgeoip-dev gettext cmake

If you also want to install Lua and Python plugins use:

apt-get install python2.6-dev  liblua5.1-0-dev

CentOS

CentOS is a RPM based distribution and it uses use yum as package management system. To install VerliHub dependences use:

yum install zlib openssl mysql-server >= 5.0 mysql >= 5.0 GeoIP gettext pcre cmake

GeoIP (only if you don't have CentOS distributions)

For other RPM based distribution like RedHat, you can download RPM packages from this link: http://packages.sw.be/geoip/. Remember to choose the right package for your architecture and also to download the devel package.

To install them use:

rpm -ivh geoip-devel-xxx.rpm
rpm –ivh geoip-xxx.src.rpm

In case your cannot find GeoIP for you RPM based distribution you can download the source from here.

To keep up to date GeoIP automatically please follow instructions on this page.

Preparing and compiling the source

Now that the prerequisites are installed, there should be no problems building the source. To build the source use:

cd /path/to/source/verlihub
mkdir build && cd build
cmake ..
make

This could take some minutes to compile depending on the speed of your processor. Note that all plugins get compiled with Verlihub if their dependencies are satisfied. Anyway you can exclude plugin from compiling if you don't need them by using:

cmake -DWITH_<plugin_name>=OFF ..

Installing verlihub

If the compilation has completed successfully then install it as super user (root) using:

make install

If the compile did not complete successfully please ask a question from the Git hub issues page.

Do not start the hub yet because you need to setup the hub before the initial start-up.

Installation using binary package

Debian based distributions

For Debian you can download DEB package from here. Then in the shell type :

dpkg -i verlihub-xxx.deb

RPM based distribution

You can download RPM package from here. Then use rpm command to install it:

rpm –ivh verlihub-xxx.rpm

where xxx indicates the selected version of VerliHub. Now you can start configuring the your hub for the first time reading next chapter.