Project

General

Profile

metacat / docs / user / troubleshooting.html @ 4691

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="toc2"><a href="#DbUpdateIssue">Database Update Fails (not a connectivity issue)</a></div>
53
  <div class="toc1"><a href="#GeneralApplicationIssues">General Application Issues</a></div>
54
  <div class="toc1"><a href="#UnitTestingIssues">Unit Testing Issues</a></div>
55
    <div class="toc2"><a href="#503ServiceTemporarilyUnavailable">Mutliple Tests Fail : 503 Service Temporarily Unavailable</a></div>
56
</div> 
57

    
58
<a name="BuildIssues"></a><div class="header1">Build Issues</div>
59
  <a name="HttpServletExceptions"></a><div class="header2">Ant BUILD FAILED : Multiple HttpSevlet Exceptions</div>
60
    <p>During an Ant build of Metacat, you will see many HttpServletRequest, HttpServletResponse and
61
    other errors.  The compiler will complain that it cannot find a symbol, for example:</p>
62
      <div class="code">
63
      [javac] /home/daigle/workspace/metacat/build/src/edu/ucsb/nceas/metacat/MetaCatServlet.java:506: cannot find symbol<br>
64
      [javac] symbol  : class HttpServletResponse<br>
65
      [javac] location: class edu.ucsb.nceas.metacat.MetaCatServlet<br>
66
      [javac] &nbsp;&nbsp;&nbsp;&nbsp;HttpServletResponse response) throws ServletException, IOException {<br>
67
      [javac] &nbsp;&nbsp;&nbsp;&nbsp;^<br>
68
      </div>
69
      
70
    <p>This is usually caused by the build not being able to find native Tomcat libraries. edit your
71
    build.properties file in  
72
      
73
<a name="InstallationIssues"></a><div class="header1">Installation Issues</div>
74
 
75
<a name="StartupIssues"></a><div class="header1">Startup Issues</div> 
76
        <a name="Jdk14Logger"></a><div class="header2">Metacat doesn't start and Jdk14Logger exception</div>
77
        <p>The symptoms are that the metacat service will not show up at all, even though Tomcat 
78
      is serving, and the following error shows up in the tomcat log (catalina.log):</p>
79
      
80
      <div class="code">org.apache.commons.logging.LogConfigurationException: User-specified log
81
      class 'org.apache.commons.logging.impl.Jdk14Logger' cannot be found or is
82
      not useable </div>
83
      
84
      <p>This message typically occurs in the tomcat log (catalina.log) 
85
      when Tomcat has been installed on an Ubuntu/Debian system using apt-get install.  
86
      And the application is started using:
87
        
88
        <div class="code">/etc/init.d/tomcat5.5 start</div>  
89
        
90
      <p>The problem is that the standard startup scripts reference the 
91
      common java service, jsvc.  Metacat will not run under jsvc.  The solutions are:
92
      <ul>
93
      <li>Download the <a href="http://knb.ecoinformatics.org/software/download.html">Metacat binary install package</a>
94
       and replace your /etc/init.d/tomcat5.5 startup script with the one provided in the
95
       package.</li>
96
      <li>Run Tomcat from the Tomcat binary directory: <tomcat_home>/bin/startup.sh and 
97
      <tomcat_home>/bin/shutdown.sh</li>
98
      </ul>
99
      </p>
100
<a name="ConfigurationIssues"></a><div class="header1">Configuration Issues</div>
101
  <a name="DbUpdateIssue"></a><div class="header2">Database Update Fails (not a connectivity issue)</div>
102
    <p>There are a number of reasons why the database update utility might fail during 
103
    configuration.  You will need to determine if the error returned indicates a connectivity issue
104
    or some issue with the database schema/data.  If it is the latter, the first step in 
105
    troubleshooting the issue is to run the db scripts manually and analyze the output.</p> 
106
    
107
    <p>The configuration utility will report which scripts it tried to run.  To 
108
    run these scripts, refer to 
109
    <a href="../user/run-db-scripts.html">how to run database scripts</a></p>
110
    
111
    <p>If the answer is not obvious, further troubleshooting may require a database 
112
    administrator.</p>
113
    
114
<a name="GeneralApplicationIssues"></a><div class="header1">General Application Issues</div> 
115

    
116
<a name="UnitTestingIssues"></a><div class="header1">Unit Testing Issues</div>
117
  <a name="503ServiceTemporarilyUnavailable"></a><div class="header2">Mutliple Tests Fail : 503 Service Temporarily Unavailable</div>
118
    <p>When running "ant test", multiple tests fail.  The output files have the error: </p>
119
      <div class="code">503 Service Temporarily Unavailable</div>
120
    <p>This typically means your Metacat server is not running.</p>
121
    
122
    <br>
123
    
124
  </body>
125
</html>