troubleshooting/upgrade: describe "previous installation not detected" cases #418
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
stormi
reviewed
Nov 24, 2025
|
|
||
| :::note | ||
| This section details how to deal with the most frequent causes for the installer not detecting your current installation. There can be other, rarer cases which are not detailed here. | ||
| This section details how to deal with the most frequent causes for the installer not detecting your current installation. There can be other, rarer cases which are not detailed here. In all cases the detailed reason for an inability to upgrade will always be possible to find in the installer log file.See [During installation or upgrade](#during-installation-or-upgrade) to access the log file. |
Member
There was a problem hiding this comment.
Suggested change
| This section details how to deal with the most frequent causes for the installer not detecting your current installation. There can be other, rarer cases which are not detailed here. In all cases the detailed reason for an inability to upgrade will always be possible to find in the installer log file.See [During installation or upgrade](#during-installation-or-upgrade) to access the log file. | |
| This section details how to deal with the most frequent causes for the installer not detecting your current installation. There can be other, rarer cases which are not detailed here. In all cases the detailed reason for an inability to upgrade will always be possible to find in the installer log file. See [During installation or upgrade](#during-installation-or-upgrade) to access the log file. |
|
|
||
| #### Disk partitionning not recognized | ||
|
|
||
| XCP-ng is quite strict about the partition table layout, partition labels, partition types. If anything has modified it, it can prevent proper identification of the previous install. |
Member
There was a problem hiding this comment.
Suggested change
| XCP-ng is quite strict about the partition table layout, partition labels, partition types. If anything has modified it, it can prevent proper identification of the previous install. | |
| XCP-ng is quite strict about the partition table layout, partition labels, partition types. If anything has modified it, it can prevent proper identification of the previous install. |
|
|
||
| XCP-ng is quite strict about the partition table layout, partition labels, partition types. If anything has modified it, it can prevent proper identification of the previous install. | ||
|
|
||
| Log lines like the one below (taken from an upgrade of a sane 8.3 install) will give an idea whether something is wrng in this area. |
Member
There was a problem hiding this comment.
Suggested change
| Log lines like the one below (taken from an upgrade of a sane 8.3 install) will give an idea whether something is wrng in this area. | |
| Log lines like the one below (taken from an upgrade of a healthy 8.3 install) will give an idea whether something is wrong in this area. |
|
|
||
| #### Inconsistent inventory file | ||
|
|
||
| The `/etc/xensource-inventory` file is critical to the upgrade process. This is one case where a log entry reading "A problem occurred whilst scanning for existing installations:" followed by more details. |
Member
There was a problem hiding this comment.
The last sentence seems off, like it's not complete.
thomas-dkmt
reviewed
Nov 25, 2025
| ### Previous installation detected but not upgradable | ||
|
|
||
| For the installer to detect your current install (XCP-ng or XenServer), the ISO must be booted in the same firmware context. | ||
| In some cases the installer will detect a current install (XCP-ng or XenServer), but report "Only product installations that cannot be upgraded have been detected". The most common causes are listed below. |
Collaborator
There was a problem hiding this comment.
Since we're moving to a new section immediately after, we can replace "below" with an actual link to the relevant section/subsection.
Contributor
Author
There was a problem hiding this comment.
that's actually not a cross-section link but "in the following subsections", and I felt it's lighter to the reader than "in the following subsections".
thomas-dkmt
reviewed
Nov 25, 2025
|
|
||
| ### Previous installation not detected | ||
|
|
||
| In other cases the installer will fail to detect a current install and only propose fresh installations. Some causes are listed below. |
Collaborator
There was a problem hiding this comment.
Suggested change
| In other cases the installer will fail to detect a current install and only propose fresh installations. Some causes are listed below. | |
| In other cases, the installer may fail to detect an existing installation, and default to offering only a clean install. Some causes are listed below. |
Also, replace "Below" with a link to the actual subsection in the page
Contributor
Author
There was a problem hiding this comment.
"default to offering only a clean install." would be wrong, there is no other option. Changing to "only offer".
I'm not sure "clean" is a good idea here (could be perceived as "cleaning", which "fresh" cannot convey)
Signed-off-by: Yann Dirson <[email protected]>
ydirson
force-pushed
the
previous-install-not-detected
branch
from
f09b8f8 to
e2678b9
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.