Metacat

<td class="tablehead" colspan="2"><p class="emphasis">Operating System Specific Instructions</p></td>

<tr>

<td>

  <p class="emphasis">

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_mac.html">Installing from CVS source on Mac OS X</a> </li>

  </ul>

</td>

</tr>

</table>

<table class="tabledefault" width="100%">

<h2>Installing Metacat on Mac OSX (10.4.10)</h2>

Author: Matthew Perry, Derik Barseghian<br />

Date: 11/05/2007<br />

<p>

This is a terse cheatsheet for metacat with postgres on os X. Please see metacat_install_instructs.html for the full details.

</p>

<h2>* pre-requirements</h2>

<h3>install ant, postgres, tomcat using macports</h3>

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

</p>

<p>

launch a terminal

</p>

<pre>

sudo port -d sync

sudo port search ant

sudo port install ant

sudo port search postgres

sudo port install postgresql82

sudo port search tomcat

sudo port install tomcat5

</pre>

<h2>* metacat install</h2>

<h3>setup database</h3>

<pre>

cd /opt/local/lib/postgresql82/

sudo mkdir data

chown -R yourusername.yourusername data

cd data

../bin/initdb -D data

../bin/pg_ctl -D data -l logfile start

../bin/createdb metacat

../bin/psql -d metacat

metacat=> create user metacat with unencrypted password 'metacat';

metacat=> \q

</pre>

<p>

test password:

</p>

<pre>

	../bin/psql -U metacat -W -h localhost metacat

	Password for user metacat:

	metacat=> \q

cd /opt/local/share/java/tomcat5

sudo mkdir -p data/metacat/data

sudo mkdir -p data/metacat/inlinedata

chown -R yourusername.yourusername data

bin/initdb -D data

bin/pg_ctl -D data -l logfile start

bin/createdb metacat

bin/psql -d metacat

metacat=> create user metacat with unencrypted password 'yourpassword';

metacat=> \q

</pre>

<p>

Add to data/pg_hba.conf:

</p>

<pre>

	host metacat metacat 127.0.0.1 255.255.255.255 password

bin/pg_ctl -D data -l logfile restart

psql -U metacat -W -h localhost metacat

</pre>

<h3>checkout metacat</h3>

<pre>

mkdir ~/cvs_src/

cd ~/cvs_src

export CVS_RSH="/usr/bin/ssh"

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

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

</pre>

<h3>edit build.properties as needed</h3>

<pre>

tomcat=/opt/local/share/java/tomcat5

deploy.dir=/opt/local/share/java/tomcat5/webapps/

config.hostname=localhost

config.port=8080

config.port.https=8443

datafilepath=/opt/local/share/java/tomcat5/data/metacat/data

inlinedatafilepath=/opt/local/share/java/tomcat5/data/metacat/inlinedata

</pre>

<p>

if your mac username is different from your cvs name, hardcode hack:

</p>

<pre>

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

log.dir=/opt/local/share/java/tomcat5/logs

metacat.dir=/Users/yourname/nceas/metacat

</pre>

<h3>install metacat</h3>

<pre>

cd metacat

sudo ant install

</pre>

<p>

Enter your cvs password a few times...

</p>

<pre>

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

ant register-schemas

</pre>

<p>Restart tomcat</p>

<pre>

sudo /opt/local/share/java/tomcat5/bin/shutdown.sh

sudo /opt/local/share/java/tomcat5/bin/startup.sh

</pre>

<p>

Point your browser to http://localhost:8080/knb/ and you should be in business.

</p>

<p>

After restarting, you'll need to fire off the following commands in order to start up postgres/tomcat again:

# 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

</p>

<pre>

/Users/nceas/Apps/apache-tomcat-5.5.20/bin/shutdown.sh

/Users/nceas/Apps/postgres/bin/pg_ctl -D /Users/nceas/Apps/postgres/data/ -l /Users/nceas/Apps/postgres/logfile -m fast stop

</pre>

<p>

You can create two shell scripts with the preceeding commands; start_metacat.sh and stop_metacat.sh

</p>