Linux Platform Prerequisites

3 minute read

This section describes the Cluster Manager, eMake, and Electric Agent/EFS installation prerequisites on Linux platforms. It also describes a known Linux kernel performance issue.

For information about platform support such as operating systems, cloud-based and Kubernetes support, Make versions, eMake emulation, databases, bitnesses, and Visual Studio versions, see CloudBees Accelerator Supported Platforms.

Supported kernel versions

CloudBees Accelerator supports these specific Linux kernel versions.

CentOS 7.5-1804, kernel 3.10.0-862

CentoS 7.4-1708, kernel 3.10.0-693

Debian 9, kernel 4.9 series

Debian 8, kernel 3.16 series

Debian 7, kernel 3.2 series

RHEL 8.0, kernel 4.18.0-80

RHEL 7.7, kernel 3.10.0-1062

RHEL 7.6, kernel 3.10.0-957

RHEL 7.5, kernel 3.10.0-862

RHEL 7.4, kernel 3.10.0-693

RHEL 7.3, kernel 3.10.0-514

RHEL 7.2, kernel 3.10.0-327

RHEL 7.1, kernel 3.10.0-229

RHEL 7.0, kernel 3.10.0-123

RHEL 6.10, kernel 2.6.32-754

RHEL 6.9, kernel 2.6.32-696

RHEL 6.8, kernel 2.6.32-642

RHEL 6.7, kernel 2.6.32-573

RHEL 6.6, kernel 2.6.32-504

RHEL 6.5, kernel 2.6.32.431

RHEL 6.4, kernel 2.6.32.358

RHEL 6.3, kernel 2.6.32.279

RHEL 6.2, kernel 2.6.32.220

RHEL 6.1, kernel 2.6.32.131

RHEL 6.0, kernel 2.6.32.71

RHEL 5.5+, kernel 2.6.18-x

RHEL 5.4, kernel 2.6.18-164

SLES 15, kernel 4.12.14

SLES 12 SP4, kernel 4.12.14

SLES 12, kernel 3.12.28

SLES 11 SP2, kernel 3.0.10

SLES 11 SP1, kernel 2.6.32

SLES 11, kernel 2.6.27

Ubuntu 18.04, kernel 4.18

Ubuntu 18.04, kernel 4.15

Ubuntu 17.10, kernel 4.13

Ubuntu 17.04, kernel 4.10

Ubuntu 16.10, kernel 4.8

Ubuntu 16.04, kernel 4.4

Ubuntu 15.10, kernel 4.2

Ubuntu 15.04, kernel 3.19

Ubuntu 14.10, kernel 3.16

Ubuntu 14.04, kernel 3.13

Linux Prerequisites

  • Each host to run Accelerator software must be x86-64 compatible.

  • SELinux must be disabled. To disable SELinux, open /etc/selinux/config and change SELINUX=enforcing to SELINUX=disabled.

  • The following packages must be installed on each host that will run the Cluster Manager or agents.

    The installer prompts you to install missing prerequisite libraries. If installation of these libraries fails, the installer displays the command that you must enter to install them afterward.

    For your reference, following are the commands that you can use to install the required packages:

    Platform Commands for Installing Required Packages

    CentOS or RHEL

    Cluster Manager machine:

    sudo yum install sudo yum install libnsl (RHEL 8.0 and newer)

    Agent machines:

    sudo yum install autoconf sudo yum install kernel-devel-$(uname -r) sudo yum install gcc make -y sudo yum install elfutils-libelf-devel (RHEL 8.0 and newer)

    Debian or Ubuntu

    Cluster Manager machine:

    None.

    Agent machines:

    sudo apt-get update sudo apt-get install autoconf sudo apt-get install linux-headers-$(uname -r) sudo apt-get install gcc make

    SUSE Linux Enterprise Server (SLES) 12

    Cluster Manager machine:

    None.

    Agent machines:

    sudo zypper update sudo zypper install autoconf sudo zypper install kernel-source sudo zypper install gcc make

    SLES 15

    Cluster Manager machine:

    None.

    Agent machines:

    sudo zypper update sudo zypper install autoconf sudo zypper install kernel-devel sudo zypper install gcc make

Known Linux kernel issue affecting performance

Affected kernel versions

This applies to RHEL kernel versions later than 2.6.18-194.32 and earlier than 2.6.32-131.

Symptoms

Affected systems might encounter reduced performance on both ext3 and ext4 file systems. Symptoms might include:

  • hung_task_timeout_secs messages in system dmesg logs

  • widely variable agent availability (entering and exiting agent “penalty” status frequently)

  • contention over the ecagent.state file

  • slower builds (with unexplained variances)

To help determine if your environment has this kernel issue, run

dmesg | grep hung_task_timeout

hung_task_timeout errors indicate a known Linux kernel issue. Contact your kernel provider to obtain a different version of the precompiled kernel.

Corrective actions

For systems running RHEL 5.6, 5.7, 5.8, and 6.0, consider upgrading to 2.6.32-131 (RHEL 6.1) or downgrading to 2.6.18-194.32 (RHEL 5.5).

Upgrading the kernel might require you to reinstall various kernel modules such as video drivers, efs, and vm-tools. You can do so by running apt-get dist-upgrade and then rebooting.