Revision as of 09:11, 9 August 2007

Setup

ms4w

This service has been installed on all the servers and the directory structure in the ms4w\Apache\htdocs folder is either 'projects' or 'students'. The 'students' folder is divided into the different students user names and the 'projects' folder is divided into the project names. From this follows that the portus project code is all in ms4w\Apache\htdocs\projects\portus_ark and my own sintana project is in ms4w\Apache\htdocs\students\hro106\sintana.

When setting up ms4w I have changed the LISTEN setting in ms4w\Apache\conf\httpd.conf from 80 to 8080 since most of the servers already had some other service running on 80. This means that the root of the server can be reached from http://localhost:8080 or the equivalent. So for the ay-dehus server the address is http://ay-dehus.soton.ac.uk:8080/ and then the folders which lead to the projects and the ark code.

MySQL

1. Download MySQL from http://dev.mysql.com/downloads/mysql
2. Install to c:\program files
3. Configure to run:
   1. server machine
   2. multifunctional DB
   3. C: as installation path
   4. online transaction processing (oltp)
   5. enable tcp/ip networking on 3306 port
   6. enable strict mode
   7. multilanguage utf-8
   8. install as a windows service
   9. include bin directory
   10. set root passwork
   11. enable access from remote machines.
4. Security considerations with mysql.
   1. You might need to allow port 3306 as an exeption through the firewall settings in windows for it to work.
   2. You might also want to change the root user and password for security reasons.
5. Download phpmyadmin - the english version or multilanguage if you wish.
6. Extract the zip folder to C:\ms4w\Apache\htdocs and maybe further into a folder system only you know for security reasons and rename the folder to just phpmyadmin without all the version numbers.
7. To configure phpmyadmin copy the file config.sample.inc.php and rename the copy to config.inc.php and leave in the main phpmyadmin folder.
   1. Change the mysql database settings like host and stuff
   2. Add a blowfish secret - can be anything or just 'herfjke'
   3. And go to the phpmyadmin page in your browser http://localhost:8080/your_secret_foldersystem/phpmyadmin/ and login

ARK

1. Get the newest version of the ARK code and pop it into the project folder. The ARK code for each project has been placed into the file directory of the ms4w\Apache\htdocs root folder under the relevant folder structure.

Clarent

1. Create a new database in mysql for clarent - I called my ark database portus_ark and the clarent database for portus i called portus_clarent.
2. Import the clarent database
3. Create a datafolder into the project folder: portus_ark\data\mapping where you want to put the maps and other data for the project.
4. Create a mapfile and put it into portus_ark\mapserver\mapfiles - see more on mapfiles later. The mapfile is only used for the clarent main map while the smaller maps attached to the modules use map settings in the ark database.
5. In portus_ark\clarent\06\clarent\settings.php
   1. Change all directories to fit the new project
   2. Point clarent default map to your new mapfile
   3. Change DB settings and point to your new clarent DB portus_clarent
   4. Set mapextent to the same as in the mapfile

Different servers

ay-dehus

ay-scribe

my laptop

Portus_ark

Sintana_ark