DCImanager 6 Knowledge Base
Do you make friends with the documentation?
Share your opinion and complete a small poll
Take a survey

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.