eResearch

You are here

DART: Metadata Schema Registry Installation

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