Wiki-Quellcode von Installation ONYX Player und Reporter
Version 355.1 von sandra_riediger am 15.12.2014
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
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 maxLevel="5" style="square" 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 | == Requirements == | ||
111 | |||
112 | * Oracle Java 8 and Apache Tomcat 8 | ||
113 | * Apache Webserver with proxy_ajp and mod_rewrite (optional) | ||
114 | * MAXIMA for the use of calculations (optional) | ||
115 | |||
116 | == Download == | ||
117 | |||
118 | * 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"]] | ||
119 | |||
120 | {{code title="Install" language="powershell"}} | ||
121 | tar xfz jdk-8uX-linux-x64.tar.gz -C /opt | ||
122 | {{/code}} | ||
123 | |||
124 | * Let the environment variable $JAVA_HOME point to the JDK directory: | ||
125 | |||
126 | {{code title="JAVA-HOME" language="powershell"}} | ||
127 | export JAVA_HOME=/opt/jdk1.8.X | ||
128 | {{/code}} | ||
129 | |||
130 | * 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"]] | ||
131 | |||
132 | {{code title="Tomcat" language="powershell"}} | ||
133 | tar xfz apache-tomcat-8.X.X.tar.gz -C /opt | ||
134 | {{/code}} | ||
135 | |||
136 | == (% style="line-height: 1.5;" %)Deployment(%%) == | ||
137 | |||
138 | * Stop your Tomcat | ||
139 | * In case of an **update**, delete old ONYX war-files and dirs from ${TOMCAT_HOME}/webapps | ||
140 | * It might be useful to clear the work and temp directory of the Tomcat Server: | ||
141 | |||
142 | {{code title="Tomcat" language="powershell"}} | ||
143 | rm -rf ${TOMCAT_HOME}/temp/* ${TOMCAT_HOME}/work/* | ||
144 | {{/code}} | ||
145 | |||
146 | (% class="_mce_tagged_br" %) | ||
147 | * Copy the onyx-player-**X.X**.war to ${TOMCAT_HOME}/webapps | ||
148 | * Start your Tomcat | ||
149 | * 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"]] | ||
150 | |||
151 | == Configuration of additional features == | ||
152 | |||
153 | === Show **example tests** on your ONYX Player start page === | ||
154 | |||
155 | * Save the zip-files in /src/main/resources/tests | ||
156 | * Set showinternaltests to true (onyxplugin.config.xml) | ||
157 | |||
158 | === Provide an **upload functionality** for tests on your ONYX Player start page === | ||
159 | |||
160 | * Define a folder in onyxplugin.config.xml where uploaded tests should be stored: <uploaddir>/tmp/</uploaddir> | ||
161 | * Note that this folder must exist and be writable or it must be allowed to create it. | ||
162 | * You can upload tests on your ONYX Player start page and access the tests directly via a static URL. | ||
163 | |||
164 | === Install MAXIMA, if you like to use calculations === | ||
165 | |||
166 | * Installation on RHEL/Fedora/CentOS: | ||
167 | |||
168 | {{code title="MAXIMA für RHEL/Fedora/CentOS" language="powershell"}} | ||
169 | sudo yum install maxima | ||
170 | {{/code}} | ||
171 | |||
172 | * Installation on Debian/Ubuntu/Mint: | ||
173 | |||
174 | {{code title="MAXIMA für Debian/Ubuntu/Mint" language="powershell"}} | ||
175 | sudo yum install maxima | ||
176 | {{/code}} | ||
177 | |||
178 | * Or visit[[http:~~/~~/maxima.sourceforge.net/>>url:http://maxima.sourceforge.net/||shape="rect"]] and download the MAXIMA files | ||
179 | |||
180 | === Save user results === | ||
181 | |||
182 | 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 | ||
183 | |||
184 | {{code language="powershell"}} | ||
185 | <resultsdir>/tmp/onyxresults/</resultsdir> in the section <playerconfig>...</playerconfig> | ||
186 | {{/code}} | ||
187 | |||
188 | of the file onyxplugin.config.xml and adjust the indicated directory to your server. | ||
189 | |||
190 | 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. | ||
191 | {{/sv-translation}} |