Con­figu­ration para­meter "$smwg­Upgrade­Key"

From semantic-mediawiki.org
Configuration parameter details:
Name $smwgUpgradeKey
Description Sets the current database schema version
Default setting See below
Software Semantic MediaWiki
Since version
Until version still available
Configuration Installation
Keyword data store · setup · upgrade · update

$smwgUpgradeKey is a configuration parameter that Sets the current database schema version. The configuration parameter was introduced in Semantic MediaWiki 3.0.0Released on an unknown date and compatible with MW 1.27.0 - 1.30.x..12

This configuration parameter must not be modified manually.

The setting to this configuration parameter verifies that a complete setup, update or upgrade using maintenance script setupStore.phpAllows to set up the data backend/store or maintenance script update.php (MediaWiki.org) was done and hereby ensures a consistent database setup.

This is done by validating the status of the database by comparing the local result of the ".smw.json" file against the upgrade key. If the ".smw.json" file does not exist or contains an invalid key then the system stops before it can access any data or tables. At the same time it shows a message to the user such as:

Error: Semantic MediaWiki was installed and enabled but is missing an appropriate upgrade key. Please run MediaWiki's "update.php" or Semantic MediaWiki's "setupStore.php" maintenance script first.

Whenever a database table change occurs, the setting to this configuration parameter (DB-YYYY-MM) is changed by the programmers of 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. to reflect the requirement for the wiki administratore to follow the processes as outlined in the installation, update and upgrade manual.

Once the installer is run, the ".smw.json" file will be updated and no longer causes the exception described.


References

  1. ^  Semantic MediaWiki: GitHub pull request gh:smw:3095
  2. ^  Semantic MediaWiki: GitHub pull request gh:smw:3100