Upgrading Mediawiki

Procedure

In the following instructions, eb_deploy refers to the shell script found in the littled_wiki project root. Note that eb_deploy is not the same thing as the command eb deploy. Use the shell script and not the eb command.

• Download new wiki distribution to littled_wiki project root.
  • Unzip the archive.
  • Make sure that all custom extensions listed in LocalSettings.php are present in the extensions folder of the new distribution.
• Edit eb_deploy.
  • Change WIKI_DISTRO_DIR to point to the directory containing the new wiki distribution.
• Make backup of previous wiki configuration
  • Backup the current wiki database.
  • Make sure to save a copy of the current LocalSettings.php for the wiki to migrate any custom settings to the new wiki distribution.
• Run eb_deploy.
• Connect to the wiki on the live server.
  • Go through the installation steps to create LocalSettings.php.
  • Download the newly created LocalSettings.php from the server to [littled_wiki_PROJECT_ROOT]/wiki_config/
• Migrate settings from previous LocalSettings.php to the new file.
  • Database settings, e.g. $wgDBServer = getenv('MEDIAWIKI_DB_SERVER');
  • Do not store any sensitive information in the configuration file.
  • Custom extensions which would be found at the very end of the file.

Troubleshooting

Extensions

BacktickCode

Enabling the BacktickCode extension in LocalSettings.php causes a 500 error.

Search for "Mediawiki backtick" will point to this page. The information on that page is out of date.

The current version of Mediawiki loads extensions with wfLoadExtension() not $wgHooks. Make sure the code for BacktickCode uses a class named BacktickCode and not $wgHooks.

Also, the current Mediawiki distribution requires an extension.json file in the extension directory. The directory without this file will result in a 500 error.

If the BacktickCode extension is causing 500 errors, it can be disabled by commenting out the wfLoadExtension('BacktickCode') call in LocalSettings.php.