Auf dem OSS 2 ist ein Joomla 1.x installiert, auf dem OSS 3 jedoch als Standard ein Joomla 1.5. Die Datenbanken dieser Joomla-Versionen sind leider nicht kompatibel. Daher muß ein Update nach folgender Anleitung erfolgen.

Diese Schritte sind nur notwendig, wenn Sie auf dem OSS 2 ein Joomla installiert und genutzt haben, d.h. wenn Sie Artikel aus dem Joomla vom OSS 2 in das neue Joomla übernehmen möchten.  

Die Original-Anleitung für das Update von den Joomla Entwicklern können Sie auf den Joomla Seiten nachlesen.

Lesen Sie diese Anleitung vollständig durch ehe Sie mit dem Update des OSS 2 auf OSS 3 starten!

Sie müssen wenigstens ein Joomla Version 1.0.13 installiert haben, wenn nicht, spielen Sie erst die notwendigen Updates ein! Zur Überprüfung Ihrer Version, melden Sie sich am Joomla Backen https://schulserver/joomla/administrator an. Die Versionsnummer steht dann in der Fußzeile.

Schritt 1: Sicherheitskopie

Legen Sie eine Sicherheitskopie der Joomla-Datenbank an, z.B. indem Sie ein OSS Backup durchführen.

Bedenken Sie auch, dass Veränderungen im Dateisystem /srv/www/oss/joomla, z.B. selbst installierte Komponenten, Bilder, Dateien, Templates nicht mit der Datenbank gesichert werden und Sie diese gesondert sichern müssen! Wenn Sie sich nicht sicher sind, kopieren Sie das gesamte Verzeichnis /srv/www/oss/joomla nach /home/archive/joomla (wenn Sie mit Hilfe von Patch 39 den OSS migrieren möchten) oder auf eine externe Platte.

Schritt 2: Migrator Komponente im OSS 2 installieren

Laden Sie die aktuellste Migrator-Komponnte vom der Pasamio Projket FRS Seite herunter. Wir haben den Test mit dem Migrator 1.5 gemacht.

Installieren Sie diese Komponente in Ihrem OSS 2 Joomla.

1. Ändern Sie in der Datei /etc/php.ini die Zeile
   mbstring.func_overload = 7 auf
   mbstring.func_overload = 0
2. erlauben Sie das Schreiben von Komponenten und Administrator-Komponenten. Führen Sie dazu als root folgende Befehle aus
   chmod og+w /srv/www/oss/joomla/administrator/components
   chmod og+w /srv/www/oss/joomla/components
3. Melden Sie sich dazu als admin im Joomla Backend an: https://schulserver/joomla/administrator (oder dem Link Administrator im Menü folgen).
4. Wählen Sie den Menüpunkt "Installers"->"Components"
5. Geben Sie bei "Package File" über den "Durchsuchen" Knopf die heruntergeladene "migrator.zip" Datei an und wählen Sie dann "Upload File & Install" um die Migrator Komponente zu installieren. Am Ende der Installation auf "Continue" drücken.

Wenn Sie im Joomla zusätzliche Plugins oder Komponenten installiert haben, dann müssen Sie beim Hersteller dieser Plugins/Komponenten nach den Upgrade-Instruktionen suchen und entsprechende Migrations-Tools jetzt installieren.

Schritt 3: Migrations-SQL-Datei erstellen

1. Rufen Sie jetzt den Menüpunkt "Components"->"Migrator" auf
2. Wählen Sie den Link "Create Migration SQL File" um die Liste der Plugins zu erhalten
3. Wählen Sie "Start Migration" um die Erstellung der Datei zu starten
4. Je nach Größe Ihrer Datenbank wird sich die darauffolgende Seite mehrfach aktualisieren und am Ende mit "Migration Complete" antworten
5. Wählen Sie jetzt "Download" um zu der erzeugten SQL-Datei zu gelangen
6. Wählen Sie bei der Datei nochmals "Download" um die Datei auf Ihrem lokalen Rechner zu speichern. Sie sollten diese Datei nicht auf dem OSS speichern, da Sie diesen ja neu installieren.

Schritt 4: Migrationsassistent im OSS 3 installieren und migrieren

Nach der Installation des OSS 3 mit Joomla können Sie die Migrations-SQL-Datei wieder einspielen. Beachten Sie dabei, dass die Joomla-Datenbank vom OSS 3 dabei komplett überspielt wird und evtl. von Ihnen bereits vorgenommenen Änderungen verloren gehen.

