View source for Help:Maintenance script updateEntityCountMap.php

{{Maintenance script
 |minimum version=3.2.0
 |display title=update&shy;Entity&shy;Count&shy;Map.php
 |script name=updateEntityCountMap.php
 |description=Allows to do mass populating of database field "smw_countmap" when initially upgrading to Semantic MediaWiki 3.2.0 and later
}}
The&nbsp;'''"updateEntityCountMap.php"''' [[Help:Maintenance scripts|maintenance script]] allows to do mass populating of [[Field:smw_countmap|database field "smw_countmap"]] in the [[Table:smw_object_aux|"smw_object_aux" database table]] when initially upgrading to {{Release|3.2.0}} or later and only has to be run once. As soon as you have successfully upgraded it will no longer be necessary to use it. The maintenance script was introduced in {{Release|3.2.0}}.[[CiteRef::gh:smw:4613]]

== Note ==
During an upgrade to {{Release|3.2.0}} and later the newly created database field "smw_countmap" in the "smw_object_aux" database table initially needs to be populated with data. However due to the sheer size of the "smw_object_aux" database table the update of database field "smw_countmap" could hog resources making {{MaintenanceScript|update.php|mwo=1}} or alternatively {{MaintenanceScript|setupStore.php}} run for a considerable time. To mitigate this the initial population using this maintenance script is run in a second step during the upgrade.

The need for running this maintenance script is visibly displayed by an error message on every page of the wiki informing that the wiki's system administrator still has to run the script to complete the upgrade. Once this maintenance script was run as a follow up to "update.php" or alternatively "setupStore.php" the will no longer appear and the upgrade of the software was completed.

== Usage ==
<syntaxhighlight lang="bash">
php extensions/SemanticMediaWiki/maintenance/updateEntityCountMap.php
</syntaxhighlight>

== Parameters ==
Maintenance scripts provide [[Help:Maintenance scripts/Generic parameters|generic maintenance parameters]], [[Help:Maintenance scripts/Script dependent parameters|script dependent parameters]] and depending on the maintenance script script specific parameters which are described on this page if provided.
{{Callout
 |This script does not provide any script specific parameters.
 |info
}}

== Example ==
{{#ask:
 [[Has parent page::{{FULLPAGENAME}}]]
 |?Subpage
 |format=ul
 |sort=
 |order=descending
}}

== See also ==
* Help page on [[Help:Upgrade|upgrading]]
* Help page on [[Help:Upgrade/Incomplete upgrade|incomplete upgrade checking]]
* Help page on [[Field:smw_countmap|database field "smw_countmap"]]
* Help page on {{MaintenanceScript|setupStore.php}}
* Help page on {{MaintenanceScript|update.php|mwo=1}}
* Help page on [[Help:Setup information file|setup information file ".smw.json"]]

<div style="display: none">
{{#scite:gh:smw:4613
 |type=pullrequest
 |url=https://github.com/SemanticMediaWiki/SemanticMediaWiki/pull/4613
}}
{{doc.info
 |master page=Help:Maintenance_script_updateEntityCountMap.php
 |status=effective
 |progress=100
 |priority=2
 |minversion=3.2.0
}}
</div>
[[Category:I18n reference page]]