Zum Inhalt springen

Installation WebEditor

Version 415.1 von tleu am 12.11.2014
Seiteninhalt:

Programmversion

 

Status

ENTWURF

Dokumentation der Installation des OnyxEditors als produktive Instanz auf einem Linuxserver

Download der Install Requirements

Download and install Oracle JDK 7

http://www.oracle.com/technetwork/java/javase/downloads/

tar xfz jdk-7uX-linux-x64.tar.gz -C /opt 

Let the environment variable $JAVA_HOME point to the JDK directory:

export JAVA_HOME=/opt/jdk1.7.X

Download and install Tomcat 7

http://tomcat.apache.org/download-70.cgi

tar xfz apache-tomcat-7.X.X.tar.gz -C /opt 
 

Download and install PostgreSQL 9

http://www.enterprisedb.com/products-services-training/pgdownload

chmod u+x postgresql-9.X-linux-x64.run
./postgresql-9.X-linux-x64.run 
 

optional: Download and install MAXIMA

TODO

Deployment

new installation

Exract the webeditor-X.X.war to ${TOMCAT_HOME}/webapps/webeditor

unzip webeditor-X.X.war -d /opt/apache-tomcat-7.X.XX/webapps/webeditor 
Create database user and database
su postgres
/opt/PostgreSQL/9.X/bin/createuser -P onyxeditor
/opt/PostgreSQL/9.X/bin/createdb -O onyxeditor onyxeditor 

Initialize database

psql -h localhost -U onyxeditor onyxeditor < /opt/apache-tomcat-7.X.XX/webapps/webeditor/WEB-INF/classes/database/setupdatabase.sql 
 

 

Configuration

configuration files are

WEB-INF/classes/de/bps/onyx/context/moduleConfigurationContext.xml

This file is the config for ONYX Editor repository configurations.

 

...
<bean id="de.bps.onyx.manager.RepositoryConfigurationManager" class="de.bps.onyx.manager.RepositoryConfigurationManager">
<property name="modules">
<map>
<entry key="FileSystemModule" value-ref="de.bps.onyx.manager.modules.FileSystemModule" />
<entry key="OLATRepoModule" value-ref="de.bps.onyx.manager.modules.OPALRepoModule" />
<entry key="PREOLATCERepoConfiguration" value-ref="de.bps.onyx.manager.modules.PREOLATCERepoConfiguration" />
</map>
</property>
<property name="defaultModule" ref="de.bps.onyx.manager.modules.OPALRepoModule" />
</bean>
... 
  • defines the repositories available:
    • key defines the internal repo ID. It may be named as you want.
    • value-ref references the bean which defines the repository configuration:
...
<bean id="de.bps.onyx.manager.modules.FileSystemModule" class="de.bps.onyx.manager.modules.FileSystemModule">
<constructor-arg index="0" ref="FileSystemConfiguration" />
</bean>
... 
  • instantiates the repo configuration depending on repository type:
    • de.bps.onyx.manager.modules.FileSystemModule: value-ref from above
    • class="...": One of:
      • de.bps.onyx.manager.modules.FileSystemModule (local file system repo)
      • de.bps.onyx.manager.modules.OPALRepoModule (uses an OLAT LMS as repo)
    • constructor-arg: ref references the configuration bean as follows:

File system repository:

...
<bean id="FileSystemConfiguration" class="de.bps.onyx.model.repo.RepositoryModuleConfiguration">
<property name="name" value="FileSystemModule" />
<property name="typeKey" value="FileSystemModule" />
<property name="description" value="File system module" />
<property name="canHandleGuest" value="true" />
<property name="serviceTarget" value="/opt/owe/fsr" />
<property name="displayname" value="Repository PRE/OLATCE" />
</bean>
... 
  • name: Name which is uses internal in OWE as identifier
  • typeKey: Repository type definition
  • description: Some description (not used at the moment)
  • canHandleGuest: set to true if this repo can handle guest users (without logon)
  • serviceTarget: File system path
  • 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)

OLAT repo:

...
<bean id="OPALRepoConfiguration" class="de.bps.onyx.model.repo.RepositoryModuleConfiguration">
...
<property name="serviceTarget" value="https://next.bps-system.de/opal/services/" />
...
</bean>
... 
 
  • serviceTarget: OLAT URL
  • Other properties as stated above for File system repository


WEB-INF/classes/de/bps/onyx/context/applicationContext.xml

This file contains the configuration for:

the connection to ONYXPLAYER. The ONYXPLAYER is used for preview.

...
   <property name="system" value="preonyxeditor" />
   <property name="previewAddress" value="http://pre.bps-system.de/onyx"/>
...

 

In this example is the ONYXPLAYER used at URL http://pre.bps-system.de/onyx . The serviceprovider name (used by ONYXPLAYER) is: preonyxeditor

the connection to database example:

   <property name="dbDriverClass" value="org.postgresql.Driver" />
   <property name="dbConnectionUrl" value="jdbc:postgresql://localhost:5432/dbname" />
   <property name="dbUserName" value="username" />
   <property name="dbPassword" value="userpassword" />
   <property name="dbDialect" value="org.hibernate.dialect.PostgreSQLDialect" /> 

WEB-INF/classes/de/bps/onyx/context/webServiceContext.xml

This file contains the configuration for the connection of the ONYXPLAYER. This ONYXPLAYER is used for statistic issues.

example:

...
<bean id="OnyxReporterTarget" class="de.bps.onyx.manager.reporter.service.OnyxReporterTarget">
<constructor-arg name="target" value="https://onyx.bps-system.de/preview/reporterservices" />
</bean>

<bean id="OnyxReporterProvider" class="de.bps.onyx.manager.reporter.service.OnyxReporterProvider">
<constructor-arg name="id" value="previewid" />
</bean>
...
 

In this example is the ONYXPLAYER used at URLhttps://onyx.bps-system.de/preview/ . The serviceprovider name (used by ONYXPLAYER) is: previewed

update installation

Start your Tomcat

/opt/apache-tomcat-7.X.XX/bin/startup.sh

 

Open the following URL in your browser:

http://localhost:8080/webeditor

Configuration of additional features

 

 

 

[root@bps0206 logs]# less /opt/apache-tomcat-7.0.54/logs/webeditor.log
[root@bps0206 logs]# less /opt/apache-tomcat-7.0.54/logs/catalina.out

create super user account

  1. register a new user on homescreen.
  2. connect to database and select the new user:  'select * from users;'
  3. UPDATE users SET role=0 WHERE ID = XXX;
untergeordnete Seiten:
relevante Links: