Upgrade from SMW 3.2.x to SMW 4.0.x (MW 1.35.0 to MW 1.37.x)

From semantic-mediawiki.org
< Help:Upgrade
Administrator manualInstallationUpgradeUpgrade from SMW 3.2.x to SMW 4.0.x (MW 1.35.0 to MW 1.37.x)
Installation
This page describes the upgrade procedure from SMW 3.2.x to SMW 4.0.x (native Composer support).
Further Information
Installation type: upgrade
Installation method: Composer
MediaWiki version: 1.35.0 to 1.37.x
Table of Contents

This help page describes the upgrade procedure from Semantic MediaWiki 3.2.x to Semantic MediaWiki 4.0.x with native Composer support.

Note that this help page assumes that you use MediaWiki 1.35.0 to 1.37.x. See also the help page on compatibility.

Step 1 - Backup database and wiki[edit]

Backup your wiki database and wiki installation.

Step 2 - Update setup file[edit]

Change to the base directory of your wiki1 in your server's shell and modify the "composer.local.json" file to look like this2:

{
	"require": {
                  "mediawiki/semantic-media-wiki": "~4.0.0"
        }
}

Step 3 - Update software[edit]

Run the composer command34 from the base directory of your wiki1 in your server's shell to upgrade the source code of Semantic MediaWiki and dependencies:

php composer.phar update --no-dev

Step 4 - Invoke Semantic MediaWiki[edit]

BREAKING: As of Semantic MediaWiki 4.0.0Released on 18 January 2022 and compatible with MW 1.35.0 - 1.37.x. you need to add wfLoadExtension( 'SemanticMediaWiki' ); to LocalSettings.php !

Until SMW 3.2.x only enableSemantics( 'example.org' ); was used to invoke SMW.

This means that you need to add the following lines to the end of your "LocalSettings.php" file:

wfLoadExtension( 'SemanticMediaWiki' );
enableSemantics( 'example.org' );

Note that "example.org" should be replaced by your wiki's domain.

Step 5 - Update database[edit]

Run maintenance script "update.php" (MediaWiki.org) from the base directory of your wiki1 in your server's shell to apply the schema changes to your wiki's database:

php maintenance/update.php

Or alternatively use maintenance script "setupStore.php"Allows to set up the data backend/store:

php extensions/SemanticMediaWiki/maintenance/setupStore.php

Done![edit]

Semantic MediaWiki and the database use should now be upgraded properly. The wiki may now be used again.

See also[edit]


References

  1. a b c  This is the directory which contains the "LocalSettings.php" file.
  2. ^  | |  This help page assumes that your are only upgrading Semantic MediaWiki. In case you installed further extensions to Semantic MediaWiki the "composer.local.json" needs to be adapted accordingly. See an example.
  3. ^  | |  In case you installed Composer "globally" on your server, you will have to drop the php and .phar particles from the command.
  4. ^  | |  This help page assumes that the "composer.phar" file is located in the base directory of your wiki. If not the path to the "composer.phar" file needs to be adapted to the server's situation.