UpgradePostNuke

Guite edited this page Nov 15, 2014 · 2 revisions

== Aktualisierung von PostNuke v0.764 ==

Bitte die folgenden Schritte in der aufgeführten Reihenfolge abarbeiten und die jeweilige Beschreibung vorab gründlich durchlesen. Werden die Anweisungen befolgt, sollten keine Probleme auftreten.

'''Tipp:''' Speziell für die Migration von PostNuke auf Zikula wurde eine spezielle Migrationsdistribution ''(auch Upgradepaket genannt)'' erstellt. Somit kann eine PostNuke-Installation (inkl. der damaligen Standardmodule) mit wenig Aufwand direkt auf Zikula 1.1 migriert werden.

'''Inhalt der Migrationsdistribution v1.1.2''' *Zikula Core 1.1.2 und Systemmodule *AuthLDAP (v0.4.0.1), Ephemerids (v1.6), FAQ (v2.2), Feeds (v2.1), News (v2.4.1), Pages (v2.3), PendingContent (v1.0), Quotes (v2.2), Ratings (v2.0), Recommend_Us (v1.1), Reviews (v2.3), Sniffer (v1.1), Thumbnail (v1.1) *InterCom (2.2), Banners (2.1), HitCount (1.0), Referers (2.1), Stats (2.3), Top_List (2.0), EZComments (1.61), Downloads (2.4), MultiHook (5.0), Polls (2.0.2), bbcode (2.0), bbsmile (2.1), Web_Links (2.0), scribite (3.1)

== Technische Voraussetzungen ==

Für einen reibungslosen Verlauf des Upgrades ist MySQL5 und PHP5 notwendig !!!

=== Datenbank und Dateisystem sichern ===

Vor dem Upgrade ist es sehr wichtig, ein Backup der v0.7x Datenbank, sowie des Dateisystems anzulegen. Einmal vorgenommene Aktualisierungen können nicht rückgängig gemacht werden, wenn keine Datensicherung vorliegt. Eine Sicherung der Datenbank kann beispielsweise über die Tools MySQLDumper, phpMyAdmin oder alternativ über SSH durchgeführt werden. Tiefergehende Anleitungen zum Sichern der Datenbanken gibt es zuhauf im Internet und in den Dokumentationen der oben genannten Tools.

=== v0.7x Installation vorbereiten ===

Als Administrator in der PostNuke-Seite anmelden und unbedingt sicherstellen, dass die folgenden Module installiert und aktiviert sind:

##Admin 2. Admin_Messages 3. Blocks 4. Groups 5. Header_Footer 6. legal 7. Mailer 8. Modules 9. Permissions 10. pnRender 11. Search 12. Settings 13. User 14. Xanthia 15. Your_Account

Weitere Module sind optional, da der Core von Zikula 1.0 auf die notwendigsten Module eingeschränkt wurde. Die sonstigen Module aus einer alten PostNuke-Installation können später getrennt von der Upgraderoutine aktualisiert werden. Dafür steht unter anderem das Paket mit den ValueAddons (Download unter code.zikula.org/core) zur Verfügung. Sobald dieser Schritt abgeschlossen wurde, kann die Datenbank aktualisiert werden.

Löschen Sie schlussendlich alle Dateien der PostNuke v.07x-Installation, da die Dateistruktur in Zikula enorm verändert wurde. Vorsichtshalber können die Dateien temporär in ein Backup-Verzeichnis ausserhalb der Installation verschoben werden, aus welchen vereinzelt Dateien (Bilder, Downloads, Module, Themes oder Plugins) nach dem erfolgtem Upgrade zurückgesichert werden können. Nachdem sämtliche .7x-Dateien entfernt wurden, können die Dateien von Zikula 1.x hochgeladen werden. Bitte beachtem dass das pnTemp-Verzeichnis inkl. Unterverzeichnisse beschreibbar gemacht werden muss (chmod -R 777).

