Handbook Talk:AMD64/Installation/Base

From Gentoo Wiki
Jump to:navigation Jump to:search
Note
Before creating a discussion or leaving a comment, please read about using talk pages. To create a new discussion, click here. Comments on an existing discussion should be signed using ~~~~:
A comment [[User:Larry|Larry]] 13:52, 13 May 2024 (UTC)
: A reply [[User:Sally|Sally]] 16:19, 10 December 2024 (UTC)
:: Your reply ~~~~
Note
Some closed discussions have been moved to an archive subpage: Handbook Talk:AMD64/Installation/Base/Archive.


provide info or different protocols for mirrors and how many to add

Talk status
This discussion needs a response from its author.

It isn't made clear what the pros and cons of the different protocols are, so I was left wondering which one is fastest/most secure. Also maybe there should be a recommendation of how many mirrors to add. MihailMihov (talk) 21:35, 7 March 2024 (UTC)

Not sure there is a need for this on, can you please show an example of this would look in Template:Proposal to help explain the benefits?
Immolo (talk) 11:50, 8 March 2024 (UTC)

command to list timezones references parent directory

Talk status
This discussion is done as of 2024-03-16.

the command ln -sf ../usr/share/zoneinfo/Europe/Brussels /etc/localtime seems to assume that the user is not in / (why would it?) or is this just a typo? MihailMihov (talk) 21:39, 7 March 2024 (UTC)

The Handbook is designed to always teach users the correct way so while you are techicnally correct, we shouldn't make this change and cause an unforeseen issue.
Immolo (talk) 11:50, 8 March 2024 (UTC)
I don't think that I explaind myself correctly. I'm not saying to use relative paths, in fact I don't see why the locale is referenced as such. Why ../usr instead of /usr? MihailMihov (talk) 13:03, 8 March 2024 (UTC)
I see what you mean now and fully agree.
Proposed changes - Please make edits here until a final revision is agreed upon.

root #ln -sf /usr/share/zoneinfo/Europe/Brussels /etc/localtime
Immolo (talk) 18:38, 16 March 2024 (UTC)
After speaking to User:floppym it's clear this change isn't required for soft linking so am returning this closed based on that discussion.
Immolo (talk) 19:10, 16 March 2024 (UTC)
Symlink targets are always evaluated relative to their position in the filesystem, so the working directory isn't relevent when calling "ln -s" with an absolute path as the last argument.
We generally try to avoid using absolute paths in symlink targets since that can cause problems when working with alternate ROOT directories. In this particular case it probably wouldn't matter.
--Floppym (talk) 19:17, 16 March 2024 (UTC)

example shows selecting the POSIX locale, but that causes issues in desktop environments

Talk status
This discussion is done as of 2024-03-16.

there is a warning that atleast one utf 8 locale must be built, but no warning that following the example and selecting POSIX will cause issues with graphical applications. MihailMihov (talk) 21:44, 7 March 2024 (UTC)

Fixed in Special:Diff/1288877/1288884, thanks!
--Xarvatium (talk) 19:23, 16 March 2024 (UTC)

Example for binary package host example has inconsistent naming

Talk status
This discussion is done as of 2024-03-15.

The example for the binary package host is in the location /etc/portage/binrepos.conf/gentoo.conf while the location in the Binary Host Quickstart points to /etc/portage/binrepos.conf/gentoobinhost.conf, and some users might find this confusing.

WavyEbuilder (talk) 21:22, 15 March 2024 (UTC)

To add this issue was found by a new user that got confused, so this is a needed changed.
Proposed changes - Please make edits here until a final revision is agreed upon.

A second important step in selecting mirrors is to configure the Gentoo ebuild repository via the /etc/portage/repos.conf/gentoobinhost.conf file. This file contains the sync information needed to update the package repository (the collection of ebuilds and related files containing all the information Portage needs to download and install software packages).
Immolo (talk) 21:29, 15 March 2024 (UTC)
Fixed in Special:Diff/1287348/1288665, thanks!
--Xarvatium (talk) 21:34, 15 March 2024 (UTC)

Mentions of 17.1 profiles should be changed to 23.0

Talk status
This discussion is done.

Now that the stage 3 files have been updated to use 23.0 profiles, I think it should be time to update any mentions of 17.1 profiles to 23.0, as I believe it could in some cases clear up confusion for some users who are installing Gentoo for the first time.

--MymeType (talk) 23:41, 27 March 2024 (UTC)

AMD64 bumped in Special:Diff/1282566/1289968
--Xarvatium (talk) 23:56, 27 March 2024 (UTC)
I see no more occurrences of 17.1. Closing. Waldo Lemmer (talk) 12:30, 1 April 2024 (UTC)

Please delete this: "# May have been created in a previous step"

Talk status
This discussion is done as of 2024-05-11.

Change 2 of 2: (the 1st change was in "Preparing the disks"). Please delete this: "# May have been created in a previous step" from this line (ONLY the text; NOT the command):

root # mkdir /efi # May have been created in a previous step

-- Pietinger 14:58, 17 April 2024 (UTC) with help from @negril in IRC TODAY

Fixed in Special:Diff/1294705/1298156, thanks!
--csfore (talk) 18:44, 11 May 2024 (UTC)

