:rem:`|||:sec:|||`Installation

1. Get the sources from ws-vacation and put the program anywhere on your harddrive:

   >>> hg clone https://bitbucket.org/wolfmanx/ws-vacation
   

2. Change alias <cite>/vacation</cite> in <cite>lib/ws-vacation.conf.in</cite>, if desired.

3. Execute the following commands (as user) to create the run-time files:

   >>> make clean
   >>> make
   

   This substitutes the installation directory in the necessary places.

4. Copy <cite>lib/ws-vacation.conf</cite> to <cite>/etc/apache2/conf.d/</cite>:

   >>> sudo cp lib/ws-vacation.conf /etc/apache2/conf.d/
   

5. Reload the Apache server:

   >>> sudo /etc/init.d/apache2 reload.
   

6. The sudo(1) setup allows the apache server to execute vacation(1) as any user (except root) without a password. This is activated by copying the file <cite>lib/ws-vacation-sudo</cite> into the directory <cite>/etc/sudoers.d</cite> (ubuntu):

   >>> sudo cp lib/ws-vacation-sudo /etc/sudoers.d/ws-vacation-sudo
   >>> sudo chmod 0440 /etc/sudoers.d/ws-vacation-sudo
   

   or by appending it to the file <cite>/etc/sudoers</cite> (older SuSE):

   >>> cat lib/ws-vacation-sudo | sudo tee -a /etc/sudoers
   

:rem:`|||:sec:|||`User Management

The file <cite>lib/.htpasswd</cite> can be created by the regular means.

An automated script is available that creates the password database from the system shadow(8) database. Just change into directory <cite>lib</cite> and execute:

>>> sudo php gen_htpasswd.php

:rem:`abstand`

:rem:`|||:sec:|||`Configuration

The file <cite>lib/config.php</cite> contains the basic configuration data.

It is possible to fine-tune the standard user selection with:

• $ALLOWED_USERS: users who are always accepted (if present in <cite>/etc/passwd</cite>).
• $INVALID_USERS: invalid users, which are always ignored.
• $ADMIN_USERS: administrators.

The configuraton setting <cite>$EXPERT_ENABLED</cite> allows to globally disable Expert Mode.

The file <cite>lib/language.php</cite> contains language specific translation and also the default vacation(1) message text.

The HTML header and footer can be modified in <cite>lib/templates.php</cite>.

:rem:`|||:sec:|||`Copyright

Copyright (C) 2012, Wolfgang Scherer, <sw@wiedenmann-seile.de>. Sponsored by Wiedenmann-Seile GmbH.