View source for Help:Upgrade/Upgrade from SMW 3.1 to SMW 3.2

{{Installation
 |Displaytitle=Upgrade from SMW 3.1.x to SMW 3.2.x (MW 1.31.0 to MW 1.35.x)
 |Description=This page describes the upgrade procedure from SMW&nbsp;3.1.x to SMW&nbsp;3.2.x (native Composer support).
 |Installation type=upgrade
 |Installation method=Composer
 |video=
 |mediawikiMinVersion=1.31.0 to 1.35.x
}}
This help page describes the '''upgrade procedure''' from Semantic MediaWiki 3.1.x to Semantic MediaWiki 3.2.x with native [[Help:Using Composer|Composer support]].

{{Callout
 |Note that this help page assumes that you use MediaWiki '''1.31.0 to 1.35.x'''. See also the help page on [[Help:Compatibility|compatibility]].
 |info
}}

== 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 wiki[[CiteRef::install:base:dir]] in your server's shell and modify the "composer.local.json" file to look like this[[CiteRef::install:software]]:
<syntaxhighlight lang="json">
{
	"require": {
                  "mediawiki/semantic-media-wiki": "~3.2.0"
        }
}
</syntaxhighlight>

== Step 3 - Update software ==
Run the composer command[[CiteRef::install:composer]][[CiteRef::install:composer:base]] from the base directory of your wiki[[CiteRef::install:base:dir]] in your server's shell to upgrade the source code of Semantic MediaWiki and dependencies:
<syntaxhighlight lang="json">
php composer.phar update --no-dev
</syntaxhighlight>

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

<syntaxhighlight lang="php">
enableSemantics( 'example.org' );
</syntaxhighlight>

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

== Step 5 - Update database ==
Run {{MaintenanceScript|update.php|mwo=1}} from the base directory of your wiki[[CiteRef::install:base:dir]] in your server's shell to apply the schema changes to your wiki's database:
<syntaxhighlight lang="json">
php maintenance/update.php
</syntaxhighlight>
Or alternatively use {{MaintenanceScript|setupStore.php}}:
<syntaxhighlight lang="json">
php extensions/SemanticMediaWiki/maintenance/setupStore.php
</syntaxhighlight>

== Step 6 - Update entity count map ==
Run {{MaintenanceScript|updateEntityCountMap.php}} from the base directory of your wiki[[CiteRef::install:base:dir]] in your server's shell to rebuild the semantic data in wiki's database:
<syntaxhighlight lang="json">
php extensions/SemanticMediaWiki/maintenance/updateEntityCountMap.php
</syntaxhighlight>

== Step 7 - Rebuild data ==
Run {{MaintenanceScript|rebuildData.php}} from the base directory of your wiki[[CiteRef::install:base:dir]] in your server's shell to rebuild the semantic data in wiki's database:
<syntaxhighlight lang="json">
php extensions/SemanticMediaWiki/maintenance/rebuildData.php -v --with-maintenance-log
</syntaxhighlight>

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

== See also ==
* Help page on [[Help:Upgrade|upgrading]]
* Help page on [[Help:Using Composer|using Composer]]
* Help page on [[Help:Installation/Troubleshooting|troubleshooting]]

{{#set: Docinfo_language =en }}
{{doc.info
 |master page=Help:Upgrade/Upgrade_from_SMW_3.1_to_SMW_3.2
 |status=effective
 |progress=100
 |priority=1
 |minversion=3.2.0
}}
[[Category:Upgrade]]