administrators (intermediate) Eine WikiFarm sind zwei Wikis, die auf einem Webserver installiert sind und einige Componenten gemeinsam nutzen. Der Begriff ist abgeleitet von 'Server Farm'.

Diese Seite gibt Aufschluss ber die Hintergrnde rund um WikiFarms und beschreibt, wie man einen 'normale' PmWiki-Konfiguration in WikiFarm berfhrt, indem man weiter PmWikis hinzufgt. Es gibt mehrere Wege WikiFarm zu konfigurieren; diese Seite beschreibt lediglich einen Weg, um es fr die Administratoren, die zum ersten Mal eine Farm installieren, es so einfach wie mglich zu halten.

Wozu braucht man eine Farm

Die primre Motivation fr eine WikiFarm ist es, den administrativen Aufwand zu reduzieren, den man hat, wenn man mehrere Wikis parallel betreibt. In einer Farm werden die meisten Programmdateien von allen Wikis der Farm gemeinsam genutzt aber an einer einzigen Stelle gespeichert. Der Administrator ist somit in der Lage z.B. den Update des PmWiki durchzufhren, indem er lediglich einmal die zentral gespeicherten Programmdateien erneuert.

Fr den Nutzer der verschiedenen Wikis ist jedes Wiki der Farm absolut unabhngig von den anderen und erscheint als eine seperate Webseite. Jedes Wiki in einer Farm:

  • hat seine eigene URL und die URL kann einer anderen Domain zugeornet sein
  • kann hat sein eigenes Layout haben, indem es unterschiedliche Skins benutzt
  • kann seine eignen Add-ons und Anpassungen haben, siehe Cookbook
  • kann siene eigenen administrativen Regelungen fr die jeweilige Konfiguration haben

Wann sollte man keine Farm benutzen

Weil die Wikis einer Farm unabhngig voneinander sind, ist es schwierig (aber nicht unmglich) Funktionalitten anzubieten, die den Zugriff zu den Inhalten von mehreren Wikis bentigen. Z.B. kann die PmWiki-Suchfunktion nur innerhalb eines Wikis suchen. Benutzt man eine Farm und ein berthema in Teile zu untergliedern, ist dies grundstzlich eine schlechte Idee. Um eine Unterteilung zu erreichen sollte man eher WikiGroups benutzen.

Ich kann mich nicht entscheiden, ob ich eine Farm nutzen soll

Die gute Nachricht ist: man braucht sich nicht vorab zu entscheiden. In der Praxis wird empfohlen erst eine normale installation eines PmWiki durchzufhren und dies eine gewisse Zeit zu benutzen. Man legt Seiten an und bearbeitet sie. Man lernt Rezepte aus dem Kochbuch (Cookbook) hinzu zu fgen. Man sollte unbedingt auch die Funktionen von WikiGroups installieren und testen, denn u.U. sind diese bereits ausreichend.

Wenn man dann feststellt, dass man ein weiters Wiki bentigt, hat man zwei Mglichkeiten:

  1. Man fhrt eine komplette Neuinstallation eines PmWiki in einem neuen Direktory durch. Was zwei vllig unabhngige Wikis ergibt, die vllig eigenstndig sind. Dies ist keine Wiki-Farm.
  2. Man erstellt eine Wiki-Farm, indem man das existierende Wiki als 'Home-Wiki' nutzt und die meisten Programmdateien gemeinsam nutzt.

Die Alternative 1 sollte in folgenden Fllen gewhlt werden:

  • da es keine Wiki-Farm ist, braucht man auch kein zustzliches KnowHow um die zweite Seite zu administrieren.
  • wenn man vor hat, eines der Wikis auf einen anderen Server zu kopieren, kann man dies sehr einfach tun, indem man das Wiki-Directory auf den zweiten Server kopiert. Dort wird es (richtige PHP-Version vorausgesetzt) problemlos funktionieren.
  • man kann in jedem PmWiki eine andere Version des PmWiki benutzen, z.B. um diese zu testen.
  • Installationsfehler wirken sich nicht auf die jeweils andere Instanz aus.

Wenn man sich fr Alternative 2, eine Wiki-Farm, entscheidet, geht man wie folgt vor .....

Vorbereitung

Bevor man eine Farm erstellt, ist sicher zu stellen dass:

Erstellen des 'Home-Wiki'

Sie haben eine laufende PmWiki-Installation? Gut, weil diese nun das 'Home-Wiki' der Farm wird.

Im Directory, welches das existierende Wiki enthlt, erstellt man eine Datei local/farmconfig.php. Diese Datei wird die Farm-Anpassungen enthalten. Z.B. kann man in farmconfig.php ein Admin-Passwort festlegen, welches dann in allen Wikis der Farm gltig ist.

