Articles in this section

How do I install ENA for Linux?

Avatar
Stuart Hill
  • Updated
Follow

System requirements

1. Linux packages that are required for ENA

Important note regarding move to OpenJDK11 in ENA v17.0 P06
Checking if a package is installed
To install missing required packages
To install Linux 8 packages that use the dnf command
rpcbind Service

2. Maximum number of processes per non-root user

3. Preparing for installation

4. Installing ENA

5. Auto starting/stopping ENA as part of a Linux server startup/shutdown procedure

6. Checking Linux firewall configurations

 

This covers a fresh installation and configuration of ENA for Linux.

If you want to know how to upgrade an installation, please take the Installation and Upgrade course on our training site or contact our support team.

Entuity recommends creating and maintaining your own documentation and notes of the specifics your installation, so that future users might better understand it in future. These details will also help if you need to discuss problems with the Entuity Support team.

 

Important: Please review the list of Known Issues before starting installation.

 

System requirements

ENA is only certified for use with the 64-bit English edition variants of:

ENA v17.0:

  • Red Hat Enterprise Linux ES version 6.
  • Red Hat Enterprise Linux ES version 7.
  • Oracle Linux 6.
  • Oracle Linux 7.

ENA v18.0:

  • Red Hat Enterprise Linux ES version 7.
  • Red Hat Enterprise Linux ES version 8.
  • Oracle Linux 7.
  • Oracle Linux 8.
  • CentOS 8

 

1. Linux packages that are required for ENA:

When installing ENA to Red Hat Linux 6 or Oracle Linux 6, a particular set of 64-bit packages must already be installed. These are as follows:

  • alsa-lib.x86_64
  • fontconfig
  • glibc.x86_64
  • libaio.x86_64
  • libgcc.x86_64
  • libgcrypt.x86_64
  • libgpg-error.x86_64
  • libICE.x86_64
  • libpcap.x86_64 (required for ENA v18.0)
  • libSM.x86_64
  • libstdc++.x86_64
  • libuuid.x86_64
  • libX11.x86_64
  • libXau.x86_64
  • libxcb.x86_64
  • libXext.x86_64
  • libXi.x86_64
  • libxml2.x86_64
  • libxslt.x86_64
  • libXtst.x86_64
  • libXt.x86_64
  • ncurses-libs.x86_64
  • nss-softokn-freebl.x86_64
  • rpcbind.x86_64
  • zlib.x86_64

Additional libraries are required on Red Hat Linux 8 or Oracle Linux 8 (for ENA v18.0):

  • compat-openssl10.x86_64
  • openssl-libs.x86_64
  • libnsl.x86_64
  • ncurses-compat-libs.x86_64

When running any of the BMC integrations shipped with ENA, there are four additional 32-bit packages that are required:

  • compat-libstdc++-33.i686
  • glibc.i686
  • nss-softokn-freebl.i686
  • libgcc.i686

Important note regarding move to OpenJDK11 in ENA v17.0 P06:

Following ENA v17.0 P06, the move to OpenJDK11 has unbundled fonts and instead relies on OS-provided fonts. OpenJDK11 recommends installing the native OS package, which can be done with ‘yum install fontconfig’ on rpm-based systems. This is a requirement for running ENA on Linux, otherwise reports will not work.

 

Checking if a package is installed:

From the server command line, you can use the RPM Package Manager (RPM). For example, to check if the rpcbind.x86_64 package is installed, enter:

rpm -q rpcbind.x86_64

  • If the package is not installed, RPM returns:

    rpcbind.x86_64 is not installed

  • If the package is installed, RPM returns full details of the package, e.g.:

    rpcbind-0.2.0-9.e16.x86_64

You can also check all packages through one instruction, an example of which is displayed below. This example does not include the packages required for the BMC integrations. This example can be copied and pasted to the command line as it includes the multi-line indicator \.

for i in alsa-lib.x86_64 fontconfig glibc.x86_64 libaio.x86_64 libgcc.x86_64 \
libgcrypt.x86_64 libgpg-error.x86_64 libICE.x86_64 libSM.x86_64 \
libstdc++.x86_64 libuuid.x86_64 libX11.x86_64 libXau.x86_64 \
libxcb.x86_64 libXext.x86_64 libXi.x86_64 libxml2.x86_64 \
libxslt.x86_64 libXtst.x86_64 libXt.x86_64 ncurses-libs.x86_64 \
nss-softokn-freebl.x86_64 rpcbind.x86_64 zlib.x86_64; \
do rpm -q $i ;done

 

To install missing required packages:

You must install any missing packages to the server before installing ENA. We recommend you consult the Linux documentation before installing the missing required packages.

Red Hat Linux users must register their system with Red Hat Network to receive updates.

