Archive:Installation 1.5.2 (de)
This page contains outdated information and is thus OBSOLETE! |
Auf dieser Seite wird beschrieben wie man Semantic MediaWiki 1.5.2 installiert, nachdem man das Programm heruntergeladen hat. Bitte beachten Sie, dass sich die Installations- und Aktualisierungshinweise je nach veröffentlichter Version unterscheiden. Versionsspezifische Hinweise in Englischer Sprache werden stets zusammen mit dem jeweiligen Softwarepaket von Semantic MediaWiki (SMW) mit der Datei „INSTALL“ bereitgestellt.
Die Erstinstallation der Software unterscheidet sich von der Aktualisierung bestehender Installationen. Stellen Sie daher sicher, dass Sie den jeweiligen Abschnitt auf dieser Seite gelesen haben, bevor sie beginnen.
Vor der Erstinstallation ist es wichtig die entsprechenden Systemvoraussetzungen zu erfüllen und den bereitgestellten Anleitungen genau zu folgen. Mit Semantic MediaWiki werden keine irreversiblen Änderungen der Datenbank vorgenommen. Bestehende Tabellen werden nicht verändert, sondern es werden weitere Tabellen hinzugefügt, die sich wieder löschen lassen. Für den Fall, dass Semantic MediaWiki wieder deinstalliert werden soll, gibt es momentan noch keine automatisierten Prozesse Bearbeitungen aus den Wikiseiten zu entfernen, die im Rahmen von semantischen Ergänzungen der Inhalte vorgenommen wurden. Dies kann ggf. mit Skripten erfolgen, welche die entsprechenden Anpassungen entfernen.
Contents
Haftungsausschluss[edit]
Bitte beachten und verstehen Sie den Haftungsausschluss im Zusammenhang mit dieser Software. Siehe hierzu die Datei „COPYING“ die zusätzlich zusammen mit dem jeweiligen Softwarepaket von Semantic MediaWiki bereitgestellt wird. Die Datei enthält die Lizenzbedingung der GNU GENERAL PUBLIC LICENSE in der Version 2 vom Juni 1991 in Englischer Sprache. Eine inoffizielle deutsche Übersetzung befindet sich auf dieser Seite.
Systemvoraussetzungen[edit]
- MediaWiki 1.15.4 und höher (bis 1.17alpha (r63248) getestet).
- PHP 5 oder höher mit Ausnahme von 5.3.1
- MySQL 4.0.14 oder höher bzw. PostgreSQL 8.3 oder höher (Die Unterstützung von PostgreSQL ist vorläufig und erfordert weitere Schritte. Siehe hierzu die Hinweise auf der Seite PostgreSQL)
- Anmerkungen
- Es wird davon abgeraten Semantic MediaWiki auf älteren als den angegebenen Versionen von MediaWiki zu verwenden. Dies deshalb, da jede neuere Version von MediaWiki Fehlerbehebungen und Sicherheitsaktualisierungen enthält, von denen auch Semantic MediaWiki profitiert.
- SMW verwendet die PHP mb_*() Multibyte-Funktionen wie mb_strpos in der php_mbstring.dll-Erweiterung. Dieser SMW-Standard ist nicht zwangsläufig in jeder PHP-Distribution aktiviert, was aber zur Nutzung der Fall sein muss. Siehe hierzu die PHP-Anleitung für Hinweise.
- Für die Erstinstallation sowie Aktualisierung bestehender Installationen benötigte SWM die Datenbanknutzerrechte (CREATE) und (ALTER TABLE), um neue Tabellen erstellen und verändern zu können. Beide Nutzerrechte können nach den entsprechenden Befehlsausführungen wieder entzogen werden. Das Skript SMW_setup.php kann auch die Datenbankzugangsdaten aus der Datei AdminSettings.php nutzen, um so eine Rechtevergabe an alle Datenbanknutzer zu umgehen.
- SMW erstellt und ändert in der Datenbank temporäre Tabellen für bestimmte semantische Abfragen. Damit dies möglich ist muss der Datenbanknutzer über das Recht CREATE TEMPORARY TABLES verfügen. Sofern dies nicht gewünscht ist, können die Funktionen für die diese Rechte benötigt werden auch deaktiviert werden. Hierzu müssen die folgenden Codezeilen in die Datei Localsettings.php der MediaWiki-Installation hinter der Zeile enableSemantics('example.org'); eingefügt werden:
$smwgQSubcategoryDepth = 0; $smwgQPropertyDepth = 0; $smwgQFeatures = SMW_ANY_QUERY & ~SMW_DISJUNCTION_QUERY; $smwgQConceptFeatures = SMW_ANY_QUERY & ~SMW_DISJUNCTION_QUERY & ~SMW_CONCEPT_QUERY;
- SMW in Verbindung mit älteren Versionen von MediaWiki
Generell ist davon abzuraten nicht mehr unterstützte MediaWiki-Version zu verwenden, da für sie keine Sicherheitsaktualisierungen mehr durchgeführt werden. Sofern Ihre Website immer noch PHP 4 verwendet, kann SMW nicht genutzt werden. Eine Portierung auf diese Version von PHP ist hierfür zu aufwendig. Sofern Sie PHP 5 und eine veraltete Version von MediaWiki verwenden, könnten zusätzliche Modifikationen an der Software notwendig sein. Diesbezügliche Informationen erhalten Sie bei den Installationsanweisungen zu der mit der jeweiligen MediaWiki-Version verfügbaren Version von SMW.
Erstinstallation[edit]
Sofern Sie bestehende Installationen von Semantic MediaWiki aktualisieren lesen Sie bitte auch den Abschnitt Aktualisierung bestehender Installationen auf dieser Seite.
Die Installation von Semantic MediaWiki erfordert drei oder vier einfach durchzuführende Schritte:
(1) Dateien kopieren:
Nach dem entpacken der heruntergeladenen Archivdatei erhält man den Ordner „SemanticMediaWiki“ der alle benötigten Dateien enthält. Dieser Ordner muss nun per File Transfer Protocol (FTP) binär mit einem FTP-Client in das Verzeichnis für die Erweiterungen von MediaWiki „[Pfad zur MediaWiki-Installation]/extensions/“ kopiert werden. Im Folgenden wird dieser Pfad „[Pfad zur MediaWiki-Installation]/extensions/SemanticMediaWiki“ als „[SMW-Pfad]“ abgekürzt. Alternativ kann man die Dateien auch über Subversion (SVN) mit einem Subversion-Client kopiert werden.
(2) [optional] Anpassung der Namensräume:
Sofern Sie auf Ihrem Wiki keine Änderungen bezüglich der Namensräume vorgenommen haben, können Sie diesen Schritt überspringen. Sofern Sie eigene selbst definierte Namensräume verwenden, ist in der Datei LocalSettings.php der Parameter $smwgNamespaceIndex zu setzen bevor man Semantic MediaWiki aktiviert. Semantic MediaWiki verwendet zehn zusätzliche Namensräume, standardmäßig mit den Nummern 100 bis 109. Die Namensräume 100 und 101 wurden bis SMW 1.4.3 nur für den Fall genutzt, sofern der Parameter $smwgSMWBetaCompatible gesetzt wurde. Seit SMW 1.5.0 werden sie nicht mehr verwendet. Die Namensräume 106 und 107 sind für die Softwareerweiterung Semantic Forms reserviert und werden von SMW nicht verwendet. Siehe hierzu auch die Dokumentation innerhalb der Datei SMW_Settings.php. Sofern Sie nach der Erstinstallation von SMW weitere Namensräume erstellen, ist hierfür eine Nummer zu vergeben die höher ist die des Namensraums mit der höchste Nummer, der von SMW verwendet wird.
- Anmerkung
Semantic MediaWiki wertet semantische Vermerke nur in bestimmten Namensräumen aus. Beispielsweise ignoriert es semantische Vermerke auf Diskussionsseiten. Sofern Sie die Eigenschaft von Namensräumen ändern möchten, was die Auswertung semantischer Vermerke angeht, dann ist die Datenbereichsvariable $smwgNamespacesWithSemanticLinks in der Datei SMW_Settings.php entsprechend zu ändern. Die wird in der Regel dann der Fall sein, wenn Sie selbstdefinierte Namensräume einsetzen.
(3) Semantic MediaWiki aktivieren:
Hierzu werden die folgenden zwei Codezeilen in die Datei „[Pfad zur MediaWiki-Intallation]/LocalSettings.php“ eingefügt.
include_once("$IP/extensions/SemanticMediaWiki/SemanticMediaWiki.php"); enableSemantics('example.org');
wobei example.org für den Namen des Servers oder die IP-Adresse des Servers steht. Diese Zeichenkette wird dazu genutzt einen global eindeutigen Namen festzulegen, welcher der Identifikation der exportierten RDF-Daten im semantischen Web ermöglicht. Die Angabe des Servernamens ist ausreichend, um diese Anforderung zu erfüllen. Sofern Sie Ihr Wiki auf mehreren Servern betreiben, können Sie sich den Name eines der Server aussuchen.
(4) Datenbank anpassen:
Loggen Sie sich in Ihr Wiki mit einen Nutzerkonto ein, das über Administratorenrechte verfügt. Rufen Sie nun die Spezialseite „Spezial:SMW-Einrichtung“ auf, um die beiden notwendigen Schritte auszuführen. Zunächst klicken Sie im ersten Schritt die Schaltfläche „Tabellen initialisieren oder aktualisieren“ im Abschnitt „Datenbankinstallation und -aktualisierung“ an. Nachdem dieser Prozess abgeschlossen wurde klicken Sie im zweiten Schritt die Schaltfläche „Datenaktualisierung beginnen“ im Abschnitt „Datenreparatur und -aktualisierung“ an (siehe auch Datenreparatur). Bitte beachten Sie, dass der erste Schritt Datenbanknutzerrechte zum Erstellen und Ändern der Datenbank benötigt (siehe Anmerkungen im Abschnitt Systemvoraussetzungen) Der zweite Schritt nimmt einige Zeit in Anspruch. Auf der Spezialseite „Spezial:SMW-Einrichtung“ können Sie auch den Arbeitsfortschritt einsehen. Semantic MediaWiki kann währende dieses Prozesses genutzt werden, allerdings hat man nicht Zugriff auf alle Daten, wie bspw. Kategorien.
Testen der Installation
Sofern Sie unsicher sind, ob die Installation korrekt abgelaufen ist, können Sie diesbezüglich ein paar entsprechende Tests durchführen.
a) Zunächst können Sie auf der Spezialseite „Spezial:Version“ nachschauen, ob Semantic MediaWiki im Abschnitt „Installierte Erweiterungen“ unter „Parser Hooks“ aufgeführt wird.
b) Erstellen Sie eine Seite mit dem Namen „SMW-Test“ in Ihrem Wiki mit dem folgenden Inhalt:
Attributüberprüfung: [[Testattribut::Testseite]]
Sofern Sie vor den Abspeichern die Vorschau ansehen, sollten Sie eine unter auf der Seite die Faktenanzeige mit der Bezeichnung „Fakten zu SMW-Test“ sehen. Nach dem Abspeichern sollten Sie nach dem Klicken auf den auf der linken Navigationsleiste unter Werkzeuge zu findenden Link „Attribute anzeigen“ zu der Spezialseite „Spezial:Browse/SMW-Test“ gelangen. Dort wird Ihnen dann das „Testattribut“ mit dem Wert „Testseite“ angezeigt.
Aktualisierung bestehender Installationen[edit]
Von Version SMW 1.5.0 oder höher[edit]
Bestehenden Installationen von SMW 1.5.x können aktualisiert werden indem man die Programmdateien auf dem Server ersetzt. Seit der Version SMW 1.5.2 und höher ist allerdings MediaWiki in der Version 1.15.4 und höher Installationsvoraussetzung.
Alle Softwareerweiterungen, die mit der Version SMW 1.5.1 kompatibel sind, sollte ohne weitere Änderungen auch mit dieser Version kompatibel sein. Sofern von der Version SMW 1.5.0 aktualisiert wird, müssen die kompatiblen Versionen der Softwareerweiterungen zusammen mit Semantic MediaWiki aktualisiert werden. Beispielsweise ist nun Semantic Maps in der Version 0.6 erforderlich. Im Fall von Problemen kann die Aktualisierung auch rückgängig gemacht werden, indem man die Programmdateien wieder mit denen von SMW 1.5.0 überschreibt. Dann muss mit der Aktualisierung gewartet werden, bis auch die eingesetzten Softwareerweiterungen in einer aktualisierten und kompatiblen Version zur Verfügung stehen.
Sofern dies nicht bereits mit der Aktualisierung auf die Version SMW 1.5.1 passiert ist, sollte man nun, wie im obigen Abschnitt Erstinstallation beschrieben, in der Datei LocalSettings.php die Codezeile
include_once("$IP/extensions/SemanticMediaWiki/includes/SMW_Settings.php");
durch
include_once("$IP/extensions/SemanticMediaWiki/SemanticMediaWiki.php");
ersetzt. Die Verwendung der Datei SMW_Settings.php ist weiterhin möglich. Dies wird allerdings bei einer zukünftigen Version vom SMW nicht mehr der Fall sein.
Von Version SMW 1.4.3 oder niedriger[edit]
Bestehende Installationen von SMW 1.4.x und alle weiteren Installationen, die bereits die Standarddatenablage („SMWSQLStore2“) verwenden, können analog den im obigen Abschnitt Erstinstallation beschriebenen Schritten aktualisiert werden. Mit allen weiteren Installationen sind diejenigen Installationen von SMW 1.2 und SMW 1.3 gemeint, die keine spezielle Einstellung verwenden, mit der auf die vormaligen Standarddatenablagesystem („SMWSQLStore“ oder „SMWRAPStore“) zurückgesetzt werden kann.
Ältere Versionen von Semantic MediaWiki können auf ähnliche Weise aktualisiert werden, wobei aber sichergestellt sein muss, dass diese nicht mehr von nunmehr veralteten Rahmenbedingungen dieser Versionen abhängig sind. Diesbezüglich wird auf die Aktualisierungsanleitungen der Versionen SMW 1.2.0 (englisch) und SMW 1.3 (englisch) verwiesen.
Mit SMW 1.5.0 wurde die Abwärtskompatibilität zu den Versionen SMW 0.1 bis 0.7 beendet. Sofern Ihr Semantic MediaWiki noch die Einstellung $smwgSMWBetaCompatible = true nutzt darf zunächst keine Aktualisierung auf SMW 1.5.0 oder höher erfolgen. Vorher muss sichergestellt werden, dass das genutzte Wiki problemlos ohne diese Einstellung läuft und verwendet werden kann.
Es wurden Veränderungen an zwei SMW-Funktionalitäten vorgenommen, die Auswirkungen auf die Daten älterer Installationen haben und daher zusätzliche Aktualisierungsschritte erfordern. Es handelt sich um n-adische-Attribute (Attribute mit mehrgliedrigen Relationen) und den Datentyp Geographische Koordinaten. Sofern bereits beide oder eine der beiden Funktionalitäten eingesetzt wurden, gibt es Aktualisierungshinweise in den folgenden beiden Unterabschnitten (Datentyp Geographische Koordinaten und n-adische-Attribute).
Unmittelbar nach der Aktivierung der Version SMW 1.5.0 oder höher kann es vorkommen, dass Sie SQL-Fehlermeldungen erhalten. Diese sind auf Hintergrundprozesse zurückzuführen, die auf die neue Datenbankstruktur zuzugreifen versuchen, bevor diese von Ihnen überhaupt initialisiert wurde. Dies kann sogar dazu führen, dass Sie noch nicht einmal mehr auf die Spezialseite „Spezial:SMW-Einrichtung“ zugreifen können. In diesen Fällen gibt es zwei Möglichkeiten der Fehlerbehebung. Entweder führen Sie auf Ihrem Server die Datei SMW_setup.php direkt über die Kommandozeile aus oder Sie löschen direkt in Ihrer Datenbank alle Einträge in der Datentabelle „job“. Hernach sollten keine Fehlermeldungen mehr beim Aufrufen der Spezialseite „Spezial:SMW-Einrichtung“ auftreten.
Nach der Aktualisierung von den Versionen SMW 1.4.x oder niedriger, müssen SMW-Softwareerweiterungen (z. B. Semantic Forms) ebenso auf eine Version aktualisiert werden, die mit SMW 1.5.1 kompatibel ist. Die entsprechenden Versionen sind auf der Webseite der jeweiligen Softwareerweiterung angegeben. Dieser Hinweis trifft besonders auf die Erweiterung Semantic Result Formats zu. Die Formate wurden in diese Erweiterung überführt und sind nach der Installation automatisch aktiviert.
Bezüglich des Datentyps Geographische Koordinaten[edit]
Dieser Datentyp wurde in die Erweiterung Semantic Maps ausgelagert die zusätzlich zur Basissoftware Semantic MediaWiki verfügbar ist. Bei Wikis, die diesen Datentyp einsetzen, muss vor der Aktualisierung auf SMW 1.5.1 die Erweiterung Semantic Maps in der Version 0.6 oder höher installiert werden, um Probleme zu vermeiden. Weitere Schritte sind im Zusammenhang mit diesem Datentyp nicht notwendig.
Die Auslagerung in die Erweiterung wurde deshalb vorgenommen, um die damit einhergehende Funktionen an einer Stelle zu konzentrieren sowie auf diese Weise eine einfache Nutzbarkeit und Weiterentwicklung der Software zu ermöglichen.
Bezüglich n-adischer-Attribute[edit]
Die Methode derartige Attribute auf deren Attributseiten anzugeben wurde im Vergleich zur Version SMW 1.4.3 und früher geändert. Es ist daher notwendig die Seiten zu all diesen Attributen zu ändern, um sie wie vorher nutzen zu können.
- Beispiel
Bis einschließlich der Version SMW 1.4.x wurden derartige Attribute durch ihren Datentyp beschrieben.
[[hat Datentyp::Seite; Ganzzahl; Zeichenkette]]
Es handelt sich um einen Datentyp der durch drei Feldern anderer vorgegebener Datentypen beschrieben ist.
In Version SMW 1.5.0 oder höher müssen die Zuordnungen auf der Attributseite selbst vorgenommen werden:
[[hat Datentyp::Datensatz]] [[hat Datenfeld::Seite; Ganzzahl; Zeichenkette]]
Alle n-adischen Attribute sind gehören nunmehr zum Datentyp Verbund. Die Informationen zu den im Datentyp vorhandenen Datenfeldern werden separat beschrieben.
- Aktualisierung
Im Rahmen der Aktualisierung auf SMW 1.5.0 oder höher müssen mehrere Schritte vorgenommen werden:
- Die neue Software installieren.
- Alle vorhandenen n-adischen Attribute mit der eingebetteten Abfrage {{#ask: [[hat Datentyp::~ *;*]] }} ermitteln.
- Alle Attributseiten analog der unter Beispiel angegebenen Änderungslogik aktualisieren.
- Gegebenenfalls müssen noch Datenreparaturen (Spezialseite „Spezial:SMW-Einrichtung“ → Abschnitt „Datenreparatur und -aktualisierung“ → Schaltfläche „Datenaktualisierung beginnen“) durchgeführt werden. Hierzu ist die „Auftragswarteschlange“ zu prüfen.
Nunmehr sollten alle Wert wie zuvor abrufbar sein. Je nachdem, entweder schon nach Schritt 3 oder erst nach Schritt 4. Sofern die Schritte 2 und 3 bereits vor Schritt 1 vorgenommen wurden, ist es unbedingt notwendig Schritt 4 durchzuführen.
Diese Änderung ermöglicht in der Zukunft zahlreiche Verbesserungen der SMW-Software an sich und neue sowie bessere Softwareerweiterungen.
Änderungen der Konfigurationseinstellungen[edit]
Verschiedene Konfigurationseinstellungen, die in der Datei LocalSettings.php vorgenommen werden, haben sich seit der Version SMW 1.0 verändert. Alle Konfigurationseinstellungen, die vorgenommen werden können, sind in Englischer Sprache auch in der Datei SMW_Settings.php dokumentiert. Die folgende Liste gibt die bislang aufgetretenen Änderungen und die Version von SMW an, mit der diese durchgeführt wurde. Sofern Sie mit einer höheren Version von Semantic MediaWiki eingestiegen sind, brauchen sie ältere Versionen betreffende Änderungen nicht mehr beachten.
- [SMW 1.4.3]
- Bis Version SMW 1.4.3 wurde die Einstellung $smwgSMWBetaCompatible unterstützt, um die inzwischen veraltet Abfragesyntax <ask> sowie den Namensraum „Relation“ aktivieren zu können. Diese Abwärtskompabilität der Software Semantic MediaWiki wurde nunmehr aufgegeben. Beim Einsatz der Versionen SMW 1.5.x und höher muss sichergestellt werden, dass das Wiki problemlos ohne diese Einstellung läuft und verwendet werden kann.
- [SMW 1.4.0]
- Bis Version SMW 1.4.0 war für die Einstellung $smwgQComparators der Standardwert '<|>|!'. Nunmehr ist dieser Standardwert zu '<|>|!|~' geändert worden, so dass der Komparator ~ „ähnlich“ („like“) standardmäßig aktiviert ist.
- Bei der Einstellung $smwgResultFormats wurden die Ausgabeformate 'timeline' => 'SMWTimelineResultPrinter' und 'eventline' => 'SMWTimelineResultPrinter' entfernt.
- [SMW 1.3]
- Seit Version SMW 1.3 wird die Faktenanzeige standardmäßig ausgeblendet und erscheint zukünftig nur in der Seitenvorschau und sofern dies entsprechend konfiguriert wurde. In der Nachfolge zur dieser Funktionalität wurde die Spezialseite „Spezial:Browse“ entwickelt, mit der die mit einer Wikiseite verknüpften Attribute angezeigt werden können. Der Link „Attribute anzeigen“, der zur Spezialseite führt, befindet sich an letzter Stelle im Navigationsbereich „Werkzeuge“ in der Navigationsleiste auf der linken Seite. Um die Faktenanzeige wie in den Versionen älter als SMW 1.3 anzuzeigen muss die Einstellung $smwgShowFactbox = SMW_FACTBOX_NONEMPTY; vorgenommen werden. Der Link zur Spezialseite „Spezial:Browse“ kann ebenso individuell angepasst werden. Diesbezügliche Hinweise in Englischer Sprache finden Sie in der Datei SMW_Settings.php.
- [SMW 1.2.1]
- Semantic MediaWiki unterstützt standardmäßig nicht mehr in semantische Attribute eingebettet Links, da dies zu Problemen führt. Um diese Funktionalität wieder zu aktivieren muss die Einstellung $smwgLinksInValues = true; vorgenommen werden.
- [SMW 1.2.0]
- Sofern Ihr Wiki noch die <ask>-Syntax oder den Namensraum „Relation“ verwendet sollten Sie die Einstellung $smwgSMWBetaCompatible = true; direkt vor der Zeile include_once("{$IP}/extensions/SemanticMediaWiki/includes/SMW_Settings.php"); in die Datei LocalSettings.php einfügen. Bitte erwägen Sie von <ask> auf #ask umzustellen, um sich von der Kompatibilität zu SMW 0.1 bis SWM 0.7 unabhängig zu machen.
- Sofern Sie die Einstellung $smwgQDisjunctionSupport = false; nutzen, müssen nun die folgenden Einstellungen zusätzlich in der Datei LocalSettings.php vorgenommen werden:
$smwgQFeatures = SMW_ANY_QUERY & ~SMW_DISJUNCTION_QUERY; $smwgQConceptFeatures = SMW_ANY_QUERY & ~SMW_DISJUNCTION_QUERY & ~SMW_CONCEPT_QUERY;
- [SMW 1.0.0]
- Die Einstellung von $smwgQEqualitySupport wurde nun von true oder false auf SMW_EQ_NONE, SMW_EQ_SOME oder SMW_EQ_FULL umgestellt. Die Standardeinstellung ist smwgQEqualitySupport = SMW_EQ_SOME;.
- Die Einstellung von $smwgQDefaultNamespaces ist nun NULL, so dass Abfragen nun alle Namensräume berücksichtigen. Vorher war die Standardeinstellung array(NS_MAIN, NS_IMAGE);.
- Die Einstellung $smwgQDefaultLinking lautet nun all, so dass nun alle Abfrageergebnisse eingebettete Links aufweisen. Diese Funktionalität führt nicht mehr zu Leistungseinschränkungen. Zuvor lautete die Standardeinstellung subject.
Sofern Sie momentan eine dieser Einstellungen in der Datei LocalSettings.php verwenden, ist es notwendig diese zu aktualisieren. Weitere Hinweise sowie die Dokumentation der möglichen Konfigurationseinstellungen in Englischer Sprache finden Sie in der Datei SMW_Settings.php