Geeklog installieren

Checkliste "Vor der Installation" (Neue Installation)

Bevor Geeklog das erste Mal installiert wird, stellen Sie sicher, dass Sie sich in den folgenden Punkten informiert haben und die benötigten Komponenten zur Verfügung stehen:

1. ein Webserver, auf dem PHP 4.04 oder höher läuft,
2. ein Webserver, auf dem MySQL läuft und der Zugriff auf eine Datenbank oder das Recht, eine Datenbank anzulegen,
3. das Recht, eine neue Datenbank in MySQL anzulegen oder Zugriff auf eine existierende Datenbank,
4. eine Telnet- oder SSH-Verbindung zu Ihrem Webserver (obwohl ein FTP-Zugriff auch ausreichen wird). Dieses Dokument geht davon aus, dass Sie einen Zugriff auf Kommanzeilenbasis auf Ihren Server haben, wird aber die wesentlichen Unterschiede für FTP-Benutzer erwähnen.
5. die Möglichkeit, ein "tarball" zu entpacken (eine Datei, die mit "tar.gz" endet).
6. Kenntnis der Unterschiede zwischen einem Pfad und einer URL.
7. Kenntnis der Pfade und Ordnerstruktur Ihres Systems.
   

   Besonderer Hinweis über Parserfehler: Einige Benutzer haben uns berichtet, dass WinZip Dateien des Geeklog-Tarballs beschädigen kann, so dass es während der Installation Fehlern auftreten. In dieser Hinsicht empfehlen wir Ihnen dringend, auf die Benutzung von WinZip zu verzichten und stattdessen WinRAR benutzen, um die Dateien auf Ihrem lokalen Rechner zu entpacken. Noch besser allerdings entpacken Sie die Dateien auf Ihrem Server (was einen Telnet/SSH-Zugang erfordert).

   Parserfehler können ebenfalls durch die Benutzung von WYSIWYG-Editoren – z.B. Dreamweaver – für die Änderung der Datei "lib-common.php" hervorgerufen werden. Benutzen Sie also vorzugsweise einen Editor für "flache Texte".

Die folgenden Anweisungen beziehen sich in erster Linie auf das Verzeichnis public_html.

Eine Geeklog-Installation besteht im Grunde genommen aus zwei Teilen: Ein Teil, der für "die ganze Welt" sichtbar ist und aus den Dateien des Verzeichnisses public_html besteht. "public_html" ist ein typischer Name für ein Verzeichnis eines Webservers, auf das Jedermann zugreifen kann. "htdocs" ist ein weiterer typischer Name; auf anderen Systemen gibt es das Verzeichnis home, Sites (Max OSX) oder web (Red Hat). Wenn auf Ihrem Server ein derartiges Verzeichnis existiert, kopieren Sie alle Dateien aus dem Geeklog-Verzeichnis public_html in dieses Verzeichnis. Sie müssen dann nur noch die Variable $_CONF['path_html'] (in der Datei config.php) auf dieses Verzeichnis verweisen lassen.

Der andere Teil von Geeklog besteht aus allen Dateien außerhalb des public_html-Verzeichnisses und sollte nicht über eine URL ansprechbar sein, denn er enthält sensible Informationen. Also sollten Sie alle diese Dateien und Verzeichnisse außerhalb ihres Webverzeichnisses speichern (mit anderen Worten: außerhalb des public_html oder htdocs oder web-Verzeichnis). Die Variable $_CONF['path'] (die ebenfalls in der Datei "config.php" zu finden ist) muss dann nur noch auf dieses Verzeichnis, in dem alle Ihre Dateien und Verzeichnisse liegen, verweisen.

Diese Unterteilung der Installation stellt sicher, dass Sie Ihre Geeklog-Seite direkt mit einem Domainnamen wie http://www.ihredomaine.de/ ansprechen können und den Verzeichnissnamen "public_html" nicht in der URL erwähnen müssen.

Installationsanleitung (Neue Installation)

Lesen Sie diesen Absatz bitte vollständig, bevor Sie mit der Installation beginnen.

1. Entpacken Sie das Tarball *innerhalb* Ihres Webbaums durch den Aufruf von
   tar -zxvf geeklog-1.3.11d.tar.gz
   in Ihrer Shell auf Ihrem Server (was – wie bereits erwähnt – einen SSH-Zugriff erfordert).
   Dateien als "Tarball" einpacken: Wenn Sie Dateien auf Ihrem lokalen Rechner geändert haben, und wieder als Tarball auf den Server laden wollen, verwenden Sie den Aufruf
   tar -vcpz -f geeklog-1.3.11d.tar.gz geeklog-1.3.11d
   FTP und Windowsbenutzer: Entpacken Sie die Tarball-Datei auf Ihrem lokalen Rechner und laden Sie die die resultierenden Dateien auf Ihren Server. Alle Dateien außer Bilddateien werden als ASCII hochgeladen.
2. Bei Installationen auf *nix -Servern kann die folgende Anweisung erforderlich sein:
   chown -R webuser:webuser /path/to/geeklog
   Das sorgt dafür, dass alles innerhalb des Pfades Ihnen gehört. Typische Angaben sind www:www oder nobody:nobody und noch öfters spielt diese Angabe keine Rolle.
3. Bei Installationen auf *nix -Servern wechseln Sie mit cd in das Verzeichnis /path/to/geeklog und geben folgende Anweisungen ein:
   chmod -R 775 logs/
chmod -R 775 public_html/backend/
chmod -R 775 public_html/images/articles
chmod -R 775 public_html/images/userphotos
   FTP-Benutzer: Wenn Sie die chmod-Anweisung über einen FTP-Client ausführen, müssen Sie chmod sowohl für die Dateien innerhalb der Verzeichnisse logs/ und public_html/backend als auch für die Verzeichnisse selber ausführen. Die meisten, wenn nicht gar alle FTP-Clients führen die Anweisung nicht rekursiv aus. Im Klartext heißt das: Sie müssen die Rechte für jede einzelne Datei innerhalb der Verzeichnisse manuell setzen.
   
   

   Besonderer Hinweis: Die meisten Fehlermeldungen bei den ersten Gehversuchen mit Geeklog kommen zustande, wenn Schritt #3 nicht sauber ausgeführt wird. Nehmen Sie sich die Zeit und gehen Sie die Schritte sorgfältig durch.

   Zudem haben eine Reihe von Benutzern Probleme mit den Zugriffsrechten, wenn diese nicht auf 777 gesetzt werden. Versuchen Sie zuerst die "milderen" Rechte 775 und stellen Sie 777 erst dann ein, wenn Sie Fehlermeldungen erhalten.

   http://yourgeeklogsite/admin/install/check.php ist ein Script, mit dem Sie die Dateirechte prüfen können.

4. Legen Sie die Datenbank für Geeklog an. Sie müssen nur die leere Datenbank anlegen, Wenn Sie sich mit MySQL nicht auskennt – das Installationsscript (siehe unten) wird die Tabellen für Sie erzeugen.
   Wenn Sie mit MySQL nicht vertraut sind, legen wir Ihnen phpMyAdmin ans Herz. Wenn Sie mit beiden Begriffen nichts anfangen können, setzen Sie sich mit den Systemadministrator in Verbindung.
5. Öffnen Sie die Datei config.php und stellen Sie die entsprechenden Parameter für Ihren Server ein. Für die erste Installation heißt das in erster Linie: Setzen Sie Pfade. Alle anderen Variablen können Sie nach einer erfolgreichen Installation noch ändern. config.php enthält jede Menge Kommentare, um Ihnen zur Seite zu stehen.
   Windows Users, Ihr solltet in der Lage sein, in Euren Pfaden den Unixpfad '/' zu benutzen. Ansonsten braucht Ihr den doppelten Windowsslash '\\'.
   Lesen Sie die Kommentare in der Datei config.php sorgfältig.
6. Öffnen Sie die Datei lib-common.php im Verzeichnis public_html und ändern Sie die require_once()-Anweisung am Anfang, so dass sie auf den Speicherort Ihrer config.php verweist.
7. Jetzt aber! Öffnen Sie Ihren Browser und navigieren Sie auf die Seite http://yourgeeklogsite/admin/install/install.php. Dort folgen Sie den Anweisungen!
8. Sobald die Erfolgsmeldung sehen, ist die Installation fertig und Sie können mit dem Einstellen von News, Atikeln und Links beginnen oder das Design anpassen. Vorher sollten Sie unbedingt das Verzeichnis admin/install löschen (und alle Dateien, die darin liegen).
9. Lesen Sie den ersten Artikel auf Ihrer Geeklog-Site, um herauszufinden, wie man sich als Administrator einloggt. Denken Sie dabei auch daran, das Administrator-Passwort zu löschen, das für die erste Benutzung mitgeliefert wird.

Wenn Probleme auftreten oder Sie laufend Fehlermeldungen erhalten, sehen Sie sich bitte den Abschnitt Typische Installationsprobleme unten an.