Die Komponente com_migrator ist der wohl bekannteste und verbreitetste Migrationassistent. Dieser Umstand ist vorallem der Tatsache geschuldet, dass er eine sehr benutzerfreundliche und ausgereifte Möglichkeit darstellt, um seine Website auf Joomla 1.5 umzustellen. Die aktuelle Version können Sie hier herunterladen.

Installation
Der com_migrator lässt sich wie jede andere Komponente direkt über das Control-Panel von Joomla installieren. Beachten Sie dabei bitte, dass der com_migrator in Ihre alte voll funktionsfähige Joomla 1.0.x Installation installiert werden muss. Bitte versuchen Sie nicht den com_migrator in Joomla 1.5 zu installieren. Nach einer erfolgreichen Installation [Abb. 1], steht Ihnen die Komponente unter Components => Migrator zur Verfügung [Abb. 2]

Abbildung 1:Erfolgreiche Installation	Abbildung 2: Das Controlpanel von com_migrator

Installation von 3rd party ETL Plugins
Wie bereits einleitend angesprochen, ist eine normale Migrationskomponente nur dazu in der Lage Content zu migrieren, der mit Joomla-Bordmitteln erstellt wurde. Um diesen Nachteil auszugleichen, bietet com_migrator die Möglichkeit Skripte von den Herstellern der 3rd Party Erweiterungen einzubinden und somit auch deren Inhalte zu übernehmen.

Das Vorgehen wird im Folgenden beispielhaft für den Dokumentenverwalter Docman beschrieben.

Unsere Docman-Installation enthält momentan nur 2 Dateien und eine Kategorie [Abb. 3], bei vielen anderen Docman-Installationen liegt diese Zahl jedoch schnell im 3 stelligen Bereich. Kein Wunder also, dass ohne passendes Migrations-Skript der Arbeitsaufwand einer Portierung von vielen Webmastern gescheut würde.

Zuallererst laden wir uns die Migrationsdateien von der Herstellerseite herunter und installieren sie wie in der readme beschrieben über das Installations-Menü von com_migrator [Abb. 4]

Abbildung 3: Inhalt der Docman-Installation	Abbildung 4: Installations-Menü für 3rd Party Plugins

Wählen Sie also die 5 Dateien gemäß der readme aus und installieren Sie diese nacheinander.
Nach erfolgreicher Installation kehren Sie zum Hauptmenü des com_migrator zurück und überprüfen Sie unter „List Plugins“, ob auch wirklich alle 5 Plugins installiert wurden. [Abb. 5]

Abbildung 5: Installierte 3rd Party Plugins

Den Migrationsprozess starten
Dem eigentlichen Migrationsprozess steht nun nichts mehr im Wege. Starten Sie diesen durch einen Klick auf „Create Migration SQL File".
Nun haben Sie noch einmal die Gelegenheit differenziert auszuwählen, welche Inhalte Sie migrieren möchten [Abb. 6]. In der Regel können Sie hier die Standardeinstellungen übernehmen.
Nachdem Sie Ihre Auswahl durch „Start Migration“ bestätigt haben, beginnt der eigentliche Migrationsprozess, der bei Erfolg mit einer aufmunternden Meldung quittiert wird.[Abb. 7]
Laden Sie nun noch die sql-Datei herunter und schon ist die erste Etappe gemeistert.

Abbildung 6: Auswahl der Migrations Plugins	Abbildung 7: Statusnachricht nach der Migration

Von 1.0 zu 1.5
Sie können nun die alte Joomla-Installation vollständig löschen (Backup nicht vergessen) und Joomla 1.5 installieren. Bei einer Migration ist ausschließlich Schritt 6 der Joomla 1.5 Installations-Routine von besonderem Interesse.
Unter „Beispieldaten laden, Inhalte aus Sicherung oder Migration wieder herstellen:“ wählen Sie bitte „Lade Migrationsskript“, tätigen Sie die korrekten Einstellungen [Abb. 8] und bestätigen Sie mit „Hochladen und ausführen“.
Wichtig ist hierbei, dass das korrekte Tabellenpräfix – normalerweise jos_ - eingegeben wird. Sie sollten auch beachten, dass Sie die richtige Zeichenkodierung der alten Website angeben. (Die richtige Zeichencodierung finden Sie heraus, indem Sie z.B. in Firefox einen Rechtsklick auf Ihre alte Seite tätigen und dann „Seiteninformationen anzeigen“ auswählen.)
Ob der Vorgang erfolgreich abgeschlossen werden konnte, wird Ihnen kurz darauf mitgeteilt. [Abb. 9]
Führen Sie nun die Installation zu Ende und überprüfen Sie den Erfolg Ihrer Migration.

Abbildung 8: Einbinden des Migrations-Skriptes	Abbildung 9: Statusnachricht nach der Migration

Hinweis:
Ihre E-Mail-Adresse und das Super Administrator-Passwort wird von der alten Seite übernommen, auch wenn Sie bei der Installation abweichende Daten eingeben.

3rd Party Erweiterungen:
Nun müssen wir uns jedoch auch noch darum kümmern, dass unsere 3rd Party Erweiterungen – in diesem Fall Docman – auch in der neuen Installation funktionieren.
Hierzu installieren Sie einfach Docman wie gewohnt über das Joomla-Menü Extensions => Install/Uninstall.
Nach einer erfolgreichen Installation, werden Sie feststellen, dass Ihre Kategorien und sonstigen Einstellungen zwar übernommen wurden, Ihre gesamten Dokumente aber verschwunden sind. Dies liegt - wie bereits angesprochen - daran, dass nur die Datenbank migriert wurde. Alle Dateien, wie Bilder und Dokumente, müssen Sie nun jedoch separat wieder in ihr ehemaliges Verzeichnis hochladen. Im Falle von Docman ist dies der Order /dmdocuments.
Sobald sich Ihre Dokumente wieder an ihrem angestammten Platz befinden, werden sie auch von Docman wieder aufgelistet.

Bilder und andere Dateien
Ich möchte noch einmal ausdrücklich daraufhin weisen, dass alle Bilder und sonstigen Dateien wieder an ihren alten Platz hochgeladen werden müssen. Da die Verlinkungen noch existieren reicht ein einfaches kopieren auf den Server aus!

Video Tutorial
Vielleicht hilft Ihnen auch das Video-Tutorial zur Migration mit dem com_migrator bei der Migration ihrer Joomla-Installation.