How to enable and disable debug logging for Backup Exec services.

Article:TECH23853  |  Created: 2003-01-24  |  Updated: 2012-12-13  |  Article URL http://www.symantec.com/docs/TECH23853
Article Type
Technical Solution

Product(s)

Issue



How to enable and disable debug logging for Backup Exec services (BE Job engine and BE remote agent).


Solution



Backup Exec (tm) for Windows Servers contains features to enable debug logging for troubleshooting purposes. There are two ways to enable debugging:
 
  • Using the Services dialog
  • Using the Registry Editor

The following instructions can be used to enable this functionality, creating detailed logs that can be reviewed during the troubleshooting process.

To enable debug logging in Backup Exec 11d, 12.x and 2010:

Using the Services dialog:
 
On Windows 2000, XP, 2003 and 2008:
 
1. Go to Start | Programs | Administrative Tools | Services
 
2. Select the Backup Exec Remote Agent for Windows Servers service, and click Stop. When prompted, click Yes to shut down the service. (On the media server, the Job Engine service will stop as well)
 
3. Select and right-click on the Backup Exec Remote Agent for Windows Servers service, and then select Properties
 
4. In the Startup Parameters box, type -debug. Click Start in the Properties page. Click OK to close (Figure 3).
 
Figure 3
 
 
5. When enabling debug on the media server, select and right-click the Backup Exec Job Engine service, and then select Properties
 
6. In the Startup Parameters box, type -debug. Click Start in the Properties page. Click OK to close (Figure 4).
 
Figure 4
 


Using the Registry Editor:
 
On Windows 2000, XP, 2003 and 2008:
 
 
Warning: Incorrect use of the Windows registry editor may prevent the operating system from functioning properly. Great care should be taken when making changes to a Windows registry. Registry modifications should only be carried-out by persons experienced in the use of the registry editor application. It is recommended that a complete backup of the registry and workstation be made prior to making any registry changes.

 
1. Stop all Backup Exec for Windows Servers services
 
2. Run REGEDIT.EXE
 
3. Browse to HKey_Local_Machine\Software\Symantec\Backup Exec for Windows\Backup Exec\Engine\Logging
 
4. Change the value of CreateDebugLog to 1 to enable debug logging
 
5. Quit the registry editor
 
6. Start the Backup Exec for Windows Servers services



To disable debugging:

Using the Services dialog:
 
On Windows 2000, XP,  2003 and 2008:
 
1. Go to Start | Programs | Administrative Tools | Services
 
2. Select the Backup Exec Remote Agent for Windows Servers service, and click Restart.
 
3. On the media server, start the Backup Exec Job Engine service as well.


Using the registry editor:
 
On Windows 2000, XP, 2003 and 2008:
 
1. Stop all Backup Exec for Windows Servers services.
 
2. Run REGEDIT.EXE
 
3. Backup Exec 11d or above: Browse to HKey_Local_Machine\Software\Symantec\Backup Exec for Windows\Backup Exec\Engine\Logging
 
4. Change the value of CreateDebugLog from 1 to 0 to disable debugging.
 
5. Quit the registry editor.
 
6. Start the Backup Exec for Windows Servers services.

To collect the logs for support:

After the Backup Exec Job Engine and Backup Exec Remote Agent for Windows Servers service are started, two log files will be created in the Backup Exec \Logs directory, which is located in one of the following locations:
 
  • Backup Exec media server:
  •    Directory =  \Program Files\Symantec\Backup Exec\Logs by default.
  •    Filenames = <ServerName>-BENGINExx.Log
  • Backup Exec remote servers:
  •    Directory =  \Program Files\Symantec\Backup Exec\RAWS\Logs by default.
  •    Filename =  <ServerName>-BEREMOTExx.LOG
 
Please provide the logs with the most appropriate modified date and time and the corresponding job log(s) from the Backup Exec console for review.
 
 
Note: Debugging that occurs through the Services applet is temporary and cycling the services or rebooting the machine will stop the debugging. Debugging configured through the Windows Registry allows for continuous debugging. Leaving the services in debugging mode will cause the logs to build up. For this reason, it is advisable to either take the services out of debugging mode when the problem is resolved, delete the older debug files, or configure the logs directory to be compressed. Please keep this in mind when determining which method of debugging to perform on a system.

 




Legacy ID



254212


Article URL http://www.symantec.com/docs/TECH23853


Terms of use for this information are found in Legal Notices