1. Installieren Sie den OSS 3. Installieren Sie dabei auch das Joomla Paket
2. Melden Sie sich im Joomla Backend https://schoolserver/joomla/administrator an
3. Wählen Sie den Menüpunkt "Erweiterungen"->"Plugins" und dann das Plugin "Authentication - LDAP"
4. Drucken Sie sich diese Seite aus oder Notieren Sie sich die Werte im Block "Parameter" (alle Werte und achten Sie auf die Sonderzeichen!)
5. Laden Sie den Migrations-Assistenten von Pasamios FRS Projekt mit einem Browser herunter.
6. Wählen Sie im Joomla Backend den Menüpunkt "Erweiterungen"->"Installieren/Deinstallieren"
7. Im Feld "Paketdatei hochladen" geben Sie den Pfad und Dateinamen des heruntergeladenen Migrations-Assistenten an (Über den Durchsuchen Knopf auswählen)
8. Durch den Knopf "Datei hochladen und installieren" installieren Sie diesen Assistenten
9. Über den Menüpunkt "Komponenten"->"Migration Assistant" können Sie den Assistenten jetzt aufrufen
10. Wählen Sie bei "Full Migration" als "Migration Script" die in Schritt 3 erzeugte und heruntergeladene SQL-Datei
11. Wählen Sie als "old Site Encoding" "utf-8"
12. Starten Sie nun über den Knopf "Migrate" die Migration
13. Melden Sie sich ab und wieder am Backend als admin an - Sie werden jetzt in englisch begrüßt
14. Wechseln Sie in das Menü "Extensions"->"Language Manager"
15. Wählen Sie den Tab "Site", setzen Sie den Auswahlpunkt bei "German" und wählen Sie dann rechts oben das gelbe Sternchen "Default"
16. Wählen Sie den Tab "Administrator", setzen Sie den Auswahlpunkt bei "German" und wählen Sie dann wieder rechts "Default" -> jetzt ist wieder Deutsch eingestellt

Schritt 5: Ldap-Verbindung herstellen

1. Melden Sie sich am Joomla Backend als admin an
2. Wählen Sie den Menüpunkt "Erweiterungen"->"Plugins"
3. Wählen Sie das Plugin "Authenticaton - LDAP"
4. Setzen Sie bei "Details" den Punkt "Aktiviert" auf "Ja"
5. Setzen Sie im Block "Parameter" die selben Werte ein, die Sie sich in Schritt 4 Punkt 4 gemerkt haben
   Die korrekten Werte in diesem Block sind:
   host: ldap
   port: 389
   LDAP V3: Ja
   TLS aushandeln: Ja
   Weiterleitungen folgen:Nein
   Autorisierungsmethode: Direkt als Benutzer verbinden
   Basis-DN: <Ihre ldap-DN z.B. dc=extis,dc=de>
   Suchstring: uid=[search]
   Benutzer-DN: uid=[username],ou=people,<Ihre ldap-DN>
   Atribut: Voller Name: cn
   Attribut: E-Mail: mail
   Attribut: Benutzer-ID: uid
6. Speichern Sie die Einstellungen über den Knopf "Speichern" rechts oben
7. Testen Sie die ldap-Anbindung, indem Sie in der OSS Admin-Oberfläche einen neuen bisher unbekannten Benutzer anlegen und sich als dieser am Joomla (https://schoolserver/joomla) anmelden.
8. Wenn der Test mit Schritt 7 klappt, dann können Sie das joomla eigene Plugin für die Anmeldung deaktivieren:
   Melden Sie sich als admin im Joomla Backend an
   Gehen Sie auf das Menü "Erweiterungen"->"Plugsin" und wählen das Modul "Authentication - Joomla"
   Setzen Sie jetzt bei "Details" den Punkt "Aktiviert" auf "Nein" und speichern Sie diese Einstellung über "Speichern"

Schritt 6: Prüfen und Anpassen

Die Migration sollte nun erfolgt sein, Ihre alten Artikel alle vorhanden. Joomla 1.5 ist an einigen Stellen anders, Sie sollten daher folgendes Prüfen:

• Paßt das Layout noch oder sollten Sie besser ein Template das für Joomla 1.5 geschrieben ist verwenden
• Stimmen alle Ihre Internen Verknüpfungen noch, ggf. sollten Sie diese über das Backend als Administrator anpassen
• Sind Ihre Menüpunkte noch korrekt verlinkt