Project

General

Profile

Download (5.1 KB) Statistics
| Branch: | Tag: | Revision:
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>
(2-2/2)