doc: Add "Installing GuixSD in a VM" node.

* doc/guix.texi (Installing GuixSD in a VM): New node.
(USB Stick Installation): Refer to it.
(System Installation): Mention "GuixSD".

Co-authored-by: Ludovic Courtès <ludo@gnu.org>
This commit is contained in:
Vincent Legoll 2016-07-13 16:24:08 +02:00 committed by Ludovic Courtès
parent 873b51b340
commit c8b543741f
No known key found for this signature in database
GPG Key ID: 090B11993D9AEBB5
1 changed files with 54 additions and 1 deletions

View File

@ -187,6 +187,7 @@ System Installation
* USB Stick Installation:: Preparing the installation medium. * USB Stick Installation:: Preparing the installation medium.
* Preparing for Installation:: Networking, partitioning, etc. * Preparing for Installation:: Networking, partitioning, etc.
* Proceeding with the Installation:: The real thing. * Proceeding with the Installation:: The real thing.
* Installing GuixSD in a VM:: GuixSD playground.
* Building the Installation Image:: How this comes to be. * Building the Installation Image:: How this comes to be.
System Configuration System Configuration
@ -6029,7 +6030,7 @@ to join! @xref{Contributing}, for information about how you can help.
@section System Installation @section System Installation
@cindex Guix System Distribution @cindex Guix System Distribution
This section explains how to install the Guix System Distribution This section explains how to install the Guix System Distribution (GuixSD)
on a machine. The Guix package manager can on a machine. The Guix package manager can
also be installed on top of a running GNU/Linux system, also be installed on top of a running GNU/Linux system,
@pxref{Installation}. @pxref{Installation}.
@ -6054,6 +6055,7 @@ available.
* USB Stick Installation:: Preparing the installation medium. * USB Stick Installation:: Preparing the installation medium.
* Preparing for Installation:: Networking, partitioning, etc. * Preparing for Installation:: Networking, partitioning, etc.
* Proceeding with the Installation:: The real thing. * Proceeding with the Installation:: The real thing.
* Installing GuixSD in a VM:: GuixSD playground.
* Building the Installation Image:: How this comes to be. * Building the Installation Image:: How this comes to be.
@end menu @end menu
@ -6199,6 +6201,9 @@ Once this is done, you should be able to reboot the system and boot from
the USB stick. The latter usually requires you to get in the BIOS' boot the USB stick. The latter usually requires you to get in the BIOS' boot
menu, where you can choose to boot from the USB stick. menu, where you can choose to boot from the USB stick.
@xref{Installing GuixSD in a VM}, if, instead, you would like to install
GuixSD in a virtual machine (VM).
@node Preparing for Installation @node Preparing for Installation
@subsection Preparing for Installation @subsection Preparing for Installation
@ -6456,6 +6461,54 @@ Join us on @code{#guix} on the Freenode IRC network or on
@file{guix-devel@@gnu.org} to share your experience---good or not so @file{guix-devel@@gnu.org} to share your experience---good or not so
good. good.
@node Installing GuixSD in a VM
@subsection Installing GuixSD in a Virtual Machine
@cindex virtual machine, GuixSD installation
If you'd like to install GuixSD in a virtual machine (VM) rather than on
your beloved machine, this section is for you.
To boot a @uref{http://qemu.org/,QEMU} VM for installing GuixSD in a
disk image, follow these steps:
@enumerate
@item
First, retrieve the GuixSD installation image as described previously
(@pxref{USB Stick Installation}).
@item
Create a disk image that will hold the installed system. To make a
qcow2-formatted disk image, use the @command{qemu-img} command:
@example
qemu-img create -f qcow2 guixsd.img 5G
@end example
This will create a 5GB file.
@item
Boot the USB installation image in an VM:
@example
qemu-system-x86_64 -m 1024 -smp 1 \
-net default -net nic,model=virtio -boot menu=on \
-drive file=guixsd.img \
-drive file=guixsd-usb-install-@value{VERSION}.@var{system}
@end example
In the VM console, quickly press the @kbd{F12} key to enter the boot
menu. Then press the @kbd{2} key and the @kbd{RET} key to validate your
selection.
@item
You're now root in the VM, proceed with the installation process.
@xref{Preparing for Installation}, and follow the instructions.
@end enumerate
Once installation is complete, you can boot the system that's on your
@file{guixsd.img} image. @xref{Running GuixSD in a VM}, for how to do
that.
@node Building the Installation Image @node Building the Installation Image
@subsection Building the Installation Image @subsection Building the Installation Image