Oracle Linux users can obtain the required packages from Oracle Public Yum Server. You can use the command line package utility Yellowdog Updater, Modified (YUM) to install missing packages. You can install all packages through one instruction, an example of which is displayed below. This example does not include the packages required for the BMC integrations. This example can be copied and pasted to the command line as it includes the multi-line indicator \.

yum install alsa-lib.x86_64 fontconfig glibc.x86_64 libaio.x86_64 libgcc.x86_64 \
libgcrypt.x86_64 libgpg-error.x86_64 libICE.x86_64 libSM.x86_64 \
libstdc++.x86_64 libuuid.x86_64 libX11.x86_64 libXau.x86_64 \
libxcb.x86_64 libXext.x86_64 libXi.x86_64 libxml2.x86_64 \
libxslt.x86_64 libXtst.x86_64 libXt.x86_64 ncurses-libs.x86_64 \
nss-softokn-freebl.x86_64 rpcbind.x86_64 zlib.x86_64

 

To install Linux 8 packages that use the dnf command:

Please find below an example of how to install Linux 8 packages that support the new dnf command, and include the new packages.

The first check is to check if the packages are installed, using rpm -qa in Linux 8.

for i in alsa-lib.x86_64 fontconfig glibc.x86_64 libaio.x86_64 libgcc.x86_64 \
libgcrypt.x86_64 libgpg-error.x86_64 libICE.x86_64 libSM.x86_64 \
libstdc++.x86_64 libuuid.x86_64 libX11.x86_64 libXau.x86_64 \
libxcb.x86_64 libXext.x86_64 libXi.x86_64 libxml2.x86_64 \
libxslt.x86_64 libXtst.x86_64 libXt.x86_64 ncurses-libs.x86_64 \
nss-softokn-freebl.x86_64 rpcbind.x86_64 zlib.x86_64 \
compat-openssl10.x86_64 openssl-libs.x86_64 libnsl.x86_64 ncurses-compat-libs.x86_64; \
do rpm -q $i ;done

The second checks for additional packages in Linux 8.

dnf install alsa-lib.x86_64 fontconfig glibc.x86_64 libaio.x86_64 libgcc.x86_64 \
libgcrypt.x86_64 libgpg-error.x86_64 libICE.x86_64 libSM.x86_64 \
libstdc++.x86_64 libuuid.x86_64 libX11.x86_64 libXau.x86_64 \
libxcb.x86_64 libXext.x86_64 libXi.x86_64 libxml2.x86_64 \
libxslt.x86_64 libXtst.x86_64 libXt.x86_64 ncurses-libs.x86_64 \
nss-softokn-freebl.x86_64 rpcbind.x86_64 zlib.x86_64 \
compat-openssl10.x86_64 openssl-libs.x86_64 libnsl.x86_64 ncurses-compat-libs.x86_64

 

rpcbind Service:

The rpcbind package is the Linux RPC port mapper. ENA uses the portmap (rpc.portmap, portmap or rpcbind) service to obtain unused ports for its internal communications, e.g. licensing functions cannot run without access to available ports, and therefore ENA cannot run.

After installing the rpcbind package, you should check that the rpcbind service is running. By default, rpcbind only starts when the server boots up.

  1. To check if rpcbind is running, enter:

    service rpcbind status

    • When the service is not running, Linux returns:

      rpcbind is stopped

    • When the service is running, Linux returns:

      rpcbind (pid nnn) is running ...

  2. To start rpcbind, enter:

    service rpcbind start

  3. We recommend you ensure that rpcbind starts every time the server starts, by entering:

    chkconfig rpcbind on

 

2. Maximum number of processes per non-root user

You can run ENA using a non-root user account. However, Red Hat Linux 6, Oracle Linux 6 and RHEL 7.x default the maximum number of processes per non-root user to 1024. ENA requires a higher limit - we recommend a value of 4096.

To check the current value of maximum user processes, from the server command line enter:

ulimit -a

To set the maximum number of processes per non-root user:

  1. From /etc/security/limits.d/90-nproc.conf, or /etc/security/limits.d/20-nproc.conf, amend the soft nproc value to 4096:

    * soft nproc 4096

  2. Restart the Linux server to apply the change.
  3. From the server command line, run ulimit to check that the value of max user processes is now set to 4096.

 

