patch doc: more on binaryinstallation

patch doc: more on binaryinstallation

[myglc2]

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

A patch to address issues raised in bug#22695.

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-doc-more-on-binary-installation.patch --]
[-- Type: text/x-patch, Size: 3213 bytes --]

From 4f4f2ddd383e9a07a906f4da375a5b53fe792ab0 Mon Sep 17 00:00:00 2001
From: George Clemmer <myglc2@gmail.com>
Date: Thu, 18 Feb 2016 11:48:28 -0500
Subject: [PATCH] doc: more on binary installation

* doc/guix.texi (Binary Installation): automatically start on boot, what
  users need to do next, confirm guix is working, don't uninstall guix,
  drop tarbar (re)production.
---
 doc/guix.texi | 46 ++++++++++++++++++++++++++++------------------
 1 file changed, 28 insertions(+), 18 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index c5a7de7..73dc401 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -377,19 +377,22 @@ Create the group and user accounts for build users as explained below
 (@pxref{Build Environment Setup}).
 
 @item
-Run the daemon:
+Run and set the Guix daemon to automatically start on boot.
+
+If your host distro uses the systemd init system:
 
 @example
-# ~root/.guix-profile/bin/guix-daemon --build-users-group=guixbuild
+# cp ~root/.guix-profile/lib/systemd/system/guix-daemon.service \
+        /etc/systemd/system/
+# systemctl start guix-daemon && systemctl enable guix-daemon
 @end example
 
-On hosts using the systemd init system, drop
-@file{~root/.guix-profile/lib/systemd/system/guix-daemon.service} in
-@file{/etc/systemd/system}.
+If your host distro uses the Upstart init system:
 
-Likewise, on hosts using the Upstart init system, drop
-@file{~root/.guix-profile/lib/upstart/system/guix-daemon.conf} in
-@file{/etc/init}.
+@example
+# ~root/.guix-profile/bin/guix-daemon --build-users-group=guixbuild
+# cp ~root/.guix-profile/lib/upstart/system/guix-daemon.conf /etc/init/
+@end example
 
 @item
 Make the @command{guix} command available to other users on the machine,
@@ -425,21 +428,28 @@ authorize them:
 @end example
 @end enumerate
 
-And that's it!  For additional tips and tricks, @pxref{Application
-Setup}.
-
-The @code{guix} package must remain available in @code{root}'s
-profile, or it would become subject to garbage collection---in which
-case you would find yourself badly handicapped by the lack of the
-@command{guix} command.
+This completes root-level install of Guix. Each user will need to
+perform additional steps to make their Guix envionment ready for use,
+@pxref{Application Setup}.
 
-The tarball in question can be (re)produced and verified simply by
-running the following command in the Guix source tree:
+You can confirm that Guix is working by installing a sample package into
+the root profile:
 
 @example
-make guix-binary.@var{system}.tar.xz
+# guix package -i hello
 @end example
 
+If your host distro uses @code{locales} that are incompatible with the
+@code{glibc} that Guix uses, you will see @code{warning: failed to
+install locale: Invalid argument}.  This may be ignored, or remedied by
+installing Locales as root, @pxref{Application Setup}.
+
+The @code{guix} package must remain available in @code{root}'s profile,
+or it would become subject to garbage collection---in which case you
+would find yourself badly handicapped by the lack of the @command{guix}
+command. In other words, don't remove @code{guix} by running @code{guix
+package -r guix}.
+
 
 @node Requirements
 @section Requirements
-- 
2.6.3

Re: patch doc: more on binaryinstallation

[Andreas Enge]

On Thu, Feb 18, 2016 at 11:58:49AM -0500, myglc2 wrote:
> A patch to address issues raised in bug#22695.

Thanks, I modified mainly the commit message a bit and pushed.
This is quite useful, being used to the old init scripts, I would not
have guessed that additional action is needed apart from copying the file.
(Thanks also to the others who pointed it out.)

Can we close the bug report now, or do you think there are more things
to be clarified?

Andreas

Re: patch doc: more on binaryinstallation

[Ludovic Courtès]

myglc2 <myglc2@gmail.com> skribis:

> From 4f4f2ddd383e9a07a906f4da375a5b53fe792ab0 Mon Sep 17 00:00:00 2001
> From: George Clemmer <myglc2@gmail.com>
> Date: Thu, 18 Feb 2016 11:48:28 -0500
> Subject: [PATCH] doc: more on binary installation
>
> * doc/guix.texi (Binary Installation): automatically start on boot, what
>   users need to do next, confirm guix is working, don't uninstall guix,
>   drop tarbar (re)production.

Thanks for looking into it, these are useful improvements!

I see this patch was pushed, but I took the freedom to amend a few
things in commit bf98aea:

> +If your host distro uses the Upstart init system:
>  
> -Likewise, on hosts using the Upstart init system, drop
> -@file{~root/.guix-profile/lib/upstart/system/guix-daemon.conf} in
> -@file{/etc/init}.
> +@example
> +# ~root/.guix-profile/bin/guix-daemon --build-users-group=guixbuild
> +# cp ~root/.guix-profile/lib/upstart/system/guix-daemon.conf /etc/init/

This was incorrect (missing ‘start guix-daemon’, etc.)

> +If your host distro uses @code{locales} that are incompatible with the
> +@code{glibc} that Guix uses, you will see @code{warning: failed to
> +install locale: Invalid argument}.  This may be ignored, or remedied by
> +installing Locales as root, @pxref{Application Setup}.

This is not quite correct, and “Application Setup” already has it:

  Packages installed via Guix will not use the locale data of the host
  system.  Instead, you must first install one of the locale packages
  available with Guix and then define the ‘GUIX_LOCPATH’ environment
  variable:

I don’t think we must repeat it here.

(Besides, there were incorrect uses of @code in this paragraph.)

Ludo’.