Metacat

  <h2> Operating System Specific Instructions </h2>

  <p> These documents are meant to outline the metacat installation process on specific platforms. They are <strong><em>not</em></strong> a substitute for the above instructions and only meant as a supplemental guideline. </p>

  <ul>

    <li> <a href="os_specific/install_metacat_windows.txt">Installing from CVS source on Windows XP</a> </li>

    <li> <a href="os_specific/install_metacat_ubuntu.txt">Installing on Ubuntu 6.06 (ie Dapper Drake)</a> </li>

  </ul>

Installing Metacat on Ubuntu

Assumes you have the base ubuntu distribution set up already.

* Add the extra repositories to your apt sources list. 

    sudo gedit /etc/apt/sources.list

    # add universe and multiverse to the following lines

       deb http://us.archive.ubuntu.com/ubuntu/ dapper main restricted universe multiverse

       deb-src http://us.archive.ubuntu.com/ubuntu/ dapper main restricted universe multiverse

    sudo apt-get update

* Install the ubuntu package dependencies

    sudo apt-get install tomcat5-webapps postgresql-server-dev-8.1 postgresql-8.1 sun-java5-jdk \

                         apache2 cvs 

* Tell the ubuntu system to use the java jdk 

    sudo update-java-alternatives -s java-1.5.0-sun

    sudo vi /etc/default/tomcat5

      JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun

      .......

      CATALINA_OPTS="-Djava.awt.headless=true -Djava.util.prefs.syncInterval=2000000 -Xmx512M -server"

      ....

      TOMCAT_SECURITY=no

    sudo /etc/init.d/tomcat5 restart

* Download metacat from CVS and set up utilites     

    mkdir ~/workspace; cd ~/workspace

    cvs -d:ext:perry@cvs.ecoinformatics.org:/cvs co metacat

    cvs -d:ext:perry@cvs.ecoinformatics.org:/cvs co utilities

    cd utilities

    ant clean jar

    cd ../metacat

* prep postgres

    # Setting up the postgres metacat db

    sudo vi /etc/postgresql/8.1/main/pg_hba.conf

    # add 

      host metacat metacat 127.0.0.1 255.255.255.255 password

    sudo su postgres

    createdb metacat

    psql -d metacat

      create user metacat with unencrypted password 'metapass';

      \q

    exit

    #restart postgres

    sudo /etc/init.d/postgresql-8.1 restart

    # TEST

    psql -U metacat -W -h localhost metacat

* Build

   sudo touch /var/lib/tomcat5/webapps/knb.war

   sudo chown perry /var/lib/tomcat5/webapps/knb.war

   cd ~/workspace/metacat

   cp build.properties default.build.properties

   # Edit build.properties 

   vi lib/metacat.properties

   #change

     onlySecureLDAPConnection=false

   # TODO set up the certificate *********

   ant clean install

   # may need to give cvs password a few times on the first build

* Postgres configuration

   psql -U metacat -W -h localhost -f build/src/xmltables-postgres.sql metacat

   ant register-schemas

* apache / tomcat integration

    #the instructions at http://www.ubuntuforums.org/showthread.php?t=219985 cover this pretty well

    #remember to add the 'knb' servlet context

* Make sure metacat_data and metacat_inline_data folders are readable/writable by tomcat user

Building Metacat from cvs on Windows XP

Matthew Perry

10/24/2006

Note: This is not intended to be a complete, step-by-step tutorial but rather a general overview of the process along with some specific "gotchas" that I encountered along the way.

===============

Download and Install via the standard windows installers:

  Postgresql 8.1

  Java 1.5 JDK

  TortiseCVS 

Download Tomacat5.5 windows installer and install to C:\tomcat5 (or another directory w/out spaces)

Download ant 1.6.5-bin and extract to C:\ant

Set environment variables (ctl panel > System > Advanced > Environment Variables). 

 ANT_HOME => C:\ant

 JAVA_HOME => C:\Program_Files\jdk1.5.0_09

 PATH => { THE EXISTING PATH };C:\Program_Files\jdk1.5.0_09\bin;C:\ant\bin;C:\Program Files\TortoiseCVS

 CVS_RSH => C:\Program Files\TortoiseCVS\TortoisePlink

Use pgadmin to 

* Create a new user named 'metacat'

* Create a new database named 'metacat', owned by user 'metacat',  with UTF8 Encoding

Download the cvs version of metacat

    cd c:\worskpace

    cvs -d:ext:{ USER }@cvs.ecoinformatics.org:/cvs co metacat

    cvs -d:ext:{ USER }@cvs.ecoinformatics.org:/cvs co utilities

    cd metacat

Adjust build.properties

  # Tomcat Properties

  tomcat=C:/tomcat5

  deploy.dir=C:/tomcat5/webapps

  # Server Properties

  config.hostname=localhost

  config.port=8080

  # Metacat database user and password and location of file stores

  user=metacat

  password=metapass

  datafilepath=C:/workspace/metacat-data

  inlinedatafilepath=C:/workspace/metacat-inline-data

  # give username for CVS access to retrieve latest EML

  cvsroot=:ext:perry@cvs.ecoinformatics.org:/cvs

Run 

  ant clean install 

Create tables

  "C:\Program Files\PostgreSQL\8.1\bin\psql.exe" -U metacat -W -h localhost -f build/src/xmltables-postgres.sql metacat

Register schemas with metacat db

  ant register-schemas

If all went well, you should be able to point your browser to http://localhost:8080/knb and see the default metacat skin