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="./../default.css">
7
</head>
8

    
9
<body>
10

    
11
<table class="tabledefault" width="100%">
12
<tr><td rowspan="2"><img src="./../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="/" 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
</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="../metacat-install.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
</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
<h2>Checkout Metacat</h2>
123
<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
<h2>Edit build.properties as needed</h2>
132

    
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
<h2>Install Metacat</h2>
155
<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
<p>
183
Startup
184
</p>
185
<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
Shutdown
192
</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

    
202

    
203
</body>
204
</html>
(1-1/6)