Help:Upgrade key

From semantic-mediawiki.org
Error output when the setup check found an invalid upgrade key and blocks access to the wiki instance

The upgrade key is an internally generated key1 (stored as upgrade_key in the setup information file ".smw.json") to make a setup (or installation) comparable with a previous instance of the software. It provides the means to detect changes in Semantic MediaWiki that requires a system administrator to take appropriate actions before the setup check can release the block and before users start to interact with the software to ensure the integrity of the installed Semantic MediaWiki.

The key is generated from multiple sources that shape the database setup in terms of what sort of tables or fields (and indices) are required and currently include:

Technical notes[edit]

Software developers may modify the upgrade key directly to indicate that something has changed in regards to the internal database structure hereby ensures a new key is generated hereby forces the next install (or upgrade) to run either maintenance script "update.php" (MediaWiki.org) or maintenance script "setupStore.php"Allows to set up the data backend/store.

A release manager may also modify the upgrade key setting in the "DefaulSettings.php" file to ensure that installs (or upgrades) with a new release do run run either maintenance script "update.php" (MediaWiki.org) or maintenance script "setupStore.php"Allows to set up the data backend/store.

See also[edit]


References

  1. ^  Semantic MediaWiki: GitHub pull request gh:smw:3095
  2. ^  Semantic MediaWiki: GitHub pull request gh:smw:4713
  3. ^  Semantic MediaWiki: GitHub pull request gh:smw:4461