DART Metadata Schema Registry (DMSR) Installation Guide

Installing instructions for Windows

WAMP (Windows, Apache, MySQL and PHP)

Install WAMP wamp5_1.6.6.exe. The default directory is c:\wamp this is used in the rest of the documentation.

PHP

Go to php.ini (located in C:\wamp\Apache2\bin) and enable XSL by removing the semicolon in from of the php_xsl extension. It should read:
```
      extension=php_xsl.dll
```
Apache will need to be restarted in order for the library to be loaded.
If this doesn't work find the php.ini file by creating a test.php and finding the path described in "Configuration File":
```
      <?php phpinfo() ?>
```

Python

Install Python 2.4 (python-2.4.msi).
Install mod_python (mod_python-3.2.10.win32-py2.4-apache2.0.exe)
- Select the Apache2 directory in C:\wamp
Install MySQL Python (MySQL-python.exe-1.2.1_p2.win32-py2.4.exe)
Install minixsv (minixsv-0.7.win32.exe)

Apache

Go to C:\wamp\Apache2\conf and add the following to the httpd.conf, then restart the Apache service. A httpd.conf file is availabe in the dmsr distribution ./prototype/apache (this works if default installations and configurations have been used).
```
          LoadModule php5_module "c:/wamp/php/php5apache2.dll"
          LoadModule python_module modules/mod_python.so
```

And:

      <Directory "C:/wamp/www/atlatl">
        SetHandler mod_python
        PythonPath "['C:/wamp/www/atlatl']+sys.path"
        PythonHandler atlatl
        PythonDebug On
      </Directory>
      <Files *.php>
        SetHandler None
      </Files>

When modified, the log file for Apache should report that both PHP and Python are running successfully.

Database

MySQL

MySQL 5.0 will already have been installed with WAMP.
Install MySQL Query Browser
Open MySQL Query Browser and connect to the database (localhost, 3306, root, no password).
Create a new schema called "dmsr".
Open creation script (dmsr.sql) from ./prototype/db
Select "dmsr" schema and execute the script.

eXist

Install from http://exist.sourceforge.net by clicking on installation jar (eXist-1.1.1-newcore-build4311.jar).
To run select "eXist Database Startup" from "Programs", "eXist XML Database".
Go to the "eXist Admin Client" connect to localhost and create a new "Collection" (Ctrl-N) called "home".
Ensure that the new resource, "home" has the correct permissions by selecting it and hitting "Resource Properties" (Ctrl-P) and allowing world write permissions.

Installing and Configuring the Web Application

Copying Files

The web site's directory is located in c:\wamp\www
Copy files and directories from inside the "html" directory from the prototype directory and place it in the "c:\wamp\www" directory.
Copy the "atlatl" directory from the prototype directory and place it in the "c:\wamp\www" directory.
The directory structure should now be composed of:
- /www - PHP files
  - /atlatl - Python files
  - /images - image files
  - /includes - PHP files and configuration
  - /xsl - XSLT files

Configuring

The configuration file "config.txt" is located in the includes directory. It is used by both PHP and Python. It shouldn't need modification if the default settings are used.

A typical configuration file looks like:

      home_dir=C:/wamp/www/
      host_name=localhost
      atlatl_location=/atlatl/atlatl.py
      mysql_server=localhost
      mysql_username=root
      mysql_password=
      mysql_database=dmsr
      cookietime=3600
      exist_host_name=localhost
      exist_port=8080
      exist_rest_dir=/exist/rest
      exist_schema_dir=/db/home

Using the Application

Go to http://localhost/login.php
Log in with username "demo" and password "demo".