How to troubleshoot backups/restores on SLES/RHEL/Appliance VMware Backup Host

  • Modified Date:
  • Article ID:000068592


New Logging information
FlashBackup Logging has been improved:
Set VERBOSE = 10 to log what entries are being cataloged.

FullVM restore logs will now be in VxUL for nbrestore
For all of the below logging, please enable the vmcloglevel at the bottom of the document. A log level of 3 is standard, however if you suspect a bug then please use 6.

Create VM calls during restores are logged in bpVMutil:


Manual browsing for virtual machines are logged in: (Please set vmcloglevel to at least 3)
# /usr/openv/netbackup/logs/nbproxy
# /usr/openv/logs/nbsl

VMware Backup Host:

Query Base Browsing:
OID 386 ncfvmwarepi OID 366 - /usr/openv/netbackup/logs/ncfnbcs

To configure run:
vxlogcfg -a -p NB -o 386 -s DebugLevel=6
vxlogcfg -a -p NB -o 366 -s DebugLevel=6
Please also setup vmcloglevel to atleast 3 (6 is the highest), instructions can be found further down the document.

To view the log for the last 30 minutes run:
vxlogview -p NB -i ncfnbcs -d all -t 00:30:00 > nbcs.txt

For Snapshots gather: (Please set vmcloglevel to at least 3)
Also check Virtual Center task and events for any errors on the Snapshot.

For Backups

To enable VxMS logging on a Linux backup host on 7.5.x/2.5.x versions:
1. Change to the /usr/openv/lib directory.
2. If the .vxms.rc file already exists, remove the # from the following line and save the file:
3. If the .vxms.rc file does not exist, create it and add the following line:

You can use the echo command to edit the .vxms.rc file (enter all on one line):
echo "debug_level=TRC_TOP|PARAM_IN|PARAM_OUT|PARAM_FULL|INFO|DEBUG" > .vxms.rc

For full VxMS logging:
echo "debug_level=TRC_TOP|PARAM_IN|PARAM_OUT|PARAM_FULL|INFO|DEBUG|TRACE1|TRACE2|TRACE3" > /usr/openv/lib/.vxms.rc

Also add the following for Transport and NCF information:

Pre NetBackup
Create a file with name 'vixDiskLib.ini' in folder /usr/openv/lib/shared/vddk/

With NetBackup and 7.6.x:
Create a file with name 'vixDiskLib.ini' in folder /usr/openv/lib/shared/vddk/lib64

Edit it and add these lines there (everything is case-sensitive, of course):
vixDiskLib.nfc.LogLevel = 4
vixDiskLib.transport.LogLevel = 6

The log files are generated in the /usr/openv/logs directory. For every backup, two log files are generated in the following format:

where <PID> is the process id and <MMDDYY> is the month, day, and year.

To configure VxMS logging on a 7.6/2.6 Linux backup host:

1. Create the VxMS log directory:
Note: For logging to occur, the VxMS directory must exist.

2. Add the following to the /usr/openv/netbackup/bp.conf file:
VXMS_VERBOSE=numeric value of 0 or greater
Set the VXMS_VERBOSE to 5 for most issues, 8 for file mapping related issues.

3. To change the log location, enter the following in the bp.conf file:
vxmslogdir=path to new log location

Note: If the VxMS log location is changed, the Logging Assistant does not collect the logs.



Tar is now nbrestore for VMware Restores:
OID 357 - /usr/openv/logs/ncfnbrestore

To configure ncfnbrestore run:
vxlogcfg -a -p NB -o 356 -s DebugLevel=6
vxlogcfg -a -p NB -o 357 -s DebugLevel=6

To view nbrestore for the last 30 minutes run:
vxlogview -p NB -o 356 -i 357 -d all -t 00:30:00 > nbrestore.txt

Additional logging for Restore related issues
On the Master Server: bprd
On the VMware Backup Host: 
# /usr/openv/logs/ncfnbrestore
# /usr/openv/logs/VxMS-<pid>log.<date>_provider
# /usr/openv/logs/VxMS-<pid>log.<date>_core
# /usr/openv/netbackup/logs/bpVMutil

Instant Recovery Logging:

On the Master Server: bprd

They are 3 main steps performed during Instant Recovery:

 - Export a backup image
 - Mount a backup image
 - Activate VM

If any of these steps failed “Activate Instant Recovery” job logs will have details about the failure and error code.
If Export a backup image fails look at nbfsd.log on media server.
Mount backup image fails look at nbfsd.log on VM Proxy host and also the Virtual Center Task and Events.
Activate VM fails look at bpVMutil.log on VM Proxy host and also the Virtual Center Task and Events.

Binaries on Linux can be found in:

Pre NetBackup

If NetBackup is version or 7.6.x:

To change vSphere timeouts and logging values on Linux
1. On the Linux backup host, create (or open) the following file:
2. To change a timeout value, enter a new dword line under [BACKUP], using the appropriate name (such as jobtimeout or poweroptimeout).  Include a value for the timeout. For example:
This example sets the job timeout to 60 seconds.
Note: If the file already contains a [BACKUP] line, do not add another [BACKUP] line.  Any other lines that already exist under [BACKUP] should remain as they are.
3. To change the level of vSphere API logging, enter a dword line for vmcloglevel with a logging value, under [BACKUP].  For example:
The allowed values are 0 through 6, where 0 is no logging and 6 is the highest log level.

Editing SymVmTools entries
Create a file called /etc/SymVmTools/VmTools.cfg.
The format of this file will be key=value with one key value pair per line.  See an example below:




Terms of use for this information are found in Legal Notices.



Did this article answer your question or resolve your issue?


Did this article save you the trouble of contacting technical support?


How can we make this article more helpful?

Email Address (Optional)