Mediawiki - Revision history

Johnno: /* Installation */

2021-09-07T22:42:39Z

Installation

2021-09-07T22:42:12Z

Installation

2021-09-07T22:38:22Z

Caching

2021-09-07T22:32:47Z

Visual Editor

2020-12-14T23:24:32Z

2020-09-02T03:37:14Z

Troubleshooting

2020-09-02T03:36:15Z

Upgrading

2020-09-02T03:32:52Z

remove notoc

2020-09-02T03:31:34Z

Upgrading

2020-09-02T03:30:53Z

Upgrading

@@ Line 3: / Line 3: @@
 This assumes Ubuntu 20.04 LTS, the new Mediawiki LTS version 1.35 and a passing familiarity with [[Git]]. First, some prerequisites (see the [[PHP]] page for more about how to set up PHP so it sucks less):
-  apt-get install git apache2 libapache2-mod-fcgi php7.4-curl php7.4-fpm php7.4-mysql curl
+  apt-get install git apache2 libapache2-mod-fcgid php7.4-curl php7.4-fpm php7.4-mysql curl
 ;NOTE: MediaWiki does not (yet) work properly with PHP 8 so we use PHP 7.4 for now.

@@ Line 1: / Line 1: @@
 == Installation ==
-This assumes Ubuntu 20.04 LTS, the new Mediawiki LTS version 1.35 and a passing familiarity with [[Git]]. First, some prerequisites:
+This assumes Ubuntu 20.04 LTS, the new Mediawiki LTS version 1.35 and a passing familiarity with [[Git]]. First, some prerequisites (see the [[PHP]] page for more about how to set up PHP so it sucks less):
-  apt-get install git apache2 libapache2-mod-php7.4 php7.4-curl php7.4-mysql curl
+  apt-get install git apache2 libapache2-mod-fcgi php7.4-curl php7.4-fpm php7.4-mysql curl
 Now clone Mediawiki with git:

@@ Line 84: / Line 84: @@
   opcache.revalidate_freq=0
   opcache.fast_shutdown=0
 === MediaWiki file cache ===
-Use the [https://www.mediawiki.org/wiki/Manual:File_cache#Operation_and_usage file cache], Luke. It's simple but effective. In <tt>LocalSettings.php</tt>:
+Use the [https://www.mediawiki.org/wiki/Manual:File_cache#Operation_and_usage file cache], Luke. It's simple but effective for anonymous users. In <tt>LocalSettings.php</tt>:
   $wgUseFileCache = true;

@@ Line 42: / Line 42: @@
 == Visual Editor ==
-=== Install Parsoid ===
+This relies on Parsoid, which used to be a separate Node.js REST service you had to install; in 2019 it was rewritten in PHP and is now bundled since version 1.35 of MediaWiki.
 === Install the required MediaWiki extensions ===
@@ Line 92: / Line 66: @@
     NS_TEMPLATE => false,
     '_merge_strategy' => 'array_plus',
   ];

@@ Line 38: / Line 38: @@
   wfLoadExtension('Cite');
-You should now be able to point Apache at the <tt>mediawiki</tt> directory and install it using the browser; you will probably need to set up a PostgreSQL or MySQL database and user first.
+You should now be able to point Apache at the <tt>mediawiki</tt> directory and install it using the browser; you will probably need to set up a [[PostgreSQL]] or MySQL database and user first.
 == Visual Editor ==

← Older revision		Revision as of 03:37, 2 September 2020
Line 148:		Line 148:
	== Troubleshooting ==		== Troubleshooting ==

−	# Having 'file:' in your $wgUrlProtocols is not just bad, it will clobber all your <tt><nowiki>[[File:whatever.jpg]]</nowiki></tt> images.	+	Having 'file:' in your $wgUrlProtocols is not just bad, it will clobber all your <tt><nowiki>[[File:whatever.jpg]]</nowiki></tt> images.
		+
		+	If you're using or have moved to MySQL or MariaDB, remove any PostgreSQL schema settings from <tt>LocalSettings.php</tt> otherwise the update scripts get terribly confused:
		+
		+	# remove this:
		+	$wgDBmwschema = 'mediawiki';

@@ Line 133: / Line 133: @@
 == Upgrading ==
-Check the [https://www.mediawiki.org/wiki/Version_lifecycle Version lifecycle] page to see which versions are current.
+Check the [https://www.mediawiki.org/wiki/Version_lifecycle Version lifecycle] page to see which versions are current, inspect your wiki's [[Special:Version]] page for version and dependency details. See also the documentation for [https://www.mediawiki.org/wiki/Manual:Upgrading/en Upgrading MediaWiki].
 Whenever the base code is updated, we need to make sure that PHP dependencies, skins, extensions and the database schema are all updated too. It looks a bit like this:

@@ Line 143: / Line 143: @@
   # (look for any new updateXXX.php commands in the maintenance directory)
-At present, <tt>npm install</tt> is only required to install grunt-based testing dependencies for developers and testers, and is not required in production.
+At present, <tt>npm install</tt> is only required to install grunt-based JavaScript dependencies for developers and testers, and is not required in production.
 Given that Wikipedia itself runs on this code, you can bet upgrades have been tested up the waazoo, so this runs very reliably. I recently upgraded a wiki from 1.19 to latest 1.35 LTS by repeating this procedure after merging each LTS branch in turn—that's 1.23, 1.27 and 1.31—as intermediate steps. It's prudent to do each LTS bump separately like this  because configuration details and deployment steps can change. For instance, 1.23 introduced PHP composer and 1.27 moved extensions and skins to git submodules.