Help:Installation (de)

From semantic-mediawiki.org
Jump to: navigation, search
Semantic MediaWiki-
Administratorenanleitung
Herunterladen
Installation
Konfiguration
Konzeptcaching
Saubere URIs
SPARQL und RDF-Speicher
Fehlerbehandlung
Datenreparatur
Softwareerweiterungen
Basiserweiterungen

SMW-Erweiterungen

Semantic MediaWiki-
Nutzeranleitung

Auf dieser Seite wird beschrieben wie man Semantic MediaWiki 1.7.0 installiert, nachdem man die erforderliche Software 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 anfangen.

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

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

oder 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 
 $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

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 Archivdateien erhält man die Ordner „SemanticMediaWiki“ sowie „Validator“ die alle benötigten Dateien beinhalten. Diese Ordner müssen 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. Alternativ kann man die Dateien auch über Subversion (SVN) mit einem Subversion-Client kopieren.

(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 zusätzliche Namensräume, standardmäßig mit den Nummern 102 bis 109. Die Namensräume 104 und 105 werden nur für den Fall genutzt, sofern der Parameter $smwgHistoricTypeNamespace mit true gesetzt wurde. Seit SMW 1.6.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 als 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 LocalSettings.php entsprechend angepasst anzugeben. Dies wird in der Regel dann der Fall sein, wenn Sie selbstdefinierte Namensräume einsetzen.

(3) Software aktivieren:
Hierzu werden die folgenden drei Codezeilen in die Datei „[Pfad zur MediaWiki-Installation]/LocalSettings.php“ eingefügt. 

require_once( "$IP/extensions/Validator/Validator.php" );
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ährend dieses Prozesses genutzt werden, allerdings hat man nicht Zugriff auf alle Daten, wie bspw. Kategorien.

Spezial:SMW-Administration (SMW-Einrichtung)
SMW wurde erfolgreich eingerichtet
SMW wurde erfolgreich getestet
Testen der Installation

Sofern Sie unsicher sind, ob die Installation korrekt abgelaufen ist, können Sie diesbezüglich ein paar entsprechende Tests durchführen:

  1. Zunächst können Sie auf der Spezialseite „Spezial:Version“ nachschauen, ob Semantic MediaWiki im Abschnitt „Installierte Erweiterungen“ oben unter „Semantische Erweiterungen“ aufgeführt wird.
  2. 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

Bitte beachten Sie die seit SMW 1.6.0 bestehende Abhängigkeit von der Softwareerweiterung Validator, die von SMW dazu eingesetzt wird, benutzerdefinierte Parameter zu validieren. Die Installation dieser Softwareerweiterung ist zwingend für den Betrieb von SMW notwendig. Validator wird gebündelt mit SMW zum Herunterladen bereitgestellt. Über SVN muss der Code der Software allerdings jeweils separat abgerufen werden.

Von den Versionen SMW 1.6.x

Bestehenden Installationen von von SMW 1.6.x können aktualisiert werden indem man die Programmdateien auf dem Server ersetzt. Die Softwareerweiterungen zu SMW, die mit der Version 1.6.x kompatibel waren, sollten ebenso mit dieser Version kompatibel. Bitte prüfen Sie dennoch dahingehend die Dokumentationsseiten der entsprechenden Softwareerweiterung. Sofern dies nicht bereits 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");

ersetzen. Die Verwendung der Datei SMW_Settings.php ist nicht mehr möglich.

Anschließend muss sowohl eine Datenbankaktualisierung wie auch eine Datenaktualisierung durchgeführt werden. Loggen Sie sich hierzu 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 starten“ 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ährend dieses Prozesses genutzt werden, allerdings hat man nicht auf alle Daten wie bspw. Kategorien Zugriff.

Von den Versionen SMW 1.5.x

Es wird empfohlen die bestehenden Installationen zunächst auf die Version SMW 1.6.1 zu aktualisieren (siehe die Beschreibung an dieser Stelle) und in einem zweiten Schritt die weitere Aktualisierung vorzunehmen.

Änderungen der Konfigurationseinstellungen

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. 

$smwgQFeatures        = SMW_ANY_QUERY & ~SMW_DISJUNCTION_QUERY;
$smwgQConceptFeatures = SMW_ANY_QUERY & ~SMW_DISJUNCTION_QUERY & ~SMW_CONCEPT_QUERY;

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


Diese Dokumentationsseite gilt für alle SMW-Versionen von 1.7.0 bis zur aktuellsten Version.
Andere Versionen: 1.6.0 – 1.6.2, 1.5.3 – 1.5.3, 1.5.2 – 1.5.2, 1.5.1 – 1.5.1, 1.5.0 – 1.5.0       Andere Sprachen: en, zh-hans

Help:Installation de 1.7.0


Retrieved from "http://semantic-mediawiki.org/wiki/Help:Installation_(de)"
Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox