Common post-installation steps

1. Configure PHP 4

PHP needs to be configured a bit before it can run Ariadne without problems. Start a text editor and create a new file with the following line:

magic_quotes_gpc = Off

Save this file as \winnt\php.ini. Make sure it doesn't get saved as php.ini.txt

(You can also edit your existing php.ini file, just make sure that magic quotes are off).

2. 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.

3. Install Ariadne

Start by unzipping the file ariadne.2.0b10.zip to a suitable directory ( e.g. C:/Program Files/Ariadne.2.0b10/ ) . 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.0b10/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.0b10\www\ directory.

4. 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-dist'. 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.0b10/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-dist to ariadne.phtml and edit it. Make sure you change the $AR->OS variable to win32. For the rest, follow the instructions in the configuration file itself. Copy store.phtml-dist to store.phtml and edit it and do the same with sessions.phtml-dist and axstore.phtml-dist. 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.0b10\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 and ariadne_sessions databases and create them 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'.

Then decide if you want to have a guest user account, if you don't, browse through the ariadne tree to /system/users/guest/, click on edit and change the password. The default is 'guest'. Also, remember to change the password for the admin user.

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