Zum Inhalt springen
Version 356.1 von tleu am 17.12.2014
Zeige letzte Bearbeiter
1 {{sv-translation language="de"}}
2 {{layout}}
3 {{layout-section ac:type="two_right_sidebar"}}
4 {{layout-cell}}
5 ====== Inhalt: ======
6
7
8
9 {{toc style="square" maxLevel="5" outline="true" absoluteUrl="true"/}}
10 {{/layout-cell}}
11
12 {{layout-cell}}
13 |=(((
14 Status
15 )))|(((
16 (% class="status-macro aui-lozenge aui-lozenge-error" %)ENTWURF
17 )))
18 {{/layout-cell}}
19 {{/layout-section}}
20
21 {{layout-section ac:type="single"}}
22 {{layout-cell}}
23 == Requirements ==
24
25 * Oracle Java 8 and Apache Tomcat 8
26 * Apache Webserver with proxy_ajp and mod_rewrite (optional)
27 * MAXIMA for the use of calculations (optional)
28
29 == Download ==
30
31 * Download and install Oracle JDK 8: [[http:~~/~~/www.oracle.com/technetwork/java/javase/downloads/>>url:http://www.oracle.com/technetwork/java/javase/downloads/||title="Verknüpfung folgen" rel="nofollow" shape="rect"]]
32
33 {{code title="Install" language="powershell"}}
34 tar xfz jdk-8uX-linux-x64.tar.gz -C /opt
35 {{/code}}
36
37 * Let the environment variable $JAVA_HOME point to the JDK directory:
38
39 {{code title="JAVA-HOME" language="powershell"}}
40 export JAVA_HOME=/opt/jdk1.8.X
41 {{/code}}
42
43 * Download and install Tomcat 8: [[http:~~/~~/tomcat.apache.org/download-80.cgi>>url:http://tomcat.apache.org/download-80.cgi||title="Verknüpfung folgen" rel="nofollow" shape="rect"]]
44
45 {{code title="Tomcat" language="powershell"}}
46 tar xfz apache-tomcat-8.X.X.tar.gz -C /opt
47 {{/code}}
48
49 == Deployment ==
50
51 * Stop your Tomcat
52 * In case of an **update**, delete old ONYX war-files and dirs from ${TOMCAT_HOME}/webapps
53 * It might be useful to clear the work and temp directory of the Tomcat Server:
54
55 {{code title="Tomcat" language="powershell"}}
56 rm -rf ${TOMCAT_HOME}/temp/* ${TOMCAT_HOME}/work/*
57 {{/code}}
58
59 (% class="_mce_tagged_br" %)
60 * Copy the onyx-player-**X.X**.war to ${TOMCAT_HOME}/webapps
61 * Start your Tomcat
62 * Open the following URL in your browser: [[http:~~/~~/localhost:8080/onyx-player-X.X/demo>>url:http://localhost:8080/onyx-player-X.X/demo||shape="rect"]]
63
64 == Configuration of additional features ==
65
66 === Show **example tests** on your ONYX Player start page ===
67
68 * Save the zip-files in /src/main/resources/tests
69 * Set showinternaltests to true (onyxplugin.config.xml)
70
71 === Provide an **upload functionality** for tests on your ONYX Player start page ===
72
73 * Define a folder in onyxplugin.config.xml where uploaded tests should be stored: <uploaddir>/tmp/</uploaddir>
74 * Note that this folder must exist and be writable or it must be allowed to create it.
75 * You can upload tests on your ONYX Player start page and access the tests directly via a static URL.
76
77 === Install MAXIMA, if you like to use calculations ===
78
79 * Installation on RHEL/Fedora/CentOS:
80
81 {{code title="MAXIMA für RHEL/Fedora/CentOS" language="powershell"}}
82 sudo yum install maxima
83 {{/code}}
84
85 * Installation on Debian/Ubuntu/Mint:
86
87 {{code title="MAXIMA für Debian/Ubuntu/Mint" language="powershell"}}
88 sudo yum install maxima
89 {{/code}}
90
91 * Or visit [[http:~~/~~/maxima.sourceforge.net/>>url:http://maxima.sourceforge.net/||shape="rect"]] and download the MAXIMA files
92
93 === Save user results ===
94
95 ONYX allows saving user results on the hard disk additionally to the transmission to the LMS. This may be useful in case results cannot be transmitted due to errors in the LMS or during the transmission process. To activate this function enter the tag
96
97 {{code language="powershell"}}
98 <resultsdir>/tmp/onyxresults/</resultsdir> in the section <playerconfig>...</playerconfig>
99 {{/code}}
100
101 of the file onyxplugin.config.xml and adjust the indicated directory to your server.
102
103 Tomcat needs a writing permission for this directory. The result files are sorted in a sub folder by date and will not be deleted. In case the result files are no longer required, deletion can be done only by administrators.
104 {{/layout-cell}}
105 {{/layout-section}}
106 {{/layout}}
107 {{/sv-translation}}
108
109 {{sv-translation language="en"}}
110 ====== Content: ======
111
112
113
114 {{toc style="none" outline="true"/}}
115
116 == Requirements ==
117
118 * Oracle Java 8 and Apache Tomcat 8
119 * Apache Webserver with proxy_ajp and mod_rewrite (optional)
120 * MAXIMA for the use of calculations (optional)
121
122 == Download ==
123
124 * Download and install Oracle JDK 8: [[http:~~/~~/www.oracle.com/technetwork/java/javase/downloads/>>url:http://www.oracle.com/technetwork/java/javase/downloads/||title="Verknüpfung folgen" rel="nofollow" shape="rect"]]
125
126 {{code title="Install" language="powershell"}}
127 tar xfz jdk-8uX-linux-x64.tar.gz -C /opt
128 {{/code}}
129
130 * Let the environment variable $JAVA_HOME point to the JDK directory:
131
132 {{code title="JAVA-HOME" language="powershell"}}
133 export JAVA_HOME=/opt/jdk1.8.X
134 {{/code}}
135
136 * Download and install Tomcat 8: [[http:~~/~~/tomcat.apache.org/download-80.cgi>>url:http://tomcat.apache.org/download-80.cgi||title="Verknüpfung folgen" rel="nofollow" shape="rect"]]
137
138 {{code title="Tomcat" language="powershell"}}
139 tar xfz apache-tomcat-8.X.X.tar.gz -C /opt
140 {{/code}}
141
142 == (% style="line-height: 1.5;" %)Deployment(%%) ==
143
144 * Stop your Tomcat
145 * In case of an **update**, delete old ONYX war-files and dirs from ${TOMCAT_HOME}/webapps
146 * It might be useful to clear the work and temp directory of the Tomcat Server:
147
148 {{code title="Tomcat" language="powershell"}}
149 rm -rf ${TOMCAT_HOME}/temp/* ${TOMCAT_HOME}/work/*
150 {{/code}}
151
152 (% class="_mce_tagged_br" %)
153 * Copy the onyx-player-**X.X**.war to ${TOMCAT_HOME}/webapps
154 * Start your Tomcat
155 * Open the following URL in your browser: [[http:~~/~~/localhost:8080/onyx-player-X.X/demo>>url:http://localhost:8080/onyx-player-X.X/demo||shape="rect"]]
156
157 == Configuration of additional features ==
158
159 === Show **example tests** on your ONYX Player start page ===
160
161 * Save the zip-files in /src/main/resources/tests
162 * Set showinternaltests to true (onyxplugin.config.xml)
163
164 === Provide an **upload functionality** for tests on your ONYX Player start page ===
165
166 * Define a folder in onyxplugin.config.xml where uploaded tests should be stored: <uploaddir>/tmp/</uploaddir>
167 * Note that this folder must exist and be writable or it must be allowed to create it.
168 * You can upload tests on your ONYX Player start page and access the tests directly via a static URL.
169
170 === Install MAXIMA, if you like to use calculations ===
171
172 * Installation on RHEL/Fedora/CentOS:
173
174 {{code title="MAXIMA für RHEL/Fedora/CentOS" language="powershell"}}
175 sudo yum install maxima
176 {{/code}}
177
178 * Installation on Debian/Ubuntu/Mint:
179
180 {{code title="MAXIMA für Debian/Ubuntu/Mint" language="powershell"}}
181 sudo yum install maxima
182 {{/code}}
183
184 * Or visit[[http:~~/~~/maxima.sourceforge.net/>>url:http://maxima.sourceforge.net/||shape="rect"]] and download the MAXIMA files
185
186 === Save user results ===
187
188 ONYX allows saving user results on the hard disk additionally to the transmission to the LMS. This may be useful in case results cannot be transmitted due to errors in the LMS or during the transmission process. To activate this function enter the tag
189
190 {{code language="powershell"}}
191 <resultsdir>/tmp/onyxresults/</resultsdir> in the section <playerconfig>...</playerconfig>
192 {{/code}}
193
194 of the file onyxplugin.config.xml and adjust the indicated directory to your server.
195
196 Tomcat needs a writing permission for this directory. The result files are sorted in a sub folder by date and will not be deleted. In case the result files are no longer required, deletion can be done only by administrators.
197 {{/sv-translation}}