Manual » Installation
- 1. Installation from source
- 1.1. Extract the source
- 1.2. Dependencies installation
- 1.2.1. Gentoo
- 1.2.2. Debian based distributions
- 1.2.3. CentOS
- 22.214.171.124. GeoIP (only if you don't have CentOS distributions)
- 1.3. Preparing and compiling the source
- 1.4. Installing verlihub
- 2. Installation using binary package
- 2.1. Debian based distributions
- 2.2. RPM based 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.
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:
- gcc version >= 4.0 (use gcc --version to get the version number) Required
- cmake >= 2.6 Required
- MySQL >= 5.0 Required
- OpenSSL >= 0.9.8 Required
- zlib Required
- Perl-compatible regular expression library (pcre) Required
- GeoIP Required
- Gettext Required
- LUA 5.1 (for Lua plugin)
- Python >= 2.5 (for Python plugin)
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.
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:
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 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 ..
If the compilation has completed successfully then install it as super user (root) using:
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.