Update Wildfly 25

Allgemeine Hinweise

Für das Update auf die Version 4.101 ist ein Update des Applikationsserver Wildfly zwingend Voraussetzung. Sie können hier auf die Erweiterungen bzw. Veränderungen des Herstellers zugreifen und sich über die neuen Möglichkeiten informieren.

Diese Anleitung beschreibt den kompletten Updateprozess inkl. der Aktualisierung der Software.

Bitte beachten Sie, dass Sie ggf. zusätzliche Module manuell Updaten müssen. Hierzu gehören z.B. das Modul "data-export.war". Sollte sich dieses Modul im "deployment" Verzeichnis des Wildfly-Servers befinden, kontaktieren Sie bitte unseren Support.

Ablauf

  1. Backup durchführen

  2. Abhängig der verwendeten Umgebung, folgen Sie bitte entweder den Anweisungen für eine Docker basierenden oder einer klassischen Umgebung.

  3. Updateprozess der Software durchführen

Vorbereitungen

Standalone.xml

Folgende Änderungen müssen in der Standalone.xml (Docker: /wildfly/config oder Klassisch: /opt/wildfly/standalone/configuration) angepasst werden.

Unser Muster bzw. die Standard-Standalone.xml, welche während der Erstinstallation ausgeliefert wird, finden Sie hier zum Download. Diese ist an die neuen Gegebenheiten der Version 4.101 angepasst.

Die grundsätzlichen Änderungen finden Sie hier im Vergleich. Bitte beachten Sie, dass die Liste evtl. nicht alle - bei Ihnen konfigurierten Eigenschaften - enthält.

Update - Docker-Umgebung

Dockerfile

Passen Sie die (Standard-)Pfad/wildfly/image/Dockerfile Datei an die neue Version an:

FROM quay.io/wildfly/wildfly:25.0.1.Final

USER root

RUN sed -i s/mirror.centos.org/vault.centos.org/g /etc/yum.repos.d/*.repo
RUN sed -i s/^#.*baseurl=http/baseurl=http/g /etc/yum.repos.d/*.repo
RUN sed -i s/^mirrorlist=http/#mirrorlist=http/g /etc/yum.repos.d/*.repo

# Start ClamAV: Folgende zwei Zeilen nur verwenden, wenn Sie unser ClamAV-Service einsetzen.

RUN yum -y install epel-release && yum -y install clamav
COPY clamd.conf /etc/clamd.d/scan.conf

# Ende ClamAV

RUN sed -i
's/override_install_langs=en_US.utf8/override_install_langs=de_DE.utf8/' /etc/yum.conf
RUN yum -y update glibc-common
ENV LC_ALL="de_DE.UTF-8"
ENV LC_CTYPE="de_DE.UTF-8"
ENV LANGUAGE="de_DE.UTF-8"
ENV LANG="de_DE.UTF-8"

USER jboss

Update-Skript

  1. (Standard-)Pfad - z.B. cd opt/docker/fs

  2. docker-compose down

  3. Im defaultUpdate.sh-Skript den Befehl docker-compose up -d um den Parameter --build ergänzen. Dadurch wird das neue Wildfly-Image gebaut. Dieser Parameter ist nur für dieses Update notwendig und kann nach dem Update entfernt werden.

  4. Updateprozess der Software durchführen

Update - Klassische-Umgebung

  1. Wildfly-Service stoppen

  2. Verzeichnis /opt/wildfly-20.0.1.Final belassen

  3. Ausführung des heruntergeladenen egov-installer.sh via ./egov-installer.sh

  4. Im neuen Verzeichnis /opt/wildfly-25.0.1.Final die gleichen Rechte wie im /opt/wildfly-20.0.1.Final Verzeichnis setzen

  5. Aktuelle Konfiguration (/.formsolutions) aus dem Wildfly 20 Verzeichnis in das neue Wildfly 25 Verzeichnis kopieren

  6. Die geänderte Standalone.xml aus dem Wildfly 20 Verzeichnis in das neue Wildfly 25 Verzeichnis kopieren

  7. Symlink zum neuen Verzeichnis setzen: ln -sf /opt/wildfly-25.0.1.Final/ /opt/wildfly

  8. Achtung: /opt/wildfly/bin/launch.sh muss vorhanden sein. Falls nicht vorhanden: von /opt/wildfly-20.0.1.Final/bin kopieren

  9. Neustart des Applikationsservers wildfly

  10. Sobald das System läuft und getestet wurde, kann das alte Wildfly-Verzeichnis /opt/wildfly-20.0.1.Final gelöscht werden