http://support.veritas.com/docs/254212
E-Mail this document to a colleague
Backup Exec (tm) for Windows Servers contains features to enable debug logging for troubleshooting purposes. 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 9.x for Windows Servers:
Using the Services dialog:
- On Windows NT 4.0:
- 1. Go to Start | Settings | Control Panel | Services
2. Select the Backup Exec Remote Agent for Windows Servers service, and click Stop. When prompted, click Yes to shut down the service.
3. Select the Backup Exec Remote Agent for Windows Servers service, and under Startup Parameters, type -debug, and then click Start (Figure 1)
- Figure 1
- 4. Select the Backup Exec Job Engine Service, and in the Startup Parameters box, type -debug, and then click Start (Figure 2)
- Figure 2
- On Windows 2000, Windows XP, Windows 2003 and Windows 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.
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. 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:
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. a. Backup Exec 10d or below: Browse to HKey_Local_Machine\Software\VERITAS\Backup Exec\Engine\Logging
4. Change the value of CreateDebugLog to 1 to enable debug logging
5. Quit the registry editor
7. Start the Backup Exec for Windows Servers services
To disable debugging in Backup Exec 9.x for Windows Servers:
Using the Services dialog:
1. Go to Start | Settings | Control Panel | Services
2. Select the Backup Exec Remote Agent for Windows Servers service, and click Stop. When prompted, click Yes to shut down the service.
3. Start both the Backup Exec Remote Agent for Windows Servers and Backup Exec Job Engine services without typing the -debug parameter
On Windows 2000, Windows XP Windows 2003 and Windows 2008:
2. Select the Backup Exec Remote Agent for Windows Servers service, and click Stop. When prompted, click Yes to shut down the service.
3. Start both the Backup Exec Remote Agent for Windows Servers service and the Backup Exec Job Engine service without typing -debug
Using the registry editor:
2. Run REGEDIT.EXE
3. a. Backup Exec 10d or below: Browse to HKey_Local_Machine\Software\VERITAS\Backup Exec\Engine\Logging
b. 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
- Backup Exec 10d or below: \Program Files\Veritas\Backup Exec\NT\Logs by default
Backup Exec 11d or above: \Program Files\Symantec\Backup Exec\Logs by default.
The name of the log files will follow the format of <ServerName>-BENGINEXX.Log for the Backup Exec Job Engine service, and <ServerName>-BEREMOTEXX.LOG for the Backup Exec Remote Agent for Windows Servers service. The XX will increment each time the services are started with the -debug option, so that a new log file is created. That is, Server1-BENGINE01.LOG would be an example of a debug log from the Backup Exec Job Engine service. Please provide these logs 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.
If it is requested by support, the registry can be altered to change the amount of detail that is reported in the logs as follows:
1. Stop all Backup Exec for Windows Servers services
3. a. Backup Exec 10d or below: Browse to HKey_Local_Machine\Software\VERITAS\Backup Exec\Engine\Logging
b. Backup Exec 11d or above: Browse to HKey_Local_Machine\Software\Symantec\Backup Exec for Windows\Backup Exec\Engine\Logging
4. Change the keys Engine NDMP Debug Level (for the Backup Exec job engine) and RANT NDMP Debug Level (for Backup Exec Remote Agent for Windows Servers) to either of the following:
- 0 - Logs Initialize, De-Initialize, and error messages
1 - Logs Initialize, De-Initialize, error messages, and flow of Network Data Management Protocol (NDMP) control
2 - Logs all activity from NDMP (this setting can drastically slow down the server)
http://support.veritas.com/docs/190979
http://support.veritas.com/docs/191538
http://support.veritas.com/docs/250681
http://support.veritas.com/docs/266844
http://support.veritas.com/docs/308905
http://support.veritas.com/docs/311459
http://support.veritas.com/docs/314545
http://support.veritas.com/docs/303828
Backup Exec for Windows Servers 10.0
Expires on: 01-24-2010
Subscribe to receive critical updates about this document Backup Exec for Windows Servers
Application: Backup, Configuration, How To, Restore, Troubleshooting
Application Basics: Debug
Operating System: Configuration
Priority: 03
English (US)
Windows 2000
Advanced Server, Advanced Server SP1, Advanced Server SP2, Advanced Server SP3, Advanced Server SP4, Advanced Server Windows Powered, Advanced Server Windows Powered SP1, Advanced Server Windows Powered SP2, Advanced Server Windows Powered SP3, Advanced Server Windows Powered SP4, Datacenter Server, Datacenter Server SP1, Datacenter Server SP2, Datacenter Server SP3, Datacenter Server SP4, Professional, Professional SP1, Professional SP2, Professional SP3, Professional SP4, SAK, Server, Server SP1, Server SP2, Server SP3, Server SP4, Server Windows Powered, Server Windows Powered SP1, Server Windows Powered SP2, Server Windows Powered SP3, Server Windows Powered SP4
Windows NT
3.1 Server, 3.1 Workstation, 3.5 Server, 3.5 Workstation, 3.51 Server, 3.51 Server SP1, 3.51 Server SP2, 3.51 Server SP3, 3.51 Server SP4, 3.51 Server SP5, 3.51 Workstation, 3.51 Workstation SP1, 3.51 Workstation SP2, 3.51 Workstation SP3, 3.51 Workstation SP4, 3.51 Workstation SP5, 4.0 Server, 4.0 Server SP1, 4.0 Server SP2, 4.0 Server SP3, 4.0 Server SP4, 4.0 Server SP5, 4.0 Server SP6, 4.0 Server SP6a, 4.0 Workstation, 4.0 Workstation SP1, 4.0 Workstation SP2, 4.0 Workstation SP3, 4.0 Workstation SP4, 4.0 Workstation SP5, 4.0 Workstation SP6, 4.0 Workstation SP6a
Windows XP
5.2, Embedded, Home 5.1, Home 5.1 SP1, Home 5.1 SP2, Home 5.1 SP3, Pro 5.1, Pro 5.1 64 bit SP1, Pro 5.1 64 bit SP2, Pro 5.1 64 bit SP3, Pro 5.1 64-bit, Pro 5.1 SP1, Pro 5.1 SP2, Pro 5.1 SP3
Windows Server 2003
DataCenter, DataCenter (IA64), DataCenter (x64), DataCenter SP1, DataCenter SP1(IA64), DataCenter SP1(x64), DataCenter SP2, Datacenter SP2(x64), Enterprise (IA64), Enterprise (x64), Enterprise SP1(IA64), Enterprise SP1(x64), Enterprise SP2, Enterprise SP2(x64), Enterprise Server, Enterprise ServerSP1, R2, Standard Server, Standard Server SP1, Standard Server SP1 (x64), Standard Server SP2, Standard Server SP2 (x64), Standard Server(x64), Storage Server, Storage Server SP1, Storage Server SP2, Web Server, Web Server SP1, Web Server SP2
Windows Server 2008
DataCenter (x64-64bit), DataCenter (x86-32bit), Enterprise (x64-64bit), Enterprise (x86-32bit), Itanium, Server Core, Standard (x64-64bit), Standard (x86-32bit), Web Server (x64-64bit), Web Server (x86-32bit)
20330 Stevens Creek Blvd. Cupertino, CA 95014
World Wide Web: http://www.symantec.com,
Tech Support Web: http://entsupport.symantec.com,
E-Mail Support: http://seer.entsupport.symantec.com/email_forms,
FTP: ftp://ftp.entsupport.symantec.com or http://ftp.entsupport.symantec.com