WiP: rework migrate to XCP-ng documentation by AtaxyaNetwork · Pull Request #346 · xcp-ng/xcp-ng-org

AtaxyaNetwork · 2025-05-26T12:24:16Z

Work in progress.

I added Prerequisites and Troubleshooting section, and rearrange/rewrite the other

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

docs/installation/migrate-to-xcp-ng.md

Signed-off-by: Cécile - AtaxyaNetwork <contact@ataxya.net>

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net> Signed-off-by: Cécile - AtaxyaNetwork <contact@ataxya.net>

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net>

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net> Signed-off-by: Cécile - AtaxyaNetwork <contact@ataxya.net>

Signed-off-by: Cécile Morange <contact@ataxya.net> Signed-off-by: Cécile - AtaxyaNetwork <contact@ataxya.net>

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net>

AtaxyaNetwork · 2025-06-16T13:51:37Z

All suggestion are reviewed !

docs/installation/migrate-to-xcp-ng.md

stormi · 2025-06-16T14:00:42Z

All suggestion are reviewed !

But it's still marked WIP. Main reason for which I haven't reviewed yet.

docs/installation/migrate-to-xcp-ng.md

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net>

AtaxyaNetwork · 2025-06-17T09:44:13Z

@stormi it marked it as WiP because I didn't want someone merging it without having some proofreading and opinion from other people.

stormi · 2025-06-17T09:46:13Z

@stormi it marked it as WiP because I didn't want someone merging it without having some proofreading and opinion from other people.

Just ask people for review, we'll not merge until it's reviewed.

In our processes, WIP usually means "I still have work to do on this". So I usually wait before I review.

rzr · 2025-12-24T09:06:11Z

I noticed this PR has been stalling for months and has the WIP keyword, and base is outdated
please mark it as draft if it not supposed to be merged yet, it will help reviewers to focus on the mergeables ones.

rzr · 2025-12-24T09:10:04Z

docs/installation/migrate-to-xcp-ng.md

+
+### Uninstall Existing Guest Tools
+
+To avoid conflicts with XCP-ng guest tools, uninstall any existing VM tools (such as VMware Tools or QEMU Guest Agent) from the VM.


Example command lines will not hurt (at least for common OSes)

rzr · 2025-12-24T09:11:00Z

docs/installation/migrate-to-xcp-ng.md

+Before shutting down the VM, run this command to install the drivers:
+
+```
+dracut --add-drivers "xen-blkfront xen-netfront" --force


Is force really needed ? we could try without first eg:

dracut --add-drivers "xen-blkfront xen-netfront" \ || dracut --add-drivers "xen-blkfront xen-netfront" --force

rzr · 2025-12-24T09:13:00Z

docs/installation/migrate-to-xcp-ng.md

+Next, run this command to convert the QCOW2 disk to a VHD format:
+
+```
+qemu-img convert -O vpc disk.qcow2 `uuidgen`.vhd


Suggested change

qemu-img convert -O vpc disk.qcow2 `uuidgen`.vhd

qemu-img convert -p -O vpc disk.qcow2 `uuidgen`.vhd

This will show progress to user

docs/installation/migrate-to-xcp-ng.md

rzr · 2025-12-24T09:19:37Z

docs/installation/migrate-to-xcp-ng.md


