| Status: | effective |
| Progress: | 100% |
| Version: | 3.1.0+ |
Upgrade from SMW 2.5.x to SMW 3.1.x (MW 1.31.0 to MW 1.33.x)
| Installation | |
|---|---|
| This page describes the upgrade procedure from SMW 2.5.x to SMW 3.1.x (native Composer support). | |
| Further Information | |
| Installation type: | upgrade |
| Installation method: | Composer |
| MediaWiki version: | 1.31.0 to 1.33.x |
| Table of Contents | |
This help page describes the upgrade procedure from Semantic MediaWiki 2.5.x to Semantic MediaWiki 3.1.x with native Composer support.
- Note that this help page assumes that you use MediaWiki 1.31.0 to 1.33.x. See also the help page on compatibility.
- Since SMW 2.5.x is not compatible with 1.31.0 to 1.33.x you must either upgrade to SMW 3.0.x to SMW 3.1.x (preferred).
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 wiki1 in your server's shell and modify the "composer.local.json" file to look like this2:
{
"require": {
"mediawiki/semantic-media-wiki": "~3.1.0"
}
}
Step 3 - Update software
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
Add the following line to the end of your "LocalSettings.php" file:
enableSemantics( 'example.org' );
Note that "example.org" should be replaced by your wiki's domain.
Step 5 - Update database
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"No description was provided.:
php extensions/SemanticMediaWiki/maintenance/setupStore.php -v
Step 6 - Update database cont.
If you see the upgrade information error message on your wiki's pages run maintenance script "populateHashField.php"No description was provided. from the base directory of your wiki1 in your server's shell to apply further changes to your wiki's database:
php extensions/SemanticMediaWiki/maintenance/populateHashField.php -v
Step 7 - Rebuild data
Run maintenance script "rebuildData.php"No description was provided. from the base directory of your wiki1 in your server's shell to rebuild the semantic data in wiki's database:
php extensions/SemanticMediaWiki/maintenance/rebuildData.php -v --with-maintenance-log
Step 8 - Update configuration
Go to the "Deprecation notices" tab on special page "SemanticMediaWiki"No description was provided. 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.
See also
- Help page on upgrading
- Help page on using Composer
- Help page on troubleshooting
References
- a b c d e This is the directory which contains the "LocalSettings.php" file.
- ^ | 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.
- ^ | In case you installed Composer "globally" on your server, you will have to drop the
phpand.pharparticles from the command. - ^ | 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.
