MediaWiki Maintenance - Revision history

Fincato: add clean up instructions.

2023-03-02T12:44:22Z

add clean up instructions.

← Older revision		Revision as of 14:44, 2 March 2023
Line 6:		Line 6:
	The process can be divided in three steps:		The process can be divided in three steps:

	* backup the MySQL db and other parts of the system		* backup the MySQL db and other parts of the system (extensions, images, etc)
	* download the newest version of the software, unpacking it, ~~move~~ it ~~to <code>/var/www/</code>~~		* download the newest version of the software, unpacking it, and prepare it
	* ~~make backup copy of~~ current MediaWiki ~~folder in <code>/var/www/</code> and copy to the newer~~ version ~~all plugins from current / previous~~ version		* replace current MediaWiki version with newly prepared version

	General, official, [[mediawikiwiki:Manual:Upgrading\|reference document]] for upgrading the wiki software.		General, official, [[mediawikiwiki:Manual:Upgrading\|reference document]] for upgrading the wiki software.
Line 45:		Line 45:
	Let's first move <code>mediawiki-1.39.2</code> to <code>/var/www:</code><syntaxhighlight lang="bash">		Let's first move <code>mediawiki-1.39.2</code> to <code>/var/www:</code><syntaxhighlight lang="bash">
	sudo cp -r mediawiki-1.39.2 /var/www/.		sudo cp -r mediawiki-1.39.2 /var/www/.
	</syntaxhighlight>Then we want to copy some of the files in <code>/var/www/mediawiki-<yyyy-mm-dd></code> to <code>/var/www/mediawiki-1.39.2</code>:		</syntaxhighlight>(This operation could be replaced by <code>sudo mv</code> instead, up to you and to your level of comfort in dealing with unix and MediaWiki)

			Then we want to copy some of the files in <code>/var/www/mediawiki-<yyyy-mm-dd></code> to <code>/var/www/mediawiki-1.39.2</code>:

	* let's move to <code>/var/www/</code>: <code>cd /var/www</code>		* let's move to <code>/var/www/</code>: <code>cd /var/www</code>
