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.0-1.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), 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 & 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), 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.

Sample log file output:

195.4.12.3 Tue Feb 22 13:21:36 200 index.html 0 403
195.4.12.3 Tue Feb 22 13:21:38 200 index.html 0 403
195.4.12.3 Tue Feb 22 13:21:39 200 index.html 0 403
195.4.12.3 Tue Feb 22 13:21:39 200 index.html 0 403
195.4.12.3 Tue Feb 22 13:22:04 200 index.html 0 403
195.4.12.3 Tue Feb 22 13:22:05 200 index.html 0 403
195.4.12.3 Tue Feb 22 13:22:18 200 x.html 0 403
195.4.12.3 Tue Feb 22 13:22:18 200 x.html 0 403
195.4.12.3 Tue Feb 22 13:22:34 200 x.html 0 403
195.4.12.3 Tue Feb 22 13:22:44 200 x2.html 0 403
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir424/class0_1 269 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir204/class1_3 4162 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir725/class0_4 575 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir593/class0_5 677 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir62/class0_3 473 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir84/class2_3 41027 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir318/class3_4 512068 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir336/class2_5 61507 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir337/class0_3 473 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir492/class1_2 3138 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir667/class1_4 5186 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir747/class1_2 3138 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir165/class0_6 779 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir760/class3_2 307268 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir359/class0_3 473 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir455/class2_5 61507 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir359/class1_4 5186 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir315/class0_0 167 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir284/class0_5 677 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir451/class0_5 677 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir121/class0_2 371 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir226/class1_4 5186 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir134/class0_6 779 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir671/class1_4 5186 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir262/class1_4 5186 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir30/class0_7 881 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir62/class0_3 473 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir234/class1_3 4162 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir201/class1_7 8258 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir417/class1_1 2114 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir312/class2_3 41027 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir605/class1_2 3138 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir79/class0_3 473 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir239/class0_2 371 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir602/class2_1 20547 200
195.4.12.3 Tue Feb 22 13:23:08 200 spec/file_set/dir47/class1_7 8258 200
195.4.12.3 Tue Feb 22 13:23:09 200 spec/file_set/dir66/class1_4 5186 200