Installation TomEE-8

Verzeichnisse einrichten

Empfohlene Verzeichnisstruktur

• /opt/letto

In diesem Ordner liegen alle Daten, die von LeTTo gespeichert und verwendet werden.

• /opt/letto/war

In diesen Ordner wird die aktuelle Version der letto.war heruntergeladen (händisch oder vom Update-Script)

• /opt/letto/images ... Speicherort für alle Bilder und Dateien, die innerhalb von Letto hochgeladen werden.
• /opt/letto/js ... Speicherort für Javascript-Dateien. Alle extern verwendeten Javaspript-Dateien können in der Letto-Konfiguration hierher kopiert werden, damit bei der Durchführung von Tests keine externen Daten benötigt werden. Damit kann die Firewall für User-Browser alle externen Zugriffe sperren.

Diese 2 Verzeichnisse (images, js) müssen auch in das [Apache|Apache-Base-Verzeichnis verlinkt] werden.

Der Ordner /opt/letto/images muss in das Backup eingebunden werden!

Die weiteren Ordner werden von LeTTo automatisch erzeugt:

• /opt/letto/pdf ... Ordner zum Zwischenspeichern von erzeugten User-PDF-Dokumenten.
• /opt/letto/tex ... Ordner zum Zwischenspeichern von erzeugten Tex-Dokumenten (Verwendung auch bei der Generierung von PDFs).
• /opt/letto/projekt ... In diesem Ordner werden Schülerprojekte gezippt für alle Abgaben abgelegt.
• /opt/letto/images/photos ... Speicherort für Schülerfotos: Bildname: SokratesID.jpg

Erzeugung der Ordner und Verlinkung zum Apache-Server

sudo mkdir /opt/letto/images
sudo mkdir /opt/letto/js

Symbolische Links für Apache

cd /var/www/html
ln -s /opt/letto/images images
ln -s /opt/letto/js js

Installation TomEE 8 Server

TomEE download und Installation

• Aktionen durchführen als user "letto"
  • Der user "letto" sollte Schreibrechte im Verzeichnis /opt haben, am einfachsten man trägt den Benutzer als Owner ein.

sudo chown letto /opt
sudo chmod 755 /opt

• Download des Servers [1], entpacken der Datei, verschieben nach /opt und einen Link auf /opt/tomee legen

wget https://mirror.klaus-uwe.me/apache/tomee/tomee-8.0.3/apache-tomee-8.0.3-plume.tar.gz
tar -xzf apache-tomee-8.0.3-plume.tar.gz
sudo mv apache-tomee-plume-8.0.3 /opt/tomee8

cd /opt/letto
ln -s /opt/tomee8 /opt/tomee

• Kontrolle ob der Benutzer "letto" alle Recht im Verzeichnis /opt/tomee hat
• MySQL Database-Connector [2] herunterladen und ins TomEE-Verzeichnis kopieren:

wget https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.47.zip
unzip mysql-connector-java-5.1.47.zip
cp mysql-connector-java-5.1.47/mysql-connector-java-5.1.47.jar /opt/tomee/lib/

• Datenbank eintragen in der Datei /opt/tomee/conf/tomee.xml

<?xml version="1.0" encoding="UTF-8"?>
<tomee>
  <!-- see http://tomee.apache.org/containers-and-resources.html -->
  <!-- activate next line to be able to deploy applications in apps -->
  <!-- <Deployments dir="apps" /> -->
  <Resource id="jdbc/letto" type="DataSource">
		JdbcDriver  com.mysql.jdbc.Driver
		JdbcUrl     jdbc:mysql://localhost/letto?autoReconnect=true
		UserName    letto
		Password    xxx-gewähltesPasswort-xxx                
                jtaManaged = true
                testOnReturn = true
                testWhileIdle = true
                timeBetweenEvictionRunsMillis = 60
                initialSize = 2
                minIdle = 2
                validationQuery = "select 1"
  </Resource>
</tomee>

• Für die Funktion von Primefaces einfügen am Ende der Datei /opt/tomee/conf/catalina.properties

org.apache.el.parser.SKIP_IDENTIFIER_CHECK=true

• In /opt/tomee/conf/context.xml => Kommentar löschen, sodass diese Zeile aktiv

<!-- Uncomment this to disable session persistence across Tomcat restarts -->
  <Manager pathname="" />

• Port Festlegen in der Datei /opt/tomee/conf/server.xml:
  zB.: http(8088), https(8483), AJP(8089)

...
<Server port="8005" shutdown="SHUTDOWN">
   ...
   <Service name="Catalina">
      ...
      <Connector port="8088" protocol="HTTP/1.1"
                 connectionTimeout="20000"
                 redirectPort="8483" xpoweredBy="false" server="Apache TomEE" />
      ...
      <Connector port="8089" protocol="AJP/1.3" redirectPort="8483" />
      ...
    
   </Service>
</Server>

• Damit mit den korrekten Dateirechten gespeichert wird suche in der Datei /opt/tomee/bin/catalina.sh nach

# Set UMASK unless it has been overridden                                                                                                                                   if [ -z "$UMASK" ]; then                                                                                                                                                        UMASK="0027"                                                                                                                                                            fi                                                                                                                                                                          umask $UMASK 

und ersetze 0027 durch 002 :

# Set UMASK unless it has been overridden                                                                                                                                   if [ -z "$UMASK" ]; then                                                                                                                                                        UMASK="0002"                                                                                                                                                            fi                                                                                                                                                                          umask $UMASK 

Einrichten des Security-Managers für das SourceCode-Plugin

• Von der Konsole aus die Datei /opt/tomee/conf/catalina.policy bearbeiten
• Am Ende anfügen:

grant {
    permission java.util.PropertyPermission "java.security.policy", "write";
    permission java.lang.RuntimePermission "createSecurityManager";
    permission java.lang.RuntimePermission "setSecurityManager";
    permission java.security.SecurityPermission "getPolicy";
    permission java.security.SecurityPermission "setPolicy";
    permission java.lang.RuntimePermission "accessDeclaredMembers";
    permission java.lang.RuntimePermission "setIO";
    permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
};

Setzen des Heap-Speichers für den TomEE Server

Der Heap-Speicher sollte für den Server auf 2/3 bis 3/4 vom physikalischen Speicher gesetzt werden.

Dazu ist eine Datei /opt/tomee/bin/setenv.sh zu erstellen, in der der Speicher in Megabyte anzugeben ist.

Hier ein Beispiel für einen Rechner mit 16GB physikalischem RAM und demnach 12GB Heap-Speicher:

#!/bin/sh -e
export CATALINA_OPTS="-Xms12000M -Xmx12000M\"

Diese Datei ist dann noch mit Ausführungsrechten zu versehen.

chmod 755 /opt/tomee/bin/setenv.sh

TomEE starten

/opt/tomee/bin/startup.sh

TomEE stoppen

/opt/tomee/bin/shutdown.sh

letto.war deployen

cd /opt/letto/war
wget -q -c --user letto --password xxxPASSWORTyyy https://letto.at/download/letto/letto-daily.war
cp letto-daily.war /opt/tomee/webapps/letto.war

Das Passwort wird von uns auf Anfrage zur Verfügung gestellt.

Update der Anwendung

siehe Update TomEE

siehe auch

• Installation