Help:Installation/Using Tarball (without shell access)

There is also a help page on how to install on a Linux based server and install on a Windows based server (requires shell access). Please always check the exact requirements and follow the instructions carefully. Make sure you understand the legal disclaimer in the file COPYING before proceeding.

To upgrade a wiki running an older version of SMW, be sure to read the relevant section before starting the upgrade.

Requirements
Compatibility information and minimum requirements for Semantic MediaWiki are listed in the document on compatibility. Please make sure that you meet them prior to installing Semantic MediaWiki.

Download
Download a Semantic MediaWiki tarball and extract it into your extension directory.CiteRef::install:tarball:dir


 * List of releases with dependencies

Please choose one of the release files we prepared and uploaded for you that contain contain the dependencies for your deployment.

Tarball releases can only run by themselves, i.e. if you would like to also use other extensions like e.g. Semantic Result Formats or Semantic Maps you cannot use the tarball release. See the information on individual file releases for a possible way out.

Extract and copy
Extract the downloaded file.

Copy the extracted folder and files to the  directory of your MediaWiki installation.

Add the required settings to the end of the "LocalSettings.php" file:

Enable Semantic MediaWiki
Add optional settingsCiteRef::install:config to the "LocalSettings.php" file as desired below the required settings.

Run maintenance script
Run the setup script from the base directoryCiteRef::install:base:dir of your MediaWiki installation (i.e. not the extension's maintenance directory):

or



Log in as a user with administrator permission to your wiki and go to the page "Special:SMWAdmin":
 * 1) Click on the "Initialise or upgrade tables" button in the "Database installation and upgrade" section to setup the database. Note that this requires permissions to alter/create database tables, as explained at the top of this help page.
 * 2) Click on the "Start updating data" button in the "Data repair and upgrade" section to activate the automatic data update. Note that this takes some time; go to Special:SMWAdmin to follow its progress. SMW can be used before this completes, but will not have access to all data yet (e.g. page categories).

Check and verify
Navigate to "Special:Version" on your wiki to verify that the extension is successfully installed.

Test your installation as described on the help page about testing SMW.

Done!

Upgrading
Use these instructions to update an existing ≤ SMW 1.8.x installation from e.g. 1.8.0.5 to 1.9.0 etc.

Upgrading from SMW 1.8.x

 * 1) Backup your database and installation.
 * 2) Remove the formerly required invocation of "Validator" from the "LocalSettings.php" file, i.e. the following line:
 * 3) Re-install Semantic MediaWiki as described in the section on installing SMW though skipping step four and optionally step five.
 * 4) Log in as a user with administrator permission to your wiki and go to the page "Special:SMWAdmin".
 * 5) Click on the "Initialise or upgrade tables" button in the "Database installation and upgrade" section to setup the database. Note that this requires permissions to alter/create database tables, as explained at the top of this help page.
 * 6) Click on the "Start updating data" button in the "Data repair and upgrade" section to activate the automatic data update. Note that this takes some time; go to Special:SMWAdmin to follow its progress. SMW can be used before this completes, but will not have access to all data yet (e.g. page categories).
 * 7) Done!
 * 1) Done!

Upgrading from ≤ SMW 1.7.x
Please upgrade to SMW 1.8.0.5 first as described on the help page on upgrading to SWM 1.8.x.

Updating SMW 1.9.x
Use these instructions to update an existing SMW 1.9 installation from e.g. 1.9.0 to 1.9.1 etc.


 * 1) Download the file release of Semantic MediaWiki.
 * 2) Extract the downloaded file.
 * 3) Copy the extracted folder and files to the   directory of your MediaWiki installationCiteRef::install:tarball:folder
 * 4) Navigate to "Special:Version" on your wiki to verify that the extension is successfully installed.
 * 5) Log in as a user with administrator permission to your wiki and go to the page "Special:SemanticMediaWiki":
 * 6) Click on the "Initialize or upgrade tables" button in the "Database installation and upgrade" section to setup the database. Note that this requires permissions to alter/create database tables, as explained at the top of this help page.
 * 7) Once you receive the success message, click the back button to go back to the "Special:SemanticMediaWiki".
 * 8) Click on the "Start updating data" button in the "Data rebuild" section to activate the automatic data update. Note that this takes some time; go to "Special:SemanticMediaWiki" to follow its progress. SMW can be used before this completes, but will not have access to all data yet (e.g. page categories).
 * 9) Done!