Installation der 2.1.4

Version vom 21:30, 14. Feb 2006

Anlegen der FTP-Verbindung im Total Commander

In diesem Artikel findet man eine detaillierte Anleitung, wie man Papoo installiert. Um das CMS Papoo überhaupt einsetzen zu können, müssen ein paar Voraussetzungen erfüllt sein.

Voraussetzungen

Geöffnete FTP-Verbindung

• ein eigener Server (zum Beispiel XAMPP für Linux) oder Webspace ist vorhanden
  • siehe auch Webhosting und Providersuche bei webhostlist.de
• PHP ist installiert
• MySQL ist installiert

Für diese Dokumentation wurde ein eigener Root-Server mit

• ProFTPD (Kennung: 164kunde_papoo)
• PHP Version 4.3.2
• MySQL 3.23.48 (Datenbankname: 164kunde_papoo_datenbank_cms, Kennung: 164kunde_papoo)
• Apache 1.3.27

verwendet. Da mittlerweile die Versionen Apache2, PHP5 und MySQL4 stabil laufen, handelt es sich hierbei um veraltete Komponenten. Alle genannten Kennungen und Passwörter sind als Beispiele zu verstehen. Die Logindaten müssen der Person bekannt sein, die Papoo installieren soll.

Benötigte Software

Markierte Dateien in der ZIP-Datei

• Papoo als ZIP-Datei oder entpackt (auf dem PC)
• FTP: Total Commander, FileZilla, WS-FTP, oder anderes FTP-Programm
• einen Browser wie den Internet Explorer oder den Firefox

Die Screenshots in dieser Dokumentation sind vom Total Commander (Shareware).

FTP-Upload

Anlegen der FTP-Verbindung im Total Commander oder einem anderen FTP-Programm.

• Servername: IP-Adresse oder Name der Domain
• FTP-Benutzername
• FTP-Passwort

Nachdem man erfolgreich die Verbindung zum FTP-Server geöffnet hat, sollte man im Startverzeichnis (englisch: home directory) seines Webservers landen. In unserem Beispiel ist das

/home/httpd/de/dein/pfad/media/

und hier wird zu Testzwecken noch das Unterverzeichnis "papoo_cms" erstellt.

Übertragung aller Papoo Dateien

Der Total Commander kann eine ZIP-Datei temporär öffnen. Wahlweise kann die heruntergeladene Datei auch entpackt werden.

Der Screenshot zeigt das alle Dateien aus der ZIP-Datei markiert sind - bis auf die .htaccess Dateien - und danach auf den Server kopiert werden. Die .htaccess wird für die Installation und einen ersten Test von Papoo nicht benötigt. Sie kann sich aber für den laufenden Betrieb als praktisch erweisen.

Danach kann man über

http://deine.domain.de/papoo_cms/setup/

die Installation starten.

Das Setup von Papoo

Die Startseite des Setup von Papoo

Bevor man jetzt mit der Installation fortfahren kann, sollte man die Schreibrechte für die Verzeichnisse überprüfen, um bekannte Installationsfehler zu vermeiden.

Verzeichnis- und Dateirechte setzen

Schritt 1: Eingabe der Daten von MySQL

Es gibt verschiedene Verzeichnisse, die Schreibrechte benötigen. Das liegt unter anderem an Smarty. Diese Template Engine benötigt für ihre Verzeichnisse "templates_c" zwingend Schreibrechte. Die folgenden Dateien und Verzeichnisse

• Datei ../lib/site_conf.php
• Verzeichnis ../css/
• Verzeichnis ../templates_c/
• Verzeichnis ../images/
• Verzeichnis ../plugins/
• Verzeichnis ../images/thumbs/
• Verzeichnis ../dokumente/
• Verzeichnis ../dokumente/upload/
• Verzeichnis ../dokumente/logs/
• Verzeichnis ../interna/templates_c/

müssen alle beschreibbar sein.

Tip: Im Administrationsmenü von Papoo lassen sich die CSS-Dateien (Aussehen der Webseite) bearbeiten. Dies geht jedoch nur, wenn zuvor die die Dateirechte aller CSS-Dateien auf 646 geändert wurden. Es bietet sich also an dies gleich beim Setup zu tun, wenn man obige Verzeichnisrechte ändert.

Die CSS-Dateien befinden sich in den Unterordnern des Ordners "../css/".

Installation im Browser durchführen

Schritt 1: absoluter Pfad und Verzeichnis ab dem DocumentRoot

