| 1 |
On Thu, 17 Jan 2013 00:04:11 -0500 |
| 2 |
Daniel Meltzer <dmeltzer.gentoo@×××××.com> wrote: |
| 3 |
|
| 4 |
> * Suggest using emerge-webrsync instead of downloading a portage snapshot and |
| 5 |
> unpacking. |
| 6 |
> * Recommend mounting /sys for grub2 and other bootloader users. |
| 7 |
> * Remove the unnecessary env-update after entering chroot. |
| 8 |
> * Add ext4 to filesystems and suggest it as default for /. We can probably |
| 9 |
> remove jfs and reiserfs from this list to keep it less overwhelming, but |
| 10 |
> thats a debate for another day. |
| 11 |
> * Additional net interfaces should be symlinked to net.lo, not net.eth0, as |
| 12 |
> net.eth0 is itself a symlink to net.lo |
| 13 |
> --- |
| 14 |
> .../doc/en/gentoo-x86-quickinstall-stage.xml | 50 |
| 15 |
> ++++++++-------------- .../doc/en/gentoo-x86-quickinstall-system.xml | |
| 16 |
> 8 ++-- xml/htdocs/doc/en/gentoo-x86-quickinstall.xml | 18 ++++---- |
| 17 |
> 3 files changed, 30 insertions(+), 46 deletions(-) |
| 18 |
> |
| 19 |
> diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml |
| 20 |
> b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml index dd48c41..ccc72ee |
| 21 |
> 100644 --- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml |
| 22 |
> +++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-stage.xml |
| 23 |
> @@ -4,8 +4,8 @@ |
| 24 |
> |
| 25 |
> <included> |
| 26 |
> |
| 27 |
> -<version>14</version> |
| 28 |
> -<date>2012-02-29</date> |
| 29 |
> +<version>15</version> |
| 30 |
> +<date>2013-01-16</date> |
| 31 |
> |
| 32 |
> <section> |
| 33 |
> <title>Setting Up The Stage</title> |
| 34 |
> @@ -54,31 +54,6 @@ user 1m2.920s |
| 35 |
> sys 0m7.530s |
| 36 |
> </pre> |
| 37 |
> |
| 38 |
> -<p> |
| 39 |
> -Install the latest Portage snapshot. Proceed as for the stage3 archive: |
| 40 |
> choose -a nearby mirror from our <uri link="/main/en/mirrors.xml">list</uri>, |
| 41 |
> download -the latest snapshot and unpack it. |
| 42 |
> -</p> |
| 43 |
> - |
| 44 |
> -<pre caption="Download the latest Portage snapshot"> |
| 45 |
> -livecd gentoo # <i>cd /mnt/gentoo/usr</i> |
| 46 |
> -livecd usr # <i>links http://www.gentoo.org/main/en/mirrors.xml</i> |
| 47 |
> -<comment>(Pick a mirror, move to the snapshots/ directory, |
| 48 |
> -highlight <b>portage-latest.tar.bz2</b> and press D to download it)</comment> |
| 49 |
> - |
| 50 |
> -<comment>(<b>Or</b> download it directly with wget without choosing a nearby |
| 51 |
> mirror)</comment> -livecd gentoo # <i>cd /mnt/gentoo/usr</i> |
| 52 |
> -livecd usr # <i>wget |
| 53 |
> http://distfiles.gentoo.org/snapshots/portage-latest.tar.bz2</i> -</pre> |
| 54 |
> - |
| 55 |
> -<pre caption="Unpack the Portage snapshot"> |
| 56 |
> -livecd usr # <i>time tar xjf portage-lat*</i> |
| 57 |
> - |
| 58 |
> -real 0m40.523s |
| 59 |
> -user 0m28.280s |
| 60 |
> -sys 0m8.240s |
| 61 |
> -</pre> |
| 62 |
> - |
| 63 |
> </body> |
| 64 |
> </section> |
| 65 |
> <section> |
| 66 |
> @@ -86,19 +61,28 @@ sys 0m8.240s |
| 67 |
> <body> |
| 68 |
> |
| 69 |
> <p> |
| 70 |
> -Mount the <path>/proc</path> & <path>/dev</path> file systems, copy over |
| 71 |
> -the <path>/etc/resolv.conf</path> file, then chroot into your Gentoo |
| 72 |
> -environment. |
| 73 |
> +Mount the <path>/proc</path>, <path>/dev</path>, and <path>/sys</path> file |
| 74 |
> +systems, copy over the <path>/etc/resolv.conf</path> file, then chroot into |
| 75 |
> +your Gentoo environment. |
| 76 |
> </p> |
| 77 |
> |
| 78 |
> <pre caption="Chroot"> |
| 79 |
> livecd usr # <i>cd /</i> |
| 80 |
> livecd / # <i>mount -t proc proc /mnt/gentoo/proc</i> |
| 81 |
> livecd / # <i>mount --rbind /dev /mnt/gentoo/dev</i> |
| 82 |
> -livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i> |
| 83 |
> +livecd / # <i>mount --rbind /sys /mnt/gentoo/sys</i> |
| 84 |
> +livecd / # <i>cp -L /etc/resolv.conf /mnt/gentoo/etc/</i> |
| 85 |
> livecd / # <i>chroot /mnt/gentoo /bin/bash</i> |
| 86 |
> -livecd / # <i>env-update && source /etc/profile</i> |
| 87 |
> ->>> Regenerating /etc/ld.so.cache... |
| 88 |
> +livecd / # <i>source /etc/profile</i> |
| 89 |
> +</pre> |
| 90 |
> + |
| 91 |
> +<p> |
| 92 |
> +Fetch the latest portage snapshot from the mirrors using emerge-webrsync. |
| 93 |
> +</p> |
| 94 |
> + |
| 95 |
> +<pre caption="Running emerge-webrsync to install a Portage snapshot"> |
| 96 |
> +livecd / # <i>mkdir /usr/portage</i> |
| 97 |
> +livecd / # <i>emerge webrsync</i> |
| 98 |
> </pre> |
| 99 |
> |
| 100 |
> </body> |
| 101 |
> diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml |
| 102 |
> b/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml index b4b7e45..34c7b5e |
| 103 |
> 100644 --- a/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml |
| 104 |
> +++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall-system.xml |
| 105 |
> @@ -4,8 +4,8 @@ |
| 106 |
> |
| 107 |
> <included> |
| 108 |
> |
| 109 |
> -<version>7</version> |
| 110 |
> -<date>2012-03-31</date> |
| 111 |
> +<version>8</version> |
| 112 |
> +<date>2013-01-16</date> |
| 113 |
> |
| 114 |
> <section> |
| 115 |
> <title>Configure the system</title> |
| 116 |
> @@ -22,7 +22,7 @@ file systems match your installation. |
| 117 |
> livecd linux # <i>cd /etc</i> |
| 118 |
> livecd etc # <i>nano -w fstab</i> |
| 119 |
> /dev/<i>sda1</i> /boot ext2 noauto,noatime 1 2 |
| 120 |
> -/dev/<i>sda3</i> / ext3 noatime 0 1 |
| 121 |
> +/dev/<i>sda3</i> / ext4 noatime 0 1 |
| 122 |
> /dev/<i>sda2</i> none swap sw 0 0 |
| 123 |
> </pre> |
| 124 |
> |
| 125 |
> @@ -58,7 +58,7 @@ livecd etc # <i>nano -w fstab</i> |
| 126 |
> <p> |
| 127 |
> Configure your network in <path>/etc/conf.d/net</path>. Add the |
| 128 |
> <c>net.eth0</c> init script to the default run level. If you have multiple |
| 129 |
> NICs, symlink them -to the <c>net.eth0</c> init script and add them to the |
| 130 |
> default run level as +to the <c>net.lo</c> init script and add them to the |
| 131 |
> default run level as well. Don't forget to set your hostname too. Either edit |
| 132 |
> <path>/etc/conf.d/net</path> and <path>/etc/conf.d/hostname</path> with |
| 133 |
> <c>nano</c> or use the following commands: |
| 134 |
> diff --git a/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml |
| 135 |
> b/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml index 06200d0..90f010d 100644 |
| 136 |
> --- a/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml |
| 137 |
> +++ b/xml/htdocs/doc/en/gentoo-x86-quickinstall.xml |
| 138 |
> @@ -29,8 +29,8 @@ want to follow this guide. |
| 139 |
> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 140 |
> <license/> |
| 141 |
> |
| 142 |
> -<version>27</version> |
| 143 |
> -<date>2012-03-31</date> |
| 144 |
> +<version>28</version> |
| 145 |
> +<date>2013-01-16</date> |
| 146 |
> |
| 147 |
> <chapter> |
| 148 |
> <title>Introduction</title> |
| 149 |
> @@ -112,17 +112,17 @@ Units = cylinders of 16065 * 512 = 8225280 bytes |
| 150 |
> </pre> |
| 151 |
> |
| 152 |
> <p> |
| 153 |
> -Use <c>mke2fs</c>, <c>mke2fs -j</c>, <c>mkreiserfs</c>, <c>mkfs.xfs</c> and |
| 154 |
> -<c>mkfs.jfs</c> to create file systems on your Linux partitions. Initialize |
| 155 |
> your -swap partition using <c>mkswap</c> and <c>swapon</c>. |
| 156 |
> +Use <c>mkfs.ext2</c>, <c>mkfs.ext3</c>, <c>mkfs.ext4</c>, <c>mkreiserfs</c>, |
| 157 |
> +<c>mkfs.xfs</c> and <c>mkfs.jfs</c> to create file systems on your Linux |
| 158 |
> +partitions. Initialize your swap partition using <c>mkswap</c> and |
| 159 |
> <c>swapon</c>. </p> |
| 160 |
> |
| 161 |
> <pre caption="Create the file systems and activate swap"> |
| 162 |
> <comment>(ext2 is all you need on the /boot partition)</comment> |
| 163 |
> -livecd ~ # <i>mke2fs /dev/sda1</i> |
| 164 |
> +livecd ~ # <i>mkfs.ext2 /dev/sda1</i> |
| 165 |
> |
| 166 |
> -<comment>(Let's use ext3 on the main partition)</comment> |
| 167 |
> -livecd ~ # <i>mke2fs -j /dev/sda3</i> |
| 168 |
> +<comment>(Let's use ext4 on the main partition)</comment> |
| 169 |
> +livecd ~ # <i>mkfs.ext4 /dev/sda3</i> |
| 170 |
> |
| 171 |
> <comment>(Create and activate swap)</comment> |
| 172 |
> livecd ~ # <i>mkswap /dev/sda2 && swapon /dev/sda2</i> |
| 173 |
> @@ -204,7 +204,7 @@ Exit the chrooted environment, unmount all file systems |
| 174 |
> and reboot: <pre caption="Reboot"> |
| 175 |
> livecd conf.d # <i>exit</i> |
| 176 |
> livecd / # <i>umount -l /mnt/gentoo/dev{/shm,/pts,}</i> |
| 177 |
> -livecd / # <i>umount -l /mnt/gentoo{/proc,/boot,}</i> |
| 178 |
> +livecd / # <i>umount -l /mnt/gentoo{/proc,/boot,/sys,}</i> |
| 179 |
> livecd / # <i>reboot</i> |
| 180 |
> <comment>(Don't forget to remove the CD)</comment> |
| 181 |
> </pre> |
| 182 |
|
| 183 |
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! |
Archives