IBM Support

Unable to find the required license library - UReleaseServer: Connection to RCL Server FAILED

Troubleshooting


Problem

Attempts to use IBM UrbanCode Release results in the licensing error "FAILED:com.ibm.rcl.ibmratl.LicenseConfigurationException".

Symptom

IBM UrbanCode Release can not connect to the license server, resulting in the following error seen in the ucrelease.log:

UReleaseServer: Contacting RCL Licensing Server...
UReleaseServer: Connecting to: 27000@<host>
=2014-03-27 15:10:33,653 ERROR localhost-startStop-1 com.urbancode.urelease.rcl.RCLManager - Could not connect to License Server. Please see server log for more details. java.lang.UnsatisfiedLinkError: rcl_ibmratl (Not found in java.library.path)
=2014-03-27 15:10:33,653 ERROR localhost-startStop-1 com.urbancode.urelease.UReleaseServer - com.ibm.rcl.ibmratl.LicenseConfigurationException: java.lang.UnsatisfiedLinkError:
rcl_ibmratl (Not found in java.library.path) null

UReleaseServer: Connection to RCL Server FAILED:com.ibm.rcl.ibmratl.LicenseConfigurationException: java.lang.UnsatisfiedLinkError: rcl_ibmratl (Not found in java.library.path) null

Cause

The JAVA_OPT -Djava.library.path points to a wrong path of Rational Common License (RCL) library.(rcl_ibmratl.jar).

Diagnosing The Problem

Steps to narrow down the issue:

  1. Verify that your IBM UrbanCode Release install directory has the required library.

    Go to <release_install_dir>/tomcat/webapps/ROOT/WEB-INF/lib/rcl/<your_system_OS_platform>/<cpu architecture>

  2. Check setenv file to ensure that it has the right path to rcl_ibmratl.jar
    1. Go to <release_install_dir>/tomcat/bin
    2. Open setenv file with a text editor
    3. Ensure that the JAVA_OPTS="$JAVA_OPTS -Djava.library.path= line points to a valid location that has rcl_ibmratl.jar file for your machine's platform.

      Example: (Linux x64)

      JAVA_OPTS="$JAVA_OPTS -Djava.library.path=/opt/IBM/UCRelease/server/tomcat/webapps/ROOT/WEB-INF/lib/rcl/linux/x386_64:$PATH"

Resolving The Problem

If -Djava.library.path points to the wrong location for rcl_ibmratl.jar:

  1. Correct the path
  2. Restart your IBM UrbanCode Release server.

If the issue persists, contact IBM Support.

[{"Product":{"code":"SS4GCC","label":"IBM UrbanCode Release"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Licensing","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"6.0.1;6.0.1.1;6.0.1.2;6.0.1.3;6.0.1.4","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21670245

Page Feedback