Solutions

How do I enable BCAAA debug logging?

Solutions ID:    KB2934
Version:    6.0
Status:    Published
Published date:    06/12/2009
Updated:    06/26/2012
 

Problem Description

How do I enable BCAAA debug logging?
How do I export BCAAA debug logs to a file?
My support engineers needs a debug log.
How do I turn on a BCAAA debug log?

How do I enable BCCA (Blue Coat Cloud Auth) debug logging?

Resolution

Please only enable BCAAA debug logging when asked to do so by Blue Coat Technical Support.  The debug log should only run long enough to collect data for the problem that is occurring.  Then the debug log should be turned off.  On your Windows server, please do the following steps:

  1. Go to the %ProgramFiles%\Blue Coat Systems\BCAAA\ directory

The installation folder depends on what you chose during the installation process. Please refer to KB4996 for further details.

  1. Open/Edit the BCAAA.ini file in that directory.
  2. Go to the bottom of the BCAAA.ini file and add the following lines:

[Debug]
DebugLevel=0xFFFFFFFF

  1. Save your changes.
  2. Click on Start > Run > and type in "services.msc".  The Windows Services will open up.
  3. Look for the BCAAA entry.  Double click on it.  Click on Stop and then Start.
  4. Duplicate the issue.
  5. Remove the debug entries in the BCAAA.ini file that were added in step 3 above.
  6. Collect the bcaaa.log file and any other bcaaa-NNNN.log files from the Windows server.  The bcaaa.log file and bcaaa-NNNN.log files are located in the %ProgramFiles%\BCAAA directory.
  7. Repeat steps 5 and 6 above (stop and start BCAAA).
  8. Zip up the BCAAA debug log.
  9. Go to https://upload.bluecoat.com/ and upload your debug log to the service request that you have open.  Please enter your name, recepient's email (generally this is the email address of the technical support engineer (TSE) that you are working with), your service request (SR) number (usually 2-SomeLongNumber), and the file itself.  Click on the "Upload File to Support" button and wait for the upload to complete.

NOTE:  The BCAAA service will be unavailable each time the BCAAA service is stopped and started.  This interruption in service may disrupt authentication during the time the BCAAA service is unavailable.  Please plan accordingly.  If the ProxySG is configured for multiple BCAAA servers, the end user interruption may not occur.

For WINDOWS SSO debugging, please do the following:

  1. Go to the %ProgramFiles%\Blue Coat Systems\BCAAA\ directory

The installation folder depends on what you chose during the installation process. Please refer to KB4996 for further details.

  1. Open/Edit the SSO.INI file in that directory.
  2. In the [DCQSetup] section, add the following line:

DCQDebug=1

  1. Save your changes.
  2. Click on Start > Run > and type in "services.msc".  The Windows Services will open.
  3. Look for the BCAAA entry.  Double click on it.  Click on Stop and then Start buttons.
  4. Duplicate the issue.
  5. Remove the debug entry in the SSO.INI file that was added in step 3 above.
  6. Collect the debug_dcq_primary_full.sso and debug_dcq_primary_inc.sso files from the Windows server.  The debug_deq_primary_*.sso files are located in the %ProgramFiles%\Blue Coat Systems\BCAAA directory.
  7. Repeat steps 5 and 6 above (stop and start BCAAA).
  8. Zip up the SSO debug files.
  9. Go to https://upload.bluecoat.com/ and upload your debug log to the service request that you have open.  Please enter your name, recepient's email (generally this is the email address of the technical support engineer (TSE) that you are working with), your service request (SR) number (usually 2-SomeLongNumber), and the file itself.  Click on the "Upload File to Support" button and wait for the upload to complete.

For Novell SSL debugging, please do the following:

    1.To the sso.ini file, add the following text :

    [NovellSetup]
    NovellDebug=1

    2. This will create the following two files, with clear text username and IP addresses.

    debug_novell_primary_full.sso
    debug_novell_primary_inc.sso


Rate this Page

Please take a moment to complete this form to help us better serve you.

Did this document help answer your question?
 
 
If you are finished providing feedback, please click the RATE CONTENT button. Otherwise, please add more detail in the following text box and then click RATE CONTENT.
 
 

Your response will be used to improve our document content.

Ask a Question