3. Preparing for installation:

  1. For direct customers, Entuity uses a secure FTP server to distribute its network analytics software. The Entuity FTP server is located here: ftp.entuity.com. Access to the Entuity FTP site requires a valid username and password that can be obtained from Entuity Support. For added security, the FTP site requires connection via SFTP. BMC customers obtain ENA via BMC EPD (Electronic Product Distribution).
  2. You need a valid account to access the server:
    • If you have purchased the software, please contact Entuity Support and they will be able to provide you the necessary details.
    • If you are trialing ENA software, please contact your Sales Engineer and they will be able to help you.
  3. Open the ftppub folder, and then open the /Images/18.0 folder (/Images/17.0 for ENA v17.0). This folder includes the Windows version, Linux version, and the checksum file. The Linux version is entuity_18_0_red.iso.gz (entuity_17_0_p1_red.iso.gz for ENA v17.0). Download the ENA image (which contains ENA v17.0 and patch P01 together), which is a compressed file.

 

4. Installing ENA:

Please find below instructions on how to install ENA, with the commands required at each step. Note that the commands in [square brackets] are not fixed - the user will need to create their own input.

  1. Navigate to the compressed image

    • cd /[folder path]

  2. Decompress the image

    • zcat ./entuity_18_0_red.iso.gz > /tmp/Entuity.iso

  3. Create mount point

    • mkdir /mnt/EntuityInstaller

  4. Mount image

    • mount -o loop /tmp/Entuity.iso /mnt/EntuityInstaller

  5. Run installer

    • /mnt/EntuityInstaller/install

  6. Accept the terms and conditions with yes or y.
  7. Specify an install directory by entering the path. Note, it is important to use an absolute path, because relative paths will break Entuity. This means that every path must start at the root, starting with /.
  8. Run configure

    • /[install path]/install/configure

  9. On Linux, configure runs from the command line, and so responses need to be typed out. Absolute paths need to be provided where applicable. For more help and information, please see How do I configure ENA from the command line?
  10. Start Entuity

    • /[install path]/bin/starteye

 

5. Auto starting/stopping ENA as part of a Linux server startup/shutdown procedure:

  1. On Linux, ENA does not automatically register a service with the operating system. Therefore, users desiring an automatic startup on Linux will need to copy the following to a new file called "entuity" that should be created within /etc/init.d/ on their server:

    #!/bin/bash
    #
    # chkconfig: 345 92 35
    # description: Starts and Stops Entuity service
    #
    ### BEGIN INIT INFO
    # Provides: eye
    # Default-Start: 3 4 5
    # Default-Stop: 0 1 2 6
    ### END INIT INFO

    entuity_home="/Entuity"

    # Waits up to 2 hours
    graceTime=7200
    # Checks every 10 seconds
    sleepInterval=10


    # Source function library.
    . /etc/init.d/functions


    [ -d $entuity_home/bin ] || exit 0

    RETVAL=0

    umask 077

    start() {

    exec 4>&1
    exec >/dev/null
    if status starteye
    then exit 0

    else
    exec >&4
    echo -n $"Starting up Entuity: "

    fi
    daemon $entuity_home/bin/starteye
    RETVAL=$?
    echo
    [ $RETVAL -eq 0 ] && touch /var/lock/subsys/entuity
    return $RETVAL


    }

    stop() {

    status starteye || exit 0
    $entuity_home/bin/stopeye
    elapsedTime=0
    RETVAL=0
    status starteye && RETVAL=1
    while [ $RETVAL -eq 1 ] && [ $elapsedTime -lt $graceTime ];do
    sleep $sleepInterval
    if status starteye
    then RETVAL=1

    else
    RETVAL=0
    break

    fi
    let elapsedTime=elapsedTime+$sleepInterval

    done
    echo
    if [ $RETVAL -eq 0 ]
    then rm -f /var/lock/subsys/eye
    else echo "Gave up waiting for Entuity to stop"
    fi
    return $RETVAL


    }

    restart() {

    stop
    start


    }

    case "$1" in
    start)
    start
    ;;
    stop)
    stop
    ;;
    restart|reload)
    restart
    ;;
    status)
    status starteye
    ;;
    *)
    echo $"Usage: $0 {start|stop|restart|status}"
    exit 1
    esac

    exit $?

  2. If ENA has been installed to a directory other than /Entuity, you must edit the above by changing the line entuity_home="/Entuity" to match where you have installed the software.
  3. ENA can then be controlled using service start | stop | restart | status.
  4. To configure the service to automatically start with the operating system startup, enter the following:
    • On Red Hat 6:
      chkconfig --add entuity
      chkconfig entuity on
    • On Red Hat 7:
      systemctl enable entuity

 

6. Checking Linux firewall configurations:

Netfilter can have a default configuration to block inbound traffic to the standard webserver ports.

  1. To check existing firewall rules:

    iptables -L

  2. If inbound webtraffic is blocked, you need to enable it:

    iptables -A INPUT -p tcp --dport 80 -j ACCEPT

  3. Or, if TLS is enabled:

    iptables -A INPUT -p tcp --dport 443 -j ACCEPT

Related articles

Comments

0 comments

Please sign in to leave a comment.