Prerequisite Libraries required by eHealth installation on Linux

Products

• CA eHealth

Issue/Introduction

Red Hat Enterprise Linux (RHEL) 6.x and 7.x do not come with all possible system libraries preinstalled as many are not needed by the software being run. However, eHealth requires several 32-bit and 64-bit libraries to be installed prior to its own installation. This article describes what's needed.

When attempting to install eHealth 6.3.3.x on a new build of RHEL 6.x or 7.x, it fails at the install stage with errors similar to:
 

FAIL -- Required utility uudecode was not found in /usr/bin.
FAIL -- Required utility lsb_release was not found in /usr/bin.
FAIL -- The 32-bit RPM package of libaio is not installed
...
etc.

These errors list out the prerequisite libraries that are missing from the system.

 

Environment

eHealth 6.3.3.x
Red Hat Enterprise Linux 7.x

Resolution

To identify problems with regards to prerequisites on Linux, run the nhCheckInstallPreReqs utility, located under the directory where the eHealth install media was extracted to. So:

1. cd $EHEALTH_INSTALL_MEDIA_DIR/eHealth
2. Run ./nhCheckInstallPreReqs

This will list out all the missing libraries (along with any other potential problems such as kernel parameters). You can isolate and list just the problems by running;

./nhCheckInstallPreReqs | grep FAIL

If there are any missing libraries, then they will be listed, similar to the following example;

FAIL ++ The 32-bit RPM package of libaio is not installed
FAIL ++ The 32-bit RPM package of libaio-devel is not installed
FAIL ++ The 64-bit RPM package of libaio-devel is not installed
FAIL ++ Error RPM libaio-devel not installed
 

Any packages listed representing prerequisite system libraries required by eHealth will then need to be installed by the Linux System Administrators of the machine. As an example, using the above, a search using the Linux Yum package manager can be executed to find the corresponding package and then it can be installed;

yum whatprovides libaio

This may return the following packages (depending on version and repository that the particular machine is subscribed to):
 

libaio-0.3.109-13.el7.i686 : Linux-native asynchronous I/O access library
Repo        : rhel-7-server-rpms

libaio-0.3.109-13.el7.x86_64 : Linux-native asynchronous I/O access library
Repo        : rhel-7-server-rpms
 

In the above example, libaio is missing the 32-bit package, so the install process would be:

yum install libaio-0.3.109-13.el7.i686

Additional Information

The list of Libraries required by eHealth 6.3.3.x on Linux includes the following:

NOTE: for some of these packages, you will need to enable the RHEL optional and/or extras channels.
 

64-bit RPM package of ksh
32-bit RPM package of libaio
32-bit RPM package of libaio-devel
64-bit RPM package of libaio-devel
32-bit RPM package of unixODBC
64-bit RPM package of unixODBC
32-bit RPM package of unixODBC-devel
64-bit RPM package of unixODBC-devel
32-bit RPM package of glibc-devel
32-bit RPM package of motif
32-bit RPM package of libstdc++
32-bit RPM package of libXrender
32-bit RPM package of openssl098e
32-bit RPM package of compat-libstdc++-33
64-bit RPM package of compat-libstdc++-33
32-bit RPM package of fontconfig
32-bit RPM package of libjpeg-turbo
32-bit RPM package of libsepol
2-bit RPM package of cyrus-sasl-lib
32-bit RPM package of libgcc
libgcc minimum requirement of 4.8.20-10
32-bit RPM package of keyutils-libs
32-bit RPM package of libuuid
32-bit RPM package of libXp
32-bit RPM package of libICE
32-bit RPM package of libXau
32-bit RPM package of libselinux
32-bit RPM package of freetype
32-bit RPM package of libXdmcp
32-bit RPM package of libXmu
32-bit RPM package of krb5-libs
32-bit RPM package of compat-db47
32-bit RPM package of libXext
32-bit RPM package of libSM
32-bit RPM package of zlib
32-bit RPM package of libcom_err
32-bit RPM package of libpng
32-bit RPM package of libpng12
32-bit RPM package of libXt
32-bit RPM package of gd
32-bit RPM package of libXi
32-bit RPM package of libxcb

Related information:
eHealth installation fails on Linux, stating invalid TZ