Installation on Windows systems

Using IIS

These are the installation instructions when you want to run PHP with IIS. If you want to use Apache for windows, goto the part titled 'Using Apache'.

1. Install PHP 4

Download the PHP 4 windows binaries from http://www.php.net/downloads.php or one of its mirrors.

Unzip PHP and install it somewhere (e.g.: C:\PHP\ ). Now download our patched version of the isapi dll from ftp://ftp.muze.nl/ and copy it over the original. (which you can find at C:\PHP\sapi\php4isapi.dll)

This patch fixes a problem with IIS and PHP which prevents PHP from finding the correct script to execute if you add path info in the url. Ariadne will not run without this.

Read the install.txt file for further instructions. Don't forget to install the isapi version of PHP.

2. Configure IIS

Start the 'Internet Services Manager', you can find it from the Start menu -> Programs -> Administrative Tools -> Internet Services Manager.

Now create a new website for Ariadne by rightclicking on the folder with the name of your system and selecting new -> website. Alternatively you can install it in an existing website if you like. Do make sure that the Web Site Access Permissions are set to 'read' and 'execute'.

Tip: If you don't use IIS's 'default' website, we advise you to disable it. This will help to make your system more secure.

Make sure that PHP is enabled in the Ariadne website. You can read instructions for this in the PHP installation instructions (install.txt).

You can now continue the installation with the part title 'Common Installation' further in this document.

Using XAMPP

These are the installation instructions when you want to run Ariadne with XAMPP on windows. You can get XAMPP from http://www.apachefriends.org/en/xammp-windows.html

Download the XAMPP installation package from http://www.apachefriends.org/en/xammp-windows.html.

Choose the default install (thus without enabling services).

Run c:\xampp\php-switch.bat to make XAMPP switch to PHP 4.

Start the XAMPP Control panel and click both the 'apache' and 'mysql' start buttons.

When Apache and MySQL are running, startup your browser and open http://localhost/. Click phpMyAdmin, enter 'ariadne' into the Create new database input field, and click the create button.

Add a user to MySQL for access to the database. Do this by clicking privileges and click the link Add a new user. Fill in all required fields, e.g.:

User name: ariadne
Host: localhost
Password: secret
Re-type: secret

[NOTE: update your ariadne/lib/configs/ariadne.phtml DB settings with any changes you have made here]

Check the Create database with same name and grant all privileges option from the Database for user list and click the go button at the bottom of the page.

Edit c:\xampp\php\php4\php4.ini where you have to disable magic_quotes_gpc and ALL Zend settings (as the Zend optimizer is NOT compatible with Ariadne).

You can now continue the installation with the part title 'Install Ariadne' further in this document.

Using Apache

These are the installation instructions when you want to run PHP with Apache for windows. If you want to use IIS instead, finish the previous part titled 'Using IIS' first, then continue the installation with the part titled 'Install MySQL'.

1. Stop IIS

If you are not already running Internet Information Services (IIS) you can skip this step.

If you want to run Ariadne on the default webserver port (80), you need to stop IIS permanently. Ariadne requires Apache and Apache cannot run on the same port as IIS. To stop the webservice of IIS, go to start->programs->aministrative tools->services and right-click on 'World Wide Web publishing services'. Select 'Properties' and click on the 'Stop' button if it is enabled. Then select 'disabled' in the startup-type selection box.

2. Install Apache

Apache can be downloaded from http://httpd.apache.org/ or one of its mirrors.

The installation wizard will guide you through the initial installation of Apache. Remember the installation path you selected for Apache.

3. Install PHP 4

Download the PHP 4 windows binaries from http://www.php.net/downloads.php or one of its mirrors.

Unzip PHP and install it somewhere (e.g.: C:\PHP\). Read the install.txt file for further instructions. Remember: you need to install PHP as a module in Apache, don't install the CGI version.

5. Configure Apache

Apache itself is not configured yet. Browse to the conf directory under the Apache installation directory and open the httpd.conf file for editting (it is text file). Search for the text 'LoadModule'. Between the list of modules there's probably a line like this:

#LoadModule php4_module modules/apachemodulephp.dll

Change this line to this:

LoadModule php4_module modules/php4apache.dll

Note: the name of the module has also changed.

Then search for the text 'AddType'. Between the list of application type's, you can find the line:

#AddType application/x-httpd-php .php

Change this line to this:

AddType application/x-httpd-php .php

Finally search for this line:

DirectoryIndex index.html index.shtml

And add index.php at the end of the line.

The file httpd.conf contains numerous other configuration settings, for more information on configuring Apache for Windows goto http://www.apache.org/.

