From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id uiarE90MJWFG4AAAgWs5BA (envelope-from ) for ; Tue, 24 Aug 2021 17:14:37 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id eD7CDt0MJWFkFgAA1q6Kng (envelope-from ) for ; Tue, 24 Aug 2021 15:14:37 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id CC84D888E for ; Tue, 24 Aug 2021 17:14:36 +0200 (CEST) Received: from localhost ([::1]:35860 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mIY8J-0005PJ-Un for larch@yhetil.org; Tue, 24 Aug 2021 11:14:35 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:34764) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mIW8C-0000T9-03 for guix-devel@gnu.org; Tue, 24 Aug 2021 09:06:20 -0400 Received: from out0.migadu.com ([2001:41d0:2:267::]:41191) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mIW84-0002RV-RS for guix-devel@gnu.org; Tue, 24 Aug 2021 09:06:18 -0400 X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=churls.world; s=key1; t=1629810362; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type; bh=jx0JcOgY6ni4h2b/yShjb5ZGtdePi3YDKoAYD3WhMag=; b=QH74yKyfc5T2Y0RqELEEamTIXwkPb3GZ+PLAT2zMjmNu37bCgbI5BeIF5JEMaWNxMb3r/D szkHJyq6dm1BF6gcHo+ItojRmHpxfxIZoDERav77mWv/MAecXBVUDgPMKtyVO7PBjM6jQI JGwBA8VxBe6kGbB+afoR3Xojr0YJ2OY/u6z+4E9vIoujykHnuOaQ5H9/kHPR/v/0iuTYM+ 0CTJJZQ877RX2VhaVukIQwmHXVBKY9nYAxWq+tD3nWwiPBQqAi2SbbI2okDGeYGCJLAfKv xm78RnjYUklnneDMca2T7IRlEXDndarRuTksd1LRMrrCCx6nPpHWh8Edonp+bg== From: Grant Shoshin Shangreaux To: guix-devel@gnu.org Subject: PATCH: clarify some of the Guix Linode recipe Date: Tue, 24 Aug 2021 07:59:49 -0500 Message-ID: <85wnobt2nw.fsf@churls.world> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Migadu-Auth-User: grant@churls.world Received-SPF: pass client-ip=2001:41d0:2:267::; envelope-from=grant@churls.world; helo=out0.migadu.com X-Spam_score_int: 12 X-Spam_score: 1.2 X-Spam_bar: + X-Spam_report: (1.2 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FROM_SUSPICIOUS_NTLD=0.499, FROM_SUSPICIOUS_NTLD_FP=1.5, PDS_OTHER_BAD_TLD=1.999, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Tue, 24 Aug 2021 11:14:11 -0400 X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1629818076; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=jx0JcOgY6ni4h2b/yShjb5ZGtdePi3YDKoAYD3WhMag=; b=ElwSDqF7AHnsPp0qf93WQYFZfkS76Dpk3PR9HO1z3nIL+cMtXof5/F8yZpX3jEI7ZrGktl 8xZF09+ZfQKUsSKGNZ8tXbatx4OP2ITJMNrSoElFCMnXHDMt1fx4JBJlgZZD6xqMSwWg1h Wy7JynnzzNEbIhvmseAC7J6SpoAKalKOLJTs7dYwjcbAskWVhYLJPZiw5TC4yLbuvK55EJ i6Ovoey7gcZ8PtRpFqZtQx8iFiDJcn7frqFsVGflfFEhcXQfD3jy+QUYpooeAqs76h1t8T AjHgVUQq8Tk77BLdKODdeTSF48z3z3K5HxUrCfrwfHK2vqQBnZS/sVbhCQPd5A== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1629818076; a=rsa-sha256; cv=none; b=a84r/tVtfhruqd2pHDfAuiiCBTQo3vvBIfitxz65Bvf5Brb8y1NzqJaxKmaVf49FEOWFLU BBYh7cCuaJxw4J2ws+a1/78oEqAvKGKypyRsuU9zudQocPti/EHsu5Q8FJG6whH8/XvwXy +RjY+MVQepZd5vU6X3c+V/gqFsyhJSfU4/0EEQbqoFoQyepuwCmUG8IXz2r2lzANu8GhgP bzL9HHay5Xqjv2824lJ398hYR48L1CNZp1F+ZulLpGXtldOs+wfJ7RN0uWiCaoKCWEH/Yx eskGwUBHuLuIeJdIcL6bdQuejNIcSwyHWWRTLmOs3wvFUt7S31ihUNzOpJ4Wgw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=churls.world header.s=key1 header.b=QH74yKyf; dmarc=pass (policy=reject) header.from=churls.world; spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Migadu-Spam-Score: -3.12 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=churls.world header.s=key1 header.b=QH74yKyf; dmarc=pass (policy=reject) header.from=churls.world; spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Migadu-Queue-Id: CC84D888E X-Spam-Score: -3.12 X-Migadu-Scanner: scn0.migadu.com X-TUID: ssXjLe33+mmM --=-=-= Content-Type: text/plain 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 --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=0001-doc-add-clarifications-to-Linode-cookbook-recipe.patch Content-Description: guix cookbook patch >From 446bf79c3733936306e9fd95c46cbfd495f6bc2a Mon Sep 17 00:00:00 2001 From: Grant Shangreaux 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/_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{}}. (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{}_rsa.pub} and your +Copy your ssh public key (eg: @file{~/.ssh/id_rsa.pub}) as +@file{@var{}_rsa.pub} and put @file{guix-config.scm} in the same directory. In a new terminal run these commands. @example sftp root@@ -put /home//ssh/id_rsa.pub . -put /path/to/linode/guix-config.scm . +put /path/to/files/_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 --=-=-=--