19.04 README says direct upgrade from 15.04.0 and later, but upgrade.php says must upgrade to 17.04.0 first.

[Marcus Leonard]

OS: RHEL 7
Apache 2.4
PHP (starting from 5.6, upgrading to 7.0 for 19.04).

Current Mahara version: 15.10.1.
Upgrading to version: 19.04.0.

The 19.04 README (https://git.mahara.org/mahara/mahara/blob/19.04_STABLE/README.md) says:
"Mahara 19.04 supports direct upgrades from previous Mahara versions 15.04.0 and later."

When I run the 19.04.0 upgrade
su -s /bin/bash apache -c "/usr/bin/php /srv/www/mahara/19.04.0/htdocs/admin/cli/upgrade.php"

It fails with:

[WAR] e8 (lib/upgrade.php:87) Must upgrade to 2017031605 (17.04.0 (release tag 17.04.0_RELEASE)) first (you have 2015092912 (15.10.1)
Call stack (most recent first):
  * check_upgrades() at /srv/www/mahara/mahara-19.04.0/htdocs/admin/cli/upgrade.php:40

Must upgrade to 2017031605 (17.04.0 (release tag 17.04.0_RELEASE)) first (you have 2015092912 (15.10.1)

So I guess someone should fix the README. Or the code. My vote is for the code. Fewer steps for us. :-)

Cheers,
Marcus

[Kristina Hoeppner (kris-hoeppner)]

Hi Marcus,

Thank you for spotting this oversight. We'll update the Readme file. Direct upgrades from older versions of Mahara get increasingly difficult the further the versions are away due to the amount of changes. A stepped upgrade is better.

Great to read though that you are upgrading to a supported version. :-)

Cheers
Kristina

[Mahara Bot (dev-mahara)]

Patch for "19.04_STABLE" branch: https://reviews.mahara.org/10062

[Mahara Bot (dev-mahara)]

Patch for "master" branch: https://reviews.mahara.org/10063

[Marcus Leonard (marcus-leonard)]

Hi Kristina,

I know, right? Finally getting off a legacy platform, so uplifting to versions of PHP and Postgresql needed for latest Mahara are now possible.

Cheers,
Marcus

[Marcus Leonard (marcus-leonard)]

I should probably add that every time I've tried to upgrade Mahara, I've hit the same problem: there's a mismatch between the documentation and the actual upgrade path.

"Upgrade to 1.10+ fails on Postgres <9.1"
https://bugs.launchpad.net/mahara/+bug/1517658
 - Docs said postgres version supported, but upgrade failed. In this case, a patch was provided by Catalyst and the upgrade proceeded.

"Upgrade to 17.04 fails on Postgres 8"
https://bugs.launchpad.net/mahara/+bug/1700893
 - Docs said postgres version supported, but upgrade failed. Postgres version actually was not supported.

"19.04 README says direct upgrade from 15.04.0 and later, but upgrade.php says must upgrade to 17.04.0 first" (This one.)
https://bugs.launchpad.net/mahara/+bug/1830847
- Docs said direct upgrade, but intermediate step was required.

It could be worth adding a step in the release process to check these things off. People like me (or not like me) do upgrade planning based on the system requirements, so it matters that they're correct.
This is probably kind of obvious, but, after bumping into this three times, it seems worth a mention.

Cheers,
Marcus

[Mahara Bot (dev-mahara)]

Patch for "18.04_STABLE" branch: https://reviews.mahara.org/10173

[Mahara Bot (dev-mahara)]

Patch for "18.10_STABLE" branch: https://reviews.mahara.org/10174

[Mahara Bot (dev-mahara)]

Patch for "19.04_STABLE" branch: https://reviews.mahara.org/10175

[Mahara Bot (dev-mahara)]

Patch for "master" branch: https://reviews.mahara.org/10176

[Mahara Bot (dev-mahara)]

Reviewed: https://reviews.mahara.org/10176
Committed: https://git.mahara.org/mahara/mahara/commit/792c6c2ac62b20dbd2b4c586dd33df434cd345b7
Submitter: Cecilia Vela Gurovic (<email address hidden>)
Branch: master

commit 792c6c2ac62b20dbd2b4c586dd33df434cd345b7
Author: Robert Lyon <email address hidden>
Date: Wed Jul 17 16:27:10 2019 +1200

Bug 1830847: Update info about upgrade

behatnotneeded

Change-Id: I776133d0e5211e130337c22cf436a4b0b87ce75a
Signed-off-by: Robert Lyon <email address hidden>

[Mahara Bot (dev-mahara)]

Reviewed: https://reviews.mahara.org/10175
Committed: https://git.mahara.org/mahara/mahara/commit/0f0d5b54214545b4eee0a0417699a285b8f211fe
Submitter: Cecilia Vela Gurovic (<email address hidden>)
Branch: 19.04_STABLE

commit 0f0d5b54214545b4eee0a0417699a285b8f211fe
Author: Robert Lyon <email address hidden>
Date: Wed Jul 17 16:22:57 2019 +1200

Bug 1830847: Update info about upgrade

behatnotneeded

Change-Id: I776133d0e5211e130337c22cf436a4b0b87ce75a
Signed-off-by: Robert Lyon <email address hidden>

[Mahara Bot (dev-mahara)]

Reviewed: https://reviews.mahara.org/10173
Committed: https://git.mahara.org/mahara/mahara/commit/59174f8d7595e7919f1c55423528a79adb7f25b9
Submitter: Cecilia Vela Gurovic (<email address hidden>)
Branch: 18.04_STABLE

commit 59174f8d7595e7919f1c55423528a79adb7f25b9
Author: Robert Lyon <email address hidden>
Date: Wed Jul 17 16:10:44 2019 +1200

Bug 1830847: Update info about upgrade

behatnotneeded

Change-Id: I776133d0e5211e130337c22cf436a4b0b87ce75a
Signed-off-by: Robert Lyon <email address hidden>

[Mahara Bot (dev-mahara)]

Reviewed: https://reviews.mahara.org/10174
Committed: https://git.mahara.org/mahara/mahara/commit/e413627f01bd20ed08a1c3320fb200210e5d508e
Submitter: Cecilia Vela Gurovic (<email address hidden>)
Branch: 18.10_STABLE

commit e413627f01bd20ed08a1c3320fb200210e5d508e
Author: Robert Lyon <email address hidden>
Date: Wed Jul 17 16:10:44 2019 +1200

Bug 1830847: Update info about upgrade

behatnotneeded

Change-Id: I776133d0e5211e130337c22cf436a4b0b87ce75a
Signed-off-by: Robert Lyon <email address hidden>