Project

General

Profile

1 3585 barseghian
<!DOCTYPE html PUBLIC "-//W3C//DTD html 4.0//EN">
2
<html>
3 3573 barseghian
4 3585 barseghian
<head>
5
  <title>Metacat Install - Mac OS X</title>
6 3780 daigle
  <link rel="stylesheet" type="text/css" href="./../default.css">
7 3585 barseghian
</head>
8
9
<body>
10
11
<table class="tabledefault" width="100%">
12 3780 daigle
<tr><td rowspan="2"><img src="./../images/KNBLogo.gif"></td>
13 3585 barseghian
<td colspan="7">
14
<div class="title">Metacat Install - Mac OS X</div>
15
</td>
16
</tr>
17
<tr>
18 3660 barteau
  <td><a href="/" class="toollink"> KNB Home </a></td>
19
  <td><a href="/data.html" class="toollink"> Data </a></td>
20
  <td><a href="/people.html" class="toollink"> People </a></td>
21
  <td><a href="/informatics" class="toollink"> Informatics </a></td>
22
  <td><a href="/biodiversity" class="toollink"> Biocomplexity </a></td>
23
  <td><a href="/education" class="toollink"> Education </a></td>
24
  <td><a href="/software" class="toollink"> Software </a></td>
25 3585 barseghian
</tr>
26
</table>
27
<hr>
28
29
<table class="tabledefault" width="100%">
30
<td class="tablehead" colspan="2"><p class="emphasis">Installing Metacat on Mac OSX (10.4.10)</p></td>
31
<tr>
32
<td>
33 3573 barseghian
<p>
34 3585 barseghian
Author: Matthew Perry<br />
35
Date: 11/9/2006<br />
36
Updated: 11/04/07 Derik Barseghian<br />
37 3573 barseghian
</p>
38
39 3585 barseghian
  <p class="emphasis">
40
	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.
41
  </p>
42
</td>
43
</tr>
44
</table>
45
46
<table class="tabledefault" width="100%">
47
<td class="tablehead" colspan="2"><p class="emphasis">Pre-Requirements</p></td>
48
<tr>
49
<td>
50
</td>
51
</tr>
52
</table>
53
54
<h2>Install ant, postgres, tomcat using macports</h2>
55 3573 barseghian
<p>Alternatively, download and install ant, postgres and tomcat from source or using fink.</p>
56
<p>
57
install <a href="http://www.macports.org/">macports</a>.
58
</p>
59
60
<p>
61
launch a terminal
62
</p>
63
64
<pre>
65
sudo port -d sync
66
sudo port search ant
67
sudo port install ant
68
sudo port search postgres
69
sudo port install postgresql82
70
sudo port search tomcat
71
sudo port install tomcat5
72
</pre>
73
74 3585 barseghian
<table class="tabledefault" width="100%">
75
<td class="tablehead" colspan="2"><p class="emphasis">Metacat Install</p></td>
76
<tr>
77
<td>
78
</td>
79
</tr>
80
</table>
81 3573 barseghian
82 3585 barseghian
<h2>Setup Postgres Database</h2>
83 3573 barseghian
<pre>
84
cd /opt/local/lib/postgresql82/
85
sudo mkdir data
86
chown -R yourusername.yourusername data
87
cd data
88
../bin/initdb -D data
89
../bin/pg_ctl -D data -l logfile start
90
../bin/createdb metacat
91
../bin/psql -d metacat
92
metacat=> create user metacat with unencrypted password 'metacat';
93
metacat=> \q
94
</pre>
95
96
<p>
97
test password:
98
</p>
99
<pre>
100
	../bin/psql -U metacat -W -h localhost metacat
101
	Password for user metacat:
102
	metacat=> \q
103
104
cd /opt/local/share/java/tomcat5
105
sudo mkdir -p data/metacat/data
106
sudo mkdir -p data/metacat/inlinedata
107
chown -R yourusername.yourusername data
108
109
</pre>
110
111
<p>
112
Add to data/pg_hba.conf:
113
</p>
114
<pre>
115
	host metacat metacat 127.0.0.1 255.255.255.255 password
116
117
bin/pg_ctl -D data -l logfile restart
118
psql -U metacat -W -h localhost metacat
119
</pre>
120
121
122 3585 barseghian
<h2>Checkout Metacat</h2>
123 3573 barseghian
<pre>
124
mkdir ~/cvs_src/
125
cd ~/cvs_src
126
export CVS_RSH="/usr/bin/ssh"
127
cvs -d:ext:your_cvs_name@cvs.ecoinformatics.org:/cvs co metacat
128
cvs -d:ext:your_cvs_name@cvs.ecoinformatics.org:/cvs co utilities
129
</pre>
130
131 3585 barseghian
<h2>Edit build.properties as needed</h2>
132 3573 barseghian
133
<pre>
134
tomcat=/opt/local/share/java/tomcat5
135
deploy.dir=/opt/local/share/java/tomcat5/webapps/
136
config.hostname=localhost
137
config.port=8080
138
config.port.https=8443
139
140
datafilepath=/opt/local/share/java/tomcat5/data/metacat/data
141
inlinedatafilepath=/opt/local/share/java/tomcat5/data/metacat/inlinedata
142
</pre>
143
144
<p>
145
if your mac username is different from your cvs name, hardcode hack:
146
</p>
147
<pre>
148
	cvsroot=:ext:yourcvsname@cvs.ecoinformatics.org:/cvs
149
150
log.dir=/opt/local/share/java/tomcat5/logs
151
metacat.dir=/Users/yourname/nceas/metacat
152
</pre>
153
154 3585 barseghian
<h2>Install Metacat</h2>
155 3573 barseghian
<pre>
156
cd metacat
157
sudo ant install
158
</pre>
159
160
<p>
161
Enter your cvs password a few times...
162
</p>
163
164
<pre>
165
psql82 -U metacat -W -h localhost -f build/src/xmltables-postgres.sql metacat
166
ant register-schemas
167
</pre>
168
169
<p>Restart tomcat</p>
170
<pre>
171
sudo /opt/local/share/java/tomcat5/bin/shutdown.sh
172
sudo /opt/local/share/java/tomcat5/bin/startup.sh
173
</pre>
174
175
<p>
176
Point your browser to http://localhost:8080/knb/ and you should be in business.
177
</p>
178
179
<p>
180
After restarting, you'll need to fire off the following commands in order to start up postgres/tomcat again:
181
</p>
182 3585 barseghian
<p>
183
Startup
184
</p>
185 3573 barseghian
<pre>
186
/Users/nceas/Apps/postgres/bin/pg_ctl -D /Users/nceas/Apps/postgres/data/ -l /Users/nceas/Apps/postgres/logfile -m fast start
187
/Users/nceas/Apps/apache-tomcat-5.5.20/bin/startup.sh
188
</pre>
189
190
<p>
191 3585 barseghian
Shutdown
192 3573 barseghian
</p>
193
<pre>
194
/Users/nceas/Apps/apache-tomcat-5.5.20/bin/shutdown.sh
195
/Users/nceas/Apps/postgres/bin/pg_ctl -D /Users/nceas/Apps/postgres/data/ -l /Users/nceas/Apps/postgres/logfile -m fast stop
196
</pre>
197
198
<p>
199
You can create two shell scripts with the preceeding commands; start_metacat.sh and stop_metacat.sh
200
</p>
201 3585 barseghian
202
203
</body>
204
</html>