Project

General

Profile

Download (5.06 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
        </p>
77
        <ol>
78
          <li>
79
            First of all use your preferred database management program to
80
            take a look at the data base.
81
            If there is only one table called
82
            <code>_c3p0ConectionTest</code>
83
            this database was an empty one and you can savely proceed to
84
            step
85
            2 in order to intialize the database structure.
86
            Otherwise this
87
            data base was not empty and might be used for different
88
            purposes.
89
            Please do not connect the Taxonomic Editor to this database
90
            unless you
91
            know waht youare doing.
92
          </li>
93
          <li>Connect to the database using the Taxonomic Editor in order to
94
            create the cdm database.</li>
95
        </ol>
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
        <p>
106
        When I execute mvn eclipse:eclipse everything seems fine but then I get this error:
107
        </p>
108
        <code>
109
          [INFO] ------------------------------------------------------------------------
110
          [ERROR] BUILD ERROR
111
          [INFO] ------------------------------------------------------------------------
112
          [INFO] Request to merge when 'filtering' is not identical. Original=resource src/main/resources:
113
          output=./cdm-server/target/classes,
114
          include=[version.properties], exclude=[**/*.java], test=false, filtering=true, merging
115
          with=resource src/main/resources: output=./cdm-server/target/classes,
116
          include=[], exclude=[version.properties|**/*.java], test=false, filtering=false
117
        </code>
118
      </question>
119
      <answer>
120
        <p>
121
            This is related to a bug in the maven-eclipse-plugin for more information please refer to
122
            http://forums.atlassian.com/thread.jspa?threadID=34952&amp;tstart=30
123
            The best remedy for this problem currently is to use an older version of the plugin. Running
124
           <code>
125
           mvn org.apache.maven.plugins:maven-eclipse-plugin:2.6:eclipse
126
           </code>
127
           should work fine.
128
        </p>
129
      </answer>
130
    </faq>
131
  </part>
132
</faqs>
(2-2/2)