Debian Sarge Install Guide
From MirrorMed
This is based on a Clearhealth Debian install I contributed earlier with modifications for mirrormed RC2. It hasn't been extensively tested against Mirrormed specifically but should work since the code is the same. Please feel free to correct any errors you find. -Thaddeus
Contents |
Debian Sarge Install
This covers a netinst Debian Sarge install using a stand alone i386 machine. What you will need for your i386 machine:
- cd with debian-31r0a-i386-netinst.iso (available from http://www.debian.org/CD/netinst/ under i386)
- internet access (to download debian packages and mirrormed)
- root access
Please note that this does not cover the security setting need to set up a production debian server. Those configurations are outside the scope of this document.
Debian Sarge Install
Boot i386 with netinst CD.
Follow the default debian installer instructions with the following exceptions. When asked, setup as a multi-user workstation. Under package selection, select only webserver. Leave mail as "no configuration at this time".
Add in the the following packages using apt-get. Nonmandatory packages are ones not required for mirrormed operation.
Nonmandatory packages for time syncronization.
apt-get install ntp ntpdate
Nonmandatory packages for ftp server.(Adding an FTP server does add a potential security risk however).
apt-get install proftpd proftpd-doc
Mandatory packages for mysql server, php4, and communication between each.
apt-get install mysql-server libmysqlclient12 libapache2-mod-auth-mysql apt-get install php4 libphp-adodb libct1 libltdl3 odbcinst1 php4-cli php4-odbc php4-pear unixodbc php4-mysql
Go to the /tmp directory and download the mirrormed RC3 tarball
cd /tmp wget http://www.mirrormed.org/download/mirrormed-1.0RC3.tgz
Extract using
tar -xvzf mirrormed-1.0RC3.tgz
Move mirrormed to the apache2 webserver document root directory and rename using.
mv /tmp/mirrormed-1.0RC3 /var/www/mirrormed
Mysql Database Configuraton
Create the mysql database root password using
/usr/bin/mysqladmin -u root password new_password_here
Create the mysql database, usually called mirrormed
/usr/bin/mysqladmin -u root -p create mirrormed
Type in password when prompted…
Pre Mirrormed Installer Configuration
Here are couple of things we need to setup before we use the automatic installer.
Both freeb2 and mirrormed directories have a tmp subdirectory, these subdirectories must be configured so that the webserver can write to it, either by changing its permissions to 777 or changing the ownership to the apache user.
Apache user is www-data in debian by default. If we change the ownership we use
chown www-data:www-data /var/www/mirrormed/tmp chown www-data:www-data /var/www/mirrormed/freeb2/tmp
Additionally the mirrormed installer will write the mirrormed and freeb2 configuration files and needs access to them, so:
chown www-data:www-data /var/www/mirrormed/local/config.php chown www-data:www-data /var/www/mirrormed/freeb2/local/config.php
Change the following in the /etc/php4/apache2/php.ini file. Apache reads this file when starting up.
change memory_limit in the php.ini file to 64M from 8M change max_execution_time in php.ini to 45 from 30 change register_globals in php.ini to Off (don’t need to change… off by default in debian) change magic_quotes_gpc in php.ini to Off from On
Restart the apache2 web server so the changes made above take, using
/usr/sbin/apache2ctl restart
Open http://yourlocalhostname/mirrormed/installer in your web browser and follow the installer.
After completing the install, here are the defaults to login:
login: admin password: admin
