Kurzanleitung Wie kann ich meine Joomla! 1.5.x auf die neue 2.5 umstellen? (upgraden) Version 1.2-11.02.2012
Einleitung Fast vier Jahre lang mussten die Joomla! Nutzer warten, bis der neue Joomla! 2.5 Release geboren war. Während dieser Zeit wurden natürlich einige Joomla! 1.5 Seiten gemacht, die nun aktualisiert werden wollen. Dies ist aber leider mit einem einfachen Darüberkopieren der neuen Files nicht erledigt. Daher habe ich versucht eine Schritt für Schritt Anleitung für Umsteigewillige zu erstellen. Diese Anleitung bewahrt euch nicht vor unvorhergesehenen Fehlern und viele Stunden Arbeit. Zudem ist sie auch nicht für einen Joomla!-Neuling gedacht, da in diesem Script auch Begriffe und Hilfsmittel verwendet werden, die eher dem Joomla!-Kenner bekannt sind. Gewisse minimale Grundkenntnisse und Joomla!-Erfahrungen sind also nötig. Hinweis: Alle Abbildungen die ihr hier seht, sind auf einem MAC erstellt worden. Es kann also gut sein, dass sich gewisse Bilder und Installationsschritte auf anderen PC-Plattformen geringfügig unterscheiden. Für die Migration solltet ihr euch genügend Zeit nehmen und diese Anleitung erst mal kurz durchlesen bevor ihr loslegt. Schreibfehler bitte an info@blueforce.ch oder über das Kontaktformular auf der Webseite melden. So helft ihr aktiv mit, die Anleitung laufend zu optimieren. Grundsätzlich gibt es zwei Ansätze, wie ihr eure Seite aktualisieren könnt. Es gibt eine automatisierte Variante, von der ihr aus einer bestehenden Joomla! 1.5 Seite auf eine Joomla! 2.5 updaten könnt, oder ihr könnt die vorhandene Seite manuell in eine neue, leere Joomla! 2.5 übertragen. In dieser Anleitung ist nur die erste Variante beschrieben. Solltet ihr die zweite Variante bevorzugen so schaut unter http://docs.joomla.org (Joomla! 2.5 Manual, Kapitel 4, in Englisch) nach. Dort ist dieses Vorgehen genau beschrieben. Noch was zum Copyright: Diese Anleitung darf beliebig kopiert, erweitert und angepasst werden. Falls ihr aber Sachen darin ergänzt wäre ich natürlich froh, wenn ihr mir davon ein Update auf info@blueforce.ch zustellen würdet. Ganz im Sinne der Community lerne ich nicht nur dazu, sondern es profitieren auch wieder alle. Vielen Dank. So, nun wünsche ich euch viel Erfolg beim Umstellen (Updaten) eurer 1.5.x Joomla! Webseiten Projekte auf die neue Version 2.5. 1. Vorbereitungen Bevor man so richtig mit Updaten loslegen kann, muss man erst mal ein paar Vorbereitungen tätigen. Als kleine Übersicht habe ich eine kleine Grafik erstellt, die euch ev. Bei diesem Entscheid weiterhelfen können. Zudem sind die nachfolgenden punkte nach dem gleichen Raster abgehandelt. Version 1.2 (11.02.2012) 2 / 21 2012 blueforce.ch
Version 1.2 (11.02.2012) 3 / 21 2012 blueforce.ch
1.1 Alles Joomla! 2.5 ready? Sei dir im Klaren, dass deine Webseite nebst der Joomla! Basis-Installation auch noch diverse Komponenten, Module und Plugins sowie ein Template hat. Alle diese Elemente müssen ebenfalls unter Joomla! 2.5 lauffähig sein oder bleiben. Falls ihr ein vorhandenes Joomla! 1.5 Template übernehmen wollt, müsst ihr darin ein paar Dateien und Konstanten (TAG s) umschreiben. 1.2 Bestehende 1.5.x Seite sichern Zu aller erst empfiehlt es sich eine lokale Kopie deiner Webseite 1.5.x auf dem PC/Mac anzulegen. Wichtig: Bitte immer mit Kopien arbeiten und nicht an produktiven Seiten üben, da immer etwas schief gehen kann. Glaubt mir, ihr werdet es mir verdanken. Eine Sicherung legt ihr am besten mit der Komponente Akeeba-Backup (http://www.akeebabackup.com) an. Dabei werden sämtliche Dateien und die mysql- Datenbank in eine *.jpa Datei gesichert. Falls diese bereits vorhanden ist, kann man schon zum nächsten Punkt. Die Akeeba-Backup Komponente könnte ihr in einer kostenlosen Basis-Variante oder in der kostenpflichtigen Pro-Variante herunterladen. Für unser Vorhaben genügt aber die kostenlose Basis-Variante. Wie ihr die Komponente ideal konfiguriert, könnt ihr im PDF Tutorial, welches ebenfalls auf der Akeeba Webseite (Akeeba Backup Quick Start Guide) gibt, herunterladen und nachlesen. 1.3 Bestandesaufnahme der Drittanbietererweiterungen Wenn deine Seite, wie eingangs erwähnt, nebst den Basisdaten von Joomla! noch weitere Erweiterungen installiert hat, muss man unbedingt vor dem Upgrade schauen, welche das sind. Damit deine Seite mit Joomla! 2.5 richtig funktioniert müssten alle vorhandenen Komponenten, Module und Plugins für Joomla! 2.5 ready sein. Dies kann aber sicher noch eine weile dauern. Da unsere automatische Upgrade-Komponente (jupgrade) zurzeit noch keine 3pd Erweiterungen (Anwendungen von Drittanbietern) unterstützt, müsst ihr wissen, ob ihr mit dem Upgraden noch warten wollt, bis es verfügbare Upgrade-Plugins dazu gibt oder ob ihr mögliche Probleme und Inkompatibilitäten in Kauf nehmen wollt. Wenn eure Seite solche Erweiterungen enthält, dann solltet ihr eine kurze Liste davon erstellen. Diese benötigen wir später, um nach 2.5 kompatiblen Erweiterungen und Aktualisierungen zu suchen. Für die Liste schreibt euch Name der Komponente und Entwicklerwebseite, sowie die entsprechende Version der Erweiterung auf. Dafür meldet ihr euch im Administrationsbereich (Backend) eurer bestehenden Seite an. Anschliessend navigiert ihr zum Installer. Version 1.2 (11.02.2012) 4 / 21 2012 blueforce.ch
Sobald ihr euch im jeweiligen Bereich (Komponenten, Module, Plugins, Templates) befindet werden euch die entsprechenden Erweiterungen mit allen nötigen Angaben aufgelistet. Schreibt euch die Namen, Webseiten-URL und Version der Erweiterung auf. Dies benötigen wir um später nach den 1.5-fähigen Erweiterungen zu suchen. Achtet dabei auf die folgenden Zeichen: Weiter soll euch die Liste aufzeigen, ob es sinnvoll ist die Seite jetzt schon um zu stellen oder vielleicht noch etwas abzuwarten, bis alle gewünschten Drittanbieter Erweiterungen verfügbar sind. Stellt ihr fest, dass es wenig oder gar keine Alternativen gibt, dann habt noch etwas Geduld mit Umstellen. Eine Liste der Joomla! 2.5 kompatiblen Erweiterungen findet ihr immer tagesaktuell unter: http://extensions.joomla.org Unter erweiterter Suche (engl.: Advanced Search) könnt ihr auch nach Joomla! Versionen gelistete Erweiterungen suchen. Version 1.2 (11.02.2012) 5 / 21 2012 blueforce.ch
Grundsatz: Je weniger Drittanbieter Erweiterungen ihr installiert habt, umso leichter lässt sich eure alte Seite umstellen! 1.4 Template anpassen oder ersetzen Als nächstes gilt es abzuklären, ob ihr euer bestehendes Webseitenlayout (Template) behalten wollt oder nicht. Hier kann man sagen, dass Joomla! 2.5 sehr viel mehr Möglichkeiten bei der Gestaltung (unterschiedliche Klassen) mitbringt als Joomla! 1.5, aber dadurch der Aufbau der Templates und die darin verwendeten PHP-Tags teilweise verändert wurden. Auch hier geht ihr für die Bestandesaufnahme gleich vor wie bei den Erweiterungen. Schaut euch bei eurem favorisierten Templateanbieter/Club um, ob euer Wunschtemplate bereits für Joomla! 2.5 zur Verfügung steht. Tipp: Wie man ein Template recht einfach von 1.5 auf 2.5 anpasst, findet ihr im Blog von Alex eine sehr gute Anleitung: (http://www.bloggerschmidt.de/blog/item/template-upgrade-15-auf-16.html) oder auch in der Joomla! Online Dokumentation: (http://docs.joomla.org/tutorial:upgrade_joomla_1.5_template_to_joomla_1.6) in Englisch. Falls euch diese Anleitung nicht ausreicht oder ihr gern mehr über die Template- Erstellung in Joomla! 2.5 wissen wollt, dann gibt es von Alex auch ein ganzes Buch dazu. Version 1.2 (11.02.2012) 6 / 21 2012 blueforce.ch
Ich werde aber hier in dieser Anleitung nicht näher auf Templates anpassen eingehen. 1.5 Richtige PHP-Version verwenden Da Joomla! 2.5 läuft nur noch unter PHP 5. Darum empfiehlt es sich, sicher zu stellen ob mein Hoster das schon so anbietet. Denn es kann sein, dass deine Joomla! 1.5 ev. noch mit PHP 4 läuft. Um sicherzustellen, welche Version bei deinem Hoster/localhost läuft, könnt ihr im Backend (BE) unter System Info nachsehen. Die übrigen Konfigurationen im PHP.ini sind für Joomla! 2.5 identisch wie für die Vorgängerversionen. Je nach Hostingangebot lässt sich die PHP.ini sowie die Versionierung der PHP Version konfigurieren. Auch diese Abklärungen können im Vorfeld helfen zu entscheiden ob man schon umstellen will/soll oder eben nicht. Habt ihr eure Joomla! 1.5 Installation noch nicht auf die neuste Version (zur Zeit: 1.5.25) aktualisiert, dann empfiehlt es sich, dies noch vor der Migration zu tun. Das wäre mal in groben Zügen das Wichtigste, was man Vor der Umstellung erledigen sollte. Version 1.2 (11.02.2012) 7 / 21 2012 blueforce.ch
2. Anlegen einer lokalen Kopie meiner Joomla! 1.5 Seite Da es zwingend nötig ist, dass ich das Upgrade nicht an einer Live-Webseite ausprobiere, lege ich mir dafür lokal auf meinem PC/Mac eine Kopie an. Wenn ihr das Backup wie im voran gegangenen Kapitel beschrieben, ausgeführt habt, dann können wir loslegen. Hinweis: Ich gehe davon aus, dass ihr schon lokal einen Webserver (XAMP/MAMP) eingerichtet habt. Ist das nicht der Fall, so müsst ihr das zuerst nachholen. Anleitungen dazu gibt es genügend im Netz. Einfach mal nach den Stichwörtern XAMP für PC User oder für Mac-User MAMP googeln. Habt ihr einen lokalen Webserver eingerichtet, braucht ihr nur die frisch erstellte Backupdatei: (site-domain-timestamp.jpa) von eurer Live-Seite herunter zu laden. Dies solltet ihr via FTP-Programm (z.b. Filezilla, Yummy) machen. Bitte (noch) nicht auspacken! Zip-Formate können übrigens genauso gut ausgepackt werden. Wichtig ist nur, dass ihr bei eurem Akeeba-Backup den integrierten J!-Installer mit drin habt. Für den Auspackvorgang braucht ihr noch das Akeeba-Kickstart Paket, dass ihr ebenfalls auf der Akeeba Webseite findet. (http://www.akeebabackup.com) Die Kickstarter-Datei ist ebenfalls eine gezippte, die ihr einfach mal lokal speichert. Danach erstellt ihr auf dem lokalen htdocs Ordner ein neues Verzeichnis mit dem Namen eurer Seite. Anschliessend entpackt ihr die Kickstart-Datei und legt die ca. 11 Dateien in den neu angelegten Ordner. Auch die *.jpa Datei kommt dort rein. Wenn ihr das alles habt müsste eurer Ordner etwa so aussehen: Version 1.2 (11.02.2012) 8 / 21 2012 blueforce.ch
Sobald alles so wie oben angezeigt abgelegt ist, könnt ihr das Verzeichnis in eurem Webbrowser aufrufen. Öffnet als erstes die kickstart.php Datei. Danach sollte ca. so was erscheinen: Mit der esc -Taste kommt ihr auf die Startseite des Akeeba-Installers. Nun auf Start klicken und los geht s... Version 1.2 (11.02.2012) 9 / 21 2012 blueforce.ch
Nun entpackt der Installer als erstes die Dateien und bereitet die Installation vor. Paralell dazu könnt ihr im phpmyadmin eine neue Datenbank anlegen. Am besten benennt ihr den Datenbankname gleich wie der von der Liveseite. Gleiches gilt natürlich auch für den Datenbankbenutzer. Selbstverständlich könnt ihr den auch anders benennen. Dach dem Entpacken öffnet sich automatisch ein neues Fenster: Hier sollte möglichst alles im Grünen sein. Ansonsten kann die Installation nicht fortgesetzt werden. Danach einfach oben rechts auf Vor klicken. Bei der Eingabe der Datenbankverbindung die Daten (DB-Name und DB-User) der frisch angelegten Datenbank eingeben. Wenn alles korrekt eingegeben wurde, sollte der Installer die Datenbank mit euren Datentabellen befüllen. Version 1.2 (11.02.2012) 10 / 21 2012 blueforce.ch
Nach Abschluss dieses Vorgangs mit ok Bestätigen und nun kommt schon der letzte Schritt, wie man ihn auch von Joomla! her kennt. Benutzernamen und Passwort frisch eingeben oder das alt bekannte einsetzen und speichern. Jetzt kann man mit dem Klick auf den Link Installationsverzeichnis löschen den Joomla! Installationsordner löschen. Selbstverständlich kann man das auch manuell machen. Zudem kann man im noch offenen Browserfenster mit dem Akeeba Installer auf den Knopf aufräumen klicken. Dabei werden alle Kickstart-Dateien gelöscht. So, jetzt müsste eure Seite auf dem lokalen PC/Mac laufen. Gratulation! Version 1.2 (11.02.2012) 11 / 21 2012 blueforce.ch
3. Download und Installation der Upgrader-Komponente Wie eingangs erwähnt, werde ich in dieser Anleitung nur die automatische Aktualisierung des Joomla! Cores beschreiben. Natürlich könnte man das Update auch manuell durchführen, in dem man die neuen Dateien einfach auf eine bestehende Joomla! 1.5 Installation drüber kopiert. Da Joomla! 2.5 die gleiche Framework-Architektur wie die 1.5er verwendet, sollte die Webseite lauffähig bleiben. Auch die Datentabellen wurden durch den Einbau der ACL (Access Level Control) nur erweitert aber nicht grundsätzlich verändert. 3.1 Die manuelle Variante Wird vorerst nicht beschrieben. Kann aber ev. zu einem späteren Zeitpunkt nachgeholt werden. Infos zum manuellen Upgrade findet ihr auch in der Joomla! Online Dokumentation unter: http://docs.joomla.org/manual_2_5 ACHTUNG: Die manuelle Variante hat den Nachteil, dass die von der Joomla! 1.5 nicht mehr benötigten Dateien nicht automatisch gelöscht werden. Diese überzähligen Sachen müsste man ebenfalls manuell löschen. 3.2 Die automatisierte Variante Grundsätzlich unterscheidet sich der Updatevorgang von der Joomla! 1.5 zu Joomla! 2.5 Version zu früheren Joomla! 1.0 zu Joomla! 1.5 Versionen darin, dass wir keine leere Joomla! 2.5 Version manuell downloaden installieren und als Ausgangsinstallation verwenden. Wir können direkt aus dem Backend der vorhandenen 1.5 er Installation die neue Version installieren. In diesem Beispiel verwenden wir die Komponente jupgrader, Version 2.5. von Matias Aguirre (http://www.matware.com.ar/). Technische Voraussetzungen: PHP 5.x muss auf dem Hosting laufen Curl module im php.ini muss aktiviert sein Joomla 1.5.x muss installiert sein Webbrowser mit Javascript/jQuery Unterstützung Welche Daten werden in die neue Version übernommen? Benutzer Kategorien Inhalte/Artikel Banner Menüs und Struktur Module Kontakte Newsfeeds Version 1.2 (11.02.2012) 12 / 21 2012 blueforce.ch
Umfragen Weblinks Templates (Angabe Entwickler! Ich konnte meins nicht upgraden!) Die Migration der Daten aus den Tabellen von Drittanbietererweiterungen ist zwar angedacht aber im Moment noch nicht erhältlich. Was macht die Upgraderkomponente? 1. Sie lädt im Hintergrund die aktuelle Joomla! 2.5 Version herunter und speichert sie ins Temporärverzeichnis der Komponente. Der Pfad muss Schreibrechte (CHMOD 777) besitzen: www.deineseite.ch/administrator/components/com_jupgrade/joomla25.zip 2. Nach dem Herunterladen werden die Dateien ausgepackt. Diese werden in einem Unterverzeichnis namens jupgrade abgelegt. Die Ausgangseite im Root- Verzeichnis bleibt dabei bestehen und natürlich auch lauffähig. z.b. www.deineseite/jupgrade/xxx 3. In der Datenbank werden die migrierten Tabellen mit dem Präfix j17_xxx gekennzeichnet und zu der bestehenden Datenbank hinzugefügt. Es sind aktuell 34 Tabellen die hinzu kommen. 4. Es wird im Unterordner jupgrade eine neue configuration.php Datei geschrieben. Wichtig: Das Installationsverzeichnis muss manuell gelöscht werden. Zudem, wenn ihr ein altes.htaccess für die 1.5 verwendet hattet, müsst ihr dieses manuell ersetzen, sobald die Seite ins Root-Verzeichnis verschoben wird! Wie vorgehen? Eigentlich wäre mit dem oberen Abschnitt schon alles erklärt, was man für ein erfolgreiches Upgrade wissen muss. Jedoch weiss ich, dass die jupgrade Komponente nicht immer sauber durch läuft. Ich benötigte einige Anläufe, bis das Upgrade geglückt ist. Daher nicht aufgeben. Die Einstellungen der jupgrade Komponente helfen euch dabei. Oder man kann auch testhalber eins-zwei 3rd-Komponenten entfernen, bevor ihr dann einen neuen jupgrade-durchgang probiert usw. Aber zum euch hier zeigen, dass es, wenn man alles korrekt macht, es wirklich funktioniert, werde ich euch noch ein paar Bildschirmausschnitte einfügen. Als erstes könnt ihr eine aktuelle Version dieser Komponente unter: http://redcomponent.com/free-downloads/cat_view/931-jupgrade herunterladen. Dabei müsst ihr euch zuerst auf der RedComponent Webseite registrieren, um an den Download-Button zu kommen. Damit ihr nicht nochmals ein Konto lösen müsst, um dann auf Ewig mit RedComponent-Werbung belästigt zu werden, könnt ihr auch folgende Registrierungsdaten verwenden: - Benutzername: goi - Passwort: passwort Version 1.2 (11.02.2012) 13 / 21 2012 blueforce.ch
Anschliessend geht ihr in euer Webseiten-Backend und installiert die Komponente wie gewohnt. Danach könnt ihr die Komponente unter Komponenten > jupgrade aufrufen. Dan erscheint folgender Screen: Rechts oben könnt ihr noch individuell ein paar Parameter-Einstellungen anpassen. Aber falls ihr nicht zum Experimentieren aufgelegt seid, belasst es am Besten so wie es standardmässig eingegeben ist. Bei der Distribution könnt ihr noch aussuchen, ob ihr Joomla! 2.5 oder 1.7 resp. Molajo (eine Joomla! Distribution www.molajo.org) installieren möchtet. Version 1.2 (11.02.2012) 14 / 21 2012 blueforce.ch
Dann nur noch auf Start Upgrade klicken und zuschauen, was passiert. Wenn ihr zu den Glücklichen gehört, welche alles auf Anhieb geht, habt ihr innherhalb von 30 Sekunden die Seite von Joomla! 1.5 auf Joomla! 2.5 migriert. Erscheint euch ein Screen, dass ihr zuerst das Mootools Upgrade aktivieren sollt, dann müsst ihr zuerst in eurer Plugin-Verwaltung das System-Plugin aktivieren. Fehlt bei euch der Eintrag in der Pluginliste, dann habt ihr wahrscheinlich nicht die neuste Joomla! 1.5.25 Version. Dann müsst ihr zuerst auf die neuste 1.5.x Version aktualisieren. Version 1.2 (11.02.2012) 15 / 21 2012 blueforce.ch
Es kann aber gut sein, dass beim Punkt Decompressing/Entpacke Paket der Statusbalken stehen bleibt. Wenn der Balken länger als eine Minute stehen bleibt, kann er die Dateien nicht extrahieren. Dann bitte kontrollieren, ob jupgrade den Ordner jupgrade im Rootverzeichnis der Webseite angelegt hat. Falls nicht, kann es sein, dass er im Webseiten Root keine Schreibrechte hat. Die CMODs müssen lokal auf 777 stehen! Version 1.2 (11.02.2012) 16 / 21 2012 blueforce.ch
Version 1.2 (11.02.2012) 17 / 21 2012 blueforce.ch
Nach ca. 30 Sekunden sollte die Meldung : Joomla! 2.5 Upgrade Finished!. Jetzt muss man aus Sicherheitsgründen nur noch den Ordner installation im Ordner jupgrade löschen. Und schon kann man sich ins neue Backend einloggen. ACHTUNG: Die Komponente jupgrade legt automatisch einen Unterordner namens jupgrade im Rootverzeichnis eurer Webseite an. Die alte Joomla! 1.5 Seite wird also nicht überschrieben! Nun könnt ihr euer Front- bzw. Backend wie folgt aufrufen: Version 1.2 (11.02.2012) 18 / 21 2012 blueforce.ch
Frontend: http://localhost:8888/deineseite/jupgrade/ Nicht erschrecken, wenn euer Template nicht wie gewohnt erscheint (s. oben). Denn der Installer schaltet standardmässig auf das Core-Template um. So könnt ihr euer Template in aller Ruhe auf den neusten Stand bringen. Backend: http://localhost:8888/deineseite/jupgrade/administrator Es empfiehlt sich in der Global Konfiguration den Debug-Modus einzuschalten. So sieht man, wo es mit der neuen Seite noch Probleme gibt. Erscheint bei euch anstelle der Front- und Backendansicht nur eine weisse Seite, dann ist das Upgrade fehlgeschlagen. Kontrolliert ob in eurer Installation das jupgrade - Verzeichnis vorhanden ist oder nicht. Wenn nicht, hat es mit den vorher erwähnten Schreibrechten zu tun. Version 1.2 (11.02.2012) 19 / 21 2012 blueforce.ch
3.3 Deutschen Sprachdateien installieren Die jupgrade - Komponente installiert nur eine englische Basisvariante von Jooimla! 2.5 D.h. man muss die deutsche Sprache manuell downloaden und installieren. Das sollte aber für einen Joomla! 1.5 Anwender kein Problem sein. Gehe dazu auf: www.jgerman.de und navigiere zu den Joomla! 2.5 Sprachpaketen (Frontend und Backend) zum Download angeboten. Version 1.2 (11.02.2012) 20 / 21 2012 blueforce.ch
Wichtig: Ich weiss, dass es x-tausend mögliche Joomla! Konfigurationen und nochmal x-tausend unterschiedliche Webservereinstellungen gibt. Darum bitte bei Problemen und Fragen die während dem Upgrade auftreten können, und glaubt mir, sie werden auftreten, nicht per Mail an mich stellen. Bitte verwendet die dafür vorgesehenen Support-Foren. Hinweis: Änderungen und Korrekturen vorbehalten. Die neuste Version gibt es jeweils auf www.blueforce.ch unter Services > Dateien zum Download. Version 1.2 (11.02.2012) 21 / 21 2012 blueforce.ch