1
|
<?xml version="1.0" encoding="UTF-8"?>
|
2
|
<faqs xmlns="http://maven.apache.org/FML/1.0.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
3
|
xsi:schemaLocation="http://maven.apache.org/FML/1.0.1 http://maven.apache.org/xsd/fml-1.0.1.xsd"
|
4
|
title="Troubleshooting" toplink="false">
|
5
|
|
6
|
<part id="general">
|
7
|
<title>General</title>
|
8
|
|
9
|
<faq id="run-cdmlib-webapp">
|
10
|
<question>
|
11
|
How can I get help?
|
12
|
</question>
|
13
|
<answer>
|
14
|
<p>The troubelshooting section is still under construction. If you
|
15
|
don't find the answer here, please contact us by email:
|
16
|
editsupport@bgbm.org</p>
|
17
|
</answer>
|
18
|
</faq>
|
19
|
|
20
|
<faq id="cdm-incompatible-version">
|
21
|
<question>
|
22
|
The CDMServer reports incompatible versions, e.g.:
|
23
|
<code>Incompatible version [cichorieae] expected version:
|
24
|
3.0.0.0.201011090000, data base version 2.4.1.2.201004231015</code>
|
25
|
</question>
|
26
|
<answer>
|
27
|
<p>
|
28
|
The version of the database to which the server is trying to
|
29
|
connect is not compatible to the software version of the server.
|
30
|
Please connect to the database using the Taxonomic Editor and
|
31
|
update the database to the current version.
|
32
|
<strong>Please make sure that you are using the latest stable
|
33
|
releases of both, the CDM Server and the Taxonomic Editor</strong>
|
34
|
</p>
|
35
|
</answer>
|
36
|
</faq>
|
37
|
|
38
|
<faq id="start-from-underprivileged-user">
|
39
|
<question>
|
40
|
LINUX: Can an underprivileged user start the CDMServer?
|
41
|
</question>
|
42
|
<answer>
|
43
|
<p>
|
44
|
Yes this is possible. In order to enable a underprivileged user to start/stop
|
45
|
the CDMServer you have to edit the sudoers file (execute: <code>visudo</code>),
|
46
|
add the following lines and modify <code>User_Alias CDMUSERS</code> accordingly.
|
47
|
You need at least to replace <code>{USER_NAME}</code> with the according user name.
|
48
|
</p>
|
49
|
<code>
|
50
|
# User alias specification
|
51
|
User_Alias CDMUSERS = {USER_NAME}
|
52
|
# Cmnd alias specification
|
53
|
Cmnd_Alias CDMSERVER = /etc/init.d/cdmserver *
|
54
|
# User privilege specification
|
55
|
CDMUSERS ALL=NOPASSWD: CDMSERVER
|
56
|
</code>
|
57
|
<p>
|
58
|
Now the user can stop/start the server by prepending sudo to the command, e.g.:
|
59
|
<code>sudo /etc/init.d/cdmserver start</code>
|
60
|
</p>
|
61
|
|
62
|
</answer>
|
63
|
</faq>
|
64
|
|
65
|
|
66
|
|
67
|
<faq id="cdm-unable-connect-or-retrieve-version">
|
68
|
<question>
|
69
|
The CDMServer reports
|
70
|
<code>Unable to connect or to retrieve version info from ...</code>
|
71
|
</question>
|
72
|
<answer>
|
73
|
<p>
|
74
|
The database to which the server is trying to connect is most
|
75
|
probably not a cdm data base. I also might be empty.
|
76
|
<ol>
|
77
|
<li>
|
78
|
First of all use your preferred database management program to
|
79
|
take a look at the data base.
|
80
|
If there is only one table called
|
81
|
<code>_c3p0ConectionTest</code>
|
82
|
this database was an empty one and you can savely proceed to
|
83
|
step
|
84
|
2 in order to intialize the database structure.
|
85
|
Otherwise this
|
86
|
data base was not empty and might be used for different
|
87
|
purposes.
|
88
|
Please do not connect the Taxonomic Editor to this database
|
89
|
unless you
|
90
|
know waht youare doing.
|
91
|
</li>
|
92
|
<li>Connect to the database using the Taxonomic Editor in order to
|
93
|
create the cdm database.</li>
|
94
|
</ol>
|
95
|
</p>
|
96
|
</answer>
|
97
|
</faq>
|
98
|
|
99
|
</part>
|
100
|
<part id="developer">
|
101
|
<title>Developer</title>
|
102
|
|
103
|
<faq id="mvn-eclipse-eclipse_resource-filtering">
|
104
|
<question>
|
105
|
When I execute mvn eclipse:eclipse everything seems fine but then I eventually get this error:
|
106
|
<code>
|
107
|
[INFO] ------------------------------------------------------------------------
|
108
|
[ERROR] BUILD ERROR
|
109
|
[INFO] ------------------------------------------------------------------------
|
110
|
[INFO] Request to merge when 'filtering' is not identical. Original=resource src/main/resources:
|
111
|
output=./cdm-server/target/classes,
|
112
|
include=[version.properties], exclude=[**/*.java], test=false, filtering=true, merging
|
113
|
with=resource src/main/resources: output=./cdm-server/target/classes,
|
114
|
include=[], exclude=[version.properties|**/*.java], test=false, filtering=false
|
115
|
</code>
|
116
|
</question>
|
117
|
<answer>
|
118
|
<p>
|
119
|
This is related to a bug in the maven-eclipse-plugin for more information please refer to
|
120
|
http://forums.atlassian.com/thread.jspa?threadID=34952&tstart=30
|
121
|
The best remedy for this problem currently is to use an older version of the plugin. Running
|
122
|
<code>
|
123
|
mvn org.apache.maven.plugins:maven-eclipse-plugin:2.6:eclipse
|
124
|
</code>
|
125
|
should work fine.
|
126
|
</p>
|
127
|
</answer>
|
128
|
</faq>
|
129
|
</part>
|
130
|
|
131
|
</faqs>
|