-    `vhd-util check -n myvm.vhd` should return `myvm.vhd is valid`
+```
+scp thegenerateduuid.vhd ip.xcp-ng.server:/run/sr-mount/uuid-of-your-SR


Suggested change

scp thegenerateduuid.vhd ip.xcp-ng.server:/run/sr-mount/uuid-of-your-SR

scp -v thegenerateduuid.vhd ip.xcp-ng.server:/run/sr-mount/uuid-of-your-SR/

rzr · 2025-12-24T09:21:12Z

docs/installation/migrate-to-xcp-ng.md

+- Check [here](../../installation/migrate-to-xcp-ng/#error-dracut-initqueue227-warning-devmapperol-root-does-not-exist-or-no-bootable-device)

-* Boot the VM and find a way to enter in the virtual UEFI of the VM. Here, I type the Escape and F9,F10,F11,F12 keys like crazy. Select Boot Manager, you should see this window :
+### Error "dracut-initqueue[227]: Warning: /dev/mapper/ol-root does not exist" (or no bootable device)


Suggested change

### Error "dracut-initqueue[227]: Warning: /dev/mapper/ol-root does not exist" (or no bootable device)

### Error "dracut-initqueue: Warning: /dev/mapper/ol-root does not exist" (or no bootable device)

I believe 227 is a process ID, if yes it is misleading here

rzr · 2025-12-24T09:22:15Z

docs/installation/migrate-to-xcp-ng.md

-* Install Guest Tools and reboot. The reboot shouldn't take long, you don't have to redo step 13, the OS seems to have repair the boot sequence by itself.
+for x in sys proc run dev tmp; do mount --bind /$x /mnt/$x; done
+```
+Check your fstab to see the exact layout of your partition!


Suggested change

Check your fstab to see the exact layout of your partition!

Check your /etc/fstab to see the exact layout of your partition!

AtaxyaNetwork force-pushed the master branch from 0a0b921 to c69771c Compare May 26, 2025 12:27

thomas-dkmt reviewed May 26, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Show resolved Hide resolved

thomas-dkmt reviewed May 26, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

thomas-dkmt reviewed Jun 3, 2025

View reviewed changes

docs/installation/migrate-to-xcp-ng.md Outdated Show resolved Hide resolved

AtaxyaNetwork and others added 5 commits June 16, 2025 15:06

WiP: rework migrate to XCP-ng documentation

e7e87d9

Signed-off-by: Cécile - AtaxyaNetwork <contact@ataxya.net>

Update docs/installation/migrate-to-xcp-ng.md

083e9d4

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net> Signed-off-by: Cécile - AtaxyaNetwork <contact@ataxya.net>

Update docs/installation/migrate-to-xcp-ng.md

920a336

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net> Signed-off-by: Cécile - AtaxyaNetwork <contact@ataxya.net>

Update docs/installation/migrate-to-xcp-ng.md

a486499

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net> Signed-off-by: Cécile - AtaxyaNetwork <contact@ataxya.net>

Update docs/installation/migrate-to-xcp-ng.md

bebaf2b

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net> Signed-off-by: Cécile - AtaxyaNetwork <contact@ataxya.net>

AtaxyaNetwork force-pushed the master branch from 60f8a97 to bebaf2b Compare June 16, 2025 13:06

AtaxyaNetwork and others added 7 commits June 16, 2025 15:08

Update docs/installation/migrate-to-xcp-ng.md

62adcb4

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net>

Update docs/installation/migrate-to-xcp-ng.md

a65b7c5

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net>

Update docs/installation/migrate-to-xcp-ng.md

f9be311

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net>

Update docs/installation/migrate-to-xcp-ng.md

0b9505a

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net>

Update docs/installation/migrate-to-xcp-ng.md

d7b2045

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net>

Update docs/installation/migrate-to-xcp-ng.md

3d90e12

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net> Signed-off-by: Cécile - AtaxyaNetwork <contact@ataxya.net>

Changes suggested by Thomas

a3d4963

Signed-off-by: Cécile Morange <contact@ataxya.net> Signed-off-by: Cécile - AtaxyaNetwork <contact@ataxya.net>

AtaxyaNetwork force-pushed the master branch from ca5cded to a3d4963 Compare June 16, 2025 13:50

Update docs/installation/migrate-to-xcp-ng.md

c3781c5

Co-authored-by: Thomas Moraine <thomas.moraine@vates.tech> Signed-off-by: Cécile Morange <contact@ataxya.net>

thomas-dkmt reviewed Jun 16, 2025

View reviewed changes