If a getrandom error occurs during installation

Some versions of the operating system (OS) kernel do not have the ability to execute a getrandom system call. This leads to an error when installing the platform.

To install the platform on such a server, update the OS kernel and, if necessary, install the rng-tools utility set.

Diagnostics

Connect to the server via SSH and run the command:

docker logs dci_auth_back4_1

If the installation error is due to the getrandom system call, the response will contain a line he following form:

libc++abi: terminating with uncaught exception of type boost::wrapexcept<boost::uuids::entropy_error>: getrandom

Solution

1. Connect to the server via SSH.
2. Update the OS kernel to at least kernel-3.10.0-544.el7.

3. Check the entropy level of the system:

   cat /proc/sys/kernel/random/entropy_avail

4. If the entropy level is below 200:

   1. Install rng-tools:

      AlmaLinux

      yum install rng-tools

      Ubuntu

      apt install rng-tools

   2.  If CentOS is installed on the server, change the line in the /systemd/system/multi-user.target.wants/rngd.service file as shown below:

      ExecStart=/sbin/rngd -f

      replace by

      ExecStart=/sbin/rngd -f -r /dev/urandom

   3. Restart the service

      AlmaLinux

      systemctl daemon-reload && systemctl start rngd

      Ubuntu

      systemctl daemon-reload && systemctl start rng-tools

   4. Сheck the entropy level of the system again:

      cat /proc/sys/kernel/random/entropy_avail

      In case of successful installation, the level value must be above 200.