Help:Upgrade

From semantic-mediawiki.org
Error produced by the upgrade and setup consistency check
Messages displayed to a user caused by an incomplete upgrade

Starting with Semantic MediaWiki 3.0.0Released on 11 October 2018 and compatible with MW 1.27.0 - 1.31.x.1 and extended with Semantic MediaWiki 3.0.1Released on 25 January 2019 and compatible with MW 1.27.0 - 1.31.x.2, the software is checking the consistency of its database schema during upgrades (and also at installation) using an upgrade key as well as other status information, e.g. for the completion of populating the hash fields for the object IDs3.

If an update contains changes to the database schema (e.g. a new field, index, etc.), or if the content of related $smwgFixedProperties and/or $smwgPageSpecialProperties is altered then it is required to either run the update.php or alternatively Semantic MediaWiki's setupStore.php.

See also[edit]

  • Upgrade and setup consistency check was introduce to validate the status of the database and settings that influence the "shape" of its tables and indices.
  • Incomplete upgrade describes situation where an incomplete state requires additional intervention from an administrator
  • Setup information file ".smw.json" is used to store information about the upgrade and setup consistency check as well as tasks that compromise an incomplete upgrade.

Notes[edit]

The setup information file ".smw.json" is essential to monitor the upgrade progress, the installation in general, and any other changes that might appear during the extension life-cycle while being enabled on a wiki. In cases where the file is no longer accessible, was manually changed, or removed, the "Upgrade Error Screen" will appear until it is re-generated and contains required information.

How to upgrade?[edit]


References

  1. ^  Semantic MediaWiki: GitHub pull request gh:smw:3095
  2. ^  Semantic MediaWiki: GitHub pull request gh:smw:3611
  3. ^  Semantic MediaWiki: GitHub pull request gh:smw:3080