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 3633 barseghian
  <link rel="stylesheet" type="text/css" href="@docrooturl../@default.css">
7 3585 barseghian
</head>
8
9
<body>
10
11
<table class="tabledefault" width="100%">
12 3633 barseghian
<tr><td rowspan="2"><img src="@docrooturl../@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
  <td><a href="@server@/" class="toollink"> KNB Home </a></td>
19
  <td><a href="@server@/data.html" class="toollink"> Data </a></td>
20
  <td><a href="@server@/people.html" class="toollink"> People </a></td>
21
  <td><a href="@server@/informatics" class="toollink"> Informatics </a></td>
22
  <td><a href="@server@/biodiversity" class="toollink"> Biocomplexity </a></td>
23
  <td><a href="@server@/education" class="toollink"> Education </a></td>
24
  <td><a href="@server@/software" class="toollink"> Software </a></td>
25
</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
110
bin/initdb -D data
111
bin/pg_ctl -D data -l logfile start
112
bin/createdb metacat
113
bin/psql -d metacat
114
metacat=> create user metacat with unencrypted password 'yourpassword';
115
metacat=> \q
116
</pre>
117
118
<p>
119
Add to data/pg_hba.conf:
120
</p>
121
<pre>
122
	host metacat metacat 127.0.0.1 255.255.255.255 password
123
124
bin/pg_ctl -D data -l logfile restart
125
psql -U metacat -W -h localhost metacat
126
</pre>
127
128
129 3585 barseghian
<h2>Checkout Metacat</h2>
130 3573 barseghian
<pre>
131
mkdir ~/cvs_src/
132
cd ~/cvs_src
133
export CVS_RSH="/usr/bin/ssh"
134
cvs -d:ext:your_cvs_name@cvs.ecoinformatics.org:/cvs co metacat
135
cvs -d:ext:your_cvs_name@cvs.ecoinformatics.org:/cvs co utilities
136
</pre>
137
138 3585 barseghian
<h2>Edit build.properties as needed</h2>
139 3573 barseghian
140
<pre>
141
tomcat=/opt/local/share/java/tomcat5
142
deploy.dir=/opt/local/share/java/tomcat5/webapps/
143
config.hostname=localhost
144
config.port=8080
145
config.port.https=8443
146
147
datafilepath=/opt/local/share/java/tomcat5/data/metacat/data
148
inlinedatafilepath=/opt/local/share/java/tomcat5/data/metacat/inlinedata
149
</pre>
150
151
<p>
152
if your mac username is different from your cvs name, hardcode hack:
153
</p>
154
<pre>
155
	cvsroot=:ext:yourcvsname@cvs.ecoinformatics.org:/cvs
156
157
log.dir=/opt/local/share/java/tomcat5/logs
158
metacat.dir=/Users/yourname/nceas/metacat
159
</pre>
160
161 3585 barseghian
<h2>Install Metacat</h2>
162 3573 barseghian
<pre>
163
cd metacat
164
sudo ant install
165
</pre>
166
167
<p>
168
Enter your cvs password a few times...
169
</p>
170
171
<pre>
172
psql82 -U metacat -W -h localhost -f build/src/xmltables-postgres.sql metacat
173
ant register-schemas
174
</pre>
175
176
<p>Restart tomcat</p>
177
<pre>
178
sudo /opt/local/share/java/tomcat5/bin/shutdown.sh
179
sudo /opt/local/share/java/tomcat5/bin/startup.sh
180
</pre>
181
182
<p>
183
Point your browser to http://localhost:8080/knb/ and you should be in business.
184
</p>
185
186
<p>
187
After restarting, you'll need to fire off the following commands in order to start up postgres/tomcat again:
188
</p>
189 3585 barseghian
<p>
190
Startup
191
</p>
192 3573 barseghian
<pre>
193
/Users/nceas/Apps/postgres/bin/pg_ctl -D /Users/nceas/Apps/postgres/data/ -l /Users/nceas/Apps/postgres/logfile -m fast start
194
/Users/nceas/Apps/apache-tomcat-5.5.20/bin/startup.sh
195
</pre>
196
197
<p>
198 3585 barseghian
Shutdown
199 3573 barseghian
</p>
200
<pre>
201
/Users/nceas/Apps/apache-tomcat-5.5.20/bin/shutdown.sh
202
/Users/nceas/Apps/postgres/bin/pg_ctl -D /Users/nceas/Apps/postgres/data/ -l /Users/nceas/Apps/postgres/logfile -m fast stop
203
</pre>
204
205
<p>
206
You can create two shell scripts with the preceeding commands; start_metacat.sh and stop_metacat.sh
207
</p>
208 3585 barseghian
209
210
</body>
211
</html>