Re: [PATCH] Enhance USB install

[ludo@gnu.org (Ludovic Courtès)]

Hi Vincent,

Vincent Legoll <vincent.legoll@gmail.com> skribis:

> From: Vincent Legoll <vincent.legoll@idgrilles.fr>
>
> * doc/guix.texi (USB install): add download & verify subsection,
> add a section to explain how to boot a VM for guixsd installation

I pushed this as commit c8b543741f422ecf41e7635c6a1c40b3bd55947a, with
several modifications.

> +@node USB storage Installation in a VM
> +@subsection USB storage Installation in a VM

Changed the title to “Installing GuixSD in a Virtual Machine”.

> +To boot a QEmu virtual machine for installing GuixSD in a disk image, follow
> +these steps:

s/QEmu/QEMU/

> +@item
> +Ensure your running kernel has the required CONFIG_BRIDGE option for the
> +network to work properly in the virtual machine:
> +
> +@example
> +zgrep CONFIG_BRIDGE= /proc/config.gz
> +CONFIG_BRIDGE=y
> +@end example
> +
> +If it is compiled as a module & loaded, it will also work:
> +
> +@example
> +zgrep CONFIG_BRIDGE= /proc/config.gz
> +CONFIG_BRIDGE=m
> +lsmod | grep ^bridge
> +bridge 117542 0
> +@end example

I removed this bit because in my experience it’s not necessary.  Or am I
overlooking something?

> +@item
> +Boot a virtual machine with the USB installation image
> +
> +@example
> +qemu-system-x86_64 -m 1024 -smp 1 -net default -net nic,model=virtio -boot menu=on \
> +  -drive file=guixsd-x86_64-raw.img \
> +  -drive file=guixsd-usb-install-@value{VERSION}.@var{system}
> +@end example
> +
> +In the VM console, quickly press the <F12> key to enter the boot menu.  Then
> +press the <2> key and the <ENTER> key to validate your selection.

Added a couple of @kbd.

> +@end enumerate
> +
> +You're now root in the VM, proceed with the installation process.

Added cross-ref to “Running GuixSD in a VM”.

This is a valuable addition, but I guess many people want to try GuixSD
in a VM first.

Thank you!

Ludo’.