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 15:35]
emulatorman
en:guide:installation [2019/05/07 05:26] (current)
emulatorman
Line 259: Line 259:
 </​code>​ </​code>​
  
-=== Analog modem, ISDN or PPPoE DSL ===+=== ADSL with PPPoE/​PPPoA ​===
  
-For xDSLdial-up and ISDN connectionswe suggest use [[https://www.hyperbola.info/packages/?​q=netifrc|netifrc]]See [[https://wiki.gentoo.org/wiki/Handbook:​AMD64/Full/Networking#ADSL_with_PPPoE.2FPPPoA|ADSL with PPPoE/PPPoA section]] in the Gentoo Handbook.+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.