Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
pt:manual:installation [2020/04/26 04:23] i3_relativism Criação deste novo documento. |
pt:manual:installation [2025/02/26 16:25] (current) luck02 [Partition disks] |
||
---|---|---|---|
Line 1: | Line 1: | ||
... (WIP) | ... (WIP) | ||
+ | |||
+ | ====== O Guia de Instalação ====== | ||
+ | |||
+ | O Guia da Instalação para a imagem live-CD da Hyperbola (launchable from USB thumb-drive, | ||
+ | |||
+ | ===== Download ===== | ||
+ | |||
+ | Download the new **Hyperbola ISO** from the [[en: | ||
+ | * 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/ | ||
+ | * Install images are **signed** and it is highly recommend to **verify their signature** before use. On **Hyperbola**, | ||
+ | * 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 # | ||
+ | |||
+ | ===== Usuários cegos e com deficiência visual ===== | ||
+ | |||
+ | There is a ISO called [[en: | ||
+ | |||
+ | ===== Escrevendo uma imagem ISO Hyperbola para uma unidade USB ===== | ||
+ | |||
+ | <code bash> | ||
+ | # dd if='' | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | |||
+ | < | ||
+ | |||
+ | ===== Instalação ===== | ||
+ | |||
+ | |||
+ | ==== Layout do teclado ==== | ||
+ | |||
+ | For many countries and keyboard types appropriate keymaps are available already, and a command like <color # | ||
+ | |||
+ | === Braille Support === | ||
+ | |||
+ | [[en: | ||
+ | |||
+ | The brltty boot-time parameter consists of three comma-separated fields: **driver**, **device**, and **table**. | ||
+ | |||
+ | For example, suppose that you have a device connected to <color # | ||
+ | |||
+ | <code bash> | ||
+ | arch32 brltty=auto, | ||
+ | </ | ||
+ | |||
+ | Once <color # | ||
+ | |||
+ | ==== Partição dos Discos ==== | ||
+ | |||
+ | See [[https:// | ||
+ | |||
+ | Remember to create any stacked block devices like [[https:// | ||
+ | |||
+ | ==== Format the partitions ==== | ||
+ | |||
+ | See [[https:// | ||
+ | |||
+ | If you are using (U)EFI you will most probably need another partition to host the UEFI System partition. Read [[https:// | ||
+ | |||
+ | ==== Mount the partitions ==== | ||
+ | |||
+ | We now must mount the root partition on <color # | ||
+ | |||
+ | ==== Connect to the Internet ==== | ||
+ | |||
+ | <note warning> | ||
+ | |||
+ | 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: | ||
+ | |||
+ | <code bash> | ||
+ | # rc-service dhcpcd stop | ||
+ | </ | ||
+ | |||
+ | For more information read [[https:// | ||
+ | |||
+ | The [[https:// | ||
+ | |||
+ | <code bash> | ||
+ | # ping -c 3 gnu.org | ||
+ | |||
+ | PING gnu.org (208.118.235.148) 56(84) bytes of data. | ||
+ | 64 bytes from wildebeest.gnu.org (208.118.235.148): | ||
+ | 64 bytes from wildebeest.gnu.org (208.118.235.148): | ||
+ | 64 bytes from wildebeest.gnu.org (208.118.235.148): | ||
+ | |||
+ | --- gnu.org ping statistics --- | ||
+ | 3 packets transmitted, | ||
+ | rtt min/ | ||
+ | </ | ||
+ | |||
+ | If you get a <color # | ||
+ | |||
+ | === Wired === | ||
+ | |||
+ | Follow this procedure if you need to set up a wired connection via a **static IP address**. | ||
+ | |||
+ | First, disable the <color # | ||
+ | |||
+ | <code bash> | ||
+ | # rc-service dhcpcd stop | ||
+ | </ | ||
+ | |||
+ | Identify the name of your Ethernet interface. | ||
+ | |||
+ | <code bash> | ||
+ | # ip link | ||
+ | |||
+ | 1: lo: < | ||
+ | link/ | ||
+ | 2: enp2s0f0: < | ||
+ | link/ether 00: | ||
+ | 3: wlp3s0: < | ||
+ | link/ether 01: | ||
+ | </ | ||
+ | |||
+ | In this example, the Ethernet interface is **enp2s0f0**. If you are unsure, your Ethernet interface is likely to start with the letter " | ||
+ | |||
+ | <code bash> | ||
+ | # iwconfig | ||
+ | |||
+ | enp2s0f0 | ||
+ | wlp3s0 | ||
+ | Mode: | ||
+ | Bit Rate=65 Mb/s | ||
+ | Retry long limit: | ||
+ | Power Management: | ||
+ | Link Quality=61/ | ||
+ | Rx invalid nwid: | ||
+ | Tx excessive retries: | ||
+ | lo no wireless extensions. | ||
+ | </ | ||
+ | |||
+ | In this example, neither **enp2s0f0** nor the **loopback** device have wireless extensions, meaning **enp2s0f0** is our Ethernet interface. | ||
+ | |||
+ | You also need to **know these settings**: | ||
+ | |||
+ | * Static IP address. | ||
+ | * Subnet mask. | ||
+ | * Gateway' | ||
+ | * Name servers' | ||
+ | * Domain name (unless you are on a local LAN, in which case you can make it up). | ||
+ | |||
+ | Activate the connected Ethernet interface (e.g. **enp2s0f0**): | ||
+ | |||
+ | <code bash> | ||
+ | # ip link set enp2s0f0 up | ||
+ | </ | ||
+ | |||
+ | Add the address: | ||
+ | |||
+ | <code bash> | ||
+ | # ip addr add ip_address/ | ||
+ | </ | ||
+ | |||
+ | For example: | ||
+ | |||
+ | <code bash> | ||
+ | # ip addr add 192.168.1.2/ | ||
+ | </ | ||
+ | |||
+ | For more options, run <color # | ||
+ | |||
+ | Add your gateway like this, substituting your own gateway' | ||
+ | |||
+ | <code bash> | ||
+ | # ip route add default via ip_address | ||
+ | </ | ||
+ | |||
+ | For example: | ||
+ | |||
+ | <code bash> | ||
+ | # ip route add default via 192.168.1.1 | ||
+ | </ | ||
+ | |||
+ | Edit <color # | ||
+ | |||
+ | <code bash> | ||
+ | # nano / | ||
+ | |||
+ | nameserver 61.23.173.5 | ||
+ | nameserver 61.95.849.8 | ||
+ | search example.com | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | Currently, you may include a maximum of three nameserver lines. In order to overcome this limitation, you can use a locally caching nameserver like [[https:// | ||
+ | </ | ||
+ | |||
+ | You should now have a working network connection. If you do not, check the detailed [[https:// | ||
+ | |||
+ | === Wireless === | ||
+ | |||
+ | Follow this procedure if you need **wireless connectivity (Wi-Fi)** during the installation process. | ||
+ | |||
+ | First, identify the name of your wireless interface. | ||
+ | |||
+ | <code bash> | ||
+ | # iw dev | ||
+ | |||
+ | phy#0 | ||
+ | Interface wlp3s0 | ||
+ | ifindex 3 | ||
+ | wdev 0x1 | ||
+ | addr 00: | ||
+ | type managed | ||
+ | </ | ||
+ | |||
+ | In this example, **wlp3s0** is the available wireless interface. If you are unsure, your wireless interface is likely to start with the letter " | ||
+ | |||
+ | < | ||
+ | If you do not see output similar to this, then your wireless driver has not been loaded. Please see [[https:// | ||
+ | </ | ||
+ | |||
+ | Bring the interface up with: | ||
+ | |||
+ | <code bash> | ||
+ | # ip link set wlp3s0 up | ||
+ | </ | ||
+ | |||
+ | <note important> | ||
+ | If you get this error message: | ||
+ | |||
+ | <code bash> | ||
+ | SIOCSIFFLAGS: | ||
+ | </ | ||
+ | |||
+ | Then, your wireless chipset could need a <color # | ||
+ | </ | ||
+ | |||
+ | Next, use <color # | ||
+ | |||
+ | <code bash> | ||
+ | # wpa_supplicant -B -i wlp3s0 -c < | ||
+ | </ | ||
+ | |||
+ | You need to replace **ssid** with the name of your network (e.g. " | ||
+ | |||
+ | Finally, you have to give your interface an IP address. This can be set manually or using the dhcp: | ||
+ | |||
+ | <code bash> | ||
+ | # dhcpcd wlp3s0 | ||
+ | </ | ||
+ | |||
+ | If that does not work, issue the following commands: | ||
+ | |||
+ | <code bash> | ||
+ | # echo ' | ||
+ | </ | ||
+ | <code bash> | ||
+ | # wpa_passphrase < | ||
+ | </ | ||
+ | <code bash> | ||
+ | # ip link set < | ||
+ | </ | ||
+ | <code bash> | ||
+ | # wpa_supplicant -B -D nl80211 -c / | ||
+ | </ | ||
+ | <code bash> | ||
+ | # dhcpcd -A < | ||
+ | </ | ||
+ | |||
+ | === ADSL with PPPoE/PPPoA === | ||
+ | |||
+ | Follow this procedure if you need **ADSL with PPPoE/ | ||
+ | |||
+ | First, identify the name of your Ethernet interface. | ||
+ | |||
+ | <code bash> | ||
+ | # ip link | ||
+ | |||
+ | 1: lo: < | ||
+ | link/ | ||
+ | 2: enp2s0f0: < | ||
+ | link/ether 00: | ||
+ | 3: wlp3s0: < | ||
+ | link/ether 01: | ||
+ | </ | ||
+ | |||
+ | 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 / | ||
+ | </ | ||
+ | |||
+ | <code bash> | ||
+ | # ln -s / | ||
+ | </ | ||
+ | |||
+ | <note important> | ||
+ | Be sure to set <color # | ||
+ | </ | ||
+ | |||
+ | Now we need to configure <color # | ||
+ | |||
+ | < | ||
+ | # nano / | ||
+ | |||
+ | config_eth0=null (Specify the ethernet interface) | ||
+ | config_ppp0=" | ||
+ | link_ppp0=" | ||
+ | plugins_ppp0=" | ||
+ | username_ppp0=' | ||
+ | password_ppp0=' | ||
+ | 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=" | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | It is also possible to set the password in <color # | ||
+ | </ | ||
+ | |||
+ | <note important> | ||
+ | Please carefully read the section on ADSL and PPP in <color # | ||
+ | </ | ||
+ | |||
+ | Now that the interface is configured, we can start it using the following commands: | ||
+ | |||
+ | <code bash> | ||
+ | rc-service net.ppp0 start | ||
+ | </ | ||
+ | |||
+ | === Behind a proxy server | ||
+ | |||
+ | If you are behind a proxy server, you will need to export the <color # | ||
+ | |||
+ | ==== 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, | ||
+ | |||
+ | <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: | ||
+ | </ | ||
+ | |||
+ | To check that your computer has the correct time, enter <color # | ||
+ | |||
+ | <code bash> | ||
+ | # date | ||
+ | </ | ||
+ | |||
+ | If the date is incorrect, you will need to manually set the correct time. | ||
+ | |||
+ | <code bash> | ||
+ | # date MMDDhhmm[[CC]YY][.ss] | ||
+ | </ | ||
+ | |||
+ | 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: | ||
+ | |||
+ | <code bash> | ||
+ | # date 111318442013.32 | ||
+ | </ | ||
+ | |||
+ | Once the date is correct, we need to initialize the gnupg directory and update pacman' | ||
+ | |||
+ | <code bash> | ||
+ | # pacman-key --init | ||
+ | </ | ||
+ | |||
+ | <code bash> | ||
+ | # mount -o remount, | ||
+ | </ | ||
+ | |||
+ | <code bash> | ||
+ | # pacman-key --populate hyperbola arch | ||
+ | </ | ||
+ | |||
+ | <code bash> | ||
+ | # pacman-key --refresh-keys | ||
+ | </ | ||
+ | |||
+ | If you get GPG errors updating those packages, you can try running these commands to start over: | ||
+ | |||
+ | <code bash> | ||
+ | # rm -r / | ||
+ | </ | ||
+ | |||
+ | <code bash> | ||
+ | # pacman-key --init | ||
+ | </ | ||
+ | |||
+ | <code bash> | ||
+ | # pacman-key --populate hyperbola arch | ||
+ | </ | ||
+ | |||
+ | <code bash> | ||
+ | # pacman-key --refresh-keys | ||
+ | </ | ||
+ | |||
+ | If you get an error related to <color # | ||
+ | |||
+ | <code bash> | ||
+ | # mkdir / | ||
+ | </ | ||
+ | |||
+ | For the time being, running the previous command might also be needed in the newly installed system. | ||
+ | |||
+ | ==== Install the base system ==== | ||
+ | |||
+ | Before installing, you may want to edit <color # | ||
+ | |||
+ | Install the base system using <color # | ||
+ | |||
+ | <code bash> | ||
+ | # pacstrap /mnt | ||
+ | </ | ||
+ | |||
+ | You can install additional packages passing <color # | ||
+ | |||
+ | If you have a **btrfs root**, you probably want to install also [[https:// | ||
+ | |||
+ | < | ||
+ | If you face GPG errors when running: | ||
+ | |||
+ | <code bash> | ||
+ | # pacstrap /mnt | ||
+ | </ | ||
+ | |||
+ | Then, you can try to fix them with: | ||
+ | |||
+ | <code bash> | ||
+ | # rm -r / | ||
+ | </ | ||
+ | |||
+ | <code bash> | ||
+ | # pacman-key --init | ||
+ | </ | ||
+ | |||
+ | <code bash> | ||
+ | # pacman-key --populate hyperbola arch | ||
+ | </ | ||
+ | |||
+ | <code bash> | ||
+ | # pacman-key --refresh-keys | ||
+ | </ | ||
+ | |||
+ | </ | ||
+ | |||
+ | ==== Install and configure a bootloader ==== | ||
+ | |||
+ | === GRUB === | ||
+ | |||
+ | * For BIOS and EFI: | ||
+ | |||
+ | <code bash> | ||
+ | # pacstrap /mnt grub | ||
+ | </ | ||
+ | |||
+ | * Install GRUB after chrooting (refer to the [[en: | ||
+ | |||
+ | See [[https:// | ||
+ | |||
+ | === Syslinux === | ||
+ | |||
+ | <code bash> | ||
+ | # pacstrap /mnt syslinux | ||
+ | </ | ||
+ | |||
+ | See [[https:// | ||
+ | |||
+ | ==== Install wireless tools ==== | ||
+ | |||
+ | If your wireless network is WPA protected, you'll need [[https:// | ||
+ | |||
+ | <code bash> | ||
+ | # pacstrap /mnt wpa_supplicant | ||
+ | </ | ||
+ | |||
+ | ==== Configure the system ==== | ||
+ | |||
+ | Generate a [[https:// | ||
+ | |||
+ | <code bash> | ||
+ | # genfstab -p /mnt >> / | ||
+ | </ | ||
+ | |||
+ | Next we [[https:// | ||
+ | |||
+ | <code bash> | ||
+ | # arch-chroot /mnt | ||
+ | </ | ||
+ | |||
+ | * Write your hostname to <color # | ||
+ | |||
+ | <code bash> | ||
+ | # echo myhostname > / | ||
+ | </ | ||
+ | |||
+ | * Symlink <color # | ||
+ | |||
+ | <code bash> | ||
+ | # ln -s / | ||
+ | </ | ||
+ | |||
+ | * Set [[archive: | ||
+ | * Add console keymap and font preferences in <color # | ||
+ | * Uncomment the selected locale in <color # | ||
+ | * Set a root password with <color # | ||
+ | * Add your user to the relevant [[https:// | ||
+ | |||
+ | <code bash> | ||
+ | # gpasswd -a YourActualUserName video | ||
+ | </ | ||
+ | |||
+ | * Configure <color # | ||
+ | |||
+ | <code bash> | ||
+ | # mkinitcpio -p linux-libre-lts | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | |||
+ | * If you want to install GRUB for the (U)EFI mode, you will need to make sure that: | ||
+ | * The computer booted in (U)EFI mode (if <color # | ||
+ | * The efivars module is loaded. (<color # | ||
+ | |||
+ | * To configure the bootloader, you have to install it and generate the file <color # | ||
+ | |||
+ | <code bash> | ||
+ | # grub-install /dev/sdX | ||
+ | </ | ||
+ | |||
+ | <note important> | ||
+ | If you want to [[en: | ||
+ | |||
+ | <code bash> | ||
+ | grub-install --no-bootsector /dev/sdX | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <code bash> | ||
+ | # grub-mkconfig -o / | ||
+ | </ | ||
+ | |||
+ | * Configure the network again for newly installed environment. See [[https:// | ||
+ | |||
+ | <note tip> | ||
+ | If you are following the [[en: | ||
+ | </ | ||
+ | |||
+ | ==== Configure speech support (for blind and visually impaired users) ==== | ||
+ | |||
+ | If you are using [[en: | ||
+ | |||
+ | * Install [[https:// | ||
+ | * Enable the espeakup service by executing: | ||
+ | |||
+ | <code bash> | ||
+ | # rc-update add espeakup default | ||
+ | </ | ||
+ | |||
+ | * Save the state of the sound card, so that it will be retrieved on reboot: | ||
+ | |||
+ | <code bash> | ||
+ | # alsactl store | ||
+ | </ | ||
+ | |||
+ | ==== Unmount and reboot ==== | ||
+ | |||
+ | If you are still in the chroot environment type <color # | ||
+ | Earlier we mounted the partitions under <color # | ||
+ | |||
+ | <code bash> | ||
+ | # umount / | ||
+ | </ | ||
+ | |||
+ | Now reboot and then login into the new system with the root account. | ||
+ | |||
+ | ==== Configure pacman ==== | ||
+ | |||
+ | Edit <color # | ||
+ | |||
+ | See [[https:// | ||
+ | |||
+ | ==== Update the system ==== | ||
+ | |||
+ | At this point you should update your system. | ||
+ | |||
+ | See [[https:// | ||
+ | |||
+ | ==== Add an user ==== | ||
+ | |||
+ | Finally, add a normal user as described in [[https:// | ||
+ | |||
+ | ===== Service management ===== | ||
+ | |||
+ | Since Hyperbola [[https:// | ||
+ | |||
+ | ===== Conclusion ===== | ||
+ | |||
+ | Your new **Hyperbola GNU/ | ||
+ | |||
+ | ===== Acknowledgement ===== | ||
+ | |||
+ | This wiki article is based on **ArchWiki**, |