IBM Support

Report generation fails with error "Unable to access license factory" in Rational Publishing Engine

Troubleshooting


Problem

Attempts to generate a report with a remote engine fails with error "Unable to access license factory" in IBM Rational Publishing Engine (RPE)

Symptom

Report generation will start but will then fail with errors similar to the following:

CRRPE1034I Processing document template 1 of 1.
Unsigned template found. This document generation will consume a RPE
license.
Unable to access license factory.
CRRPE1034I Aborting engine execution...
CRRPE1024E Document generation failed

In French:



[RRDG_1:21-CORE] CRRPE3010E La licence n'a pas pu être vérifiée.
Impossible d'accéder à la fabrique de licences.
com.ibm.rational.rpe.common.utils.RPEException: Impossible d'accéder à la fabrique de licences.
at com.ibm.rational.rpe.engine.core.RPEEngine$RPELicenseImpl.checkLicense(RPEEngine.java:77)
at com.ibm.rational.rpe.engine.core.RPEEngine$RPELicenseImpl.checkLicense(RPEEngine.java:165)
at com.ibm.rational.rpe.engine.core.RPEEngine.checkoutLicense(RPEEngine.java:229)
at com.ibm.rational.rpe.engine.core.RPEEngine.beginDocgen(RPEEngine.java:289)
at com.ibm.rational.rpe.engine.RRDGEngine.run(RRDGEngine.java:1064)
at java.lang.Thread.run(Thread.java:798)
Caused by: com.ibm.rcl.telelogic.LicenseConfigurationException: java.lang.UnsatisfiedLinkError: rcl_telelogic (Not found in java.library.path)
null
at com.ibm.rcl.telelogic.FLEXLicenseControl.LoadLicenseLibrary(Unknown Source)
at com.ibm.rcl.telelogic.FLEXLicenseControl.<init>(Unknown Source)
at com.ibm.rcl.telelogic.LicenseControlFactory.getLicenseControl(Unknown Source)
at com.ibm.rational.rpe.engine.core.RPEEngine$RPELicenseImpl.checkLicense(RPEEngine.java:72)
... 5 more
[RRDG_1:21-CORE] CRRPE3010E La licence n'a pas pu être vérifiée.
Impossible d'accéder à la fabrique de licences.

Cause

The error indicates that the startup cannot find the tl_lic.dll library. There are a number or reasons why this might happen.

Environment

This has been seen on a Windows client.

Resolving The Problem

There could be a number or reasons for this error:

  1. License file is not in the path:
    Ensure that the file 'tl_lic.dll' is in your PATH so that the Java loader can locate it. The RPE installer adds the folder '%RPE_HOME%\lib' to the %PATH% environment variable. If you use the RPE API on machines without RPE installed, you will need to ensure this library is accessible to your custom Java application.

  2. Using 64-bit JAVA
    RPE is verified to run on 64-bit operating systems but it still requires 32-bit Java. Ensure you are using the 32-bit java installed with RPE

  3. Installation problems.
    RPE co-exists with a number of different Rational products. We have seen that when these are installed under the same paths then this issue is resolved.

[{"Product":{"code":"SS6RHZ","label":"Rational Publishing Engine"},"Business Unit":{"code":"BU005","label":"IoT"},"Component":"General Information","Platform":[{"code":"PF033","label":"Windows"}],"Version":"1.0;1.1;1.1.1;1.1.2","Edition":""}]

Document Information

Modified date:
16 June 2018

UID

swg21666059