Einige Provider verbieten spezielle Parameter in der Datei .htaccess. Falls beim Aufruf der Seiten der Fehler "500 Internal Server Error" erscheinen sollte, so kann die Datei gefahrlos gelöscht werden. Die benötigten Konfigurationen könnte (abhängig vom Provider) auch über die php.ini definiert werden. Bitte dann den Provider auf die Möglichkeiten der Deaktivierung von register_globals und magic_quotes_gpc ansprechen. Alternativ einen Blick in das deutsche Doku-Wiki werfen.

=== config.php aktualisieren ===

Der Speicherort der config.php wurde in das Verzeichnis /config verschoben. In der mitgelieferten Originaldatei müssen in folgende Zeilen die Zugangsdaten für die Datenbank manuell eingepflegt werden:

$PNConfig['System']['prefix']
$PNConfig['DBInfo']['default']['dbuname']
$PNConfig['DBInfo']['default']['dbpass']
$PNConfig['DBInfo']['default']['dbname']

Weiterhin sollte die folgende Zeile angepasst werden:

$PNConfig['System']['installed'] = 1;

Wurden verschlüsselte Werte aus der config.php von PostNuke eingefügt, muss folgende Zeile abgeändert werden:

$PNConfig['DBInfo']['default']['encoded'] = 1;

Wenn nicht mit den Standardwerten gearbeitet wird, wird es in einigen Fällen auch notwendig sein, den Datenbanktyp, Table und Host zu bearbeiten. Das ist jedoch eher die Ausnahme und unter anderem auch Providerabhängig.

=== Upgrade durchführen ===

Um die Datenbank zu aktualisieren muss die Datei upgrade.php im Browser aufgerufen werden. Hier werden auch Benutzername und Kennwort der vorhandenen PostNuke-Installation benötigt. Danach müssen nur noch die Anweisungen in dem Skript befolgt werden.

'''Hinweis 1''': Zikula entfernt die Fußnachricht (Footer) aus der Admin-Oberfläche. Somit wird eine vorhandene Footer-Nachricht anschließend verschwinden. Es wird empfohlen mögliche Footer-Nachrichten im Theme fest zu integrieren. Der Inhalt der alten Nachricht wird in einer Datei im pnTemp-Verzeichnis abgelegt.

'''Hinweis 2''': Aus Performancegründen sind seit Zikula v1.0 keine Benutzerzugriffsrechte mehr möglich. Es wird empfohlen die Benutzer in einer Gruppe aufzunehmen und darüber die Zugriffsrechte zu verwalten.

'''Hinweis 2''': Bitte im Modul "Einstellungen" sicherstellen, dass beim "Startmodul" auch ein Modul ausgewählt ist, welches in der Distribution vorhanden ist (z.B. News, Umfragen, Suche). Ansonsten kann es nach der Migration zu einem Fehler kommen, da das ausgewählte Modul nicht vorhanden ist. Diese Einstellung kann natürlich nach der erfolgreichen Migration wieder auf ein beliebiges Modul zurückgeändert werden.

=== Aufräumarbeiten ===

Abschließend müssen die Dateien upgrade.php, install.php und das Install-Verzeichnis aus dem Dateisystem entfernt werden.

=== Themes aktualisieren ===

Mit Zikula wurde die Struktur der Themeverwaltung geändert. Das Modul heißt nun Themes (''nicht mehr Xanthia'') und intern lautet die Version 'Xanthia Version 3'. Falls vorher ein Xanthia 2 Theme genutzt wurde, kann dieses über das Modul automatisch konvertiert werden. Dazu muss das Theme-Verzeichnis beschreibbar gemacht werden (chmod -R 777). Bitte beachten, dass diese Konvertierung bei einem komplexen Ausgangstheme vielleicht nicht immer 100%ig funktioniert. Sowieso müssen weitere Änderungen am Theme manuell durchgeführt werden. Nach der Konvertierung sollte das Theme-Verzeichnis wieder auf 'nur-lesbar' gesetzt werden!

=== Änderungen bei den Modulen ===

