Hinweise zur Migration auf jadice server 5.9

API-Änderungen im Überblick

Entfernte Klassen, Methoden oder Properties

Änderungen in der Spring-Konfiguration

Anpassung Schema-Location

Diese Änderung betrifft alle XML-Dateien im Ordner server-config und dessen Unterverzeichnissen.

https://activemq.apache.org/schema/core/activemq-core-5.15.12.xsd → https://activemq.apache.org/schema/core/activemq-core-5.16.0.xsd

https://www.springframework.org/schema/security/spring-security-5.3.xsd → https://www.springframework.org/schema/security/spring-security-5.4.xsd

Änderungen in der Konfiguration des FileTypeAnalyzers

In der Open Source Variante des FileTypeAnalyzers hat sich der Package-Name für Modca-spezifische Analyzer geändert. In der Datei filetype-databases/default.xml müssen daher die Package-Name angepasst werden.

"org.jadice.filetype.matchers.ModcaMatcher" wird zu "org.jadice.filetype.matchers.modca.ModcaMatcher" und

"org.jadice.filetype.matchers.IocaMatcher" wird zu "org.jadice.filetype.matchers.modca.IocaMatcher"

Änderungen im Logging

Das Standard Logging-Framework ist nun Log4j in der Version 2. Die notwendigen Bibliotheken werden im Verzeichnis /server-libs/  ausgeliefert. Die Konfiguration geschieht ausschließlich in der Datei /server-config/log4j2.xml .

Weiter Informationen finden Sie auch im Abschnitt Konfiguration logging der Dokumentation.

Anpassungen der filetype-databases

Durch die Umstellung des FileTypeAnalzyers auf das Open Source Projekt https://github.com/levigo/filetype-analyzer müssen durch das Umbennen von Packages Anpassungen an der default.xml folgende Änderungen vorgenommen werden:

• Aus com.levigo.jadice.filetype.database.ModcaMatcher wird org.jadice.filetype.matchers.modca.ModcaMatcher
• com.levigo.jadice.filetype.database.IocaMatcher → org.jadice.filetype.matchers.modca.IocaMatcher
• com.levigo.jadice.filetype.database.PDFMatcher → com.levigo.jadice.server.documentplatform.filetypeanalysis.PDFMatcher
• Aus den restlichen Klassen im Package com.levigo.jadice.filetype.database wird org.jadice.filetype.matchers

Hinweis: Hierfür empfiehlt sich einen Abgleich gegenüber der Konfiguration in der Original-Ausliferung des jadice servers vorzunehmen.

Verwendung von asynchronen Loggern

Um den Performance Overhead durch Logging zu verringern werden alle Log4j 2 Logger standardmäßig im asynchronen Modus gestartet.  Dazu wird in der wrapper.conf die System-Property -Dlog4j2.contextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector gesetzt. Soll stattdessen synchron geloggt werden, kann diese Property einfach entfernt werden.

Logging Bibliotheken

Die blau hinterlegten als nicht notwendig bezeichneten Bibliotheken sind log4j-2 spezifisch und können beim Wechsel zu einem anderen Logging-Framework durch die entsprechenden Alternativen ersetzt werden.

Nicht mehr unterstützte Funktionen

Mit dieser Version wird das Log-Shipping auf einen JMS-Client entfernt. Damit entfällt die Möglichkeit sich auf dem Client die Lognachrichten des Servers ausgeben zu lassen. Das betrifft NICHT die Lognachrichten der eigentlichen JMS-Job-Verarbeitung.

Schriftarten auf Linux installieren

Folgende Schriftarten-Packages empfehlen wir für den Betrieb des jadice server unter Linux Systemen:

fontconfig

microsoft truetype font packages

lsb_release

Wie genau diese auf Ihrem Betriebsystem zu installieren sind hängt vom Betriebsystem ab, z.B.:

auf debian/ubuntu/mint
(note: for debian the 'contrib' and 'non-free' repositories need to be added first)
sudo apt-get install aptitude
sudo aptitude update
sudo aptitude install fontconfig
sudo aptitude install ttf-mscorefonts-installer
sudo aptitude install lsb-release

auf RHEL/CentOS/Fedora

sudo yum install fontconfig
sudo yum install redhat-lsb
sudo yum install xorg-x11-font-utils
sudo yum install cabextract
(note: if cabextract installation fails ...
sudo rpm -i ftp://rpmfind.net/linux/dag/redhat/el6/en/x86_64/dag/RPMS/cabextract-1.4-1.el6.rf.x86_64.rpm
)
sudo rpm -i https://downloads.sourceforge.net/project/mscorefonts2/rpms/msttcore-fonts-installer-2.6-1.noarch.rpm

auf SuSE/OpenSuSE

sudo zypper install fontconfig
sudo zypper install lsb-release
sudo zypper install fetchmsttfonts