Now you need to test whether Apache will run with PHP installed. First youwill need to restart the Apache service. You can do this from the Start menu -> Programs -> Apache -> Restart Apache.

To check if everything is installed correctly, create a file with the name 'info.php' in the Apache document root (e.g.: C:\Program Files\Apache Group\Apache\htdocs\) with the following contents:

<?php
 phpinfo();
?>

Start a web browser and go to http://localhost/info.php. If everything installed ok, you should see a formatted page displaying some information about PHP and Apache.

Install MySQL

Start by unzipping the file mysql-3.23.40- win.zip. If you use WinZip you can immediately press Install, otherwise you can unzip the files to a temporary directory and start setup.exe.

The installation wizard will guide you through the initial installation of MySQL.

After the installation wizard finishes, start the program winmysqladmin.exe from the bin directory under the Mysql installation directory. This program will first ask you to enter a username and password. You can use these to connect to the MySQL database from now on. The program has placed itself in the system tray, so click on the 'traffic light' icon there and select 'show me'. Now press the 'my.ini Setup' tab. Enter the correct values for the base directory and select 'mysqld-nt'. Check the entries in the my.ini file and then press 'Save Modification'.

Finally you need to create two databases for Ariadne to use later. Click on the tab databases. Right click on the computer name in the Databases overview and select create database. Now enter the name of your ariadne database, e.g. ariadne, and click on create the database. The input dialog will remain and you can enter the second database, used for storing session information, you might call that ariadne_sessions.

Install Ariadne

Start by unzipping the file ariadne.2.6.zip to a suitable directory ( e.g. C:/Program Files/Ariadne.2.6/ ) . This directory should not be in your webservers document root! (That would allow hackers to read the programs source code via the web, which is a bad thing.)

Now you can either move the www directory from the ariadne installation directory to a new directory in the document root of the webserver, e.g. /ariadne/, or you can direct the webserver to an alternative directory.

If you are using Apache, you can add an alias directive to the Apache's httpd.conf. e.g.:

Alias /ariadne/ C:/Program Files/Ariadne.2.6/www/

Don't forget to restart Apache again after this change.

If you are using IIS, you can add a Virtual Directory with the same effect. In the Internet Services Manager you can select the Ariadne website, right-click on it and select 'new' -> 'Virtual Directory'. In the wizard enter a name for the ariadne virtual directory, e.g. "ariadne", and point it to the C:\Program Files\ariadne.2.4\www\ directory.

Configure Ariadne

Next you need to configure Ariadne. There are a few configuration files, if you forget one of these, Ariadne won't run and remain strangely quiet :)

The first file is in the www (or /ariadne/) directory, called 'ariadne.inc-win'. Copy this file to 'ariadne.inc' and edit it. Change the path in the file to point to the (fully qualified) path of the lib directory under the Ariadne installation dir (e.g. C:/Progra~1/Ariadne.2.6/lib/).

Important: Only use 'legacy' filenames for directories, the tar and gzip utilities used by Ariadne don't understand spaces in filenames. Also remember to use only forward slashes ('/') in paths, as the backslash ('\') has special meaning as an 'escape' character in PHP.

The next files are in the lib/configs/ directory under the ariadne installation directory. Copy ariadne.phtml-win to ariadne.phtml and edit it. Remember to enter the username and password and database names you entered when you installed MySQL.

Now got to the control panel and start system again. Click on advanced and then Environment Variables. Select the Path variable from the system variables box and press Edit. Now add the bin directory in the Ariadne installation directory to the path, e.g. C:\Program Files\ariadne.2.4\bin .

The final step is running the Ariadne initial installation script. This script populates the database with a minimal set of objects. Start your browser and go to the url http://localhost/ariadne/install/install.php. The script will display a lot of messages, as long as none of them say 'ERROR', you are allright :)

You should now be able to login to Ariadne. Point your webbrowser to your webserver, e.g. http://your.host.com/ariadne/ and enter 'admin' as username and 'muze' as password. If you don't see a logon form but a message saying 'the object you requested could not be found', then the installation went wrong. Check to see if you entered the correct paths and fix them if necessary. Then drop the ariadne database and create it again (the fastest way to 'clear' them) and run the install.php script again.

If you successfully logged on, then before you do anything else remove the ariadne/install/ directory in the document root. This is an installation directory used for the webbased install, which can mess up your database if someone runs the scripts in it later. You might want to keep the files around somewhere, as there is also a script 'setadmin.php' in it, which come in handy if you ever forget the password for 'admin'.

If you need more assistance with the installation, try the newsgroups at news://news.muze.nl/ or the forums at http://news.muze.nl/.