Manual:Config script/de
Wenn Sie MediaWiki erst einmal installiert haben, muss als Erstes die Grundeinstellung vervollständigt werden, indem Sie das mitgelieferte Konfigurationsprogramm ablaufen lassen. Mit diesem Programm teilen Sie MediaWiki die Informationen mit, die es benötigt, damit das Wiki eingerichtet werden und korrekt laufen kann.
Contents |
Vorbereitung [edit]
In den folgenden Beispielen wird angenommen, dass Ihre Website unter http://www.example.com/ eingerichtet ist, die physisch auf Ihrem Server unter /home/example/web zu finden ist. Sie müssen die Beispiele anpassen und in Ihrem Fall die eigene Adresse verwenden.
- Verwenden Sie Ihren Webbrowser und browsen Sie zur Wiki-Hauptseite. Dies ist das über das Web erreichbare Verzeichnis, in welches Sie MediaWiki installiert haben. Dieses heißt bezeichnenderweise
/wiki(z. B.http://www.example.com/wiki/). Es wird angenommen, dass Sie MediaWiki installiert haben unter:/home/example/web/wiki. - Es wird Ihnen mitgeteilt, dass Ihr wiki installiert, aber noch nicht konfiguriert ist. „Klicken Sie hier um wiki einzurichten.“ Mit dem Klick auf diesen Link starten Sie das Konfigurationsprogramm.
| MediaWiki version: | ≥ 1.17 |
Konfigurationsprogramm (ab 1.17) [edit]
Der neue Arbeitsablauf fragt die verschiedenen Einstellungen nacheinander in einzelnen Formularen ab (siehe die Übersicht rechts). Abhängig von der tatsächlichen Konstellation werden unter Umständen einzelne Schritte übersprungen. Jeder Schritt ist mit Weiter abzuschließen.
Zu den Festlegungen stehen kurze Erläuterungen zur Verfügung. Meistens ist die Konfiguration ohne Kontrolle in dieser Anleitung möglich. Die untenstehende Tabelle „Felder in Formularen“ enthält weitere Hinweise.
- Sprache
- Wählen Sie aus, welche Sprache während der Installation und für das Wiki verwendet werden soll.
- Vorhandenes Wiki
- Wenn die Datei LocalSettings.php bereits existiert, muss ein dort vorhandener Aktualisierungsschlüssel $wgUpgradeKey eingetragen werden.
- Willkommen
- Die Software prüft, ob die Voraussetzungen erfüllt sind und welche ergänzenden Maßnahmen empfohlen werden. Beachten Sie auch die Lizenzbedingungen, bevor die Konfiguration fortgesetzt wird.
- Mit der Datenbank verbinden
- Wählen Sie ein Datenbanksystem aus. Abhängig von der Auswahl sind unterschiedliche Angaben vorzunehmen.
- Eine vorhandene Installation aktualisieren
- An dieser Stelle wird die vorhandene Datenbank geprüft. Sofern erforderlich, werden Definitionen (Tabellen, Spalten) an eine neue MW-Version angepasst.
- Datenbankeinstellungen
- Auch diese Einstellungen hängen vom Datenbanksystem ab.
- Name
- Hier geht es um den Namen des Wiki und seinen Systemverwalter. – Eigentlich sind damit alle erforderlichen Einstellungen abgeschlossen. Für die praktische Arbeit sind weitere Optionen sinnvoll, auch wenn das als nicht erforderlich bezeichnet wird.
- Optionen
- Diese beziehen sich auf Benutzeranmeldungen, Wiki-Lizenz, Email-Einstellungen, Erweiterungen und das Hochladen von Dateien.
- Installieren
- Mit diesem Formular werden alle Einstellungen abgeschlossen. Danach werden in der Datenbank die Einträge erstellt (mit Protokollierung).
- Fertig
- Als Ergebnis wird die Datei LocalSettings.php erzeugt. Sie enthält alle Informationen, die MediaWiki zur Ausführung benötigt. Speichern Sie diese Datei im Hauptverzeichnis des Wikis, also unter /home/example/web/wiki.
- Installationsvorgang erneut starten
- In Ausnahmefällen – vor allem bei umfangreicheren Änderungen – ist dies möglich und sinnvoll. Bitte beachten Sie aber, dass dann die bisherige Installation gelöscht wird und manche Inhalte nicht oder nur sehr umständlich zur Verfügung stehen.
Es gibt Fälle, in denen man das Konfigurationsskript selbst sucht – vor allem nach der Installation einer neuen MW-Version. Das Skript befindet sich im Verzeichnis mw-config von wiki und kann so gestartet werden:
- http://www.example.com/wiki/mw-config/index.php (Installation im Netz) bzw.
http://localhost/wiki/mw-config/index.php (beim lokalen Wiki)
Wenn eine der Optionen nachträglich geändert werden soll, ist entweder LocalSettings.php manuell zu ändern; oder Sie müssen sie umbenennen (eigentlich löschen, aber so haben Sie noch eine Sicherungskopie) und die gesamte Konfiguration wiederholen.
| MediaWiki version: | ≤ 1.16 |
Konfigurationsprogramm (ab 1.10) [edit]
Es gibt Fälle, in denen man das Konfigurationsskript selbst sucht. Das Konfigurationskript ist zu finden im Verzeichnis config von wiki. Verwendet man das obere Beispiel, so wäre das Konfigurationsprogramm zu finden unter http://www.example.com/wiki/config/.
- Wenn das Skript Konfigurationsfehler entdeckt, erlaubt es nicht, die Konfiguration fortzusetzen. Weiter unten finden Sie Einzelheiten über mögliche Fehlermeldungen und was zu tun ist, wenn Fehlermeldungen eintreten.
- Wenn alle Prüfungen bestanden sind wird Ihnen ein Formular präsentiert, in welches die Informationen einzutragen sind, die MediaWiki jetzt benötigt. Folgen Sie den Anweisungen auf dem Formular um die benötigten Angaben einzutragen. Hilfe zu irgendeinem von diesen Punkten finden Sie weiter unten im Text.
- Klicken Sie den Knopf "Install". Das Programm wird jetzt die Datenbank einpflegen und eine Konfigurationsdatei anlegen. Wenn irgendwelche Fehler auftreten, gehen Sie zurück und überprüfen Ihre Angaben. Hilfe finden Sie weiter unten im Text.
Wenn die Installation beendet ist wird im Verzeichnis "config" eine Datei namens LocalSettings.php erzeugt. Die Datei enthält alle Informationen die MediaWiki zur Ausführung benötigt.
- Verschieben Sie diese Datei in das Hauptverzeichnis von wiki (wenn Sie z.B. MediaWiki unter /home/example/web/wiki installiert haben, verschieben Sie es hierhin).
- Legen Sie strenge Zulassungen für die Datei LocalSettings.php fest (chmod 600 and chown <webserver owner> Anmerkung: Z.B. auf einem NAS sytem können unter Umständen auch eine andere Rechteinstellung notwenig sein, die allerdings ein Sicherheitsrisiko darstellen könnte chmod 604)
- Löschen Sie das Verzeichnis "config".
Wenn Sie das vorgenannte erledigt haben, sollte Ihr wiki zum Einsatz bereit sein. Browsen Sie zu der Adresse in der Sie Ihr wiki installiert haben (in unserem Beispiel: http://www.example.com/wiki/) und beginnen Sie mit dem Editieren.
Felder in Formularen [edit]
Wenn Sie die Formblätter in der Konfiguration ausfüllen und unsicher sind, was Sie eingeben sollen, sehen Sie in der folgenden Tabelle nach.
Die Reihenfolge und Gruppierung der Felder entspricht den einzelnen Formularen im neueren Konfigurationsprogramm.
| Feld | Erläuterung | MW-Hilfe |
|---|---|---|
| Sprache | ||
| Language Sprache des Wikis |
Aus der zweiten Dropdown-Liste wird die Sprache für das Wiki ausgewählt. Bitte beachten Sie, dass nicht alle Anpassungen vollständig sind. Unicode (UTF-8) ist der normale Zeichensatz für jede Auswahl. | Language |
| Mit der Datenbank verbinden | ||
| Datenbanksystem | Zunächst ist das Datenbankverwaltungssystem (Database Management System, DBMS) auszuwählen. Zurzeit sind standardmäßig MySQL und SQLite vorgesehen. Möglich sind (mit unterschiedlichen Voraussetzungen) auch Oracle, Postgres, DB2. Die weiteren Einstellungen hängen von dieser Auswahl ab. | MySQL SQLite Oracle PostgreSQL IBM DB2 |
| Database host Datenbankserver |
Der Server, auf dem sich die Datenbank befindet. Wenn sich die Datenbank auf dem gleichen Server wie der Webserver befindet, setzen Sie ein: localhost Anmerkung: Wenn MySQL mit einem speziellen "socket file" arbeitet (z. B. unter Unix mit --socket=/tmp/mysocketfile), dann geben Sie hier an: localhost:/tmp/mysocketfile |
|
| Database name Datenbankname |
Unter diesem Namen soll die Datenbank für das Wiki aufgerufen werden. Anmerkung: Wenn Sie die Rechte als „Superuser“ des DBMS haben, kann die Datenbank unter diesem Namen während der Konfiguration erstellt werden. Andernfalls ist der Name anzugeben, unter dem die Datenbank für das Wiki beim DBMS-Server estellt worden ist. Anmerkung: Wenn Sie auf einer Seite installieren, die von Yahoo gehostet wird, müssen Sie den Datenbanknamen festlegen auf mysql. |
Database access |
| Database table prefix Datenbank-Tabellenvorsatz |
Nur bei MySQL: Eine optionale Vorsilbe, die vor den Namen jeder Tabelle in der wiki-Datenbank gesetzt wird. Wenn Sie mehrere Wikis betreiben möchten, müssen Sie eine Vorsilbe benützen wie z. B. w1. Damit können innerhalb derselben Datenbank viele Wikis mit unverwechselbaren Namen installiert werden. So wird z. B. der allgemeine Name archive zu w1_archive, w2_archive usw. Auf diese Weise können Sie weitere Installationen von MediaWiki hinzufügen, ohne die Datenbanktabellen zu überschreiben. | |
| Database username Datenbankbenutzername |
Der Benutzername für den Zugriff auf die Wiki-Datenbank. Anmerkung: Als „Superuser“ können Sie hier einfach einen Benutzernamen eintragen, der für die Datenbank registriert wird. Andernfalls ist ein Benutzer anzulegen mit den Rechten für SELECT, INSERT, UPDATE und DELETE. Zur Installation benötigt er zusätzlich die Rechte für CREATE and INDEX. Anmerkung: Es wird strikt empfohlen, keinen Superuser als Datenbankbenutzer anzugeben, denn das Passwort wird im Klartext gespeichert. |
|
| Database password Datenbankpasswort |
Das Benutzerpasswort für den Zugriff auf die Wiki-Datenbank. | |
| Database port Datenbankadresskomponente |
Nur bei Postgres: Dies ist der Port, unter welchem Postgres zu erreichen ist. Der voreingestellte Wert von 5432 sollte in den meisten Fällen funktionieren . | |
| Schema for mediawiki / Schema for tsearch2 Namensmuster |
Nur bei Postgres: Der Mustername, mit dem Sie Ihr wiki benennen. Der voreingestellte Name mediawiki sollte für die meisten Zwecke genügen. Um mehr als ein wiki in der gleichen Datenbank zu verwenden, sollten sowohl der Datenbank-Mustername als auch der Benutzername geändert werden – möglichst mit dem gleichen Namen, um Verwirrung zu vermeiden. Der voreingestellte Name public bei tsearch2 sollte so gut wie nie verändert werden müssen. | |
| Superuser account (Superuserkonto)/ Superuser password Superuserpasswort |
Der Root-account bzw. der Superuser ist das Benutzerkonto mit Administratorrechten bei Betriebssystemen. Wenn Sie es nicht haben, verändern Sie nichts und wenden sich an Ihren Provider. Wenn Sie es haben, können Sie die obenstehenden Abschnitte über die Anlage einer Datenbank überspringen, da MediaWiki in diesem Fall in der Lage ist, dieses selbst zu erledigen. | |
| Weitere Datenbankeinstellungen Auch diese hängen vom verwendeten DBMS ab. Siehe die o. g. Verweise auf die Hilfe. |
||
| Database character set Zeichensatz der Datenbank |
Mit Unicode wurde ein internationaler Standard zur Darstellung von Zeichen und Texten festgelegt. Das Format UTF-8 ist dabei am gebräuchlichsten. Es gibt nur selten einen Grund, eine der angebotenen Alternativen zu wählen. | |
| Name | ||
| Name des Wiki | Dieser Name wird durchgehend im Wiki als „öffentlicher Name“ angezeigt. Ein kurzer Begriff ohne Satzzeichen wird empfohlen. | $wgSitename |
| Projektnamensraum | Diese Bezeichnung wird für Projektseiten verwendet. Standardmäßig entspricht es dem Namen des Wiki, darf aber davon abweichen. Außerdem darf es weder den Text „MediaWiki“ noch das Zeichen ‚#‘ enthalten. | $wgMetaNamespace |
| Administrator | Es ist ein erster Benutzer anzulegen mit Benutzernamen und Passwort. Dieser bekommt die Rechte als: Administrator, Automatisch bestätigter Benutzer, Bürokrat, Benutzer. | User rights |
| Email-Kontakt | Diese Adresse wird verwendet für administrative Aufgaben, Fehlermeldungen und Benachrichtigungen. Üblich ist admin@localhost. | $wgPasswordSender |
| Optionen | ||
| Art des Wikis | Es wird allgemein festgelegt, unter welchen Bedingungen Nutzer mitarbeiten können. Erläuterungen dazu stehen direkt bei der Auswahl. | |
| Copyright und Lizenz | Es werden mehrere Varianten freier Lizenzen angeboten, unter die das Wiki fallen soll; die ausgewählte Lizenz wird am Fuß einer jeden Seite angezeigt. – "Creative Commons Attribute Share Alike" entspricht der aktuellen Lizenz für die WMF-Projekte. | Copyright |
| Email-Einstellungen | Es gibt mehrere Festlegungen, unter welchen Bedingungen Emails verschickt werden sollen. | Email settings |
| Erweiterungen Extensions |
Mit Extensions werden die Möglichkeiten von MediaWiki erweitert. Jede Erweiterung muss separat heruntergeladen und installiert werden. Diejenigen Erweiterungen, die das Konfigurationsprogramm vorfindet, werden direkt angeboten; die ausgewählten Extensions werden ohne nachträgliche manuelle Installation direkt eingebunden. | Erweiterungen |
| Dateien hochladen | Es ist ausdrücklich festzulegen, ob für das Wiki Dateien (Bilder) hochgeladen werden können. | $wgEnableUploads |
| Logo des Wikis | Hier wird das große Logo eingetragen, das auf jeder Seite links oben angezeigt wird (empfohlene Größe 135x135 Pixel). Das kleine Logo, das in der Adresszeile des Browsers erscheint, muss nachträglich manuell durch $wgFavicon eingetragen werden. | Logo |
| Zugriff auf Commons | Wie von den WMF-Projekten gewohnt, können Dateien auf Wunsch direkt von Anmerkung: Bei einem lokalen Wiki ist dies nur dann sinnvoll, wenn jederzeit eine Internet-Verbindung besteht. |
$wgUseInstantCommons |
| Object Caching | Mit Objektcaching wird die Geschwindigkeit von MediaWiki verbessert, indem häufig genutzte Daten zwischengespeichert werden. Mittelgroßen bis großen Wikis wird sehr empfohlen, dies zu nutzen, aber auch für kleine Wikis ergeben sich erkennbare Vorteile. | memcached |
Siehe auch [edit]
- Weitere Konfigurationsmöglichkeiten
- Konfiguration – vollständige Liste aller Einstellungen (englisch)
- Fehlermeldungen (englisch)
| Sprache: | English • Deutsch • español • français • 日本語 • português do Brasil • русский • 中文 • 中文(台灣) |
|---|
