/ - Diff - Metacat - Ecoinformatics Redmine

     These documents are meant to outline the metacat installation process on specific platforms. They are <strong><em>not</em></strong> a substitute for the below 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 from CVS source on Ubuntu 6.06 (ie Dapper Drake)</a> </li>
         <li> <a href="os_specific/install_metacat_windows.html">Installing from CVS source on Windows XP</a> </li>
         <li> <a href="os_specific/install_metacat_ubuntu.html">Installing from CVS source on Ubuntu 6.06 (ie Dapper Drake)</a> </li>
         <li> <a href="os_specific/install_metacat_mac.html">Installing from CVS source on Mac OS X</a> </li>
       </ul>

     <!DOCTYPE html PUBLIC "-//W3C//DTD html 4.0//EN">
     <html>
     <head>
       <title>Metacat Install - Windows XP</title>
       <link rel="stylesheet" type="text/css" href="@docrooturl@default.css">
     </head>
     <body>
     <table class="tabledefault" width="100%">
     <tr><td rowspan="2"><img src="@docrooturl@images/KNBLogo.gif"></td>
     <td colspan="7">
     <div class="title">Metacat Install - Windows XP</div>
     </td>
     </tr>
     <tr>
       <td><a href="@server@/" class="toollink"> KNB Home </a></td>
       <td><a href="@server@/data.html" class="toollink"> Data </a></td>
       <td><a href="@server@/people.html" class="toollink"> People </a></td>
       <td><a href="@server@/informatics" class="toollink"> Informatics </a></td>
       <td><a href="@server@/biodiversity" class="toollink"> Biocomplexity </a></td>
       <td><a href="@server@/education" class="toollink"> Education </a></td>
       <td><a href="@server@/software" class="toollink"> Software </a></td>
     </tr>
     </table>
     <hr>
     <table class="tabledefault" width="100%">
     <td class="tablehead" colspan="2"><p class="emphasis">Building Metacat from cvs on Windows XP</p></td>
     <tr>
     <td>
     <p>
     Matthew Perry<br />
 /24/2006
     </p>
       <p class="emphasis">
     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.
       </p>
     </td>
     </tr>
     </table>
     <h2>Download and Install via the standard windows installers</h2>
     <p>
       Postgresql 8.1
       Java 1.5 JDK
       TortiseCVS
     </p>
     <h2>Tomcat</h2>
     <p>
     Download Tomacat5.5 windows installer and install to C:\tomcat5 (or another directory w/out spaces)
     </p>
     <h2>Ant</h2>
     <p>
     Download ant 1.6.5-bin and extract to C:\ant
     </p>
     <h2>Environment variables</h2>
     <pre>
     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
     </pre>
     <h2>Database</h2>
     <pre>
     Use pgadmin to
     * Create a new user named 'metacat'
     * Create a new database named 'metacat', owned by user 'metacat',  with UTF8 Encoding
     </pre>
     <h2>Checkout metacat</h2>
     <pre>
     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
     </pre>
     <h2>Edit build.properties</h2>
     <pre>
     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=metacatpass
       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
     </pre>
     <h2>Run</h2>
     <pre>
       ant clean install
     </pre>
     <h2>Create tables</h2>
     <pre>
       "C:\Program Files\PostgreSQL\8.1\bin\psql.exe" -U metacat -W -h localhost -f build/src/xmltables-postgres.sql metacat
     </pre>
     <h2>Register schemas with metacat db</h2>
     <pre>
       ant register-schemas
     </pre>
     <p>
     If all went well, you should be able to point your browser to http://localhost:8080/knb and see the default metacat skin
     </p>
     </body>
     </html>

     <h2>Installing Metacat on Mac OSX (10.4.10)</h2>
     Author: Matthew Perry, Derik Barseghian<br />
     Date: 11/05/2007<br />
     <!DOCTYPE html PUBLIC "-//W3C//DTD html 4.0//EN">
     <html>
     <head>
       <title>Metacat Install - Mac OS X</title>
       <link rel="stylesheet" type="text/css" href="@docrooturl@default.css">
     </head>
     <body>
     <table class="tabledefault" width="100%">
     <tr><td rowspan="2"><img src="@docrooturl@images/KNBLogo.gif"></td>
     <td colspan="7">
     <div class="title">Metacat Install - Mac OS X</div>
     </td>
     </tr>
     <tr>
       <td><a href="@server@/" class="toollink"> KNB Home </a></td>
       <td><a href="@server@/data.html" class="toollink"> Data </a></td>
       <td><a href="@server@/people.html" class="toollink"> People </a></td>
       <td><a href="@server@/informatics" class="toollink"> Informatics </a></td>
       <td><a href="@server@/biodiversity" class="toollink"> Biocomplexity </a></td>
       <td><a href="@server@/education" class="toollink"> Education </a></td>
       <td><a href="@server@/software" class="toollink"> Software </a></td>
     </tr>
     </table>
     <hr>
     <table class="tabledefault" width="100%">
     <td class="tablehead" colspan="2"><p class="emphasis">Installing Metacat on Mac OSX (10.4.10)</p></td>
     <tr>
     <td>
     <p>
     This is a terse cheatsheet for metacat with postgres on os X. Please see metacat_install_instructs.html for the full details.
     Author: Matthew Perry<br />
     Date: 11/9/2006<br />
     Updated: 11/04/07 Derik Barseghian<br />
     </p>
     <h2>* pre-requirements</h2>
     <h3>install ant, postgres, tomcat using macports</h3>
       <p class="emphasis">
     	This is a terse cheatsheet for installing metacat with postgres on os X. Please see the <a href="../metacatinstall.html">general instructions</a> for the full details.
       </p>
     </td>
     </tr>
     </table>
     <table class="tabledefault" width="100%">
     <td class="tablehead" colspan="2"><p class="emphasis">Pre-Requirements</p></td>
     <tr>
     <td>
     </td>
     </tr>
     </table>
     <h2>Install ant, postgres, tomcat using macports</h2>
     <p>Alternatively, download and install ant, postgres and tomcat from source or using fink.</p>
     <p>
     install <a href="http://www.macports.org/">macports</a>.
