Editing TEHCC Wiki:Maintenance
Jump to navigation
Jump to search
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
{{#arraydefine:phpcommand|php}}<!-- Load with any special directory specifying required to access desired version of php --> | {{#arraydefine:phpcommand|php}}<!-- Load with any special directory specifying required to access desired version of php --> | ||
'''Note!''' On the command line, you no longer need to specify the location of the latest version of php. When it calls for <kbd>php</kbd> you simply use <kbd>{{#arrayprint:phpcommand}}</kbd>. | |||
'''Note!''' | |||
==System Maintenance== | ==System Maintenance== | ||
===Upgrade/Reinstall=== | ===Upgrade/Reinstall=== | ||
Use to upgrade across major versions or to reinstall | Use to upgrade across major versions or to reinstall a borked install | ||
# Get MediaWiki (per [https://www.mediawiki.org/wiki/Manual:Upgrading MediaWiki site]) | # Get MediaWiki (per [https://www.mediawiki.org/wiki/Manual:Upgrading MediaWiki site]) | ||
## Download desired version | ## Download desired version [https://www.mediawiki.org/wiki/Download MediaWiki Site] using <kbd>wget</kbd> to the home directory | ||
## Unpack using <kbd>tar -xvzf</kbd> (''e.g.'', <code>tar -xvzf '' | ## Unpack using <kbd>tar -xvzf</kbd> (''e.g.'', <code>tar -xvzf ''mediawiki stable release number.tar.gz''</code>) | ||
## Delete zipped tarball (''e.g.'', <code>rm '' | ## Delete zipped tarball (''e.g.'', <code>rm ''mediawiki stable release number.tar.gz''</code>) | ||
# Copy customized files to new install (per [https://www.mediawiki.org/wiki/Manual:Upgrading MediaWiki site]) | # Copy customized files to new install (per [https://www.mediawiki.org/wiki/Manual:Upgrading MediaWiki site]) | ||
## Copy Localsettings.php (''e.g.'', <code>cp | ## Copy Localsettings.php (''e.g.'', <code>cp public_html/clubwiki/LocalSettings.php ~/''mediawiki stable release number''/</code>) | ||
## Copy Images folder (''e.g.'', <code>cp -R public_html/clubwiki/images/ ~/''mediawiki stable release number''/</code>) | |||
## Copy Images folder (''e.g.'', <code>cp -R | ## Copy kml folder (''e.g.'', <code>cp -R public_html/clubwiki/kml/ ~/''mediawiki stable release number''/</code>) | ||
## Copy | |||
# Move over to new install (per [https://www.mediawiki.org/wiki/Manual:Upgrading MediaWiki site]) | # Move over to new install (per [https://www.mediawiki.org/wiki/Manual:Upgrading MediaWiki site]) | ||
##Move the existing installation to a temporary backup folder <code>mv ~/public_html/clubwiki/ OLD.yyyymmdd.clubwiki</code> | ##Move the existing installation to a temporary backup folder <code>mv ~/public_html/clubwiki/ ~/OLD.yyyymmdd.clubwiki</code> | ||
## Move the new installation to the public folder <code>mv '' | ## Move the new installation to the public folder <code>mv ~/''mediawiki stable release number'' ~/public_html/clubwiki</code> | ||
# | # Install extensions/handlers | ||
# | ## [https://getcomposer.org/download/ Composer] - per [https://www.mediawiki.org/wiki/Composer/For_extensions Mediawiki] site in wiki root folder, run <code>Web host doesn't like my link to get composer command</code> then <code>php composer.phar self-update</code> | ||
# Lessons of the past... | ## Add composer based extensions to requirements list, create as needed <code>vi composer.local.json</code> - Ensure you specify the most recent/desired versions | ||
## If upgrade stalls to white screen, likely a specified extension is not installed, check list and add as needed | ### [https://www.semantic-mediawiki.org/wiki/Help:Installation/Quick_guide Semantic MediaWiki] - whole site revolves around it | ||
# | ### [https://github.com/JeroenDeDauw/Maps/blob/master/INSTALL.md Maps] - For the embedded interactive maps | ||
### [https://www.semantic-mediawiki.org/wiki/Semantic_Result_Formats Semantic result formats] - permits semantic queries to other formats, I know array type is used by complex templates but I'm sure others have been used as well | |||
### [https://www.mediawiki.org/wiki/Extension:Semantic_Compound_Queries Semantic Compound Queries] - permits advanced queries notably used in complex map templates | |||
## Update/install specified extensions using composer <code>php composer.phar update --no-dev</code> | |||
## [https://www.mediawiki.org/wiki/Extension:NumberFormat NumberFormat] - Download extension and extract into the extension directory <code>tar -xzf extension.tar.gz -C ~/public_html/clubwiki/extensions/</code> | |||
## [https://www.mediawiki.org/wiki/Extension:Page_Forms/Download_and_installation Page Forms] - Download extension and extract into the extension directory <code>tar -xzf extension.tar.gz -C ~/public_html/clubwiki/extensions/</code> | |||
## [https://www.mediawiki.org/wiki/Extension:Arrays Arrays] - Simple extension download. Used for array manipulation in templates | |||
## [https://www.mediawiki.org/wiki/Extension:Header_Tabs Header Tabs] - Allows turning form pages (or really any page) into tabbed pages | |||
## [https://www.mediawiki.org/wiki/Extension:MyVariables MyVariables] - Allows referencing logged in user for form automation | |||
## {https://www.mediawiki.org/wiki/Extension:SimpleTable SimpleTable] - Allows simple table definition, specifically easily working with a CSV list, install by creating file as specified | |||
# Run Mediawiki upgrade or command line update (per [https://www.mediawiki.org/wiki/Manual:Upgrading MediaWiki site]) | |||
## Lessons of the past... | |||
### If upgrade stalls to white screen, likely a specified extension is not installed, check list and add as needed | |||
# Done! (May need to ctrl-shift-R to force reload pages to avoid seeing errors) | |||
===Update MediaWiki=== | ===Update MediaWiki=== | ||
Line 72: | Line 40: | ||
# Download patch from the [http://dumps.wikimedia.org/mediawiki/ dumps site] | # Download patch from the [http://dumps.wikimedia.org/mediawiki/ dumps site] | ||
# <kbd>cd</kbd> to <code>cd ~/public_html/clubwiki/</code> directory (the one with LocalSettings.php). | # <kbd>cd</kbd> to <code>cd ~/public_html/clubwiki/</code> directory (the one with LocalSettings.php). | ||
# Download (<kbd>wget</kbd>) the patch file from the [http://dumps.wikimedia.org/mediawiki/ dumps site] and <kbd>gunzip</kbd> it <code>gunzip '' | # Download (<kbd>wget</kbd>) the patch file from the [http://dumps.wikimedia.org/mediawiki/ dumps site] and <kbd>gunzip</kbd> it <code>gunzip ''mediawiki stable release number.patch''.gz</code>. | ||
# Use <code>patch -p1 --dry-run</code> to check what will be changed (''e.g.'', <code>patch -p1 --dry-run -i '' | # Use <code>patch -p1 --dry-run</code> to check what will be changed (''e.g.'', <code>patch -p1 --dry-run -i ''mediawiki stable release number.patch''</code>) | ||
# If all is well, run <kbd>patch</kbd> again without <code>--dry-run</code> | # If all is well, run <kbd>patch</kbd> again without <code>--dry-run</code>. | ||
# Check [[Special:Version]] and you should see the new version number in place. | # Check [[Special:Version]] and you should see the new version number in place. | ||
# Delete patch files <code>rm '' | # Delete patch files <code>rm ''mediawiki stable release number.patch''*</code> | ||
===Update extensions=== | ===Update extensions=== | ||
Line 90: | Line 57: | ||
## [https://github.com/SemanticMediaWiki/SemanticResultFormats/blob/master/RELEASE-NOTES.md Semantic Result Formats] | ## [https://github.com/SemanticMediaWiki/SemanticResultFormats/blob/master/RELEASE-NOTES.md Semantic Result Formats] | ||
## [https://github.com/SemanticMediaWiki/SemanticCompoundQueries/blob/master/RELEASE-NOTES.md Semantic Compound Queries] | ## [https://github.com/SemanticMediaWiki/SemanticCompoundQueries/blob/master/RELEASE-NOTES.md Semantic Compound Queries] | ||
## Rerun composer update if there were any updates to perform <code>{{#arrayprint:phpcommand}} composer.phar update --no-dev</code> | ## Rerun composer update if there were any updates to perform <code>{{#arrayprint:phpcommand}} composer.phar update --no-dev</code> | ||
# Manual extensions - Go to [[Special:Version]] and compare what's shown on extension page | # Manual extensions - Go to [[Special:Version]] and compare what's shown on extension page | ||
## [https://www.mediawiki.org/wiki/Extension:NumberFormat NumberFormat] - Download needed updates and extract into the extension directory <code>tar -xzf extension.tar.gz -C public_html/clubwiki/extensions/</code> | ## [https://www.mediawiki.org/wiki/Extension:NumberFormat NumberFormat] - Download needed updates and extract into the extension directory <code>tar -xzf extension.tar.gz -C public_html/clubwiki/extensions/</code> | ||
## [https://www.mediawiki.org/wiki/Extension:Page_Forms/Download_and_installation Page Forms] - Download extension and | ## [https://www.mediawiki.org/wiki/Extension:Page_Forms/Download_and_installation Page Forms] - Download extension and extract into the extension directory <code>tar -xzf extension.tar.gz -C public_html/clubwiki/extensions/</code> | ||
## [https://www.mediawiki.org/wiki/Extension:Arrays Arrays] - Upload new version into extension folder | ## [https://www.mediawiki.org/wiki/Extension:Arrays Arrays] - Upload new version into extension folder | ||
## [https://www.mediawiki.org/wiki/Extension:Header_Tabs Header Tabs] - Upload new version into extension folder | ## [https://www.mediawiki.org/wiki/Extension:Header_Tabs Header Tabs] - Upload new version into extension folder | ||
## [https://www.mediawiki.org/wiki/Extension:MyVariables MyVariables] - Upload new version into extension folder | ## [https://www.mediawiki.org/wiki/Extension:MyVariables MyVariables] - Upload new version into extension folder | ||
## [https://www.mediawiki.org/wiki/Extension:SimpleTable SimpleTable] - Upload new version into extension folder | ## [https://www.mediawiki.org/wiki/Extension:SimpleTable SimpleTable] - Upload new version into extension folder | ||
# Remaining extensions are part of MediaWiki and upgraded with it | # Remaining extensions are part of MediaWiki and upgraded with it | ||
# Update completion - run maintenance routine from <code>cd ~/public_html/clubwiki/</code> directory: <code>{{#arrayprint:phpcommand}} maintenance/update.php</code> | # Update completion - run maintenance routine from <code>cd ~/public_html/clubwiki/</code> directory: <code>{{#arrayprint:phpcommand}} maintenance/update.php</code> |