Line 76:		Line 78:

	After this, visit [https://wiki.hackersanddesigners.nl wiki.hackersanddesigners.nl] and check if things are working!		After this, visit [https://wiki.hackersanddesigners.nl wiki.hackersanddesigners.nl] and check if things are working!

			=== Clean up ===
			When all it's good, remove the following directories:

			* <code>sudo rm -rf /var/www/mediawiki-<yyyy-mm-dd></code>
			* <code>sudo rm -rf ~/mediawiki-1.39.2</code> (only if you made a copy (<code>cp -r</code>) of the directory from <code>~/.</code> to <code>/var/www/</code>, instead of moving it (<code>mv</code>))

	=== Debugging ===		=== Debugging ===

Fincato: Add debugging

2023-03-02T12:05:54Z

Add debugging

← Older revision		Revision as of 14:05, 2 March 2023
Line 78:		Line 78:

	=== Debugging ===		=== Debugging ===
			No specific techniques, besides:

			* reading the printed error messages on the wiki website
			* check the Nginx logs by checking:
			** access log: <code>/var/log/nginx/mediawiki.access.log</code>
			** error log: <code>/var/log/nginx/mediawiki.error.log</code>

	[[Category:Maintenance]]		[[Category:Maintenance]]

Fincato: fix blockquote

2023-03-02T12:00:29Z

fix blockquote

← Older revision		Revision as of 14:00, 2 March 2023
Line 16:		Line 16:

	<blockquote>		<blockquote>
	Use <code>runJobs.php</code> to run all [https://www.mediawiki.org/wiki/Manual:RunJobs.php pending jobs] and clear the queue before performing the upgrade.Then backup the MySQL database:<syntaxhighlight lang="bash">		Use <code>runJobs.php</code> to run all [https://www.mediawiki.org/wiki/Manual:RunJobs.php pending jobs] and clear the queue before performing the upgrade.
			</blockquote>

			Then backup the MySQL database:<syntaxhighlight lang="bash">
	mysqldump --user=<wikidb_user> --password=<wikidb_userpassword> <wiki_db_name> > mw-backup-<yyyy-mm-dd>.sql		mysqldump --user=<wikidb_user> --password=<wikidb_userpassword> <wiki_db_name> > mw-backup-<yyyy-mm-dd>.sql
	</syntaxhighlight>You can find the database's user, password and name under the Database settings in the <code>LocalSettings.php</code> file part of the MediaWiki folder.		</syntaxhighlight>You can find the database's user, password and name under the Database settings in the <code>LocalSettings.php</code> file part of the MediaWiki folder.

Fincato: init

2023-03-02T11:58:19Z

init

@@ Line 16: / Line 16: @@
 <blockquote>
-Use <code>runJobs.php</code> to run all [https://www.mediawiki.org/wiki/Manual:RunJobs.php pending jobs] and clear the queue before performing the upgrade.
+Use <code>runJobs.php</code> to run all [https://www.mediawiki.org/wiki/Manual:RunJobs.php pending jobs] and clear the queue before performing the upgrade.Then backup the MySQL database:<syntaxhighlight lang="bash">
 [[Category:Maintenance]]

Fincato at 10:53, 2 March 2023

2023-03-02T10:53:49Z

← Older revision		Revision as of 12:53, 2 March 2023
Line 16:		Line 16:

	<blockquote>		<blockquote>
	Use runJobs.php to run all [https://www.mediawiki.org/wiki/Manual:RunJobs.php pending jobs] and clear the queue before performing the upgrade.		Use <code>runJobs.php</code> to run all [https://www.mediawiki.org/wiki/Manual:RunJobs.php pending jobs] and clear the queue before performing the upgrade.
	~~</blockquote~~


	[[Category:Maintenance]]		[[Category:Maintenance]]

Fincato at 10:53, 2 March 2023

2023-03-02T10:53:25Z

← Older revision		Revision as of 12:53, 2 March 2023
Line 1:		Line 1:
			{{Article
			\|MainNavigation=No
			}}
	Upgrading MediaWiki, as it is in general installing it and using it (eg their APIs), is quite annoying. It definitely could be simplified in the process by writing like a Python script (well commented), but so far as I'd used not to upgrade this software so often, it's all manual labour.		Upgrading MediaWiki, as it is in general installing it and using it (eg their APIs), is quite annoying. It definitely could be simplified in the process by writing like a Python script (well commented), but so far as I'd used not to upgrade this software so often, it's all manual labour.

Line 12:		Line 15:
	Before starting the backup process (SQL dump), clear any "pending jobs" from the db:		Before starting the backup process (SQL dump), clear any "pending jobs" from the db:

	~~{{Blockquote~~		<blockquote>
	~~\|text=~~Use runJobs.php to run all [https://www.mediawiki.org/wiki/Manual:RunJobs.php pending jobs] and clear the queue before performing the upgrade.		Use runJobs.php to run all [https://www.mediawiki.org/wiki/Manual:RunJobs.php pending jobs] and clear the queue before performing the upgrade.
	~~\|source=https:/~~/~~www.mediawiki.org/wiki/Manual:Upgrading#Clear_pending_jobs~~		</blockquote
	}}

	~~{{Article~~
	~~\|MainNavigation=No~~
	}}
	[[Category:Maintenance]]		[[Category:Maintenance]]

Fincato at 10:52, 2 March 2023

2023-03-02T10:52:41Z

← Older revision		Revision as of 12:52, 2 March 2023
Line 11:		Line 11:
	=== Backup ===		=== Backup ===
	Before starting the backup process (SQL dump), clear any "pending jobs" from the db:		Before starting the backup process (SQL dump), clear any "pending jobs" from the db:

			{{Blockquote
			\|text=Use runJobs.php to run all [https://www.mediawiki.org/wiki/Manual:RunJobs.php pending jobs] and clear the queue before performing the upgrade.
			\|source=https://www.mediawiki.org/wiki/Manual:Upgrading#Clear_pending_jobs
			}}

	{{Article		{{Article

Fincato: Init

2023-03-02T10:48:38Z

Init

@@ Line 1: / Line 1: @@
 {{Article
 |MainNavigation=No
 }}

Fincato: Created page with "{{Article |MainNavigation=No }}"

2023-03-02T10:39:02Z

Created page with "{{Article |MainNavigation=No }}"

New page