HOWTO: Compilation and installation

Compilation

To compile the Hiawatha webserver, download the tarball from the download page and use

tar -xzf hiawatha-<version>.tar.gz
cd hiawatha-<version>

to unpack the source tarball. To compile Hiawatha use

./configure [options]
make

The options for the configure script are:

option	description	required libraries when feature enabled
--disable-cache	disable file caching
--disable-largefile	disable support for large files
--disable-ipv6	disable IPv6 support
--disable-ssl	disable SSL support	libssl-dev
--disable-toolkit	disable URL toolkit
--enable-command	enable CommandChannel
--enable-debug	enable debug info (for development only)
--enable-xslt	enable XSLT support	libxml2-dev, libxslt1-dev

Installation

After a successful compilation, you can install Hiawatha via the following command. You need root privileges for this.

make install

Debian

Debian and Debian based operating systems can use the following command to build a Debian package:

apt-get install libc6-dev libssl-dev dpkg-dev debhelper fakeroot libxml2-dev libxslt1-dev
./configure
make deb

To successful build a Debian package, you need the following packages to be installed: libc6-dev, libssl-dev, dpkg-dev, debhelper, fakeroot, libxml2-dev and libxslt1-dev. After the package has been build, use the following command to install the package.

dpkg -i hiawatha_<architecture>_<version>.deb

to install the package. The created package file is located one directory higher than the source directory.

Uninstallation

To uninstall Hiawatha when installed from source, use the following command from within the source directory to uninstall Hiawatha:

make uninstall

When installed via dpkg, use the following command to uninstall the Hiawatha package:

dpkg --purge hiawatha