• Wählen Sie eine Sprache aus. Es stehen Deutsch und Englisch zur Verfügung. Bestätigen Sie danach mit Enter.
• Als nächstes werden Sie zur Erläuterungseite der Installation weitergeleitet. Diese erklärt, welche technischen Voraussetzungen und Daten zur Installation notwendig sind.

Schritt 1

Schritt 2: Die Daten von MySQL wurden übernommen

• Auf dieser Seite wird geprüft, ob die erforderlichen Rechte (siehe oben) gesetzt wurden. Ist die Prüfung nicht erfolgreich, erscheint eine Fehlermeldung.
• Zu diesem Zeitpunkt werden Sie nach Ihren Zugangsdaten (MySQL, Pfade, etc.) gefragt. Im Screenshot sehen Sie ein Beispiel für übliche Testkonfigurationen. In der kurzen Anleitung stehen die Voraussetzungen und Beispiele genauer erklärt.
• Der absoluten Pfad sollte vorbelegt sein. Wenn im Feld "Absoluter Pfad" nicht das richtige oder kein Verzeichnis steht, müssen Sie den absoluten Pfad bei Ihrem Provider in Erfahrung bringen.
• Wenn Sie Papoo in ein Unterverzeichnis Ihres Webservers installieren, müssen Sie den Namen des Verzeichnisses an die Daten in diesem Feld anhängen.

Schritt 2

mysql_connect getestet, Hinweise für Schritt 4

Wenn keine Fehler angezeigt werden, war die Installation erfolgreich

Die Daten für Ihre Verbindung zum RDBMS und zur Datenbank sind gespeichert worden. Diese Daten werden in die "../lib/site_conf.php" eingetragen. In Schritt 3 wird die Verbindung zum RDBMS und zur Datenbank geprüft. Mit Klick auf "Verbindung zur Datenbank prüfen" gehen Sie zu Schritt 3 über.

Schritt 3

Wenn Sie nun die Webseite von Schritt 3 (ohne Fehlermeldungen) sehen, hat alles geklappt und die Verbindung konnte hergestellt werden. Nun können alle wichtigen Daten in die Datenbank kopiert werden. Dieser Schritt kann von ca. 15 bis 90 Sekunden dauern. Obwohl einige tausend Datensätze angelegt werden, sollte es nur bei sehr langsamen Servern länger als ein paar Minuten dauern.

Achtung! Wenn es sich nicht um eine Neuinstallation handelt, dann besteht die Gefahr, dass alle Daten in den bestehenden Tabellen gelöscht werden. Sollten also schon Tabellen mit dem entsprechenden Präfix existieren, werden Sie gefragt, ob Sie diese überschreiben wollen. In diesem Fall sind nach der Installation die "alten" Daten nicht mehr vorhanden. Haben Sie ein anderes Präfix angegeben, werden die bestehenden Tabellen nicht überschrieben. So kann man in einer Datenbank mehrere "Instanzen" von Papoo installieren.

Schritt 4

In diesem Schritt legt Papoo die Tabellen in Ihrer Datenbank an.

Dieser Schritt kann je nach Leistung ihres Servers einige Sekunden bis hin zu 1-2 Minuten dauern, da einige 10.000 Datensätze eingetragen werden müssen. Bitte drücken Sie während dieser Zeit keinen Link oder die Reloadtaste Ihres Bowsers.

Wenn schon eine Papoo Installation mit diesem Prefix vorhanden ist, werden Sie gefragt, ob Sie die vorhandenen Tabellen überschreiben möchten, oder ob Sie einen anderen Prefix angeben möchten.

• Möchten Sie die vorhandene Installation behalten klicken Sie bitte auf "Datenbank Praefix ändern"
• möchten Sie die vorhandene Installation ersetzen klicken Sie bitte auf "Datenbank Tabellen eintragen und die alten Daten löschen"

Schritt 5

In Schritt Fünf legen Sie das Passwort des Benutzers "root" fest. Der Benutzer "root" ist der Benutzer der volle Administrationsrechte auf Ihre Papoo Installation hat.

Abschluss

Nachdem Sie das Passwort festgelegt haben, müssen Sie mit Ihrem FTP-Programm den Ordner "Setup" im Papoo Ordner löschen. Weiterhin müssen die Rechte der Datei "/lib/site_conf.php" auf 444 (bedeutet "Nur Lesezugriff") ändern.

Nun können Sie Ihre Seite das erste Mal aufrufen beziehungsweise Administrieren:

• Ihre Startseite finden Sie unter der folgenden Adresse: http://localhost (Beispiel: http://www.papoo.de)

• Die Administration erfolgt dagegen unter dieser Adresse: http://localhost/interna/ (Beispiel: http://www.papoo.de/interna/)