Contents

  1. Download the files
  2. Prepare the database
  3. Install evQueue core
  4. Install the web board

Download the files

Go to the download page and download evQueue core (source or package), create_tables.sql and the web board source archive.

Prepare the 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';

Initialize tables

root@evqueue:~# wget http://www.evqueue.net/data/create_tables.sql
root@evqueue:~# mysql -u evqueue -p evqueue <create_tables.sql

Install evQueue core

Install from package

If you are using debian, using the package is the easiest way to install evQueue core.

root@evqueue:~# dpkg -i evqueue-core_1.4_amd64.deb
root@evqueue:~# apt-get -f install

Install from source

Install cmake and development libraries

root@evqueue:~# apt-get install build-essential cmake libmysqlclient-dev libxerces-c-dev libxqilla-dev

Get the source, build and install

root@evqueue:~# git clone --branch v1.4 https://github.com/coldsource/evqueue-core.git
root@evqueue:~# cd evqueue-core
root@evqueue:~# mkdir build
root@evqueue:~# cd build
root@evqueue:~# cmake ..
root@evqueue:~# make
root@evqueue:~# sudo make install

Configure evQueue

Edit the configuration 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.

If you compliled from sources, you might have to change file paths (/usr/local/bin instead of /usr/bin) and uid/gid settings as the evqueue user/group will not be created.

You can launch evQueue (package version) with :

root@evqueue:~# /etc/init.d/evqueue start

If you compiled from sources or want to manually launch the engine :

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

See syslogs if everything went well :

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

Install the web board

Install from package

The package is recommended if you are using debian.

root@evqueue:~# dpkg -i evqueue-frontend-php_1.4_all.deb
root@evqueue:~# apt-get -f install

You're done, you can then do the configuration.

Install from source

Install apache and PHP

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

Check that you have "AllowOverride All" in your vhost configuration

Restart apache :

root@evqueue:~# /etc/init.d/apache2 restart

Extract the web board

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

Edit the .htaccess and set the correct PHP include path. This path should point to the absolute path of the "includes" directory. You should have somehting like this :

php_value include_path '.:/var/www/html/evqueue-frontend-php/includes'

Create empty configuration files

root@evqueue:~# cd evqueue-frontend-php/includes
root@evqueue:~# mkdir conf
root@evqueue:~# touch conf/logger.php conf/databases.php conf/queueing.php conf/sites_base.php

Guided configuration

Access the web board and follow the instructions. If you used the packaged version, the web board should be accessible on localhost/evqueue.

Once done, access the web board with the default user account admin/admin.