IBM Support

KCIIN0198E TEPS fails to start

Technote (troubleshooting)


Attempts to start the TEPS fails with the error:
/opt/IBM/ITM/{interp-type}/cq/bin/KfwServices: error while loading shared libraries: cannot open shared object file: No such file or directory


LD_LIBRARY_PATH in the $CANDLEHOME/config/cq.config file does not included the PATH to the missing library.

Diagnosing the problem

Confirm the location of the missing library.

Confirm the LD_LIBRARY_PATH defined in $CANDLEHOME/config/cq.config file does not include the path to the missing library.

Resolving the problem

Do not edit the LD_LIBRARY_PATH in the cq.config file. The contents of this file will be overwritten during the TEPS restart.

Locate the $CANDLEHOME/config/.ConfigData/kcqenv file.

Within the kcqenv file, confirm the setting for the variable KFW_EWAS_HOME. Focus on line that begins with the operating system architecture.


# grep KFW_EWAS_HOME /opt/IBM/ITM/config/.ConfigData/kcqenv

grep KFW_EWAS_HOME /opt/IBM/ITM/config/.ConfigData/kcqenv

When the KFW_EWAS_HOME setting is not set, the LD_LIBRARY_PATH within the $CANDLEHOME/config/cq.ini file will not be able to locate all libraries.

Reconfigure the TEPS in order to rebuild the $CANDLEHOME/config/.ConfigData/kcqenv file.

> Store a backup copy of the $CANDLEHOME/config/.ConfigData/kcqenv file in a filesystem other than $CANDLEHOME

Reconfigure the TEPS

> itmcmd config -A cq

Document information

More support for: Tivoli Components
ITM Tivoli Enterprise Portal V6

Software version: 6.2.2, 6.2.3, 6.3

Operating system(s): AIX, Linux

Reference #: 1597261

Modified date: 24 August 2015

Translate this page: