Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:guide:installation [2017/11/17 14:53]
emulatorman
en:guide:installation [2019/05/07 05:26] (current)
emulatorman
Line 8: Line 8:
   * Instead of six different images we only provide a **single one** which can be booted into an **i686** and **x86_64** live system to install **Hyperbola GNU/​Linux-libre** over the network.   * Instead of six different images we only provide a **single one** which can be booted into an **i686** and **x86_64** live system to install **Hyperbola GNU/​Linux-libre** over the network.
   * Install images are **signed** and it is highly recommend to **verify their signature** before use. On **Hyperbola**,​ this can be done by using <color #​620BB9/#​EEDDFF>​pacman-key -v <​iso-file>​.sig</​color>​   * Install images are **signed** and it is highly recommend to **verify their signature** before use. On **Hyperbola**,​ this can be done by using <color #​620BB9/#​EEDDFF>​pacman-key -v <​iso-file>​.sig</​color>​
-  * The image can be burned to a **CD**, mounted as an **ISO** file, or directly written to a **USB stick** using a utility like <color #0BB928/#DDFFE3>​dd</​color>​. It is intended for new installations only; an existing **Hyperbola GNU/​Linux-libre** system can always be updated with <color #​620BB9/#​EEDDFF>​pacman -Syu</​color>​.+  * The image can be burned to a **CD**, mounted as an **ISO** file, or directly written to a **USB stick** using a utility like <color #620BB9/#EEDDFF>​dd</​color>​. It is intended for new installations only; an existing **Hyperbola GNU/​Linux-libre** system can always be updated with <color #​620BB9/#​EEDDFF>​pacman -Syu</​color>​.
  
 ===== Blind and visually impaired users ===== ===== Blind and visually impaired users =====
Line 33: Line 33:
 === Braille Support === === Braille Support ===
  
