Required Libraries

Linux systems must include these libraries for Enterprise Console operation:

  • libaio
  • numactl package, which includes libnuma.so.1 for RHEL, CentOS, and Fedora, and libnuma1 for Ubuntu and Debian

  • glibc2.12

    Note: This glibc version is included into a given operating system release, and therefore cannot be updated.

  • tzdata for RHEL, CentOS, Fedora, openSUSE Leap 15.5, and Ubuntu version 20.x and higher

    Note: The tzdata package is also required by the MySQL connector.

  • libncurses5 (and above) for Ubuntu, CentOS, Debian, openSUSE Leap 15.5

    Warning: As of MySQL 5.5.57 and 5.7.19, libtinfo.so.5 is a required prerequisite library.

  • ncurses-libs-5.x for RHEL and CentOS

    Warning: As of MySQL 5.5.57 and 5.7.19, libtinfo.so.5 is a required prerequisite library.
  • SLES12 and SLES15 using libxml2-2 and libxml2-tools

This table provides instructions on how to install the libraries on some common flavors of the Linux operating system.

Note: If you cannot install the library, check that you have a supported version of your Linux flavor.
Linux FlavorCommand
  • Red Hat
  • CentOS
  • CentOS Stream
  • Amazon

Use yum to install the library, such as:

  • yum install libaio
  • yum install numactl
  • yum install tzdata
  • yum install ncurses-libs-5.x
Warning: Ensure that only one package mgr for rpm and is installed before running the Enterprise Console installer.
Note:

For RHEL8, CentOS8 you can either manually install version 5 of ncurses or use version 6.

  • To install version 5, follow these steps:
  1. sudo rpm -ivh --force ncurses-base-5.x.rpm
  2. sudo rpm -ivh --force ncurses-libs-5.x.rpm
Warning:

The ncurses-libs depends on the ncurses-base so you must install the ncurses-base first. These are examples of a trusted source for rpm download:

  • To install version 6, follow these steps:

You must either create symlinks for ncurses-libs-5 which points to ncurses-libs-6, or install the ncurses-compat-libs package, to provide ABI version 5 compatibility.

RHEL8 symlink:
sudo ln /usr/lib64/libtinfo.so.6.1 /usr/lib64/libtinfo.so.5
sudo ln /usr/lib64/libncurses.so.6.1 /usr/lib64/libncurses.so.5

CentOS8 symlink:
sudo ln /usr/lib64/libtinfo.so.6.1 /usr/lib64/libtinfo.so.5
sudo ln /usr/lib64/libncurses.so.6.1 /usr/lib64/libncurses.so.5
RHEL8 compat-libs:
sudo yum install -y ncurses-compat-libs
CentOS8 compat-libs:

sudo yum install -y ncurses-compat-libs

Use the following prerequisites to install on CentOS Stream:

  • sudo yum install -y libaio.x86_64
  • sudo yum install -y numactl.x86_64
  • sudo yum install -y tzdata
  • sudo yum install -y ncurses-compat-libs.x86_64
FedoraInstall the library RPM from the Fedora website:
  • yum install libaio
  • yum install numactl
  • yum install tzdata
Ubuntu

Use apt-get, such as:

  • sudo apt-get install libaio1
  • sudo apt-get install numactl
  • sudo apt-get install tzdata
  • sudo apt-get install libncurses5
Warning: Ensure that only one package mgr between dpkg and rpm is installed before running the Enterprise Console installer. This pkg manager utility will be used to verify mandatory pkgs before the Enterprise Console installation.
Note:

For Ubuntu20 you can install libncurses5 or libncurses6.

  • If you choose libncurses5:

    sudo apt-get install libncurses5

  • If you choose libncurses6:

    sudo apt-get install libncurses6

    Note: For libncurses6 you need to create symlink for libncurses5 pointing to libncurses6.

    sudo ln -s /usr/lib/x86_64-linux-gnu/libncurses.so.6.2 /usr/lib/x86_64-linux-gnu/libncurses.so.5 sudo ln -s /usr/lib/x86_64-linux-gnu/libtinfo.so.6.2 /usr/lib/x86_64-linux-gnu/libtinfo.so.5
DebianUse a package manager (such as APT) to install the library (as previously described in the Ubuntu instructions).
openSUSE Leap 15.5

Use zypper to install the library, such as:

  • sudo zypper install libaio
  • sudo zypper install libnuma1

  • sudo zypper install tzdata

  • sudo zypper install libncurses5

    Note:

    For openSUE Leap 15.5, you can install libncurses5 or libncurses6.

    • If you choose libncurses5:

      sudo zypper install libncurses5

    • If you choose libncurses6:

      sudo zypper install libncurses6

      Note: For libncurses6 you need to create symlink for libncurses5 pointing to libncurses6.

      sudo ln /lib64/libncurses.so.6.1 /lib64/libncurses.so.5 sudo ln -s /lib64/libtinfo.so.6.1 /lib64/libtinfo.so.5ncurses-compat-libs
Warning: Ensure that only one package mgr for rpm and is installed before running the Enterprise Console installer. Also, you need to add the openSUSE machine repository before installing the tzdata package.
For openSUSE Tumbleweed run the following as root:
zypper addrepo https://download.opensuse.org/repositories/home:amshinde/openSUSE_Tumbleweed/home:amshinde.repo
zypper refresh
zypper install tzdata
For openSUSE Leap 42.1 run the following as root:
zypper addrepo https://download.opensuse.org/repositories/home:amshinde/openSUSE_Leap_42.1/home:amshinde.repo
zypper refresh
zypper install tzdata
For openSUSE 13.2 run the following as root:
zypper addrepo https://download.opensuse.org/repositories/home:amshinde/openSUSE_13.2/home:amshinde.repo
zypper refresh
zypper install tzdata
For openSUSE 13.1 run the following as root:
zypper addrepo https://download.opensuse.org/repositories/home:amshinde/openSUSE_13.1/home:amshinde.repo
zypper refresh
zypper install tzdata
You may run into file conflicts when two packages attempt to install files with the same name but different contents. If you choose to continue, the old files and their contents will be replaced.
See the openSUSE website (https://software.opensuse.org/download.html?project=home%3Aamshinde&package=tzdata) to manually download and install the tzdata package.
SLES12 and SLES15

Use zypper to install the library, such as:

  • sudo zypper install libxml2-2
  • sudo zypper install libxml2-tools
  • sudo zypper install libaio1
  • sudo zypper install numactl
  • sudo zypper install libcurses5
  • sudo zypper install tzdata
See Platform Requirements for operating system support information.