MediaWIKI Upgrade: Difference between revisions
mNo edit summary |
|||
| (9 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
There are all sorts of tutorials on upgrading MediaWiki. Here's the "down and dirty" version. | There are all sorts of tutorials on upgrading MediaWiki. Here's the "down and dirty" version. | ||
NOTE: As of 2020 and MediaWiki 1.35.0, the Visual Editor is include within the MediaWiki package. And it works out of the box for HTTP and HTTPS (dang that used to be difficult to figure out how to install and then configure to use with STUNNEL). | |||
==BACKUP!== | ==BACKUP!== | ||
Don't take a chance | Don't take a chance! Assume the upgrade will mess something up. So make a backup. For MediaWiki, that consists of two items: The website files and the data base. | ||
Backup the website files (actually make a copy)<syntaxhighlight lang="text"> | Backup the website files (actually make a copy)<syntaxhighlight lang="text"> | ||
| Line 19: | Line 21: | ||
This is a good opportunity to upgrade PHP too. As of this writing, 5.2020, MediaWiki claims there is an issue with version 1.3.X of MediaWiki and PHP 7.4.X, so use 7.3.X | This is a good opportunity to upgrade PHP too. As of this writing, 5.2020, MediaWiki claims there is an issue with version 1.3.X of MediaWiki and PHP 7.4.X, so use 7.3.X | ||
yum upgrade php73* (This will upgrade all relevant PHP version 7.3 modules if FCGI is being used) | yum upgrade php73* (This will upgrade all relevant PHP version 7.3 modules if FCGI is being used) | ||
Another Note: If multiple versions of PHP (7.2, 7.3, 7.4, etc.) are installed and using FCGI, when upgrading with yum upgrade php74*, will also upgrade the lower versions. | |||
As of MediaWiki 1.34.1 they had an issue with PHP 7.4.0 - about 7.4.2, but as of 7.4.7, everything seems to work fine. | |||
==Upgrade (Actually Install and Copy)== | ==Upgrade (Actually Install and Copy)== | ||
| Line 43: | Line 48: | ||
===LocalSettings.php=== | ===LocalSettings.php=== | ||
Copy the old copy of the LocalSettings.php file into the upgrade directory as the "new one", if it exists, wouldn't be overwritten with the new copy process. See this for a tip on the LocalSettings.php file. | Copy the old copy of the LocalSettings.php file into the upgrade directory as the "new one", if it exists, wouldn't be overwritten with the new copy process. See this for a tip on the LocalSettings.php file. | ||
===Images=== | |||
Make sure the /WhatEverPathToWiki/images permissions are writable for the Owner. IE, if the images Directory is owned by Apache, it needs to be writable. 777 works, 755 is recommended, but if it doesn't work, go with 777. | |||
===Scribunto & Lua=== | ===Scribunto & Lua=== | ||
If the Mediawiki software being upgraded uses the Scribunto and Lua extensions, then change permissions on the following file;<syntaxhighlight lang="text"> | If the Mediawiki software being upgraded uses the Scribunto and Lua extensions, then change permissions on the following file;<syntaxhighlight lang="text"> | ||
chmod a+x /var/www/html/ | chmod a+x /var/www/html/WhatEverWebSite/extensions/Scribunto/includes/engines/LuaStandalone/binaries/lua5_1_5_linux_64_generic/lua | ||
Older versions of Mediawiki use the below path; | Older versions of Mediawiki use the below path; | ||
/var/www/html/ | /var/www/html/WhatEverWebSite/extensions/Scribunto/engines/LuaStandalone/binaries/lua5_1_5_linux_64_generic | ||
</syntaxhighlight>Not doing the above item will hose the Wiki! | </syntaxhighlight>Not doing the above item will hose the Wiki! | ||
| Line 68: | Line 76: | ||
===Alternative for Modifying Files (CSS)=== | ===Alternative for Modifying Files (CSS)=== | ||
Instead of changing code in files, CSS can be used to modify visibility of elements on a MediaWiki Site. The below script can be placed in the LocalSettings.php file and modify what appears for anonymous users and logged in users (probably not necessary to change anything for logged in users.<syntaxhighlight lang="text"> | Instead of changing code in files, CSS can be used to modify visibility of elements on a MediaWiki Site. The below script can be placed in the LocalSettings.php file and modify what appears for anonymous users and logged in users (probably not necessary to change anything for logged in users).<syntaxhighlight lang="text"> | ||
function efAddSkinStyles(OutputPage &$out, Skin &$skin) { | function efAddSkinStyles(OutputPage &$out, Skin &$skin) { | ||
if(!$skin->getUser()-> | if(!$skin->getUser()->isRegistered()) { | ||
if ($skin->getSkinName() == 'vector') { | if ($skin->getSkinName() == 'vector') { | ||
$out->addInlineStyle('#ca-history { display:none; }'); | $out->addInlineStyle('#ca-history { display:none; }'); | ||
| Line 81: | Line 89: | ||
$out->addInlineStyle('#ca-talk { display:none; }'); | $out->addInlineStyle('#ca-talk { display:none; }'); | ||
$out->addInlineStyle('#ca-viewsource { display:none; }'); | $out->addInlineStyle('#ca-viewsource { display:none; }'); | ||
$out->addInlineStyle('#footer-info-lastmod { display:none; }'); | |||
} | } | ||
} else { | } else { | ||
| Line 92: | Line 100: | ||
$wgHooks['BeforePageDisplay'][] = 'efAddSkinStyles'; | $wgHooks['BeforePageDisplay'][] = 'efAddSkinStyles'; | ||
</syntaxhighlight>The "#footer-info-lastmod" ID that is commented out above will disable the display of "Last edited / Last modified" for anonymous users. | </syntaxhighlight>The "#footer-info-lastmod" ID that is commented out above will disable the display of "Last edited / Last modified" for anonymous users. | ||
As of version 1.36.0, an error message noting a "Deprecated Function" will pop up if the following line is left in place: if(!$skin->getUser()->IsLoggedIn()) { | |||
The above code replaces the IsLoggedIn with isRegistered Function. | |||
===Extensions=== | ===Extensions=== | ||
Upgrade extensions (if there are upgrades). Visual Editor is one that needs to be kept up. Hopefully nothing breaks for extensions that don't have upgrades available. | Upgrade extensions (if there are upgrades). Visual Editor is one that needs to be kept up. Hopefully nothing breaks for extensions that don't have upgrades available. | ||
<br /> | |||
==Database Update== | |||
...and finally, don't forget to update the database structure. From the /WhatEverPathToWebSite/WebSite/maintenance Directory;<syntaxhighlight lang="text"> | |||
php update.php | |||
</syntaxhighlight>It can be done from the GUI, but is recommended that it be done from the command line.<br /> | |||