The IP addresses of the VMs on which NAICE is deployed must be configured statically.

To deploy the VM, it is required to install a set of packages available in the official repositories of the operating system in use.

A local mirror of the official repository, deployed within an isolated network and accessible from the target machine, can be used to install these packages via a package manager such as APT (Ubuntu, Astra Linux) or YUM (RedOS).

Install the docker.io and docker-compose packages according to the official instructions: https://docs.docker.com/engine/install/ubuntu/

sudo apt-get update && \
sudo apt-get install ca-certificates curl && \
sudo install -m 0755 -d /etc/apt/keyrings && \
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc && \
sudo chmod a+r /etc/apt/keyrings/docker.asc && \
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null && \
sudo apt-get update && \
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y

$ sudo docker --version
Docker version 29.2.1, build a5c7197

$ sudo docker compose version
Docker Compose version v5.1.0

Install packages and all required dependencies from the official Ubuntu repository corresponding to the OS version in use:

Deploying NAICE on 2 VMs:

sudo apt install python3-psycopg2 python3-apt keepalived logrotate -y

Deploying NAICE on 4 VMs:

VMs hosting the PostgreSQL cluster:

sudo apt install python3-psycopg2 python3-apt -y

VMs hosting the NAICE cluster:

sudo apt install python3-psycopg2 python3-apt keepalived logrotate -y

Install packages from the official Astra Linux repository:

sudo apt install docker.io python3-apt python3-psycopg2 python3-requests -y

The Docker Compose plugin cannot be installed from the Astra Linux repository, as it contains an outdated version. It must be downloaded from the following link to the target host: https://cloud.eltex-co.ru/index.php/s/yKlAcy83VVPEfzx.

Example download using wget:

wget https://cloud.eltex-co.ru/index.php/s/yKlAcy83VVPEfzx/download -O docker-compose-linux-x86_64

On the target host, create a directory:

sudo mkdir -pv /usr/local/lib/docker/cli-plugins

Place the downloaded file download into this directory and rename it to docker-compose:

sudo mv -v docker-compose-linux-x86_64 /usr/local/lib/docker/cli-plugins/docker-compose

Change the file owner to root:

sudo chown root:root -v /usr/local/lib/docker/cli-plugins/docker-compose

Make the file executable:

sudo chmod 755 -v /usr/local/lib/docker/cli-plugins/docker-compose

$ sudo docker --version
Docker version 28.3.3.astra1, build

$ sudo docker compose version
Docker Compose version v2.2.3

sudo apt install docker.io python3-apt python3-psycopg2 python3-requests -y && \
wget https://cloud.eltex-co.ru/index.php/s/yKlAcy83VVPEfzx/download -O docker-compose-linux-x86_64 && \
sudo mkdir -pv /usr/local/lib/docker/cli-plugins && \
sudo mv -v docker-compose-linux-x86_64 /usr/local/lib/docker/cli-plugins/docker-compose && \
sudo chown root:root -v /usr/local/lib/docker/cli-plugins/docker-compose && \
sudo chmod 755 -v /usr/local/lib/docker/cli-plugins/docker-compose && \
sudo docker --version && \
sudo docker compose version

Install packages required for deploying NAICE services on the virtual machines:

sudo apt install keepalived logrotate -y

Install the required packages along with all dependencies from the official Astra Linux repository on all hosts that will be used for the installation:

sudo apt install docker.io docker-compose-v2 python3-apt python3-psycopg2 python3-requests -y

$ sudo docker --version
Docker version 28.3.3.astra1, build

$ sudo docker compose version
Docker Compose version 2.39.2.astra1

Install packages required for deploying NAICE services on the virtual machines:

sudo apt install keepalived logrotate -y

Install Docker and Docker Compose packages from the official RedOS repository:

sudo yum install docker-ce docker-compose python3-psycopg2 python3-requests -y

$ sudo docker --version
Docker version 28.1.1, build 4eba377

$ sudo docker compose version
Docker Compose version 5.0.2

Install packages required for deploying NAICE services on the virtual machines:

sudo yum install keepalived logrotate -y

To run Ansible playbooks, use a VM running Ubuntu 24, RedOS 8.0.2, or Astra Linux 1.8.6.

