Die folgenden Anweisungen zeigen einen Weg zur Migration einer bestehenden Mambo 4.5.2 Installation nach Joomla! 1.0

Wiki Anleitung

Wenn Sie von einer älteren Mambo Version umsteigen möchten, ist unter Umständen zunächst ein Upgrade Ihrer Mamboinstallation, mindestens auf die Version 4.5.2, erforderlich. Anschließend können Sie auf Joomla! 1.0 umsteigen.

Jede Systemumstellung steht und fällt mit der richtigen Planung.

Bevor Sie beginnen, sollten Sie daher unbedingt diese Schritte befolgen:

• Besprechen Sie die Umstellungen oder Änderungen mit den verschiedenen Interessengruppen (Kunden, Arbeitsgruppe, Verantwortliche, etc.)
• Erstellen Sie eine Kopie, als Basis für Ihre Änderungen oder Umstellungen.
• Testen Sie die auf Basis dieser Kopie geänderte oder umgestellte Installation auf einem Server, möglichst ausserhalb Ihres Produktionsbereiches.
• Beziehen Sie die obigen Interessengruppen in den Test mit ein.
• Fertigen Sie ein Backup des gesamten Systems (Dateien, Datenbank, Datenbanktabellen, etc.) an.
• Bestimmen Sie einen Zeitpunkt für die Änderung oder Umstellung, bei dem die normalen Abläufe in Ihrem Geschäft möglichst wenig gestört werden.
• Informieren Sie dann die obigen Interessengruppen über den festgelegten Zeitpunkt und mögliche Ausfallzeiten.
• Bereiten Sie sich darauf vor, dass sie gegebenenfalls die letzte stabile Konfiguration zurückspielen können.

• Kopieren Sie die Joomla! Dateien (z.B. per FTP) in ein neues Verzeichnis unterhalb Ihres Root Verzeichnisses.
• Löschen Sie das Verzeichnis Joomla/installation.
• Kopieren Sie Ihre Mambo configuration.php auf den Server, in Ihre Joomla! Installation. Ändern Sie die Variablen $mosConfig_absolute_path und $mosConfig_live_site entsprechend Ihrer neuen Konfiguration.
• Kopieren Sie alle EIGENEN Templates, Komponenten, Module, Mambots und Sprachdateien in das selbe relative Verzeichnis unter Ihrem neuen Joomla Verzeichnis. In der folgenden Liste finde Sie eine Reihe von Einträgen, die NICHT KOPIERT werden sollten, da Sie Teil des Joomla-Cores sind.
  
  Templates:
  
  * mambo_admin (Administrator only)
  * mambo_admin_blue (administrator only)
  * rhuk_solarflare_ii
  
  Components:
  
  * com_admin (administrator only)
  * com_banners
  * com_categories (administrator only)
  * com_checkin (administrator only)
  * com_config (administrator only)
  * com_contact
  * com_content
  * com_frontpage
  * com_installer (administrator only)
  * com_languages (administrator only)
  * com_login
  * com_mambots (administrator only)
  * com_massmail (administrator only)
  * com_media (administrator only)
  * com_menumanager (administrator only)
  * com_menus (administrator only)
  * com_messages
  * com_modules (administrator only)
  * com_newsfeeds
  * com_poll
  * com_registration
  * com_rss
  * com_search
  * com_sections (administrator only)
  * com_statistics (administrator only)
  * com_syndicate (administrator only)
  * com_templates (administrator only)
  * com_trash (administrator only)
  * com_typedcontent (administrator only)
  * com_user
  * com_users (administrator only)
  * com_weblinks
  * com_wrapper
  
  Modules:
  
  * mod_archive
  * mod_banners
  * mod_components (administrator only)
  * mod_fullmenu (administrator only)
  * mod_latest (administrator only)
  * mod_latestnews
  * mod_logged (administrator only)
  * mod_login
  * mod_mainmenu
  * mod_mosmsg (administrator only)
  * mod_mostread
  * mod_newsflash
  * mod_online
  * mod_pathway
  * mod_poll
  * mod_popular (administrator only)
  * mod_quickicon (administrator only)
  * mod_random_image
  * mod_related_items
  * mod_rssfeed
  * mod_search
  * mod_sections
  * mod_stats
  * mod_templatechooser
  * mod_toolbar (administrator only)
  * mod_unread (administrator only)
  * mod_whosonline
  * mod_wrapper
  
  Mambots:
  
  * content/geshi
  * content/legacybots
  * content/moscode
  * content/mosemailcloak
  * content/mosimage
  * content/mosloadposition
  * content/mospaging
  * content/mossef
  * content/mosvote
  * editors/none
  * editors/tinymce
  * editors-xtd/mosimage.btn
  * editors-xtd/mospage.btn
  * search/categories.searchbot
  * search/contacts.searchbot
  * search/content.searchbot
  * search/newsfeeds.searchbot
  * search/sections.searchbot
  * search/weblinks.searchbot
  
  Language:
  
  * english
  
