Anleitung zur Aktualisierung

Transkript

1 CONTREXX AKTUALISIERUNG 2010 COMVATION AG. Alle Rechte vorbehalten. Diese Dokumentation ist urheberrechtlich geschützt. Alle Rechte, auch die der Modifikation, der Übersetzung, des Nachdrucks und der Vervielfältigung, im Ganzen oder in Teilen, bedürfen der vorherigen schriftlichen Genehmigung der COMVATION AG. Dies gilt unabhängig davon, auf welche Art und Weise, für welche Zwecke und mit welchen Mitteln dies geschieht. Die COMVATION AG übernimmt weder Garantie für die Fehlerfreiheit und Aktualität dieses Handbuches, noch juristische Verantwortung oder irgendeine Haftung, die aus der Nutzung dieses Handbuches resultiert. Dies gilt auch für Auslassungen, fehlerhafte Angaben und daraus eventuell entstehende Schäden. 1/14

2 Inhaltsverzeichnis 1 Vorbereitung Welche Contrexx-Version ist aktuell installiert? PHP-Version überprüfen Update-Paket herunterladen Datensicherung Dateien sichern Quellcode Anpassungen (Optional) Datenbank sichern Aktualisierung Webseite deaktivieren Dateien kopieren Verzeichnisberechtigungen überprüfen Installation starten Nachträgliche Anpassungen Quellcode Anpassungen wieder einfügen Website aktivieren Webseite überprüfen Fehlerbehebung Community Support Alte Version wiederherstellen Dateien wiederherstellen Datenbank wiederherstellen /14

3 1 Vorbereitung Folgendes benötigen Sie, um eine Aktualisierung durchzuführen: Alle Zugangsdaten für Ihre Contrexx-Installation. Diese finden Sie auf dem Datenblatt, das Ihnen nach der Bestellung zugesandt wurde Ein FTP-Programm. Im Beispiel wird FileZilla verwendet - Dieses kann unter kostenlos heruntergeladen werden Zudem muss folgendes Überprüft werden, bevor Sie mit der Aktualisierung beginnen: Welche Contrexx-Version ist aktuell installiert? Diese Information benötigen Sie, um das richtige Update-Paket herunterzuladen. Welche PHP-Version läuft auf meinem Server? Damit eine Aktualisierung installiert werden kann, benötigen Sie PHP Version 5 oder neuer. 1.1 Welche Contrexx-Version ist aktuell installiert? Loggen Sie sich ins Contrexx ein. Auf der Übersichtsseite finden Sie die Versionsangaben(Abbildung 1) (Im Beispiel Contrexx Premium 2.1 Service Pack 1). Notieren Sie diese. Abbildung 1: Contrexx-Home 3/14

4 1.2 PHP-Version überprüfen Damit eine Aktualisierung durchgeführt werden kann, muss auf Ihrem Server PHP Version 5 oder neuer installiert sein. Dies können Sie im Contrexx unter System Informationen -> Server Infos überprüfen. Falls eine ältere PHP-Version installiert ist, kontaktieren Sie den technischen Support ihres Hostings und verlangen eine Aktualisierung der PHP-Version. 1.3 Update-Paket herunterladen Gehen Sie auf und loggen Sie sich ein oder erstellen Sie einen neuen Account. Unter Downloads -> Software -> Update Pakete finden Sie eine Übersicht aller Contrexx-Versionen Abbildung 2: Übersicht der Update-Pakete Wählen Sie die Versionsnummer, die Sie aktuell installiert haben. 4/14

5 Nun sehen Sie alle verfügbaren Update-Pakete dieser Version. Wählen Sie das neuste und laden dieses herunter. Entpacken Sie das heruntergeladene ZIP-Archiv in ein Verzeichnis Ihrer Wahl. Abbildung 3: Update-Paket herunterladen 5/14

6 2 Datensicherung Um einen Datenverlust zu verhindern, ist es sehr ratsam, ein Backup der aktuellen Installation anzulegen. Achtung: Falls am Quellcode Ihrer Contrexx-Installation Anpassungen durchgeführt worden sind, ist es zwingend, dieses Kapitel durchzuarbeiten. 2.1 Dateien sichern Loggen Sie sich per FTP-Programm auf Ihren Server ein. Nun sehen Sie eine Übersicht aller Verzeichnisse, die auf Ihrem Server liegen. Einige FTP-Programme blenden versteckte Dateitypen aus. Stellen Sie sicher, dass diese angezeigt werden. (In FileZilla unter Server-> Auflistung versteckter Dateien erzwingen ) Speichern Sie eine Sicherheitskopie des Stammverzeichnisses (im Beispiel httpdocs/) auf Ihrem Computer (Abbildung 4). Abbildung 4: Kopie von Stammverzeichnis herunterladen 6/14

7 2.2 Quellcode Anpassungen (Optional) Falls am Quellcode Ihrer Contrexx-Installation Anpassungen durchgeführt worden sind, befindet sich im Stammverzeichnis ein Ordner Customizing. Falls Sie kein Verzeichnis mit diesem Namen haben, überspringen Sie diesen Abschnitt. Im Customizing-Verzeichnis befinden sich Sicherheitskopien von den Dateien, an denen Anpassungen gemacht worden sind. Damit diese Anpassungen nicht verloren gehen, muss zwingend ein Backup davon erstellt werden. Da bei der Aktualisierung viele Kerndateien überschrieben werden, müssen diese nach der Installation wieder mit den Sicherheitskopien aus dem Customizing-Verzeichnis überschrieben werden. 2.3 Datenbank sichern Loggen Sie auf Ihrem Server ins DB-Verwaltungsprogramm ein (Im Beispiel wird phpmyadmin verwendet. Dies kann unter kostenlos heruntergeladen werden). Abbildung 5: phpmyadmin 7/14

