PATCH: clarify some of the Guix Linode recipe

PATCH: clarify some of the Guix Linode recipe

[Grant Shoshin Shangreaux]

[-- Attachment #1: Type: text/plain, Size: 485 bytes --]


Hello! I hope I'm not double posting, but I think the email I intended
to send before never made it out of my outbox. I recently set up GuixSD
on Linode following the cookbook. I hit a few snags along the way where
I either missed something or misunderstood, so I thought I'd offer a
patch with a few clarifications to the article. Some of it is likely due
to changes in the Linode UI. Hopefully this patch is helpful.

Thanks for Guix and the great docs everyone!

Grant Shangreaux


[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: guix cookbook patch --]
[-- Type: text/x-diff, Size: 4331 bytes --]

From 446bf79c3733936306e9fd95c46cbfd495f6bc2a Mon Sep 17 00:00:00 2001
From: Grant Shangreaux <grant@unabridgedsoftware.com>
Date: Mon, 23 Aug 2021 22:47:05 -0500
Subject: [PATCH] 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
---
 doc/guix-cookbook.texi | 37 ++++++++++++++++++++-----------------
 1 file changed, 20 insertions(+), 17 deletions(-)

diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi
index 5b1b4b5ea9..849072189d 100644
--- a/doc/guix-cookbook.texi
+++ b/doc/guix-cookbook.texi
@@ -2050,10 +2050,12 @@ Copy into it the output of:
 cat ~/.ssh/<username>_rsa.pub
 @end example
 
-Power the Linode down. In the Linode's Disks/Configurations tab, resize
-the Debian disk to be smaller. 30 GB is recommended.
+Power the Linode down.
+
+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
 @item
 Label: "Guix"
@@ -2065,9 +2067,9 @@ Filesystem: ext4
 Set it to the remaining size
 @end itemize
 
-On the "configuration" field that comes with the default image, press
-"..." and select "Edit", then on that menu add to @file{/dev/sdc} the "Guix"
-label.
+In the Configurations tab, press "Edit" on the default Debian profile.
+Under "Block Device Assignment" click "Add a Device". It should be
+@file{/dev/sdc} and you can select the "Guix" disk. Save Changes.
 
 Now "Add a Configuration", with the following:
 @itemize @bullet
@@ -2093,8 +2095,8 @@ Root device: @file{/dev/sda}
 Turn off all the filesystem/boot helpers
 @end itemize
 
-Now power it back up, picking the Debian configuration.  Once it's
-booted up, ssh in your server via @code{ssh
+Now power it back up, booting with the Debian configuration.  Once it's
+running, ssh to your server via @code{ssh
 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
 @pxref{Binary Installation,,, guix, GNU Guix}" steps:
@@ -2183,19 +2185,20 @@ Replace the following fields in the above configuration:
 @end lisp
 
 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
 login.
 
-Save your ssh public key (eg: @file{~/.ssh/id_rsa.pub}) as
-@file{@var{<your-username-here>}_rsa.pub} and your
+Copy your ssh public key (eg: @file{~/.ssh/id_rsa.pub}) as
+@file{@var{<your-username-here>}_rsa.pub} and put
 @file{guix-config.scm} in the same directory.  In a new terminal run
 these commands.
 
 @example
 sftp root@@<remote server ip address>
-put /home/<username>/ssh/id_rsa.pub .
-put /path/to/linode/guix-config.scm .
+put /path/to/files/<username>_rsa.pub .
+put /path/to/files/guix-config.scm .
 @end example
 
 In your first terminal, mount the guix drive:
@@ -2205,9 +2208,9 @@ mkdir /mnt/guix
 mount /dev/sdc /mnt/guix
 @end example
 
-Due to the way we set things up above, we do not install GRUB
-completely.  Instead we install only our grub configuration file.  So we
-need to copy over some of the other GRUB stuff that is already there:
+Due to the way we set up the bootloader section of the guix-config.scm,
+only the grub configuration file will be installed.  So, we need to copy
+over some of the other GRUB stuff already installed on the Debian system:
 
 @example
 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''
 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.
 Congratulations!
 
-- 
2.20.1

Re: PATCH: clarify some of the Guix Linode recipe

[Ludovic Courtès]

Hi Grant,

Grant Shoshin Shangreaux <grant@churls.world> skribis:

> Hello! I hope I'm not double posting, but I think the email I intended
> to send before never made it out of my outbox. I recently set up GuixSD
> on Linode following the cookbook. I hit a few snags along the way where
> I either missed something or misunderstood, so I thought I'd offer a
> patch with a few clarifications to the article. Some of it is likely due
> to changes in the Linode UI. Hopefully this patch is helpful.

Looks like this message fell through the summer cracks…

> From 446bf79c3733936306e9fd95c46cbfd495f6bc2a Mon Sep 17 00:00:00 2001
> From: Grant Shangreaux <grant@unabridgedsoftware.com>
> Date: Mon, 23 Aug 2021 22:47:05 -0500
> Subject: [PATCH] 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

This looks like a welcome improvement, so I went ahead and applied it.
(Cc’ing Joshua, who originally wrote this section.)

Thanks!

Ludo’.

Re: PATCH: clarify some of the Guix Linode recipe

[jbranso]

September 8, 2021 4:37 PM, "Ludovic Courtès" <ludo@gnu.org> wrote:

> Hi Grant,
> 
> Grant Shoshin Shangreaux <grant@churls.world> skribis:
> 
>> Hello! I hope I'm not double posting, but I think the email I intended
>> to send before never made it out of my outbox. I recently set up GuixSD
>> on Linode following the cookbook. I hit a few snags along the way where
>> I either missed something or misunderstood, so I thought I'd offer a
>> patch with a few clarifications to the article. Some of it is likely due
>> to changes in the Linode UI. Hopefully this patch is helpful.
> 
> Looks like this message fell through the summer cracks…
> 
>> From 446bf79c3733936306e9fd95c46cbfd495f6bc2a Mon Sep 17 00:00:00 2001
>> From: Grant Shangreaux <grant@unabridgedsoftware.com>
>> Date: Mon, 23 Aug 2021 22:47:05 -0500
>> Subject: [PATCH] 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
> 
> This looks like a welcome improvement, so I went ahead and applied it.
> (Cc’ing Joshua, who originally wrote this section.)

Thanks Ludo!  You're 10x as productive as me!

> 
> Thanks!
> 
> Ludo’.