Wiki-Quellcode von Update Wildfly 25

Zuletzt geändert von MACH ProForms GmbH am 20.11.2024

Verstecke letzte Bearbeiter
MACH ProForms GmbH 4.1 1 = Allgemeine Hinweise =
2
MACH ProForms GmbH 13.1 3 Für das Update auf die Version 4.101 ist ein Update des Applikationsserver Wildfly zwingend Voraussetzung. Sie können [[hier >>https://www.wildfly.org/news/2021/10/05/WildFly25-Final-Released/]]auf die Erweiterungen bzw. Veränderungen des Herstellers zugreifen und sich über die neuen Möglichkeiten informieren.
MACH ProForms GmbH 4.1 4
MACH ProForms GmbH 13.1 5 (% class="box infomessage" %)
6 (((
7 Diese Anleitung beschreibt den __kompletten__ Updateprozess inkl. der Aktualisierung der Software.
8 )))
9
MACH ProForms GmbH 16.1 10 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.
11
12 == Ablauf ==
13
14 1. Backup durchführen
15 1. Abhängig der verwendeten Umgebung, folgen Sie bitte entweder den Anweisungen für eine Docker basierenden oder einer klassischen Umgebung.
16 1. [[Updateprozess >>url:https://wiki.form-solutions.de/wiki/admindoku/view/Main/01_Systemadministration/05_Anleitungen/03_Update/]]der Software durchführen
17
18 = Vorbereitungen =
19
20 == Standalone.xml ==
21
22 Folgende Änderungen müssen in der //Standalone.xml// (Docker: ///wildfly/config// oder Klassisch~:// /opt/wildfly/standalone/configuration//) angepasst werden.
23
24 Unser Muster bzw. die Standard-Standalone.xml, welche während der Erstinstallation ausgeliefert wird, finden Sie [[hier >>https://cloud.machproforms.de/index.php/s/b7fKTQ4M5xobZAM]]zum Download. Diese ist an die neuen Gegebenheiten der Version 4.101 angepasst.
25
MACH ProForms GmbH 20.1 26 Die grundsätzlichen Änderungen finden Sie [[hier >>doc:.Anpassungen Wildfly 25 Standalone\.xml.WebHome]]im Vergleich. Bitte beachten Sie, dass die Liste evtl. nicht alle - bei Ihnen konfigurierten Eigenschaften - enthält.
MACH ProForms GmbH 19.1 27
MACH ProForms GmbH 16.1 28 = Update - Docker-Umgebung =
29
30 == Dockerfile ==
31
32 Passen Sie die //(Standard-)Pfad/wildfly/image/Dockerfile// Datei an die neue Version an:
33
34 (% class="box" %)
35 (((
36 FROM quay.io/wildfly/wildfly:25.0.1.Final
MACH ProForms GmbH 26.1 37
38 USER root
MACH ProForms GmbH 27.1 39
MACH ProForms GmbH 26.1 40 RUN sed -i s/mirror.centos.org/vault.centos.org/g /etc/yum.repos.d/*.repo
41 RUN sed -i s/^#.*baseurl=http/baseurl=http/g /etc/yum.repos.d/*.repo
42 RUN sed -i s/^mirrorlist=http/#mirrorlist=http/g /etc/yum.repos.d/*.repo
MACH ProForms GmbH 27.1 43
MACH ProForms GmbH 28.1 44 # Start ClamAV: Folgende zwei Zeilen nur verwenden, wenn Sie unser ClamAV-Service einsetzen.
45
46 RUN yum -y install epel-release && yum -y install clamav
47 COPY clamd.conf /etc/clamd.d/scan.conf
48
49 # Ende ClamAV
50
MACH ProForms GmbH 27.1 51 RUN sed -i 's/override_install_langs=en_US.utf8/override_install_langs=de_DE.utf8/' /etc/yum.conf
52 RUN yum -y update glibc-common
53 ENV LC_ALL="de_DE.UTF-8"
54 ENV LC_CTYPE="de_DE.UTF-8"
55 ENV LANGUAGE="de_DE.UTF-8"
56 ENV LANG="de_DE.UTF-8"
57
58 USER jboss
MACH ProForms GmbH 16.1 59 )))
60
61 == Update-Skript ==
62
63 1. (Standard-)Pfad - z.B. //cd opt/docker/fs//
64 1. //docker-compose down//
MACH ProForms GmbH 30.1 65 1. 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.
MACH ProForms GmbH 24.1 66 1. [[Updateprozess >>url:https://wiki.form-solutions.de/wiki/admindoku/view/Main/01_Systemadministration/05_Anleitungen/03_Update/]]der Software durchführen
MACH ProForms GmbH 16.1 67
68 = Update - Klassische-Umgebung =
69
MACH ProForms GmbH 21.1 70 1. Wildfly-Service stoppen
MACH ProForms GmbH 29.1 71 1. Verzeichnis ///opt/wildfly-20.0.1.Final// belassen
72 1. Ausführung des heruntergeladenen egov-installer.sh via //./egov-installer.sh//
MACH ProForms GmbH 30.1 73 1. Im neuen Verzeichnis ///opt/wildfly-25.0.1.Final// die gleichen Rechte wie im// /opt/wildfly-20.0.1.Final// Verzeichnis setzen
MACH ProForms GmbH 29.1 74 1. Aktuelle Konfiguration (/.formsolutions) aus dem Wildfly 20 Verzeichnis in das neue Wildfly 25 Verzeichnis kopieren
75 1. Die geänderte Standalone.xml aus dem Wildfly 20 Verzeichnis in das neue Wildfly 25 Verzeichnis kopieren
76 1. Symlink zum neuen Verzeichnis setzen: //ln -sf /opt/wildfly-25.0.1.Final/ /opt/wildfly//
77 1. Achtung: ///opt/wildfly/bin/launch.sh// muss vorhanden sein. Falls nicht vorhanden: von ///opt/wildfly-20.0.1.Final/bin// kopieren
78 1. Neustart des Applikationsservers wildfly
79 1. Sobald das System läuft und getestet wurde, kann das alte Wildfly-Verzeichnis ///opt/wildfly-20.0.1.Final// gelöscht werden