me
/
guix
Archived
1
0
Fork 0

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
Grant Shangreaux 2021-08-23 22:47:05 -05:00 committed by Ludovic Courtès
parent 16ef7b4938
commit de15397006
No known key found for this signature in database
GPG Key ID: 090B11993D9AEBB5
1 changed files with 20 additions and 17 deletions

View File

@ -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!