on Jun 16, 2016Article Content
| Article Number | 000020693 |
| Applies To | RSA 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 |
| Issue | How to enable debugging for RSA ClearTrust backend services on Microsoft Windows |
| Resolution | The 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 ID | a18246 |