Requirements

The following software is required:

Package	Download
RedHat Linux 6.2	http://www.redhat.com
mod_virgule (kaitiaki version)	kaitiaki_1.0.tar.gz
the sample kaitiaki website database	kaitiaki_db_1.0.tar.gz
rtf-converter	rtf-converter_1.0.tar.gz
Majordomo	http://www.greatcircle.com/majordomo/
MajorCool	http://www.conveyanced.com/MajorCool/
Hypermail	http://www.hypermail.org

Installing www.kaitiaki.org.nz

This document describes how to install the kaitiaki web site software. It is intended for experienced computer users - preferably with some Linux experience.

Install Linux

The kaitiaki web site is intended to be run on Redhat Linux version 6.2. The original machine was a P150 with 2442 MB hard disk, 48MB RAM and an ne2000 compatible network card on I/O port 0x280. This machine was configured as a web server with X Windows and the Gnome desktop. The install options are listed here.

Network Configuration

RedHat Linux provides several GUI based configuration tools. To use them:

Login as root
type startx (which will start the Gnome desktop)

To set up the ethernet driver for an ne2000 network card

Click on the Gnome menu ("foot" icon at bottom left of the screen)

Select Another Level Menus | Administration | Kernel Configurator
Click Add
Choose Module type eth
click which module and select the driver for your network card (ne)
Enter io=0x280 as a parameter
Choose Restart kerneld

Set the TCP/IP Configuration

The network addresses listed are for ReddFish, for other installations, please use an IP address, netmask and name server address provided by your ISP.

Select Gnome | Another Level Menus | Administration | Network Configuration
Select the Interfaces tab
Click the Add button
Choose the Ethernet option and click OK
Enter the IP address (210.55.56.199)
and Netmask (210.55.56.224)
Select Activate interface at boot time
Select the Names tab
Enter the hostname (taiao.kaitiaki.org.nz)
Enter the Domain (kaitiaki.org.nz)
Enter the name servers (210.55.56.205)
Click Save
Select the Routing tab
Set the default gateway (210.55.56.193)
Set the gateway device (eth0)
Click Add enter 0.0.0.0 mask 255.255.255.255 with your ethernet device as interface and router IP address as gateway ( eth0 210.55.56.193)
Click Save
Select the Hosts tab
Add full computer name and ip address (taiao.kaitiaki.org.nz, 210.55.56.199)
add alias taiao
click Save
close the netwrok configurator

Samba

ReddFish has a Windows NT Domain which is used for accessing the file server and printer. Linux can access the NT server using the Samba server software. This is convenient, but not necessary for the kaitiaki server, instructions for configuring Samba are given here.

Configuring Apache

See kaitiaki.conf for the conf file settings specific to the kaitiaki site. Edit /etc/httpd/conf/httpd.conf to make the changes. Then restart the web server by typing /etc/rc.d/init.d/httpd restart

Installing mod_virgule

Mod virgule is the sofware that manages most of the kaitiaki web site, particularly the trust metric system.

cd /home/kaitiaki
tar xvzf /path/to/mod_virgule_k_1.0.tar.gz
tar xvzf /path/to/virgule_db_k_1.0.tar.gz
cd mod_virgule

You may wish to edit some of the source files in order to customise your site. Then:

make install
test by checking that http://localhost/virgule/ displays the "main directory"

The original installation instructions by Raph Levien are here.

Install rtf-converter

The rtf-converter application is used by the web site software to convert uploaded rtf documents to html. To install the RTF converter

cd /home/kaitiaki
tar xvzf /path/to/rtf-converter-1.0.tar.gz
cd rtf
make

Make a shortcut to the rtf-converter in /usr/bin.

su
cd /usr/bin
ln -s /home/kaitiaki/rtf-converter rtf-converter

Test the rtf-converter by:

cd /home/kaitiaki/rtf/testfiles
rtf-converter -o sample.html sample.rtf

Installing HT/Dig

