Project

General

Profile

1 3956 tao
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
4
<html xmlns="http://www.w3.org/1999/xhtml">
5
<head>
6
  <meta http-equiv="Content-Type" content=
7
  "text/html; charset=us-ascii" />
8
  <meta name="generator" content="pandoc" />
9
  <style type="text/css">
10
/*<![CDATA[*/
11
  ol.decimal { list-style-type: decimal; }
12 4607 walbridge
	li { padding-bottom: 5px; }
13
	blockquote {
14
		background-color: #f5f5f5;
15
		margin: 10px 15px 5px 20px;
16
		padding: 1px 0px 1px 10px;
17
	}
18
19
	.keyword {
20
		color: #00008b;
21
	}
22
23
	.type {
24
		color: #2b91af;
25
	}
26
27
	.string {
28
		color: #810541;
29
	}
30
31 3956 tao
  /*]]>*/
32
  </style>
33
34
  <title>Metacat Install - Registry</title>
35
  <link rel="stylesheet" type="text/css" href="default.css" />
36
</head>
37
38
<body>
39
  <table class="tabledefault" width="100%">
40
    <tr>
41
      <td rowspan="2"><img src="images/KNBLogo.gif" /></td>
42
43
      <td colspan="7">
44
        <div class="title">
45
          Metacat Installation - Registry
46
        </div>
47
      </td>
48
    </tr>
49
50
    <tr>
51
      <td><a href="/" class="toollink">KNB Home</a></td>
52
53
      <td><a href="/data.html" class="toollink">Data</a></td>
54
55
      <td><a href="/people.html" class="toollink">People</a></td>
56
57
      <td><a href="/informatics" class=
58
      "toollink">Informatics</a></td>
59
60
      <td><a href="/biodiversity" class=
61
      "toollink">Biocomplexity</a></td>
62
63
      <td><a href="/education" class="toollink">Education</a></td>
64
65
      <td><a href="/software" class="toollink">Software</a></td>
66
    </tr>
67
  </table>
68
  <hr />
69
70
  <table class="tabledefault" width="100%">
71
    <tr>
72
      <td class="tablehead" colspan="2">
73
        <p class="emphasis">Installing the Metacat Registry</p>
74
      </td>
75
    </tr>
76
77
    <tr>
78
      <td>Author: Shaun Walbridge<br />
79
      Date: 06/06/2008<br /></td>
80
    </tr>
81
  </table>
82
83
  <h1 id="registry-installation">Registry Installation</h1>
84
85
  <h2 id="whats-it-for">What's it for?</h2>
86
87
  <p>The Metacat Registry provides an easy mechanism to create and
88
  edit simple EML metadata documents, and accounts for your Metacat
89
  users. It is an optional component of Metacat, but is useful when
90
  you need very low barriers to creating simple EML, or have users
91
  unable to use Morpho. The LDAP account management interface is
92
  useful if you are authenticating users against LDAP, and need to
93
  provide a basic mechanism for managing user accounts.</p>
94
95
  <h2 id="installation-instructions">Installation Instructions</h2>
96
97
  <p>The Registry can be installed on any machine Metacat runs on,
98
  but does require additional legwork to get it installed. It
99
  requires that Metacat is set deployed behind Apache, as our
100
  recommended installation platform, and the instructions assume
101
  Apache is already installed and working correctly.</p>
102
103
  <h2 id="steps">Steps</h2>
104
105
  <ol class="decimal">
106
    <li>
107
      <p>Download and extract the Metacat release:</p>
108 4607 walbridge
      <blockquote>
109
<pre><span class="type">mkdir</span> metacat &amp;&amp; cd metacat
110
<span class="type">wget</span> http://knb.ecoinformatics.org/software/dist/metacat-src-1.8.0.zip
111
<span class="type">unzip</span> metacat-src-1.8.0.zip
112
<span class="type">cd</span> metacat-1.8.0
113
<span class="type">export</span> METACAT=`pwd`
114 3956 tao
</pre>
115 4607 walbridge
</blockquote>
116 3956 tao
    </li>
