Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel6
include
outlinetrue
indent
stylenone
exclude
typelist
class
printabletrue

Introduction

Esta es una guía muy resumida de los pasos necesarios para instalar Rocky Linux. Al realizarla hemos partido de la ISO This is a very brief guide which provides the necessary steps to install Rocky Linux or Red Hat. For this guide, the following ISO has been used: Rocky-9.4-x86_64-minimal.iso, es posible que en otras versiones algunos pasos cambien.

...

(some steps may vary in other versions).

This guide is meant for reference purposes only and it does not replace any official documentation, which should always be taken into account.

Note: For Red Hat, you must have a valid subscription in order to download the required packages. You must register your subscription before running any dnf or yum commands.

Steps to install

...

Descargar la ISO de la web oficial de Rocky, cargarla en su sistema de virtualización y arrancar.

Al arrancar se muestra un asistente gráfico, configurar los siguientes apartados:

...

Idioma y Zona horaria

...

Layout del teclado

...

the operating system

  1. Download the ISO from the official Rocky website. Then upload it to your virtualization system, and boot it up.

  2. Upon booting, a graphical setup wizard is displayed. Configure at least the following sections:

    1. Language, Keyboard, and Time Zone.

    2. Installation destination: Automatic partitioning. Enter and click “Done” to select this mode.

    3. Software Selection → Minimal install.

    4. Configuración de red: En el apartado IPv4, seleccionar Static y añadir las IPs necesarias para cada tipo de instalación (master requiere 2 y los nodos 1), configurando Máscara de red y Gateway correspondiente en cada caso. Luego, configurar DNS en el campo correspondiente.

    5. Usuario del sistema y su contraseña
      (info) Recomendación: crear un usuario (p. ej. opengate), con contraseña y con el check de Administrador. No activar ni poner contraseña al usuario root, usaremos sudo con el usuario administrador.

Info

Si no se configura en este momento la red (o no se configura correctamente), tras reiniciar se puede ejecutar el comando sudo nmtui para configurar la conexión de red.

...

    1. Network & Host Name: Enter configuration, IPv4 tab. Choose the “Manual” method, then add IP addresses (the Master requires at least two interfaces when deployed with SIP Registrar, see sample screenshot).

      image-20240927-124529.pngImage Added

    2. Root Password & User Creation.

      1. Recommendation: create a user (e.g., opengate) with a password and check the Administrator option. Do not activate or set a password for the root user; use sudo with the administrator user.

image-20240927-124742.pngImage Added

Info

If the network is not configured at this time (or not configured correctly), you can run the command sudo nmtui after rebooting to set up the network connection.

Once the installation is complete, restart the machine, eject the installation disk, and verify that it boots up and can be connected via SSH (ssh opengate@ip.ip.ip.ip donde opengate es el usuario que se ha configurado durante la instalación, where opengate is the user configured during the installation).

Steps to install Docker

Una vez conectado a la consola del sistema, ejecutar los siguientes comandos:

...

Once connected to the system console, execute the following commands:

  1. If you need to modify the network configuration:

    Code Block
    sudo nmtui
  2. Para deshabilitar el Disable the firewall:

    Code Block
    sudo systemctl disable firewalld
    sudo systemctl stop firewalld
  3. Instalar Install Docker:

    Code Block
    sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
    sudo dnf -y install docker-ce docker-ce-cli containerd.io docker-compose-plugin
    sudo systemctl --now enable docker

    En caso de instalar en RedHat, el repositorio es diferente, ejecutar estos comandosIf installing on Red Hat, the repository is different. Execute these commands:

    Code Block
    sudo dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo
    sudo dnf -y install docker-ce docker-ce-cli containerd.io docker-compose-plugin
    sudo systemctl --now enable docker
  4. Añadir el usuario al grupo “docker” (si no se hace todos los comandos de docker deberán ejecutarse con Add the user to the "docker" group (if this is not done, all Docker commands will need to be executed with sudo):

    Code Block
    sudo usermod -a -G docker $(whoami)

    Tras ejecutar este comando es necesario realizar un logout y volver a conectar para que cargue los permisos. Salir con exit y volver a establecer la conexión ssh.

    Una vez conectado de nuevo, verificar que docker está funcionando con el comando docker info que mostrará una información similar a la siguienteAfter executing this command, it is necessary to log out and reconnect for the permissions to take effect. Logout with exit and then re-establish the SSH connection.

  5. Once reconnected, verify that Docker is running with the command docker info, which will display information similar to the following:

    Code Block
    [opengate@localhost ~]$ docker info
    Client: Docker Engine - Community
     Version:    26.1.3
     Context:    default
     Debug Mode: false
     Plugins:
      buildx: Docker Buildx (Docker Inc.)
        Version:  v0.14.0
        Path:     /usr/libexec/docker/cli-plugins/docker-buildx
      compose: Docker Compose (Docker Inc.)
        Version:  v2.27.0
        Path:     /usr/libexec/docker/cli-plugins/docker-compose
    ...

Other OS level configuration

Email service

En el Master es necesario instalar “postfix” para poder enviar los emails de buzones de voz:

Code Block
sudo dnf install postfix
sudo systemctl --now enable postfix

Status
colourRed
titleTODO
Poner la documentación que tenemos en manuales para configurar relay de correo.

NTP synchronization

...

Multiple IP addresses

If you do not configure them using the install user interface, start the console configuration with sudo nmtui, select the appropriate connection, then use the “Add…” option inside Addresses section to add the new IP.

...

For Azure installations, follow the official documentation https://learn.microsoft.com/en-us/azure/virtual-network/ip-services/virtual-network-multiple-ip-addresses-portal#red-hat-enterprise-linux-and-others

NTP synchronization

By default, it is configured to sync with public servers. If you want to configure it to sync with the machine running OpenGate Proxy Server, edit the file /etc/chrony.conf, remove the public servers, and add the following instead:

Code Block
server ip.ip.ip.ip iburst trust

Siendo Where ip.ip.ip.ip la dirección IP de la máquina de OpenGate Proxy Server, en la que previamente se ha activado el servidor NTP (consultar pinstallgude). is the IP address of the OpenGate Proxy Server machine.

In the OpenGate Proxy Windows machine the NTP Server can be enabled with the following steps:

  1. Disable the Windows NTP client. You must first open the date and time configuration settings, select the Internet Time tab and click on Change settings. Next, uncheck the Synchronize with an Internet time server box, as shown below:

    image-20241002-132559.pngImage Added

  2. Enable the Windows NTP server. You must first create a file named NTPServerEnable.reg with the following:

    Code Block
    Windows Registry Editor Version 5.00
    [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\W32Time\TimeProviders\NtpServer]
    "Enabled"=dword:00000001
    [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\W32Time\Config]
    "AnnounceFlags"=dword:00000005
  3. Run the NTPServerEnable.reg file created and accept the prompt to import the data into the registry. Open a command prompt as administrator and issue the following commands:

    Code Block
    sc config w32time start=auto
    net start w32time

Email service

On the OpenGate Master node, it is necessary to install "postfix" in order to send voicemails:

Code Block
sudo dnf install postfix
sudo systemctl --now enable postfix

Email relay

See Configuring email relay for voicemails