FEATURES is an incremental variable

Since FEATURES is an incremental variable, instructions under "Installing binary packages" should be updated as follows:

# Install binary packages when available
FEATURES="getbinpkg"
# Require signatures
FEATURES="binpkg-request-signature"

See: FEATURES --Lucatrv (talk) 13:37, 1 May 2024 (UTC)

I don't think this is right. It's incremental across scopes, not within the same file. --Sam (talk) 22:08, 2 May 2024 (UTC)
Yes sorry, of course you're right, I update my suggestion:
# Install binary packages and require signatures
FEATURES="getbinpkg binpkg-request-signature"

--Lucatrv (talk) 21:25, 3 May 2024 (UTC)

Missing step to remove /etc/localtime

Talk status
This discussion needs help as of 2024-05-21.
Tip: To get this fixed sooner, use {{Proposal}}.

When configuring the timezone, a warning appears about /etc/localtime being a file instead of a symlink:

 $emerge --config sys-libs/timezone-data
 
  * Found a regular file at /etc/localtime.
  * Some software may expect a symlink instead.
  * You may convert it to a symlink by removing the file and running:
  *   emerge --config sys-libs/timezone-data
  * Copying /usr/share/zoneinfo/America/New_York to /etc/localtime.

It seems like perhaps there should be a step to remove /etc/localtime before running emerge --config sys-libs/timezone-data. GuyEP (talk) 03:45, 21 May 2024 (UTC)

I'm linking this discussion here because it seems related.
Waldo Lemmer 04:53, 21 May 2024 (UTC)

Please explain relative path meaning for symlinks

Talk status
This discussion is done as of 2024-09-20.

The Gentoo Handbook should address inexpert users too, so please after "ln -sf ../usr/share/zoneinfo/Europe/Brussels /etc/localtime" add an explaining note such as: "The target path with `../` at the start is relative to the link location, not to the current directory". See for instance: https://wiki.archlinux.org/title/Systemd-resolved#DNS --Lucatrv (talk) 22:19, 1 June 2024 (UTC)

Proposed changes to section systemd - Please make edits here until a final revision is agreed upon.

Note
The target path with ../ at the start is relative to the link location, not necessarily to the current directory.

--Lucatrv (talk) 13:18, 2 June 2024 (UTC)

I added the word "necessarily". Most guides cd to the link location, which makes the link location and current directory the same.
Looks good to me :)
Waldo Lemmer 13:54, 2 June 2024 (UTC)
Fixed in Special:Diff/1313977/1313983, thanks!
--csfore (talk) 15:24, 20 September 2024 (UTC)

Clarify chrooting section

Talk status
This discussion is done as of 2024-09-20.

In the "Chrooting" section, in the "Mounting the necessary filesystems" subsection there is a tooltip saying that "this" steps can be skipped and "arch-chroot" used instead, but it is unclear what steps can be skipped and where the reader should resume. The proposition is to move this tooltip to the very top of the "Chrooting" section, and change it to something like: "If using Gentoo's install media You can make below actions with a convenient script called arch-chroot, and then resume at the "Preparing for a bootloader" subsection + the command itself below". --Shvrma (talk) 12:34, 6 June 2024 (UTC)

I agree. The "If using Gentoo's install media" tip should be moved upwards to directly below the Mounting the necessary filesystems heading.
Waldo Lemmer 04:51, 7 June 2024 (UTC)
Fixed in Special:Diff/1313983/1313985, thanks!
--csfore (talk) 15:27, 20 September 2024 (UTC)

repo verification

Talk status
This discussion is still ongoing as of 2024-09-29.

I think it should be pointed out that the use of "emerge-webrsync" and "emerge --sync" comes along with cryptographic verification. Otherwise, the unknowing newbie might think, it's, for example, only plain stupid rsync.

--Duxsco (talk) 21:16, 6 September 2024 (UTC)

More including tips for desktops

Talk status
This discussion is still ongoing as of 2024-10-09.

I think maybe more explanation about desktop installation - maybe a couple of links to common desktop environment wikis. The existing selection of the contents of the desktop profile is basically useless - it does not provide a usable desktop. Df1050 (talk) 09:00, 9 October 2024 (UTC)

I feel like I need to explain: I think that if the handbook really only installs the base system, it should choose the minimal profile and explain the desktop installation. Otherwise, write out the full desktop installation process, which should also be a link. Df1050 (talk) 09:05, 9 October 2024 (UTC)

Mention that GENTOO_MIRRORS does not need to be set

Talk status
This discussion is still ongoing as of 2024-10-26.

As noted by someone on gentoo-user, the "Optional: Selecting mirrors" section isn't clear: it doesn't mention that, if GENTOO_MIRRORS is not set, distfiles.gentoo.org will be used by default. This can lead to confusion, as a section marked as 'Optional' appears to be saying that one should manually specify a mirror. Thus, i suggest changing the opening text of that section to:

Proposed changes - Please make edits here until a final revision is agreed upon.

By default, Gentoo will download source from distfiles.gentoo.org. However, it is also possible to manually specify a mirror by setting the GENTOO_MIRRORS variable in make.conf; Portage will then try to use the mirror(s) listed in that variable.