This is an old revision of the document!


Guía de instalación

La Guía de instalación del live-CD de Hyperbola (que también se puede ejecutar desde una unidad de memoria USB) está destinada a ayudar a los usuarios experimentados de GNU/Linux a instalar Hyperbola desde el sistema live iniciado con la imagen de instalación oficial. Esta página asume un alto nivel de experiencia con los sistemas y utilidades GNU/Linux, especialmente la línea de comandos. Si desea una guía más detallada, paso a paso a través del proceso de instalación, consulte la Guía para principiantes. Antes de comenzar, le recomendamos que consulte nuestras FAQ, Arch FAQ, y emplee el man command para leer la página del manual de cualquier comando con el que no estén familiarizados. La wiki de Hyperbola (conocida como HyperWiki), así como la ArchWiki, debe ser la fuente principal de información y su primer recurso durante la resolución de problemas.

Descarga

Descargue la nueva imagen de Hyperbola ISO desde la página de descarga.

  • En lugar de seis imágenes diferentes, solo proporcionamos una sola imagen que puede iniciarse en un sistema i686 y x86_64 para instalar Hyperbola GNU/Linux-libre a través de la red.
  • Las imágenes de instalación están firmadas y se recomienda verificar su firma antes de usarlas. En Hyperbola, esto se puede hacer usando pacman-key -v <iso-file>.sig
  • La imagen se puede grabar en un CD, se puede montar como un archivo ISO o se puede escribir directamente en un USB stick utilizando una utilidad como dd. Esto destinado solo para nuevas instalaciones; un sistema existente Hyperbola GNU/Linux-libre siempre se puede actualizar con pacman -Syu.

Usuarios de baja visión o deficientes visuales.

Existe una ISO llamada HyperTalking que es un CD de instalación derivado, basado en TalkingArch y una copia de la Hyperbola ISO modificada para incluir la salida de voz y braille.

Escribiendo una imagen ISO de Hyperbola en una unidad USB

# dd if=''[iso file]'' of=''[usb device file]'' bs=1M && sync
[iso file] es la ruta del archivo ISO image.
[usb device file] es la ruta del archivo dispositivo USB. dmesg o lsblk –fs puede usarse para saber la ruta. A menudo es similar a los nombres de los dispositivos de almacenamiento como discos duros y SSD, por ejemplo. /dev/sdb 'Es muy importante usar el valor correcto' para evitar sobrescribir otros dispositivos de almacenamiento.

Instalación

Diseño del teclado

Para muchos países y tipos de teclado, ya están disponibles los mapas de teclas apropiados, y un comando como loadkeys uk puede hacer lo que desee. Puede encontrar más archivos de mapas de teclas disponibles en /usr/share/kbd/keymaps/ (puede omitir la ruta del mapa de teclado y la extensión de archivo usando loadkeys).

Soporte braille

HyperTalking incluye brltty, para aquellos que poseen pantallas braille. El paquete brltty disponible en el CD HyperTalking se compiló con la menor cantidad de dependencias posible. Si desea utilizar braille, deberá proporcionar el parámetro brltty en el indicador de inicio. Alternativamente, puede iniciar brltty desde el shell, una vez que el sistema se haya iniciado.

El parámetro brltty boot-time consta de tres campos separados por comas: driver, device y table. El primero es el controlador para su pantalla, el segundo es el nombre del archivo del dispositivo y el tercero es una ruta relativa a una tabla de traducción. Puede usar “auto” para especificar que el controlador debe detectarse automáticamente. Lo invito a leer la documentación de brltty para una explicación más completa del programa.

Por ejemplo, suponga que tiene un dispositivo conectado a /dev/ttyS0, el primer puerto serie. Usted desea utilizar la tabla de texto en inglés de EE.UU. y el controlador debe ser detectado automáticamente. Esto es lo que debe escribir en el indicador de arranque:

arch32 brltty=auto,ttyS0,en_US

Una vez que se esté ejecutando brltty, es posible que desee deshabilitar el habla. Puede hacerlo a través de la tecla “print screen”, también conocida como sysrq. En mi teclado qwerty, esa tecla está ubicada directamente sobre la tecla de inserción, entre F12 y el bloqueo de desplazamiento.

Particionado de discos

