Project

General

Profile

1
<!DOCTYPE html PUBLIC "-//W3C//DTD html 4.0//EN">
2
<html>
3

    
4
<head>
5
  <title>Metacat Install - Mac OS X</title>
6
  <link rel="stylesheet" type="text/css" href="@docrooturl../@default.css">
7
</head>
8

    
9
<body>
10

    
11
<table class="tabledefault" width="100%">
12
<tr><td rowspan="2"><img src="@docrooturl../@images/KNBLogo.gif"></td>
13
<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
<p>
34
Author: Matthew Perry<br />
35
Date: 11/9/2006<br />
36
Updated: 11/04/07 Derik Barseghian<br />
37
</p>
38

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

    
82
<h2>Setup Postgres Database</h2>
83
<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
<h2>Checkout Metacat</h2>
130
<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
<h2>Edit build.properties as needed</h2>
139

    
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
<h2>Install Metacat</h2>
162
<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
<p>
190
Startup
191
</p>
192
<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
Shutdown
199
</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

    
209

    
210
</body>
211
</html>
(1-1/6)