-...
     sudo port install tomcat5
     </pre>
     <h2>* metacat install</h2>
     <table class="tabledefault" width="100%">
     <td class="tablehead" colspan="2"><p class="emphasis">Metacat Install</p></td>
     <tr>
     <td>
     </td>
     </tr>
     </table>
     <h3>setup database</h3>
     <h2>Setup Postgres Database</h2>
     <pre>
     cd /opt/local/lib/postgresql82/
     sudo mkdir data
-...
     </pre>
     <h3>checkout metacat</h3>
     <h2>Checkout Metacat</h2>
     <pre>
     mkdir ~/cvs_src/
     cd ~/cvs_src
-...
     cvs -d:ext:your_cvs_name@cvs.ecoinformatics.org:/cvs co utilities
     </pre>
     <h3>edit build.properties as needed</h3>
     <h2>Edit build.properties as needed</h2>
     <pre>
     tomcat=/opt/local/share/java/tomcat5
-...
     metacat.dir=/Users/yourname/nceas/metacat
     </pre>
     <h3>install metacat</h3>
     <h2>Install Metacat</h2>
     <pre>
     cd metacat
     sudo ant install
-...
     <p>
     After restarting, you'll need to fire off the following commands in order to start up postgres/tomcat again:
     # Startup
     </p>
     <p>
     Startup
     </p>
     <pre>
     /Users/nceas/Apps/postgres/bin/pg_ctl -D /Users/nceas/Apps/postgres/data/ -l /Users/nceas/Apps/postgres/logfile -m fast start
     /Users/nceas/Apps/apache-tomcat-5.5.20/bin/startup.sh
     </pre>
     <p>
     # Shutdown
     Shutdown
     </p>
     <pre>
     /Users/nceas/Apps/apache-tomcat-5.5.20/bin/shutdown.sh
-...
     <p>
     You can create two shell scripts with the preceeding commands; start_metacat.sh and stop_metacat.sh
     </p>
     </body>
     </html>

     <!DOCTYPE html PUBLIC "-//W3C//DTD html 4.0//EN">
     <html>
     <head>
       <title>Metacat Install - Ubuntu</title>
       <link rel="stylesheet" type="text/css" href="@docrooturl@default.css">
     </head>
     <body>
     <table class="tabledefault" width="100%">
     <tr><td rowspan="2"><img src="@docrooturl@images/KNBLogo.gif"></td>
     <td colspan="7">
     <div class="title">Metacat Install - Ubuntu</div>
     </td>
     </tr>
     <tr>
       <td><a href="@server@/" class="toollink"> KNB Home </a></td>
       <td><a href="@server@/data.html" class="toollink"> Data </a></td>
       <td><a href="@server@/people.html" class="toollink"> People </a></td>
       <td><a href="@server@/informatics" class="toollink"> Informatics </a></td>
       <td><a href="@server@/biodiversity" class="toollink"> Biocomplexity </a></td>
       <td><a href="@server@/education" class="toollink"> Education </a></td>
       <td><a href="@server@/software" class="toollink"> Software </a></td>
     </tr>
     </table>
     <hr>
     <table class="tabledefault" width="100%">
     <td class="tablehead" colspan="2"><p class="emphasis">Installing Metacat on Ubuntu</p></td>
     <tr>
     <td>
       <p class="emphasis">
     Assumes you have the base ubuntu distribution set up already.
       </p>
     </td>
     </tr>
     </table>
     <h2>Repositories</h2>
     <pre>
     * 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
     </pre>
     <h2>Ubuntu Package Dependencies</h2>
     <pre>
     * Install the ubuntu package dependencies
         sudo apt-get install tomcat5-webapps postgresql-server-dev-8.1 postgresql-8.1 sun-java5-jdk \
                              apache2 cvs
     </pre>
     <h2>java jdk</h2>
     <pre>
     * 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
     </pre>
     <h2>Checkout Metacat</h2>
     <pre>
     * 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
     </pre>
     <h2>prep postgres</h2>
     <pre>
         # 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 'metacatpass';
           \q
         exit
     </pre>
     <h2>restart postgres</h2>
     <pre>
         sudo /etc/init.d/postgresql-8.1 restart
         # TEST
         psql -U metacat -W -h localhost metacat
     </pre>
     <h2>Build</h2>
     <pre>
        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
     </pre>
     <h2>Postgres configuration</h2>
     <pre>
        psql -U metacat -W -h localhost -f build/src/xmltables-postgres.sql metacat
        ant register-schemas
     </pre>
     <h2>apache / tomcat integration</h2>
     <pre>
         #the instructions at <a href="http://www.ubuntuforums.org/showthread.php?t=219985">http://www.ubuntuforums.org/showthread.php?t=219985</a> 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
     </pre>
     </body>
     </html>

Project

General

Profile

Metacat

Revision 3585

Added by barseghian over 16 years ago