From mboxrd@z Thu Jan 1 00:00:00 1970 From: myglc2 Subject: patch doc: more on binaryinstallation Date: Thu, 18 Feb 2016 11:58:49 -0500 Message-ID: <87oabehs52.fsf@gmail.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:36563) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aWRud-0004iZ-Ac for guix-devel@gnu.org; Thu, 18 Feb 2016 11:58:44 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aWRua-0002UN-1X for guix-devel@gnu.org; Thu, 18 Feb 2016 11:58:43 -0500 Received: from plane.gmane.org ([80.91.229.3]:47350) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aWRuZ-0002TO-QH for guix-devel@gnu.org; Thu, 18 Feb 2016 11:58:39 -0500 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1aWRuX-0005MU-6d for guix-devel@gnu.org; Thu, 18 Feb 2016 17:58:37 +0100 Received: from c-73-167-118-254.hsd1.ma.comcast.net ([73.167.118.254]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 18 Feb 2016 17:58:37 +0100 Received: from myglc2 by c-73-167-118-254.hsd1.ma.comcast.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 18 Feb 2016 17:58:37 +0100 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+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: guix-devel@gnu.org --=-=-= Content-Type: text/plain A patch to address issues raised in bug#22695. --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=0001-doc-more-on-binary-installation.patch >From 4f4f2ddd383e9a07a906f4da375a5b53fe792ab0 Mon Sep 17 00:00:00 2001 From: George Clemmer 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 --=-=-=--