Project

General

Profile

« Previous | Next » 

Revision 815a5220

Added by Andreas Kohlbecker almost 13 years ago

faq concerning #2324

View differences:

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