IBM Support

ClearQuest Web server process fails to start with an unsatisfied link error

Troubleshooting


Problem

This technote explains how to resolve an unsatisfied link error. This can occur when starting IBM® Rational® ClearQuest® Web server processes.

Symptom

Attempting to login to the ClearQuest Web produces a blank page. On the server, you can check the stderr file in the directory:
<install directory>/rational/clearquest/cqweb/cqserver/logs and found requestmgr-7.

Full text of the log is as follows:

Exception in thread "main" java.lang.UnsatisfiedLinkError: Can't find library cqjniproxy  (libcqjniproxy.so) in sun.boot.library.path or java.library.path
sun.boot.library.path=/opt/rational/common/IBMJava2-142/jre/bin
java.library.path=/opt/rational/common/IBMJava2-142/jre/bin:/opt/rational
/common/IBMJava2-142/jre/bin/classic:/opt/rational/common/IBMJava2-142
/jre/bin:/usr/lib
at java.lang.ClassLoader.loadLibrary(ClassLoader.java:2047)
at java.lang.Runtime.loadLibrary0(Runtime.java:824)
at java.lang.System.loadLibrary(System.java:908)
at com.rational.clearquest.cqweb.requestmgr.RmRequestMgr.<init>(Unknown Source)
at com.rational.clearquest.cqweb.requestmgr.RmInitialization.main(Unknown Source)

Cause


Cause on Linux or UNIX platform server
The LD_LIBRARY_PATH environment variable is not set.

Cause on Windows platform server
PATH environment variable values referencing ClearQuest paths are invalid. This can happen after an upgrade of ClearQuest, or if you have installed Oracle software.

Resolving The Problem

Resolving the problem on Linux or UNIX platforms

To run Rational ClearQuest Server and the Rational ClearQuest Web Application components, you must set the LD_LIBRARY_PATH parameter as documented in the ClearQuest Information Center.


After the server restarts you should be able to access the ClearQuest Web server and be prompted with a login screen as expected.

Resolving the problem on Windows platforms

Check the system PATH environment variable.

Follow these steps:

  1. Go to Control Panel > System, and click the Advanced tab.
  2. Click the Environment Variable button.
  3. Under System Variables select PATH.
  4. Verify that all Rational paths are correct, separated by a semicolon (;), and are located at the beginning of the variable.

Note: The server may need to be rebooted for System variable changes to take effect.

[{"Product":{"code":"SSSH5A","label":"Rational ClearQuest"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Web Java Server","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.0;7.0.0.1;7.0.0.2;7.0.0.3;7.0.0.4;7.0.0.5;7.0.0.6;7.0.1;7.0.1.1;7.0.1.2;7.0.1.3;7.0.1.4;7.0.1.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
16 June 2018

UID

swg21239017

Page Feedback