This wiki is being moved to a new server and cannot be edited. Please sit tight. Thank you.

Maintenance script "setup­Store.php"

From semantic-mediawiki.org
setupStore.php
Allows to set up the data backend/store
Further Information
Provided by: Semantic MediaWiki
Added: 2.0.0
Removed: still in use
Location (path): ./extensions/SemanticMediaWiki/maintenance/
Table of Contents

The "setupStore.php" is a maintenance script sets up the storage backend currently selected in the "LocalSettings.php" file or the default data backend (store) if no other backend was selected.

This maintenance script deprecated the former "SMW_setup.php" script starting with Semantic MediaWiki 1.9.2Released on 18 April 2014 and compatible with MW 1.19.0 - 1.22.x. which was removed with the release of Semantic MediaWiki 3.0.0Released on 11 October 2018 and compatible with MW 1.27.0 - 1.31.x. in October 2018. When upgrading to Semantic MediaWiki 3.0.0Released on 11 October 2018 and compatible with MW 1.27.0 - 1.31.x. the migration to this script must be done.

Usage[edit]

php setupStore.php [--password|--delete|--backend|--nochecks|--skip-optimize|--skip-import] [backend]
This only shows the script specific parameters.

Parameters[edit]

Maintenance scripts provide generic maintenance parameters, script dependent parameters and depending on the maintenance script script specific parameters which are described on this page if provided.

Script specific parameters
Parameter Description
-password The password for the user account
NoteNote: Specifying user credentials in a command line call will usually store them within the shell history file.
--delete Delete all semantic data, uninstall the selected storage backend. This is useful when moving to a new storage engine, and in the rare case of unsinstalling Semantic MediaWiki. Deleted data can be recreated using this script (setup) followed by maintenance script "rebuildData.php"Allows to rebuild all the semantic data for a selected data backend/store (rebuild) but this may take some time.
--backend [backend] Execute the operation for the storage backend of the given name. For instance "SMWSQLStore3" or "SMWSQLStore2".
--nochecks When specified, no prompts are provided. Deletion will thus happen without the need to provide any confirmation.
--skip-optimize1 When specified the key distribution is not being analyzed, optimized and stored. Thus the internal query planner cannot determine the most efficient execution for queries.
--skip-import1 When specified, the import process of default or custom vocabularies is not being done.


Examples[edit]

The following command verbosely creates the tables to be used by the default backend.
php setupStore.php
The following command verbosely deletes existing tables used by the "SMWSQLStore2" backend after prompting for confirmation.
php setupStore.php --delete --backend SMWSQLStore2
The following command skips the database optimization process.
php setupStore.php --skip-optimize
The following command skips the import of vocabularies while still doing the database optimization process.
php setupStore.php --skip-import
This is best used on a regular basis to assure optimal wiki health.

See also[edit]

References

  1. a b  Semantic MediaWiki: GitHub pull request gh:smw:2801