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.

Tip: If you cannot install the library, check that you have a supported version of your Linux flavor.
Linux Flavor Command
  • 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
Note: 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

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.

How to create symlinks
RHEL8 symlink:sudo ln /usr/lib64/libtinfo.so.6.1 /usr/lib64/libtinfo.so.5sudo 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.5sudo ln /usr/lib64/libncurses.so.6.1 /usr/lib64/libncurses.so.5

How to install ncurses-compat-libs
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
Fedora Install 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:

    How to install libncurses5
    sudo apt-get install libncurses5

  • If you choose libncurses6:

    How to install libncurses6
    sudo apt-get install libncurses6

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

    How to create symlinks

    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
Debian Use 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:

      How to install libncurses5
      sudo zypper install libncurses5

    • If you choose libncurses6:

      How to install libncurses6
      sudo zypper install libncurses6

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

      How to create symlinks

      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.
Click here to expand the steps to do so:
For openSUSE Tumbleweed run the following as root:
CODE 
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:
CODE 
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:
CODE 
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:
CODE 
zypper addrepo https://download.opensuse.org/repositories/home:amshinde/openSUSE_13.1/home:amshinde.repo
zypper refresh
zypper install tzdata
CODE 
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.
CODE 
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.

Chromium Requirement

The Reports service requires Chrome or Chromium. Follow the install steps on your Report server according to your operating system's requirements.

Operating System Command
Ubuntu
CODE 
sudo apt update && sudo apt install -y chromium-browser
Debian
CODE 
sudo apt update && sudo apt install -y chromium
RHEL, CentOS, Rocky, and Alma
CODE 
sudo dnf install -y epel-release && sudo dnf install -y chromium
Fedora
CODE 
sudo yum install -y epel-release && sudo yum install -y chromium

Verify the Installation

Run the following command to verify whether Chrome or Chromium is installed on Report server:

CODE 
chromium --version
Or
CODE 
chromium-browser --version
Platform Default Executable Path
Ubuntu /usr/bin/chromium-browser

Chromium Path Errors

If the Reports Service cannot start, check the logs. You will see one of the following errors:
  • FATAL ERROR: Chromium executable path is not configured
  • Chromium executable not found at configured path: /path/to/chromium
  • FATAL: Service cannot start - Chromium validation failed. Please fix the Chromium configuration and restart the service.
  1. Run the following command:
    CODE 
    which chromium || which chromium-browser

  2. Edit config/user-config.json and add the executable path:

    JSON 
    {
  "chromium": {
    "executablePath": "/usr/bin/chromium"
  }
}
    Alternatively, you can set the PUPPETEER_EXECUTABLE_PATH environment variable to the chromium binary path.
    CODE 
    export PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium-browser

EPEL Repository Issues

Run the following command to troubleshoot the EPEL repository issues:
RHEL/CentOS 9
CODE 
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
RHEL/CentOS 8
CODE 
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

Nodejs Requirements

The Reports Service requires Node.js 22 LTS >= 22.21.1. Follow the install steps on your Report server according to your operating system's requirements:
Operating System Command
Ubuntu and Debian
CODE 
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo DEBIAN_FRONTEND=noninteractive apt install -y nodejs
RHEL, CentOS, Rocky, and Alma
CODE 
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs
RHEL and CentOS 7 (Legacy)
CODE 
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo yum install -y nodejs
Fedora
CODE 
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs

Verify the Installation

Run the following command to verify whether Nodejs is installed on Report server:
CODE 
node --version