Wiki-Quellcode von Update Wildfly 25

Zuletzt geändert von MACH ProForms GmbH am 20.11.2024

Zeige letzte Bearbeiter
1 = Allgemeine Hinweise =
2
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.
4
5 (% class="box infomessage" %)
6 (((
7 Diese Anleitung beschreibt den __kompletten__ Updateprozess inkl. der Aktualisierung der Software.
8 )))
9
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
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.
27
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
37
38 USER root
39
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
43
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
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
59 )))
60
61 == Update-Skript ==
62
63 1. (Standard-)Pfad - z.B. //cd opt/docker/fs//
64 1. //docker-compose down//
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.
66 1. [[Updateprozess >>url:https://wiki.form-solutions.de/wiki/admindoku/view/Main/01_Systemadministration/05_Anleitungen/03_Update/]]der Software durchführen
67
68 = Update - Klassische-Umgebung =
69
70 1. Wildfly-Service stoppen
71 1. Verzeichnis ///opt/wildfly-20.0.1.Final// belassen
72 1. Ausführung des heruntergeladenen egov-installer.sh via //./egov-installer.sh//
73 1. Im neuen Verzeichnis ///opt/wildfly-25.0.1.Final// die gleichen Rechte wie im// /opt/wildfly-20.0.1.Final// Verzeichnis setzen
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