Project

General

Profile

1
<!-- 
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="#BuildIssues">Build Issues</a></div>
47
    <div class="toc2"><a href="#HttpServletExceptions">Ant BUILD FAILED : Multiple HttpServlet Exceptions</a></div> 
48
  <div class="toc1"><a href="#InstallationIssues">Installation Issues</a></div>
49
  <div class="toc1"><a href="#StartupIssues">Startup Issues</a></div>
50
    <div class="toc2"><a href="#Jdk14Logger">Metacat doesn't start and Jdk14Logger exception</a></div> 
51
  <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 class="toc2"><a href="#503ServiceTemporarilyUnavailable">Mutliple Tests Fail : 503 Service Temporarily Unavailable</a></div>
55
</div> 
56

    
57
<a name="BuildIssues"></a><div class="header1">Build Issues</div>
58
  <a name="HttpServletExceptions"></a><div class="header2">Ant BUILD FAILED : Multiple HttpSevlet Exceptions</div>
59
    <p>During an Ant build of Metacat, you will see many HttpServletRequest, HttpServletResponse and
60
    other errors.  The compiler will complain that it cannot find a symbol, for example:</p>
61
      <div class="code">
62
      [javac] /home/daigle/workspace/metacat/build/src/edu/ucsb/nceas/metacat/MetaCatServlet.java:506: cannot find symbol<br>
63
      [javac] symbol  : class HttpServletResponse<br>
64
      [javac] location: class edu.ucsb.nceas.metacat.MetaCatServlet<br>
65
      [javac] &nbsp;&nbsp;&nbsp;&nbsp;HttpServletResponse response) throws ServletException, IOException {<br>
66
      [javac] &nbsp;&nbsp;&nbsp;&nbsp;^<br>
67
      </div>
68
      
69
    <p>This is usually caused by the build not being able to find native Tomcat libraries. edit your
70
    build.properties file in  
71
      
72
<a name="InstallationIssues"></a><div class="header1">Installation Issues</div>
73
 
74
<a name="StartupIssues"></a><div class="header1">Startup Issues</div> 
75
	<a name="Jdk14Logger"></a><div class="header2">Metacat doesn't start and Jdk14Logger exception</div>
76
	<p>The symptoms are that the metacat service will not show up at all, even though Tomcat 
77
      is serving, and the following error shows up in the tomcat log (catalina.log):</p>
78
      
79
      <div class="code">org.apache.commons.logging.LogConfigurationException: User-specified log
80
      class 'org.apache.commons.logging.impl.Jdk14Logger' cannot be found or is
81
      not useable </div>
82
      
83
      <p>This message typically occurs in the tomcat log (catalina.log) 
84
      when Tomcat has been installed on an Ubuntu/Debian system using apt-get install.  
85
      And the application is started using:
86
        
87
        <div class="code">/etc/init.d/tomcat5.5 start</div>  
88
        
89
      <p>The problem is that the standard startup scripts reference the 
90
      common java service, jsvc.  Metacat will not run under jsvc.  The solutions are:
91
      <ul>
92
      <li>Download the <a href="http://knb.ecoinformatics.org/software/download.html">Metacat binary install package</a>
93
       and replace your /etc/init.d/tomcat5.5 startup script with the one provided in the
94
       package.</li>
95
      <li>Run Tomcat from the Tomcat binary directory: <tomcat_home>/bin/startup.sh and 
96
      <tomcat_home>/bin/shutdown.sh</li>
97
      </ul>
98
      </p>
99
<a name="ConfigurationIssues"></a><div class="header1">Configuration Issues</div>
100

    
101
<a name="GeneralApplicationIssues"></a><div class="header1">General Application Issues</div> 
102

    
103
<a name="UnitTestingIssues"></a><div class="header1">Unit Testing Issues</div>
104
  <a name="503ServiceTemporarilyUnavailable"></a><div class="header2">Mutliple Tests Fail : 503 Service Temporarily Unavailable</div>
105
    <p>When running "ant test", multiple tests fail.  The output files have the error: </p>
106
      <div class="code">503 Service Temporarily Unavailable</div>
107
    <p>This typically means your Metacat server is not running.</p>
108
    
109
    <br>
110
    
111
  </body>
112
</html>
(55-55/62)