Skip to content

Conversation

@yblatti
Copy link

@yblatti yblatti commented Oct 30, 2025

Disclaimers : 
- I'm a hypervisor noob
- I'm not a native English speaker

While upgrading some XenServer 8.2 machines to XCP-ng using the ISO, one of them didn't offer to upgrade.
I didn't know that this machine was installed using Legacy BIOS instead UEFI.
I shamefully admit that it took me a veeeeery long time to understand what was wrong.

This PR proposes to add warning in the upgrade doc and a hint in the troubleshooting guide.

Also the "Upgrade via installation ISO" procedure linked to the download page for installation steps, which seemed to be wrong.

Before submitting the pull request, you must agree with the following statements by checking both boxes with a 'x'.

  • "I accept that my contribution is placed under the CC BY-SA 2.0 license [1]."
  • "My contribution complies with the Developer Certificate of Origin [2]."

[1] https://creativecommons.org/licenses/by-sa/2.0/
[2] https://docs.xcp-ng.org/project/contributing/#developer-certificate-of-origin-dco

yblatti and others added 4 commits October 30, 2025 12:05
… page" for procedure instead of "download page" (does not detail steps)

Signed-off-by: yblatti <[email protected]>
@yblatti yblatti force-pushed the uefi-bios-warning-in-upgrade branch from a431482 to e0f085a Compare October 30, 2025 11:06

## The ISO installer does not offer to upgrade the existing install (XCP-ng or XenServer)

For the installer to detect your current install (XCP-ng or XenServer), the ISO must be booted in the same firmware context.\
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's a trailing \.

But that's not the comment I wanted to make initially: mismatching firmware mode is not the only reason why the installer will not offer to upgrade in some cases.

For example, in some cases, the firstboot script in the previous installation never completed, which prevents the installer from detecting the existing installation.

@ydirson can likely tell more about it.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for your feedback !

[...] mismatching firmware mode is not the only reason why the installer will not offer to upgrade in some cases.
For example, in some cases, the firstboot script in the previous installation never completed, which prevents the installer from detecting the existing installation.

TBH, this is out of my league. Feel free to add any relevant information in this section. We could also change the title to a more specific one.

There's a trailing \.

The new line was added for readability. Should I remove it ?

@stormi stormi requested a review from thomas-dkmt October 30, 2025 17:18
Co-authored-by: Thomas Moraine <[email protected]>
Signed-off-by: Yves Blatti <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants