Chapter 2. Installation

This chapter describes how to install TUX.

Installation Instructions

  1. For optimal performance, create a separate RAID partition as the document root for TUX.

  2. Configure and install the kernel with TUX support built-in, if it has not already been provided with TUX configured.

  3. Install the TUX package with the command rpm -Uvh tux-2.1.0-2.i386.rpm (modify as necessary for new versions...)

  4. Create an index.html file in /var/www/html, the default document root directory.

  5. Start TUX with the command service tux start (or ./tux.init start on Linux systems not running Red Hat Linux), and test the URL http://localhost/ with lynx or any Web browser.

The latest TUX releases can be downloaded from http://people.redhat.com/~mingo/TUX-patches/. To install a TUX patch use the following instructions:

  1. Download the latest TUX patch and userspace utilities from http://people.redhat.com/~mingo/TUX-patches/.

  2. Apply the TUX patch to a vanilla 2.4.2 kernel tree with the command patch -p0 < tux2-full-2.4.2-X6 (where tux2-full-2.4.2-X6 is the TUX kernel patch).

  3. Use make oldconfig to enable TUX in the kernel config, compile it, and boot into the TUX kernel.

  4. Compile and install the userspace utilities, where tux-2.0.25 is the version of TUX you want to install:
    tar xzvf tux-2.0.25.tar.gz
    cd tux-2.0.25
    make
    make install

  5. Create an index.html file in /var/www/html, the default document root directory.

  6. Start TUX with the command service tux start (or ./tux.init start on Linux systems not running Red Hat Linux), and test the URL http://localhost/ with lynx or any Web browser.

Log Files

For each request, TUX logs the address of the requestor, a date and time stamp accurate to at least one second, specification of the file requested, size of the file transferred, and the final status of the request.

The log files for TUX are stored in /var/log/tux in binary format. In this binary format, the log files are approximately 50% smaller than standard ASCII text log files. To view log files use the command /usr/sbin/tux2w3c /var/log/tux. The tux2w3c program converts the binary log files into into standard W3C-conforming HTTPD log files. If you want to save the ASCII output, you can redirect the output to a file: /usr/sbin/tux2w3c /var/log/tux > tux.log, where tux.log is the name of the output file.

Sample log file output:

195.4.12.3 - - Fri Nov  9 01:05:56 2001 "GET /test.html HTTP/1.1" - 53 200
195.4.12.3 - - Fri Nov  9 01:06:10 2001 "GET / HTTP/1.1" - 2890 200
255.255.255.255 - - Fri Nov  9 01:06:10 2001 "GET /icons/apache_pb.gif HTTP/1.1" - 0 404
195.4.12.3 - - Fri Nov  9 01:06:10 2001 "GET /poweredby.png HTTP/1.1" - 1154 200
195.4.12.3 - - Fri Nov  9 01:06:04 2001 "GET /test.html HTTP/1.1" - 53 200
195.4.12.3 - - Fri Nov  9 01:06:22 2001 "GET /manual/index.html HTTP/1.1" - 5557 200
195.4.12.3 - - Fri Nov  9 01:06:04 2001 "GET /test.html HTTP/1.1" - 53 200
195.4.12.3 - - Fri Nov  9 01:06:22 2001 "GET /manual/images/apache_header.gif HTTP/1.1" - 4084 200
195.4.12.3 - - Fri Nov  9 01:06:04 2001 "GET /test.html HTTP/1.1" - 53 200
195.4.12.3 - - Fri Nov  9 01:06:22 2001 "GET /manual/images/pixel.gif HTTP/1.1" - 61 200
195.4.12.3 - - Fri Nov  9 01:06:04 2001 "GET /test.html HTTP/1.1" - 53 200
195.4.12.3 - - Fri Nov  9 01:06:26 2001 "GET /manual/invoking.html HTTP/1.1" - 1 200
195.4.12.3 - - Fri Nov  9 01:06:04 2001 "GET /test.html HTTP/1.1" - 53 200
195.4.12.3 - - Fri Nov  9 01:06:35 2001 "GET /manual/stopping.html HTTP/1.1" - 1 200
195.4.12.3 - - Fri Nov  9 01:06:04 2001 "GET /test.html HTTP/1.1" - 53 200
195.4.12.3 - - Fri Nov  9 01:06:37 2001 "GET /manual/howto/ssi.html HTTP/1.1" - 18523 200
195.4.12.3 - - Fri Nov  9 01:06:41 2001 "GET /manual/new_features_1_3.html HTTP/1.1" - 34531 200