Contents

  1. General informations on building
  2. Debian 8
  3. Debian 9

General informations on building

Libgit2

The version of ligbit2 provided by debian 8 is too old to work with evQueue (version 0.24 is required), so git support is disabled by default. If you want to enable git support, you will have to build libgit2 0.24 from source and install it. The packaged version is linked against a static version of libgit 0.24, so git support is enabled.

User used to run evQueue

The default configuration ships with a user 'evqueue' that is used to run the core. If you compile from source, you will either have to create this user, or change the configuration file to run with another user.

Core configuration

To configure the core, edit the file /etc/evqueue.conf and adapt it to your needs. You should essentially set the mysql configuration :

See the configuration file documentation for more details.

Debian 8

Prepare database

Install MySQL

root@evqueue:~# apt-get install mysql-server

Create database and user

mysql> CREATE DATABASE evqueue;
mysql> GRANT ALL PRIVILEGES ON evqueue.* to evqueue@localhost IDENTIFIED BY 'password';

Build and install core

Install required packages :

root@evqueue:~# sudo apt-get install git build-essential cmake libmysqlclient-dev libxerces-c-dev libpcre++-dev

Get the source, build and install the core

root@evqueue:~# git clone --branch v2.0 https://github.com/coldsource/evqueue-core.git
root@evqueue:~# cd evqueue-core
root@evqueue:~# mkdir build
root@evqueue:~# cd build
root@evqueue:~# cmake -DCMAKE_INSTALL_PREFIX=/usr ..
root@evqueue:~# make
root@evqueue:~# sudo make install

Configure evQueue

See the general informations.

Run the core

You can now launch evQueue

root@evqueue:~# evqueue --config /etc/evqueue.conf

See syslog if everything went well :

root@evqueue:~# tail /var/log/syslog

Install the frontend

Install apache and PHP

root@evqueue:~# sudo apt-get install apache2 libapache2-mod-php5 php5-mysql php5-xsl

Go to the document root and extract the source

root@evqueue:~# git clone --branch v2.0 https://github.com/coldsource/evqueue-frontend-php.git

You can now access evQueue web interface and do the final configuration inline.

Default user and password is admin / admin

Debian 9

Prepare database

Install MySQL

root@evqueue:~# apt-get install mariadb-server

Create database and user

mysql> CREATE DATABASE evqueue;
mysql> GRANT ALL PRIVILEGES ON evqueue.* to evqueue@localhost IDENTIFIED BY 'password';

Build and install core

Install required packages :

root@evqueue:~# sudo apt-get install git build-essential cmake libmariadbclient-dev-compat libxerces-c-dev libpcre++-dev libgit2-dev

Get the source, build and install the core

root@evqueue:~# git clone --branch v2.0 https://github.com/coldsource/evqueue-core.git
root@evqueue:~# cd evqueue-core
root@evqueue:~# mkdir build
root@evqueue:~# cd build
root@evqueue:~# cmake -DCMAKE_INSTALL_PREFIX=/usr ..
root@evqueue:~# make
root@evqueue:~# sudo make install

Configure evQueue

See the general informations.

Run the core

You can now launch evQueue

root@evqueue:~# evqueue --config /etc/evqueue.conf

See syslog if everything went well :

root@evqueue:~# tail /var/log/syslog

Install the frontend

Install apache and PHP

root@evqueue:~# sudo apt-get install apache2 libapache2-mod-php7.0 php7.0-mysql php7.0-xsl php7.0-zip php7.0-xml

Go to the document root and extract the source

root@evqueue:~# git clone --branch v2.0 https://github.com/coldsource/evqueue-frontend-php.git

You can now access evQueue web interface and do the final configuration inline.

Default user and password is admin / admin