000020693 - How to enable debugging for RSA ClearTrust backend services on Microsoft Windows

Document created by RSA Customer Support Employee on Jun 16, 2016Last modified by RSA Customer Support Employee on Apr 21, 2017
Version 2Show Document
  • View in full screen mode

Article Content

Article Number000020693
Applies ToRSA ClearTrust 5.0.1
RSA ClearTrust 5.5.x
RSA ClearTrust Authorization Server (AServer)
RSA ClearTrust Entitlements Server (EServer)
RSA ClearTrust Dispatcher
Microsoft Windows Services
IssueHow to enable debugging for RSA ClearTrust backend services on Microsoft Windows
ResolutionThe RSA ClearTrust AServer (RSAaserver), dispatcher (RSAdispatch), and EServer (RSAeserver) services on Windows can be configured to send debug information to a file. Follow the steps below to do this:

1. Determine which of the processes you would like to debug, e.g.:

 -- AServer -                 authentication and authorization information

 -- dispatcher -         keyserver information and Authorization server list for Web/app clients

 -- EServer -                 ClearTrust administration

2. Click Run from the Start Menu

3. In the Run dialogue box, type "regedit" and click OK

4. Add "-DDEBUG -DDEBUG_FILE=xxxxx" to the services registry entries for each server you wish to debug, where xxxxx is {drive}:full path\filename

NOTE: Please ensure that the drive you select has an adequate amount of free space to store the debug information

Examples:

-- AServer

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\RSAaserver\Parameters\options = -Xmx128m -Xrs -DDEBUG -DDEBUG_FILE=c:\aserver.txt -Djava.ext.dirs=C:\CLEART~1.1_B\lib -DCT_ROOT=C:\CLEART~1.1_B -DLISTEN_PORT=5615

-- dispatcher

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\RSAdispatch\Parameters\options = -Xmx64m  -Xrs -DDEBUG -DDEBUG_FILE=c:\dispatcher.txt -Djava.ext.dirs=C:\PROGRA~1\RSA\CLEART~1.1\lib  -DCT_ROOT=C:\PROGRA~1\RSA\CLEART~1.1

-- EServer

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\RSAeserver\Parameters\options = -Xmx128m -Xrs -DDEBUG -DDEBUG_FILE=c:\eserver.txt -Djava.ext.dirs=C:\PROGRA~1\RSA\CLEART~1.1\lib -DCT_ROOT=C:\PROGRA~1\RSA\CLEART~1.1

5. Restart the services that you wish to debug and run your test

NOTE: Upon completion of your test, please remember to remove the debug parameters from the registry entries and restart the processes to ensure that you do not run out of disk space. Also note that the debug file will be overwritten each time you restart the process.
Legacy Article IDa18246

Attachments

    Outcomes