Re: [PATCH 1/3] Bring gentoo-x86-quickinstall in line with many of the changes that have been made to the official handbook. It would probably make sense down the line to turn this into a 64 bit quickinstall guide, as that's rapidly becoming the common denominator for new users. This commit makes the following changes:
Joshua Saddler <[email protected]> Wed, 16 Jan 2013 22:19:46 -0800
| Newsgroups | gmane.linux.gentoo.documentation |
|---|---|
| Message-ID | <[email protected]> |
On Thu, 17 Jan 2013 00:04:11 -0500 Daniel Meltzer <[email protected]> wrote: > * Suggest using emerge-webrsync instead of downloading a portage snapshot and > unpacking. > * Recommend mounting /sys for grub2 and other bootloader users. > * Remove the unnecessary env-update after entering chroot. > * Add ext4 to filesystems and suggest it as default for /. We can probably > remove jfs and reiserfs from this list to keep it less overwhelming, but > thats a debate for another day. > * Additional net interfaces should be symlinked to net.lo, not net.eth0, as > net.eth0 is itself a symlink to net.lo > --- > .../doc/en/gentoo-x86-quickinstall-stage.xml | 50 > ++++++++-------------- .../doc/en/gentoo-x86-quickinstall-system.xml | > 8 ++-- xml/htdocs/doc/en/gentoo-x86-quickinstall.xml | 18 ++++---- > 3 files changed, 30 insertions(+), 46 deletions(-) > > diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml > b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml index dd48c41..ccc72ee > 100644 --- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml > +++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml > @@ -4,8 +4,8 @@ > > <included> > > -<version>14</version> > -<date>2012-02-29</date> > +<version>15</version> > +<date>2013-01-16</date> > > <section> > <title>Setting Up The Stage</title> > @@ -54,31 +54,6 @@ user 1m2.920s > sys 0m7.530s > </pre> > > -<p> > -Install the latest Portage snapshot. Proceed as for the stage3 archive: > choose -a nearby mirror from our <uri link="/main/en/mirrors.xml">list</uri>, > download -the latest snapshot and unpack it. > -</p> > - > -<pre caption="Download the latest Portage snapshot"> > -livecd gentoo # <i>cd /mnt/gentoo/usr</i> > -livecd usr # <i>links http://www.gentoo.org/main/en/mirrors.xml</i> > -<comment>(Pick a mirror, move to the snapshots/ directory, > -highlight <b>portage-latest.tar.bz2</b> and press D to download it)</comment> > - > -<comment>(<b>Or</b> download it directly with wget without choosing a nearby > mirror)</comment> -livecd gentoo # <i>cd /mnt/gentoo/usr</i> > -livecd usr # <i>wget > http://distfiles.gentoo.org/snapshots/portage-latest.tar.bz2</i> -</pre> > - > -<pre caption="Unpack the Portage snapshot"> > -livecd usr # <i>time tar xjf portage-lat*</i> > - > -real 0m40.523s > -user 0m28.280s > -sys 0m8.240s > -</pre> > - > </body> > </section> > <section> > @@ -86,19 +61,28 @@ sys 0m8.240s > <body> > > <p> > -Mount the <path>/proc</path> & <path>/dev</path> file systems, copy over > -the <path>/etc/resolv.conf</path> file, then chroot into your Gentoo > -environment. > +Mount the <path>/proc</path>, <path>/dev</path>, and <path>/sys</path> file > +systems, copy over the <path>/etc/resolv.conf</path> file, then chroot into > +your Gentoo environment. > </p> > > <pre caption="Chroot"> > livecd usr # <i>cd /</i> > livecd / # <i>mount -t proc proc /mnt/gentoo/proc</i> > livecd / # <i>mount --rbind /dev /mnt/gentoo/dev</i> > -livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i> > +livecd / # <i>mount --rbind /sys /mnt/gentoo/sys</i> > +livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i> > livecd / # <i>chroot /mnt/gentoo /bin/bash</i> > -livecd / # <i>env-update && source /etc/profile</i> > ->>> Regenerating /etc/ld.so.cache... > +livecd / # <i>source /etc/profile</i> > +</pre> > + > +<p> > +Fetch the latest portage snapshot from the mirrors using emerge-webrsync. > +</p> > + > +<pre caption="Running emerge-webrsync to install a Portage snapshot"> > +livecd / # <i>mkdir /usr/portage</i> > +livecd / # <i>emerge webrsync</i> > </pre> > > </body> > diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml > b/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml index b4b7e45..34c7b5e > 100644 --- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml > +++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml > @@ -4,8 +4,8 @@ > > <included> > > -<version>7</version> > -<date>2012-03-31</date> > +<version>8</version> > +<date>2013-01-16</date> > > <section> > <title>Configure the system</title> > @@ -22,7 +22,7 @@ file systems match your installation. > livecd linux # <i>cd /etc</i> > livecd etc # <i>nano -w fstab</i> > /dev/<i>sda1</i> /boot ext2 noauto,noatime 1 2 > -/dev/<i>sda3</i> / ext3 noatime 0 1 > +/dev/<i>sda3</i> / ext4 noatime 0 1 > /dev/<i>sda2</i> none swap sw 0 0 > </pre> > > @@ -58,7 +58,7 @@ livecd etc # <i>nano -w fstab</i> > <p> > Configure your network in <path>/etc/conf.d/net</path>. Add the > <c>net.eth0</c> init script to the default run level. If you have multiple > NICs, symlink them -to the <c>net.eth0</c> init script and add them to the > default run level as +to the <c>net.lo</c> init script and add them to the > default run level as well. Don't forget to set your hostname too. Either edit > <path>/etc/conf.d/net</path> and <path>/etc/conf.d/hostname</path> with > <c>nano</c> or use the following commands: > diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml > b/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml index 06200d0..90f010d 100644 > --- a/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml > +++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml > @@ -29,8 +29,8 @@ want to follow this guide. > <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> > <license/> > > -<version>27</version> > -<date>2012-03-31</date> > +<version>28</version> > +<date>2013-01-16</date> > > <chapter> > <title>Introduction</title> > @@ -112,17 +112,17 @@ Units = cylinders of 16065 * 512 = 8225280 bytes > </pre> > > <p> > -Use <c>mke2fs</c>, <c>mke2fs -j</c>, <c>mkreiserfs</c>, <c>mkfs.xfs</c> and > -<c>mkfs.jfs</c> to create file systems on your Linux partitions. Initialize > your -swap partition using <c>mkswap</c> and <c>swapon</c>. > +Use <c>mkfs.ext2</c>, <c>mkfs.ext3</c>, <c>mkfs.ext4</c>, <c>mkreiserfs</c>, > +<c>mkfs.xfs</c> and <c>mkfs.jfs</c> to create file systems on your Linux > +partitions. Initialize your swap partition using <c>mkswap</c> and > <c>swapon</c>. </p> > > <pre caption="Create the file systems and activate swap"> > <comment>(ext2 is all you need on the /boot partition)</comment> > -livecd ~ # <i>mke2fs /dev/sda1</i> > +livecd ~ # <i>mkfs.ext2 /dev/sda1</i> > > -<comment>(Let's use ext3 on the main partition)</comment> > -livecd ~ # <i>mke2fs -j /dev/sda3</i> > +<comment>(Let's use ext4 on the main partition)</comment> > +livecd ~ # <i>mkfs.ext4 /dev/sda3</i> > > <comment>(Create and activate swap)</comment> > livecd ~ # <i>mkswap /dev/sda2 && swapon /dev/sda2</i> > @@ -204,7 +204,7 @@ Exit the chrooted environment, unmount all file systems > and reboot: <pre caption="Reboot"> > livecd conf.d # <i>exit</i> > livecd / # <i>umount -l /mnt/gentoo/dev{/shm,/pts,}</i> > -livecd / # <i>umount -l /mnt/gentoo{/proc,/boot,}</i> > +livecd / # <i>umount -l /mnt/gentoo{/proc,/boot,/sys,}</i> > livecd / # <i>reboot</i> > <comment>(Don't forget to remove the CD)</comment> > </pre> most of these are on our to-do list for current/past handbook bugs. thanks for the patches for the quickinstall guide; it's something we've been meaning to do along with the other changes, which have been in the handbook for awhile. hopefully someone'll get to these soonish!
signature.asc
(application/pgp-signature, 198 B)
-----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.19 (GNU/Linux) iEYEARECAAYFAlD3mAQACgkQxPWMzpKk6kPg2wCgnRB6/Qu8vFIkkKMudiSDcsax dnQAnRGTQM+LEFXeTsSV4Rfgce1Z0HW4 =zRnZ -----END PGP SIGNATURE-----