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

This is a very brief guide with which provides the necessary steps necessary to install Rocky Linux or Red Hat. For this guide, we used the following ISO has been used: Rocky-9.4-x86_64-minimal.iso; (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 For Red Hat, you must have a valid subscription in order to download the required packages. You must register the your subscription before running any dnf or yum commands.

Steps to install

...

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. Network & Host Name: enter 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.png

    5. 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; we will use sudo with the administrator user.

...

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, where opengate is the user configured during the installation).

Steps to install Docker

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

  1. If you need to modify the network configuration:

    Code Block
    sudo nmtui
  2. Disable the firewall:

    Code Block
    sudo systemctl disable firewalld
    sudo systemctl stop firewalld
  3. 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

    If installing on Red Hat, the repository is different; execute . 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. 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)

    After 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

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:

...

  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.png

  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