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="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="toc2"><a href="#MapDisplayIssue">Maps will not display</a></div>
55
  <div class="toc1"><a href="#UnitTestingIssues">Unit Testing Issues</a></div>
56
    <div class="toc2"><a href="#503ServiceTemporarilyUnavailable">Mutliple Tests Fail : 503 Service Temporarily Unavailable</a></div>
57
</div> 
58

    
59
<a name="BuildIssues"></a><div class="header1">Build Issues</div>
60
  <a name="HttpServletExceptions"></a><div class="header2">Ant BUILD FAILED : Multiple HttpSevlet Exceptions</div>
61
    <p>During an Ant build of Metacat, you will see many HttpServletRequest, HttpServletResponse and
62
    other errors.  The compiler will complain that it cannot find a symbol, for example:</p>
63
      <div class="code">
64
      [javac] /home/daigle/workspace/metacat/build/src/edu/ucsb/nceas/metacat/MetaCatServlet.java:506: cannot find symbol<br>
65
      [javac] symbol  : class HttpServletResponse<br>
66
      [javac] location: class edu.ucsb.nceas.metacat.MetaCatServlet<br>
67
      [javac] &nbsp;&nbsp;&nbsp;&nbsp;HttpServletResponse response) throws ServletException, IOException {<br>
68
      [javac] &nbsp;&nbsp;&nbsp;&nbsp;^<br>
69
      </div>
70
      
71
    <p>This is usually caused by the build not being able to find native Tomcat libraries. edit your
72
    build.properties file in  
73
      
74
<a name="InstallationIssues"></a><div class="header1">Installation Issues</div>
75
 
76
<a name="StartupIssues"></a><div class="header1">Startup Issues</div> 
77
	<a name="Jdk14Logger"></a><div class="header2">Metacat doesn't start and Jdk14Logger exception</div>
78
	<p>The symptoms are that the metacat service will not show up at all, even though Tomcat 
79
      is serving, and the following error shows up in the tomcat log (catalina.log):</p>
80
      
81
      <div class="code">org.apache.commons.logging.LogConfigurationException: User-specified log
82
      class 'org.apache.commons.logging.impl.Jdk14Logger' cannot be found or is
83
      not useable </div>
84
      
85
      <p>This message typically occurs in the tomcat log (catalina.log) 
86
      when Tomcat has been installed on an Ubuntu/Debian system using apt-get install.  
87
      And the application is started using:
88
        
89
        <div class="code">/etc/init.d/tomcat5.5 start</div>  
90
        
91
      <p>The problem is that the standard startup scripts reference the 
92
      common java service, jsvc.  Metacat will not run under jsvc.  The solutions are:
93
      <ul>
94
      <li>Download the <a href="http://knb.ecoinformatics.org/software/download.html">Metacat binary install package</a>
95
       and replace your /etc/init.d/tomcat5.5 startup script with the one provided in the
96
       package.</li>
97
      <li>Run Tomcat from the Tomcat binary directory: <tomcat_home>/bin/startup.sh and 
98
      <tomcat_home>/bin/shutdown.sh</li>
99
      </ul>
100
      </p>
101
<a name="ConfigurationIssues"></a><div class="header1">Configuration Issues</div>
102
  <a name="DbUpdateIssue"></a><div class="header2">Database Update Fails (not a connectivity issue)</div>
103
    <p>There are a number of reasons why the database update utility might fail during 
104
    configuration.  You will need to determine if the error returned indicates a connectivity issue
105
    or some issue with the database schema/data.  If it is the latter, the first step in 
106
    troubleshooting the issue is to run the db scripts manually and analyze the output.</p> 
107
    
108
    <p>The configuration utility will report which scripts it tried to run.  To 
109
    run these scripts, refer to 
110
    <a href="../user/run-db-scripts.html">how to run database scripts</a></p>
111
    
112
    <p>If the answer is not obvious, further troubleshooting may require a database 
113
    administrator.</p>
114
    
115
<a name="GeneralApplicationIssues"></a><div class="header1">General Application Issues</div> 
116
  <a name="MapDisplayIssue"></a><div class="header2">Maps will not display</div>
117
    <p>There are two known reasons why maps might not display in a web browser.</p> 
118
    <ul>
119
    <li>Sarfari Browser - the safari browser is not supported by the map libraries.  You will
120
        need to switch to a different browser.</li>
121
    <li>Firefox Browser with the Firebug plugin - Firebug is a plugin that allows a developer
122
        to easily view and troubleshoot web page layouts.  Unfortunately, this plugin can
123
        keep the maps from displaying.  There is no plan by the third party map display
124
        developers to address this issue.  You will need to disable Firebug in your 
125
        browser.</li>
126
    </ul>
127
    
128
<a name="UnitTestingIssues"></a><div class="header1">Unit Testing Issues</div>
129
  <a name="503ServiceTemporarilyUnavailable"></a><div class="header2">Mutliple Tests Fail : 503 Service Temporarily Unavailable</div>
130
    <p>When running "ant test", multiple tests fail.  The output files have the error: </p>
131
      <div class="code">503 Service Temporarily Unavailable</div>
132
    <p>This typically means your Metacat server is not running.</p>
133
    
134
    <br>
135
    
136
  </body>
137
</html>
(56-56/63)