On Thu, 17 Jan 2013 00:04:11 -0500
Daniel Meltzer <dmeltzer.gentoo@gmail.com> 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!
Daniel Meltzer <dmeltzer.gentoo@gmail.com> 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!
Attached Files:
-
signature.asc (0.19 KB)