If Astra Linux 1.7.X is used as the target OS for NAICE deployment, ensure that the Ansible version is not higher than 2.17:

$ ansible --version

Installation is not supported on newer Ansible versions, as Astra Linux 1.7.X uses Python 3.7, which is not supported.

If necessary, reinstall Ansible and downgrade to the required version.

ansible-galaxy collection list | grep community.docker

If necessary, the file can be downloaded to any PC with Internet access to the website https://cloud.eltex-co.ru (using the link above) and then transferred to the target host using any available SCP client into the home directory of the user who will perform the installation.

wget https://cloud.eltex-co.ru/index.php/s/9Hv6p4yz611fDXb/download -O community-docker-4.7.0.tar.gz

$ ansible-galaxy collection install community-docker-4.7.0.tar.gz

$ ansible-galaxy collection list | grep community.docker
community.docker                         4.7.0  <--- Latest version
community.docker                         X.X.X  <--- Previous version

If necessary, the file can be downloaded to any PC with Internet access to the website https://cloud.eltex-co.ru (using the link above) and then transferred to the target host using any available SCP client into the home directory of the user who will perform the installation.

wget https://cloud.eltex-co.ru/index.php/s/iWhUOSdtaIYGnim/download -O naice_install_2026-04-17.tar.gz

tar xzvf naice_install_2026-04-17.tar.gz
cd naice_install/ansible

---
# Local actions
all:
  hosts:
    localhost:
      ansible_connection: local
      ansible_user: <username of the host user running the playbook>
      ansible_ssh_pass: <password of the host user running the playbook>
      ansible_become_password: <sudo password of the host user running the playbook>

# Host group for high-availability NAICE deployment
reservation:
  hosts:
    master_host:
      ansible_host: <IP address of host 1 for NAICE>
      ansible_port: 22
      ansible_user: <username>
      ansible_ssh_pass: <user password>
      ansible_become_password: <sudo password>
      keepalived_interface: <interface name on which the VIP address will be configured, e.g. eth0>

    backup_host:
      ansible_host: <IP address of host 2 for NAICE>
      ansible_port: 22
      ansible_user: <username>
      ansible_ssh_pass: <user password>
      ansible_become_password: <sudo password>
      keepalived_interface: <interface name on which the VIP address will be configured, e.g. eth0>
  vars:
    keepalived_vip: <VIP address without mask, e.g. 192.168.0.11>

# Host group for postgres-cluster deployment (primary + standby)
postgres-cluster:
  hosts:
    node_primary:
      ansible_host: <IP address of the host for PostgreSQL node-1>
      ansible_port: 22
      ansible_user: <username>
      ansible_ssh_pass: <user password>
      ansible_become_password: <sudo password>
      forwarded_postgresql_port: 5432
      forwarded_ssh_port: 15432
    node_standby:
      ansible_host: <IP address of the host for PostgreSQL node-2>
      ansible_port: 22
      ansible_user: <username>
      ansible_ssh_pass: <user password>
      ansible_become_password: <sudo password>
      forwarded_postgresql_port: 5432
      forwarded_ssh_port: 15432

When deploying NAICE on two hosts, the target installation host IP addresses are the same for master_host and node_primary, as well as backup_host and node_standby.

ansible-playbook install-postgres-cluster.yml -i inventory/hosts-cluster.yml

PLAY RECAP **********************************************************************************************************************************************************************************************************************************
node_primary               : ok=61   changed=22   unreachable=0    failed=0    skipped=26   rescued=0    ignored=0   
node_standby               : ok=45   changed=22   unreachable=0    failed=0    skipped=17   rescued=0    ignored=0   

Before starting the installation, make sure that the Primary role belongs to the PostgreSQL node specified in the variable node_primary “ansible_host”. If necessary, perform a Primary role switch. If this requirement is not met, the installation cannot be completed.

ansible-playbook reservation-naice-services.yml -i inventory/hosts-cluster.yml

PLAY RECAP **********************************************************************************************************************************************************************************************************************************
backup_host                : ok=82   changed=26   unreachable=0    failed=0    skipped=32   rescued=0    ignored=0   
master_host                : ok=88   changed=32   unreachable=0    failed=0    skipped=45   rescued=0    ignored=0