Troubleshooting slow RPE Launcher/Studio start


Update 2015.02.03: another cause for a slow Launcher/Studio start is an invalid RPE WebService URL.  Check your ini files to determine if the -Dcom.ibm.rational.rpews.url is set and verify the URL is correct and accessible.

If RPE Launcher/Studio take more than a few seconds to start it is possible that your license configuration is sub-optimal. A slow license check-in will also impact document generation via the Java API or remote services. In extreme situations this can make RPE appear to hang or take minutes to start.

Symptoms: RPE Launcher/Studio splash screen shows up but there is no progress indicator or progress messages for a few seconds.

How to confirm this is indeed a license issue: start RRPE Launcher in publish wizard mode. In this mode RPE Launcher does not immediately consume a license. The command line to use is:

“%RPE_HOME%\launcher\rpe-launcher.exe” -publish “path to dsx”

If Launcher starts very fast this way than the license setup is indeed an issue.

Cause: the license environment variable, TELELOGIC_LICENSE_FILE, contains a large number of entries. Typically some of those entries will be invalid and some will point to license servers that have RPE licenses.

How to fix: trim the environment variable such that it contains only servers that are valid. If more than one server is present put one with RPE licenses towards the start of the list ( first is best). Once you do that there are a few more steps you need to take:

IMPORTANT these steps involve editing the Windows registry. Make sure that appropriate backups are performed prior to performing these steps. Failure to do so may result in unrecoverable system instability and data loss.

1. Delete all occurrences of the TELELOGIC_LICENSE_FILE registry values, look up them up in the following locations:
HKEY_CURRENT_USER\Software\FLEXlm License Manager\TELELOGIC_LICENSE_FILE
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\FLEXlm License Manager\TELELOGIC_LICENSE_FILE
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment\TELELOGIC_LICENSE_FILE

2. Other registry locations may be created by the operating system, depending on visualization settings or caching. Search for TELELOGIC_LICENSE_FILE in the Windows registry and delete any other occurrences as well.

3. (optional but recommended) restart the machine

4. Start RPE Launcher/Studio and verify if the start time is improved

Advertisements

Author: Dragos Cojocari

Architect for Rational Publishing Engine

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s