Zum Inhalt springen

Wiki-Quellcode von Installation WebEditor

Version 415.1 von tleu am 12.11.2014
Zeige letzte Bearbeiter
1 {{layout}}
2 {{layout-section ac:type="two_right_sidebar"}}
3 {{layout-cell}}
4 ====== Seiteninhalt: ======
5
6
7
8 {{toc style="none" maxLevel="5" outline="true" absoluteUrl="true"/}}
9 {{/layout-cell}}
10
11 {{layout-cell}}
12 |=(% colspan="1" %)(% colspan="1" %)
13 (((
14 Programmversion
15 )))|(% colspan="1" %)(% colspan="1" %)
16 (((
17
18 )))
19 |=(((
20 Status
21 )))|(((
22 (% class="status-macro aui-lozenge aui-lozenge-error" %)ENTWURF
23 )))
24 {{/layout-cell}}
25 {{/layout-section}}
26
27 {{layout-section ac:type="single"}}
28 {{layout-cell}}
29 Dokumentation der Installation des OnyxEditors als produktive Instanz auf einem Linuxserver
30
31 = Download der Install Requirements =
32
33 == Download and install Oracle JDK 7 ==
34
35 [[http:~~/~~/www.oracle.com/technetwork/java/javase/downloads/>>url:http://www.oracle.com/technetwork/java/javase/downloads/||rel="nofollow" shape="rect" class="external free"]]
36
37 {{code language="powershell"}}
38 tar xfz jdk-7uX-linux-x64.tar.gz -C /opt 
39 {{/code}}
40
41 **Let the environment variable $JAVA_HOME point to the JDK directory:**
42
43 {{code language="powershell"}}
44 export JAVA_HOME=/opt/jdk1.7.X
45 {{/code}}
46
47 == (% class="mw-headline" %)Download and install Tomcat 7(%%) ==
48
49 [[http:~~/~~/tomcat.apache.org/download-70.cgi>>url:http://tomcat.apache.org/download-70.cgi||rel="nofollow" shape="rect" class="external free"]]
50
51 {{code language="powershell"}}
52 tar xfz apache-tomcat-7.X.X.tar.gz -C /opt 
53 {{/code}}
54
55 {{{ }}}
56
57 == Download and install PostgreSQL 9 ==
58
59 [[http:~~/~~/www.enterprisedb.com/products-services-training/pgdownload>>url:http://www.enterprisedb.com/products-services-training/pgdownload||rel="nofollow" shape="rect" class="external free"]]
60
61 {{code language="powershell"}}
62 chmod u+x postgresql-9.X-linux-x64.run
63 ./postgresql-9.X-linux-x64.run 
64 {{/code}}
65
66 {{{ }}}
67
68 == optional: Download and install MAXIMA ==
69
70 TODO
71
72 = Deployment =
73
74 == new installation ==
75
76 Exract the webeditor-X.X.war to ${TOMCAT_HOME}/webapps/webeditor
77
78 {{code language="powershell"}}
79 unzip webeditor-X.X.war -d /opt/apache-tomcat-7.X.XX/webapps/webeditor 
80 {{/code}}
81
82 {{{Create database user and database}}}
83
84 {{code language="powershell"}}
85 su postgres
86 /opt/PostgreSQL/9.X/bin/createuser -P onyxeditor
87 /opt/PostgreSQL/9.X/bin/createdb -O onyxeditor onyxeditor 
88 {{/code}}
89
90 Initialize database
91
92 {{code language="sql"}}
93 psql -h localhost -U onyxeditor onyxeditor < /opt/apache-tomcat-7.X.XX/webapps/webeditor/WEB-INF/classes/database/setupdatabase.sql 
94 {{/code}}
95
96 {{{ }}}
97
98
99
100 === (% class="mw-headline" %)Configuration(%%) ===
101
102 configuration files are
103
104 **WEB-INF/classes/de/bps/onyx/context/moduleConfigurationContext.xml**
105
106 This file is the config for ONYX Editor repository configurations.
107
108
109
110 {{code language="xml"}}
111 ...
112 <bean id="de.bps.onyx.manager.RepositoryConfigurationManager" class="de.bps.onyx.manager.RepositoryConfigurationManager">
113 <property name="modules">
114 <map>
115 <entry key="FileSystemModule" value-ref="de.bps.onyx.manager.modules.FileSystemModule" />
116 <entry key="OLATRepoModule" value-ref="de.bps.onyx.manager.modules.OPALRepoModule" />
117 <entry key="PREOLATCERepoConfiguration" value-ref="de.bps.onyx.manager.modules.PREOLATCERepoConfiguration" />
118 </map>
119 </property>
120 <property name="defaultModule" ref="de.bps.onyx.manager.modules.OPALRepoModule" />
121 </bean>
122 ... 
123 {{/code}}
124
125 * defines the repositories available:
126 ** key defines the internal repo ID. It may be named as you want.
127 ** value-ref references the bean which defines the repository configuration:
128
129 {{code language="xml"}}
130 ...
131 <bean id="de.bps.onyx.manager.modules.FileSystemModule" class="de.bps.onyx.manager.modules.FileSystemModule">
132 <constructor-arg index="0" ref="FileSystemConfiguration" />
133 </bean>
134 ... 
135 {{/code}}
136
137 * instantiates the repo configuration depending on repository type:
138 ** de.bps.onyx.manager.modules.FileSystemModule: value-ref from above
139 ** class="...": One of:
140 *** de.bps.onyx.manager.modules.FileSystemModule (local file system repo)
141 *** de.bps.onyx.manager.modules.OPALRepoModule (uses an OLAT LMS as repo)
142 ** constructor-arg: ref references the configuration bean as follows:
143
144 File system repository:
145
146 {{code language="xml"}}
147 ...
148 <bean id="FileSystemConfiguration" class="de.bps.onyx.model.repo.RepositoryModuleConfiguration">
149 <property name="name" value="FileSystemModule" />
150 <property name="typeKey" value="FileSystemModule" />
151 <property name="description" value="File system module" />
152 <property name="canHandleGuest" value="true" />
153 <property name="serviceTarget" value="/opt/owe/fsr" />
154 <property name="displayname" value="Repository PRE/OLATCE" />
155 </bean>
156 ... 
157 {{/code}}
158
159 * name: Name which is uses internal in OWE as identifier
160 * typeKey: Repository type definition
161 * description: Some description (not used at the moment)
162 * canHandleGuest: set to true if this repo can handle guest users (without logon)
163 * serviceTarget: File system path
164 * displayname: String to show as repo name in ONYX Editor (if not given, some internal translation will be done to show a generic and type dependent name)
165
166 OLAT repo:
167
168 {{code language="powershell"}}
169 ...
170 <bean id="OPALRepoConfiguration" class="de.bps.onyx.model.repo.RepositoryModuleConfiguration">
171 ...
172 <property name="serviceTarget" value="https://next.bps-system.de/opal/services/" />
173 ...
174 </bean>
175 ... 
176 {{/code}}
177
178 {{{ }}}
179
180 * serviceTarget: OLAT URL
181 * Other properties as stated above for File system repository
182
183
184 \\**WEB-INF/classes/de/bps/onyx/context/applicationContext.xml**
185
186 This file contains the configuration for:
187
188 the connection to ONYXPLAYER. The ONYXPLAYER is used for preview.
189
190 {{code language="xml"}}
191 ...
192 <property name="system" value="preonyxeditor" />
193 <property name="previewAddress" value="http://pre.bps-system.de/onyx"/>
194 ...
195 {{/code}}
196
197
198
199 In this example is the ONYXPLAYER used at URL [[http:~~/~~/pre.bps-system.de/onyx>>url:http://pre.bps-system.de/onyx||rel="nofollow" shape="rect" class="external free"]] . The serviceprovider name (used by ONYXPLAYER) is: preonyxeditor
200
201 the connection to database example:
202
203 {{code language="xml"}}
204 <property name="dbDriverClass" value="org.postgresql.Driver" />
205 <property name="dbConnectionUrl" value="jdbc:postgresql://localhost:5432/dbname" />
206 <property name="dbUserName" value="username" />
207 <property name="dbPassword" value="userpassword" />
208 <property name="dbDialect" value="org.hibernate.dialect.PostgreSQLDialect" /> 
209 {{/code}}
210
211
212 **WEB-INF/classes/de/bps/onyx/context/webServiceContext.xml**
213
214 This file contains the configuration for the connection of the ONYXPLAYER. This ONYXPLAYER is used for statistic issues.
215
216 example:
217
218 {{code language="xml"}}
219 ...
220 <bean id="OnyxReporterTarget" class="de.bps.onyx.manager.reporter.service.OnyxReporterTarget">
221 <constructor-arg name="target" value="https://onyx.bps-system.de/preview/reporterservices" />
222 </bean>
223
224 <bean id="OnyxReporterProvider" class="de.bps.onyx.manager.reporter.service.OnyxReporterProvider">
225 <constructor-arg name="id" value="previewid" />
226 </bean>
227 ...
228 {{/code}}
229
230 {{{ }}}
231
232 In this example is the ONYXPLAYER used at URL[[https:~~/~~/onyx.bps-system.de/preview/ .>>url:https://onyx.bps-system.de/preview/.&nbsp||rel="nofollow" shape="rect" class="external text"]] The serviceprovider name (used by ONYXPLAYER) is: previewed
233
234 == (% class="mw-headline" %)update installation
235 (%%) ==
236
237 **Start your Tomcat**
238
239 {{code language="powershell"}}
240 /opt/apache-tomcat-7.X.XX/bin/startup.sh
241 {{/code}}
242
243
244
245 **Open the following URL in your browser:**
246
247 [[http:~~/~~/localhost:8080/webeditor>>url:http://localhost:8080/webeditor||rel="nofollow" shape="rect" class="external free"]]
248 \\Configuration of additional features
249
250
251
252
253
254
255
256 [root@bps0206 logs]# less /opt/apache-tomcat-7.0.54/logs/webeditor.log
257 [root@bps0206 logs]# less /opt/apache-tomcat-7.0.54/logs/catalina.out
258
259 = (% class="mw-headline" %)create super user account
260 (%%) =
261
262 1. (% lang="en" class="short_text hps" %)register(% class="short_text" lang="en" %) (% lang="en" class="short_text hps" %)a new user on(% class="short_text" lang="en" %) h(% lang="en" class="short_text hps" %)omescreen.
263 1. (% lang="en" class="short_text hps" %)connect to database and select the new user:  'select * from users;'
264 1. UPDATE users SET role=0 WHERE ID = XXX;
265 {{/layout-cell}}
266 {{/layout-section}}
267
268 {{layout-section ac:type="two_right_sidebar"}}
269 {{layout-cell}}
270 ====== untergeordnete Seiten: ======
271
272
273
274 {{children all="true"/}}
275 {{/layout-cell}}
276
277 {{layout-cell}}
278 ====== relevante Links: ======
279
280 * [[lorem ipsum>>url:https://www.bps-system.de/help/display/OPAL/Handbuch+OPAL||shape="rect"]]
281 {{/layout-cell}}
282 {{/layout-section}}
283 {{/layout}}