TIBCO ActiveMatrix Adapter for Files (FA) deployed instance fails with the error, 'Could not load module libtibems.so'.

TIBCO ActiveMatrix Adapter for Files (FA) deployed instance fails with the error, 'Could not load module libtibems.so'.

book

Article ID: KB0092515

calendar_today

Updated On:

Products Versions
TIBCO ActiveMatrix BusinessWorks Plug-in for Files for Unix and Windows -
Not Applicable -

Description

Description:
TIBCO ActiveMatrix Adapter for Files (FA) deployed instance fails with the error, 'Could not load module libtibems.so', if it can not find the TIBCO Enterprise Message Service libraries.

Symptoms:
Error 'Could not load module libtibems.so'  can be seen on the console or in the log file. The following is sample stack:

***
***
Environment variables successfully set
Could not load program /tibco/adapter/adfiles/6.2/bin/adfilesagent:
        Dependent module libtibems.so could not be loaded.
Could not load module libtibems.so.
System error: No such file or directory
***


Cause:
TIBCO ActiveMatrix® Adapter for Files is not able to locate the TIBCO Enterprise Message Service libraries at the run time.

Resolution

A).  Install TIBCO Enterprise Message Service Client libraries. 

With TIBCO Runtime Agent 5, 
TIBCO Enterprise Message Service server or client (separate client installer available from EMS(7.x and above) needs to be available on the deployed machine. If you have missed this step before deployment then you will have to use traUpgradeManager. Refer to the following document link.

<tibco-home>\tra\5.9\doc\pdf\tib_TRA_upgrade_5.9.0.pdf> Upgrade Steps > Upgrade Each Primary and Secondary AdministrationServer > Point 5.

B). TIBCO ActiveMatrix Adapter for Files environment script also needs to be updated.

1). Check <TRA-HOME>/domain/<Domain-name>/Application/<FA-ApplicationName>. You will find a startup script. (.sh on UNIX and .bat on Windows).
2). Open the script in an editor. It will also have source commands to set the environments. (For example adfilesagent_env.sh from <adapter home>/bin location).
3). Open adfilesagent_env.sh in an editor and add the EMS path. Define EMS_HOME and include EMS_HOME\lib in the system path(LIBPATH=AIX).
4). Run the startup script from the console.

Issue/Introduction

TIBCO ActiveMatrix Adapter for Files (FA) deployed instance fails with the error, 'Could not load module libtibems.so'.

Additional Information

tibco-home>\tra\5.9\doc\pdf\tib_TRA_upgrade_5.9.0.pdf