Creating a katlas mirror on a windows machine

You'll need to download three things:

Downloads

The Saint WAMP (a pre-built combination of Apache, MySQL and PHP, for windows.)

From http://sourceforge.net/projects/yawamp/

Get version 3.4 or greater (with PHP 5).

The katlas web site

The latest backup, created nightly, is at http://katlas.math.toronto.edu/backup/web-backup.tar.gz

You may want to begin downloading this while you install Saint; it's a big download (>200mb).

The katlas sql database

Again, the nightly backup is at http://katlas.math.toronto.edu/backup/wikidb-backup.sql.gz

(It is certainly possible to do this without Saint; I've successfully installed all the components separately in the past. --Scott 21:05, 4 Dec 2005 (EST))

Install Saint

Just run the executable. You can just accept all the default choices. (If you're pressed for space, you can choose not to install filezilla or hamster.) In the last dialog box, you'll be given the option to start the service (selected by default). Do this!

(Troubleshooting - I installed Saint in a directory without spaces in the path; your results may vary.)

Configuring Saint

(See also the Saint README for further details.)

Start the content server

You should see in the system tray the Apache icon. If you'll double click on it, you'll see the Apache Service Monitor showing that the TSW-Controlserver is installed. We need to install the TSW-Contentserver as well.

Under the windows Start menu, find the TSW folder. Go to the WEB subfolder, and select 'TSW Contentserver install'. This should start the Apache Service Monitor. (If it doesn't, start it separately.) Now you'll see the TSW Contentserver. Click start!

(Troubleshooting - perhaps copy and paste the commandline of this shortcut, and run it from a commandline?) (Troubleshooting - the most likely cause of problems in getting Saint started is already having programs bound the ports 80 (http) and 443 (https). You can quickly check for this by typing netstat -a at the command line. Using netstat -a -b will (attempt) to give the name of executable which bound to each port. For example, for some reason Skype binds to ports 80 and 443, and I had to disable it before installing Saint.)

Change the document root (optional)

Open httpd.conf, and modify the DocumentRoot line. You'll also need to change the line <Directory htdocs> to something like <Directory "c:\path\to\DocumentRoot\">. Make sure you've created the directory, then restart the Contentserver service using the Apache Service Monitor.

Start the SQL database

Under the TSW folder in the start menu, go to the DB/MySQL folder, and run MyWinSQLAdmin. Enter whatever username and password you like to create the instance. The SQL administration program automatically minimises to the system tray, as a green traffic light.

Install katlas

Unpack the archives

Move the two .gz files you downloaded from http://katlas.math.toronto.edu/backup/ to your document root directory. If you didn't change it above, the default is Apache2/htdocs under the directory you installed the Saint in. (So quite likely c:\Program Files\TSW\Apache2\htdocs\.

From now on we'll use the web interface to configure Saint:

1. Go to http://localhost:3000/
2. You'll be prompted for a username and password. These are initially admin and accessrequired.
3. Change to English, using the drop down box at the top left of the window.