Consulte partitioning para obtener más información.

Recuerde crear cualquier dispositivo de bloque apilado como LVM, LUKS, o RAID.

Formatear las particiones

Consulte File Systems para obtener más información.

Si está utilizando (U)EFI, lo más probable es que necesite otra partición para alojar la partición del sistema UEFI. Lea Crear una partición del sistema UEFI en GNU/Linux.

Montar las particiones

Ahora debemos montar la partición raíz en /mnt. También debe crear directorios y montar cualquier otra partición (/mnt/boot, /mnt/home, …) y monte su partición swap si desea que sean detectadas por genfstab.

Conectar a internet

A partir de la v197, udev ya no asigna nombres de interfaz de red según el esquema de denominación wlanX y ethX. Si viene de una distribución diferente o está reinstalando Hyperbola y no conoce el nuevo estilo de nomenclatura de la interfaz, no asuma que su interfaz inalámbrica se llama wlan0, o que su interfaz alámbrica se llame eth0. Puede usar el comando ip link para descubrir los nombres de sus interfaces.

Un servicio DHCP ya está habilitado para todos los dispositivos disponibles. Si necesita configurar una IP estática o usar herramientas de administración, primero debe detener este servicio:

# rc-service dhcpcd stop

Para obtener más información, lea Configuring Network.

El daemon de red dhcpcd se inicia automáticamente durante el arranque e intentará iniciar una conexión por cable. Intente hacer ping a un servidor para ver si se estableció una conexión. Por ejemplo, gnu.org:

# 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): icmp_seq=1 ttl=47 time=183 ms
64 bytes from wildebeest.gnu.org (208.118.235.148): icmp_seq=2 ttl=47 time=168 ms
64 bytes from wildebeest.gnu.org (208.118.235.148): icmp_seq=3 ttl=47 time=183 ms
 
--- gnu.org ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2002ms
rtt min/avg/max/mdev = 168.131/178.357/183.914/7.248 ms

Si obtiene un ping: unknown host error, primero verifique si hay un problema con el cable o la intensidad de la señal inalámbrica. De lo contrario, deberá configurar la red manualmente, como se explica a continuación.

Cableado

Siga este procedimiento si necesita configurar una conexión por cable a través de una dirección IP estática.

Primero, deshabilite el servicio dhcpcd que se inició automáticamente en el arranque:

# rc-service dhcpcd stop

Identifique el nombre de su interfaz Ethernet.

# 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

En este ejemplo, la interfaz Ethernet es enp2s0f0. Si no está seguro, es probable que su interfaz de Ethernet comience con la letra “e” y que no sea “lo” o que comience con la letra “w”. También puede usar iwconfig y ver qué interfaces no son inalámbricas:

# iwconfig
 
enp2s0f0  no wireless extensions.
wlp3s0    IEEE 802.11bgn  ESSID:"NETGEAR97"
          Mode:Managed  Frequency:2.427 GHz  Access Point: 2C:B0:5D:9C:72:BF
          Bit Rate=65 Mb/s   Tx-Power=16 dBm
          Retry  long limit:7   RTS thr:off   Fragment thr:off
          Power Management:on
          Link Quality=61/70  Signal level=-49 dBm
          Rx invalid nwid:0  Rx invalid crypt:0  Rx invalid frag:0
          Tx excessive retries:0  Invalid misc:430   Missed beacon:0
lo        no wireless extensions.

En este ejemplo, ni enp2s0f0 ni el dispositivo loopback tienen extensiones inalámbricas, lo que significa que enp2s0f0 es nuestra interfaz Ethernet.

También necesitas conocer estas configuraciones:

  • Dirección IP estática.
  • Máscara de subred.
  • Dirección IP de la puerta de enlace.
  • Direcciones IP de los servidores de nombres (DNS).
  • Nombre de dominio (a menos que esté en una LAN local, en cuyo caso puede recuperarlo).

Active la interfaz Ethernet conectada (por ejemplo, enp2s0f0):

# ip link set enp2s0f0 up

Agregue la dirección:

# ip addr add ip_address/subnetmask dev interface_name

Por ejemplo:

# ip addr add 192.168.1.2/24 dev enp2s0f0

Para obtener más opciones, ejecute man ip.

