Running the iProcess Engine 11.6.1 installation script (swinstall) more than once can result in system libraries being deleted which can cause core operating system processes to fail

Running the iProcess Engine 11.6.1 installation script (swinstall) more than once can result in system libraries being deleted which can cause core operating system processes to fail

book

Article ID: KB0082441

calendar_today

Updated On:

Products Versions
TIBCO iProcess Engine (Oracle) 11.6.1

Description

If the iProcess Engine 11.6.1 installation script (swinstall) is run more than once it will cause system libraries to be deleted.

The initial processing of the installation script (swinstall) for installation or upgrade creates soft links in the $SWDIR/libs directory to the system libraries:

libplds4.so
libplc4.so
libsoftokn3.so
libnspr4.so
libnss3.so
libssl3.so

Any subsequent running of the installation script (swinstall) will copy all the libraries from the iProcess Engine temporary installation directory to $SWDIR/libs which results in the libraries in the system directory being deleted.

This can result in a number of issues such as:

1. SSH not working
2. Not having the ability to reboot operating system without using rescue mode to recover the deleted libraries with ones from a backup

Issue/Introduction

Running the iProcess Engine 11.6.1 installation script (swinstall) more than once can result in system libraries being deleted which can cause core operating system processes to fail

Environment

TIBCO iProcess Engine (DB2) 11.6.1 TIBCO iProcess Engine (Oracle) 11.6.1 Oracle Solaris 10, 11, 11.3 64-bit on SPARC Red Hat Enterprise Linux Server 6.5, 6.6, 6.7, 6.8, 6.x, 7.0, 7.1, 7.2, 7.3, 7.x 64-bit on x86-64

Resolution

If there is a requirement to run the installation script a second or subsequent time(s) the change detailed below to the swinstall and instutil script should be made prior to running the script.

Both scripts are located in the iProcess Engine temporary installation directory.

Change required to swinstall script:
1. Open the swinstall script in a suitable editor.
2. Locate line 3537,
$ECHO "..\c"
cp -f $DISTDIR/*.$SHLIBEXT "$SWDIR/libs"    >> "$copydistlog" 2>&1
3. Open a line before the cp command and add a function to be called,
DeleteSoftLinkForLdapLibraries
4. Save and exit the file.

Change required to instutil script:
1. Open the instutil script in a suitable editor.
2. Locate line 1169,
CreateSoftLinkForLdapLibraries()
3. Open a line before this and add the DeleteSoftLinkForLdapLibraries function,
DeleteSoftLinkForLdapLibraries()
{
    if [ "$PLATFORM" = "SunOS" -o "$PLATFORM" = "Linux" ] ; then
        if [ -L "$SWDIR/libs/$LIBSSL3" ] ; then
            rm -f $SWDIR/libs/$LIBSSL3
        fi
        if [ -L "$SWDIR/libs/$LIBNSS3" ] ; then
            rm -f $SWDIR/libs/$LIBNSS3
        fi
        if [ -L "$SWDIR/libs/$LIBNSPR4" ] ; then
            rm -f $SWDIR/libs/$LIBNSPR4
        fi
        if [ -L "$SWDIR/libs/$LIBSOFTOKN3" ] ; then
            rm -f $SWDIR/libs/$LIBSOFTOKN3
        fi
        if [ -L "$SWDIR/libs/$LIBPLC4" ] ; then
            rm -f $SWDIR/libs/$LIBPLC4
        fi
        if [ -L "$SWDIR/libs/$LIBPLDS4" ] ; then
            rm -f $SWDIR/libs/$LIBPLDS4
        fi
    fi
}
4. Save and exit the file.

The issue will also be fixed in TIBCO iProcess Engine 11.6.1 Hotfix 002.