|
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] HttpServletResponse response) throws ServletException, IOException {<br>
|
|
68
|
[javac] ^<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>
|