117
118
    <li>
119
      <p>Build the Metacat Perl client library:</p>
120 4607 walbridge
      <blockquote>
121
<pre><span class="type">cd</span> $METACAT/src/perl/Metacat
122
<span class="type">perl</span> Makefile.PL
123
<span class="type">sudo make</span>
124
<span class="type">sudo make install</span>
125 3956 tao
</pre>
126 4607 walbridge
</blockquote>
127 3956 tao
    </li>
128
129
    <li>
130 4607 walbridge
      <p>Install the system libraries needed. On Redhat:
131
      <blockquote>
132
<pre><span class="type">sudo yum install</span> gcc libxml2-devel libxslt-devel ant -y
133 3956 tao
</pre>
134 4607 walbridge
</blockquote>
135 3956 tao
136 4607 walbridge
      On Debian:
137
      <blockquote>
138
			<pre>
139
<span class="type">sudo apt-get install</span> ant libappconfig-perl libxml-libxml-perl libxml-libxslt-perl \
140
libtemplate-perl libcgi-session-perl libdigest-sha1-perl libnet-ldap-perl \
141
libterm-readkey-perl libxml-dom-perl libsoap-lite-perl -y
142
</pre>
143
</blockquote>
144 4366 daigle
	  You will need to install one package using cpan
145 4607 walbridge
      <blockquote><pre><span class="type">sudo cpan</span> -i Config::Properties</pre></blockquote>
146 4366 daigle
147 4607 walbridge
      Debian users should skip ahead to step 7.
148 4009 walbridge
</p>
149 3956 tao
    </li>
150
151
    <li>
152
      <p>Install CPAN, which allows us to install the Perl
153
      dependencies for the registry and account management parts of
154
      Metacat. If asked to manually configure cpan, type 'no' and
155
      CPAN will be setup with its default values.</p>
156 4607 walbridge
      <blockquote>
157
<pre><span class="type">sudo yum install</span> perl-CPAN
158
<span class="type">sudo cpan</span>
159 3956 tao
</pre>
160 4607 walbridge
</blockquote>
161 3956 tao
162
      <p>You should now see a prompt which looks like:</p>
163 4607 walbridge
      <blockquote>
164
<pre><span class="string">cpan&gt;</span>
165 3956 tao
</pre>
166 4607 walbridge
</blockquote>
167 3956 tao
168
      <p>The rest of the commands will assume you're inside of
169
      CPAN. Let's get the most recent version of the CPAN software.
170
      Just press return after any prompts you recieve during this
171
      process.</p>
172 4607 walbridge
      <blockquote>
173
<pre>install Bundle::CPAN
174
reload cpan
175 3956 tao
</pre>
176 4607 walbridge
</blockquote>
177 3956 tao
    </li>
178
179
    <li>
180
      <p>Install the required modules. Here we're installing an old
181
      LibXSLT, as the current one requires a newer libxslt than is
182
      available on Redhat 4 &amp; 5. Again, just answer 'yes' to
183
      any questions.</p>
184 4607 walbridge
      <blockquote>
185
<pre>install AutoLoader
186 3956 tao
install CGI
187
install CGI::SEssion
188 4009 walbridge
install LWP::UserAgent
189 3956 tao
install Net::LDAP
190
install Template
191
install URI
192
install MSERGEANT/XML-LibXSLT-1.58.tar.gz
193
</pre>
194 4607 walbridge
</blockquote>
195 3956 tao
    </li>
196
197
    <li>
198
      <p>Now visit the resulting URL:</p>
199 4607 walbridge
      <blockquote>
200 4610 walbridge
<pre>http://localhost/knb/cgi-bin/register-dataset.cgi?cfg=nceas
201 3956 tao
</pre>
202 4607 walbridge
</blockquote>
203 3956 tao
204
      <p>If everything worked correctly, you should see a page like
205
      this: <img src="images/registry-login.jpg" alt=
