Disclaimer

This blog is kind of my own personal work Notebook, and the processes below are only guaranteed to work for my specific configurations. So, use this info at your own risk, and please understand I won't be able to provide any help if you break something

Sunday, November 26, 2023

Maintenance scripts to run after a MediaWiki migration / update

Migrating or updating a MediaWiki installation is a significant task that requires careful attention to detail to ensure smooth operation and data integrity. 

Here are some of the most important maintenance scripts to run after a MediaWiki migration or update:

  • update.php: This is arguably the most crucial script to run after an update. It updates the MediaWiki database schema to the latest version. Failing to run this script can result in database errors or a non-functioning wiki.
  • rebuildall.php: This script helps in rebuilding various secondary storage structures, including search indexes, recent changes, and more. It's particularly useful if there's been a significant change in the data structure or storage engine.
  • runJobs.php: MediaWiki defers some tasks to be executed later by job queue. After an update or migration, it’s important to make sure that any pending jobs are processed, as they might include tasks essential for the wiki's functionality.
  • refreshLinks.php: This script updates the links tables, which store information about what pages link to each other. It's essential for maintaining the integrity of internal links and backlinks, especially after large-scale content migration.
  • rebuildtextindex.php: If you’re using MediaWiki's built-in search engine, this script will rebuild the full-text search index. This is crucial for ensuring that the search function works correctly post-migration.
  • initSiteStats.php: This script recalculates and updates site statistics, such as the number of articles, files, users, page views, etc. It's important for keeping track of the growth and usage of your wiki.
  • rebuildrecentchanges.php: This script rebuilds the recent changes table. It’s particularly useful if there have been significant changes to the wiki's content or structure.
  • checkImages.php: Use this script to check the consistency of images and image metadata, ensuring that all files are correctly stored and accessible.
  • rebuildFileCache.php: If you're using file caching, this script will help regenerate the cache, which is important for performance, especially on high-traffic wikis.
  • cleanupUsersWithNoId.php: This script cleans up users who don't have an ID in the user table, which might happen during migrations.
  • cleanupSpam.php: If your wiki is public and allows user contributions, this script can help clean up spam pages.
  • updateSearchIndex.php: In case you've made significant changes to the content, running this script will update the search index to reflect the new state of the wiki.

No comments:

Post a Comment