7.5. Installation

After successful compilation you're ready to install software. It's easy as writing:

make install

You can also add PREFIX=some/directory to install it in other that default one. For example following command will install all files in /var/v-q:

make PREFIX=/var/v-q install

Note: Default destination directory is /var/vq.

7.5.1. Special steps for Qmail

After installing v-q you can tweak some settings. For example if qmail's configuration owner is other than user running qmailvqd you can change owner and set SETUID permission for bin/qmail_* programs (except qmailvqd). This will allow these programs to change qmail's configuration.

Note: Programs starting with qmail- are simple shell scripts - setting SETUID/SETGID flag for them will not work with decent shells. You will have to modify them to use sudo to run some commands. See qmail-send-restart for some clues about it.

7.5.2. Special steps for PostgreSQL

First you need to create user for v-q in PostgreSQL. Default user is "mail", but you can use any name. To create user you can use following command:

createuser -A -D -P mail

Then you need to create a database for v-q. Default name is "mail". But you can use any name.

createdb -E utf-8 -O mail mail

To compile PostgreSQL modules you should run in bash:

make pgsql 2>&1 > out.pgsql

In tcsh run:

make pgsql >& out.pgsql

Remember that pqxx-config must be in the path (if you don't have this program it means either libpqxx is not installed or it's too old version).

To install PostgreSQL modules run:

make install-pgsql

You can also add PREFIX=some/directory if you want to install it in other directory than the default one. For example following command will install it in /var/v-q:

make PREFIX=/var/v-q install-pgsql

Note: Default destination directory is /var/vq.

To create objects in a database you can use PERL script install.pgsql. This document doesn't describe how to manually create them. If you don't want to use this script check it's source to see what needs to be created.

Note: Before running this script check whether it suits you needs (for example schema name).


Remember to set password for database user and configure PostgreSQL to authorize users. If you don't do it everyone will be able to modify entries in a database.

7.5.3. What if I have problems?

If you have problems installing v-q check home page, check also v-q's page on SourceForge. There you will find a mailing list, forums, etc.

Read also Chapter 5

Hosted by: BerliOS Logo SourceForge.net Logo