206
      "Registry Login Page" /></p>
207
    </li>
208
  </ol>
209
210
  <h2 id="installing-the-nceas-registry">Installing the NCEAS
211
  Registry</h2>
212
213
  <p>These are special instructions required for the NCEAS skin to
214
  get a current projects list from the AdminDB, and can safely be
215
  ignored in all other uses.</p>
216
217
  <ol class="decimal">
218
    <li>
219
      <p>Download and install the Oracle Instant Client RPMs. These
220
      can be obtained from the <a href=
221
      "http://www.oracle.com/technology/software/tech/oci/instantclient/htdocs/linuxsoft.html">
222
      oracle website</a>.</p>
223 4607 walbridge
      <blockquote>
224 4610 walbridge
<pre><span class="type">rpm -i</span> oracle-instantclient-basic-10.2.0.3-1.i386.rpm
225
<span class="type">rpm -i</span> oracle-instantclient-devel-10.2.0.3-1.i386.rpm
226
<span class="type">rpm -i</span> oracle-instantclient-sqlplus-10.2.0.3-1.i386.rpm
227 3956 tao
</pre>
228 4607 walbridge
</blockquote>
229 3956 tao
    </li>
230
231
    <li>
232 4607 walbridge
      <p>Next, we'll need an <pre>tnsnames.ora</pre> file for
233 3956 tao
      Oracle to locate the server we're connecting to. In this
234
      example, we'll copy it from a remote location:</p>
235 4607 walbridge
      <blockquote>
236 4610 walbridge
<pre><span class="type">mkdir -p</span> /usr/lib/oracle/10.2.0.3/network/admin/ &amp;&amp; <span class="type">cd !$</span>
237
<span class="type">scp</span> walbridge@knb.ecoinformatics.org:/usr/lib/oracle/10.1.0.4/network/admin/tnsnames.ora .
238 3956 tao
</pre>
239 4607 walbridge
</blockquote>
240 3956 tao
    </li>
241
242
    <li>
243
      <p>The AdminDB is accessed via Perl, so install the needed
244
      Oracle driver using CPAN:</p>
245 4607 walbridge
      <blockquote>
246
<pre>cpan
247 3956 tao
install DBI
248
install DBD::Oracle
249
</pre>
250 4607 walbridge
</blockquote>
251 3956 tao
    </li>
252
253
    <li>
254
      <p>Now we can install the AdminDB module itself:</p>
255 4607 walbridge
      <blockquote>
256
<pre>mkdir -p ~/projects/admindb &amp;&amp; cd !$
257 3956 tao
export CVSROOT=:ext:walbridge@cvs.nceas.ucsb.edu:/cvsnceas
258
cvs co admindb
259
cd admindb/perl/NCEAS/AdminDB
260
perl Makefile.PL
261
make
262
sudo make install
263
</pre>
264 4607 walbridge
</blockquote>
265 3956 tao
    </li>
266
267
    <li>
268
      <p>Finally, set the correct properties in the
269 4607 walbridge
      <pre>nceas.cfg</pre> file:</p>
270
      <blockquote>
271
<pre>nceas_db = //hyperion.nceas.ucsb.edu:1521/nceasp.nceas.ucsb.edu
272 3956 tao
nceas_db_user = admowner
273
nceas_db_password = NCEAS_DB_READ_PASSWORD_HERE
274
</pre>
275 4607 walbridge
</blockquote>
276 3956 tao
    </li>
277
278
    <li>
279 4607 walbridge
      <p>A quick check of <pre>register-dataset.cgi</pre> should
280 3956 tao
      now show a complete list of projects: <img src=
281
      "images/registry-nceas-projects.png" alt=
282
      "NCEAS Project list" /></p>
283
    </li>
284
  </ol>
285
286
  <h2 id="notes">Notes</h2>
287
288
  <p>Redhat based, tested on Centos 5</p>
289
290
  <p>Debian based, tested on Ubuntu 8.04</p>
291
</body>
292
</html>