Difference between revisions of "Talk:Installation guide"

From ArchWiki
Jump to navigation Jump to search
(pacman-key --populate: rm closed)
(Boot loader options: re)
(12 intermediate revisions by 4 users not shown)
Line 19: Line 19:
  
 
== Network configuration ==
 
== Network configuration ==
 
=== <s>Lacking explanations</s> ===
 
:The newly installed environment has no network connection activated by default. See [[Network configuration#Network management]].
 
 
:For [[Wireless configuration]], [[install]] the {{Pkg|iw}} and {{Pkg|wpa_supplicant}} packages, as well as needed [[Wireless#Installing driver/firmware|firmware packages]]. Optionally install {{Pkg|dialog}} for usage of ''wifi-menu''.
 
 
The Network configuration section is rubbish. It doesn't explain that wifi-menu is part of [[netctl]] and telling users to install both iw ''and'' wpa_supplicant is plainly wrong. I would replace it with a DRY "See [[Network configuration]]." but maintainers aren't trusted to edit the [[Installation guide]]. --[[User:Larivact|Larivact]] ([[User talk:Larivact|talk]]) 17:09, 18 May 2018 (UTC)
 
 
:If maintainers go on the talk page and plainly state "this section is rubbish" while indicating they would push their change without discussion, then no, I wouldn't trust maintainers with editing this central article. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 21:09, 18 May 2018 (UTC)
 
 
::Nah, [[User:Larivact|Larivact]] is right. I had to go to a completely different site to figure out that wifi-menu even exists. It should include the line: "For supported wireless devices run {{ic|wifi-menu}} to set up the network". Would have saved me a couple hours. I genuinely don't understand why you would include the tool, but have no reference to it (and please don't take this as an indication that you should just remove the tool). [[User:Klaymen|Klaymen]] ([[User talk:Klaymen|talk]]) 02:38, 24 December 2018 (UTC)
 
 
:I would agree linking appropriate article would suit more than current section, given deprecation of Beginners' Guide for similar reasons.
 
:It is not that maintainers aren't trusted, but that MediaWiki doesn't allow specifying what user groups can perform edits, the choice is only among all, only auto-confirmed or only admins [https://wiki.archlinux.org/index.php?title=ArchWiki_talk:Contributing&oldid=512883], plus we need to discuss edits to central wiki articles beforehand anyway [https://wiki.archlinux.org/index.php?title=User_talk:Svito&oldid=511693]. -- [[User:Svito|Svito]] ([[User talk:Svito|talk]]) 20:03, 18 May 2018 (UTC)
 
 
::I've wanted to create additional groups for a while now (should be simple with LocalSettings.php published). Anyone interested should be able to write a patch and send it to the admins. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 21:09, 18 May 2018 (UTC)
 
 
:Indeed "rubbish" wasn't a very wise choice of a word, a lot of volunteer effort has been put to get to the current state of the wiki, of course everything can always be improved.
 
:In particular, the history of that section basically is [https://wiki.archlinux.org/index.php?title=Beginners%27_guide&oldid=446855#Network_configuration Beginners' guide#Network configuration] > [https://wiki.archlinux.org/index.php?title=Installation_guide&diff=442466&oldid=442463] > [https://wiki.archlinux.org/index.php?title=Installation_guide&diff=442470&oldid=442469].
 
:I'd be in favor of simply restoring a similar state to [https://wiki.archlinux.org/index.php?title=Installation_guide&oldid=442463#Network_configuration], i.e. I'd link [[Network configuration]] but also [[Wireless network configuration]] directly, and drop the rest of the details.
 
:-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 16:19, 20 May 2018 (UTC)
 
 
::[https://wiki.archlinux.org/index.php?title=Installation_guide&diff=522153&oldid=521933] With the recent changes to [[Network configuration]] article, we may make similar changes to [[Installation guide#Connect to the Internet]]. Even a specific link to [[Wireless network configuration]] should no longer be required, since you need to follow [[Network configuration#DHCP]] anyway and [[Wireless]] is linked from [[Network configuration#Setup]]. Proposed wording:
 
 
:::The installation image enables the [[dhcpcd]] daemon on boot for [https://git.archlinux.org/archiso.git/tree/configs/releng/airootfs/etc/udev/rules.d/81-dhcpcd.rules wired] network devices. The connection may be checked with:
 
::: {{ic|# ping archlinux.org}}
 
:::If no connection is available, [[stop]] the ''dhcpcd'' service:
 
::: {{ic|# systemctl stop dhcpcd@<TAB>}}
 
:::Proceed with instructions in [[Network configuration]].
 
 
::If that's a bit too short we might expand the {{man|8|ping}} example, compare expansion template in [[Network_configuration#Ping]]. --[[User:Alad|Alad]] ([[User talk:Alad|talk]]) 16:38, 20 May 2018 (UTC)
 
 
:::I actually prefer the current style with the systemctl example, using the ic template and a spelled-out instruction to press Tab. I don't see the need to expand further on ping directly in this page.
 
:::On a second thought with respect to my previous post, I'm fine with dropping direct links to [[Wireless network configuration]] and only point to [[Network configuration]] as proposed in OP, i.e. also in [[Installation guide#Network configuration]] (I think we should be consistent between the two network-configuration sections).
 
:::Another idea, we could merge [[Installation guide#Hostname]] into [[Installation guide#Network configuration]] now, since [[Hostname]] lands in [[Network configuration]] anyway, and even if that section is moved to [[DNS configuration]], it's still all network setup.
 
:::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 15:08, 21 May 2018 (UTC)
 
 
::::I've removed the [[Wireless network configuration]] link from both sections. As it stands it cannot be used independently of [[Network configuration]] anyway. It's the devil or the blue sea - when configuring a simple wireless connection, users have to wade through pages of possibly unrelated information in [[Network configuration]] or be confused by missing steps in [[Wireless network configuration]]. Sometimes I believe that things would be much easier if our user base didn't value "choice" as much.
 
::::About the ''systemctl'' example, after all this time I'm still not sure on the {{ic|Tab}} instructions. We never finished the relevant discussion in [[Help_talk:Reading]] and the steps to fill in (choosing the right ethernet adapter, tab-completing it and pressing return) are not necessarily obvious.
 
::::About [[Installation guide#Hostname]], I'm fine with moving this section under [[Installation guide#Network configuration]]. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 23:22, 25 May 2018 (UTC)
 
 
:::::I've merged #Hostname into #Network_configuration.
 
:::::I hear you about the complexity of the network configuration pages, but it's a huge topic, I'll leave it to [[Talk:Network configuration]].
 
:::::I'm going to reply to [[Help talk:Reading#Mention tab completion.3F]], but regarding this instance I propose the following:
 
::::::If no connection is available, [[stop]] the ''dhcpcd'' service with {{ic|systemctl stop dhcpcd@''interface''}}; you can [[Wikipedia:Command-line_completion|tab-complete]] the {{ic|''interface''}} name. Then proceed to configure the network as described in [[Network configuration]].
 
:::::-- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 15:49, 26 May 2018 (UTC)
 
 
::::::I'd like "where the {{ic|interface}} name can be [[Wikipedia:Command-line_completion|tab-completed]]" better, but that's just a detail. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 16:33, 26 May 2018 (UTC)
 
 
:::::::Implemented [https://wiki.archlinux.org/index.php?title=Installation_guide&diff=523411&oldid=523346] -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 16:50, 26 May 2018 (UTC)
 
 
:::::::May I suggest the following edit to this section:
 
::::::::If no connection is available, or you are using a wireless device, [[stop]] the ''dhcpcd'' service with ... [[User:Tourian|Tourian]] ([[User talk:Tourian|talk]]) 04:45, 28 May 2018 (UTC)
 
:::::::::That's already mentioned in the relevant section: [[Installation_guide#Connect_to_the_Internet]]. ''dhcpcd'' is not enabled by default in the installed system so there is nothing to stop in [[Installation_guide#Network_configuration]]. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 06:33, 28 May 2018 (UTC)
 
::::::::::I guess the proposed wording is indeed for [[Installation_guide#Connect_to_the_Internet]], which as it stands has no mention of wireless devices (only implied through lack of connection) -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 10:05, 28 May 2018 (UTC)
 
:::::::::::Yes, it is not explicit. The wording on 20 May 2018 at the end of [[Installation_guide#Connect_to_the_Internet]] was "Proceed with [[Network configuration]] for wired devices or [[Wireless network configuration]] for wireless devices", with the reference to wireless devices removed after the decision to send those on wireless connections to [[Network configuration]]. Therefore, how about starting this section with, "If you are using a wireless network device, proceed with [[Network Configuration]]. For wired devices, the installation image enables the [[dhcpcd]] daemon on boot. The connection..." and leave the rest as it is. -- [[User:Tourian|Tourian]] ([[User talk:Tourian|talk]]) 14:04, 28 May 2018 (UTC)
 
 
::::::::::::I perhaps prefer the first wording you suggested, since we've always told people to disable the wired dhcpcd even when using a wireless connection, to rule out any possible conflicts. I don't feel strongly about this however.. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 16:03, 28 May 2018 (UTC)
 
 
: In [[Installation_guide#Network_configuration]], can we append the introduction of [[Network_configuration#Network_management]]? Currently new users are pointed to a page that is comprehensive, but unhelpful as a part of the installation guide. --[[User:Mpan|Mpan]] ([[User talk:Mpan|talk]]) 00:38, 8 February 2019 (UTC)
 
 
:: Done, closing. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:41, 13 March 2019 (UTC)
 
  
 
=== dhcpcd for installed environment ===
 
=== dhcpcd for installed environment ===
Line 97: Line 35:
  
 
::[https://wiki.archlinux.org/index.php?title=Network_configuration&diff=340138&oldid=333485 First] appearance in our wiki, cited [https://www.debian.org/doc/manuals/debian-reference/ch05.en.html#_the_hostname_resolution source], also [https://wiki.archlinux.org/index.php?title=Talk:Network_configuration&oldid=360328#Hostname_resolution discussion]. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 10:26, 22 May 2018 (UTC)
 
::[https://wiki.archlinux.org/index.php?title=Network_configuration&diff=340138&oldid=333485 First] appearance in our wiki, cited [https://www.debian.org/doc/manuals/debian-reference/ch05.en.html#_the_hostname_resolution source], also [https://wiki.archlinux.org/index.php?title=Talk:Network_configuration&oldid=360328#Hostname_resolution discussion]. -- [[User:Kynikos|Kynikos]] ([[User talk:Kynikos|talk]]) 10:26, 22 May 2018 (UTC)
 
== <s>Add a TIP under Post-installation</s> ==
 
 
Under [[Installation_guide#Post-installation]], it may be a good idea to add a TIP like this for new (or even existing) users:
 
{{Tip|Create an account at [https://wiki.archlinux.org/ ArchWiki] and add [[General recommendations]] page to your [[Special:Watchlist|Watchlist]] to automatically get alerts for new recommendation or changes to existing recommendations. You may also add other Wiki pages of your liking to the Watchlist so as to always stay up-to-date with them.}}
 
-- [[User:Amish|Amish]] ([[User talk:Amish|talk]]) 01:19, 10 June 2018 (UTC)
 
 
:It's certainly an interesting suggestion. I'm not sure if it's in the scope of the installation guide however; maybe [[Help:Reading]] is better suited? -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 21:26, 10 June 2018 (UTC)
 
 
::[[Installation guide]] would always be read by those installing Arch Linux. But not necessarily [[Help:Reading]] (today is first time I read it in 4-5 years with Arch Linux). So Installation guide will bring in more awareness and more involvement of users.
 
 
:::That's a bit of an issue since the Installation guide assumes users have read [[Help:Reading]]... though I'm not unaware of this, see e.g. [https://wiki.archlinux.org/index.php?title=Installation_guide&diff=508490&oldid=508486] -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 09:55, 11 June 2018 (UTC)
 
 
::::Actually the purpose of [[Help:Reading]] is to tell users how to read the page / article but not what can be done after Installation. Here Tip is intended to suggest what to do after installation. i.e. Post-installation.
 
::::[[User:Amish|Amish]] ([[User talk:Amish|talk]]) 12:15, 11 June 2018 (UTC)
 
 
:I'd word it less imperatively:
 
::{{Tip|You can stay up to date with ArchWiki articles by [[Special:CreateAccount|creating an account]] and adding articles of interest to [[Special:Watchlist|your Watchlist]].}}
 
:--[[User:Larivact|Larivact]] ([[User talk:Larivact|talk]]) 04:47, 11 June 2018 (UTC)
 
 
::Sounds good to me. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 09:55, 11 June 2018 (UTC)
 
 
::My intention was to highlight [[General recommendations]] for Watchlist because thats a page every Arch user must follow to keep their Arch Linux well maintained. Other important page that I feel must be highlighted to be added in Watchlist is [[System maintenance]].
 
::
 
::OR we can have Tip like this:
 
::{{Tip|You can stay up to date with ArchWiki articles by [[Special:CreateAccount|creating an account]] and adding articles of interest to [[Special:Watchlist|your Watchlist]]. Few articles you may want start with are at [[Main Page]]}}
 
::-- [[User:Amish|Amish]] ([[User talk:Amish|talk]]) 12:32, 11 June 2018 (UTC)
 
 
:What is the current state of this suggestion, because I believe it is very interesting. I have a preference for the first proposed TIP.
 
:-- [[User:Apollo22|Apollo22]] ([[User talk:Apollo22|talk]]) 19:23, 12 August 2018 (UTC)
 
 
:Why not just use bookmarks? Creating an account to follow changes seems more tedious, it's meant for editors. --[[User:Ubone|Ubone]] ([[User talk:Ubone|talk]]) 16:34, 22 September 2018 (UTC)
 
 
::In hindsight, this is the better solution. The general recommendations and installation hardly change to the extent that continuous checking for updates is required. Closing -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 17:47, 13 March 2019 (UTC)
 
  
 
== Network Configuration -- WiFi discussion ==
 
== Network Configuration -- WiFi discussion ==
Line 172: Line 76:
  
 
::::That looks good to me. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 14:57, 28 August 2018 (UTC)
 
::::That looks good to me. -- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 14:57, 28 August 2018 (UTC)
 
== <s>ArchWiki link</s> ==
 
 
[[special:diff/542917]] shouldn't that link go [[Table_of_contents]] or similar? --[[User:Ubone|Ubone]] ([[User talk:Ubone|talk]]) 13:20, 26 September 2018 (UTC)
 
 
:Why would it? That link is supposed to specifically explain what ArchWiki ''is''. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 13:38, 26 September 2018 (UTC)
 
 
::isn't the context of the sentence about the tools used in the article and their wiki pages? --[[User:Ubone|Ubone]] ([[User talk:Ubone|talk]]) 14:39, 26 September 2018 (UTC)
 
 
:::No. [[man page]] doesn't link to a list of all available man pages either. Closing -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 17:48, 13 March 2019 (UTC)
 
 
== <s>/etc/locale.conf needs to be created</s> ==
 
 
The area needing a correction is [[Installation guide#Localization]].
 
 
The instructions tell you to set variables in the /etc/locale.conf file, but the file doesn't exist unless the user creates it. If the user needs to '''create''' the file, it should be explicitly explained with that language just as it is explained for the hostname file in [[Installation guide#Network configuration]] area. "'''Create''' the hostname file:"
 
 
For '''Localization''', I propose we add the verbiage ''Create the locale.conf file: /etc/locale.conf''
 
[[User:Schlitzkrieg|Schlitzkrieg]] ([[User talk:Schlitzkrieg|talk]]) 18:52, 28 September 2018 (UTC)
 
 
:[https://wiki.archlinux.org/index.php?title=Installation_guide&diff=568604&oldid=565601] -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:09, 13 March 2019 (UTC)
 
  
 
== fstab ==
 
== fstab ==
Line 219: Line 102:
 
: Moved to [[Talk:EFI system partition#Size_of_EFI_partition]]. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 17:40, 13 March 2019 (UTC)
 
: Moved to [[Talk:EFI system partition#Size_of_EFI_partition]]. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 17:40, 13 March 2019 (UTC)
  
== <s>Example layouts section</s> ==
+
== Boot loader installation ==
  
There are several things I don't like in the current [[Installation guide#Example layouts]] section.
+
[[Installation guide#Boot loader]] doesn't say to '''install''' a boot loader, it only refers to a list of them. How about adding something like "Choose and install at least one boot loader."? -- [[User:nl6720|nl6720]] ([[User talk:nl6720|talk]]) 19:46, 14 March 2019 (UTC)
  
* <s>BIOS/GPT & BIOS/MBR is merged in one example. This is bound to lead to unnecessary confusion, since, for example, there is no BIOS boot partition for MBR. I suggest omitting BIOS/GPT since not all firmware support it (due to being unsupported by Windows). Then the GRUB-specific partition doesn't need to be listed.</s>
+
: ''At least'' one? -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 21:09, 14 March 2019 (UTC)
* <s>Column title "Partition type (GUID)". If the GUIDs (and IDs for MBR) are omitted for ''simplicity'', then the column should not mention them.</s>
 
* <s>[https://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec/ The Discoverable Partitions Specification] is not used on GPT.</s>
 
* <s>The suggested size for {{ic|/}}, "Remainder of the device", could be replaced with the required minimum. [[Partitioning]] suggests 23-32 GiB, so how about 32 GiB.</s>
 
* <s>The suggested size of [[ESP]] doesn't match the recommended size from [[EFI system partition#Create the partition]].</s>
 
* <s>[[gdisk]] is not mentioned or linked (it doesn't share an wiki article with [[fdisk]] anymore) even once in the [[Installation guide]]. It could be added to the note below the tables.</s>
 
* <s>Without [[Template:ic]] around the mount points and partitions, they look awful.</s>
 
  
I presume that, unlike [[Partitioning#Example layouts]], the examples should be as ''simple'' as possible, so, I propose the following examples.
+
:: Might not be the most common scenario, but it's possible to use one boot loader for BIOS booting and another for UEFI booting. E.g. [[rEFInd]] for UEFI booting + [[Syslinux]] for BIOS booting. If that use case is too uncommon to be mentioned then just add "Choose and install a boot loader.". -- [[User:nl6720|nl6720]] ([[User talk:nl6720|talk]]) 21:31, 14 March 2019 (UTC)
  
-- [[User:nl6720|nl6720]] ([[User talk:nl6720|talk]]) 07:37, 28 January 2019 (UTC)
+
=== Boot loader options ===
  
: There is no "required minimum" on the root partition. Saying something like 32 GiB would make Arch exclusive to bare metal installations or virtual machines with a large image size. If anything, the "remainder of the device" wording should be improved, as already discussed elsewhere. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:02, 13 March 2019 (UTC)
+
Is it worth saying that without {{Pkg|systemd-sysvcompat}}, you need to add the {{ic|1=init=/lib/systemd/systemd}} kernel parameter?
  
: Added a mention of [[gdisk]] to [[fdisk]]: [https://wiki.archlinux.org/index.php?title=Fdisk&diff=568597&oldid=568258]. I don't want to add it here, as it won't make much difference and there's already enough choices to make on installation. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:00, 13 March 2019 (UTC)
+
I got a bad surprise when I uninstalled the thing. [[User:Flying_sheep|flying sheep]] 08:05, 18 April 2019 (UTC)
  
:: I don't think linking to gdisk from fdisk's intro is appropriate, similar software & alternatives are already listed in related articles box. My complaint was specifically about there being no link to [[gdisk]] from the [[Installation guide]]. -- [[User:nl6720|nl6720]] ([[User talk:nl6720|talk]]) 08:56, 14 March 2019 (UTC)
+
:That is not something that belongs in the [[Installation guide]]. The {{ic|1=init=}} parameter is documented in [[Kernel parameters#Parameter list]] and its description hints at the consequences of uninstalling {{Pkg|systemd-sysvcompat}}.
 +
:What made you decide to uninstall {{Pkg|systemd-sysvcompat}}? -- [[User:nl6720|nl6720]] ([[User talk:nl6720|talk]]) 10:37, 18 April 2019 (UTC)
  
::: The point stands though: gdisk was written because fdisk originally lacked GPT support, which ''fdisk'' now does since 2012. So there's hardly any point in linking gdisk from the install guide, and anyone who for some reason is not satisfied with ''fdisk'' can take the extra step and click the link to [[gdisk]] in the [[fdisk]] article.
+
== <s>Verify signature -- alternative keyserver</s> ==
::: Generally, trying to mention each and every single choice, regardless of their equivalence or relevance, is just cumbersome and brings nothing to those reading the guide. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]])
 
  
: I guess {{ic|/dev/sd''X''2}} being root in both examples is the reason for keeping the current "BIOS with MBR or GPT" example. I don't really have a solution for this. The wiki's usage of {{ic|/dev/sdXY}} will need to be addressed sooner or later due to the naming scheme of NVME disks.
+
It seems <code>pgp.mit.edu</code> has been down for weeks.
: Re [[Special:Diff/565508]]: There's no maximum for the ESP, so how about "At least 256 MiB". -- [[User:nl6720|nl6720]] ([[User talk:nl6720|talk]]) 09:00, 2 February 2019 (UTC)
 
  
:: I agree with the simpler examples. To make the numbering work out I propose to simplify the example commands in [[Installation guide#Format the partitions]], it's hard to cater to users who have never mounted a drive or created a directory anyway.
+
Given that GnuPG has setup its keyserver <code>keys.gnupg.net</code>, perhaps we could add it as an alternative?
:: Regarding the partition sizes, note that the column says "suggested size" instead of "maximum" or "minimum" size. (256 MiB is not the strict minimum either, especially for {{ic|/efi}} as mount point.) As such the existing 256-512 MiB suggestion for ESP looks reasonable to me. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:54, 2 February 2019 (UTC)
 
  
::: [https://wiki.archlinux.org/index.php?title=Installation_guide&diff=565589&oldid=565575] -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 19:06, 2 February 2019 (UTC)
+
Despite currently it uses a self signed certificate, which limits TLS.
  
::: My issue with "256–512 MiB" is that the [[EFI system partition#Create the partition]] recommendation "550 MiB" is outside that range. -- [[User:nl6720|nl6720]] ([[User talk:nl6720|talk]]) 19:39, 2 February 2019 (UTC)
+
[[User:LuxD3si9n|LuxD3si9n]] ([[User talk:LuxD3si9n|talk]]) 18:33, 26 March 2019 (UTC)
  
:::: This was (is?) discussed in [[#Wording_in_example_layout_table_and_size_of_EFI_partition]] -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 19:43, 2 February 2019 (UTC)
+
:I don't know even know why we add a specific keyserver to that line... how to deal with keyservers is described in [[GnuPG#Use_a_keyserver]] already. [https://wiki.archlinux.org/index.php?title=Installation_guide&diff=569896&oldid=568871] -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 00:23, 27 March 2019 (UTC)
  
::::: Hmm, I see. FAT32 & 512+ MiB are used due to to firmware bugs, but the example suggests a range that includes a size smaller than 512 MiB so it's ineffective for that purpose. The main issue for me is that readers will see "''conflicting information''" with 256–512 MiB in the [[Installation guide]] and 550 MiB in other articles (just in case, I'm not suggesting to change the other articles). No one is going to think that the "Suggested size" is just a suggestion and not a hard limit.  -- [[User:nl6720|nl6720]] ([[User talk:nl6720|talk]]) 20:10, 2 February 2019 (UTC)
+
== Confusing partition numbers ==
  
:::::: Added an accuracy notice to [[EFI_system_partition#Create_the_partition]]. As to the "No one is going to think that ...", I see no proof of that. -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 18:06, 13 March 2019 (UTC)
+
The partition numbers on this page are confusing. The table calls the root partition /dev/sdX2, while the text below calls it /dev/sdX1. It should be matched for consistency. [[User:Sabinscabin|Sabinscabin]] ([[User talk:Sabinscabin|talk]]) 20:29, 13 April 2019 (UTC)
 
 
=== <s>Example layouts section draft</s> ===
 
 
 
{| class="wikitable"
 
|+ BIOS/MBR
 
|-
 
! Mount point
 
! Partition
 
! [[Wikipedia:Partition type|Partition type]]
 
! Suggested size
 
|-
 
| {{ic|/mnt}}
 
| {{ic|/dev/sd''X''1}}
 
| Linux
 
| At least 32 GiB
 
|-
 
| {{ic|[SWAP]}}
 
| {{ic|/dev/sd''X''2}}
 
| Linux swap
 
| More than 512 MiB
 
|-
 
|}
 
 
 
{| class="wikitable"
 
|+ UEFI/GPT
 
|-
 
! Mount point
 
! Partition
 
! [[Wikipedia:GUID_Partition_Table#Partition_type_GUIDs|Partition type]]
 
! Suggested size
 
|-
 
| {{ic|/boot}} or {{ic|/mnt/efi}}
 
| {{ic|/dev/sd''X''1}}
 
| [[EFI system partition]]
 
| 550 MiB
 
|-
 
| {{ic|/mnt}}
 
| {{ic|/dev/sd''X''2}}
 
| Linux x86-64 root (/)
 
| At least 32 GiB
 
|-
 
| {{ic|[SWAP]}}
 
| {{ic|/dev/sd''X''3}}
 
| Linux swap
 
| More than 512 MiB
 
|-
 
|}
 
 
 
{{Note|
 
* Use [[fdisk]] or [[parted]], or [[gdisk]] (GPT only) to modify partition tables. For example {{ic|fdisk /dev/sd''X''}}.
 
* [[Swap]] space can be set on a [[swap file]] for file systems supporting it.
 
}}
 
 
 
See [[Partitioning#Example layouts]] for more detailed and advanced examples.
 
 
 
== <s>Reword locale section that it is clear that not uncommenting en_US will lead to issues</s> ==
 
 
 
In the unofficial Telegram group we get people at least weekly that have some issue that goes back to not uncommenting en_US.
 
 
 
There needs to be added emphasis on the AND or simply explained that en_US is the default that apps expect, and will otherwise crash or malfunction.
 
 
 
Current: Uncomment {{ic|en_US.UTF-8 UTF-8}} and other needed [[locale]]s in {{ic|/etc/locale.gen}}, and generate them with:
 
 
 
Proposed: Uncomment {{ic|en_US.UTF-8 UTF-8}}, which is needed for many programs to work, and also other needed [[locale]]s in {{ic|/etc/locale.gen}}, and generate them with:
 
 
 
[[User:C0rn3j|C0rn3j]] ([[User talk:C0rn3j|talk]]) 13:53, 11 February 2019 (UTC)
 
 
 
:Uncommenting locales which will never be used does not make sense. Obviously, it is the point of locales to let users configure something else than en_US, so if something crashes without en_US, it is not a configuration problem.
 
:In any case, the installation guide will not change based on some vague claims which others cannot read on.
 
:-- [[User:Lahwaacz|Lahwaacz]] ([[User talk:Lahwaacz|talk]]) 20:43, 12 February 2019 (UTC)
 
 
 
== <s>SSH</s> ==
 
 
 
For me the first thing I wanna do is connect to the new server by SSH!
 
Then I can copy/paste commands, sit at my own workplace with multiple screens, and access the wiki and Google etc etc etc. Am I really the only one? Or does the majority really sit in front of their new linux box with a seperate monitor, keyb and mouse? I would be surprised!
 
Please add, as one of the very first sections, how to enable SSH:
 
-passwd
 
-systemctl start sshd.service
 
 
 
Then you can start to configure and continue the installation :-)
 
{{Unsigned|23:35, 20 February 2019 (UTC)|MrCalvin}}
 
 
 
:All of that is already explained in the [[Install from SSH]] article. -- [[User:nl6720|nl6720]] ([[User talk:nl6720|talk]]) 08:45, 21 February 2019 (UTC)
 
 
 
== Boot loader installation ==
 
 
 
[[Installation guide#Boot loader]] doesn't say to '''install''' a boot loader, it only refers to a list of them. How about adding something like "Choose and install at least one boot loader."? -- [[User:nl6720|nl6720]] ([[User talk:nl6720|talk]]) 19:46, 14 March 2019 (UTC)
 
 
 
: ''At least'' one? -- [[User:Alad|Alad]] ([[User talk:Alad|talk]]) 21:09, 14 March 2019 (UTC)
 
 
 
:: Might not be the most common scenario, but it's possible to use one boot loader for BIOS booting and another for UEFI booting. E.g. [[rEFInd]] for UEFI booting + [[Syslinux]] for BIOS booting. If that use case is too uncommon to be mentioned then just add "Choose and install a boot loader.". -- [[User:nl6720|nl6720]] ([[User talk:nl6720|talk]]) 21:31, 14 March 2019 (UTC)
 

Revision as of 10:37, 18 April 2019

Read this first before adding new suggestions

  • systemd tools such as hostnamectl, timedatectl and localectl do not work in the installation chroot environment, so please do not propose to use them in the guide unless you can prove that they have been made to work also in that case. See [1], [2], [3] and [4] for some past discussions about this issue.
  • localectl list-keymaps does not work due to bug FS#46725. For the chosen replacement command, see [5].
  • localhost must be set explicitely in /etc/hosts, as it is otherwise resolved over the network. See FS#56684.

-- The ArchWiki Administrators 22:17, 2 September 2016 (UTC)

Link to the German version

Instead of de:Arch Install Scripts you could choose de:Anleitung für Einsteiger it means "Beginner's Guid" and is a very detailed artikel for very new arch users and the future experts.

Thank you, done. -- Kynikos (talk) 16:31, 6 February 2018 (UTC)
This was already proposed last year and rejected: [6]. I don't see what has changed since then. If someone adds me as admin to the german wiki or changes the protection settings, I can update de:Arch Install Scripts as required. -- Alad (talk) 18:13, 6 February 2018 (UTC)
I see, I didn't remember that discussion so I've reverted the change, hopefully you'll make it to update the translation, let's leave this open until the problem is solved, otherwise this kind of suggestion will keep appearing recurrently. -- Kynikos (talk) 17:53, 7 February 2018 (UTC)

Network configuration

dhcpcd for installed environment

How about we add a sentence to Installation_guide#Network_configuration describing how to restore use of dhcpcd as done on the installation medium? That way if the connection already worked on installation people only need a brief look at dhcpcd. -- Alad (talk) 15:48, 27 May 2018 (UTC)

I think that would just hide the possibility of choice from users. Maybe just say that dhcpcd is not enabled on the installed system without recommending anything. -- Lahwaacz (talk) 17:34, 27 May 2018 (UTC)

Why should a static IP be preferred over 127.0.1.1 in /etc/hosts?

"If the system has a permanent IP address, it should be used instead of 127.0.1.1."

I think the ArchWiki should not just say do X but also why. Alad as you added this, perhaps you can explain?--Larivact (talk) 15:14, 21 May 2018 (UTC)

In Network_configuration#Local hostname resolution: "For a system with a permanent IP address, that permanent IP address should be used instead of 127.0.1.1." -- Lahwaacz (talk) 06:48, 22 May 2018 (UTC)
First appearance in our wiki, cited source, also discussion. -- Kynikos (talk) 10:26, 22 May 2018 (UTC)

Network Configuration -- WiFi discussion

I'm starting a new thread seeing as the last one took a different direction and never really got resolved.


As it stands, the current instructions for the installation guide make it challenging for users who need to connect to the internet via a Wireless connection rather than wired. The Installation_guide#Connect_to_the_Internet section essentially assumes the users are using a wired connection, and to test it with a ping. Otherwise, they are directed to the Network_configuration page. Unfortunately, that page does not provide clear instructions for new users (or even those who just want to do a quick connection) to establish a connection via wireless. Equally so, should users find their way to the Wireless_network_configuration page, there is some digging to do there in order to find instructions to setup a connection. These are currently using the iw command, which may prove to be challenging to some. I see a few different possible solutions to improve the user experience:

  • Add explicit instructions to the installation guide
    • This is not ideal, as it adds another place to maintain likely duplicate information
  • Add a reference to the Wireless_network_configuration page
    • This is better, though the page would likely need a new section, or some tweaking to allow users to more easily find the information they need to get setup
  • Add new/better instructions to the Network_configuration page
    • This may also prove to be tricky, seeing as that page is already fairly monolithic, and focuses mostly on wired connections

One other consideration (of which I also don't see any progress) is the discussions revolving around moving and breaking down the Network Configuration guides, to separate Wired and Wireless content. With this move I could see such instructions being provided there. In any case, the guide should provide instructions that are:

  • Easy to follow, particularly for new users
  • Puts no emphasis on persisting configurations, as this is not applicable during the install phase
  • Offers options (choice is King)

--CubeTheThird (talk) 23:47, 26 August 2018 (UTC)

The Wireless network configuration link was removed because it cannot be used independently of Network configuration. I propose the following:
  1. Implement Talk:Network configuration#Moving Ethernet-specific sections to Wired subpage. Network configuration currently isn't straightforward. The actual setup instructions are hidden in the Network management section and it's confusing that wireless has a subpage but wired and medium-agnostic configuration are mixed together. See my demo.
  2. Have the Connect to the Internet section only link Network configuration and move the dhcpcd udev rule note there.
  3. Move Wireless network configuration to Network configuration/Wireless and move its iw section to a dedicated article because since recently we also have iwd.
The result should be more user-friendly without duplicating content.
--Larivact (talk) 07:13, 27 August 2018 (UTC)
As for your demo, note that in Talk:Network_configuration#Ongoing_rewrite, Alad said: "ping is one of the very first commands a new user has to run on installation to verify the availability of an internet connection". So unless you intend to direct users from the installation guide directly to the Network configuration#Troubleshooting section, there is still some more thinking to be done... -- Lahwaacz (talk) 07:21, 28 August 2018 (UTC)
Well then let's keep Connect to the Internet and revise it:

The installation image has a udev rule that enables the dhcpcd service for Ethernet network interfaces on boot. If you use Ethernet, verify the connection with ping:

# ping archlinux.org

If the ping fails see Network configuration#Troubleshooting. If you want to use Wi-Fi or a static IP address, stop the dhcpcd service with systemctl stop dhcpcd@interface where the interface name can be tab-completed and proceed with Network configuration.

--Larivact (talk) 08:41, 28 August 2018 (UTC)
That looks good to me. -- Lahwaacz (talk) 14:57, 28 August 2018 (UTC)

fstab

The section about generating the fstab with genfstab mentions -U and -L options but not the possibility to use GPT identifiers PARTUUID and PARTLABEL with the '-t' option. Those are described in Persistent block device naming and are a better choice for some users. genfstab itself doesn't explicitly list the GPT options either so IMHO it would be helpful to add this info here.

—This unsigned comment is by Grmat (talk) 15:12, 9 October 2018‎. Please sign your posts with ~~~~!

In that case you should open a bug / file a patch such that genfstab does list these options. The wiki shouldn't make up for missing basic documentation in distribution tools. -- Alad (talk) 17:49, 13 March 2019 (UTC)

Wording in example layout table and size of EFI partition

Wording in example layout table

Regarding Installation_guide#Example_layouts:

even if many users will understand remainder of the device as what is left after size of /dev/sdx1 and /dev/sdx3 are subtsructed from the size of the device, I think the order of the table might be confusing for some. Some people might set /dev/sdx2 to the size of the device minus size of /dev/sdx1, and then stumbled at where from 512 MiB, or larger, are to be found for /dev/sdx3. Either suggest the swap space as /dev/sdx2 and / as /dev/sdx3, or better explain the meaning of the remainder of the device for sdx2. Regid (talk) 14:05, 29 December 2018 (UTC)

Using /dev/sdx2 for swap is questionable, it doesn't emphasize that swap is optional nor is it consistent with other articles like dm-crypt/Encrypting an entire system. If you have some better explanation for "remainder of the device" feel free to propose it. -- Alad (talk) 08:55, 30 December 2018 (UTC)
I was trying to say that a user that patitions his HD by following the table might do the following: look at first row in the table, and creates the EFI partition. Than continue with the 2nd row. So he creates a partition at the remainder of his HD. Now he comes to the 3rd row: where will he get 512 MiB, or larger? As for dm-crypt/Encrypting an entire system, I might be wrong thinking that each partition is considered a separate device, so it doesn't matter if the swap space is before, or after, the / partition. Regid (talk) 12:41, 30 December 2018 (UTC)
Perhaps call it "Principal part of the device" instead. NB the term "remainder of the device" is often used for a separate /home in other articles. --Indigo (talk) 21:33, 3 February 2019 (UTC)

Size of EFI partition

Moved to Talk:EFI system partition#Size_of_EFI_partition. -- Alad (talk) 17:40, 13 March 2019 (UTC)

Boot loader installation

Installation guide#Boot loader doesn't say to install a boot loader, it only refers to a list of them. How about adding something like "Choose and install at least one boot loader."? -- nl6720 (talk) 19:46, 14 March 2019 (UTC)

At least one? -- Alad (talk) 21:09, 14 March 2019 (UTC)
Might not be the most common scenario, but it's possible to use one boot loader for BIOS booting and another for UEFI booting. E.g. rEFInd for UEFI booting + Syslinux for BIOS booting. If that use case is too uncommon to be mentioned then just add "Choose and install a boot loader.". -- nl6720 (talk) 21:31, 14 March 2019 (UTC)

Boot loader options

Is it worth saying that without systemd-sysvcompat, you need to add the init=/lib/systemd/systemd kernel parameter?

I got a bad surprise when I uninstalled the thing. – flying sheep 08:05, 18 April 2019 (UTC)

That is not something that belongs in the Installation guide. The init= parameter is documented in Kernel parameters#Parameter list and its description hints at the consequences of uninstalling systemd-sysvcompat.
What made you decide to uninstall systemd-sysvcompat? -- nl6720 (talk) 10:37, 18 April 2019 (UTC)

Verify signature -- alternative keyserver

It seems pgp.mit.edu has been down for weeks.

Given that GnuPG has setup its keyserver keys.gnupg.net, perhaps we could add it as an alternative?

Despite currently it uses a self signed certificate, which limits TLS.

LuxD3si9n (talk) 18:33, 26 March 2019 (UTC)

I don't know even know why we add a specific keyserver to that line... how to deal with keyservers is described in GnuPG#Use_a_keyserver already. [7] -- Alad (talk) 00:23, 27 March 2019 (UTC)

Confusing partition numbers

The partition numbers on this page are confusing. The table calls the root partition /dev/sdX2, while the text below calls it /dev/sdX1. It should be matched for consistency. Sabinscabin (talk) 20:29, 13 April 2019 (UTC)