Revision 815a5220
Added by Andreas Kohlbecker almost 13 years ago
src/site/fml/troubleshooting.fml | ||
---|---|---|
1 | 1 |
<?xml version="1.0" encoding="UTF-8"?> |
2 | 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">
|
|
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 | 5 |
|
6 |
<part id="general">
|
|
7 |
<title>General</title>
|
|
6 |
<part id="general">
|
|
7 |
<title>General</title>
|
|
8 | 8 |
|
9 |
<faq id="run-cdmlib-webapp">
|
|
10 |
<question>
|
|
11 |
How can I get help?
|
|
9 |
<faq id="run-cdmlib-webapp">
|
|
10 |
<question>
|
|
11 |
How can I get help?
|
|
12 | 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>
|
|
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 | 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> |
|
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 userprivileged user to start/stop |
|
45 |
the CDMServer you have to edit the sudoers (execute: <code>visudo</code>), |
|
46 |
add the following lines and modify <code>User_Alias CDMUSERS</code> accordingly |
|
47 |
</p> |
|
48 |
<code><pre> |
|
49 |
# User alias specification |
|
50 |
User_Alias CDMUSERS = cdm |
|
51 |
# Cmnd alias specification |
|
52 |
Cmnd_Alias CDMSERVER = /usr/bin/jsvc *, /bin/chown cdm\:cdm /var/run/cdmserver* |
|
53 |
|
|
54 |
# User privilege specification |
|
55 |
root ALL=(ALL:ALL) ALL |
|
56 |
|
|
57 |
CDMUSERS ALL=NOPASSWD: CDMSERVER |
|
58 |
</pre> |
|
59 |
</code> |
|
60 |
</answer> |
|
61 |
</faq> |
|
37 | 62 |
|
38 |
<faq id="cdm-unable-connect-or-retrieve-version"> |
|
39 |
<question> |
|
40 |
The CDMServer reports |
|
41 |
<code>Unable to connect or to retrieve version info from ...</code> |
|
42 |
</question> |
|
43 |
<answer> |
|
44 |
<p> |
|
45 |
The database to which the server is trying to connect is most |
|
46 |
probably not a cdm data base. I also might be empty. |
|
47 |
<ol> |
|
48 |
<li> |
|
49 |
First of all use your preferred database management program to |
|
50 |
take a look at the data base. |
|
51 |
If there is only one table called |
|
52 |
<code>_c3p0ConectionTest</code> |
|
53 |
this database was an empty one and you can savely proceed to |
|
54 |
step |
|
55 |
2 in order to intialize the database structure. |
|
56 |
Otherwise this |
|
57 |
data base was not empty and might be used for different |
|
58 |
purposes. |
|
59 |
Please do not connect the Taxonomic Editor to this database |
|
60 |
unless you |
|
61 |
know waht youare doing. |
|
62 |
</li> |
|
63 |
<li>Connect to the database using the Taxonomic Editor in order to |
|
64 |
create the cdm database.</li> |
|
65 |
</ol> |
|
66 |
</p> |
|
67 |
</answer> |
|
68 |
</faq> |
|
69 | 63 |
|
70 |
</part> |
|
71 |
<part id="developer"> |
|
72 |
<title>Developer</title> |
|
73 | 64 |
|
74 |
<faq id="mvn-eclipse-eclipse_resource-filtering"> |
|
75 |
<question> |
|
76 |
When I execute mvn eclipse:eclipse everything seems fine but then I eventually get this error: |
|
77 |
<code> |
|
65 |
<faq id="cdm-unable-connect-or-retrieve-version"> |
|
66 |
<question> |
|
67 |
The CDMServer reports |
|
68 |
<code>Unable to connect or to retrieve version info from ...</code> |
|
69 |
</question> |
|
70 |
<answer> |
|
71 |
<p> |
|
72 |
The database to which the server is trying to connect is most |
|
73 |
probably not a cdm data base. I also might be empty. |
|
74 |
<ol> |
|
75 |
<li> |
|
76 |
First of all use your preferred database management program to |
|
77 |
take a look at the data base. |
|
78 |
If there is only one table called |
|
79 |
<code>_c3p0ConectionTest</code> |
|
80 |
this database was an empty one and you can savely proceed to |
|
81 |
step |
|
82 |
2 in order to intialize the database structure. |
|
83 |
Otherwise this |
|
84 |
data base was not empty and might be used for different |
|
85 |
purposes. |
|
86 |
Please do not connect the Taxonomic Editor to this database |
|
87 |
unless you |
|
88 |
know waht youare doing. |
|
89 |
</li> |
|
90 |
<li>Connect to the database using the Taxonomic Editor in order to |
|
91 |
create the cdm database.</li> |
|
92 |
</ol> |
|
93 |
</p> |
|
94 |
</answer> |
|
95 |
</faq> |
|
96 |
|
|
97 |
</part> |
|
98 |
<part id="developer"> |
|
99 |
<title>Developer</title> |
|
100 |
|
|
101 |
<faq id="mvn-eclipse-eclipse_resource-filtering"> |
|
102 |
<question> |
|
103 |
When I execute mvn eclipse:eclipse everything seems fine but then I eventually get this error: |
|
104 |
<code> |
|
78 | 105 |
[INFO] ------------------------------------------------------------------------ |
79 |
[ERROR] BUILD ERROR
|
|
80 |
[INFO] ------------------------------------------------------------------------
|
|
81 |
[INFO] Request to merge when 'filtering' is not identical. Original=resource src/main/resources:
|
|
82 |
output=./cdm-server/target/classes,
|
|
83 |
include=[version.properties], exclude=[**/*.java], test=false, filtering=true, merging
|
|
84 |
with=resource src/main/resources: output=./cdm-server/target/classes,
|
|
85 |
include=[], exclude=[version.properties|**/*.java], test=false, filtering=false
|
|
106 |
[ERROR] BUILD ERROR
|
|
107 |
[INFO] ------------------------------------------------------------------------
|
|
108 |
[INFO] Request to merge when 'filtering' is not identical. Original=resource src/main/resources:
|
|
109 |
output=./cdm-server/target/classes,
|
|
110 |
include=[version.properties], exclude=[**/*.java], test=false, filtering=true, merging
|
|
111 |
with=resource src/main/resources: output=./cdm-server/target/classes,
|
|
112 |
include=[], exclude=[version.properties|**/*.java], test=false, filtering=false
|
|
86 | 113 |
</code> |
87 |
</question>
|
|
88 |
<answer>
|
|
89 |
<p>
|
|
90 |
This is related to a bug in the maven-eclipse-plugin for more information please refer to
|
|
91 |
http://forums.atlassian.com/thread.jspa?threadID=34952&tstart=30
|
|
92 |
The best remedy for this problem currently is to use an older version of the plugin. Running
|
|
93 |
<code>
|
|
94 |
mvn org.apache.maven.plugins:maven-eclipse-plugin:2.6:eclipse
|
|
95 |
</code>
|
|
96 |
should work fine.
|
|
97 |
</p>
|
|
98 |
</answer>
|
|
99 |
</faq>
|
|
100 |
</part>
|
|
114 |
</question>
|
|
115 |
<answer>
|
|
116 |
<p>
|
|
117 |
This is related to a bug in the maven-eclipse-plugin for more information please refer to
|
|
118 |
http://forums.atlassian.com/thread.jspa?threadID=34952&tstart=30
|
|
119 |
The best remedy for this problem currently is to use an older version of the plugin. Running
|
|
120 |
<code>
|
|
121 |
mvn org.apache.maven.plugins:maven-eclipse-plugin:2.6:eclipse
|
|
122 |
</code>
|
|
123 |
should work fine.
|
|
124 |
</p>
|
|
125 |
</answer>
|
|
126 |
</faq>
|
|
127 |
</part>
|
|
101 | 128 |
|
102 | 129 |
</faqs> |
Also available in: Unified diff
faq concerning #2324