User:Daveh/Wiki Upgrade 1.24

Install/Upgrade Notes

• Install MW 1.24
• Copy LocalSettings.php and ./config from existing MW.
• Copy ./extensions/* from existing (don't overwrite).
• Copy ./skins/UespMonobook and ./skins/uespvector
• Error:

    PHP Fatal error:  Class 'MonoBookTemplate' not found in /home/uesp/dev/www/w/skins/UespMonoBook/UespMonoBook.skin.php on line 63

• Add line to top of UespMonoBook.skin.php:

    require_once "skins/MonoBook/MonoBookTemplate.php";

• Pages have display issue

• In UespMonoBook.php remove the 3 lines:

    'common/commonElements.css' => array( 'media' => 'screen' ),
    'common/commonContent.css' => array( 'media' => 'screen' ),
    'common/commonInterface.css' => array( 'media' => 'screen' ),

• In UespMonoBook.skin.php modify the function call in setupSkinUserCss() to be:

    $out->addModuleStyles( array('mediawiki.skinning.elements', 'mediawiki.skinning.content', 'mediawiki.skinning.interface', 'skins.uespmonobook' ));

• MediaWiki now requires PHP's iconv extension

• Included in PHP by default.

• update.php

• Note: For dev need to manually set ``$uespIsDev = true`` in LocalSettings.php or it tries to update the main database.
• Note: Need to manually edit LocalSettings.php and set the language in order to update the pt and it databases.
• Time Required: ~4 hours

• jQuery update to 1.11.x
• Crash on page edit/creation

• Apache Log: /usr/sbin/httpd: symbol lookup error: /usr/lib64/libnsssysinit.so: undefined symbol: PR_GetEnvSecure
• Start then stop Apache (restart doesn't work, due to issue in NSS?)

• Crash on viewing category pages

    require_once(/home/uesp/dev/www/w/includes/CategoryPage.php): failed to open stream: No such file or directory in /home/uesp/dev/www/w/extensions/MetaTemplate/MetaTemplateCategoryPage.php on line 3,

• Change include path to includes/page/CategoryPage.php.

• Special:SpecialPages crashes

     require_once(/home/uesp/dev/www/w/includes/QueryPage.php): failed to open stream: No such file or directory in /home/uesp/dev/www/w/extensions/UsersEditCount/UsersEditCount_body.php on line 4

• Change include path to includes/specialpage/QueryPage.php.

• It seems you can use the wiki while the upgrade process is under way (no observed issues on dev).
• Created the /home/uesp/scripts/uesp-getmwext script to help download extension updates from MW GitHub. Format is:

        uesp-getmwext EXTENSION VERSION
    ex: uesp-getmwext Disambiguator 1_24

Note that script is very basic and only does minimal error checking.

Extensions

• Upgrade Issues

• MwEmbedSupport -- No GitHub, included in MW +1.32
• Patroller -- Only source for 1.26 or later?
• ProtectSection -- No updates
• StringFunctions -- No updates, included optionally in ParserFunctions
• MobileFrontEnd -- 1.24 requires deprecated Mantle extension (included in MW +1.25)?
• qwebirChat -- No longer used?

• UESP Custom Extensions

• DaedricFont
• DailyEdits
• DragonFont
• EsoCharData
• FalmerFont
• JobQueue
• LogPageRenderTimes
• MetaTemplate
• UespCustomCode
• UespEsoItemLink
• UespEsoSkills
• UespLegendsCards
• UespMap
• UncategorizedUESPPages
• UsersEditCount

Upgrade Procedure

1. Copy new code to directory w-124 on all servers.
2. Stop database mirroring on content3
3. Move old code to w-123 and new code to w on all servers.
4. Wait for ~1 hour to ensure no significant new issues crop up.
5. Run database update on en followed by pt and it on content3.
6. In case of significant issue:

• Create backup from wiki database on content3
• Restore on db1 to new database
• Point wikis to new database

Post-Upgrade Notes

• Add $wgUseSquid = true; to Cache.php (unsure if required).
• Add the following to Debug.php (reminder not to use this on the main content1/2 servers):

    $wgDebugToolbar = true;
    $wgUseSquid = false;

• Memcached was turned off due to copying config from dev (sessions didn't work correctly.
• Prefix searching not working on main wiki. Edit /w/resources/src/mediawiki/mediawiki.searchSuggest.js line 130 to be:

   namespace: '0|102|104|106|108|110|112|114|116|118|120|122|124|126|128|130|132|134|136|138|140|142|144|146|148|150',

• Prefix searching not working on mobile wiki. Edit /w/resources/extensions/MobileFrontEnd/javascripts/modules/search/SearchApi.js line 42 to be:

   gpsnamespace: '0|102|104|106|108|110|112|114|116|118|120|122|124|126|128|130|132|134|136|138|140|142|144|146|148|150',