Help:Installation/General notes

From semantic-mediawiki.org
Administrator manualInstallationHelp:Installation/General notes
  • Extension "Semantic MediaWiki"Semantic MediaWiki (SMW) is a free, open-source extension to MediaWiki that lets you store and query data within the wiki's pages. Semantic MediaWiki is also a full-fledged framework, in conjunction with many spinoff extensions, that can turn a wiki into a powerful and flexible knowledge management system. All data created within SMW can easily be published via the Semantic Web, allowing other systems to use this data seamlessly. has dependencies that will be made available during the installation.
  • Individual extensions to Semantic MediaWiki, e.g. extension "Semantic Result Formats"Provides additional formats for semantic queries may have different requirements.
  • Individual extensions to Semantic MediaWiki may not be compatible with the "~2.5" release (yet). Please see those extensions' documentation pages, or contact the respective developers, for further information.
  • To upgrade a wiki running an older version of Semantic MediaWiki, be sure to read the relevant section before starting the upgrade.
  • If you are using MediaWiki 1.23 and higher and/or PHP 5.4 and higher you are strongly encouraged to install or to update to Semantic MediaWiki 2.5.0Released on 14 March 2017 and compatible with MW 1.23.0 - 1.29.x. or higher. Semantic MediaWiki 2.4.6Released on 15 February 2017 and compatible with MW 1.19.0 - 1.28.x. and lower is discouraged for production use with these versions.
  • The ConfirmEdit1 extension is known to cause limitations in the functioning of Semantic MediaWiki when used on MediaWiki 1.26.x. You are advised to upgrade MediaWiki to version 1.27.0 or later.

Environment

  • Please always check the exact requirements and follow the instructions carefully. Make sure you understand the legal disclaimer in the file COPYING before proceeding.
  • It is required that the PHP mbstring extension is enabled (provides PHP mb_*() multibyte functions such as mb_strpos in the php_mbstring.dll). This is standard but not enabled by default on some distributions of PHP.
  • When using a SPARQL backend, Semantic MediaWiki and onoi/http-request requires access to the cURL functions of PHP. These functions may have to be enabled/installed to be available.
  • While not required (yet), it is suggested to have the PHP intl (ICU) extension enabled especially when Semantic MediaWiki is used in a UTF-8 (non-Latin) environment.
  • For users that require symbolic links, some information can be found here.

Settings

  • For installation and upgrade, Semantic MediaWiki needs the rights to create new tables (CREATE) and to alter tables (ALTER TABLE). You can remove both rights after Semantic MediaWiki is set up. The maintenance script setupStore.phpAllows to set up the data backend/store can use the DB credentials from "LocalSettings.php" for this purpose, avoiding the need of extra rights for the wiki DB user.
  • When using the configuration parameter $smwgDefaultStoreSets the storage backend to be used for the semantic data set to a SQL data backend (default), Semantic MediaWiki creates and alters temporary tables for certain semantic queries. To do this, the wiki's database user account must have privileges for CREATE TEMPORARY TABLES and DROP. If you don't wish to allow such privileges, please read how to disable the use of temporary tables in "LocalSettings.php".
  • Some notes and related settings for a multi-database environment
  • Webserver notes lists settings or limitations that are imposed by a specific webserver environment

Recommendations

  • Extended list of recommendations and settings
  • It is highly recommended to have the parser cache and Semantic MediaWiki specific cache enabled and set to appropriate values.
  • Information about regular maintenance tasks and the job queue can be found here.

References

  1. ^  Semantic MediaWiki: GitHub issue gh:smw:1406