Budo-Lexikon | PmWikiDe / Installation

Administratoren (Grundlagen) (deutsche Übersetzung der Seite PmWiki.Installation, Stand 2005-09-16)

Auf dieser Seite wird erklärt, wie Pm Wiki 2.0 heruntergeladen und installiert wird. Hier noch eine Liste dazugehörender Seiten:

Voraussetzungen - für die Installation von Pm Wiki
Upgrades - Wie bestehende Installation auf den neuesten Stand gebracht werden
Wikifarm - Betrieb von mehreren Wikis mit einer einzigen Installation
Liste der Änderungen - Verfügbare neue Funktionen und Fehlerbehebungen in Englisch

Verbesserungen an diesen Anleitungen wären hoch willkommen. Berichten Sie jedes Problem in der pmwiki-users Mailingliste oder tragen es im PmWiki Issue Tracking System ein.

Installation von Pm Wiki

1. Die letzte Pm Wiki Version als ZIP Archiv (pmwiki-latest.zip) oder als GZIPtes tar (pmwiki-latest.tgz) von http://www.pmwiki.org/pub/pmwiki/ herunterladen.

2. Das heruntergeladene Archiv mittels tar zxvf pmwiki-latest.tgz oder unzip pmwiki-latest.zip entpacken. Dadurch wird ein pmwiki-x.y.z Verzeichnis erzeugt in der die Pm Wiki Software zu finden ist. Zum Beispiel sollte das aktuelle "latest" Paket in ein Verzeichnis "pmwiki-2.3.37" entpackt werden. Das Verzeichnis enthält folgende Dateien:

    COPYING            Die GNU General Public License
    local/             Verzeichnis für lokale Anpassungen
    pmwiki.php         Das pmwiki Hauptprogramm
    pub/               Verzeichnis für frei zugängliche Daten
    css/               Verzeichnis für .css Dateien
    skins/             Verzeichnis für Layout Vorlagen
    sample-config.php  Eine Beispielkonfigurationsdatei
    scripts/           Einige Erweiterungsmodule für Pm Wiki
    wikilib.d/         Verzeichnis mit den Standard Pm Wiki-Seiten
    cookbook/          Verzeichnis für Rezepte aus dem Kochbuch

3. Das Verzeichnis pmwiki-x.y.z sollte an einem Platz abgelegt werden, auf den der Webserver zugreifen kann (z.B. in einem public_html Verzeichnis irgendeiner Art). Man kann die Dateien und Verzeichnisse mit verschiedenen Werkzeugen ablegen -- FTP oder mit Unix mv oder cp Befehlen.

Hinweis: Es ist wahrscheinlich auch eine gute Idee den Verzeichnisnamen "pmwiki-x.y.z" einfach zu "pmwiki" umzubenennen.

4. Öffnen Sie pmwiki.php auf dem Server in Ihrem Webbrowser (also nicht die Datei auf Ihrem Rechner mit der Internetadresse file://...). Pm Wiki analysiert dann das System und gibt Anweisungen (falls notwendig), um das Verzeichnis wiki.d/ zu erzeugen. In diesem Verzeichnis werden die neu erzeugten Seiten Ihres Wikis gespeichert. Normalerweise gibt es zwei Möglichkeiten, das Verzeichnis zu erzeugen:

4a. Man kann das Verzeichnis wiki.d/ manuell erzeugen und ihm dann volle Schreibrechte zuweisen (d.h. "chmod 777 wiki.d"). Verwenden Sie diese Methode, wenn auf Ihrem Server der "Safe Mode" bei PHP eingeschaltet ist.

4b. Auf manchen Systemen ist es möglich, das Verzeichnis wiki.d/ von Pm Wiki erzeugen zu lassen, indem das Verzeichnis, das pmwiki.php enthält, kurzzeitig das Recht 2777 erhält. Unter Unix wird hierzu normalerweise in das Verzeichnis gewechselt, das pmwiki.php enthält und folgender Befehl ausgeführt

        chmod 2777 .

(Man beachte den Punkt am Ende). Der chmod Befehl funktioniert auch in vielen FTP Programmen. Das Erzeugen von wiki.d/ auf diese Weise wird

a) das Verzeichnis für den Webserver beschreibbar machen, damit das Verzeichnis für die Wikidateien erzeugt werden kann, b) behält die Gruppenrechte des Verzeichnisses bei, so dass das Erzeugerkonto des Verzeichnisses die Dateien in diesem Verzeichnis bearbeiten kann und c) wird es für andere Konten (Accounts) auf dem gleichen Server schwieriger auf die Dateien im Verzeichnis wiki.d/ zuzugreifen.

5. Nachdem alle Verzeichnisrechte eingestellt wurden, öffnen Sie nochmal pmwiki.php im Webbrowser. Wenn alles gut gegangen ist, wird das Verzeichnis wiki.d erzeugt und man sieht die Standardseite.

Wichtig: Wenn man die Methode 4b verwendet hat, sollte man die Rechte des Verzeichnisses, das pmwiki.php enthält mit dem Befehl "chmod 755 ." wieder zurücksetzen.

6. Wenn man weitere Anpassungen für die eigene Pm Wiki Installation durchführen möchte, sollte man einen Blick auf die Seite Erste Einstellungen werfen. Zusätzlich kann man sich die Anmerkungen zu den Versionen (Englisch) ansehen.

7. Wenn man Pm Wiki in anderen Sprachen nutzen möchte, kann man sich das gewünschte Sprachpaket (i18n-de.zip) oder alle (i18n-all.zip) als ZIP Archiv (i18n-de.zip) von http://www.pmwiki.org/pub/pmwiki/i18n/ herunterladen. Dann werden die Dateien wie oben beschrieben auf dem Server in das Verzeichnis wikilib.d/ kopiert. Zum aktivieren folgenden Eintrag (im Beispiel für die deutsche Übersetzung) in die stdconfig.php im Verzeichnis scripts setzen:

XLPage('de','PmWikiDe.XLPage');

Anmerkungen

Wenn der Unix-Befehl tar für das Entpacken des Archivs in Schritt 2 verwendet wird, muss man sicherstellen, dass die Dateien mit ausreichenden rechten erzeugt wurden, damit der Webserver darauf zugreifen kann. Normalerweise kann man das erreichen, indem man in der Befehlszeile umask 002 eingibt, bevor das Archiv entpackt wird.
Viele Administratoren erzeugen eine Datei index.php im pmwiki Verzeichnis, die nur eine Zeile enthält:
<?php include('pmwiki.php');
Man beachte, dass die PHP-Endkennung " ?>" für bessere Kompatibilität weggelassen wurde, da einige Betriebssysteme Probleme mit zusätzlichen Leerzeilen haben.
Wenn die Installation auf einem Windows-Rechner erfolgt, sollte man unbedingt einen Blick auf Cookbook:SimultaneousEdits werfen. Unter Windows funktioniert die korrekte Behandlung von zeitgleichen Bearbeitungen nicht, da der dazu benötigte Befehl diff3 unter Windows nicht verfügbar ist.

<< Löschen von Seiten | Dokumentationsindex | Erste Einstellungen >>