Updating MediaWiki - Revision history

Thomasd: /* Finalizing the update */

2021-09-07T21:09:50Z

Finalizing the update

← Older revision		Revision as of 23:09, 7 September 2021
Line 87:		Line 87:
	* Test your new MediaWiki installation: make sure all basic functionality (viewing, editing pages, file upload) works and all your extensions function properly.		* Test your new MediaWiki installation: make sure all basic functionality (viewing, editing pages, file upload) works and all your extensions function properly.
	* Delete the old installation: you should remove the previously created <code>www/wiki_old</code> directory, using the command line or through a GUI. A simple GUI explanation can be found on [[Accessing_your_files#Creating_and_Deleting_files_and_folders\|Accessing your files]].		* Delete the old installation: you should remove the previously created <code>www/wiki_old</code> directory, using the command line or through a GUI. A simple GUI explanation can be found on [[Accessing_your_files#Creating_and_Deleting_files_and_folders\|Accessing your files]].

			== If something goes wrong ==

			If something goes wrong during the update so your wiki doesn't work anymore, you can revert the process to go back to your old wiki. If you already moved files or directories such as <code>LocalSettings.php</code> or <code>images</code> from <code>wiki_old</code> to <code>wiki</code>, move them back into <code>wiki_old</code>. Then delete <code>wiki</code> and rename <code>wiki_old</code> back to <code>wiki</code>. Your old wiki is then restored so you can retry the update process. If you still run into any trouble, feel free to email us at [mailto:ulyssis@ulyssis.org ulyssis@ulyssis.org].

Thomasd: /* Installing the new files */

2021-08-31T23:18:32Z

Installing the new files

← Older revision		Revision as of 01:18, 1 September 2021
Line 42:		Line 42:
	Finally, you need to move certain other other files and directories from the '''old''' directory to the '''new''' directory. The easiest way to do this using Cyberduck is by going up a directory (so if your wiki is in <code>www/wiki</code>, go to <code>www</code>), and drag-and-dropping the necessary files and directories. For example, moving <code>LocalSettings.php</code> by drag-and-dropping it from <code>wiki_old</code> into <code>wiki</code>:		Finally, you need to move certain other other files and directories from the '''old''' directory to the '''new''' directory. The easiest way to do this using Cyberduck is by going up a directory (so if your wiki is in <code>www/wiki</code>, go to <code>www</code>), and drag-and-dropping the necessary files and directories. For example, moving <code>LocalSettings.php</code> by drag-and-dropping it from <code>wiki_old</code> into <code>wiki</code>:

	[[File:Cyberduck wiki move 1.png\|~~thumb\|center~~]]		[[File:Cyberduck wiki move 1.png\|500px]]

	[[File:Cyberduck wiki move 2.png\|~~thumb\|center~~]]		[[File:Cyberduck wiki move 2.png\|500px]]

	Although the exact files you need to move are different depending on your wiki, here are some suggestions from the [https://www.mediawiki.org/wiki/Manual:Upgrading#Other_files official instructions]:		Although the exact files you need to move are different depending on your wiki, here are some suggestions from the [https://www.mediawiki.org/wiki/Manual:Upgrading#Other_files official instructions]:

Thomasd at 23:16, 31 August 2021

2021-08-31T23:16:31Z

← Older revision		Revision as of 01:16, 1 September 2021
Line 40:		Line 40:
	[[File:Cyberduck rename.png\|thumb\|center]]		[[File:Cyberduck rename.png\|thumb\|center]]

	Finally, you need to ~~copy~~ certain other other files and directories from the '''old''' directory to the '''new''' directory. The easiest way to do this using Cyberduck is by ~~creating~~ a ~~"New Browser". Right click the '''new'''~~ directory, and ~~click "New Browser"~~.		Finally, you need to move certain other other files and directories from the '''old''' directory to the '''new''' directory. The easiest way to do this using Cyberduck is by going up a directory (so if your wiki is in <code>www/wiki</code>, go to <code>www</code>), and drag-and-dropping the necessary files and directories. For example, moving <code>LocalSettings.php</code> by drag-and-dropping it from <code>wiki_old</code> into <code>wiki</code>:

	[[File:Cyberduck ~~new browser~~.png\|thumb\|center]]		[[File:Cyberduck wiki move 1.png\|thumb\|center]]

	~~Then, you can simply place both windows next to each other, and drag-and-drop files or directories to copy them from the '''old''' directory to the '''new''' directory~~. ~~For example, copying <code>LocalSettings.php</code>:~~		[[File:Cyberduck wiki move 2.png\|thumb\|center]]

	~~[[File:Cyberduck drag and drop.png\|center\|750px]]~~		Although the exact files you need to move are different depending on your wiki, here are some suggestions from the [https://www.mediawiki.org/wiki/Manual:Upgrading#Other_files official instructions]:

	Although the exact files you need to ~~copy~~ are different depending on your wiki, here are some suggestions from the [https://www.mediawiki.org/wiki/Manual:Upgrading#Other_files official instructions]:
	* <code>LocalSettings.php</code>, which contains your old configuration settings.		* <code>LocalSettings.php</code>, which contains your old configuration settings.
	* The <code>images/</code> directory, containing the uploaded files to the wiki.		* The <code>images/</code> directory, containing the uploaded files to the wiki. Because the new wiki directory already contains an (empty) <code>images</code> directory, you need to delete that one first by right-clicking on it and pressing "Delete". Make sure to only delete the <code>images</code> directory in the '''new''' wiki directory. Then you can move the old <code>images</code> directory into the new wiki directory.
	* Custom extensions from within the <code>extensions/</code> directory. Be careful not to overwrite the default extensions that are bundled with the new MediaWiki version.		* Custom extensions from within the <code>extensions/</code> directory. Be careful not to overwrite the default extensions that are bundled with the new MediaWiki version.
	* Custom skins from within the <code>skins/</code> directory. Be careful not to overwrite the default skins that are bundled with the new MediaWiki version.		* Custom skins from within the <code>skins/</code> directory. Be careful not to overwrite the default skins that are bundled with the new MediaWiki version.

Yoa: /* Finalizing the update */

2021-08-17T19:13:33Z

Finalizing the update

← Older revision		Revision as of 21:13, 17 August 2021
Line 82:		Line 82:
	[[File:Cyberduck update output.png\|center\|750px]]		[[File:Cyberduck update output.png\|center\|750px]]

	~~However~~, if you ~~did~~ encounter any errors while executing the script, you could try taking a look at the [https://www.mediawiki.org/wiki/Manual:Upgrading#Command_line_2 official instructions]. If this does not resolve your problems, feel free to send us an email. We will try to assist you in completing the update.		If you get the error <code>Could not open input file</code>, you might have misspelled the installation location. Double check the path to make sure everything is correct.

			If you encounter any other errors while executing the script, you could try taking a look at the [https://www.mediawiki.org/wiki/Manual:Upgrading#Command_line_2 official instructions]. If this does not resolve your problems, feel free to send us an email. We will try to assist you in completing the update.

	Congratulations! You successfully updated MediaWiki. Still, there are two more important steps you must perform:		Congratulations! You successfully updated MediaWiki. Still, there are two more important steps you must perform:
	* Test your new MediaWiki installation: make sure all basic functionality (viewing, editing pages, file upload) works and all your extensions function properly.		* Test your new MediaWiki installation: make sure all basic functionality (viewing, editing pages, file upload) works and all your extensions function properly.
	* Delete the old installation: you should remove the previously created <code>www/wiki_old</code> directory, using the command line or through a GUI. A simple GUI explanation can be found on [[Accessing_your_files#Creating_and_Deleting_files_and_folders\|Accessing your files]].		* Delete the old installation: you should remove the previously created <code>www/wiki_old</code> directory, using the command line or through a GUI. A simple GUI explanation can be found on [[Accessing_your_files#Creating_and_Deleting_files_and_folders\|Accessing your files]].

Yoa: /* Finalizing the update */

2021-08-17T19:06:35Z

Finalizing the update

← Older revision		Revision as of 21:06, 17 August 2021
Line 70:		Line 70:
	[[File:Cyberduck send command.png\|thumb\|center]]		[[File:Cyberduck send command.png\|thumb\|center]]

	Enter the following command in the pop-up box:		Enter the following command in the pop-up box (of course, replace <code><wiki installation location></code> with the location of your new installation):

	php <wiki installation location>/maintenance/update.php		php <wiki installation location>/maintenance/update.php

Vincenttc at 14:00, 13 August 2021

2021-08-13T14:00:38Z

← Older revision		Revision as of 16:00, 13 August 2021
Line 11:		Line 11:
	[[File:Installed software.png\|center\|frame]]		[[File:Installed software.png\|center\|frame]]

	A table of all recent MediaWiki versions can be found on ~~the~~ [https://en.wikipedia.org/wiki/MediaWiki_version_history ~~the official table~~]. Currently supported versions are indicated by a green or yellow color in the first column. To determine which version you want to download, follow these steps:		A table of all recent MediaWiki versions can be found on [https://en.wikipedia.org/wiki/MediaWiki_version_history wikipedia]. Currently supported versions are indicated by a green or yellow color in the first column. To determine which version you want to download, follow these steps:
	* If the ''branch'' of your version ('''the first two numbers''', like <code>1.xx</code>) is currently supported (green or yellow), you should choose the latest version for this branch. For example, for version 1.35.3, the branch is 1.35.		* If the ''branch'' of your version ('''the first two numbers''', like <code>1.xx</code>) is currently supported (green or yellow), you should choose the latest version for this branch. For example, for version 1.35.3, the branch is 1.35.
	* If this branch is not supported anymore, you should choose the most recent LTS branch. This is indicated by '''(LTS)''' in the second column. '''Make sure this LTS branch is not older than your current branch!'''		* If this branch is not supported anymore, you should choose the most recent LTS branch. This is indicated by '''(LTS)''' in the second column. '''Make sure this LTS branch is not older than your current branch!'''

Yoa: /* Downloading the right version */

2021-08-08T20:26:49Z

Downloading the right version

← Older revision		Revision as of 22:26, 8 August 2021
Line 4:		Line 4:

	== Downloading the right version ==		== Downloading the right version ==
	To start updating MediaWiki, you will need to download the archive file of the version you want to update to. If you ~~arrived at this page after receiving~~ an email from our [[Software Version Checker]], follow the instructions in the next ~~paragraph~~. Otherwise, you can skip the ~~next paragraph~~.		To start updating MediaWiki, you will need to download the archive file of the version you want to update to. If you did not receive an email from our [[Software Version Checker]], follow the instructions in the next subsection. Otherwise, you can skip to the subsection [[#Downloading the right version using the Software Version Checker \| Downloading the right version using the Software Version Checker]].

	=== Downloading the right version based on your wiki ===		=== Downloading the right version based on your wiki ===

Yoa: /* Downloading the right version */

2021-08-08T20:24:05Z

Downloading the right version

← Older revision		Revision as of 22:24, 8 August 2021
Line 6:		Line 6:
	To start updating MediaWiki, you will need to download the archive file of the version you want to update to. If you arrived at this page after receiving an email from our [[Software Version Checker]], follow the instructions in the next paragraph. Otherwise, you can skip the next paragraph.		To start updating MediaWiki, you will need to download the archive file of the version you want to update to. If you arrived at this page after receiving an email from our [[Software Version Checker]], follow the instructions in the next paragraph. Otherwise, you can skip the next paragraph.

	~~The email you received might contain a line similar to:~~		=== Downloading the right version based on your wiki ===
	~~- MediaWiki in <path>. Installed version: <version1>. Latest version: <version2>.~~		You can find your current MediaWiki version by going to the <code>Special:Version</code> page on your wiki (simply paste this in the search box) and looking for the "MediaWiki" version under "Installed software". For example, for this wiki, you can find the current version at [[Special:Version]]. At the time of writing, it looks like this:
	~~This line tells you where~~ the ~~MediaWiki installation is located, its current~~ version~~, and the version you need to download.~~

	~~If you don't have an email from our Software Version Checker, you~~ can find your current MediaWiki version by going to the <code>Special:Version</code> page on your wiki (simply paste this in the search box) and looking for the "MediaWiki" version under "Installed software". For example, for this wiki, you can find the current version at [[Special:Version]]. At the time of writing, it looks like this:

	[[File:Installed software.png\|center\|frame]]		[[File:Installed software.png\|center\|frame]]
Line 20:		Line 17:

	Now, click on the link of the branch you want to download. This will redirect you to a page with information about this version. The first paragraph on this page contains a link to <code>mediawiki-1.xx.yy.tar.gz</code>. Download this archive and save it somewhere on your computer.		Now, click on the link of the branch you want to download. This will redirect you to a page with information about this version. The first paragraph on this page contains a link to <code>mediawiki-1.xx.yy.tar.gz</code>. Download this archive and save it somewhere on your computer.

			=== Downloading the right version using the Software Version Checker ===
			The email you received will contain a link to the correct MediaWiki version. This link looks something like:
			https://releases.wikimedia.org/mediawiki/1.xx/mediawiki-core-1.xx.yy.tar.gz

			Simply click this link to download the archive and save it somewhere on your computer.

	== Renaming the old installation ==		== Renaming the old installation ==

Yoa: /* Updating extensions */

2021-08-08T13:06:12Z

Updating extensions

← Older revision		Revision as of 15:06, 8 August 2021
Line 53:		Line 53:

	== Updating extensions ==		== Updating extensions ==
	If you use any extensions that are not bundled with MediaWiki by default, you should update them too. A list of bundled extensions can be found at https://www.mediawiki.org/wiki/Bundled_extensions_and_skins, these extensions will be updated automatically.		If you use any extensions that are not bundled with MediaWiki by default, you should update them too. A list of bundled extensions can be found at https://www.mediawiki.org/wiki/Bundled_extensions_and_skins, these extensions will be updated automatically. However, for example, you might have the ULYSSIS extensions [[Securing MediaWiki using Centrale KU Leuven Login\|MediaWikiShibboleth]] or [https://github.com/ULYSSIS-KUL/CompressUploads CompressUploads] installed. As with MediaWiki itself, you can find the versions of your installed extensions on the <code>Special:Version</code> page, under "Installed extensions". Extensions will often link to a website where you can download the latest versions. For example, for this wiki, you can find the installed extensions at [[Special:Version]]. At the time of writing, it looks like this:

	However, for example, you might have the ULYSSIS extensions [[Securing MediaWiki using Centrale KU Leuven Login\|MediaWikiShibboleth]] or [https://github.com/ULYSSIS-KUL/CompressUploads CompressUploads] installed. As with MediaWiki itself, you can find the versions of your installed extensions on the <code>Special:Version</code> page, under "Installed extensions". Extensions will often link to a website where you can download the latest versions. For example, for this wiki, you can find the installed extensions at [[Special:Version]]. At the time of writing, it looks like this:

	[[File:Installed extensions.png\|center\|frame]]		[[File:Installed extensions.png\|center\|frame]]

Yoa: /* Updating extensions */

2021-08-08T13:05:59Z

Updating extensions

← Older revision		Revision as of 15:05, 8 August 2021
Line 53:		Line 53:

	== Updating extensions ==		== Updating extensions ==
	If you use any extensions that are not bundled with MediaWiki by default, you should update them too. A list of bundled extensions can be found at https://www.mediawiki.org/wiki/Bundled_extensions_and_skins, these extensions will be updated automatically. However, for example, you might have the ULYSSIS extensions [[Securing MediaWiki using Centrale KU Leuven Login\|MediaWikiShibboleth]] or [https://github.com/ULYSSIS-KUL/CompressUploads CompressUploads] installed. As with MediaWiki itself, you can find the versions of your installed extensions on the <code>Special:Version</code> page, under "Installed extensions". Extensions will often link to a website where you can download the latest versions. For example, for this wiki, you can find the installed extensions at [[Special:Version]]. At the time of writing, it looks like this:		If you use any extensions that are not bundled with MediaWiki by default, you should update them too. A list of bundled extensions can be found at https://www.mediawiki.org/wiki/Bundled_extensions_and_skins, these extensions will be updated automatically.

			However, for example, you might have the ULYSSIS extensions [[Securing MediaWiki using Centrale KU Leuven Login\|MediaWikiShibboleth]] or [https://github.com/ULYSSIS-KUL/CompressUploads CompressUploads] installed. As with MediaWiki itself, you can find the versions of your installed extensions on the <code>Special:Version</code> page, under "Installed extensions". Extensions will often link to a website where you can download the latest versions. For example, for this wiki, you can find the installed extensions at [[Special:Version]]. At the time of writing, it looks like this:

	[[File:Installed extensions.png\|center\|frame]]		[[File:Installed extensions.png\|center\|frame]]