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:
- 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>
- Check setenv file to ensure that it has the right path to rcl_ibmratl.jar
- Go to <release_install_dir>/tomcat/bin
- Open setenv file with a text editor
- 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:
- Correct the path
- Restart your IBM UrbanCode Release server.
If the issue persists, contact IBM Support.
Was this topic helpful?
Document Information
Modified date:
17 June 2018
UID
swg21670245