"Failed to load shared library, library name : JRE_Home/lib/i386/client/libjvm.so" exception when starting TIBCO Administrator or the domain's Hawk Agent.

"Failed to load shared library, library name : JRE_Home/lib/i386/client/libjvm.so" exception when starting TIBCO Administrator or the domain's Hawk Agent.

book

Article ID: KB0085711

calendar_today

Updated On:

Products Versions
TIBCO Administrator -
Not Applicable -

Description

Resolution:
Symptoms:
=========
"Failed to load shared library, library name : &ltJRE_Home>/lib/i386/client/libjvm.so/libjvm.so " exception when starting TIBCO Administrator or the domain's local Hawk Agent. The same applies to any application started with the JVM wrapper, including TIBCO BusinessWorks applications.

Cause
=====

The Failed to load shared library, library name : &ltJRE_Home>/lib/i386/client/libjvm.so is usually symptomatic of mismatched 32-bit and 64-bit binaries. For example, libjvm.so could be 32-bit while tibcoadmin_&ltDomainName> or hawkagent_&ltDomainName> are 64-bit. In Linux with kernel 2.6 or newer, this could be due to access control security policies enforced by the Security-Enhanced Linux (SELinux) feature.

In Solaris, the cause could be the /tibco/tibcosoft/jre/1.5.0/lib/sparc/client directory not being on the trusted directory list defined in the configuration file: by default /var/ld/ld.config (for 32–bit applications) and /var/ld/64/ld.config (for 64-bit applications), or a chosen file defined in LD_CONFIG. With secure applications, the runtime linker restricts searches to only those directories in LD_LIBRARY_PATH which are also trusted.

Solution:
=======

1). Confirm the mismatch by running the command:
      $ file libjvm.so
      $ file &ltTibco_Home>/administrator/domain/&ltdomainName>/bin/tibcoadmin_&ltdomainName>
      $ file &ltTibco_Home>/tra/domain/&ltdomainName>/hawkagent_&ltdomainName>

2). On 32-bit platforms and on 64-bit platforms with 32-bit Tibco software:

a). Confirm that every TIBCO software, and their service packs if any, was installed using 32-bit a installation package. The installation logs under &ltTibco_Home>/log might be useful.

b). If libjvm.so is 32-bit and the tibcoadmin_&ltdomainName> or hawkagent_&ltdomainName> are 64-bit, confirm that wrap is 32-bit then copy it over to these binaries:
         $ file &ltTibco_Home>/tra/5.6/bin/wrap
         $ cp &ltTibco_Home>/tra/5.6/bin/wrap  &ltTibco_Home>/administrator/domain/&ltdomainName>/bin/tibcoadmin_&ltdomainName>
         $ cp &ltTibco_Home>/tra/5.6/bin/wrap  &ltTibco_Home>/tra/domain/&ltdomainName>/hawkagent_&ltdomainName>

c). If libjvm.so is 64-bit, try reinstalling JRE from a 32-bit TRA installation package.

3). On 64-bit platforms with 64-bit Tibco software:

a). Confirm that every TIBCO software, and their service packs if any, was installed using 64-bit a installation package. The installation logs under &ltTibco_Home>/log might be useful.
    
b). If libjvm.so is 64-bit and the tibcoadmin_&ltdomainName> or hawkagent_&ltdomainName> are 32-bit, confirm that wrap64 is indeed 64-bit then copy it over to these binaries:
         $ file &ltTibco_Home>/tra/5.6/bin/wrap64
         $ cp &ltTibco_Home>/tra/5.6/bin/wrap64  &ltTibco_Home>/administrator/domain/&ltdomainName>/bin/tibcoadmin_&ltdomainName>
         $ cp &ltTibco_Home>/tra/5.6/bin/wrap64  &ltTibco_Home>/tra/domain/&ltdomainName>/hawkagent_&ltdomainName>

c). If libjvm.so is 32-bit, try reinstalling JRE from a 64-bit TRA installation package.

4). On Linux, if the binaries are of the same (32-bit or 64-bit) class, disabling SELINUX may solve the issue:
    In /etc/selinux/config, change the following line:
        SELINUX=enforcing
    to:
        SELINUX=disabled

Reboot the system to reset the Linux policies.


5). On Solaris,  if the binaries are of the same (32-bit or 64-bit) class, run the following command:

     $ crle

This will show the currently trusted directories and an example of a command that generates the configuration file. Use this command to add &ltJRE_HOME>/lib/sparc/client directory. Root access is required.

Note: Perform a backup before applying the modifications.

Issue/Introduction

"Failed to load shared library, library name : JRE_Home/lib/i386/client/libjvm.so" exception when starting TIBCO Administrator or the domain's Hawk Agent.