doc: add clarifications to Linode cookbook recipe
* doc/guix-cookbook.texi: clarify Linode recipe Reword paragraph about adding the Guix device disk to Debian config. Improve example commands for sftp-ing files to the server. Minor wording fixes Signed-off-by: Ludovic Courtès <ludo@gnu.org>master
parent
16ef7b4938
commit
de15397006
|
@ -2050,10 +2050,12 @@ Copy into it the output of:
|
||||||
cat ~/.ssh/<username>_rsa.pub
|
cat ~/.ssh/<username>_rsa.pub
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
Power the Linode down. In the Linode's Disks/Configurations tab, resize
|
Power the Linode down.
|
||||||
the Debian disk to be smaller. 30 GB is recommended.
|
|
||||||
|
In the Linode's Storage tab, resize the Debian disk to be smaller.
|
||||||
|
30 GB free space is recommended. Then click "Add a disk", and fill
|
||||||
|
out the form with the following:
|
||||||
|
|
||||||
In the Linode settings, "Add a disk", with the following:
|
|
||||||
@itemize @bullet
|
@itemize @bullet
|
||||||
@item
|
@item
|
||||||
Label: "Guix"
|
Label: "Guix"
|
||||||
|
@ -2065,9 +2067,9 @@ Filesystem: ext4
|
||||||
Set it to the remaining size
|
Set it to the remaining size
|
||||||
@end itemize
|
@end itemize
|
||||||
|
|
||||||
On the "configuration" field that comes with the default image, press
|
In the Configurations tab, press "Edit" on the default Debian profile.
|
||||||
"..." and select "Edit", then on that menu add to @file{/dev/sdc} the "Guix"
|
Under "Block Device Assignment" click "Add a Device". It should be
|
||||||
label.
|
@file{/dev/sdc} and you can select the "Guix" disk. Save Changes.
|
||||||
|
|
||||||
Now "Add a Configuration", with the following:
|
Now "Add a Configuration", with the following:
|
||||||
@itemize @bullet
|
@itemize @bullet
|
||||||
|
@ -2093,8 +2095,8 @@ Root device: @file{/dev/sda}
|
||||||
Turn off all the filesystem/boot helpers
|
Turn off all the filesystem/boot helpers
|
||||||
@end itemize
|
@end itemize
|
||||||
|
|
||||||
Now power it back up, picking the Debian configuration. Once it's
|
Now power it back up, booting with the Debian configuration. Once it's
|
||||||
booted up, ssh in your server via @code{ssh
|
running, ssh to your server via @code{ssh
|
||||||
root@@@var{<your-server-IP-here>}}. (You can find your server IP address in
|
root@@@var{<your-server-IP-here>}}. (You can find your server IP address in
|
||||||
your Linode Summary section.) Now you can run the "install guix from
|
your Linode Summary section.) Now you can run the "install guix from
|
||||||
@pxref{Binary Installation,,, guix, GNU Guix}" steps:
|
@pxref{Binary Installation,,, guix, GNU Guix}" steps:
|
||||||
|
@ -2183,19 +2185,20 @@ Replace the following fields in the above configuration:
|
||||||
@end lisp
|
@end lisp
|
||||||
|
|
||||||
The last line in the above example lets you log into the server as root
|
The last line in the above example lets you log into the server as root
|
||||||
and set the initial root password. After you have done this, you may
|
and set the initial root password (see the note at the end of this
|
||||||
|
recipe about root login). After you have done this, you may
|
||||||
delete that line from your configuration and reconfigure to prevent root
|
delete that line from your configuration and reconfigure to prevent root
|
||||||
login.
|
login.
|
||||||
|
|
||||||
Save your ssh public key (eg: @file{~/.ssh/id_rsa.pub}) as
|
Copy your ssh public key (eg: @file{~/.ssh/id_rsa.pub}) as
|
||||||
@file{@var{<your-username-here>}_rsa.pub} and your
|
@file{@var{<your-username-here>}_rsa.pub} and put
|
||||||
@file{guix-config.scm} in the same directory. In a new terminal run
|
@file{guix-config.scm} in the same directory. In a new terminal run
|
||||||
these commands.
|
these commands.
|
||||||
|
|
||||||
@example
|
@example
|
||||||
sftp root@@<remote server ip address>
|
sftp root@@<remote server ip address>
|
||||||
put /home/<username>/ssh/id_rsa.pub .
|
put /path/to/files/<username>_rsa.pub .
|
||||||
put /path/to/linode/guix-config.scm .
|
put /path/to/files/guix-config.scm .
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
In your first terminal, mount the guix drive:
|
In your first terminal, mount the guix drive:
|
||||||
|
@ -2205,9 +2208,9 @@ mkdir /mnt/guix
|
||||||
mount /dev/sdc /mnt/guix
|
mount /dev/sdc /mnt/guix
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
Due to the way we set things up above, we do not install GRUB
|
Due to the way we set up the bootloader section of the guix-config.scm,
|
||||||
completely. Instead we install only our grub configuration file. So we
|
only the grub configuration file will be installed. So, we need to copy
|
||||||
need to copy over some of the other GRUB stuff that is already there:
|
over some of the other GRUB stuff already installed on the Debian system:
|
||||||
|
|
||||||
@example
|
@example
|
||||||
mkdir -p /mnt/guix/boot/grub
|
mkdir -p /mnt/guix/boot/grub
|
||||||
|
@ -2260,7 +2263,7 @@ still need to set your root and user password initially by clicking on
|
||||||
the ``Launch Console'' option in your linode. Choose the ``Glish''
|
the ``Launch Console'' option in your linode. Choose the ``Glish''
|
||||||
instead of ``Weblish''. Now you should be able to ssh into the machine.
|
instead of ``Weblish''. Now you should be able to ssh into the machine.
|
||||||
|
|
||||||
Horray! At this point you can shut down the server, delete the
|
Hooray! At this point you can shut down the server, delete the
|
||||||
Debian disk, and resize the Guix to the rest of the size.
|
Debian disk, and resize the Guix to the rest of the size.
|
||||||
Congratulations!
|
Congratulations!
|
||||||
|
|
||||||
|
|
Reference in New Issue