= Installation on Slackware =

== Needed Packages ==

To install Vuurmuur on Slackware, please check these packages are installed:

 * autoconf : /d/autoconf-x.xx-noarch-1
 * automake : /d/automake-x.x.x-noarch-1
 * binutils : /d/binutils-x.x.x.x.x-i486-3
 * gcc : /d/gcc-x.x.x-i486-1
 * gcc-g++ : /d/gcc-g++-x.x.x-i486-1
 * gettext : /a/gettext-x.x.x-i486-1
 * gettext-tools : /d/gettext-tools-x.x.x-i486-1
 * kernel-headers : /d/kernel-headers-x.x.x-i386-1
 * libtool : /d/libtool-x.x.x-i486-1
 * m4 : /d/m4-x.x.x-i486-1
 * make : /d/make-x.xx-i386-1
 * ncurses : /l/ncurses-x.x-i486-2
 * perl : /d/perl-x.x.x-i486-1
(Download from ftp.slackware.com or mirror (cf http://www.slackware.com/getslack/ ))

== the Slackware package ==
In order to handle the vuurmuur slackware package, you'll need pkgtools
 * pkgtools : /a/pkgtools-x.x.x-i486-y

=== Install the Slackware package ===

 * download the slackware package from the Downloads page
 * log as root and type
{{{
installpkg vuurmuur-x.x.x-i486-y
}}}
 * for an automatic launch of vuurmuur, you'll need to open /etc/rc.d/rc.local and add these lines: 
{{{
if [ -x /etc/rc.d/rc.vuurmuur ]; then
/etc/rc.d/rc.vuurmuur start
fi
}}}

== Build the Slackware package ==
If you want to build your own vuurmuur slackware package

 * download the Vuurmuur sources archive
 * download the vuurmuur.SlackBuild package-building script and its description slack-desc
 * (optional) modify the BUILD variable in the vuurmuur.SlackBuild... and DON'T modify something else until you know what you are doing
 * launch the script with
{{{
sh ./vuurmuur.SlackBuild
}}}
 * the package is in the /tmp directory
{{{
ls /tmp/vuurmuur-x.y.zz-i486-w.tgz
}}}

== Install from source ==
=== The automatic way ===
Installing from source is an easy task with the install script:

 * download the archive, e.g. Vuurmuur-0.5.68.tar.gz, and store it on your disk
 * log as root
 * unpack the archive with the command
{{{
tar -xvzf Vuurmuur-0.5.68.tar.gz
}}}
 * enter the directory Vuurmuur-0.5.68
{{{
cd Vuurmuur-0.5.68
}}}
 * Now run the install script:
{{{
sh ./install.sh --install
}}}
 * Specify '/usr/local' as the install directory (/usr is the default one)
 * Specify '/etc' as the config directory (which is the default one)
 * Specify '/var/log/vuurmuur' as the logs directory (which is the default one)
 * After some waiting you should get a success message. If errors occurs, check the logs files or try the manual way. 

=== The manual way ===

 * download the archive, e.g. Vuurmuur-0.5.68.tar.gz, and store it on your disk
 * log as root
 * unpack the archive with the command
{{{
tar -xvzf Vuurmuur-0.5.68.tar.gz
}}}
 * enter the directory Vuurmuur-0.5.68
{{{
cd Vuurmuur-0.5.68
}}}
 * unpack the archives with the command
{{{
 sh ./install.sh --unpack
}}}
 * enter the 'libvuurmuur' directory
 * run the configure script, make then install 
{{{
cd libvuurmuur
./configure --prefix=/usr/local --sysconfdir=/etc
make
make install
cd ..
}}}
 * enter the 'vuurmuur' directory
 * run the configure script, make then install 
{{{
cd vuurmuur
./configure --prefix=/usr/local --sysconfdir=/etc \
--with-libvuurmuur-includes=/usr/local/include \
--with-libvuurmuur-libraries=/usr/local/lib
make
make install
cd ..
}}}
(hey...why do you think an install.sh script exists ;-))

 * enter the 'vuurmuur_conf' directory
 * run the configure script, make then install 
{{{
cd vuurmuur_conf
./configure --prefix=/usr/local --sysconfdir=/etc \
--with-libvuurmuur-includes=/usr/local/include \
--with-libvuurmuur-libraries=/usr/local/lib
make
make install
cd ..
}}}

== Configuration ==
The 'rc.vuurmuur' script is uptodate
This script should be copied into the /etc/rc.d/ directory
Which will allow us to start Vuurmuur by "/etc/rc.d/rc.vuurmuur start"

 * copy this script 
{{{
cp /usr/local/share/vuurmuur/scripts/rc.vuurmuur /etc/rc.d
}}}
 * chmod +x this script 
{{{
chmod +x /etc/rc.d/rc.vuurmuur
}}}

At last you could install the logrotate script.
Simply copy /usr/local/share/vuurmuur/scripts/vuurmuur-logrotate into /etc/logrotate.d/

Don't forget to check that the LANG environment variable is properly defined (or set it if not)