WEB: Simple Web Server - Implementation Design

Class Volumes

The boot volume of WEB is based on the Fedora Core 3 Linux distribution. Below is a list of the software packages installed on WEB, most of them are from the FC3 package repository.

Installed Packages.

The packages that are standard to the FC3 are marked with (FC3) and can be updated to a newer version using 'yum update' (do this only on a branched instance of WEB!). The non-FC3 packages have the source URL listed in parentheses instead.

• httpd-2.0.53-3.3 (FC3)
• mod_ssl-2.0.53-3.3 (FC3)
• crypto-utils-2.1-4 (FC3)
• php-4.3.11-2.8 (FC3)
• mod_perl-1.99_16-3 (FC3)
• MySQL-client-4.1.16-1.glibc23.i386.rpm (http://mysql.mirrors.hoobly.com/Downloads/MySQL-4.1/)
• MySQL-shared-compat-4.1.18-0.i386.rpm (as above)
• perl-DBD-MySQL-2.9007-1.CLT.i386.rpm (custom, branched from FC3, modified to depend only on MySQL-client, instead of on the full mysql package and re-built with the MySQL 4.1 client libraries)
• php-mysql-4.3.11-2.8 (FC3)
• mod_auth_mysql-20030510-5 (FC3)
• samba-common-3.0.10-1.fc3 (FC3)
• samba-client-3.0.10-1.fc3 (FC3)
• libc-client-2002e-13.i386.rpm (FC3)
• php-imap-4.3.11-2.8.i386.rpm (FC3)

Perl Modules, non-RPM Installed

The following additional Perl modules are installed using the CPAN module installer and can be upgraded with the same, if necessary. Here are the install commands used. The comment indicates the version installed.

• perl -MCPAN -e 'install "Date::Format"' # INST_VERSION 2.22
• perl -MCPAN -e 'install "AppConfig"' # INST_VERSION 1.56
• perl -MCPAN -e 'install "Template"' # INST_VERSION 2.14
• perl -MCPAN -e 'install "Mail::Mailer"' # INST_VERSION 1.73
  NOTE: the Mail::Mailer module is patched after the installation, to fix a bug in the SMTP mailer sub-module. Unless the bug is fixed in a future version, the patch needs to be re-applied if this module is updated.

Re-install Procedure

Here are the steps to re-build the WEB appliance from a blank appliance image.

Preparation (needed if starting from older LUX image)

wget http://download.fedora.redhat.com/pub/fedora/linux/core/3/i386/os/RPM-GPG-KEY-fedora
rpm --import RPM-GPG-KEY-fedora
rm RPM-GPG-KEY-fedora
yum install which
yum clean all

Volume Preparation

The boot volume must have 70-80 MB free space. Configuration used for the released WEB image: two volumes, one for "/" and one for "/usr", with 80MB and 200MB size respectively.

Temporarily make the content volume writeable, so that a test website can be installed, if desired.

Installation - 3rd Party Packages

# HTTP server & modules
yum -y install httpd
yum -y install mod_ssl
yum -y install php mod_perl
yum clean all
yum -y install crypto-utils

# MySQL client and shared libs
wget http://mysql.mirrors.hoobly.com/Downloads/MySQL-4.1/MySQL-client-4.1.16-1.glibc23.i386.rpm
rpm -i MySQL-client-4.1.16-1.glibc23.i386.rpm
rm -rf MySQL-client-4.1.16-1.glibc23.i386.rpm
wget http://mysql.mirrors.hoobly.com/Downloads/MySQL-4.1/MySQL-shared-compat-4.1.18-0.i386.rpm
rpm -i MySQL-shared-compat-4.1.18-0.i386.rpm
rm -rf MySQL-shared-compat-4.1.18-0.i386.rpm

# my RPM (modified from FC3, changed dependency to be on MySQL client, not on the full MySQL pkg):
rpm -i perl-DBD-MySQL-2.9007-1.CLT.i386.rpm

# mysql-related Apache modules - install AFTER the MySQL stuff
# (or else, it would drag in the MySQL 3.2 package from FC3!)
yum -y install php-mysql mod_auth_mysql
yum clean all

# needed for Bugzilla, already installed as a dependency by 'yum'
# yum install perl-DBI

# Perl Modules (minimum req. for Bugzilla)
perl -MCPAN -e 'install "Date::Format"'
perl -MCPAN -e 'install "AppConfig"'
perl -MCPAN -e 'install "Template"'
perl -MCPAN -e 'install "Mail::Mailer"'

# samba client
yum install samba-common
yum clean all
yum install samba-client
yum clean all


# misc tweaks
mkdir -p /mnt/content
chkconfig --levels 12345 sendmail off

Installation - Patches and Appliance-related Customization Files

cd /root
tar -jxf 3tappl-WEB-2.1.0.tar.bz2

# add our stuff (see attached files, copy them all to /root, e.g.)
cd /
patch -p0 /root/3tappl-WEB-2.1.0/appliance.sh.patch
patch -p0 /root/3tappl-WEB-2.1.0/fstab.patch
patch -p0 /root/3tappl-WEB-2.1.0/httpd.conf.patch
patch -p0 /root/3tappl-WEB-2.1.0/mailer-1.73.patch
patch -p0 /root/3tappl-WEB-2.1.0/sysconfig-http.patch
cd
mv 3tappl-WEB-2.1.0/alias_set.sh httpd_prerun.sh appl_dyn.pl /appliance
mv 3tappl-WEB-2.1.0/appl.conf /etc/httpd/conf.d

# Update log rotation Edit etc/logrotate.conf and ensure that the following is specified:

rotate 4
size 512k

-- LeoKalev - 21 Mar 2006