• Führen Sie die unten dargestellten Änderungen für alle Ihre Administratoren Templates aus.
• Rufen Sie dann die neue Site in Ihrem Browser auf.

Wenn alles wie gewünscht funktioniert, archivieren Sie Ihre bisherige Site und verschieben das Joomla! Verzeichnis an die Position Ihrer ursprünglichen Site. Oder nutzen Sie z.B. Web Server Alias, Einstellen des neuen Verzeichnisses in Ihrer Web Server Konfiguration, etc.; es gibt hier viele, je nach Hoster unterschiedliche, Möglichkeiten.

Datenbank Updates

Obwohl keine "kritischen" Datenbank Updates zwingend erforderlich sind, haben wir ein Skript (/installation/sql/migrate_Mambo4523_to_Joomla_100.sql) beigefügt, welches ein auf MamboForge verweisendes Modul deaktiviert und ein anderes Standard Administrator Template einstellt.

Bitte beachten Sie, das Sie entweder das obige Skript oder den folgenden Template Patch ausführen müssen, damit der Administrationsbereich korrekt funktioniert.

Mambo und Joomla! emulieren in der Standardeinstellung die PHP Einstellung "register_globals = on". Nach modernen Web Application Design - Standards gilt diese Einstellung üblicherweise als unerwünscht. Die empfohlene Einstellung lautet "register_globals = off". Auch wenn es kein Allheilmittel ist, so schützt es doch in einigen Situation vor Angriffen, die sonst aufgrund von Programmierfehlern oder schlechter Progammierung möglich wären.

Um diese Einstellung (register_globals = off) in Joomla! zu emulieren, benennen Sie bitte globals.php um in globals.php-on und anschließend globals.php-off in globals.php.

Wir können nicht garantieren, dass damit alle Ihre gewohnten Addons weiterhin funktionieren. Die Autoren der Addons gehen eventuell davon aus, dass PHP mit der Einstellung "register_globals = on" ausgeführt wird.

Joomla! mit PHP 5 und MySQL 4.1

MySQL 4.1 benötigt die "mysqli libraries" für den Zugriff auf die Datenbank. Damit Joomla! in einer solchen Umgebung installiert und ausgeführt werden kann, sind Änderungen erforderlich. Bitte benennen Sie die Datei database.php um in database.mysql.php sowie anschließend database.mysqli.php in database.php.

Mögliche Fragen

Kann ich die Joomla! Dateien einfach in mein Mambo Verzeichnis über meine bestehenden Mambo Dateien kopieren?

Ja, aber wir empfehlen Ihnen dieses zuerst, anhand einer Kopie Ihrer bisherigen Installation, auszuprobieren und in jedem Fall vorher ein Backup anzufertigen. Achten Sie in diesem Fall bitte besonders darauf, dass

• alle Dateien aktualisiert wurden
• keine Übertragungsfehler aufgetreten sind
• alle Dateien anschließend noch die selben Dateirechte (CHMOD) besitzen.

Nach der Installation zeigt die Seitenvorschau eine leere Seite?!

Prüfen Sie, dass Sie das Installationsverzeichnis gelöscht haben. Falls nicht, bekommen Sie wahrscheinlich einen entsprechenden Hinweis, wenn Sie sich im Administrationsbereich abmelden.

Administrator Template Patch
(ACHTUNG: findet ab Joomla! 1.0.1 keine Verwendung mehr)

Hinweis: die folgenden Anweisungen sind für Joomla! Versionen ab 1.0.1 nicht mehr erforderlich, da ab der Version 1.0.1 geänderte `mambo_admin` und `mambo_admin_blue` Templates hinzugefügt wurden - Sie können die folgenden Anweisungen bei einem Upgrade auf Joomla!-Versionen ab 1.0.1 ignorieren.

Da "Output Buffering" im Administrationsbereich eingeführt wurde, sind geringfügige Änderungen an den Administrator Templates erforderlich, damit sie in Joomla! korrekt funktionieren.

Laden Sie die index.php Ihrer Administrator Templates in einen Editor, suchen Sie nach den folgenden Code-Zeilen

Anschließend speichern Sie die Datei.

Wenn Sie die Änderungen lokal durchgeführt haben, laden Sie die index.php wieder in das entsprechende Administrator Template Verzeichnis auf den Server.