Status: | effective |
Progress: | 100% |
Version: | 3.2.0+ |
Help:Upgrade key
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:
-
$smwgUpgradeKey
Sets the current database schema version -
$smwgDefaultStore
Sets the storage backend to be used for the semantic data -
$smwgPageSpecialProperties
Sets the page related special properties to be used -
$smwgFixedProperties
Sets user defined properties to have a dedicated database table for them -
$smwgEnabledFulltextSearch
Sets whether full-text search support for properties may be used -
$smwgFieldTypeFeatures
Sets relational database specific field type features -
$smwgEntityCollation
No description was provided.2 Setup::MINIMUM_DB_VERSION
3
Technical notes
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"No description was provided..
A release manager may also modify the upgrade key setting in the "DefaultSettings.php" file to ensure that installs (or upgrades) with a new release do run either maintenance script "update.php" (MediaWiki.org) or maintenance script "setupStore.php"No description was provided..
See also
- Help page on the setup information file
- Help page on configuration parameter
$smwgConfigFileDir
Sets the directory for storing the setup information file ensuring database consistency – Defines the location to which the setup information file is written - Help page on configuration parameter
$smwgUpgradeKey
Sets the current database schema version – An internal key that allows developers to indicate that a change of the database has occurred/is required - File:Octocat.png "SetupFile.php" file. – Contains details on how the upgrade key is generated