HT/Dig is the search engine software used for the search pages on the kaitiaki web site. To install HT/Dig

su kaitiaki
cd /home/kaitiaki
tar xvzf /path-to/htdig.tar.gz
mkdir /home/kaitiaki/html
cd htdig-x-y
./configure --prefix=/home/httpd/htdig --with-cgi-bin-dir=/home/httpd/cgi-bin --with-search-dir=/home/kaitiaki/html/kimi --with-image-dir=/home/kaitiaki/html/images
make
exit (return to root logon)
make install
ln -s /home/httpd/htdig/bin/rundig /usr/sbin/rundig

Now edit /home/httpd/htdig/conf/htdig.conf

change start_url to http://www.kaitiaki.org.nz/
change maintainer to your e-mail address
uncomment the template_map and template_name options.

After you have put some web site content in place:

rundig

After you have everything set up you will want to add the rundig command into your crontab

crontab -e
i (for insert mode)
0 4 * * * rundig
[esc] [shift]ZZ (save and exit)

The above settings should run rundig every morning at 4am

Majordomo

Adding special user accounts

Several components of the kaitiaki web site software use special user accounts.

Majordomo requires a special login in order to run securely. The kaitiaki web site uses "karere" as the majordomo login To add the "karere" login

Start linuxconf (Gnome | Run Program and type linuxconf)
Select Add User
Full Name: Karere
group: daemon
password: ******

To Install majordomo

cd /home/kaitiaki
tar xvzf /path-to/majordomo-x.y.tar.gz
cd majordomo-x.y
gedit Makefile
change the location of Perl to PERL=/usr/bin/perl
set W_USER to the id of the Karere user (502)
set W_GROUP to the id of the daemon group
Save and close the file
cp sample.cf majordomo.cf
gedit majordomo.cf
change $Whereami to "taiao.kaitiaki.org.nz"
change $sendmail-command to "usr/sbin/sendmail"

After installing majordomo you need to edit /etc/aliases to configure the mailing lists. A sample set of aliases to add is here. To reduce spamming of the lists, make sure you change all occurrences of "-secret" to another (hard to guess) name. After modifying /etc/aliases, run newaliases to load the new version.

To install MajorCool

The kaitiaki web site uses the MajorCool web interface to majordomo. The MajorCool source code is located in /home/kaitiaki/majorcool. Install MajorCool as follows:

mkdir /home/kaitiaki/MajorCool
tar xvzf /path/to/majorcool.tar.gz
./configure

Configure will prompt for the settings, which you should base on the sample default.sh given here (if you replace the existing default.sh with the sample, configure will use it for obtaining the default settings.

Several (cosmetic) changes were made to MajorCool for use with the Kaitiaki web site. These changes can be applied by:

Copy the file kaitiaki.diff to /home/httpd/majordomo/
cd /home/httpd/majordomo/
patch majordomo.pl kaitiaki.diff

For additional information on installing MajorCool, read install.htm in the majorcool/Docs directory or on the MajorCool web site at www.conveyanced.com/MajorCool/Docs/install.htm.

To install Hypermail

Hypermail processes all mail sent to the "korero" mailing list to provide an archive browseable through the web.

cd /home/kaitiaki/
tar xvzf /path/to/hypermail.tar.gz
./configure
make
cd src
make install

Now set up the korero mailing list to pass incoming messages to hypermail.

First, create a link to hypermail in the majordomo directory.

cd /home/httpd/majordomo/
ln -s /usr/local/bin/hypermail hypermail

The majordomo.aliases file already contains the settings for hypermail. The korero-secret alias forwards messages to korero-web, and korero-web uses the majordomo wrapper application as follows:

korero-web: "| /home/httpd/majordomo/wrapper hypermail -i -u -d /home/httpd/mail-archive/korero/ -c /home/httpd/mail-archive/configs/korero.rc -l \" ,Archive ,of ,Korero ,Mailing ,List\""