Wenn die URL fr das existierende 'Home-Wiki' http://www.example.com/pmwiki/ ist, dann sieht die einfachste farmconfig.php wie folgt aus:

    <?php if (!defined('PmWiki')) exit();
      $FarmPubDirUrl = 'http://www.example.com/pmwiki/pub';

Dies ld dann die Variable $FarmPubDirUrl mit dem Speicherort des 'Home-Wiki' und somit auch des /pub-Directorys. Das /pub-Directory enthlt alle Skin-Definitionen und GUI-Edit-Buttons, welche von den Wikis der Wiki-Farm gemeinsam genutzt werden sollen.

So verblffend dies klingt, sind dies schon alle nderungen, die bentigt werden, um das existierende 'Home-Wiki' in eine Wiki-Farm zu verwandeln.

Weitere Wikis innerhalb der Farm erstellen

1. Erzeugen eines Directorys, welches das neue Wiki enthalten wird. Dieses Directory muss vom Webserver erreichbar sein, so wie das des 'Home-Wiki'.

2. Erzeugen einer Datei index.php in diesem Directory, welche folgende Angaben enthlt:

    <?php include('path/to/pmwiki.php');

Damit benutzt das neue PmWiki die Dateien und Programme aus dem 'Home-Wiki'. Die Angabe path/to/pmwiki.php ist der Pfad, in welchem die Datei pmwiki.php des 'Home-Wiki' gespeichert ist. Man kann sowohl eine absoulte Pfandangabe (/home/username/pmwiki/pmwiki.php) als auch eine relative Pfadangaben (../pmwiki/pmwiki.php) benutzen. Benutze keine URL - es darf also kein 'http://' in der Pfadangabe enthalten sein. Fr Windows-Web-Server ist der komplette Dateipfad zu benutzen C:/Apache Group/Apache2/www/mynewwiki/.

3. Wenn man nun das neue Wiki mit dem Webbrowser aufruft, also eine URL, die mit 'http://' beginnt, wird automatisch das Wiki-Directory wiki.d/ erzeugt, in welchem die Wiki-Seiten gespeichert werden. Wenn eine Fehlermeldung erscheint, befolgen Sie die Angaben der Fehlermeldung. Wenn Sie die option "slightly more secure installation" whlen, mssen Sie beide genannten Kommandos ausfhren.

Ihre Wiki-Farm ist nun installiert und enthlt 2 Wikis. Um weitere Wikis hinzuzufgen, mssen Sie einfach die letzten 3 Steps wiederholen.

Einstellungen

Jede Wiki-Farm erbt die Einstellungen aus farmconfig.php. Alle Einstellungen, die in der Wiki-Farm Gltigkeit haben, mssen also in farmconfig.php gespeichert sein.

Um Einstellungen fr jeweils ein Wiki vorzunehmen ist ein Verzeichnis local/ zu erstellen, in welchem alle lokalen Einstellungen des jeweiligen Wiki gespeichert werden. Die Farm-Einstellungen werden vor den lokalen Einstellungen gelesen, so dass die lokalen Einstellungen die farmweit geltenden berschreiben.

Die PmWiki-Variable $FarmD zeigt auf das Directory in welchem pmwiki.php des 'Home-Wiki' gespeichert ist. Diese wird als Prefix bentigt um auf gemeinsam genutzte Komponenten des jeweiligen Wiki zuzugreifen. Zum Beispiel:

  • $FarmD/scripts/ zeigt auf das gemeinsame Verzeichnis scripts/
  • $FarmD/pub/ zeigt auf das gemeinsame Verzeichnis pub/ directory
  • $FarmD/cookbook/ zeigt auf das gemeinsame Verzeichnis cookbook/ directory

Hinweis

  • Die Terminologie, welche in Wili-Farms benutzt wird ist nicht durchgngig. Siehe auch WikiFarmTerminology?
  • Es ist wichtig zu wissen, dass nicht alle Rezepte aus dem Kochbuch fr Wiki-Farms geschreiben und getestet wurden. Beachten Sie die Informationen wie das jeweilige Rezept auf die Wiki-Farm anzuwenden ist.
  • Es gibt viel, viel mehr Funktionalitten, die man mit Wiki-Farm nutzen kann. Einige sind beschrieben in WikiFarmsAdvanced?, welches auch Schritt-fr-Schritt-Anleitungen enthlt um Wiki-Farms zu installieren.

<< Internationalisierungen | DocumentationIndex | InterMap anpassen >>

Seite zuletzt geändert am 31.07.2006 09:09 Uhr · Seitenaufrufe: 1399