Achtung, bevor in der Administration -> Modules ein Upgrade des User Moduls durchgeführt werden kann, muss zwingend das Profile Modul installiert und aktiviert werden. Ansonsten werden nur der Username und das Passwort übernommen. Alle weiteren Daten gehen ansonsten dabei verloren. Siehe hierzu auch [http://code.zikula.org/core/ticket/965 Ticket 965].
''Anmerkung: Dieses Fehlverhalten sollte mit der Migrationsdistribution v1.1.2 behoben sein.''

Achtung, im deu. Migrationspaket von Postnuke v0.764 nach Zikula v1.2.0 fehlt das Credits Modul. Im Ordner modules/Credits befinden sich nur die Sprachpakete. Es kann [http://code.zikula.org/credits/downloads hier] heruntergeladen werden.

==== Module aus dem v0.764 Core ====

{| border=1 class="wikitable" !'''Postnuke v0.764''' !'''Zikula v1.0.x''' !'''Zikula v1.1.x''' |- | AddStory | News (ValueAddOn Paket) | News |- | Admin | Admin (Core) | Admin (Core) |- | Admin_Messages | Admin_Messages (Core) | Admin_Messages (Core) |- | Autolinks | [//multihook MultiHook] | [//multihook MultiHook] |- | AvantGo | AvantGo (ValueAddOn Paket) | Entfernt |- | Banners | Banners(ValueAddOn Paket) | Banners |- | Blocks | Blocks (Core) | Blocks (Core) |- | Censor | [//multihook MultiHook] | [//multihook MultiHook] |- | Comments | [//ezcomments EZComments] | [//ezcomments EZComments] |- | Credits | Credits (ValueAddOn Paket) | Credits (ValueAddOn Paket) |- | Downloads | [//downloads Downloads] | [//downloads Downloads] |- | Ephemerids | Ephemerids (ValueAddOn Paket) | Ephemerids (ValueAddOn Paket) |- | Example | Entfernt | Entfernt |- | FAQ | FAQ (ValueAddOn Paket) | FAQ |- | Groups | Groups (Core) | Groups (Core) |- | Header_Footer | Header_Footer (Core) | Header_Footer (Core) |- | legal | legal (Core) | legal (Core) |- | LostPassword | Users (Core) | Users (Core) |- | Mailer | Mailer (Core) | Mailer (Core) |- | MailUsers | MailUsers (ValueAddOn Paket) | Users (Core) |- | Members_List | Members_List (ValueAddon Paket) | Profile ([http://support.zikula.de/module-CMS_Support_Forum-viewtopic-topic-29024.htm Bugreport] + [https://zikula.technixen.net/index.php/Downloads/display/lid/19 Skript zur Übernahme der Daten]) |- | Messages | [//intercom InterCom] | [//intercom InterCom] |- | Modules | Modules (Core) | Modules (Core) |- | Multisites | wird derzeit | nicht unterstützt |- | News | News (ValueAddOn Paket) | News |- | NewUser | Users (Core) | Users (Core) |- | Permissions | Permissions (Core) | Permissions (Core) |- | pn_bbclick | [included in the Core] | [included in the Core] |- | pn_bbcode | [//bbcode bbcode] | [//bbcode bbcode] |- | pn_bbsmile | [//bbsmile bbsmile] | [//bbsmile bbsmile] |- | pnRender | pnRender (Core) | pnRender (Core) |- | Polls | [//advancedpolls Polls] | [//advancedpolls Polls] |- | Quotes | Quotes (ValueAddOn Paket) | Quotes |- | Ratings | Ratings (ValueAddOn Paket) | Ratings |- | Recommend_Us | Recommend_Us (ValueAddOn Paket) | Recommend_Us |- | Referers | Referers (ValueAddOn Paket) | Referers |- | Reviews | Reviews (ValueAddOn Paket) | Reviews |- | RSS | Feeds (Core) | Feeds |- | Search | Search (Core) | Search (Core) |- | Sections | Pages (ValueAddOn Paket) | Pages |- | Settings | Settings (Core) | Settings (Core) |- | Sniffer | Sniffer (ValueAddOn Paket) | Sniffer (ValueAddOn Paket) |- | Stats | Stats (ValueAddOn Paket) | Stats |- | Submit_News | News (ValueAddOn Paket) | News |- | Top_List | Top_List (ValueAddOn Paket) | TopList |- | Topics | Categories (Core) | Topics |- | typetool | [//scribite scribite!] | [//scribite scribite!] |- | User | Users (Core) | Users (Core) |- | Web_Links | Web_Links | Web_Links |- | Wiki | Wiki_Code (ValueAddOn Paket) | Entfernt |- | Xanthia | Theme (Core) | Theme (Core) |- | Your_Account | Users (Core) | Users (Core) |}

==== Neu mit Zikula hinzugekommene Module ====

*AuthLDAP (ValueAddOn Paket) *AuthPN (Core) *Errors (Core) *HitCount (ValueAddOn Paket) *ObjectData (Core) *PageLock (Core) *PendingContent (ValueAddOn Paket) *pnForm (Core) *Profile (Core) *SecurityCenter (Core) *SysInfo (Core) *Thumbnail (ValueAddOn Paket) *Tour (Core) *Workflow (Core)

==== Ersetzte Module von Drittherstellern ====

{| border=1 class="wikitable" !'''Postnuke v0.764''' !'''Zikula v1.x''' ! |- | pnAddressbook | [//addressbook Addressbook] | Achtung, bietet leider keine Import Funktionalität. Muss manuell per phpMyAdmin durchgeführt werden. |- | pnBook | [//eternizer Eternizer] | Für den Datenimport aus pnBook nach Eternizer muss pnBook installiert und aktiviert sein! Anschließend kann pnBook vollständig entfernt werden. |- | photoshare | [//mediashare Mediashare] | Achtung: [http://code.zikula.org/core/changeset/25229/tags/Zikula-1.1.0/modules/Topics?old_path=%2F&format=zip Topics Modul] installieren für alle Mediashare Versionen < 4.x |}

==== Module von Drittherstellern für die Patches benötigt werden ====

{| border=1 class="wikitable" !PostWrap 2.5 ! mit zusätzlichem Patch zu finden hier http://www.spidean.com/index.php?name=Downloads&req=viewsdownload&sid=48 |- | Mediashare 3.2 | [http://code.zikula.org/core/changeset/25229/tags/Zikula-1.1.0/modules/Topics?old_path=%2F&format=zip Topics Modul] installieren |- | Pagesetter | [http://code.zikula.org/core/changeset/25229/tags/Zikula-1.1.0/modules/Topics?old_path=%2F&format=zip Topics Modul] installieren |}

==== Module von Drittherstellern, für welche es keinen offiziellen Ersatz gibt ====

{| border=1 class="wikitable" !dynamenu ! Funktionen können über Template-Magie oder über den ExtMenu-Block umgesetzt werden. Siehe Blanktheme-Projekt |- | onlineXP | teilweise in den Modulen Users, Profile oder beispielsweise ContactList enthalten. |- | pn_notify | wurde damals nur für pnBook benötigt. Der Nachfolger Eternizer erfordert diesen Hook nicht mehr |}

==== Upgrade-Probleme? ====

Falls Probleme mit dem Upgrade des News-Moduls auftreten sollte, dann kann das leider 'zig Ursachen haben. Doch eventuell hilft [http://support.zikula.de/module-CMS_Support_Forum-viewtopic-topic-29984-start-0.htm#pid139843 dieser Beitrag] im Forum weiter, wo das Upgrade-Skript bei der Migration (Topics=>Kategorien) stoppte. Ursache dafür waren leere Topic-Namen bzw. Namen, die nur aus Zahlen bestanden. Vorsichtshalber sollte man die Datenbanktabellen ''''xyz_stories_cat'''' und ''''xyz_topics'''' auf Merkwürdigkeiten überprüfen.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.