Upgrade error logic mistake in error message?

Hey,

just tried to upgrade a very old instance and it failed with the error mesage below.

current:
gitlab-ee-11.11.0-ee.0.el7.x86_64
gitlab-ee-15.1.2-ee.0.el7.x86_64

The main line being:
gitlab preinstall: It seems you are upgrading from major version 11 to major version 15.
gitlab preinstall: It is required to upgrade to the latest 15.0.x version first before proceeding.

the error message does not make sense.
I believe it should read:
gitlab preinstall: It seems you are upgrading from major version 11 to major version 15.
gitlab preinstall: It is required to upgrade to the latest 11.x version first before proceeding.
(i have to upgrade 11 to latest first, before upgrading)

I have this issue resolved by upgrading to 11 latest and going from there, its just the error message is misleading and confusing. I have seen the same in other forums posts, but noone seems to comment on the version number in error message

Running transaction check
Running transaction test
Transaction test succeeded
Running transaction
gitlab preinstall: It seems you are upgrading from major version 11 to major version 15.
gitlab preinstall: It is required to upgrade to the latest 15.0.x version first before proceeding.
gitlab preinstall: Please follow the upgrade documentation at Upgrading GitLab | GitLab
error: %pre(gitlab-ee-15.1.2-ee.0.el7.x86_64) scriptlet failed, exit status 1
Error in PREIN scriptlet in rpm package gitlab-ee-15.1.2-ee.0.el7.x86_64
gitlab-ee-11.11.0-ee.0.el7.x86_64 was supposed to be removed but is not!
Verifying : gitlab-ee-11.11.0-ee.0.el7.x86_64 1/2
Verifying : gitlab-ee-15.1.2-ee.0.el7.x86_64

The error message includes a link to upgrading gitlab which shows that you have to follow the upgrade path. Because it’s not possible to upgrade from Gitlab 11.11.0 directly to 15.1.2. But I guess you didn’t bother to read the documentation or the link provided in the error?

So the error message makes complete sense. As per the docs (and the link in your post):

1 Like

Thanks iwalker! Very appreciated.

2023-01-02: Edit by @dnsmichi: Removed a GitLab Code of Conduct violation.