Difference between revisions of "Handbook Talk:AMD64/Full/Installation"
Maffblaster (talk | contribs) (Fixing up discussions. Adding InfoBoxes for tracking purposes.) |
(use shiny new {Talk} template) |
||
| Line 1: | Line 1: | ||
== 5.4 Viewing Documentation During Install == | == 5.4 Viewing Documentation During Install == | ||
| − | {{ | + | {{Talk|open}} |
The documentation recommends creating a new user account and logging in on a separate virtual tty to load links with the install docs, then switching back and forth between a command tty and the docs tty. This will work but it's clumsy, slow, and aggravating. A better solution is to use "screen" which is already included on the minimal install CD. The docs can be viewed side-by-side with one or more command shells on the same terminal with the following commands: | The documentation recommends creating a new user account and logging in on a separate virtual tty to load links with the install docs, then switching back and forth between a command tty and the docs tty. This will work but it's clumsy, slow, and aggravating. A better solution is to use "screen" which is already included on the minimal install CD. The docs can be viewed side-by-side with one or more command shells on the same terminal with the following commands: | ||
| Line 14: | Line 14: | ||
== Choosing the right profile == | == Choosing the right profile == | ||
| − | {{ | + | {{Talk|open}} |
While not a recommendation, this section suggests using "no-multilib" for a pure 64-bit environment. I think this should be followed by the disclaimer on the AMD64 FAQ: | While not a recommendation, this section suggests using "no-multilib" for a pure 64-bit environment. I think this should be followed by the disclaimer on the AMD64 FAQ: | ||
| Line 22: | Line 22: | ||
== Optional: Selecting mirrors == | == Optional: Selecting mirrors == | ||
| − | {{ | + | {{Talk|open}} |
If you use >=sys-apps/portage-2.2.16, you not have to use | If you use >=sys-apps/portage-2.2.16, you not have to use | ||
| Line 41: | Line 41: | ||
== Unpacking the stage tarball == | == Unpacking the stage tarball == | ||
| − | {{ | + | {{Talk|open}} |
Is "--xattrs" required on some versions of tar to keep the extended attributes when extracting the archive or is this a mistake and as the manpage says, is only used to "save the user/root xattrs to the archive" (while when extracting, one would have to specify "--no-xattrs" to bypass them). | Is "--xattrs" required on some versions of tar to keep the extended attributes when extracting the archive or is this a mistake and as the manpage says, is only used to "save the user/root xattrs to the archive" (while when extracting, one would have to specify "--no-xattrs" to bypass them). | ||
| Line 47: | Line 47: | ||
== Setting the date and time == | == Setting the date and time == | ||
| − | {{ | + | {{Talk|open}} |
Is there a reason Handbook doesn't suggest "ntpdate pool.ntp.org" instead of typing date manually? | Is there a reason Handbook doesn't suggest "ntpdate pool.ntp.org" instead of typing date manually? | ||
| Line 53: | Line 53: | ||
== Typo "there are e a" == | == Typo "there are e a" == | ||
| − | {{ | + | {{Talk|open}} |
There's an apparent typo on a whole series of these wiki pages. | There's an apparent typo on a whole series of these wiki pages. | ||
| Line 102: | Line 102: | ||
== 404 link on Introduction == | == 404 link on Introduction == | ||
| − | {{ | + | {{Talk|open}} |
The link to the Gentoo AMD64 project site (https://www.gentoo.org/proj/en/base/amd64/), on the Hardware Requirements section of the Introduction, leads to a 404 error. | The link to the Gentoo AMD64 project site (https://www.gentoo.org/proj/en/base/amd64/), on the Hardware Requirements section of the Introduction, leads to a 404 error. | ||
| Line 108: | Line 108: | ||
== Minor typo & systemd creep == | == Minor typo & systemd creep == | ||
| − | {{ | + | {{Talk|open}} |
Correct "on a amd64" to "on an amd64" if possible. | Correct "on a amd64" to "on an amd64" if possible. | ||
| Line 127: | Line 127: | ||
== Re: Banshee == | == Re: Banshee == | ||
| − | {{ | + | {{Talk|open}} |
Banshee is software that is loaded with commercial interests, namely Amazon.com. If it has dependency issues then those should be dealt with at the Banshee development site, not here. | Banshee is software that is loaded with commercial interests, namely Amazon.com. If it has dependency issues then those should be dealt with at the Banshee development site, not here. | ||
| Line 133: | Line 133: | ||
== Configuring the network == | == Configuring the network == | ||
| − | {{ | + | {{Talk|open}} |
The Handbook heavily relies on the assumption that the network interface name is eth0, which is highly unlikely with the new udev naming rules. | The Handbook heavily relies on the assumption that the network interface name is eth0, which is highly unlikely with the new udev naming rules. | ||
| Line 148: | Line 148: | ||
== Installing the sources == | == Installing the sources == | ||
| − | {{ | + | {{Talk|open}} |
<div class="cmd-box"><div><code style="color: #ef2929; font-weight: bold;">root #</code><span class="tripleclick-separator"></span><code>emerge --ask sys-kernel/gentoo-sources</code></div></div> | <div class="cmd-box"><div><code style="color: #ef2929; font-weight: bold;">root #</code><span class="tripleclick-separator"></span><code>emerge --ask sys-kernel/gentoo-sources</code></div></div> | ||
| Line 160: | Line 160: | ||
This section is out of date: | This section is out of date: | ||
| − | {{ | + | {{Talk|open}} |
{{KernelBox|title=Activating USB Support for input devices|<pre> | {{KernelBox|title=Activating USB Support for input devices|<pre> | ||
| Line 182: | Line 182: | ||
== Kernel config for efi stub == | == Kernel config for efi stub == | ||
| − | {{ | + | {{Talk|open}} |
Please edit configuration of kernel for efi support, else kernel not load a root file system. | Please edit configuration of kernel for efi support, else kernel not load a root file system. | ||
| Line 193: | Line 193: | ||
== Link to "other arches" on download page == | == Link to "other arches" on download page == | ||
| − | {{ | + | {{Talk|open}} |
In the "[[Handbook:AMD64/Full/Installation#Download the media|Download the media]]" section which discusses the "minimal installation CDs", the link to "the [//www.gentoo.org/downloads/#other-arches downloads page] (recommended)" is to the "Advanced Choices and other Architectures" section of that page. Shouldn't it be to the top of the page (no section anchor) where links to download the "normal" amd64 Minimal Installation CD, LiveDVD, and Stage 3 files are to be found? - [[User:Dcljr|dcljr]] ([[User talk:Dcljr|talk]]) 18:32, 13 April 2016 (UTC) | In the "[[Handbook:AMD64/Full/Installation#Download the media|Download the media]]" section which discusses the "minimal installation CDs", the link to "the [//www.gentoo.org/downloads/#other-arches downloads page] (recommended)" is to the "Advanced Choices and other Architectures" section of that page. Shouldn't it be to the top of the page (no section anchor) where links to download the "normal" amd64 Minimal Installation CD, LiveDVD, and Stage 3 files are to be found? - [[User:Dcljr|dcljr]] ([[User talk:Dcljr|talk]]) 18:32, 13 April 2016 (UTC) | ||
| Line 199: | Line 199: | ||
== Remove Parted == | == Remove Parted == | ||
| − | {{ | + | {{Talk|open}} |
Remove Parted from handbook! fdisk have support GPT layout, and part of coreutils (default) | Remove Parted from handbook! fdisk have support GPT layout, and part of coreutils (default) | ||
| Line 205: | Line 205: | ||
== EFI partition mount == | == EFI partition mount == | ||
| − | {{ | + | {{Talk|open|date=Jun 20 2016}} |
| − | | | ||
| − | }} | ||
I see the Handbook mentions that Grub2 can't be used, and efibootmgr should be used instead. However, using grub2 is a suitable option. | I see the Handbook mentions that Grub2 can't be used, and efibootmgr should be used instead. However, using grub2 is a suitable option. | ||
| Line 224: | Line 222: | ||
== Configuring GRUB2 == | == Configuring GRUB2 == | ||
| − | {{ | + | {{Talk|open}} |
When GRUB2 is installed, it mounts the boot partition in read-only mode with the following notification: | When GRUB2 is installed, it mounts the boot partition in read-only mode with the following notification: | ||
Revision as of 02:31, 11 January 2017
5.4 Viewing Documentation During Install
The documentation recommends creating a new user account and logging in on a separate virtual tty to load links with the install docs, then switching back and forth between a command tty and the docs tty. This will work but it's clumsy, slow, and aggravating. A better solution is to use "screen" which is already included on the minimal install CD. The docs can be viewed side-by-side with one or more command shells on the same terminal with the following commands:
- screen links Gentoo.org
- ^A ^C
- ^A | (for vertical split) or ^A S (for horizontal split)
Each "screen" can be split further into more windows. I would suggest including these instructions in the install docs in addition to or instead of the virtual terminal switching method.
Choosing the right profile
While not a recommendation, this section suggests using "no-multilib" for a pure 64-bit environment. I think this should be followed by the disclaimer on the AMD64 FAQ:
Switching from a no-multilib to a multilib-enabled profile is currently not supported (conversion hints), so think over your decision twice before you use the no-multilib profile.
Optional: Selecting mirrors
If you use >=sys-apps/portage-2.2.16, you not have to use
root #mirrorselect -i -r -o >> /mnt/gentoo/etc/portage/make.confAs, the SYNC variable in make.conf is deprecated and no longer used by portage.
You will should use
root #mkdir /mnt/gentoo/etc/portage/repos.confroot #cp /usr/share/portage/config/repos.conf /mnt/gentoo/etc/portage/repos.conf/gentoo.confIf you want to be updated from other mirror, you can run
root #mirrorselect -i -r -oselect mirror and paste received URI here /mnt/gentoo/etc/portage/repos.conf/gentoo.conf in variable "sync-uri"
example:
sync-uri = rsync://rsync.ru.gentoo.org/gentoo-portage
More info https://wiki.gentoo.org/wiki/Project:Portage/Sync
P.S. Sorry my bad english.
Unpacking the stage tarball
Is "--xattrs" required on some versions of tar to keep the extended attributes when extracting the archive or is this a mistake and as the manpage says, is only used to "save the user/root xattrs to the archive" (while when extracting, one would have to specify "--no-xattrs" to bypass them).
Setting the date and time
Is there a reason Handbook doesn't suggest "ntpdate pool.ntp.org" instead of typing date manually?
Typo "there are e a"
There's an apparent typo on a whole series of these wiki pages. I created and validated wiki account for myself, but alas, it doesn't (yet) give me the option to edit the pages - so apparently I can't correct it.
Anyway, the error: "there are e a couple" should apparently be: "there are a couple" on at least these pages:
https://wiki.gentoo.org/wiki/Handbook:AMD64/Full/Installation
https://wiki.gentoo.org/wiki/Handbook:AMD64/Installation/Stage
https://wiki.gentoo.org/wiki/Handbook:Alpha/Full/Installation
https://wiki.gentoo.org/wiki/Handbook:Alpha/Full/Installation/es
https://wiki.gentoo.org/wiki/Handbook:Alpha/Installation/Stage
https://wiki.gentoo.org/wiki/Handbook:HPPA/Full/Installation
https://wiki.gentoo.org/wiki/Handbook:HPPA/Full/Installation/es
https://wiki.gentoo.org/wiki/Handbook:HPPA/Installation/Stage
https://wiki.gentoo.org/wiki/Handbook:IA64/Full/Installation
https://wiki.gentoo.org/wiki/Handbook:IA64/Full/Installation/es
https://wiki.gentoo.org/wiki/Handbook:IA64/Installation/Stage
https://wiki.gentoo.org/wiki/Handbook:MIPS/Full/Installation
https://wiki.gentoo.org/wiki/Handbook:MIPS/Installation/Stage
https://wiki.gentoo.org/wiki/Handbook:PPC/Full/Installation
https://wiki.gentoo.org/wiki/Handbook:PPC/Full/Installation/es
https://wiki.gentoo.org/wiki/Handbook:PPC/Installation/Stage
https://wiki.gentoo.org/wiki/Handbook:PPC64/Full/Installation
https://wiki.gentoo.org/wiki/Handbook:PPC64/Full/Installation/es
https://wiki.gentoo.org/wiki/Handbook:PPC64/Installation/Stage
https://wiki.gentoo.org/wiki/Handbook:Parts/Full/Installation
https://wiki.gentoo.org/wiki/Handbook:Parts/Installation/Stage
https://wiki.gentoo.org/wiki/Handbook:SPARC/Full/Installation
https://wiki.gentoo.org/wiki/Handbook:SPARC/Full/Installation/es
https://wiki.gentoo.org/wiki/Handbook:SPARC/Installation/Stage
https://wiki.gentoo.org/wiki/Handbook:X86/Full/Installation
https://wiki.gentoo.org/wiki/Handbook:X86/Installation/Stage
https://wiki.gentoo.org/wiki/Handbook:X86/Installation/Stage/es
(Above posted by Michael Paoli, fixed for wikification)
Systemd needed for Banshee Too!
About the optional systemd and Gnome, could you mention that systemd is also required for programs like Banshee that highly depend on Gnome architecture.
404 link on Introduction
The link to the Gentoo AMD64 project site (https://www.gentoo.org/proj/en/base/amd64/), on the Hardware Requirements section of the Introduction, leads to a 404 error.
Minor typo & systemd creep
Correct "on a amd64" to "on an amd64" if possible.
I'm here to do a clean openRC installation. Let's keep systemd in check.
The "--make-rslave" operation creeps in without mention of it being optional, if it is, and without yet mention that it is because of systemd.
If these operations are unnecessary without systemd, then please move the "--make-rslave" operations into, and/or under, the note. For example:
Note
The --make-rslave operations are needed for systemd support later in the installation.
root #mount --make-rslave /mnt/gentoo/sys root #mount --make-rslave /mnt/gentoo/dev
Re: Banshee
Banshee is software that is loaded with commercial interests, namely Amazon.com. If it has dependency issues then those should be dealt with at the Banshee development site, not here.
Configuring the network
The Handbook heavily relies on the assumption that the network interface name is eth0, which is highly unlikely with the new udev naming rules. Recommending the use of
root #ip link show upfrom a Gentoo-based installation medium or
root #udevadm test-builtin net_id /sys/class/net/eth0 2> /dev/nullif coming from a different installation medium would allow users still unfamiliar with Gentoo to avoid errors during setup.
Agreed...I solved this by simply running
root #touch /etc/udev/rules.d/80-net-name-slot.rulesLikely works for 95% of all users with a single network card that doesn't change slots
Installing the sources
root #emerge --ask sys-kernel/gentoo-sourcesThis command execution recommends to control its status in another terminal by doing:
root #tail -f /var/log/emerge-fetch.logBut we have previously chrooted into /mnt/gentoo/. So I suggest to specify that if we log into another terminal we should tail the file inside the mounted folder by doing:
root #tail -f /mnt/gentoo/var/log/emerge-fetch.logKernel config for USB support
This section is out of date:
'"`UNIQ--pre-00000003-QINU`"'
I believe the relevant options have been moved to:
'"`UNIQ--pre-00000006-QINU`"'
Kernel config for efi stub
Please edit configuration of kernel for efi support, else kernel not load a root file system.
Processor type and features --->
[*] Built-in kernel command line
(root=/dev/sda2 rw)
Link to "other arches" on download page
In the "Download the media" section which discusses the "minimal installation CDs", the link to "the downloads page (recommended)" is to the "Advanced Choices and other Architectures" section of that page. Shouldn't it be to the top of the page (no section anchor) where links to download the "normal" amd64 Minimal Installation CD, LiveDVD, and Stage 3 files are to be found? - dcljr (talk) 18:32, 13 April 2016 (UTC)
Remove Parted
Remove Parted from handbook! fdisk have support GPT layout, and part of coreutils (default)
EFI partition mount
I see the Handbook mentions that Grub2 can't be used, and efibootmgr should be used instead. However, using grub2 is a suitable option.
The EFI partition should be mounted to /boot/efi:
# mkdir /mnt/gentoo/boot/efi # mount /dev/sda1 /mnt/gentoo/boot/efi
- Hi
| Community member | |
|---|---|
| Name | |
| Nickname |
|
, I saw your message in IRC. We are still very much active in monitoring and updating the wiki, although we're not always able to immediately respond on IRC. I agree, GRUB2 is a suitable option for EFI on Gentoo. I use it myself. With that being said we have to be careful with how much we try to support in the various handbooks. The purpose of it is to help users get Gentoo installed; not to walk them through all the configuration options (Gentoo is far too flexible for that!). :)
- I don't remember the Handbook ever saying GRUB2 can't be used for EFI on amd64 systems, but I will take a look and fix anything that doesn't seem right. Kind regards, --Maffblaster (talk) 02:05, 21 June 2016 (UTC)
Configuring GRUB2
When GRUB2 is installed, it mounts the boot partition in read-only mode with the following notification:
root #emerge sys-boot/grub>>> Verifying ebuild manifests >>> Running pre-merge checks for sys-boot/grub-2.02_beta2-r9 * To avoid automounting and auto(un)installing with /boot, * just export the DONT_MOUNT_BOOT variable. * Your boot partition, detected as being mounted at /boot, is read-only. * It will be remounted in read-write mode temporarily.
Because of this, the following command will fail:
root #grub2-install /dev/sdaInstalling for i386-pc platform. grub2-install: error: failed to get canonical path of `/boot/grub'.
As a workaround, just unmount the boot partition before running the command with:
root #umount /bootAfterwards, I noticed my boot partition was empty and I had to reinstall my kernel. I'm not sure if I messed something up, or if this is a bug or what.