8 Hier klicken Sie auf den Reiter Exportieren. Wählen Sie die Contrexx-Datenbank (deren Namen finden Sie auf dem Datenblatt). Die restlichen Einstellungen belassen Sie, wie sie sind und klicken auf OK. Damit laden Sie eine Sicherungskopie der Datenbank auf Ihren Computer. Abbildung 6: Datenbank exportieren 8/14

9 3 Aktualisierung 3.1 Webseite deaktivieren Damit die Besucher ihrer Website während der Installation nicht mit Warnungen konfrontiert werden, deaktivieren Sie Ihre Webseite. Dazu gehen Sie im Contrexx auf Administration -> Grundeinstellungen und setzen den Seitenstatus auf deaktiviert. Abbildung 7: Webseite deaktivieren 9/14

10 3.2 Dateien kopieren Kopieren Sie das entpackte Update-Paket auf Ihren Contrexx-Server. Verbinden Sie sich also wieder per FTP-Programm mit Ihrem Server. Überschreiben Sie die Dateien im Stammverzeichnis des Servers mit den Dateien aus dem Verzeichnis CMS_FILES in Ihrem Update-Paket. Abbildung 8: Dateien hochladen 3.3 Verzeichnisberechtigungen überprüfen Damit keine Berechtigungsprobleme entstehen, müssen Sie sicherstellen, dass folgende Verzeichnisse und deren Unterverzeichnisse auf dem Server allen Benutzern volle Zugriffsrechte gewähren: cache config feed images media themes tmp Im FileZilla geht das wie folgt: Rechtsklick auf ein Verzeichnis -> Dateiberechtigungen.. (Abbildung 9) 10/14

11 Abbildung 9: Berechtigungen ändern Stellen Sie sicher, dass die Einstellungen analog zu Abbildung 9 gesetzt sind. 3.4 Installation starten Sobald alle Dateien auf dem Server sind und die Berechtigungen richtig gesetzt wurden, rufen Sie im Browser und folgen Sie den Anweisungen. Abbildung 10: Installation Falls bei der Installation ein Fehler passierte, beachten Sie 5: Fehlerbehebung. Nach erfolgreicher Aktualisierung können Sie das Verzeichnis "/update", welches sich auf Ihrem Webserver im Contrexx- Verzeichnis befindet, löschen. 11/14

12 4 Nachträgliche Anpassungen 4.1 Quellcode Anpassungen wieder einfügen Wenn am Quellcode ihrer Website Anpassungen durchgeführt wurden (2.2: Quellcode Anpassungen (Optional)), müssen nun die entsprechenden Dateien mit den Sicherheitskopien aus dem Customizing- Verzeichnis ersetzt werden. Möglicherweise finden Sie im Customizing-Verzeichnis eine Textdatei mit genauen Angaben, wo die zu ersetzenden Dateien liegen. Falls nicht, suchen Sie am besten mit der Suchfunktion Ihres FTP-Programms danach (Im FileZilla mittels F3-Taste). 4.2 Website aktivieren Analog zu 3.1: Webseite deaktivieren 4.3 Webseite überprüfen Nach der Aktualisierung sollte die gesamte Website getestet werden. Möglicherweise wurden einige Module so stark verändert, dass die erstellten Inhaltsseiten nicht mehr funktionieren. Sollten sich einige Module nicht korrekt verhalten, geht man wie folgt vor: Installieren Sie das Modul neu: Dazu gehen Sie im Contrexx auf Administration -> Modul Manager. Dort setzten Sie beim betroffenen Modul ein Häkchen und klicken auf Änderungen übernehmen. Nun ist das Modul entfernt. Dasselbe machen Sie nochmals, um das Modul wieder zu installieren. Abbildung 11: Modul neu installieren Dies erstellt auch die zugeordneten Inhaltsseiten neu. Diese müssen danach wieder an ihre ursprünglichen Plätze verschoben werden; Möglicherweise sind auch noch Anpassungen am Design notwendig, da neue Stile verwendet werden. Das wars! Viel Vergnügen mit Ihrer neuen Contrexx-Version! 12/14

13 5 Fehlerbehebung 5.1 Community Support Bei Fragen und Problemen wird Ihnen gerne im Contrexx OpenSource-Forum geholfen: Viele Fragen werden auch in der Contrexx-Wissensdatenbank und im Contrexx-Wiki beantwortet: Alte Version wiederherstellen Falls die Aktualisierung nicht erfolgreich war, können Sie mit dem erstellten Backup die alte Version der Website wiederherstellen: Dateien wiederherstellen Loggen Sie sich per FTP-Programm auf Ihren Server ein. Löschen Sie alle Dateien aus dem Contrexx- Verzeichnis. Laden Sie Ihre Sicherungskopie in das Verzeichnis Datenbank wiederherstellen Loggen Sie auf Ihrem Server ins DB-Verwaltungsprogramm phpmyadmin ein. Standardmässig unter folgender URL: Wählen Sie den Reiter Datenbanken (Abbildung 12). Hier wählen Sie die Contrexx-DB und klicken das kleine Symbol unten rechts der Tabelle, um die Datenbank zu löschen. Abbildung 12: Datenbank löschen 13/14

14 Nun importieren Sie die erstellte Sicherheitskopie der Datenbank: Wählen Sie den Reiter Importieren(Abbildung 13), klicken Sie Datei auswählen und wählen Sie die vor der Aktualisierung erstellte Sicherungsdatei der DB. Nun klicken Sie OK, um die Datenbank zu importieren. Abbildung 13: Datenbank importieren Ihr Contrexx ist jetzt wieder auf demselben Stand, wie vor der Aktualisierung. 14/14