Agregue su puerta de enlace de esta manera, sustituyendo la dirección IP de su propia puerta de enlace:

# ip route add default via ip_address

Por ejemplo:

# ip route add default via 192.168.1.1

Edite resolv.conf, sustituyendo las direcciones IP de sus servidores de nombres y su nombre de dominio local:

# nano /etc/resolv.conf
 
nameserver 61.23.173.5
nameserver 61.95.849.8
search example.com
Actualmente, puede incluir un máximo de tres líneas de servidor de nombres. Para superar esta limitación, puede usar un servidor de nombres de almacenamiento en caché local como Dnsmasq.

Ahora debería tener una conexión de red de trabajo. Si no lo hace, vea la página Network Configuration.

Inalámbrico

Siga este procedimiento si necesita conectividad inalámbrica (Wi-Fi) durante el proceso de instalación.

Primero, identifique el nombre de su interfaz inalámbrica.

# iw dev
 
phy#0
        Interface wlp3s0
                ifindex 3
                wdev 0x1
                addr 00:21:6a:5e:52:bc
                type managed

En este ejemplo, wlp3s0 es la interfaz inalámbrica disponible. Si no está seguro, es probable que su interfaz inalámbrica comience con la letra “w” y que no sea “lo” o que comience con la letra “e”.

Si no ve una salida similar a esta, entonces su controlador inalámbrico no se ha cargado. Consulte Wireless Setup para obtener información más detallada.

Trae la interfaz con:

# ip link set wlp3s0 up
Si recibe este mensaje de error:
SIOCSIFFLAGS: No such file or directory

Entonces, su conjunto de chips inalámbricos podría necesitar un firmware no libre para funcionar. Esto no es compatible con Hyperbola. Consulte Instalación inalámbrica si no está seguro de que esto sea cierto para su conjunto de chips en particular.

A continuación, utilice iw dev wlp3s0 scan | grep SSID para buscar redes disponibles, luego conectarse a una red con:

# wpa_supplicant -B -i wlp3s0 -c <(wpa_passphrase "ssid" "psk")

Debe reemplazar ssid con el nombre de su red (por ejemplo, “Linksys, etc…”) y psk con su contraseña inalámbrica, dejando las comillas alrededor del nombre y la contraseña de la red.

Finalmente, debes darle a tu interfaz una dirección IP. Esto se puede configurar manualmente o usando el dhcp:

# dhcpcd wlp3s0

Si eso no funciona, ejecute los siguientes comandos:

# echo 'ctrl_interface=DIR=/run/wpa_supplicant' > /etc/wpa_supplicant.conf
# wpa_passphrase <ssid> <passphrase> >> /etc/wpa_supplicant.conf
# ip link set <interface> up # Puede que no sea necesario, ya que dhcpcd debería mostrarlo, pero puede ser necesario para wpa_supplicant.
# wpa_supplicant -B -D nl80211 -c /foobar.conf -i <interface name>
# dhcpcd -A <interface name>

ADSL with PPPoE/PPPoA

Follow this procedure if you need ADSL with PPPoE/PPPoA during the installation process.

First, identify the name of your Ethernet interface.

# 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

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:

# ln -s /etc/init.d/net.lo /etc/init.d/net.ppp0
# ln -s /etc/init.d/net.lo /etc/init.d/net.enp2s0f0
Be sure to set rc_depend_strict to YES in /etc/rc.conf.

Now we need to configure /etc/conf.d/net.

# 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_need_ppp0="net.enp2s0f0"
It is also possible to set the password in /etc/ppp/pap-secrets.
Please carefully read the section on ADSL and PPP in /usr/share/doc/netifrc-*/net.example.bz2. It contains many more detailed explanations of all the settings any particular PPP setup will likely need.

Now that the interface is configured, we can start it using the following commands:

rc-service net.ppp0 start

Behind a proxy server

If you are behind a proxy server, you will need to export the http_proxy and ftp_proxy environment variables. See Proxy settings for more information.

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.

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 above for internet setup instructions.

To check that your computer has the correct time, enter date in the terminal.

# date

If the date is incorrect, you will need to manually set the correct time.

# 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:

# date 111318442013.32

Once the date is correct, we need to initialize the gnupg directory and update pacman's keys.

