Project

General

Profile

1 4602 daigle
<!--
2
  *   '$RCSfile$'
3
  *     Purpose: web page describing the installation of Metacat
4
  *   Copyright: 2008 Regents of the University of California and the
5
  *               National Center for Ecological Analysis and Synthesis
6
  *     Authors: Chad Berkley
7
  *
8
  *    '$Author: daigle $'
9
  *    '$Date: 2008-11-19 16:48:24 -0800 (Wed, 19 Nov 2008) $'
10
  *    '$Revision: 4597 $'
11
  *
12
  *
13
  -->
14
15
<!DOCTYPE html PUBLIC "-//W3C//DTD html 4.0//EN">
16
<html>
17
18
<head>
19
  <title>Metacat Configuration Instructions</title>
20
  <link rel="stylesheet" type="text/css" href="./common.css">
21
  <link rel="stylesheet" type="text/css" href="./default.css">
22
</head>
23
24
<body>
25
26
<table class="tabledefault" width="100%">
27
<tr><td rowspan="2"><img src="./images/KNBLogo.gif"></td>
28
<td colspan="7">
29
<div class="title">Metacat Configuration</div>
30
</td>
31
</tr>
32
<tr>
33
  <td><a href="/" class="toollink"> KNB Home </a></td>
34
  <td><a href="/data.html" class="toollink"> Data </a></td>
35
  <td><a href="/people.html" class="toollink"> People </a></td>
36
  <td><a href="/informatics" class="toollink"> Informatics </a></td>
37
  <td><a href="/biodiversity" class="toollink"> Biocomplexity </a></td>
38
  <td><a href="/education" class="toollink"> Education </a></td>
39
  <td><a href="/software" class="toollink"> Software </a></td>
40
</tr>
41
</table>
42
<hr>
43
44
<div class="header1">Table of Contents</div>
45
<div class="toc">
46
  <div class="toc1"><a href="#InstallationIssues">Installation Issues</a></div>
47 4609 daigle
    <div class="toc2"><a href="#Issue1">Issue 1</a></div>
48
    <div class="toc2"><a href="#Issue2">Issue 2</a></div>
49 4602 daigle
  <div class="toc1"><a href="#StartupIssues">Startup Issues</a></div>
50 4609 daigle
    <div class="toc2"><a href="#Jdk14Logger">Metacat doesn't start and Jdk14Logger exception</a></div>
51 4602 daigle
  <div class="toc1"><a href="#ConfigurationIssues">Configuration Issues</a></div>
52
  <div class="toc1"><a href="#GeneralApplicationIssues">General Application Issues</a></div>
53
  <div class="toc1"><a href="#UnitTestingIssues">Unit Testing Issues</a></div>
54
</div>
55
56
<a name="InstallationIssues"></a><div class="header1">Installation Issues</div>
57
<a name="Issue1"></a><div class="header2">Issue 1</div>
58
  <p>Issue 1 here</p>
59
<a name="Issue2"></a><div class="header2">Issue 2</div>
60
  <p>Issue 2 here</p>
61
62
<a name="StartupIssues"></a><div class="header1">Startup Issues</div>
63 4609 daigle
	<a name="Jdk14Logger"></a><div class="header2">Metacat doesn't start and Jdk14Logger exception</div>
64
	<p>The symptoms are that the metacat service will not show up at all, even though Tomcat
65
      is serving, and the following error shows up in the tomcat log (catalina.log):</p>
66
67
      <div class="code">org.apache.commons.logging.LogConfigurationException: User-specified log
68
      class 'org.apache.commons.logging.impl.Jdk14Logger' cannot be found or is
69
      not useable </div>
70
71
      <p>This message typically occurs in the tomcat log (catalina.log)
72
      when Tomcat has been installed on an Ubuntu/Debian system using apt-get install.
73
      And the application is started using:
74
75
        <div class="code">/etc/init.d/tomcat5.5 start</div>
76
77
      <p>The problem is that the standard startup scripts reference the
78
      common java service, jsvc.  Metacat will not run under jsvc.  The solutions are:
79
      <ul>
80
      <li>Download the <a href="http://knb.ecoinformatics.org/software/download.html">Metacat binary install package</a>
81
       and replace your /etc/init.d/tomcat5.5 startup script with the one provided in the
82
       package.</li>
83
      <li>Run Tomcat from the Tomcat binary directory: <tomcat_home>/bin/startup.sh and
84
      <tomcat_home>/bin/shutdown.sh</li>
85
      </ul>
86
      </p>
87 4602 daigle
<a name="ConfigurationIssues"></a><div class="header1">Configuration Issues</div>
88
89
<a name="GeneralApplicationIssues"></a><div class="header1">General Application Issues</div>
90
91
<a name="UnitTestingIssues"></a><div class="header1">Unit Testing Issues</div>