Update von 5.0.1. auf 5.2.2 (Neuaufbau)
Vorab, Gründe für den Umstieg
Anlass der Umstellung war -Ende 2024- der Versuch, die Joomla-Version von 5.0.1 auf 5.2.2 zu updaten; die Joomla-Update-Prüfung nannte als eine Voraussetzung dafür eine mySQL-Version von >8; unsere db war noch Version 5 (der Versionnsprung klingt größer als er ist); der uns zugewiesene db-Server liess aber keine 8er Version zu, dafür musste die Serverumgebung -und der Tarif- gewechselt werden, auf eigene Verantwortung; dieses Vorgehen wurde uns schon im Feb. 24 nahegelegt -damals war es die php- und die SQL-Version- und wir haben den Umstieg vorerst vertagt, u.a. in der Hoffung, Alfahosting würde den Umstieg eines Tages vielleicht doch selbst vollziehen. So gab es also das Angebot, eine zeitlang neben der produktiven Umgebung eine weitere, neuere Umgebung zu bekommen und den Umstieg eigenverantwortlich zu vollziehen.
die alternativen Ansätze
Die von Alfahosting angebotene Joomla-Installation hatte die Version 3.9 (!!), so lief es auf eine manuelle Installation raus, dabei habe ich zunächst zwei Ansätze verfolgt:
-
die vorhandene Installation möglichst komplett in die neue Landschaft zu transferieren und dann updaten;, damit kommt dann natürlich auch einiger Wildwuchs (z.B. nicht mehr genutzte Komponenten, Module, Erweiterungen, Verzeichnisse, Nutzer,… mit; im folgende spreche ich allgemein von „Erweiterungen“, im Einzelnen können das Komponenten, Module, plugins,… sein
-
eine Joomla Grundinstallation in der neuen Umgebung mit der aktuellen Version und die dann nach und nach an den Zustand des vorigen Auftrittes heranführen; vermutlich deutlich mehr Arbeit, aber mit der Chance, dabei die Installation/Konfiguration zu bereinigen und zu verschlanken auf die Komponenten, die wirklich gebraucht werden.
Für beide Fälle war ein Verständnis erforderlich, welche Erweiterungen wofür gebraucht werden, um ggfs. welche zu aktualisieren, wegzulassen, gegen andere auszutauschen,… und dabei auch eine Strategie zu verfolgen, z.B. möglichst nah am Standard zu bleiben oder nur Erweiterungen zu nutzen, die noch gepflegt werden und/oder sich einfach updaten lassen.
erste Versuche/lessons learned
-
der Ex- und Import der Datenbank war vergleichsweise schnell erledigt, Nutzer wurden angelegt, die präfixe ('j3_') auf jeden Fall so gelassen; die ganzen Credentials, die bei der Anlage der -zunächst leeren- 8er db definiert werden, braucht man nur kurz, denn nach dem Import der produktiven Inhalte gelten auch die „alten“ Anmeldedaten. Im Übrigen befinden sich die db-Anmelddaten in der configuration.php im Root-Verzeichnis /J#
-
die Logik mit child themes und overrides habe ich grundsätzlich verstanden (es gibt u.a. eine user.css, in der die eigenen Anpassungen hinterlegt sind und die auch updates der Joomla-Version übersteht); gleichzeitig gibt es im Detail noch einige Verständnis- bzw. Interpretationsprobleme;
-
auch wenn der aktuelle content durch den db-Import schnell verfügbar/zu sehn war, waren beide Ansätze (s.o.) zunächst sehr weit vom aktuellen Auftritt entfernt, bis ich -eher zufällig- die /css/template.min.css umbenannt habe
-
durch den db-Import kommt deutlich mehr als nur der content (die Beiträge) in den Auftritt, so z.B. auch viele Erweiterungen -die angepassten Templates wiederum offenbar nicht
-
eine Joomla-Installation out of the box hat
-
5 Komponenten (Banner, Kontakte, Newsfeed, Tags, Suchindex)
-
3 Site-Module (BreadCrumbs, Main menu, Login Form)
-
150 plugins
-
248 (!) Erweiterungen, darunter z.B. MFA Yubikey, per default aktiviert !?!
-
-
die Grundinstallation mit importierter db hat gleich deutlich mehr Erweiterungen, wenn auch deren Konfiguration voraussetzt, dass die entsprechenden Verzeichnisse vorhanden sind -andernfalls kommt beim Aufruf der Erweiterung die Meldung: Modul-xml-Datei nicht vorhanden(verfügbar?); dann bleibt nur das Rüberkopieren aus einer funktionierenden Installation oder eben die Neuinstallation -was wohl die sauberere Lösung ist, u.a weil manchmal auch weitere Verzeichnisse als das zugehörige mod_### gebraucht werden
-
bei der Recherche, welche Erweiterungen für was „zuständig“ sind wurde schnell klar, dass die Site Module eine zentrale Rolle spielen; z.B.:
-
Site Modul: „Sidebar left“ ⇒ Position: Sidebar left ⇒ de-/aktivieren
-
Site Modul: Navigationspfad ⇒ „BreadCrumbs“/Aktuelle Seite
-
-
außerdem gibt es aber
-
Layout der Startseite: Navileiste „Menüs“/Hauptmenü ⇒ Reiter „Details“, „Blog-Layout“ (RSV-Logo) und Metadaten (Der RSV Mellensee ist ein Verein…)…
-
der Weg zur Nachbildung des gewohnten Auftritts/der Umzug
am Anfang steht der Export der produktiven db (mySQL5.#, aus der alten Umgebung), das Erstellen einer neuen, leeren db (mySQL8.#) in der neuen Umgebung (incl. Anlage berechtigter Nutzer) und der Import der Inhalte aus dem Export; dabei gab es kleinere Probleme in Sachen Zuordnung Nutzer⇔db, aber letztlich funzte es…
vorab: die Grundinstallation: das aktuelle Joomla-Paket als zip-Datei herunterladen, „unten“ auspacken und dann „nach oben“ laden, zumindest kenne ich noch keinen Weg um die zip-Datei auf dem Server zu entpacken; das wäre vermutlich die effizientere Methode, denn der entpackte upload dauert eine gute Viertelstunde und braucht meist noch einen zweiten Anlauf, um auch die fehlgeschlagenen Übertragungen nochmal anzuschieben.
und: Achtung, Falle! wenn mehrere Auftritte (z.B. Test und Prod) auf eine (dieselbe) db schauen, dann schlagen manche Änderungen unverhofft durch, z.B. die Änderung des Hintergrundbildes auf der Startseite, die Anordnung der Module in den Sidebars oder auch die Sichtbar-Machung der Überschriften dieser Module
was ich gemacht habe, die Reihenfolge muss nicht immer zwangsläufig eingehalten werden
-
mit/nach der Installation die db angepasst -auf wfw…_prod,
damit ist der content da, außerdem das Top-Menü (oben links, Disclaimer, Impressum, DSGVO), der „Willkommen…“-Schriftzug über dem -nicht vorhandenen-Bild, das Navi-Menü („BreadCrumbs“) sowie das Layout (oben zweispaltig, dann 5 Artikel, 12 Links auf weitere Artikel, 10 Links auf weitere Seiten, die Seitenzahl sowie der TOP-Link nach oben); was fehlt sind z.B. die Farben und also das Template und das wird auch „angemeckert“ -
Template „cassiopeia_rsv“ 'rüberkopiert, damit sind die Farben, Ränder,… fast komplett, was fehlt sind Icons(Gifs bei den LA-Artikeln) sowie Bilder -hierfür hilft das Rüberkopieren der /images-Ordnerstruktur
-
Indizierung/Suche reaktivieren; muss vermutlich nicht nach jedem Umzug neu passieren, aber die Suche hatte ich zuletzt wg. Fehlermeldungen deaktiviert, wollte sie aber jetzt wieder aktivieren/nutzen/anzeigen. Hintergrund: seit der Migration von Joomla 3 auf 4 gibt es die „alte“ Suche nicht mehr, stattdessen gibt es jetzt das Site Modul „Suchindex“ deshalb:
im Menü „Site Module“ ⇒ '+' / Neu ⇒ Filter: „Such“⇒ „Suchindex“ (Modultyp) hinzu, Titel vergeben, Position definieren (Sidebar rechts) ⇒FERTIG! (ggfs. noch den Suchindex aufbauen/aktualisieren und testen; analgog kann auch mit mit dem Modul „wer ist online“ verfahren werden; das Site Modul Benutzermenü ist das Menü für den angemeldeten Nutzer (Navigation-Menü, Rt: Modul ⇒Menü:Benutzermenü + Basiseintrag:Beitrag erstellen) -
Banner, Images,..; rüberkopieren der beiden Dateien (Volleyball und Logo) nach /mages/banner;
1x Site Modul „Image“ ⇒ Options ⇒ Hintergrund: Bild auswählen (Vereins-Foto)
1x nach Site Template Stile ⇒ cassiopeia_rsv ⇒Rt. Erweitert ⇒ Bild ausw. (Logo/Banner) -
Navileiste oben mod_djmegamenu
beim Aufruf errmsg: xml-Datei nicht verfügbar; Verz. „mod_djmegamenu“ aus bestehender Installation rüberkopiert; Stil/Theme anpassen im Modul, Rt. „Options“ ⇒ Theme: Clean -
Sponsoren/Kalender/Events; Sponsoren ⇒ errmsg: xml nicht vorhanden; rüberkopiert aus best. Inst, reicht aber nicht, es werden außerdem ein Ordner /images/sponsoren und dort Bilddateien erwartet.vielleicht ist hier anstatt des Rüberkopierens eine Neuinstallation nachhaltiger…; bei den Events hat ein Rüberkopieren (von mod_jevents und com_jevents) zu fatalen Fehlern beim Seitenaufbau geführt, daher die Version 3.6.83 (soll mit J5 kompatibel sein) von jevents.net heruntergeladen und über „Erweiterung installieren“ hinzugefügt; am Ende kamen zwei Meldungen: Bibliotheksdatei deinstallieren ;Manifestdatetei ungültig/fehlt UND Paketinst. abgeschlossen; in jedem Fall waren anschliessend sofort Kalender und Termine sichtbar!
-
Besucherzähler; zunächst checken, ob jsvisit in der neusten Version überhaupt noch geeignet ist -zuletzt gab's bei der Updateprüfung Fehlermeldungen
-
2do: check: den Djimageslider (wg der Sponsoren) auch nochmal komplett neu installieren, dann kommt vermutlich auch das modul mit; was hatte ich noch mit einem „stumpfen Kopieren“ erledigt? djmegamenu eher, jevents eher nicht…
-
was noch: evt über Module wie Wortwolke, neuste/meistgelesene Beiträge, oder den mitlaufenden Balken nachdenken, dabei nicht zu viele Spielereien einbauen; Anfahrt nicht vergessen, ebenso vielleicht Bild „Sportplatz von oben“, Wichtig vor dem Abschalten der alten Umgebung: Blick in die Archive retten (dabei nochmal über Lesbarkeit/Farben nachdenken) UND DOKU!!
Auftritt Joomla5.2.3 löschen und vielleicht noch einen oob Auftritt dazu „packen“