000024536 - Enable ClearTrust backend service debugging on Windows or UNIX

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 Number000024536
Applies ToRSA ClearTrust 4.6.1
RSA ClearTrust 4.6.1.1
Microsoft Windows
UNIX (AIX, HP-UX, Solaris)
All UNIX platforms
IssueEnable ClearTrust backend service debugging on Windows or UNIX
ResolutionOn Windows:
1.  Edit the dispatch.bat, auth0x.bat, eserver.bat files; add the "-DDEBUG" parameter to the command line just before the "-DCT_ROOT" section.
eg:

C:\Securant\jre\bin\java -classpath %CLASSPATH% -Xnoclassgc -Xms4M -Xmx64M -DDEBUG -DCT_ROOT=C:\Securant\SecCtrl\ct_root sirrus.entitlements.db.dbkona.Bootstrap

2.  Now launch each .bat file manually in a command prompt, and the debug output will appear in the command window.  
Note:  You can also redirect the output to a file using the "> filename" after the .bat command

On UNIX:

1.   Insert "-DDEBUG=true" flags into the secctrl_server script just after the "java" command.  This file is located in /$CTROOT/securecontrol/scripts/secctrl_server directory:
eg:

         'dataserver')
              echo "Starting the ClearTrust/SecureControl
Entitlements Server"

              if [ $2 ] ; then
                   java -DDEBUG=true -DESrvr -DCT_ROOT=$CT_ROOT
-Xms16m -Xmx64m sirrus.entitlements.db.dbkona.Bootstrap > $2 2>&1 &
              else
                   java -DDEBUG=true -DESrvr -DCT_ROOT=$CT_ROOT
-Xms16m -Xmx64m sirrus.entitlements.db.dbkona.Bootstrap &
              fi
              ;;

         'authorizer')

              if [ $2 ] ; then
                   echo "Starting a ClearTrust/SecureControl
Authorization Server on port " $2
                   if [ $4 ] ; then
                        java -DDEBUG=true -DAuth
-DCT_ROOT=$CT_ROOT -DLISTEN_PORT=$2 -DVOYAGER_PORT=$3 -Xms64m -Xmx64m
sirrus.entitlements.auth.AuthorizationServer > $4 2>&1 &
                   else
                        java -DDEBUG=true -DAuth
-DCT_ROOT=$CT_ROOT -DLISTEN_PORT=$2 -DVOYAGER_PORT=$3 -Xms64m -Xmx64m
sirrus.entitlements.auth.AuthorizationServer &
                   fi
              else
                   echo "You must specify a pair of port
numbers to run a ClearTrust/SecureControl Authorization Server"
              fi
              ;;

         'dispatcher')
              echo "Starting a ClearTrust/SecureControl Server
Dispatcher "
              if [ $2 ] ; then
                   java -DDEBUG=true -DDisp -DCT_ROOT=$CT_ROOT
-Xmx16m sirrus.entitlements.auth.dispatch.AuthorizationDispatcher > $2 &
              else
                   java -DDEBUG=true -DDisp -DCT_ROOT=$CT_ROOT
-Xmx16m sirrus.entitlements.auth.dispatch.AuthorizationDispatcher &
              fi
              ;;

2.   Turn debug=true in Default.conf
3.   Change the log level to 40 in the Default.conf
4.   Restart all of the CT components individually in their own window so you can see what is happening

    For the entitlement server
         ./secctrl_server dataserver

    For the dispatcher
         ./secctrl_server dispatcher

    For the first authorization server
         ./secctrl_server authorizer 5615 5616

    For the second authorization server
         ./secctrl_server authorizer 5617 5618
Legacy Article IDa6915

Attachments

    Outcomes