Help:Upgrade/Upgrade from SMW 2.5 to SMW 3.1

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

Step 1 - Backup database and wiki
Backup your wiki database and wiki installation.

Step 2 - Update setup file
Change to the base directory of your wikiCiteRef::install:base:dir in your server's shell and modify the "composer.local.json" file to look like thisCiteRef::install:software:

Step 3 - Update software
Run the composer commandCiteRef::install:composerCiteRef::install:composer:base from the base directory of your wikiCiteRef::install:base:dir in your server's shell to upgrade the source code of Semantic MediaWiki and dependencies:

Step 4 - Invoke Semantic MediaWiki
Add the following line to the end of your "LocalSettings.php" file:

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

Step 5 - Update database
Run from the base directory of your wikiCiteRef::install:base:dir in your server's shell to apply the schema changes to your wiki's database: Or alternatively use :

Step 6 - Update database cont.
If you see the upgrade information error message on your wiki's pages run from the base directory of your wikiCiteRef::install:base:dir in your server's shell to apply further changes to your wiki's database:

Step 7 - Rebuild data
Run from the base directory of your wikiCiteRef::install:base:dir in your server's shell to rebuild the semantic data in wiki's database:

Step 8 - Update configuration
Go to the "Deprecation notices" tab on and update your wiki's "LocalSettings.php" file according to the information provided on that page.

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