| 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 && 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 |
4947
|
daigle
|
<pre><span class="type">sudo yum install</span> gcc libxml2-devel libxslt-devel ant openssl -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 |
4934
|
walbridge
|
libterm-readkey-perl libxml-dom-perl libsoap-lite-perl libio-socket-ssl-perl -y
|
| 142 |
4607
|
walbridge
|
</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 |
4768
|
daigle
|
<blockquote><pre><span class="type">sudo cpan</span> -i scalar::util</pre></blockquote>
|
| 147 |
4366
|
daigle
|
|
| 148 |
4615
|
walbridge
|
Debian users should skip ahead to step 6.
|
| 149 |
4009
|
walbridge
|
</p>
|
| 150 |
3956
|
tao
|
</li>
|
| 151 |
|
|
|
| 152 |
|
|
<li>
|
| 153 |
|
|
<p>Install CPAN, which allows us to install the Perl
|
| 154 |
|
|
dependencies for the registry and account management parts of
|
| 155 |
|
|
Metacat. If asked to manually configure cpan, type 'no' and
|
| 156 |
|
|
CPAN will be setup with its default values.</p>
|
| 157 |
4607
|
walbridge
|
<blockquote>
|
| 158 |
|
|
<pre><span class="type">sudo yum install</span> perl-CPAN
|
| 159 |
|
|
<span class="type">sudo cpan</span>
|
| 160 |
3956
|
tao
|
</pre>
|
| 161 |
4607
|
walbridge
|
</blockquote>
|
| 162 |
3956
|
tao
|
|
| 163 |
|
|
<p>You should now see a prompt which looks like:</p>
|
| 164 |
4607
|
walbridge
|
<blockquote>
|
| 165 |
|
|
<pre><span class="string">cpan></span>
|
| 166 |
3956
|
tao
|
</pre>
|
| 167 |
4607
|
walbridge
|
</blockquote>
|
| 168 |
3956
|
tao
|
|
| 169 |
|
|
<p>The rest of the commands will assume you're inside of
|
| 170 |
|
|
CPAN. Let's get the most recent version of the CPAN software.
|
| 171 |
|
|
Just press return after any prompts you recieve during this
|
| 172 |
|
|
process.</p>
|
| 173 |
4607
|
walbridge
|
<blockquote>
|
| 174 |
|
|
<pre>install Bundle::CPAN
|
| 175 |
|
|
reload cpan
|
| 176 |
3956
|
tao
|
</pre>
|
| 177 |
4607
|
walbridge
|
</blockquote>
|
| 178 |
3956
|
tao
|
</li>
|
| 179 |
|
|
|
| 180 |
|
|
<li>
|
| 181 |
|
|
<p>Install the required modules. Here we're installing an old
|
| 182 |
|
|
LibXSLT, as the current one requires a newer libxslt than is
|
| 183 |
|
|
available on Redhat 4 & 5. Again, just answer 'yes' to
|
| 184 |
|
|
any questions.</p>
|
| 185 |
4607
|
walbridge
|
<blockquote>
|
| 186 |
|
|
<pre>install AutoLoader
|
| 187 |
3956
|
tao
|
install CGI
|
| 188 |
4822
|
daigle
|
install CGI::Session
|
| 189 |
4009
|
walbridge
|
install LWP::UserAgent
|
| 190 |
4934
|
walbridge
|
install IO::Socket:SSL
|
| 191 |
3956
|
tao
|
install Net::LDAP
|
| 192 |
|
|
install Template
|
| 193 |
|
|
install URI
|
| 194 |
|
|
install MSERGEANT/XML-LibXSLT-1.58.tar.gz
|
| 195 |
4822
|
daigle
|
install Digest::SHA1
|
| 196 |
4947
|
daigle
|
install Crypt::SSLeay
|
| 197 |
3956
|
tao
|
</pre>
|
| 198 |
4607
|
walbridge
|
</blockquote>
|
| 199 |
3956
|
tao
|
</li>
|
| 200 |
|
|
|
| 201 |
4615
|
walbridge
|
<li>
|
| 202 |
|
|
<p>Double check that Metacat's temporary folder, <code><span class="string">application.tempDir</span></code>, is writable by the apache user, usually <code><span class="string">www-data</span></code> or <code><span class="string">apache</span></code>.
|
| 203 |
3956
|
tao
|
<li>
|
| 204 |
|
|
<p>Now visit the resulting URL:</p>
|
| 205 |
4607
|
walbridge
|
<blockquote>
|
| 206 |
4610
|
walbridge
|
<pre>http://localhost/knb/cgi-bin/register-dataset.cgi?cfg=nceas
|
| 207 |
3956
|
tao
|
</pre>
|
| 208 |
4607
|
walbridge
|
</blockquote>
|
| 209 |
3956
|
tao
|
|
| 210 |
|
|
<p>If everything worked correctly, you should see a page like
|
| 211 |
|
|
this: <img src="images/registry-login.jpg" alt=
|
| 212 |
|
|
"Registry Login Page" /></p>
|
| 213 |
|
|
</li>
|
| 214 |
|
|
</ol>
|
| 215 |
|
|
|
| 216 |
|
|
<h2 id="installing-the-nceas-registry">Installing the NCEAS
|
| 217 |
|
|
Registry</h2>
|
| 218 |
|
|
|
| 219 |
|
|
<p>These are special instructions required for the NCEAS skin to
|
| 220 |
|
|
get a current projects list from the AdminDB, and can safely be
|
| 221 |
|
|
ignored in all other uses.</p>
|
| 222 |
|
|
|
| 223 |
|
|
<ol class="decimal">
|
| 224 |
|
|
<li>
|
| 225 |
|
|
<p>Download and install the Oracle Instant Client RPMs. These
|
| 226 |
|
|
can be obtained from the <a href=
|
| 227 |
|
|
"http://www.oracle.com/technology/software/tech/oci/instantclient/htdocs/linuxsoft.html">
|
| 228 |
|
|
oracle website</a>.</p>
|
| 229 |
4607
|
walbridge
|
<blockquote>
|
| 230 |
4610
|
walbridge
|
<pre><span class="type">rpm -i</span> oracle-instantclient-basic-10.2.0.3-1.i386.rpm
|
| 231 |
|
|
<span class="type">rpm -i</span> oracle-instantclient-devel-10.2.0.3-1.i386.rpm
|
| 232 |
|
|
<span class="type">rpm -i</span> oracle-instantclient-sqlplus-10.2.0.3-1.i386.rpm
|
| 233 |
3956
|
tao
|
</pre>
|
| 234 |
4607
|
walbridge
|
</blockquote>
|
| 235 |
3956
|
tao
|
</li>
|
| 236 |
|
|
|
| 237 |
|
|
<li>
|
| 238 |
4607
|
walbridge
|
<p>Next, we'll need an <pre>tnsnames.ora</pre> file for
|
| 239 |
3956
|
tao
|
Oracle to locate the server we're connecting to. In this
|
| 240 |
|
|
example, we'll copy it from a remote location:</p>
|
| 241 |
4607
|
walbridge
|
<blockquote>
|
| 242 |
4610
|
walbridge
|
<pre><span class="type">mkdir -p</span> /usr/lib/oracle/10.2.0.3/network/admin/ && <span class="type">cd !$</span>
|
| 243 |
|
|
<span class="type">scp</span> walbridge@knb.ecoinformatics.org:/usr/lib/oracle/10.1.0.4/network/admin/tnsnames.ora .
|
| 244 |
3956
|
tao
|
</pre>
|
| 245 |
4607
|
walbridge
|
</blockquote>
|
| 246 |
3956
|
tao
|
</li>
|
| 247 |
|
|
|
| 248 |
|
|
<li>
|
| 249 |
|
|
<p>The AdminDB is accessed via Perl, so install the needed
|
| 250 |
|
|
Oracle driver using CPAN:</p>
|
| 251 |
4607
|
walbridge
|
<blockquote>
|
| 252 |
|
|
<pre>cpan
|
| 253 |
3956
|
tao
|
install DBI
|
| 254 |
|
|
install DBD::Oracle
|
| 255 |
|
|
</pre>
|
| 256 |
4607
|
walbridge
|
</blockquote>
|
| 257 |
3956
|
tao
|
</li>
|
| 258 |
|
|
|
| 259 |
|
|
<li>
|
| 260 |
|
|
<p>Now we can install the AdminDB module itself:</p>
|
| 261 |
4607
|
walbridge
|
<blockquote>
|
| 262 |
|
|
<pre>mkdir -p ~/projects/admindb && cd !$
|
| 263 |
3956
|
tao
|
export CVSROOT=:ext:walbridge@cvs.nceas.ucsb.edu:/cvsnceas
|
| 264 |
|
|
cvs co admindb
|
| 265 |
|
|
cd admindb/perl/NCEAS/AdminDB
|
| 266 |
|
|
perl Makefile.PL
|
| 267 |
|
|
make
|
| 268 |
|
|
sudo make install
|
| 269 |
|
|
</pre>
|
| 270 |
4607
|
walbridge
|
</blockquote>
|
| 271 |
3956
|
tao
|
</li>
|
| 272 |
|
|
|
| 273 |
|
|
<li>
|
| 274 |
|
|
<p>Finally, set the correct properties in the
|
| 275 |
4607
|
walbridge
|
<pre>nceas.cfg</pre> file:</p>
|
| 276 |
|
|
<blockquote>
|
| 277 |
|
|
<pre>nceas_db = //hyperion.nceas.ucsb.edu:1521/nceasp.nceas.ucsb.edu
|
| 278 |
3956
|
tao
|
nceas_db_user = admowner
|
| 279 |
|
|
nceas_db_password = NCEAS_DB_READ_PASSWORD_HERE
|
| 280 |
|
|
</pre>
|
| 281 |
4607
|
walbridge
|
</blockquote>
|
| 282 |
3956
|
tao
|
</li>
|
| 283 |
|
|
|
| 284 |
|
|
<li>
|
| 285 |
4607
|
walbridge
|
<p>A quick check of <pre>register-dataset.cgi</pre> should
|
| 286 |
3956
|
tao
|
now show a complete list of projects: <img src=
|
| 287 |
|
|
"images/registry-nceas-projects.png" alt=
|
| 288 |
|
|
"NCEAS Project list" /></p>
|
| 289 |
|
|
</li>
|
| 290 |
|
|
</ol>
|
| 291 |
|
|
|
| 292 |
|
|
<h2 id="notes">Notes</h2>
|
| 293 |
|
|
|
| 294 |
|
|
<p>Redhat based, tested on Centos 5</p>
|
| 295 |
|
|
|
| 296 |
|
|
<p>Debian based, tested on Ubuntu 8.04</p>
|
| 297 |
|
|
</body>
|
| 298 |
|
|
</html>
|