-[[en:​main:​downloads#​HyperTalking]] includes ​<color #​0BB928/#​DDFFE3>​brltty</​color>​, for those who own braille displays. ​ The [[https://​www.hyperbola.info/​packages/?​q=brltty|brltty]] package available on the [[en:​main:​downloads#​HyperTalking]] CD was compiled with as few dependencies as possible. If you wish to use braille, you will need to supply the brltty parameter at the boot prompt. ​ Alternatively,​ you can start <color #​620BB9/#​EEDDFF>​brltty</​color>​ from the shell, after the system has booted.+[[en:​main:​downloads#​HyperTalking]] includes ​**brltty**, for those who own braille displays. ​ The [[https://​www.hyperbola.info/​packages/?​q=brltty|brltty]] package available on the [[en:​main:​downloads#​HyperTalking]] CD was compiled with as few dependencies as possible. If you wish to use braille, you will need to supply the brltty parameter at the boot prompt. ​ Alternatively,​ you can start <color #​620BB9/#​EEDDFF>​brltty</​color>​ from the shell, after the system has booted.
  
 The brltty boot-time parameter consists of three comma-separated fields: **driver**, **device**, and **table**. ​ The first is the driver for your display, the second is the name of the device file, and the third is a relative path to a translation table. ​ You can use "<​color #​620BB9/#​EEDDFF>​auto</​color>"​ to specify that the driver should be automatically detected. ​ I encourage you to read the <color #​620BB9/#​EEDDFF>​brltty</​color>​ documentation for a fuller explanation of the program. The brltty boot-time parameter consists of three comma-separated fields: **driver**, **device**, and **table**. ​ The first is the driver for your display, the second is the name of the device file, and the third is a relative path to a translation table. ​ You can use "<​color #​620BB9/#​EEDDFF>​auto</​color>"​ to specify that the driver should be automatically detected. ​ I encourage you to read the <color #​620BB9/#​EEDDFF>​brltty</​color>​ documentation for a fuller explanation of the program.
Line 63: Line 63:
 ==== Connect to the Internet ==== ==== Connect to the Internet ====
  
-<note warning>​As of v197, <color #​0BB928/#​DDFFE3>​udev</​color> ​no longer assigns network interface names according to the **wlanX** and **ethX** naming scheme. If you are coming from a different distribution or are reinstalling **Hyperbola** and not aware of the new interface naming style, please do not assume that your wireless interface is named <color #​620BB9/#​EEDDFF>​wlan0</​color>,​ or that your wired interface is named <color #​620BB9/#​EEDDFF>​eth0</​color>​. You can use the command <color #​620BB9/#​EEDDFF>​ip link</​color>​ to discover the names of your interfaces.</​note>​+<note warning>​As of v197, **udev** no longer assigns network interface names according to the **wlanX** and **ethX** naming scheme. If you are coming from a different distribution or are reinstalling **Hyperbola** and not aware of the new interface naming style, please do not assume that your wireless interface is named <color #​620BB9/#​EEDDFF>​wlan0</​color>,​ or that your wired interface is named <color #​620BB9/#​EEDDFF>​eth0</​color>​. You can use the command <color #​620BB9/#​EEDDFF>​ip link</​color>​ to discover the names of your interfaces.</​note>​
  
 A DHCP service is already enabled for **all available devices**. If you need to setup a static IP or use management tools, you should stop this service first: A DHCP service is already enabled for **all available devices**. If you need to setup a static IP or use management tools, you should stop this service first:
Line 259: Line 259:
 </​code>​ </​code>​
  
-=== Analog modem, ISDN or PPPoE DSL ===+=== ADSL with PPPoE/​PPPoA ​===
  
-For xDSLdial-up and ISDN connectionssee [[https://wiki.archlinux.org/index.php/Direct_Modem_Connection|Direct Modem Connection]].+Follow this procedure if you need **ADSL with PPPoE/​PPPoA** during the installation process. 
 + 
 +Firstidentify the name of your Ethernet interface. 
 + 
 +<code bash> 
 +# ip link 
 + 
 +1: lo: <​LOOPBACK,UP,​LOWER_UP>​ mtu 65536 qdisc noqueue state UNKNOWN mode DEFAULT 
 +    link/​loopback 00:00:​00:​00:​00:​00 brd 00:​00:​00:​00:​00:​00 
 +2: enp2s0f0: <​BROADCAST,​MULTICAST>​ mtu 1500 qdisc noop state DOWN mode DEFAULT qlen 1000 
 +    link/ether 00:​11:​25:​31:​69:​20 brd ff:​ff:​ff:​ff:​ff:​ff 
 +3: wlp3s0: <​BROADCAST,​MULTICAST,​UP,​LOWER_UP>​ mtu 1500 qdisc mq state UP mode DORMANT qlen 1000 
 +    link/ether 01:​02:​03:​04:​05:​06 brd ff:​ff:​ff:​ff:​ff:​ff 
 +</​code>​ 
 + 
 +In this example, the Ethernet interface is **enp2s0f0**. 
 + 
 +Second, create the PPP net script and the net script for the Ethernet interface to be used by PPP: 
 + 
 +<code bash> 
 +# ln -s /etc/init.d/net.lo /etc/init.d/​net.ppp0 
 +</​code>​ 
 + 
 +<code bash> 
 +# ln -s /​etc/​init.d/​net.lo /​etc/​init.d/​net.enp2s0f0 
 +</​code>​ 
 + 
 +<note important>​ 
 +Be sure to set <color #​620BB9/#​EEDDFF>​rc_depend_strict</​color>​ to **YES** in <color #​0B71B9/#​DDF1FF>/​etc/​rc.conf</​color>​.  
 +</​note>​ 
 + 
 +Now we need to configure <color #​0B71B9/#​DDF1FF>/​etc/​conf.d/​net</​color>​. 
 + 
 +<​code>​ 
 +# nano /​etc/​conf.d/​net 
 + 
 +config_eth0=null (Specify the ethernet interface) 
 +config_ppp0="​ppp"​ 
 +link_ppp0="​enp2s0f0"​ (Specify the ethernet interface) 
 +plugins_ppp0="​pppoe"​ 
 +username_ppp0='​user'​ 
 +password_ppp0='​password'​ 
 +pppd_ppp0="​ 
 +noauth 
 +defaultroute 
 +usepeerdns 
 +holdoff 3 
 +child-timeout 60 
 +lcp-echo-interval 15 
 +lcp-echo-failure 3 
 +noaccomp noccp nobsdcomp nodeflate nopcomp novj novjccomp"​ 
 +   
 +rc_net_ppp0_need="​net.enp2s0f0"​ 
 +</​code>​ 
 + 
 +<​note>​ 
 +It is also possible to set the password in <color #​0B71B9/#​DDF1FF>/​etc/​ppp/​pap-secrets</​color>​.  
 +</​note>​ 
 + 
 +<note important>​ 
 +Please carefully read the section on ADSL and PPP in <color #​0B71B9/#​DDF1FF>/​usr/​share/​doc/​netifrc-*/​net.example.bz2</​color>​. It contains many more detailed explanations of all the settings any particular PPP setup will likely need. 
 +</​note>​ 
 + 
 +Now that the interface is configured, we can start it using the following commands: 
 + 
 +<code bash> 
 +rc-service net.ppp0 start 
 +</​code>​
  
 === Behind a proxy server ​ === === Behind a proxy server ​ ===
Line 269: Line 336:
 ==== Verification of package signatures ==== ==== Verification of package signatures ====
  
-New packager keys are necessary by default to install **Hyperbola** from current ISOs. Because changes in existing keys might happen since the ISO release, it is recommended,​ if **not mandatory**,​ to update the keys before attempting an install. ​To upgrade ​the package ​[[https://​www.hyperbola.info/​packages/?​q=hyperbola-keyring|hyperbola-keyring]] and [[https://www.hyperbola.info/​packages/?​q=arch-keyring|arch-keyring]]:​+New packager keys are necessary by default to install **Hyperbola** from current ISOs. Because changes in existing keys might happen since the ISO release, it is recommended,​ if **not mandatory**,​ to update the keys before attempting an install. 
 + 
 +<note important>​ 
 +Keep in mind these steps will fail if your system is not set to the correct time, or if you are not connected to the internet. See [[en:guide:​installation#​connect_to_the_internet|above]] for internet setup instructions. 
 +</note> 
 + 
 +To check that your computer has the correct time, enter <color #620BB9/#​EEDDFF>​date</​color>​ in the terminal.
  
 <code bash> <code bash>
-pacman -Sy hyperbola-keyring arch-keyring+date
 </​code>​ </​code>​
  
-If you face GPG errors updating those packagesit's likely because ​the key that signed it have **expired**. To fix thisrun:+If the date is incorrect, ​you will need to manually set the correct time. 
 + 
 +<code bash> 
 +# date MMDDhhmm[[CC]YY][.ss] 
 +</​code>​ 
 + 
 +where **MM** is the month**DD** ​the day, **hh** the hour, **mm** the minutes, **CC** the century, **YY** the year and **.SS** the seconds of current timethe seconds can be omitted (and then also the dot before them should be omitted), the year can also be submitted or just the century. for instance if the current time is 32 seconds and 44 minutes past 18 (6 pm) on the 13th November 2013. Then the command would be: 
 + 
 +<code bash> 
 +# date 111318442013.32 
 +</​code>​ 
 + 
 +Once the date is correct, we need to initialize the gnupg directory and update pacman'​s keys. 
 + 
 +<code bash> 
 +# pacman-key --init 
 +</​code>​ 
 + 
 +<code bash> 
 +# mount -o remount,​size=100M,​noatime /​etc/​pacman.d/​gnupg 
 +</​code>​
  
 <code bash> <code bash>
Line 285: Line 378:
 </​code>​ </​code>​
  
-After that, if no errors ​happen, running ​<color #​620BB9/#​EEDDFF>​pacman -Sy hyperbola-keyring arch-keyring</​color>​ again should work.+If you get GPG errors ​updating those packagesyou can try running ​these commands to start over:
  
-If you get an error related to <color #620BB9/#​EEDDFF>​dirmngr</color>, you can get rid of it with:+<code bash> 
 +rm -r /etc/​pacman.d/​gnupg/​* 
 +</code>
  
 <code bash> <code bash>
-mkdir /​root/​.gnupg && chmod go-rx /​root/​.gnupg && touch /​root/​.gnupg/​dirmngr_ldapservers.conf+pacman-key --init
 </​code>​ </​code>​
  
-For the time being, running the previous command might also be needed in the newly installed system. +<code bash> 
- +# pacman-key --populate hyperbola arch 
-It may be also possible that the system clock is behind and the keys are incorrectly marked invalid. ​ To solve this, manually set the correct time.+</​code>​
  
 <code bash> <code bash>
-date MMDDhhmm[[CC]YY][.ss]+pacman-key --refresh-keys
 </​code>​ </​code>​
  
-where **MM** is the month**DD** the day, **hh** the hour, **mm** the minutes, **CC** the century, **YY** the year and **.SS** the seconds ​of current time, the seconds can be omitted (and then also the dot before them should be omitted), the year can also be submitted or just the century. for instance if the current time is 32 seconds and 44 minutes past 18 (6 pm) on the 13th November 2013. Then the command would be:+If you get an error related to <color #​620BB9/#​EEDDFF>​dirmngr</​color>​you can get rid of it with:
  
 <code bash> <code bash>
-date 111318442013.32+mkdir /root/.gnupg && chmod go-rx /​root/​.gnupg && touch /​root/​.gnupg/​dirmngr_ldapservers.conf
 </​code>​ </​code>​
 +
 +For the time being, running the previous command might also be needed in the newly installed system.
  
 ==== Install the base system ==== ==== Install the base system ====
Line 331: Line 428:
  
 <code bash> <code bash>
-# pacman ​-Sfy hyperbola-keyring arch-keyring+rm -r /etc/pacman.d/gnupg/*
 </​code>​ </​code>​
 +
 +<code bash>
 +# pacman-key --init
 +</​code>​
 +
 +<code bash>
 +# pacman-key --populate hyperbola arch
 +</​code>​
 +
 +<code bash>
 +# pacman-key --refresh-keys
 +</​code>​
 +
 </​note>​ </​note>​
  
Line 380: Line 490:
  
   * Write your hostname to <color #​0B71B9/#​DDF1FF>/​etc/​hostname</​color>​   * Write your hostname to <color #​0B71B9/#​DDF1FF>/​etc/​hostname</​color>​
 +
 +<code bash>
 +# echo myhostname > /​etc/​hostname
 +</​code>​
 +
   * Symlink <color #​0B71B9/#​DDF1FF>/​etc/​localtime</​color>​ to <color #​0B71B9/#​DDF1FF>/​usr/​share/​zoneinfo/​Zone/​SubZone</​color>​. Replace <color #​620BB9/#​EEDDFF>​Zone</​color>​ and <color #​620BB9/#​EEDDFF>​Subzone</​color>​ to your liking. For example:   * Symlink <color #​0B71B9/#​DDF1FF>/​etc/​localtime</​color>​ to <color #​0B71B9/#​DDF1FF>/​usr/​share/​zoneinfo/​Zone/​SubZone</​color>​. Replace <color #​620BB9/#​EEDDFF>​Zone</​color>​ and <color #​620BB9/#​EEDDFF>​Subzone</​color>​ to your liking. For example:
  
Line 389: Line 504:
   * Add console keymap and font preferences in <color #​0B71B9/#​DDF1FF>/​etc/​conf.d/​keymaps</​color>​   * Add console keymap and font preferences in <color #​0B71B9/#​DDF1FF>/​etc/​conf.d/​keymaps</​color>​
   * Uncomment the selected locale in <color #​0B71B9/#​DDF1FF>/​etc/​locale.gen</​color>​ and generate it with <color #​620BB9/#​EEDDFF>​locale-gen</​color>​   * Uncomment the selected locale in <color #​0B71B9/#​DDF1FF>/​etc/​locale.gen</​color>​ and generate it with <color #​620BB9/#​EEDDFF>​locale-gen</​color>​
 +  * Set a root password with <color #​620BB9/#​EEDDFF>​passwd</​color>​
 +  * Add your user to the relevant [[https://​wiki.archlinux.org/​index.php/​Users_and_groups|group]] such as:
 +
 +<code bash>
 +# gpasswd -a YourActualUserName video
 +</​code>​
 +
   * Configure <color #​0B71B9/#​DDF1FF>/​etc/​mkinitcpio.conf</​color>​ as needed (see [[https://​wiki.archlinux.org/​index.php/​Mkinitcpio|mkinitcpio]]) and create an initial RAM disk with:   * Configure <color #​0B71B9/#​DDF1FF>/​etc/​mkinitcpio.conf</​color>​ as needed (see [[https://​wiki.archlinux.org/​index.php/​Mkinitcpio|mkinitcpio]]) and create an initial RAM disk with:
    
Line 406: Line 528:
 # grub-install /dev/sdX # grub-install /dev/sdX
 </​code>​ </​code>​
 +
 +<note important>​
 +If you want to [[en:​guide:​encrypted_installation|install GRUB on a Libreboot system]], keep in mind your system **does not use UEFI or Legacy BIOS**, but instead loads GRUB as its only payload. So you we will run this command instead:
 +
 +<code bash>
 +grub-install --no-bootsector /dev/sdX
 +</​code>​
 +</​note>​
  
 <code bash> <code bash>
Line 411: Line 541:
 </​code>​ </​code>​
  
-  * Set a root password with <color #​620BB9/#​EEDDFF>​passwd</​color>​ 
   * Configure the network again for newly installed environment. See [[https://​wiki.archlinux.org/​index.php/​Network_Configuration|Network Configuration]] and [[https://​wiki.parabola.nu/​Wireless_Setup|Wireless Setup]].   * Configure the network again for newly installed environment. See [[https://​wiki.archlinux.org/​index.php/​Network_Configuration|Network Configuration]] and [[https://​wiki.parabola.nu/​Wireless_Setup|Wireless Setup]].
  
- +<note tip> 
-Add your user to the relevant ​[[https://​wiki.archlinux.org/​index.php/​Users_and_groups|group]] such as: +If you are following ​the [[en:guide:​encrypted_installation|libreboot encrypted installation]] instructions,​ be sure to save copy of grub.cfg on a thumbdrive in case the one flashed to libreboot is incorrect. You can use the grub shell to boot from the extra copy. 
- +</note>
-<code bash> +
-# gpasswd -YourActualUserName video +
-</code>+
  
 ==== Configure speech support (for blind and visually impaired users) ==== ==== Configure speech support (for blind and visually impaired users) ====
Line 475: Line 601:
 ===== Acknowledgement ===== ===== Acknowledgement =====
  
-This wiki article is based on **ArchWiki** and **[[https://​wiki.parabola.nu/​|ParabolaWiki]]**. We may have removed non-[[https://​www.gnu.org/​philosophy/​free-system-distribution-guidelines.html|FSDG]] bits from it.+This wiki article is based on **ArchWiki**, **GentooWiki** and **[[https://​wiki.parabola.nu/​|ParabolaWiki]]**. We may have removed non-[[https://​www.gnu.org/​philosophy/​free-system-distribution-guidelines.html|FSDG]] bits from it.