# pacman-key --init
# mount -o remount,size=100M,noatime /etc/pacman.d/gnupg
# pacman-key --populate hyperbola arch
# pacman-key --refresh-keys

If you get GPG errors updating those packages, you can try running these commands to start over:

# rm -r /etc/pacman.d/gnupg/*
# pacman-key --init
# pacman-key --populate hyperbola arch
# pacman-key --refresh-keys

If you get an error related to dirmngr, you can get rid of it with:

# mkdir /root/.gnupg && chmod go-rx /root/.gnupg && touch /root/.gnupg/dirmngr_ldapservers.conf

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 /etc/pacman.d/mirrorlist such that your preferred mirror is first. This copy of the mirrorlist will be installed on your new system by pacstrap as well, so it's worth getting it right.

Install the base system using pacstrap:

# pacstrap /mnt

You can install additional packages passing base and the names of these packages as arguments after the root directory of the new installation (all packages from the base group are installed if no package is specified).

If you have a btrfs root, you probably want to install also btrfs-progs.

If you face GPG errors when running:
# pacstrap /mnt

Then, you can try to fix them with:

# rm -r /etc/pacman.d/gnupg/*
# pacman-key --init
# pacman-key --populate hyperbola arch
# pacman-key --refresh-keys

Install and configure a bootloader

GRUB

  • For BIOS and EFI:
# pacstrap /mnt grub

See GRUB for further details.

Syslinux

# pacstrap /mnt syslinux

See Syslinux for further details.

Install wireless tools

If your wireless network is WPA protected, you'll need wpa_supplicant to connect to it:

# pacstrap /mnt wpa_supplicant

Configure the system

Generate a fstab with the following command (if you prefer to use UUIDs or labels, add the -U or -L option, respectively):

# genfstab -p /mnt >> /mnt/etc/fstab

Next we chroot into our newly installed system:

# arch-chroot /mnt
  • Write your hostname to /etc/hostname
# echo myhostname > /etc/hostname
  • Symlink /etc/localtime to /usr/share/zoneinfo/Zone/SubZone. Replace Zone and Subzone to your liking. For example:
# ln -s /usr/share/zoneinfo/Europe/Athens /etc/localtime
  • Set locale preferences in /etc/locale.conf
  • Add console keymap and font preferences in /etc/conf.d/keymaps
  • Uncomment the selected locale in /etc/locale.gen and generate it with locale-gen
  • Set a root password with passwd
  • Add your user to the relevant group such as:
# gpasswd -a YourActualUserName video
  • Configure /etc/mkinitcpio.conf as needed (see mkinitcpio) and create an initial RAM disk with:
# mkinitcpio -p linux-libre-lts
linux-libre-lts is our default kernel since we are a long-term support distro.
  • 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 /sys/firmware/efi exist, then it booted in (U)EFI mode)
    • The efivars module is loaded. (modprobe efivars will load it)
  • To configure the bootloader, you have to install it and generate the file grub.cfg:
# grub-install /dev/sdX
If you want to 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:
grub-install --no-bootsector /dev/sdX
# grub-mkconfig -o /boot/grub/grub.cfg
If you are following the libreboot encrypted installation instructions, be sure to save a 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.

Configure speech support (for blind and visually impaired users)

If you are using HyperTalking and need start speech support when you boot the system, you will need to do:

# rc-update add espeakup default
  • Save the state of the sound card, so that it will be retrieved on reboot:
# alsactl store

Unmount and reboot

If you are still in the chroot environment type exit or press Ctrl+D in order to exit. Earlier we mounted the partitions under /mnt. In this step we will unmount them:

# umount /mnt/{boot,home,}

Now reboot and then login into the new system with the root account.

Configure pacman

Edit /etc/pacman.conf and configure pacman's options, also enabling the repositories you need.

See Pacman and Repositories for details.

Update the system

At this point you should update your system.

See Upgrading packages for instructions.

Add an user

Finally, add a normal user as described in User management.

Service management

Since Hyperbola removed entire systemd support, we suggest you read about OpenRC which is our main default init system.

Conclusion

Your new Hyperbola GNU/Linux-libre base system is now a functional GNU/Linux environment.

Acknowledgement

This wiki article is based on ArchWiki, GentooWiki and ParabolaWiki. We may have removed non-FSDG bits from it.