Veritas Netbackup 5.X bperror Codes
===============================================================
Error Number: 0
the requested operation was successfully completed
There were no problems detected with the requested operation.
Try the following:
None, unless this was a database backup performed through a database extension p
roduct (for example, NetBackup for Oracle or NetBackup for SQL Server). In those
instances, code 0 means the backup script that started the backup ran without e
rror. However, you must check other status as explained in the related NetBackup
manual to see if the database was successfully backed up.
===============================================================
Error Number: 1
the requested operation was partially successful
A problem that may require corrective action was detected during the requested o
peration.
Try the following:
Check the All Log Entries report and also the progress log (if there is one). So
me of the problems that can show up under status code 1 are:
* A file or directory path that is more than 1023 characters long.
For NetBackup Advanced Client: the maximum path name length is 1000 character
s for snapshot backups, not 1023. When the snapshot is created, a new mount poin
t is added to the beginning of the file path. If this new mount point plus the o
riginal file path exceeds 1023 characters, the backup fails with status code 1.
The progress log includes the entry "ERR - Skipping long dir path."
* Could not open a file.
The file may have been locked for some reason.
* On a UNIX system, NetBackup could not get the link name of a file.
* On a UNIX system, NetBackup could not process a sparse file.
* Read error encountered in a file.
* File is of an unknown type, or may be hidden.
* On a UNIX system, the lstat system call fails on a file that is eligible to b
e backed up. This may be a permission problem.
* On a UNIX system, a file could not be locked that has mandatory locking enabl
ed.
* A Vault job may terminate with status code 1 if non-fatal errors are encounte
red during one or more of the following operations:
* duplication
* suspension of unvaulted media
* expiration of disk images
* execution of vlt_ejectlist_notify script
* catalog backup
* eject and/or report
In the event of a non-fatal error, Vault will attempt to complete all the ste
ps configured in the vault profile.
Identify which of the above operations encountered an error by reviewing the
summary.log file in each of the sidxxx directories that had problems:
On UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
On Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
Or review the vault debug log file in the following directory:
On UNIX: /usr/openv/netbackup/logs/vault
On Windows: install_path\NetBackup\logs\vault
Correct the problem and rerun the vault job.
* A synthetic backup job may terminate with a status code 1 under the following
conditions:
* No images were found to synthesize (status code = 607)
* TIR info has been pruned from component images (status code = 136)
* Image format is unsupported (status code = 79)
The synthetic backup job will log the actual status code in the NetBackup err
or log. Please refer to the documentation for the corresponding NetBackup error
code for the corrective action to take.
* If a scheduled backup of a UNIX database extension client started via a polic
y that contains multiple backup scripts fails with a status code 1, it means tha
t some of the backup scripts returned a failure status.
* On NetBackup 5.0 or later clients using Windows Open File Backups (WOFB) to b
ack up open or active files, volume snapshots may not have been enabled successf
ully for the backup. The following logging messages should appear in the bpbkar3
2 logs if volume snapshots could not be successfully enabled.
If multi-streamed backup jobs are enabled, log messages similar to the one be
low would appear, indicating volume snapshots were not enabled for the multi-str
eamed backup job:
11:05:44.601 AM: [1536.724] <4> tar_backup::V_AddToFI_XBSAObj: INF - Volume snap
shots not enabled for: D:\Directory1
If multi-streamed backups were not enabled, log messages similar to the one b
elow would appear, indicating volume snapshots were not enabled for the non-stre
amed backup job:
1:59:41.229 PM: [2076.2088] <4> V_Snapshot::V_Snapshot_CreateSnapshot: INF - ===
============================
1:59:41.229 PM: [2076.2088] <4> V_Snapshot::V_Snapshot_CreateSnapshot: INF - Att
empting to create snapshots for D:\Directory1
1:59:41.229 PM: [2076.2088] <4> V_Snapshot::V_Snapshot_CreateSnapshot: INF - CRE
ATE request: C:\Program Files\VERITAS\NetBackup\bin\bpfis create -fim VSP "D:\ D
irectory1"
1:59:41.799 PM: [2076.2088] <4> V_Snapshot::V_Snapshot_ParseBpfisOutput: INF - S
napshot creation, FIS_ID: 1058813981
1:59:41.799 PM: [2076.2088] <4> V_Snapshot::V_Snapshot_ParseBpfisOutput: INF - S
napshot creation EXIT STATUS 11: system call failed
1:59:41.799 PM: [2076.2088] <4> V_Snapshot::V_Snapshot_CreateSnapshot: INF - Sna
pshot creation was not successful
1:59:41.799 PM: [2076.2088] <4> V_Snapshot::V_Snapshot_CreateSnapshot: INF - ===
============================
If this is the case, examine the online_util logs for error log messages rega
rding snapshot creation failures (Please see the NetBackup Advanced Client Syste
m Administrator's Guide for more details on the online_util logs).
In the online_util logs, the following logs messages may appear when snapshot
creation fails for Windows Open File Backup:
1)
04:01:14.168 [376.2364] <32> onlfi_fi_split: VfMS error 11; see following messag
es:
04:01:14.168 [376.2364] <32> onlfi_fi_split: Fatal method error was reported
04:01:14.168 [376.2364] <32> onlfi_fi_split: vfm_freeze_commit: method: VSP, typ
e: FIM, function: VSP_make
04:01:14.168 [376.2364] <32> onlfi_fi_split: VfMS method error 3; see following
message:
04:01:14.168 [376.2364] <32> onlfi_fi_split: VERITAS Frozen Image Services: snap
shot creation failed: invalid argument(s).
Cause: VSP could not be enabled because the VSP snapshot for the backup could
not meet the minimum time specified in the Busy File Wait setting for VSP.
Recommended action: Either increase the Busy File Timeout VSP setting (recomm
ended setting: 300 seconds or more) or resubmit the backup job when there is les
s activity on the volume.
2)
04:17:55.571 [1636.3224] <2> onlfi_vfms_logf: VERITAS Frozen Image Services: (nu
ll): There was an unexpected error while preparing the VSP snapshot transaction.
Dumping the parameter array to provide more information: Error 112 from VSP_Pre
pare
Cause: VSP could not be enabled for the backup because there is not enough fr
ee disk space on the client for the VSP Snapshot Cache files.
Recommended action: Free up some disk space on the volumes being backed up.
3)
If Microsoft Volume Shadow Copy Service (VSS) is used as the Windows Open Fil
e Backup snapshot provider and snapshot creation fails, please refer to your Eve
nt Viewer's Application and System Logs for error information.
* With NetBackup 5.0 or later installed and clients that use the Windows Op
en File Backup option to back up open or active files, a snapshot error may have
occurred. If this is the case, a log message in the bpbkar32 debug log will app
ear indicating a snapshot error has occurred. For example:
8:51:14.569 AM: [1924.2304] <2> tar_base::V_vTarMsgW: ERR
-Snapshot Error while reading test.file
See the recommended actions under status code 156.
===============================================================
Error Number: 2
none of the requested files were backed up
A backup or archive could not back up any of the files in the file list.
Try the following:
Verify that the files exist and you have read access to them.
* Check to see if there is a trailing space on one or more of the filenames in
the client's file list. Remove any inadvertent trailing characters (such as spac
es or tabs).
* On UNIX clients, check to see if the files or directories would be excluded b
ecause of an entry in /usr/openv/netbackup/exclude_list.
* On PC clients, check the exclude list per the instructions in the user's guid
e for the client.
* On Windows clients, verify that the account used to start the NetBackup Clien
t service has read access to the files.
If you are backing up a network drive or a UNC (universal naming convention)
path, use the Services application in the Windows Control Panel to verify that t
he NetBackup Client service does not start under the SYSTEM account. The SYSTEM
account cannot access network drives.
To back up network drives or UNC paths, change the NetBackup Client service s
tartup to log in as a user that has permission to access network drives.
===============================================================
Error Number: 3
valid archive image produced, but no files deleted due to non-fatal problems
The backup portion of the archive command reported problems so the files were no
t deleted.
Try the following:
Examine the progress log or status of the archive on the client to determine if
you need to retry the archive after correcting the problem. If the problem is no
t serious and the files were backed up, you can manually delete the files. To ve
rify which files were backed up, use the NetBackup client-user interface in rest
ore mode and browse the files in the archive. A possible cause for files not bei
ng deleted is that you do not have the necessary permissions. NetBackup cannot d
elete files unless you are either the user that owns the files, a superuser on U
NIX, or an administrator on Windows.
===============================================================
Error Number: 4
archive file removal failed
The backup portion of the archive completed was successful but the delete failed
.
Try the following:
Verify that you have permission to delete the files and that the read-only flag
is not set for the files. On UNIX clients, verify that you have write permission
to the directories that contain the files.Since the backup was successful, you
can delete the files that were backed up (or have the system administrator delet
e the files if you do not have the necessary permissions).
===============================================================
Error Number: 5
the restore failed to recover the requested files
There were errors that caused the restore to fail.
Try the following:
1. Ensure that the client's server list contains entries for the master server
and for any media servers that could be used during a backup or restore.
2. Examine the status or progress log on the client for messages on why the res
tore failed. Also, check the All Log Entries report on the server.
3. Check ownership and permission on directories where files will be restored.
4. Correct problems that you find and retry the restore.
5. For OpenVMS clients, make sure the NetBackup client software is version 3.4
or higher.
6. If you receive status code 5 when attempting to restore files from a FlashBa
ckup backup after a NetBackup patch was installed, the patch may not have been i
nstalled properly. Follow the installation instructions in the patch README file
and make sure the libsfr.so file is copied as instructed.
===============================================================
Error Number: 6
the backup failed to back up the requested files
Errors caused the user backup to fail.
Try the following:
1. Verify that you have read access to the files. Check the status or progress
log on the client for messages on why the backup failed. Correct problems and re
try the backup.
2. On Windows clients, verify that the account used to start the NetBackup Clie
nt service has read access to the files.
3. On Macintosh clients, this code can be due to multiple backups being attempt
ed simultaneously on the same client. Some possible solutions are:
* Adjust the backup schedules.
* If the client is only in one policy, set the policy attribute, Limit jobs
per policy, to 1.
* Set the NetBackup global attribute, Maximum jobs per client, to 1 (note th
at this limits all clients in all policies).
4. For a UNIX database extension client (for example, NetBackup for Oracle), th
is can mean a problem with the script that is controlling the backup.
Check the progress report on the client for a message such as Script exited w
ith status code = number (the number will vary). The progress log also usually n
ames the script.
Check the script for problems. Also, check the troubleshooting logs created b
y the database extension. See the NetBackup guide that came with the database ex
tension for information on the scripts and troubleshooting logs.
===============================================================
Error Number: 7
the archive failed to back up the requested files
Errors caused the user archive to fail.
Try the following:
Verify that you have read access to the files. Check the progress log or the sta
tus on the client for messages on why the archive failed. Correct problems and r
etry the archive. On Windows clients, verify that the account used to start the
NetBackup services has read access to the files.
===============================================================
Error Number: 8
unable to determine the status of rbak
On DomainOS clients, rbak is used to do restores. If rbak does not exit with a s
tatus message, NetBackup cannot determine whether the restore worked or not.
Try the following:
Check for a new core file to see if rbak aborted. Check the ps output to see if
rbak is hung. If so, kill it and try again. Check the progress log for any unusu
al messages from rbak.
===============================================================
Error Number: 9
an extension package is needed, but was not installed
A NetBackup extension product is required in order to perform the requested oper
ation.
Try the following:
Install the required extension product.
===============================================================
Error Number: 10
allocation failed
Allocation of system memory failed because there is insufficient system memory a
vailable. This could be caused by the system being overloaded with too many proc
esses and not enough physical or virtual memory.
Try the following:
Free up memory by terminating unneeded processes that consume memory. Add more s
wap space or physical memory.
===============================================================
Error Number: 11
system call failed
A system call failed. This status code is used for a generic system call failure
that does not have its own status code.
Try the following:
1. Check the All Log Entries and Problems reports to determine which system cal
l failed and other information about the error.
2. For NetBackup Advanced Client:
* The file system specified as a snapshot source is not mounted. In this case,
you may see the following in the /usr/openv/netbackup/logs/bpfis log:
17:12:51 bpfis: FTL - snapshot processing failed, status 11
17:12:51 bpfis: ERR - bpfis FATAL exit status = 11: system call failed
17:12:51 bpfis: INF - EXIT STATUS 11: system call failed
and the following in the /usr/openv/netbackup/logs/online_util log:
17:12:51 onlfi_vfms_logf: INF - cannot snap_on, err: 5
17:12:51 delete_mount_point: INF - Deleted mount point
/tmp/__jody_test:20958
17:12:51 onlfi_freeze: FTL - VfMS error 11; see following messages:
17:12:51 onlfi_freeze: FTL - Fatal method error
17:12:51 onlfi_freeze: FTL - vfm_freeze: method: nbu_snap, type: FIM,
function: nbu_snap_freeze
17:12:51 onlfi_freeze: FTL - VfMS method error 5; see following message:
17:12:51 onlfi_freeze: FTL - nbu_snap_freeze: Cannot turn on snapshot;
snapshot source=/opt, cache=/dev/rdsk/c1t3d1s0, snap error=5
17:12:51 onlfi_thaw: WRN - / is not frozen
Make sure that the file system specified for the snapshot source has been mou
nted.
* The file system specified as the snapshot source does not correspond to the f
ile system that contains the actual files (as opposed to symbolic links to the f
iles). The mounted file system for the snapshot source must contain the actual f
iles, not symbolic links. If items in the file list, such as /oracle/datafile an
d /oracle, are actually symbolic links to /export/home/oracle, the snapshot sour
ce must specify /export, or /export/home, not /oracle.
* vxvm is selected as the snapshot method but the snapshot source is not config
ured over a VERITAS Volume Manager VxVM volume. In this case, you may see the fo
llowing in the /usr/openv/netbackup/logs/bpfis log:
17:12:51 bpfis main: FTL - snapshot processing failed, status 11
17:12:51 bpfis Exit: ERR - bpfis FATAL exit status = 11: system call failed
17:12:51 bpfis Exit: INF - EXIT STATUS 11: system call failed
and something like the following in the /usr/openv/netbackup/logs/ online_uti
l log:
17:12:51 onlfi_vfms_logf: INF - vxvm_freeze: Snapshot source /cockpit1
on device /dev/dsk/c1t0d0s6 is not on a VxVM volume
17:12:51 delete_mount_point: INF - Deleted mount point
/tmp/_cockpit1_coc_group1:3518
17:12:51 onlfi_freeze: FTL - VfMS error 11; see following messages:
17:12:51 onlfi_freeze: FTL - Fatal method error
17:12:51 onlfi_freeze: FTL - vfm_freeze: method: vxvm, type: FIM, function:
vxvm_freeze
17:12:51 onlfi_freeze: FTL - VfMS method error 9; see following message:
17:12:51 onlfi_freeze: FTL - vxvm_freeze: Snapshot source /cockpit1 on
device /dev/dsk/c1t0d0s6 is not on a VxVM volume
17:12:51 onlfi_thaw: INF - fim=vxvm
17:12:51 onlfi_thaw: WRN - /cockpit1 is not frozen
Make sure that the snapshot source is configured over a VERITAS Volume Manage
r VxVM volume.
* vxvm was selected as the snapshot method, but a VERITAS Volume Manager snapsh
ot mirror of the snapshot source volume had not been created prior to running th
e backup, or another backup is currently running that is using the snapshot mirr
or. In either case, you may see the following in the /usr/openv/netbackup/logs/o
nline_util log:
17:12:51 onlfi_freeze: FTL - VfMS error 11; see following messages:
17:12:51 onlfi_freeze: FTL - Fatal method error
17:12:51 onlfi_freeze: FTL - vfm_freeze: method: vxvm, type: FIM, function:
vxvm_freeze
17:12:51 onlfi_freeze: FTL - VfMS method error 3; see following message:
17:12:51 onlfi_freeze: FTL - find_ready_snapshot: Cannot find available
snapshot mirror
Refer to the NetBackup Advanced Client System Administrator's Guide for infor
mation on how to create a snapshot mirror on the client before running the backu
p.
* vxvm was selected as the snapshot method, and a VERITAS Volume Manager snapsh
ot mirror of the snapshot source volume has been created. However, two different
backup jobs (A and B) attempt to back up the same volume (for example, vol01),
but job A starts just before job B. Because there is a brief pause between findi
ng an available snapshot mirror and actually forming the snapshot of it, job B (
running slightly behind job A) might attempt to create a snapshot of the snapsho
t mirror just before job A (running slightly ahead) actually creates the snapsho
t and gets the lock on it.
In this case, you may see the following in the /usr/openv/netbackup/logs/onli
ne_util log:
17:12:51 onlfi_freeze: FTL - VfMS error 11; see following messages:
17:12:51 onlfi_freeze: FTL - Fatal method error
17:12:51 onlfi_freeze: FTL - vfm_freeze: method: vxvm, type: FIM, function:
vxvm_freeze
17:12:51 onlfi_freeze: FTL - VfMS method error 3; see following message:
17:12:51 onlfi_freeze: FTL - vxvm_freeze: Command failed with status=11:
/usr/sbin/vxassist -g rootdg snapshot vol01 VfMSCAAu7a4Uw
/var/tmp/VfMSAAAs7a4Uw 2>/var/tmp/VfMSBAAt7a4Uw
The job that was unable to get a lock (job B in the above example) fails, and
must be run again.
* When using nbu_snap as a snapshot method, you may have stale snapshots if sta
tus code 11 occurs with the following messages in the /usr/openv/netbackup/logs/
online_util log. (Stale snapshots are those that were not automatically deleted
by nbu_snap.)
17:12:51 onlfi_freeze: FTL - VfMS error 11; see following messages:
17:12:51 onlfi_freeze: FTL - Fatal method error
17:12:51 onlfi_freeze: FTL - vfm_freeze: method: nbu_snap, type: FIM,
function: nbu_snap_freeze
17:12:51 onlfi_freeze: FTL - VfMS method error 5; see following message:
17:12:51 onlfi_freeze: FTL - nbu_snap_freeze: Cannot turn on snapshot;
snapshot source=/oracle/ufs_r, cache=/dev/rdsk/c4t1d11s4,snap error=11
a. Look for stale snapshots by running the /usr/openv/netbackup/bin/driver/s
naplist command when there are no active backups running. If the snaplist comman
d shows cache entries, there are stale snapshots. Nothing is displayed if there
are no stale snapshots.
Example snaplist output:
id ident size cached minblk err time
43 6515 8390970 0 0 0 11/16/00 13:31:36
device = /dev/rdsk/c1t6d0s0
cache = /dev/rdsk/c1t6d0s7
b. Use the snapoff command to remove the stale snapshot, as follows:
/usr/openv/netbackup/bin/driver/snapoff id
where id is the id from the snaplist output (such as 43 in the above example)
.
* If a backup using the VxFS_Checkpoint snapshot method failed, the NetBackup b
pbkar process should automatically remove the clone. Sometimes, however, bpbkar
is unable to remove the clone. In this case, you may see messages such as the fo
llowing in the /usr/openv/netbackup/logs/online_util log:
15:21:45.716 [4236] <4> create_mount_point: INF - Created mount point
/tmp/_vtrax_test_fastrax_dlt:4236
15:21:45.869 [4236] <2> onlfi_vfms_logf: INF - vxfs clone handle : 9600344
15:21:45.870 [4236] <2> onlfi_vfms_logf: INF - VxFS_Checkpoint_freeze: Cannot c
reate
checkpoint; status=17
15:21:45.872 [4236] <4> delete_mount_point: INF - Deleted mount point
/tmp/_vtrax_test_fastrax_dlt:4236
15:21:45.873 [4236] <32> onlfi_freeze: FTL - VfMS error 11; see following
messages:
15:21:45.873 [4236] <32> onlfi_freeze: FTL - Fatal method error was reported
15:21:45.873 [4236] <32> onlfi_freeze: FTL - vfm_freeze: method: VxFS_Checkpoin
t,
type: FIM, function: VxFS_Checkpoint_freeze
15:21:45.873 [4236] <32> onlfi_freeze: FTL - VfMS method error 17; see
following message:
15:21:45.874 [4236] <32> onlfi_freeze: FTL - VxFS_Checkpoint_freeze: Cannot cre
ate
checkpoint; status=17
Remove the clone as follows.
Note: If the checkpoint is not removed, you will not be able to use VxFS_Checkpo
int to back up any data in the file system where the checkpoint is mounted.
a. List the name of the checkpoint by entering the following VxFS command:
/usr/lib/fs/vxfs/fsckptadm list /file_system
where file_system is the name of the file system where the checkpoint is moun
ted. Following is sample output. In this example, /vtrax_test is the file system
and fi_ckpt is the name of the checkpoint.
/vtrax_test
fi_ckpt:
ctime = Mon Nov 12 10:08:13 2001
mtime = Mon Nov 12 10:08:13 2001
flags = largefiles
b. Remove the checkpoint by entering the following:
/usr/lib/fs/vxfs/fsckptadm remove checkpoint /file_system
c. If the checkpoint cannot be removed, unmount the checkpoint and retry ste
p b.
* If a snapshot backup failed using TimeFinder, ShadowImage, or BusinessCopy me
thod, there may be a VxVM clone left over from a previous backup. You may see me
ssages similar to the following in the /usr/openv/netbackup/logs/online_util log
:
19:13:07.686 [14981] <2> onlfi_vfms_logf: INF - do_cmd: Command failed with stat
us=20:
/usr/openv/netbackup/bin/bpdgclone -g wil_test -n vol01 -f /var/tmp/HDSTFCAAs7aO
qD
/var/tmp/VfMSAAAq7aOqD 2>/var/tmp/VfMSBAAr7aOqD
19:13:07.687 [14981] <2> onlfi_vfms_logf: INF - --- Dumping file /var/tmp/VfMSAA
Aq7aOqD (stdout):
19:13:07.687 [14981] <2> onlfi_vfms_logf: INF - --- End of file /var/tmp/VfMSAAA
q7aOqD
19:13:07.687 [14981] <2> onlfi_vfms_logf: INF - --- Dumping file /var/tmp/VfMSBA
Ar7aOqD (stderr):
19:13:07.687 [14981] <2> onlfi_vfms_logf: INF - clone group and volume alrea
dy exists
19:13:07.688 [14981] <2> onlfi_vfms_logf: INF - --- End of file /var/tmp/VfMSBAA
r7aOqD
NetBackup automatically creates VxVM clones for TimeFinder, ShadowImage, or B
usinessCopy backups of data configured over volumes. After the backup has comple
ted, NetBackup removes the VxVM clone. In this case, a system crash or reboot ma
y have prevented the removal. Remove the clone as follows.
(Do the following on the client or alternate client, depending on the type of
backup.)
a. When no backups are running, use the following VxVM command to list any c
lones: vxdg list
The clone name will be of the form clone_disk_group_clone.
b. To remove the clone, enter the following:
/usr/openv/netbackup/bin/bpdgclone -g disk_group -n volume -c
For example:
/usr/openv/netbackup/bin/bpdgclone -g wil_test -n vol01 -c
where wil_test is the name of the disk group and volo1 is the name of the VxV
M volume.
For more information on removing a VxVM clone, refer to the NetBackup Advance
d Client System Administrator's Guide. For vxdg, refer to the VERITAS Volume Man
ager Administrator's Guide.
c. Before running the backup again, resynchronize the primary disk with the
secondary disk. For assistance, refer to the NetBackup Advanced Client System Ad
ministrator's Guide.
* If a snapshot backup failed using the FlashSnap or VVR snapshot method, there
may be a VxVM snapshot left over from a previous backup. You may see messages s
imilar to the following in the /usr/openv/netbackup/logs/online_util log:
14:41:15.345 [22493] <32> onlfi_freeze: FTL - VfMS error 11; see following messa
ges:
14:41:15.345 [22493] <32> onlfi_freeze: FTL - Fatal method error was reported
14:41:15.345 [22493] <32> onlfi_freeze: FTL - vfm_freeze_commit: method: FlashSn
ap, type: FIM, function: FlashSnap_freeze_commit
14:41:15.345 [22493] <32> onlfi_freeze: FTL - VfMS method error 8; see following
message:
14:41:15.345 [22493] <32> onlfi_freeze: FTL - vxvm__find_ready_snapshot: Cannot
find available snapshot mirror
NetBackup automatically creates VxVM snapshots for backups of data configured
over volumes. After the backup completes, NetBackup removes the VxVM snapshot.
In this case, a system crash or reboot may have prevented the removal. Remove th
e snapshot as follows.
For FlashSnap:
(Do the following on the client or alternate client, depending on the type of
backup.)
a. Find the VxVM disk group:
vxdg list
The format of the disk group name is as follows:
primaryhost_diskgroup_split
If vxdg list does not show the disk group, the group might have been deported
. You can discover all the disk groups, including deported ones, by entering:
vxdisk -o alldgs list
The disk groups listed in parentheses are not imported on the local system.
b. Deport the VxVM disk group:
vxdg deport primaryhost_diskgroup_split
Enter the following on the primary (original) client:
c. Import and join the VxVM disk group:
vxdg import primaryhost_diskgroup_split
vxrecover -g primaryhost_diskgroup_split -m
vxdg join primaryhost_diskgroup_split diskgroup
d. Start the volume and snap back the snapshot volume:
vxvol -g primaryhost_diskgroup_split start SNAP_diskgroup_volume
vxassist snapback SNAP_diskgroup_volume
For VVR, on the alternate client:
a. Enter the following to display unsynchronized mirror disks:
vxprint -g diskgroup
b. Enter the following to resynchronize the mirror disks:
vxassist -g diskgroup -v volume snapback
* When using a snapshot method such as VxFS_Checkpoint to back up a VxFS file s
ystem, the backup will fail if the VERITAS File System (VxFS) license has expire
d. Messages such as the following appear in the /usr/openv/netbackup/logs/online
_util log:
11:37:42.279 [24194] <2> onlfi_vfms_logf: INF - VxFS_Checkpoint_freeze: Cannot o
pen checkpoint; status=100
11:37:42.283 [24194] <4> delete_mount_point: INF - Deleted mount point /tmp/_vrt
s_frzn_img__test1_24194
11:37:42.283 [24194] <32> onlfi_freeze_fim_fs: FTL - VfMS error 11; see followin
g messages:
11:37:42.283 [24194] <32> onlfi_freeze_fim_fs: FTL - Fatal method error was repo
rted
11:37:42.284 [24194] <32> onlfi_freeze_fim_fs: FTL - vfm_freeze: method: VxFS_Ch
eckpoint, type: FIM, function: VxFS_Checkpoint_freeze
11:37:42.284 [24194] <32> onlfi_freeze_fim_fs: FTL - VfMS method error 100; see
following message:
11:37:42.284 [24194] <32> onlfi_freeze_fim_fs: FTL - VxFS_Checkpoint_freeze: Can
not open checkpoint; status=100
Obtain a new VxFS license and retry the backup.
3. For NetBackup Advanced Client with instant recovery:
* If the backup is enabled for instant recovery with either the vxvm or VVR sna
pshot method, your VxVM mirrors may not be properly configured. In this case, yo
u may see the following in the /usr/openv/netbackup/logs/bppfi log on the client
(when verbose mode is set high).
13:43:39.095 [16375] <2> onlfi_vfms_logf: INF - Executing command:
13:43:39.095 [16375] <2> onlfi_vfms_logf: INF - /usr/sbin/vxprint -g rootdg -q -
t -e 'assoc="pfi_concat"' /var/tmp/VfMSAA
Arja4.F 2>/var/tmp/VfMSBAAsja4.F
13:43:39.215 [16375] <2> onlfi_vfms_logf: INF - pfi_find_snapdone: 0 SNAPDONE pl
exes found
13:43:39.215 [16375] <2> onlfi_vfms_logf: INF - Executing command:
13:43:39.215 [16375] <2> onlfi_vfms_logf: INF - /usr/sbin/vxassist -g rootdg sna
pprint pfi_concat /var/tmp/VfMSAAArja4.F
2>/var/tmp/VfMSBAAsja4.F
13:43:39.512 [16375] <2> onlfi_vfms_logf: INF - 0 active plexes for /rootdg/pfi_
concat: 0 are PFI 0 non-PFI
13:43:39.512 [16375] <2> onlfi_vfms_logf: INF - pfi_find_active.3309: exiting wi
th VXVM_E_SYS = 3
13:43:39.512 [16375] <2> onlfi_vfms_logf: INF - pfi_snapshot.3866: No PFI snapsh
ot. err= 3
Configure the VxVM mirrors as described in the Instant Recovery chapter of th
e NetBackup Advanced Client System Administrator's Guide.
4. A frequent cause is that the server's file system is full. For example, you
may see a message similar to the following in the Problems report or bpdbm debug
log:
06/27/95 01:04:00 romb romb db_FLISTsend failed: system call failed (11)
06/27/95 01:04:01 romb romb media manager terminated by parent process
06/27/95 01:05:15 romb romb backup of client romb exited with status 11
(system call failed)
On UNIX systems, run a df command on the /usr/openv/netbackup/db directory.
If the df command does not reveal the problem, check the bpdbm debug logs or
do a grep for the message
system call failed
in relevant files under the directory /usr/openv/netbackup/db/error/
On Windows systems, verify that there is enough room in the disk partition wh
ere NetBackup is installed.
5. Verify that the system is not running out of virtual memory. If virtual memo
ry is the problem, shut down unused applications or increase the amount of virtu
al memory.
To increase virtual memory on Windows:
a. Display the Control Panel.
b. Double-click System.
c. On the Performance tab, set Virtual Memory to a higher value.
6. On UNIX systems, check for a semaphore problem. This error can be caused by
the system not having enough semaphores allocated. This is most commonly seen on
Solaris 2 servers when an RDBMS is also running.
The symptoms of the problem vary. In some cases, error messages in the NetBac
kup log indicate a backup failure due to an error in semaphore operation; anothe
r symptom is the inability of the NetBackup Device Manager service Media Manager
device daemon, ltid, to acquire a needed semaphore (this is the Media Manager D
evice Manager device daemon on UNIX).
System requirements vary; thus, no absolute recommendations can be made. One
customer running both NetBackup and ORACLE on their Solaris server made the foll
owing changes to their /etc/system file and then rebooted the system (boot -r);
the changes were found to be adequate:
set semsys:seminfo_semmni=300
set semsys:seminfo_semmns=300
set semsys:seminfo_semmsl=300
set semsys:seminfo_semmnu=600
Set these attributes to a value great enough to provide resources to all appl
ications on your system.
Run the NetBackup Configuration Validation Utility (NCVU) and note the semaph
ore settings in the kernel checks in section one.
7. Examine other debug logs or the progress log or status on the client.
===============================================================
Error Number: 12
file open failed
An open of a file failed.
Try the following:
* For NetBackup Advanced Client only:
Status code 12 may appear in the /usr/openv/netbackup/logs/bptm or bpdm log,
accompanied by the following:
tpc_read_config failed: cannot open file
/usr/openv/volmgr/database/3pc.conf
This may indicate that the policy is configured with either NetBackup Media S
erver or Third-Party Copy Device as the offhost backup method, but that the 3pc.
conf file does not exist or is in the wrong location. For instructions on creati
ng the 3pc.conf file, refer to the latest version of the NetBackup Advanced Clie
nt System Administrator's Guide.
* For a FlashBackup policy, if the CACHE= entry follows the source data entry (
the entry for the data to back up), the backup will fail with status code 12. Me
ssages such as the following will appear in the /usr/openv/netbackup/logs/bpbkar
logs on the client
09:55:33.941 [6092] <16> bpfsmap: ERR - open_snapdisk: NBU snapshot enable faile
d error 3
09:55:33.942 [6092] <32> bpfsmap: FTL - bpfsmap: can't open snapshot disk /dev/r
dsk/c4t1d0s3 errno 0
09:55:33.950 [6092] <16> bpbkar Exit: ERR - bpbkar FATAL exit status = 12: file
open failed
09:55:33.956 [6092] <4> bpbkar Exit: INF - EXIT STATUS 12: file open failed
09:55:33.957 [6092] <2> bpbkar Exit: INF - Close of stdout complete
Change the order of the Backup Selections list so that the CACHE entry preced
es the source data entry. (The source data entry specifies the raw partition con
taining the file system to be backed up.)
* Check the NetBackup Problems report. Try to determine the file and why the er
ror occurred. A possible cause is a permission problem with the file. For detail
ed troubleshooting information, create a debug log directory for the process tha
t returned this status code. Then, retry the operation, and check the resulting
debug log.
===============================================================
Error Number: 13
file read failed
A read of a file or socket failed. Possible causes include:
* I/O error reading from the file system.
* Read of an incomplete or corrupt file.
* Socket read failing. A socket read failure can be caused by a network problem
or a problem with the process that is writing to the socket.
* A problem specific to NetBackup Advanced Client (see recommended actions).
Try the following:
1. Check the NetBackup Problems report for clues on where and why the problem o
ccurred.
2. For a FlashBackup client, check the /var/adm/messages log for errors like th
e following:
Mar 24 01:35:58 bison unix: WARNING: sn_alloccache: cache
/dev/rdsk/c0t2d0s3 full - all snaps using this cache are now unusable
This indicates that the cache partition is not large enough. If possible, inc
rease the size of the cache partition. Or, if multiple backups are using the sam
e cache, either reduce the number of concurrent backups by rescheduling some of
them or reschedule the entire backup to a time when the file system is less acti
ve.
3. For detailed troubleshooting information, create a debug log directory for t
he process that returned this status code, retry the operation, and check the re
sulting debug log.
4. For NetBackup Advanced Client only:
Status code 13 may appear in the /usr/openv/netbackup/logs/bpbkar log, and ca
n indicate the following:
* The files to back up reside on an IDE drive as opposed to SCSI, and the of
fhost backup method was set to either NetBackup Media Server or Third-Party Copy
Device. If you are using offhost backup, the disk containing the client files m
ust be a SCSI or Fibre Channel device.
If the disk is an IDE drive, you may see the following in the /usr/openv/ net
backup/logs/online_util log:
get_disk_info: FTL - /var/tmp/caa026fEU disk_inquiry failed.
Errno = 25: Inappropriate ioctl for device
and the following may appear in the /usr/openv/netbackup/logs/bpbkar log:
bpbkar: INF - Processing /var
bpbkar: ERR - get_disk_info() failed, status 13
bpbkar: ERR - tpc_get_disk_info() failed: err 13
bpbkar: ERR - bpbkar FATAL exit status = 13: file read failed
bpbkar: INF - EXIT STATUS 13: file read failed
* The files to back up exist on a file system that is not mounted. The file sys
tem specified as the snapshot source must be mounted. If the snapshot source is
not mounted but the mount point is present, NetBackup may try to take a snapshot
of the directory above the directory that was specified as the snapshot source.
===============================================================
Error Number: 14
file write failed
A write to a file or socket failed. Possible causes include:
* I/O error writing to the file system.
* Write to a socket failed. This can be caused by a network problem or a proble
m with the process reading from the socket.
* Writing to a full disk partition.
Try the following:
* Check the NetBackup Problems report for clues on where and why the problem oc
curred.
* For detailed troubleshooting information, create a debug log directory for th
e process that returned this status code, retry the operation, and check the res
ulting debug log.
* Make sure that routers, bridges, and other network devices are all at "full"
duplex.
* Use a "sniffer" program to determine the number of packets being rejected and
/or re-requested.
* On Windows systems, the client bpbkar log may contain a 10054 "Connection Res
et Error"error (usually indicates a hardware error). Somewhere between the NetBa
ckup client and server, the connection was reset. When NetBackup receives this e
rror, it is unable to continue the backup. This error has been attributed to the
following:
* A hiccup in the network.
* A bad network interface card on a NetBackup client.
* A bad network interface card on the NetBackup server.
* Faulty routers.
* Other applications interfering with NetBackup connections.
* On Novell systems, status code 14 has also been attributed to network issues.
Try a "sniffer" program, as suggested above.
===============================================================
Error Number: 15
file close failed
A close of a file or socket failed.
Try the following:
Check the NetBackup Problems report for clues on where and why the problem occur
red. For detailed troubleshooting information, create a debug log directory for
the process that returned this status code, retry the operation, and check the r
esulting debug log.
===============================================================
Error Number: 16
unimplemented feature
The specified operation is unimplemented. This error should not occur through no
rmal use of NetBackup.
Try the following:
Save all error information and call customer support.
===============================================================
Error Number: 17
pipe open failed
Occurs in NetBackup client menu and vault areas.
Try the following:
None
===============================================================
Error Number: 18
pipe close failed
Close of a pipe failed, when one process tries to start a child process.
Try the following:
Check the NetBackup Problems report for clues on why the failure occurred. For d
etailed troubleshooting information, create a debug log directory for the proces
s that returned this status code, retry the operation, and check the resulting d
ebug log.
===============================================================
Error Number: 19
getservbyname failed
A call to getservbyname() failed. The getservbyname()function uses the name of t
he service to find a service entry in the services file (or NIS services map on
UNIX if it is configured).
Try the following:
1. Check the NetBackup Problems report for clues on why the failure occurred.
2. On a UNIX system, check that /etc/services and NIS services map (if applicab
le) have entries for the NetBackup services: bpcd, bpdbm, and bprd.
3. Run the NetBackup Configuration Validation Utility (NCVU) and note the servi
ces configuration checks in section one.
4. On a Windows system, verify that the %SystemRoot%\system32\drivers\etc\servi
ces file shows the correct entries for the NetBackup internet processes: bpcd, b
pdbm, and bprd.
Ensure that the NetBackup Client Service Port number and NetBackup Request Se
rvice Port number on the Network tab in the NetBackup Client Properties dialog m
atch the settings in the services file. To display this dialog, start the Backup
, Archive, and Restore interface and click NetBackup Client Properties on the Fi
le menu. The values on the Network tab are written to the services file when the
NetBackup Client service starts.
Also, see "Verifying Host Names and Services Entries" in the Troubleshooting
Guide.
5. Check the level of network activity. An overloaded network can cause this er
ror.
6. If the above actions do not reveal the problem, create a debug log directory
for the process that returned this status code, retry the operation, and check
the resulting debug log.
===============================================================
Error Number: 20
invalid command parameter
One or more command parameters were not valid. This error can occur when a maste
r and its media servers or a master server and a client have different levels of
NetBackup installed. For example, if a NetBackup master server has NetBackup 4.
5 and the media server has NetBackup 3.4. This error can also occur if the wrong
parameters are used when executing a command line.
Try the following:
1. Check the NetBackup Problems report for clues.
2. If the error occurs when executing a command on the command line, verify tha
t the parameters are valid.
3. For NetBackup Advanced Client:
* If the following appears in the /usr/openv/netbackup/logs/bptm log,
bptm: cannot perform Third-Party-Copy for multiplexed backups
send_brm_msg: ERROR 20
bptm: EXITING with status 20
multiplexing was enabled on a third-party copy backup. The Third-Party Copy D
evice offhost backup method is incompatible with multiplexing (the writing of tw
o or more concurrent backup jobs to the same storage device). You must disable m
ultiplexing for any third-party copy backups. If multiplexing is enabled, the ba
ckup will fail.
* The media server may not have the correct 3pc.conf file entry for the clie
nt disk needed for the backup. The following appears in the /usr/openv/netbackup
/logs/bpbkar log:
14:45:00.983 [15773] <4> bpmap_mm_get_devid: GET_DEVICE_INDEX 1
EMC:SYMMETRIX:601092014000
14:45:00.986 [15773] <4> bpbkar child_send_keepalives: keepalive
child started, pid = 15822
14:47:02.029 [15773] <4> bpmap_mm_get_devid: keepalive child:
15822 killed
14:47:02.030 [15773] <4> bpmap_mm_get_devid: DEVICE_INDEX -1
14:47:02.031 [15773] <16> bpmap_send_extend: ERR - can't obtain
device id string EMC:SYMMETRIX:601092014000
14:47:33.167 [15773] <16> bpbkar Exit: ERR - bpbkar FATAL exit
status = 227: no entity was found
14:47:33.167 [15773] <4> bpbkar Exit: INF - EXIT STATUS 227: no
entity was found
14:47:33.168 [15773] <2> bpbkar Exit: INF - Close of stdout
complete
This shows that a particular device cannot be found in the 3pc.conf file on t
he media server (14:47:02.031 [15773] <16> bpmap_send_extend: ERR - can't obtain
device id string EMC:SYMMETRIX:601092014000). The problem is one of the followi
ng:
* The 3pc.conf file on the media server is outdated. Recreate the 3pc.conf f
ile.
* The media server is not on the same fibre channel network as the third-par
ty copy device and client disk. As a result, the 3pc.conf file does not have a c
orrect entry for the client disk. Run the bptpcinfo command with the
-x client_name option; this adds the client disk to the 3pc.conf file. For each
disk added to the file by means of bptpcinfo -x client_name, you may need to add
the device's world-wide name (wwn=), as explained in the SAN Configuration chap
ter of the NetBackup Advanced Client System Administrator's Guide.
* For a FlashBackup policy configured in the earlier (pre-5.0) manner, if th
e Backup Selections list contains the actual file name of the raw device (such a
s /devices/pci@1f,0/pci@1/scsi@3/sd@1,0:d,raw) rather than the symbolic link for
m (such as /dev/rdsk/c0t0d0s1), the backup will fail. Messages such as the follo
wing will appear in the /usr/openv/netbackup/logs/bpbkar logs on the client:
09:41:30.785 [5998] <32> bpfsmap: FTL - bpfsmap: couldn't get block name for /de
vices/pci@1f,0/pci@1/scsi@3/sd@1,0:d,raw
09:41:30.792 [5998] <16> bpbkar Exit: ERR - bpbkar FATAL exit status = 20: inval
id command parameter
09:41:30.797 [5998] <4> bpbkar Exit: INF - EXIT STATUS 20: invalid command param
eter
09:41:30.799 [5998] <2> bpbkar Exit: INF - Close of stdout complete
Use the symbolic link form of the device name (such as /dev/rdsk/c0t0d0s1) an
d retry the backup.
CAUTION: For a FlashBackup policy configured with NetBackup Advanced Client,
with the Perform snapshot backups option selected, the backup may complete but t
he data cannot be restored if the Backup Selections list contains the actual fil
e name of a raw device.
* The HP VxFS snapshot mechanism requires a dedicated cache partition for ea
ch snapshot. A check is made in the mount table to make sure the cache partition
is not already in use. If the cache partition is already in use, status code 20
will occur.
Check the /usr/openv/netbackup/logs/bpbkar log for a message similar to the f
ollowing:
bpfsmap: FTL - bpfsmap: snapshot cache already in use, /dev/arrayvg/vol4c
bpbkar Exit: ERR - bpbkar FATAL exit status = 20: invalid command paramet
er
bpbkar Exit: INF - EXIT STATUS 20: invalid command parameter
If the snapshot cache partition is already in use, you will have to set up yo
ur policy schedules to run at different times, or use different cache partitions
for each backup.
If the Allow multiple data streams option is enabled, each stream must have i
ts own dedicated cache partition.
4. Compare the NetBackup version level on the server to that on the clients:
* On UNIX NetBackup servers and clients, check the /usr/openv/netbackup/bin/
version file.
* On Windows NetBackup servers, check the install_path\netbackup\version.txt
file or the About NetBackup item on the Help menu.
* On Microsoft Windows clients, check the About NetBackup item on the Help m
enu.
* On NetWare target clients, check the Version entry in the bp.ini file.
If the client software is earlier than 3.0, verify that the client is in a St
andard type policy.
* On Macintosh clients, check the version file in the bin folder in the NetB
ackup folder in the Preferences folder.
* If the error is being displayed from a Java interface, tell them how to en
able the debug print manager in the Java startup file. Retry and compare the par
ameters logged in the Java log with the parameters listed in the commands usage
statement.
5. If the above actions do not reveal the problem, create a debug log directory
for the process that returned this status code, retry the operation, and check
the resulting debug log.
===============================================================
Error Number: 21
socket open failed
A socket could not be opened.
Try the following:
1. Check the NetBackup Problems report for clues on where and why the failure o
ccurred. If you cannot determine the cause from the Problems report, create debu
g log directories for the processes that returned this status code. Then, retry
the operation and check the resulting debug logs.
2. On Sun Solaris, verify that all operating system patches are installed (see
the Operating Notes section of the NetBackup Release Notes).
3. On Windows, verify that the recommended service packs are installed.
===============================================================
Error Number: 22
socket close failed
A socket could not be closed.
Try the following:
1. Check the NetBackup Problems report for clues on where and why the failure o
ccurred. If you cannot determine the cause from the Problems report, create debu
g log directories for the processes that could have returned this status code. T
hen, retry the operation and check the resulting debug logs.
2. On Sun Solaris, verify that all operating system patches are installed (see
the Operating Notes section of the NetBackup Release Notes).
3. On Windows, verify that the recommended service packs are installed.
===============================================================
Error Number: 23
socket read failed
A read operation from a socket failed.
Try the following:
1. Check the NetBackup Problems report for clues on where and why the failure o
ccurred. If you cannot determine the cause from the Problems report, create debu
g log directories for the processes that could have returned this status code. T
hen, retry the operation and check the resulting debug logs.
2. Corrupt binaries are one possible cause for this error. For example, in one
instance, the following was seen in the bpsched debug log.
get_num_avail_drives: readline failed: socket read failed (23)
get_stunits: get_num_avail_drives failed with stat 23
Loading a fresh bptm from the install media resolved the problem.
3. On Sun Solaris, verify that all operating system patches are installed (see
the Operating Notes section of the NetBackup Release Notes).
4. On Windows, verify that the recommended service packs are installed.
5. This error may occur during a restore to a Novell client. Note the following
possible actions:
* By default, the value for Novell "Maximum Concurrent Disk Cache Writes" ma
y be too low (for example, 50); Novell recommends setting it to 100. A value of
100 increases the speed and efficiency of disk cache writes by increasing the nu
mber of write requests that can be executed at one time.
* Change to or add the following settings in the Novell sys:system\autoexec.
ncf file:
SET Maximum Packet Receive Buffers = 4000
SET Maximum Directory Cache Buffers = 4000
SET Maximum Concurrent Disk Cache Writes = 2000
SET Maximum Concurrent Directory Cache Writes = 2000
SET Maximum Physical Receive Packet Size = 1514
* On NT/2000 master servers, check the LIST_FILES_TIMEOUT value and ensure t
hat this value is at least 1800.
6. Run the NetBackup Configuration Validation Utility (NCVU) on the master serv
er and clients. Note the name resolution checks in section seven and NCVU summar
y.
===============================================================
Error Number: 24
socket write failed
A write operation to a socket failed.
Try the following:
1. Check the NetBackup Problems report for clues on where and why the failure o
ccurred. If you cannot determine the cause from the Problems report, create debu
g log directories for the processes that could have returned this status code. T
hen retry the operation and check the resulting debug logs.
2. A possible cause could be a high network load. For example, this has been se
en in conjunction with Cannot write to STDOUT when a Windows system that is moni
toring network load has detected a high load and sent an ICMP packet to other sy
stems that says the route being used by those systems was disconnected. The log
messages were similar to the following:
01/31/96 14:05:23 ruble crabtree.null.com from client crabtree.null.com: ERR - C
annot write to STDOUT. Err no= 242: No route to host
01/31/96 14:05:48 ruble crabtree.null.com successfully wrote backup id crabtree.
null.com_0823125016, copy 1, fragment 1, 440864 Kbytes at 628.538 Kbytes/sec
01/31/96 14:05:51 netbackup crabtree.null.com CLIENT crabtree.null.com POLICY Re
mote3SysFullW SCHED Sirius EXIT STATUS 24 (socket write failed)
3. On Sun Solaris, verify that all operating system patches are installed (see
the Operating Notes section of the NetBackup Release Notes).
4. On Windows, verify that the recommended service packs are installed.
5. This error may occur during a restore to a Novell client. Note the following
possible actions:
* By default, the value for Novell "Maximum Packet Receive Buffers" may be t
oo low (such as 100). The restore performance may be improved by changing this v
alue to 2000. To change it, issue "SET Maximum Packet Receive Buffers=" a
t the console, or enter the value in either of the following Novell files: sys:s
ystem\startup.ncf or sys:system\autoexec.ncf.
* Change to or add the following settings in the Novell sys:system\autoexec.
ncf file:
SET Maximum Packet Receive Buffers = 4000
SET Maximum Directory Cache Buffers = 4000
SET Maximum Concurrent Disk Cache Writes = 2000
SET Maximum Concurrent Directory Cache Writes = 2000
SET Maximum Physical Receive Packet Size = 1514
6. Run the NetBackup Configuration Validation Utility (NCVU) on the master serv
er and clients. Note the name resolution checks in section seven and NCVU summar
y.
===============================================================
Error Number: 25
cannot connect on socket
A process timed out while connecting to another process for a particular operati
on. This problem can occur when a process tries to connect to the NetBackup requ
est daemon (bprd) or database manager daemon (bpdbm) and the daemon is not runni
ng. (On Windows, these daemons are the NetBackup Request Manager and NetBackup D
atabase Manager services.) It can also occur if the network or server is heavily
loaded and has slow response time, or if an evaluation license key for NetBacku
p has expired. However, the most common cause of this error is hostname resoluti
on problems.
Try the following:
1. On a UNIX NetBackup master server, verify that the bprd and bpdbm processes
are running. If these processes are not running, start them. On a Windows master
server, verify that the NetBackup Request Manager and NetBackup Database Manage
r services are running. If these services are not running, start them.
If the above processes or services are running, examine the All Log Entries r
eport for the time of the failure to determine where the failure occurred.
* If you cannot view the report, or you get a cannot connect on socket error
when trying to view it, verify again that the NetBackup Database Manager servic
e or daemon is running. Then, create a debug log directory for bpdbm, retry the
operation, and check the resulting debug log.
* If you can view the report and have not found an entry related to this pro
blem, create debug log directories for the related processes that were running w
hen the error first appeared (this process will frequently be bpbrm). Then, retr
y the operation and check the resulting debug logs.
2. Verify that the server list specifies the correct master server.
* On Windows systems, the master server is designated as CURRENT on the Serv
ers tab in the Specify NetBackup Machines and Policy Type dialog. To display thi
s dialog box, start the Backup, Archive, and Restore interface and click Specify
NetBackup Machines and Policy Type on the File menu.
* On UNIX, and Macintosh systems, the master server is the first SERVER entr
y in the bp.conf file.
* On NetWare target and OS/2 clients, the master server name is the first SE
RVER entry in the bp.ini file.
* Make sure all recommended NetBackup patches have been installed. Check the
VERITAS support web site for current patch information. (Go to www.support.veri
tas.com, then select "NetBackup" followed by "files and updates".)
* If failure occurs when executing a user-directed backup from a client, mak
e sure a user-directed backup schedule exists at the master server.
* When working with NetBackup database extensions, make sure that the applic
able database product has the correct permissions allowing NetBackup to write to
the progress log on the client.
* On UNIX systems, if bpdbm is dying when the shutdown script is executed on
a media server, carefully read the K77netbackup script (in /usr/openv/netbackup
/bin/goodies) for details on how to prevent this problem.
If you change the server list on a master server, stop and restart the NetBac
kup database manager and request daemons (UNIX) or the NetBackup Database Manage
r and NetBackup Request Manager services (Windows).
3. Check the services file.
On UNIX, verify that the /etc/services file (and NIS services if NIS is used)
has entries for the NetBackup services: bpcd, bpdbm, and bprd.
Run the NetBackup Configuration Validation Utility (NCVU) and note the servic
es port checks in section one. Note the NetBackup daemon running and listening c
heck and the bpps check in section three.
On Windows, verify that the %SystemRoot%\system32\drivers\etc\services file h
as the correct entries for bpcd, bpdbm, and bprd.
Also, verify that the NetBackup Client Service Port number and NetBackup Requ
est Service Port number on the Network tab in the NetBackup Client Properties di
alog match the settings in the services file. To display this dialog, start the
Backup, Archive, and Restore interface and click NetBackup Client Properties on
the File menu. The values on the Network tab are written to the services file wh
en the NetBackup Client service starts.
Also, see "Verifying Host Names and Services Entries" in the Troubleshooting
Guide.
4. On Sun Solaris, verify that all operating system patches are installed (see
the Operating Notes section of the NetBackup Release Notes).
5. On Windows, verify that the recommended service packs are installed.
6. When the base NetBackup license key expires, daemons (such as bprd and bpdbm
) will terminate on the NetBackup server. If these daemons are not running, you
are likely to encounter status code 25 errors in the Administration console. Ins
tall a valid base NetBackup license key, restart the daemons, and restart the co
nsole.
7. For NetBackup Advanced Client:
When many devices are configured on a media server, it may take a long time f
or the bptpcinfo command to generate the 3pc.conf file. When the backup is run f
or the first time, the backup may fail with status 25. Make sure that the /usr/o
penv/volmgr/database/3pc.conf file exists. If it does, rerun the backup. If the
backup fails again, run the bptpcinfo manually to generate the 3pc.conf file, th
en try the backup again.
8. Run the NetBackup Configuration Validation Utility (NCVU) on the master serv
er and clients. Note the name resolution checks in section seven and NCVU summar
y.
===============================================================
Error Number: 26
client/server handshaking failed
A process on the server encountered an error when communicating with the client.
This error indicates that the client and server were able to initiate communica
tions, but encountered difficulties in completing them. This problem can occur d
uring a backup or a restore.
Try the following:
Determine which activity encountered the handshake failure by examining the All
Log Entries report for the appropriate time period. Determine the client and ser
ver that had the handshake failure. For detailed troubleshooting information, cr
eate a debug log directory for the process that returned this status code, retry
the operation, and check the resulting debug log.
===============================================================
Error Number: 27
child process killed by signal
A child of the process reporting this error was killed. This can occur because t
he backup job was terminated or the child process was terminated by another erro
r. This problem can also occur if a NetBackup process was terminated through Tas
k Manager or another utility.
Try the following:
Check the NetBackup All Log Entries report for clues on where and why the failur
e occurred. For detailed troubleshooting information, create a debug log directo
ry for the process that you suspect of returning this status code. Then, retry t
he operation and check the resulting debug log.
===============================================================
Error Number: 28
failed trying to fork a process
A fork of a child process failed (on UNIX) or a CreateProcess failed (on Windows
). This may be due to:
* An overloaded system
* Insufficient swap space or physical memory
* Too many processes running on the system
Try the following:
Check the NetBackup All Log Entries report for clues on where and why the failur
e occurred. For detailed troubleshooting information, create debug log directori
es for the processes that you suspect of returning this status code. Then, retry
the operation and check the resulting debug logs.
===============================================================
Error Number: 29
failed trying to exec a command
A command could not be executed. This can occur because the permissions of the c
ommand do not allow it to be executed, or there is lack of system resources such
as memory and swap space.
Try the following:
1. Check the NetBackup All Log Entries report for clues on where and why the fa
ilure occurred.
2. Check the permissions on the command to be executed.
3. For detailed troubleshooting information, create a debug log directory for t
he process that returned this status code, retry the operation, and check the re
sulting debug log.
===============================================================
Error Number: 30
could not get passwd information
Could not get the passwd entry for a user.
Try the following:
Check the NetBackup All Log Entries report for clues on where and why the failur
e occurred. For detailed troubleshooting information, create a debug log for the
process that you suspect of returning this status code. Then, retry the operati
on and check the resulting debug log.
===============================================================
Error Number: 31
could not set user id for process
Could not set the user ID of a process to that of the requesting user. NetBackup
executes client processes as the requesting user.
Try the following:
Check the NetBackup All Log Entries report for clues on where and why the failur
e occurred. For detailed troubleshooting information, create a debug log directo
ry for the process that you suspect of returning this status code. Then, retry t
he operation and check the resulting debug log.
===============================================================
Error Number: 32
could not set group id for process
Could not set the group ID of a process to the requesting user group. NetBackup
executes client processes with the group ID of the requesting user.
Try the following:
Check the NetBackup All Log Entries report for clues on where and why the failur
e occurred. For detailed troubleshooting information, create a debug log directo
ry for the process that you suspect of returning this status code. Then, retry t
he operation and check the resulting debug log.
===============================================================
Error Number: 33
failed while trying to send mail
An E-mail notification of backup, archive, or restore results has failed. The E-
mail could not be sent to the administrator's address as specified by the E-mail
global attribute, or, in the case of a UNIX client, an E-mail address specified
with USEMAIL in the client's bp.conf file.
Try the following:
Check the NetBackup All Log Entries report for clues on where and why the failur
e occurred. For detailed troubleshooting information, create a debug log directo
ry for the process that you suspect of returning this status code. Then, retry t
he operation and check the resulting debug log.
===============================================================
Error Number: 34
failed waiting for child process
The bpsched process encountered a failure while waiting for a child process to c
omplete.
Try the following:
Check the NetBackup All Log Entries report for clues on where and why the failur
e occurred. For detailed troubleshooting information, create a debug log for the
process that you suspect of returning this status code. Then, retry the operati
on and check the resulting debug log.
===============================================================
Error Number: 35
cannot make required directory
Could not create a required directory. Possible causes are:
* A process does not have permission to create the directory
* The path to the directory is not valid
* An IO error occurs
* There was no space available on the device containing the directory
Try the following:
1. Check the NetBackup All Log Entries report to determine which directory coul
d not be created and why it could not be created. In particular, check for a ful
l disk partition.
2. Check the permissions on the parent directory and verify that NetBackup serv
ices are started with a "Logon as" account that has permission to create the dir
ectory.
3. For detailed troubleshooting information, create a debug log directory for t
he process that returned this status code, retry the operation, and check the re
sulting debug log.
===============================================================
Error Number: 36
failed trying to allocate memory
Allocation of system memory failed. This error occurs when there is insufficient
system memory available. This could be caused by the system being overloaded wi
th too many processes and there is not enough physical and virtual memory.
Try the following:
Free up memory by terminating unneeded processes that consume a lot of memory. A
dd more swap space or physical memory.
===============================================================
Error Number: 37
operation requested by an invalid server
A request was made to the NetBackup request daemon (bprd) or NetBackup database
manager daemon (bpdbm) by an invalid media server or Windows NetBackup Remote Ad
ministration Console. On Windows, these daemons are the NetBackup Request Manage
r and NetBackup Database Manager services.
Try the following:
Examine the NetBackup All Log Entries report for the time of this error to deter
mine which system was trying to connect to the master server. If the server is a
valid media server, verify that the storage unit for the media server is define
d. Also, verify that the server or Windows NetBackup Remote Administration Conso
le has a server list entry on the master server. If necessary, update the server
list. On a UNIX master server, add a SERVER = media_server_name to the bp.conf
file. media_server_name is the host name of the media server. On a Windows maste
r server, add the media server to the list on the Servers tab in the Master Serv
er Properties dialog (see "Using the Host Properties Window" in the Troubleshoot
ing Guide). If a server or Windows NetBackup Remote Administration Console has m
ore than one host name (for example, if it has multiple network interfaces), ver
ify that the master server has a server list entry for each of them. If you chan
ge the server list on a UNIX master server, you must stop and then restart the N
etBackup Request daemon (bprd) and NetBackup database manager daemon (bpdbm) for
the changes to take effect. If you change the server list on a Windows master s
erver, stop and then restart the NetBackup Request Manager and NetBackup Databas
e Manager services.Run the NetBackup Configuration Validation Utility (NCVU) med
ia server checks. Note the media server and storage unit checks in sections four
and five.
===============================================================
Error Number: 38
could not get group information
Could not get the group entry describing a UNIX user group.
Try the following:
Check the NetBackup Problems report for clues on why the error occurred. For det
ailed troubleshooting information, create a debug log directory for the process
that returned this status code, retry the operation, and check the resulting deb
ug log.
===============================================================
Error Number: 39
client name mismatch
The name that the client used in a request to the NetBackup server did not match
the client name configured in the policy on the server.
Try the following:
Change either the NetBackup client name setting on the client (see the applicabl
e NetBackup users guide) or the one in the policy configuration on the server so
the two match.Run the NetBackup Configuration Validation Utility (NCVU) -conf <
media server option> and -conf checks for the associated NetBack
up nodes. On the media server check, note the client configuration in the policy
checks in section five.
===============================================================
Error Number: 40
network connection broken
The connection between the client and the server was broken. This status code ca
n also appear if the connection is broken between the master and media server du
ring a backup.
Try the following:
1. Try pinging the client from the server. If this is not possible, check for l
oose connections or other network problems.
2. Verify that the server list settings are correct on both the client and the
server. If the backup involves a media server, verify that these entries are cor
rect on both the master and media server. For example, if a media server does no
t have a server list entry for the master, it does not accept connections from t
he master.
* On Windows, the master server is designated on the Servers tab in the Mast
er Server Properties dialog. To display this dialog, see "Using the Host Propert
ies Window" in the Troubleshooting Guide.
* On UNIX, and Macintosh systems, the master server is the first SERVER entr
y in the bp.conf file.
* On NetWare target and OS/2 clients the master server name is the first SER
VER entry in the bp.ini file.
If you change the server list on a UNIX master server, you must stop and then
restart the NetBackup Request daemon (bprd) and NetBackup database manager daem
on (bpdbm) for the changes to take effect. On Windows, stop and restart the NetB
ackup Request Manager and NetBackup Database Manager services.
3. Status code 40 can also be due to the operator denying a mount request.
4. Run the NetBackup Configuration Validation Utility (NCVU) -conf and -conf checks for the associated NetBackup nodes. N
ote the ping checks in section seven.
===============================================================
Error Number: 41
network connection timed out
The server did not receive any information from the client for too long a period
of time.
Try the following:
1. On UNIX or Windows clients, check for the following problems with the bpbkar
client process.
On Windows clients: The bpbkar client process is not hung, but due to the fil
es and directories it is scanning, it has not replied to the server within the C
lient read timeout or Client connect timeout period. This has been seen to occur
during incremental backups when directories have thousands of unmodified files.
For this case, use Host Properties on the NetBackup server to change Client c
onnect timeout or Client read timeout. These settings are on the Timeouts and Un
iversal Settings tabs, respectively, in the Master Server Properties dialog (see
"Using the Host Properties Window" in the Troubleshooting Guide). The default f
or these timeouts is 300 seconds.
You can also monitor CPU utilization to determine if this condition exists.
On UNIX clients:
* The bpbkar client process is hung on a file that has mandatory locking set
. For this case, add the following to the client's bp.conf file:
VERBOSE
and as root on the client execute:
touch /usr/openv/netbackup/bpbkar_path_tr
mkdir /usr/openv/netbackup/logs/bpbkar
Then retry the operation. The names of the files are logged in the debug log
file in the /usr/openv/netbackup/logs/bpbkar directory before bpbkar processes t
hem. The last file in the log will be the file that is causing problems.
Note: Also, use the above procedure for other, "unknown" bpbkar hangs.
If the problem is due to mandatory file locking, you can have NetBackup skip
the locked files by setting LOCKED_FILE_ACTION to SKIP in the /usr/openv/netback
up/bp.conf file on the client.
* The bpbkar client process is not hung, but due to the files and directorie
s it is scanning, it has not replied to the server within CLIENT_READ_TIMEOUT or
CLIENT_CONNECT_TIMEOUT. This has been seen to occur during backups when directo
ries have thousands of unmodified files, or during restores of sparse files that
have thousands of holes; it has also been seen when backing up file systems or
directories that reside on optical disk, which is considerably slower than magne
tic disk.
For this case, try adding or modifying the CLIENT_READ_TIMEOUT and CLIENT_CON
NECT_TIMEOUT values in the server's /usr/openv/netbackup/bp.conf file. The defau
lt for the CLIENT_READ_TIMEOUT and CLIENT_CONNECT_TIMEOUT is 300 seconds if unsp
ecified.
Use your system's ps command and monitor CPU utilization to help decide which
of the above conditions exist.
When you are through investigating the problem, delete the /usr/openv/netback
up/logs/bpbkar directory, since the log files can become quite large and are not
deleted automatically. Also delete /usr/openv/netbackup/bpbkar_path_tr so you d
o not generate larger log files than needed the next time you create directory /
usr/openv/netbackup/logs/bpbkar.
2. On Windows systems, try the following:
* Disable the following file:
install_path\VERITAS\NetBackup\bin\tracker.exe
* Repair hard drive fragmentation. You could try an application called Diske
eper Lite, which is part of the Windows NT Resource Kit.
* Make sure there is enough space available in \temp.
3. If the server cannot connect to the client, create bpcd or bpbkar (UNIX and
Windows only) debug log directories on the client, retry the operation, and chec
k the resulting logs. If these logs do not provide a clue, create a bpbrm debug
log on the server, retry the operation again, and check the resulting debug log.
If the bpbrm log has entries similar to the following:
bpbrm hookup_timeout: timed out waiting during the client hookup
bpbrm Exit: client backup EXIT STATUS 41: network connection timed out
then the problem is in the routing configuration on the server.
Verify that the client IP address is correct in the name service that is bein
g used. On UNIX, if both NIS and DNS files are used, verify that they match.
Also, see "Resolving Network Communication Problems" in the Troubleshooting G
uide.
4. If you are using an AIX token ring adapter and the routed daemon is running,
the timeout can occur because the token ring adapter creates dynamic routes, ca
using the routed daemon to crash.
5. For a FlashBackup client, this can happen if the file system being backed up
is very large and has a very large number of files. It can also occur if a larg
e number of concurrent data streams are active at the same time. The corrective
action is to add CLIENT_READ_TIMEOUT to the /usr/openv/netbackup/bp.conf file an
d set it to increase the timeout interval.
6. Make sure all recommended NetBackup patches have been installed. Check the V
ERITAS support web site for current patch information. (Go to www.support.verita
s.com, then select "NetBackup" followed by "files and updates".)
Run the NetBackup Configuration Validation Utility (NCVU) for the associated
NetBackup nodes. Note the pack checks in section two.
7. Add the CLIENT_READ_TIMEOUT values to the master server, media server and cl
ient when a NetBackup database extension product is installed. The values should
all be the same for each server. The value set is dependent on the size of the
database being backed up. See the NetBackup System Administrator's Guide for mor
e information on CLIENT_READ_TIMEOUT.
8. Make sure enhanced authentication is configured correctly. See the chapter o
n enhanced authentication in the NetBackup System Administrator's Guide.
For example, the following could result in status code 41: host A is configur
ed to use enhanced authentication with host B, but host B is not configured to u
se enhanced authentication with host A. In this case, connections from host B to
host A are likely to fail with status code 41. Connections from host A to B are
likely to fail with authentication errors (status code 160).
===============================================================
Error Number: 42
network read failed
An attempt to read data from a socket failed.
Try the following:
1. Verify that both the client and the server are operational.
2. Perform "Resolving Network Communication Problems" in the Troubleshooting Gu
ide.
3. Check the Problems report for clues.
===============================================================
Error Number: 43
unexpected message received
The client and server handshaking was not correct.
Try the following:
1. Verify that the correct version of software is running on the client and the
server.
2. Enable detailed debug logging:
* On the server, create a bpbrm debug log directory.
* On clients, create a bpcd debug log directory (created automatically on Ma
cintosh clients).
* Increase the amount of debug information included in the logs as explained
in the debug log topics in Chapter 3 of the Troubleshooting Guide.
3. Retry the operation and examine the logs.
Note: If you are using bpstart_notify scripts on UNIX or Windows clients, verify
that messages are not being written to stdout or stderr.
===============================================================
Error Number: 44
network write failed
An attempt to write data to a socket failed.
Try the following:
1. Check the Problems report for information about the error.
2. Verify that the client and servers are operational and connected to the netw
ork.
3. Create a debug log directory for the process that reported the problem and t
he operation. Examine the resulting debug log file for detailed troubleshooting
information.
4. Perform "Resolving Network Communication Problems" in the Troubleshooting Gu
ide.
===============================================================
Error Number: 45
request attempted on a non reserved port
An attempt was made to access a client from a nonreserved port.
Try the following:
Verify that the latest software is installed on the client and server.
* On UNIX NetBackup servers and clients, check the /usr/openv/netbackup/bin/ver
sion file.
* Run the NetBackup Configuration Validation Utility (NCVU) for the associated
NetBackup clients. Note the client software checks in section two.
* On Windows NetBackup servers, check the install_path\netbackup\version.txt fi
le or the About NetBackup item on the Help menu.
* On Microsoft Windows clients, check the About NetBackup item on the Help menu
.
* On NetWare target clients, check the Version entry in the bp.ini file.
* If this is a NetBackup for NetWare client and has a version of NetBackup earl
ier than 3.0, verify that the client is in a Standard type policy.
* On Macintosh clients, check the version file in the bin folder in the NetBack
up folder in the Preferences folder.
===============================================================
Error Number: 46
server not allowed access
The server is trying to access a client but access is blocked. Possible causes a
re:
* The server is not listed on the client as a valid server.
* The client has been configured to require encrypted backups, but the encrypti
on attribute for the backup policy on the server has not been selected.
* The evaluation license for the NetBackup Encryption product has expired on th
e server, but the NetBackup client has been configured to require encrypted back
ups. As a result, the server attempted to make a non-encrypted backup of the cli
ent; since the client is configured to require encryption, the backup failed.
Try the following:
* If the server is a valid server but is not listed on the client, add its name
to the client's server list:
* On Windows clients, add the server on the Servers tab in the Specify NetBa
ckup Machines and Policy Type dialog box. To display this dialog box, start the
Backup, Archive, and Restore interface on the client and click Specify NetBackup
Machines and Policy Type on the File menu.
* On UNIX and Macintosh clients, add a SERVER entry in the bp.conf file.
* On NetWare target and OS/2 clients, add a SERVER entry in the bp.ini file.
If you continue to have problems, review "Resolving Network Communication Pro
blems" in the Troubleshooting Guideand "Verifying Host Names and Services Entrie
s" in the Troubleshooting Guide.
* To make non-encrypted backups of the client, set CRYPT_OPTION on the client t
o allowed or denied. For more information, refer to the NetBackup Encryption Sys
tem Administrator's Guide.
* If the NetBackup encryption evaluation license has expired on the server and
you want to continue encrypting backups of the client, you must purchase a perma
nent encryption license key and add it to the server. After you add the permanen
t encryption license key, check the attributes of the backup policy to make sure
that encryption is selected.
To check the validity of an evaluation license key, do the following:
On Windows: go to the Help menu on the NetBackup Administration window on the
NetBackup server and select License Keys. If the evaluation key is not listed i
n the NetBackup License Keys window, the key has expired. Use this window to add
the new permanent encryption key.
On UNIX: use the /usr/openv/netbackup/bin/admincmd/get_license_key command on
the server. Select option f to list the active license keys and features. If th
e evaluation key is not listed, the key has expired. Use this command to add the
new permanent encryption key.
===============================================================
Error Number: 47
host is unreachable
An attempt to connect to another machine failed.
Try the following:
1. Verify that the name service (or services) being used by the client is confi
gured to correctly resolve the host names of the NetBackup server.
2. Verify that the name service (or services) being used by the server is confi
gured to correctly resolve the host name of the NetBackup client.
3. Try to ping the client from the server and the server from the client.
4. If you continue to have problems, perform "Resolving Network Communication P
roblems" in the Troubleshooting Guide.
5. Run the NetBackup Configuration Validation Utility (NCVU) for the associated
NetBackup nodes. Note the hostname checks in sections four and seven.
===============================================================
Error Number: 48
client hostname could not be found
The system function gethostbyname() failed to find the client's host name.
Try the following:
1. Verify that the client name is correct in:
* The NetBackup policy configuration on the master server.
* The General tab in the NetBackup Client Properties dialog box and the Clie
nts tab in the Specify NetBackup Machines and Policy Type dialog box (on Microso
ft Windows and NetWare nontarget clients). To display these dialog boxes, start
the Backup, Archive, and Restore interface on the client. For the General tab, c
lick NetBackup Client Properties on the File menu; for Clients tab, click Specif
y NetBackup Machines and Policy Type on the File menu.
* The bp.conf file on UNIX and Macintosh clients.
* The bp.ini file on OS/2 and NetWare target clients.
2. On clients and servers, verify that the name service is set up to correctly
resolve the NetBackup client names.
On UNIX clients, verify that the client's host name is in the /etc/hosts file
or the YP hosts file or NIS maps.
3. For the NetBackup policy configuration, run the NetBackup Configuration Vali
dation Utility (NCVU) -conf and note the policy checks in
section five. For the client hostname, note the hostname checks in sections four
and seven.
===============================================================
Error Number: 49
client did not start
The client failed to start up correctly.
Try the following:
1. Verify that software is installed on the client and it is the correct versio
n. If necessary, reinstall the client software.
2. Check for full file systems on the client.
3. Enable detailed debug logging on the client:
* Create bpcd and bpbkar (UNIX or Windows only) debug log directories.
* On a UNIX client, add the VERBOSE option to the /usr/openv/netbackup/bp.co
nf file.
* On PC clients, increase the debug or log level as explained in the debug l
og topics in Chapter 3 of the Troubleshooting Guide.
4. Retry the operation and examine the resulting logs.
5. On UNIX systems, use the UNIX sum command to check for corrupt binaries.
===============================================================
Error Number: 50
client process aborted
The client backup aborted. One instance when this code appears is if a NetBackup
master or media server is shut down or rebooted when a backup or restore is in
process.
Try the following:
1. Enable detailed debug logging:
* Create a bpbkar debug log directory (UNIX or Windows only).
* Create a bpcd debug log directory (this log is created automatically on Ma
cintosh clients.)
* On UNIX clients, add the VERBOSE option to the /usr/openv/netbackup/bp.con
f file.
* On PC clients, increase the debug or log level as explained in the debug l
og topics in Chapter 3 of the Troubleshooting Guide.
2. Retry the operation and examine the resulting logs.
3. On UNIX clients, check for core files in the / directory.
4. On UNIX clients, check the system log (/usr/adm/messages on Solaris) for sys
tem problems.
5. This problem can sometimes be due to a corrupt binary.
On UNIX clients, use the UNIX sum command to check the bpcd, bpbkar, and tar
binaries, located in /usr/openv/netbackup/bin on the client. Reinstall them if t
hey are not the same as in the client directory under /usr/openv/netbackup/clien
t on the server.
Run the NetBackup Configuration Validation Utility (NCVU) for the associated
NetBackup clients. Note the client software checks in section two.
On a Windows client, check the bpinetd.exe, bpcd.exe, bpbkar32.exe, and tar32
.exe executables located in the install_path\NetBackup\bin folder on the client.
Reinstall the client if these executables are not the same size as on other Win
dows clients or are not at the same release level or do not have the same NetBac
kup patches applied as other Windows clients.
===============================================================
Error Number: 51
timed out waiting for database information
The catalog process did not respond within five minutes.
Try the following:
1. Verify that the NetBackup Database Manager service or daemon is running.
2. Verify that there is space in the file system that contains the NetBackup ca
talogs.
3. Create bpbrm and bpdbm debug log directories on the server and retry the ope
ration.
4. Look in the debug log files to find more information on the problem.
===============================================================
Error Number: 52
timed out waiting for media manager to mount volume
The requested volume was not mounted before the timeout expired. This error can
also occur if the volume happens to be a cleaning tape but was not specified as
a cleaning tape. Another possible cause: if the last available drive has a mount
request for a non-backup (such as a restore), then a backup requiring the same
drive is initiated before the mount completes. This is due to the drive not bein
g reported as busy until the mount completes.
Try the following:
1. Verify that the requested volume is available and an appropriate drive is re
ady and in the UP state.
2. If this occurs during a read operation (restore, duplicate, verify), the dri
ves could be busy. Try increasing the media mount timeout specified by the NetBa
ckup global attribute in order to allow more time for mounting and positioning t
he media.
3. Verify that the tape is not a cleaning tape that is configured as a regular
volume.
4. When the robot is controlled by an Automated Cartridge System, verify that t
he ACSLS system is up.
5. If this is an initial installation, refer to "To Resolve Common Configuratio
n Problems" in the Troubleshooting Guide.
6. On Windows, check the Event Viewer Application log for error messages that i
ndicate why the tape mount did not complete. On UNIX, check the system log.
===============================================================
Error Number: 53
backup restore manager failed to read the file list
The backup and restore manager (bpbrm) could not read the list of files to back
up or restore.
Try the following:
Verify that the server software has been installed correctly on all NetBackup se
rvers. If that is not the problem:
1. Create bpbrm and bpsched debug log directories on the server.
2. On a UNIX NetBackup server, add the VERBOSE option to the bp.conf file. On a
Windows NetBackup server, set the Verbose logging level option on the Logging t
ab in the Master Server Properties dialog. To display this dialog, see "Using th
e Host Properties Window" in the Troubleshooting Guide.
3. Retry the operation and check the resulting debug logs for detailed troubles
hooting information.
===============================================================
Error Number: 54
timed out connecting to client
The server could not complete the connection to the client. The accept system or
winsock call timed out after 60 seconds.
Try the following:
1. For a Macintosh or NetWare target client, verify that the server is not tryi
ng to connect when a backup or restore is already in progress on the client. The
se clients can handle only one NetBackup job at a time.
On a Macintosh, you can check for activity by examining the NetBackupListen f
ile in the following folder on the startup disk of the Macintosh client:
:System Folder:Preferences:NetBackup:logs:inetd:log.mmddyy
2. On a Sequent platform, verify that the system has the correct level of TCP/I
P.
3. Perform "Resolving Network Communication Problems" in the Troubleshooting Gu
ide.
4. On UNIX clients, verify that the /usr/openv/netbackup/bin/bpcd binary exists
and that it is the correct size.
5. Check the /etc/inetd.conf file to make sure the bpcd path is correct in the
following entry:
bpcd stream tcp nowait root /usr/openv/netbackup/bin/bpcd bpcd
6. On systems that include NetBackup master, media, and clients (with NetBackup
database extension products installed on one or more clients), make sure the cl
ient name is in the master's /etc/hosts file.
7. Run the NetBackup Configuration Validation Utility (NCVU) for the associated
NetBackup nodes. Note the bpcd checks in sections one and three.
===============================================================
Error Number: 55
permission denied by client during rcmd
The UNIX client does not have the server's name in its /.rhosts file.
Try the following:
Add the server name to the /.rhosts file on the UNIX client.
===============================================================
Error Number: 56
client's network is unreachable
An error was returned that the host was unreachable by the client (WSAENETUNREAC
H on Windows systems, or ENETUNREACH on UNIX systems) when performing a system c
all.
Try the following:
Try to ping the client from the server. Check the IP address for the client. If
you still have problems, talk to your network administrator.Run the NetBackup Co
nfiguration Validation Utility (NCVU) -conf and -conf checks for the associated NetBackup nodes. Note the ping checks in s
ection seven.
===============================================================
Error Number: 57
client connection refused
The client refused a connection on the port number for bpcd. This can occur beca
use there is no process listening on the bpcd port or there are more connections
to the bpcd port than the network subsystem can handle with the listen() call.
Try the following:
1. For Windows NetBackup servers:
a. Make sure the NetBackup client software is installed.
b. Verify that the bpcd and bprd port numbers in the %SystemRoot%\system32\d
rivers\etc\services file on the server matches the setting on the client.
c. Verify that the NetBackup Client Service Port number and NetBackup Reques
t Service Port number on the Network tab in the NetBackup Client Properties dial
og match the bpcd and bprd settings in the services file. To display this dialog
, start the Backup, Archive, and Restore interface on the server and click NetBa
ckup Client Properties on the File menu.
The values on the Network tab are written to the services file when the NetBa
ckup Client service starts.
d. Verify that the NetBackup client service is running.
e. Use the following command to see if the master server returns correct inf
ormation for the client:
install_path\VERITAS\NetBackup\bin\bpclntcmd -pn
2. For UNIX servers:
a. Make sure the NetBackup client software is installed.
b. Verify that the bpcd port number on the server (either NIS services map o
r in /etc/services) matches the number in the client's services file.
c. Run the NetBackup Configuration Validation Utility (NCVU) for the associa
ted NetBackup nodes. Note the NetBackup services port number checks in section o
ne.
3. For a Macintosh or NetWare target client, verify that the server is not tryi
ng to connect when a backup or restore is already in progress on the client. The
se clients can handle only one NetBackup job at a time.
4. Perform "Resolving Network Communication Problems" in the Troubleshooting Gu
ide.
===============================================================
Error Number: 58
can't connect to client
The server was unable to connect to the client.
Try the following:
Perform "Resolving Network Communication Problems" in the Troubleshooting Guide.
Run the NetBackup Configuration Validation Utility (NCVU) for the associated Net
Backup nodes. Note the NetBackup services port number, bpcd, and services checks
in section one, and the bpcd checks in section three.
===============================================================
Error Number: 59
access to the client was not allowed
The master or media server is trying to access the client, but the server is not
recognized by the client as a valid server.
Try the following:
1. If the server is a valid server, verify that it is in the server list on the
client. If necessary add it as follows:
* On Windows clients, add the server on the Servers tab in the Specify NetBa
ckup Machines and Policy Type dialog box. To display this dialog, start the Back
up, Archive, and Restore interface on the client and click Specify NetBackup Mac
hines and Policy Type on the File menu.
* On UNIX, and Macintosh clients, add a SERVER entry in the bp.conf file.
* On NetWare target and OS/2 clients add a SERVER entry in the bp.ini file.
If you change the server list on a UNIX master server, you must stop and then
restart the NetBackup Request daemon (bprd) and NetBackup database manager daem
on (bpdbm) for the changes to take effect. On Windows, stop and restart the NetB
ackup Request Manager and NetBackup Database Manager services.
2. On Windows clients, enable bpinetd debug logging as follows:
a. Create a bpinetd debug log directory on the client.
b. Increase the debug or log level as explained in the debug log topics in C
hapter 3 of the Troubleshooting Guide.
c. Retry the backup and examine the resulting logs to determine the cause of
the failure.
3. On all clients, enable bpcd debug logging as follows:
a. Create a bpcd debug log directory on the client.
b. On a UNIX client, add the VERBOSE option to the /usr/openv/netbackup/bp.c
onf file.
c. On PC clients, increase the debug or log level as explained in the debug
log topics in Chapter 3 of the Troubleshooting Guide.
d. Retry the backup and examine the resulting logs to determine the cause of
the failure.
4. Check the bpcd debug log to determine the server's peername and what compari
sons are being made.
The bpcd process compares NetBackup server list entries to the peername of th
e server attempting the connection and rejects the connection if the names are d
ifferent. If necessary, change the server list entry on the client to match the
peername.
5. On Windows clients, check the following:
* Verify that NetBackup for Windows software was installed under a Windows a
dministrator account.
If NetBackup is under another type of account, reinstall it under an administ
rator account. The installation will complete successfully under a non-administr
ator account but the NetBackup Client service is not added to Windows and the Ne
tBackup server cannot access the client.
* Verify that the Windows TCP/IP service specifies the domain server that re
solves names for the subnet that contains the NetBackup servers.
UNIX and Windows clients are frequently not on the same subnet and use differ
ent domain servers. When this condition exists the NetBackup servers and Windows
clients may be able to ping one another, but the server is still unable to acce
ss the Windows client.
6. If the preceding steps do not resolve this problem, see "Resolving Network C
ommunication Problems" in the Troubleshooting Guide.
7. If NetBackup is using multiple network interfaces with media servers, make s
ure the interface names appear in the client's /usr/openv/netbackup/bp.conf file
.
8. Run the NetBackup Configuration Validation Utility (NCVU) for the associated
NetBackup clients. Note the media server checks in sections four and seven.
===============================================================
Error Number: 60
client cannot read the mount table
The backup process on the client could not read the list of mounted file systems
.
Try the following:
1. Execute a df to see if the system can read the mount table.
2. On an SCO system, code 60 can occur because the mount-point path name exceed
s 31 characters, which is the maximum allowed on an SCO system. The bpbkar debug
log on the client will show a message similar to the following:
bpbkar build_nfs_list: FTL - cannot statfs net Errno: 42406
To eliminate these errors for future backups, create a mount point with a sho
rter name and symbolically link the long name to the short name.
3. For detailed troubleshooting information, create a bpbkar debug log director
y, retry the operation, and examine the resulting log.
===============================================================
Error Number: 61
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 62
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 63
process was killed by a signal
A kill signal was sent to the client process.
Try the following:
This is usually caused by someone intentionally terminating a backup.
===============================================================
Error Number: 64
timed out waiting for the client backup to start
The client did not send a ready message to the server within the allotted time.
Try the following:
1. On all clients, enable bpcd debug logging as follows:
a. Create a bpcd debug log directory on the client.
b. On a UNIX client, add the VERBOSE option to the /usr/openv/netbackup/bp.c
onf file.
c. On PC clients, increase the debug or log level as explained in the debug
log topics in Chapter 3 of the Troubleshooting Guide.
2. On a UNIX or Windows client, create the bpbkar debug log directory on the cl
ient.
3. On Windows clients, verify that the NetBackup Client service is running.
4. On a UNIX client, use the ps command to check for a client process that is u
sing too much CPU time.
5. Retry the backup and examine the debug logs for clues on the cause of the fa
ilure.
===============================================================
Error Number: 65
client timed out waiting for the continue message from the media manager
The tape manager, bptm reported that the media did not load and position within
the allotted time.
Try the following:
Verify that the requested volume is available and the required device is in an U
P state.For detailed debug information:
1. Create a bptm debug log directory on the server.
2. On a UNIX NetBackup server, add the VERBOSE option to the bp.conf file. On a
Windows NetBackup server, set the Verbose logging level option on the Logging t
ab in the Master Server Properties dialog (see "Using the Host Properties Window
" in the Troubleshooting Guide).
3. Retry the operation and check the bptm debug log file for information on the
drive, robot, and tape that is causing the timeout.
4. On a Windows NetBackup server (master or media), check the Event Viewer Appl
ication log for error messages that indicate why the tape mount did not complete
.
===============================================================
Error Number: 66
client backup failed to receive the CONTINUE BACKUP message
The client bpbkar process did not receive the message from the server that indic
ates that the server is ready to continue.
Try the following:
Verify that the server did not crash. If that is not the problem and you need mo
re information:
1. On UNIX and Windows clients, enable bpbkar debug logging.
a. Create a bpbkar debug log directory.
b. On a UNIX client, add the VERBOSE option to the bp.conf file. On a Window
s client, set Verbose on the TroubleShooting tab in the NetBackup Client Propert
ies dialog box. To display this dialog box, start the Backup, Archive, and Resto
re interface on the client and select NetBackup Client Properties from the File
menu.
2. On other PC clients except Macintosh, create a debug log directory for bpcd
(the bpcd log is created automatically on Macintosh).
To increase the amount of information that appears in the logs, see the loggi
ng topics in Chapter 3 of the Troubleshooting Guide.
3. On the master server create bpsched and bpbrm debug log directories. If ther
e are media servers involved, create a bpbrm debug log directory on them.
4. Retry the operation and check the resulting debug logs.
===============================================================
Error Number: 67
client backup failed to read the file list
The client could not read the list of files to back up.
Try the following:
First, verify that the server did not crash. If that is not the problem and you
need more information:
1. Set up debug logging:
a. On the server, create a bpbrm debug log directory.
b. On UNIX and Windows clients, create a bpbkar debug log directory.
c. On other PC clients except Macintosh, create a debug log directory for bp
cd (the bpcd log is created automatically on Macintosh).
To increase the amount of information that appears in the logs, see the loggi
ng topics in Chapter 3 of the Troubleshooting Guide.
2. Retry the operation and check the resulting debug logs.
===============================================================
Error Number: 68
client timed out waiting for the file list
The client did not receive the list of files to back up within the allotted time
. This list comes from the server.
Try the following:
First, verify that the server did not crash. If that is not the problem and you
need more information:
1. Set up debug logging:
a. On the server, create a debug log directory for bpbrm.
b. On UNIX and Windows clients, create a bpbkar debug log directory.
c. On other PC clients except Macintosh, create a debug log directory for bp
cd (the bpcd log is created automatically on Macintosh).
To increase the amount of information that appears in the logs, see the loggi
ng topics in Chapter 3 of the Troubleshooting Guide.
2. Retry the operation and check the resulting debug logs.
===============================================================
Error Number: 69
invalid filelist specification
The file list received from the server had invalid entries.
Try the following:
1. Check the policy file list. If wildcards are used, verify there are matching
bracket characters ([ and ]). If the file list contains UNC (Universal Naming C
onvention) names, ensure they are properly formatted.
2. For NetBackup Advanced Client only:
If this was an offhost backup (NetBackup Media Server or Third-Party Copy Dev
ice), code 69 may indicate that the file list contains the ALL_LOCAL_DRIVES entr
y. NetBackup does not support the ALL_LOCAL_DRIVES entry for offhost backup. Rem
ove the ALL_LOCAL_DRIVES entry from the file list.
===============================================================
Error Number: 70
an entry in the filelist expanded to too many characters
The wildcards used in one of the file list entries caused too many files to be s
pecified.
Try the following:
Change the wildcards in the file list to specify fewer files.
===============================================================
Error Number: 71
none of the files in the file list exist
The files in the file list did not match any of the files on the client. This er
ror can occur when there is only one file in the file list and the file cannot b
e backed up due to an I/O error.
Try the following:
1. Verify that the correct file list is specified for this client.
2. On Windows clients, verify that the account used to start the NetBackup Clie
nt service has read access to the files.
If you are backing up a network drive or a UNC (universal naming convention)
path, use the Services application in the Windows Control Panel to verify that t
he NetBackup Client service does not start under the SYSTEM account. The SYSTEM
account cannot access network drives.
To back up network drives or UNC paths, change the NetBackup Client service s
tartup to log in as a user that has permission to access network drives.
3. Check the All Log Entries report for clues.
4. Set up debug logging:
* On UNIX and Windows clients, create a debug log directory for bpbkar.
* On other PC clients except Macintosh, create a debug log directory for bpc
d (the bpcd log is created automatically on Macintosh).
To increase the amount of information that appears in the logs, see the loggi
ng topics in Chapter 3 of the Troubleshooting Guide.
5. Retry the operation and check the resulting debug logs.
6. On Novell systems, check the following:
* For the nontarget version of NetBackup for NetWare, the backup policy type
must be "NetWare", and the files list should include a forward slash (/) only.
There should be nothing else in the files list.
To check the policy type and files list, start Backup Policy Management and r
ight-click the name of a policy. Click the Attributes tab to check the policy ty
pe; click the Files tab to check the contents of the files list.
* For the target version, the backup policy type must be "Standard", and the
policy files list must be formatted as follows:
/target_name
where a forward slash precedes the variable target_name.
To check the policy type and files list, start Backup Policy Management and r
ight-click the name of a policy. Click the Attributes tab to check the policy ty
pe; click the Files tab to check the contents of the files list.
Note: For the target version, the following NetWare message may be another indic
ator of incorrect policy type (this message would appear in the Novell client's
bpcd log):
unable to connect to service, scheduled access not specified
Make sure the policy type is set to "Standard".
* For either the target or nontarget version of NetBackup for NetWare, make
sure that the NetWare loadable modules (NLMs) SMDR and TSAxxx (such as TSA500, T
SA600, and TSANDS) are all at the same version. If they are not at the same vers
ion, status 71 may occur.
===============================================================
Error Number: 72
the client type is incorrect in the configuration database
The policy type attribute in the policy configuration indicates that the client
is one type, but the installed software is for another type.
Try the following:
Verify that the policy type attribute for the policy is correct.Run the NetBacku
p Configuration Validation Utility (NCVU) for the associated NetBackup clients.
Note the client software checks in section two.
===============================================================
Error Number: 73
bpstart_notify failed
The bpstart_notify script returned a nonzero exit code.
Try the following:
Check the bpstart_notify script on the client to see if it performs as desired.
===============================================================
Error Number: 74
client timed out waiting for bpstart_notify to complete
The bpstart_notify script on the client took too long.
Try the following:
Try to speed up the bpstart_notify script or set the BPSTART_TIMEOUT on the serv
er to a value that is larger than the default. Set BPSTART_TIMEOUT in the bp.con
f file on a UNIX NetBackup server. On a Windows NetBackup server, use Host Prope
rties to set Backup Start Notify Timeout (see "Using the Host Properties Window"
in the Troubleshooting Guide).
===============================================================
Error Number: 75
client timed out waiting for bpend_notify to complete
The bpend_notify script on the client took too long.
Try the following:
Try to speed up the bpend_notify script or set BPEND_TIMEOUT on the server to a
value that is larger than the default. Set BPEND_TIMEOUT in the bp.conf file on
a UNIX NetBackup server. On a Windows NetBackup server, use Host Properties to s
et Backup End Notify Timeout.
===============================================================
Error Number: 76
client timed out reading file
A fifo was specified in the file list and no data was produced on the fifo withi
n the allotted time.
Try the following:
Make sure that the process that is to produce the data on the named fifo is star
ted correctly. Add an entry to the /usr/openv/netbackup/bp.conf file on the serv
er to set CLLIENT_READ_TIMEOUT to a larger value than the default.
===============================================================
Error Number: 77
execution of the specified system command returned a nonzero status
An immediate command returned a nonzero status.
Try the following:
1. Verify that the command is specified correctly.
2. For NetBackup Advanced Client only:
The policy file list may contain files that do not reside within a file syste
m that was designated as the snapshot source. For a snapshot method to be applie
d to the backup of individual files, the snapshot source must be a file system (
not a raw partition or Volume Manager volume) and the files in the policy file l
ist must reside within that file system.
3. Execute the command manually to see if the desired result is produced.
4. For detailed troubleshooting information, set up debug logging:
a. On UNIX and Windows clients, create a debug log directory for bpbkar.
b. On other PC clients except Macintosh, create a debug log directory for bp
cd (the bpcd log is created automatically on Macintosh).
To increase the amount of information that appears in the logs, see the loggi
ng topics in Chapter 3 of the Troubleshooting Guide.
c. Retry the operation and check the resulting debug log.
===============================================================
Error Number: 78
afs/dfs command failed
Indicates an AFS vos command failure.
Try the following:
1. Check the NetBackup Problems Report for additional information on why the co
mmand failed.
2. The bpbkar debug log shows the command that was executed. Create a debug log
directory for bpbkar. Retry the operation and retry the resulting debug log.
3. Try executing the vos command manually to duplicate the problem.
===============================================================
Error Number: 79
unsupported image format for the requested database query
Possible causes are: the images to be synthesized have been generated using an a
scii catalog, were generated for a pre-5.0 client, were generated on a pre-5.0 m
aster server, or one or more of the images to be synthesized has been encrypted.
These images cannot be synthesized.
Try the following:
* Ensure that NetBackup is configured to use a binary catalog.
* Ensure that none of the images has been encrypted.
* Upgrade the client to NetBackup 5.0 or later. Regenerate the full and increme
ntal images on the 5.0 or later master server using the binary catalog. Rerun th
e synthetic backup job.
===============================================================
Error Number: 80
Media Manager device daemon (ltid) is not active
If the server is UNIX, the Media Manager device daemon, ltid, is not running. If
the server is Windows, the NetBackup Device Manager service is not running.
Try the following:
1. On Windows, use the Activity Monitor or the Services application in the Wind
ows Control Panel to see if the NetBackup Device Manager service is running. If
it is not running, start it. To enable verbose logging, place VERBOSE on a line
by itself in the install_path\Volmgr\vm.conf file before starting the service.
2. On UNIX, use vmps to see if ltid is running and if necessary start it in ver
bose mode with the following command:
/usr/openv/volmgr/bin/ltid -v
Or, add a VERBOSE entry to the Media Manager configuration file, /usr/openv/v
olmgr/vm.conf. Create the vm.conf file if necessary.
3. On UNIX, check the system logs to verify that ltid starts.
Note: On UNIX systems, ltid, and on Windows systems, the NetBackup Device Manage
r service, is used only if devices are attached to the system.
===============================================================
Error Number: 81
Media Manager volume daemon (vmd) is not active
The tape manager (bptm) could not communicate with the NetBackup Volume Manager
service (Windows) or the Media Manager volume daemon (UNIX). This communication
is required for most operations.
Try the following:
On UNIX, verify that the Media Manager device daemon (ltid) and the volume daemo
n (vmd) are running. Start them if necessary. On Windows, verify that both the N
etBackup Device Manager service and the NetBackup Volume Manager service are run
ning. Start them if necessary.
Note: ltid or the NetBackup Device Manager service is used only if devices are a
ttached to the system.
===============================================================
Error Number: 82
media manager killed by signal
The tape manager (bptm) or disk manager (bpdm) was terminated by another process
or a user.
Try the following:
This should not occur in normal operation. If you want to terminate an active ba
ckup, use the NetBackup Activity Monitor.
* When backing up a DomainOS client this error has occurred after the server ha
s not received anything on the socket for at least 300 seconds, thus causing a c
lient read timeout and breaking the connection. The bpbkar debug log had an entr
y similar to the following:
13:22:49 [1347] <16> bpbkar: ERR - Extra output - - ECONNRESET
Connection reset by peer (UNIX/errno status)
Increasing the CLIENT_READ_TIMEOUT value (in this instance to 900) has resolv
ed this problem.
===============================================================
Error Number: 83
media open error
The tape manager (bptm) or disk manager (bpdm) could not open the device or file
that the backup or restore must use.
Try the following:
1. For additional information, check the following:
* NetBackup Problems report
* System log (UNIX)
* Event Viewer Application log (Windows)
2. Typically, this status code indicates a drive configuration problem that all
ows more than one process at a time to open the device.
On UNIX, the problem could be due to:
* Two (or more) devices were configured that are really the same physical de
vice (for different densities perhaps). Verify that none of the /dev files used
for these devices have the same major or minor numbers.
* Links exist in the file system that are allowing users access to the drive
s.
* The configuration for the drives was modified (in the administrator interf
ace or vm.conf) and the Media Manager device daemon, ltid, was not restarted. Ve
rify the configuration and start ltid.
On Windows, the problem could be that the Media Manager device configuration
was modified but the NetBackup Device Manager service was not restarted. Verify
the configuration and restart the NetBackup Device Manager service.
3. Make sure the tapes are not write protected.
4. For detailed troubleshooting information:
a. Create a debug log directory for bpdm (if the device is disk) or bptm (if
the device is tape).
b. On UNIX, restart ltid in the verbose mode by executing:
/usr/openv/volmgr/bin/ltid -v
Or, add a VERBOSE entry to the Media Manager configuration file, /usr/openv/v
olmgr/vm.conf. Create the vm.conf file if necessary.
c. On Windows, enable verbose logging by adding VERBOSE on a line by itself
in the install_path\Volmgr\vm.conf file. Then, stop and restart the NetBackup De
vice Manager service.
d. Retry the operation and check the resulting debug log files.
e. On Windows systems, look at the install_path\VERITAS\NetBackup\db\media\e
rrors log for a drive that is frequently producing errors.
On UNIX systems, look at the /usr/openv/netbackup/db/media/errors log (which
is also included in the /usr/openv/netbackup/bin/goodies/support/support script
output) for a drive that is frequently producing errors.
===============================================================
Error Number: 84
media write error
The system's device driver returned an I/O error while NetBackup was writing to
removable media or a disk file.
Try the following:
1. For NetBackup Advanced Client only:
If the following message appears in the /usr/openv/netbackup/bptm log, and th
e values for key, asc, and ascq are all zero (0x0) as shown in this example mess
age:
tape error occurred on extended copy command, key = 0x0, asc = 0x0,
ascq = 0x0
your host-bus adapter and its driver are probably not supported by NetBackup
Advanced Client. The host-bus adapters supported in the release are listed in th
e NetBackup Release Notes.
2. For additional information, check the following:
* NetBackup Problems report to determine the device or media that caused the
error
* System and error logs for the system (UNIX)
* Event Viewer Application and System logs (Windows)
3. If NetBackup was writing backups to a disk file, verify that the disk has en
ough space for the backup.
For a catalog backup to a disk path on a UNIX system, you may be trying to wr
ite a image greater than two gigabytes. File sizes greater than two gigabytes is
a limitation on many UNIX file systems. Tape files do not have this limit.
4. If the media is tape or optical disk, check for:
* A defective or dirty drive, in which case, clean it or have it repaired (r
efer to the tpclean command for robotic drives).
* The wrong media type. Verify that the media matches the drive type you are
using. On an optical drive, the platters may not be formatted correctly.
* Defective media. If this is the case, use the bpmedia command to set the v
olume to the FROZEN state so it is not used for future backups.
* Incorrect drive configuration. Verify the Media Manager and system configu
ration for the drive.
For example, on UNIX the drive could be configured for fixed mode when it mus
t be variable mode. See the Media Manager Device Configuration Guide for more in
formation.
This often results in the media being frozen with a message, "too many data b
locks written, check tape/drive block size configuration."
===============================================================
Error Number: 85
media read error
The system device driver returned an I/O error while NetBackup was reading from
tape, optical disk, or a disk file.
Try the following:
1. For additional information, check the following:
* NetBackup Problems report to determine the device or media that caused the
error
* System and error logs for the system (UNIX)
* Event Viewer Application and System logs (Windows)
2. Check for the following:
* A defective or dirty drive. Clean it or have it repaired (see the tpclean
command for cleaning).
* Incorrect drive configuration. Verify the Media Manager and system configu
ration for the drive.
For example, on UNIX the drive could be configured for fixed mode when it mus
t be variable mode. See the Media Manager Device Configuration Guide for more in
formation.
* Defective media. In this case, you may not be able to recover all the data
on the media. Use the bpmedia command to set the volume to the FROZEN state so
it is not used for future backups.
* The wrong media type. Verify that the media matches the drive type you are
using.
===============================================================
Error Number: 86
media position error
The system's device driver returned an I/O error while NetBackup was positioning
media (tape or optical disk).
Try the following:
1. For additional information, check the following:
* NetBackup Problems report to determine the device or media that caused the
error
* System and error logs for the system (UNIX)
* Event Viewer Application and System logs (Windows)
2. Check for the following:
* A defective or dirty drive. Clean it or have it repaired (see the tpclean
command for cleaning).
* Incorrect drive configuration. Verify the Media Manager and system configu
ration for the drive.
For example, on UNIX the drive could be configured for fixed mode when it mus
t be variable mode. See the Media Manager Device Configuration Guide for more in
formation.
* Defective media. In this case, some data may be lost. Use the bpmedia comm
and to set the volume to the FROZEN state so it is not used for future backups.
* The wrong media type. Verify that the media matches the drive type you are
using.
===============================================================
Error Number: 87
media close error
The system's device driver returned an I/O error while NetBackup was closing a t
ape or optical disk.
Try the following:
1. For additional information, check the following:
* NetBackup Problems report to determine the device or media that caused the
error
* System and error logs for the system (UNIX)
* Event Viewer Application and System logs (Windows)
2. Check for the following:
* A defective or dirty drive. Clean it or have it repaired (see the tpclean
command for cleaning).
* Defective media. In this case, some data may be lost. Use the bpmedia comm
and to set the volume to the FROZEN state so it is not used for future backups.
===============================================================
Error Number: 88
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 89
problems encountered during setup of shared memory
The NetBackup processes use shared memory for some operations. This error is ret
urned when an error is encountered in the initialization of the shared memory vi
a the operating system's APIs.
Try the following:
Check for a shared memory problem. This error can occur if the system cannot all
ocate enough shared memory. This usually occurs when you use multiplexing, which
increases the shared memory requirements. A symptom is an entry similar to the
following in a NetBackup log (or report).
could not allocate enough shared memory
If you see this type of message, refer to the vendor documentation for your p
latform for instructions on increasing the amount of shared memory on your syste
m.
Because system requirements vary, no absolute recommendations can be made, ot
her than to use values great enough to provide resources to all applications. In
at least one instance, however, the following was found to be adequate on a Sun
platform:
set shmsys:shminfo_shmmax=8388608
set shmsys:shminfo_shmmin=1
set shmsys:shminfo_shmmni=100
set shmsys:shminfo_shmseg=10
set semsys:seminfo_semmnu=600
set semsys:seminfo_semmns=300
After making the changes to the /etc/system file on the Sun platform and rebo
oting with boot -r, the problem was resolved. Note that in the above, shminfo_sh
mmin must be less than or equal to 100 for NetBackup processes to run.
===============================================================
Error Number: 90
media manager received no data for backup image
The tape manager (bptm) or disk manager (bpdm) received no data when performing
a backup, archive, or duplication. This can occur for incremental backups where
no data was backed up because no files have changed.
Try the following:
1. Check the All Log Entries report.
2. For detailed debug information, create bpdm or bptm debug log directories on
the server. If the client is Windows, also create a bpbkar debug log directory
on the client. Retry the operation and check the resulting debug logs.
3. For additional information, check the following:
* NetBackup Problems report to determine the device or media that caused the
error
* System and error logs for the system (UNIX)
* Event Viewer Application log (Windows)
4. Verify the Media Manager and system configuration for the drive.
For example, on UNIX the drive may not be set for variable mode in a case whe
re that mode is required by NetBackup. Check the Media Manager Device Configurat
ion Guide for drive configuration information.
5. Verify that the Media Manager configuration for the backup device matches wh
at is specified for the storage unit in the NetBackup policy.
6. Verify that you are using the correct media in the drive.
7. For detailed debug information, create a bpdm or bptm debug log directory (w
hichever applies) on the server. If the client is Windows, also create a bpbkar
debug log directory on the client. Retry the operation and check the resulting d
ebug logs. Retry the operation. Check the resulting debug log file.
8. If the error was encountered by duplication or by a Vault session which is u
sing an Alternate Read Server to do duplication, verify that the Alternate Read
Server has access to the source media.
===============================================================
Error Number: 91
fatal NB media database error
The tape manager (bptm) received an error while reading or updating its media ca
talog.
Try the following:
1. Check the All Log Entries report for more information.
2. Check the NetBackup Media Lists report to see if the catalog is intact. If t
he catalog is not intact, consider reloading it from the latest NetBackup catalo
g backup volume.
3. Verify that the disk partition on which the catalog resides has enough space
.
4. If the above actions do not explain the problem, check the NetBackup Problem
s report.
5. For detailed troubleshooting information, create a bptm debug log directory
on the server and retry the operation. Check the resulting debug log file.
6. Contact customer support and send appropriate problem and debug log sections
.
===============================================================
Error Number: 92
media manager detected image that was not in tar format
When performing a restore, the tape manager (bptm) or disk manager (bpdm) could
not find a tar header at the offset it expected.
Try the following:
1. Perform a bpverify of the affected image to determine if it is written corre
ctly.
2. Check the NetBackup Problems report for additional information about the err
or.
3. Verify the Media Manager and system configuration for the drive.
For example, on some UNIX systems, for example, if you do not configure the d
rive for variable-mode block size writes, backup images written to the media pro
duce this error when an attempt is made to restore the image. For example, you s
ee the following sequence of events:
* Backup succeeds
* Verify succeeds
* Restore fails
The bptm debug log shows an error similar to
00:58:54 [2304] <16> write_data: write of 32768 bytes indicated
only 29696 bytes were written, errno = 0
In this case, configure the drive for variable-mode block sizes and suspend m
edia written on that device. See the NetBackup Device Configuration Guide.
The images written to those media may be restorable (this is platform depende
nt), but single file restores are almost guaranteed to fail. You can choose to e
xpire these media and regenerate the backups, or you can attempt to duplicate th
e images on these media to another device and then expire the original copy.
4. Error code 92 has been encountered on some relabeled and value-added 8-mm ta
pe drives where the drive's microcode incorrectly processes a "forward space rec
ord" SCSI command.
5. If the problem is not one of the above, create a debug log directory for eit
her bpdm or bptm and retry the operation. Check the resulting debug log file.
===============================================================
Error Number: 93
media manager found wrong tape in drive
When loading a volume for a backup or restore, the tape manager (bptm) found a v
olume loaded that did not have the expected tape header. This can indicate that
volumes in a robot are not in the slots indicated in the Media Manager volume co
nfiguration.
Try the following:
* If the volume is in a robot and the robot supports barcodes, perform a Compar
e Contents with Volume Configuration (on Windows) or Compare robot contents with
volume configuration (on UNIX). The resulting report shows which media ID was f
ound and validates its slot number with what is in the Media Manager volume conf
iguration. Then, either change the physical location in the robot or change the
volume configuration to show the correct slot.
* If the volume was mounted on a nonrobotic drive, verify that the correct volu
me was mounted and assigned.
===============================================================
Error Number: 94
cannot position to correct image
When searching for a backup image to restore, the tape manager (bptm) did not fi
nd the correct backup ID at the expected position on the volume. This can indica
te a drive hardware problem.
Try the following:
1. Try the restore on another drive if possible.
2. For additional information, check the following:
* NetBackup Problems report to determine the device or volume that caused th
e error
* System and error logs for the system (UNIX)
* Event Viewer Application and System logs (Windows)
3. For detailed troubleshooting information, create a debug log directory for b
ptm and retry the operation. Check the resulting debug log files.
===============================================================
Error Number: 95
requested media id was not found in NB media database and/or MM volume database
An operation was requested on a media ID for which NetBackup does not have a rec
ord. An example of this is using bpmedia to suspend or freeze a media ID that do
es not exist.
Try the following:
Run a NetBackup Media List report to determine the valid media IDs. Then, retry
the command with a valid media ID.
===============================================================
Error Number: 96
unable to allocate new media for backup, storage unit has none available
The tape manager (bptm) could not allocate a new volume for backups. This indica
tes that the storage unit has no more volumes available in the volume pool for t
his backup. Note that NetBackup will not change storage units during the backup.
Try the following:
Check the NetBackup Problems report to determine the storage unit that is out of
media.
1. If the storage unit is a robot and there are empty slots, add more volumes (
remember to specify the correct volume pool).
* If there are no empty slots, move some media to nonrobotic and then add ne
w volumes.
* If you are having difficulty keeping track of your available volumes, try
the available_media script:
On UNIX, this script is in:
/usr/openv/netbackup/bin/goodies/available_media
On Windows, the script is in:
install_path\NetBackup\bin\goodies\available_media.cmd
This script lists all volumes in the Media Manager volume configuration, and
augments that list with information on the volumes currently assigned to NetBack
up.
2. Set up a scratch volume pool as a reserve of unassigned tapes. If NetBackup
needs a new tape and no more tapes are available in the current volume pool, Net
Backup moves a tape from the scratch pool into the volume pool that the backup i
s using.
3. If the storage unit and volume pool appear to have media, verify the followi
ng:
* Volume is not FROZEN or SUSPENDED.
Check for this condition by using the NetBackup Media List report. If the vol
ume is frozen or suspended, use the bpmedia command to unfreeze or unsuspend it
(if that is desired).
* Volume has not expired or exceeded its maximum number of mounts.
* Volume Database Host name for the device is correct.
If you change the Volume Database Host name, stop and restart the Media Manag
er device daemon, ltid, (if the server is UNIX) or the NetBackup Device Manager
service (if the server is a Windows system).
* The correct host is specified for the storage unit in the NetBackup config
uration.
The host connection should be the server (master or media) that has drives co
nnected to it.
* The Media Manager volume configuration has media in the correct volume poo
l and unassigned or active media is available at the required retention level.
Use the NetBackup Media List report to show the retention levels, volume pool
s, and status (active and so on) for all volumes. Use the NetBackup Media Summar
y report to check for active volumes at the correct retention levels.
4. In some configurations, the NetBackup bptm process is rejected when requesti
ng media from the vmd process (UNIX) or the NetBackup Volume Manager service (Wi
ndows) because that process or service cannot determine the name of the host tha
t is making the request.
This can be due to incorrect network configuration involving:
* Multiple network interfaces
* /etc/resolv.conf on those UNIX systems that use it
* Running DNS and not having reverse addressing configured
5. Create bptm and vmd debug log directories and retry the operation.
6. Examine the bptm debug log to verify that bptm is connecting to the correct
system. If an error is logged, examine the vmd log.
On UNIX, the vmd log is:
/usr/openv/volmgr/debug/daemon/log.xxxxxx
On Windows, the vmd log is:
install_path\Volmgr\debug\daemon\xxxxxx.log
7. If this is a new storage unit, and this is the first attempt to use it, stop
and restart NetBackup on the master server.
Note: The bptm debug logs (in verbose mode) usually show the NetBackup media sel
ection process.
===============================================================
Error Number: 97
requested media id is in use, cannot process request
An operation was requested on a media ID that is in use. An example of this is a
ttempting to suspend or freeze a volume while it is being used for a backup or r
estore.
Try the following:
Retry the command when the volume is not in use. Use the Device Monitor to deter
mine if the volume is in use.
===============================================================
Error Number: 98
error requesting media (tpreq)
The tape manager and optical manager (bptm) received an error when requesting a
media mount from the NetBackup Device Manager service (on Windows) or the Media
Manager device daemon (ltid) (on UNIX).
Try the following:
* Check the NetBackup Problems report to determine the reason for the failure.
The most common cause is that the NetBackup Device Manager service (on Windows)
or the Media Manager device daemon (ltid) (on UNIX) is not running. Start it if
necessary.
* If duplicating backups or using Vault to duplicate backups, this error could
be an indication that the Alternate Read Server does not have access to the tape
on which the original backup resides.
===============================================================
Error Number: 99
NDMP backup failure
None of the paths in your NDMP policy file list was backed up successfully.
Try the following:
Check the NetBackup All Log Entries report for more information. A possible caus
e for this error is that none of the backup paths exist on the NDMP host.
===============================================================
Error Number: 100
system error occurred while processing user command
A system call failed in bparchive, bpbackup, bplist, or bprestore.
Try the following:
1. Enable debug logging for bparchive, bpbackup, bplist, or bprestore (as appro
priate) by creating debug log directories for them.
On UNIX, if a nonroot user is having problems, verify that the directory crea
ted has mode 666. Look for and correct any reported errors.
2. Retry the operation and check the resulting logs.
If the logs do not reveal the problem, use the command line version of the co
mmand and correct any problems that are reported on stderr.
===============================================================
Error Number: 101
failed opening mail pipe
The process that attempts to send mail could not open the pipe to the server.
Try the following:
Verify that mail is configured on the client. For detailed troubleshooting infor
mation, create a bpcd debug log directory and retry the operation. Check the res
ulting bpcd debug log.
===============================================================
Error Number: 102
failed closing mail pipe
The process that sends mail could not close the pipe to the server.
Try the following:
Verify that mail is configured on the client. For detailed troubleshooting infor
mation, create a bpcd debug log directory and retry the operation. Check the res
ulting bpcd debug log.
===============================================================
Error Number: 103
error occurred during initialization, check configuration file
None
Try the following:
None
===============================================================
Error Number: 104
invalid file pathname
None
Try the following:
None
===============================================================
Error Number: 105
file pathname exceeds the maximum length allowed
The path name built by using the current working directory exceeds the maximum p
ath length allowed by the system.
Try the following:
Shorten the current working directory path length.
===============================================================
Error Number: 106
invalid file pathname found, cannot process request
One of the file paths to be backed up or archived is not valid.
Try the following:
Verify that full path names are used (they start with / on UNIX), and they are l
ess than the maximum path length for the system. Also, verify that the files exi
st and the permissions allow NetBackup to access them.
===============================================================
Error Number: 107
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 108
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 109
invalid date specified
This error can occur when executing a command on the command line that contains
a date option. The format of a date option can vary depending on the locale of
the master server.
Try the following:
1. If the error occurred on a command line, examine the standard error output f
rom the command for an explanatory message.
2. Refer to the format for the date options in the usage statement for the comm
and. Look up the locale of the master server. Compare the date format of that lo
cale with the date format on the usage statement for the command.
3. Check the NetBackup Problems report for clues.
4. If the error is being displayed from a Java interface, enable the debug prin
t manager in the Java startup file. Retry and compare the parameters logged in t
he Java log with the parameters listed in the command's usage statement.
5. If the above actions do not reveal the problem, create a debug log directory
for the process that returned this status code, retry the operation, and check
the resulting debug log.
===============================================================
Error Number: 110
Cannot find the NetBackup configuration information
On Windows, NetBackup could not read the registry entries that were created duri
ng installation. On UNIX, the /usr/openv/netbackup/bp.conf file does not exist.
Try the following:
On Windows, reinstall NetBackup software on the client. On UNIX, create a /usr/o
penv/netbackup/bp.conf file with at least the following lines:
SERVER = server_name
CLIENT_NAME = client_name
===============================================================
Error Number: 111
No entry was found in the server list
On UNIX, the SERVER = server_name line is missing in the bp.conf file. On Window
s, the server list contains no entries.
Try the following:
* On a UNIX client, add the following line to the top of the /usr/openv/netback
up/bp.conf file:
SERVER = server_name
* On a Microsoft Windows or nontarget NetWare client, add the server name on th
e Servers tab in the Specify NetBackup Machines and Policy Type dialog box. To d
isplay this dialog, start the Backup, Archive, and Restore interface on the clie
nt and click Specify NetBackup Machines and Policy Type on the File menu.
* Run the NetBackup Configuration Validation Utility (NCVU) for the associated
NetBackup clients. Note the bp.conf or bpgetconfig checks in section four.
* On an OS/2 or NetWare target client, add the server name to the bp.ini file.
* On a Macintosh client, add the SERVER = server_name line to the bp.conf file
in the NetBackup folder in the Preferences folder.
===============================================================
Error Number: 112
no files specified in the file list
A restore was requested with no files in the file list.
Try the following:
Specify at least one file to be restored.
===============================================================
Error Number: 113
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 114
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 115
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 116
VxSS authentication failed
The parties on either end of a socket connection were unable to mutually authent
icate each other.
Try the following:
1. Ensure that the VERITAS Security Services is installed and configured. For
complete installation instructions please see the VERITAS Security Services Inst
allation Guide.
2. Check that both parties have a valid certificate. This can be done by examin
ing the expiry date listed from a bpnbat -WhoAmI. For example:
bpnbat -WhoAmI
Name: JDOG
Domain: MYCOMPANY
Issued by: /CN=broker/OU=root@machine1.mycompany.com/O=vx
Expiry Date: Sep 19 12:51:55 2003 GMT
Authentication method: Microsoft Windows
Operation completed successfully.
Shows an expiry date of September 19th, 2003. After 12:51:55 GMT this credent
ial is no longer valid and a new credential is required.
3. If running from the NetBackup Administration console, close and reopen the c
onsole. The console automatically obtains a credential for the currently logged
in identity, if possible. By default these certificates are valid for 24 hours.
To set a longer default time please consult the VERITAS Security Services Admini
strator's Guide.
4. Ensure that the certificates for both sides either use the same broker, are
children of the same root broker, or have trusts established between them. See t
he VERITAS Security Services Administrator's Guide for more information on broke
r hierarchies and establishing trust relationships between brokers.
5. Ensure that connectivity is possible between the physical systems in questio
n. If general sockets cannot connect between the machines (such as ping and teln
et), there may be issues within the network unrelated to NetBackup that are caus
ing this problem.
6. Ensure that the system has sufficient swap space and the following directori
es are not full:
* /home/username
* /user/openv/netbackup/logs
* /tmp
===============================================================
Error Number: 117
VxSS access denied
The user identity used to attempt an operation does not have the permissions nee
ded to perform the action.
Try the following:
1. If using the default groups, make certain that the user is attempting to per
form an operation appropriate for that group. For example, a member of NBU_Opera
tors is unable to modify policy information; this is a permission reserved for a
dministrator roles.
2. Ensure that the system has sufficient swap space and the following directori
es are not full:
* /home/username
* /user/openv/netbackup/logs
* /tmp
3. If using your own defined groups and permissions, first determine the objec
t with which the operation is associated, and then add the permissions relative
to the action. For example, if a user is required to up and down drives but does
not currently have permission to do so, verify that the user belongs to the cor
rect authorization group.
If needed, verify that the group has Up and Down permissions on the Drive obj
ect within the Group Permission tab. If necessary, you can increase the verbosit
y level of NetBackup to locate what object and what permissions are required for
the failing request. The pertinent lines in the debug logs will look similar to
the following:
17:19:27.653 [904.872] <2> GetAzinfo: Peer Cred Info.
Name: JMIZZLE
Domain: MYCOMPANY
Expiry: Sep 24 21:45:32 2003 GMT
Issued by: /CN=broker/OU=root@machine1.mycompany.com/O=vx
AuthType: 1
17:19:37.077 [904.872] <2> VssAzAuthorize: vss_az.cpp.5082: Function: VssAzAutho
rize. Object
NBU_RES_Drives
17:19:37.077 [904.872] <2> VssAzAuthorize: vss_az.cpp.5083: Function: VssAzAutho
rize. Permissions Up
17:19:40.171 [904.872] <2> VssAzAuthorize: vss_az.cpp.5166: Function: VssAzAutho
rize. 20 Permission denied.
In the instance illustrated above, the user JMIZZLE is attempting to perform
an operation that requires the Up permission on the Drives object. To diagnose t
he problem, examine the group(s) to which the user belongs to ensure that the ap
propriate group includes the Up permission (Up is a member of the Operate permis
sion set for Drives).
===============================================================
Error Number: 118
VxSS authorization failed
NetBackup was unable to complete the authorization check against the Authorizati
on service.
Try the following:
1. Ensure the Authorization Service/Daemon is running. Please refer to the VERI
TAS Security Services Administrator's Guide for more information on Authenticati
on and Authorization Daemons.
2. Ensure you are talking to the correct master server. Within the bp.conf fil
es on the local server verify that the entry AUTHORIZATION_SERVICES specifies th
e proper host name, fully qualified, of the Authorization service. For example,
AUTHORIZATION_SERVICE = machine2.mycompany.com 0
specifies that the server will contact machine2 in order to perform Authoriza
tion checks. Also ensure that this entry matches that of the master server.
3. Please ensure that the system has sufficient swap space and the following di
rectories are not full:
* /home/
* /user/openv/netbackup/logs
* /tmp
4. Ensure the server contacting the master has a valid certificate. The machine
certificate can be examined as follows:
For UNIX:
# bpnbat -WhoAmI -cf /usr/openv/var/vxss/credentials/machine3.mycompany.com
For Windows:
Bpnbat WhoAmI -cf "c:\Program Files\VERITAS\NetBackup\var\vxss\credentials\m
achine3.mycompany.com"
Both of which would return:
Name: machine3.mycompany.com
Domain: NBU_Machines@machine2.mycompany.com
Issued by: /CN=broker/OU=root@machine2.mycompany.com/O=vx
Expiry Date: Sep 2 19:25:29 2004 GMT
Authentication method: VERITAS Private Security
Operation completed successfully.
If the expiry date has been exceeded it is necessary to use bpnbat -LoginMach
ine to obtain a new credential for the machine. Please see the Netbackup Command
s manual for more information on bpnbat.
The server attempting the check is not authorized to examine the Authorizatio
n database. Ensure that bpnbaz -ShowAuthorizers retuned the machines identity. E
nsure the machine has a machine credential under the directory (Program Files\VE
RITAS\var\vxss\credentials for Windows, /usr/openv/var/vxss/credentials for UNIX
).
This credential should have the full name of the machine, for example, machin
e1.company.com.
5. Check that the maximum number of open sockets to the Authorization database
has not been exhausted. This can be done by using netstat to determine the numbe
r of sockets opened to port 4032 on the Authorization server, and referring to t
he following configuration entries on Windows and UNIX:
Windows:
HKLM\SOFTWARE\VERITAS\Security\Authorization\Communication\ClientMaxConnectio
ns
UNIX:
/etc/vx/vss/VRTSaz.conf entry "ClientMaxConnections"
If the maximum number of open connections has been reached it may be necessar
y to increase the number of maximum open connections. Increasing the number of o
pen connections will increase the memory footprint of the Authorization service/
daemon. Extreme increases in the maximum number of connections can result in per
formance degradation.
===============================================================
Error Number: 119
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 120
cannot find configuration database record for requested NB database backup
The program that backs up the NetBackup internal catalogs could not find the att
ributes that indicate which media IDs to use or paths to back up. This error sho
uld not occur under normal circumstances.
Try the following:
1. Check the NetBackup Problems report for additional information about the err
or.
2. For detailed troubleshooting information, create admin and bpdbm debug log d
irectories and retry the operation. Check the resulting debug logs.
3. Contact customer support and send appropriate problem and debug log sections
detailing the error.
===============================================================
Error Number: 121
no media is defined for the requested NB database backup
NetBackup attempted to back up its internal catalogs and there were no media IDs
defined in the catalog backup configuration.
Try the following:
Add the media IDs to the catalog backup configuration. Verify that the media IDs
are in the NetBackup volume pool.Run the NetBackup Configuration Validation Uti
lity (NCVU) on the master server. Note the NetBackup database configuration chec
ks in section six.
===============================================================
Error Number: 122
specified device path does not exist
The NetBackup internal catalogs were backed up by using the bpbackupdb command l
ine and specifying a device path (on Windows) or a raw device file (on UNIX) tha
t does not exist.
Try the following:
Retry the command using a valid device file name.Run the NetBackup Configuration
Validation Utility (NCVU) on the master server. Note the NetBackup database con
figuration checks in section six.
===============================================================
Error Number: 123
specified disk path is not a directory
NetBackup attempted to back up its internal catalogs and the backup attributes w
ere set to dump to a disk. However, the disk file path already exists and is not
a directory.
Try the following:
Specify a different disk path for the catalog backup or delete the file that alr
eady exists.
===============================================================
Error Number: 124
NB database backup failed, a path was not found or is inaccessible
One or more of the paths specified in the catalog backup configuration could not
be backed up.
Try the following:
1. Check the NetBackup Problems report for additional information about the err
or. Some possible causes are:
* The path does not exist.
* On a UNIX system, there is a symbolic link in one of the paths.
2. After determining which path could not be accessed, correct the path names i
n the catalog backup configuration.
===============================================================
Error Number: 125
another NB database backup is already in progress
Only one NetBackup catalog backup may be active at any given time.
Try the following:
None.
===============================================================
Error Number: 126
NB database backup header is too large, too many paths specified
Too many paths were specified in the NetBackup catalog backup configuration to f
it in a fixed-size media header. This error should not occur under normal circum
stances.
Try the following:
Delete some of the paths from the catalog backup configuration.
===============================================================
Error Number: 127
specified media or path does not contain a valid NB database backup header
The bprecover command was issued and the media ID specified does not have valid
catalog backup data.
Try the following:
Validate that the correct media ID is being used.
===============================================================
Error Number: 128
NB database recovery failed, a process has encountered an exceptional condition
One or more catalogs specified for recovery could not be restored. For more deta
il, refer to the error message issued just above this status code in the output
from the bprecover command.
Try the following:
1. After fixing the problem reported in the error message in the bprecover outp
ut, refer to "Recovering the NetBackup Catalogs for Windows" in the Troubleshoot
ing Guide or "Recovering the NetBackup Catalogs for UNIX" in the Troubleshooting
Guide to identify which NetBackup services (Windows) or daemons (UNIX) should b
e shut down prior to attempting the NetBackup database recovery. The NetBackup s
ervices should be shut down except for the NetBackup Client Service, which must
be running for the database recovery to succeed.
2. Check the NetBackup Problems report for additional information about the err
or. Some possible causes are:
* A disk may be full.
* The NetBackup catalog tape may be corrupt.
===============================================================
Error Number: 129
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 130
system error occurred
An error occurred that prevents the product from operating in a consistent fashi
on. This error is usually related to a system call.
Try the following:
1. Check the NetBackup Problems report for additional information about the err
or.
2. Check the system log for reported problems.
3. For detailed troubleshooting information, create bpdbm, bpsched, bptm, and b
prd debug log directories on the master server and retry the operation. Check th
e resulting debug logs.
===============================================================
Error Number: 131
client is not validated to use the server
The client name, as determined from the connection to the server, did not match
any client name in the NetBackup configuration and there was no altnames configu
ration for this client on the master server. A client and server that have multi
ple network connections can encounter this problem if the name by which the clie
nt is configured is not the one by which its routing tables direct connections t
o the server.
Try the following:
1. Examine the NetBackup Problems report.
2. Create a debug log directory for bprd and retry the operation. Check the res
ulting debug log to determine the connection and client names.
Depending on the request type (restore, backup, and so on.), you may need or
want to:
* Change the client's configured name.
* Modify the routing tables on the client.
* On the master server, set up an altnames directory and file for this clien
t (see the NetBackup System Administrator's Guide).
or
* On a UNIX master server, create a soft link in the NetBackup image catalog
.
3. Review "Verifying Host Names and Services Entries" in the Troubleshooting Gu
ide.
4. Run the NetBackup Configuration Validation Utility (NCVU) -conf on the master server for the associated NetBackup clients. Note the client h
ostname checks in section seven.
===============================================================
Error Number: 132
user is not validated to use the server from this client
None
Try the following:
None
===============================================================
Error Number: 133
invalid request
One of two explanations exist.
* A request was made that is unrecognized. This usually results from different
versions of NetBackup software being used together.
* If a client receives this error in response to a list or restore request, it
means that the DISALLOW_CLIENT_LIST_RESTORE or DISALLOW_CLIENT_RESTORE option ex
ists in the bp.conf file on a UNIX NetBackup server or in the registry on a Wind
ows NetBackup server. These options deny list and restore requests from all NetB
ackup clients.
Try the following:
1. If you suspect that the software versions are the problem, verify that all N
etBackup software is at the same version level.
* On UNIX NetBackup servers and clients, check the /usr/openv/netbackup/bin/
version file.
* On Windows NetBackup servers, check the install_path\netbackup\version.txt
file or the About NetBackup item on the Help menu.
* On Microsoft Windows clients, check the About NetBackup item on the Help m
enu.
* On NetWare target clients, check the Version entry in the bp.ini file.
If the client software is earlier than 3.0, verify that the client is in a St
andard type policy.
* On Macintosh clients, check the version file in the bin folder in the NetB
ackup folder in the Preferences folder.
2. If the server is denying list and restore requests, remove the DISALLOW_CLIE
NT_LIST_RESTORE and DISALLOW_CLIENT_RESTORE options from the bp.conf file on a U
NIX NetBackup server or from the registry on a Windows NetBackup server. Then, s
top and restart the NetBackup request daemon (UNIX) or NetBackup Request Manager
service (Windows).
3. For detailed troubleshooting information, create bpdbm, bprd, and admin debu
g log directories. Then, retry the operation and check the resulting debug logs.
===============================================================
Error Number: 134
unable to process request because the server resources are busy
Status code 134 is an informational message indicating that all drives in the st
orage unit are currently in use. If this occurs, NetBackup automatically tries a
nother storage unit; if one is not available, NetBackup requeues the job with a
status of 134 and retries it later.
Try the following:
None.The 134 code is an informational message only and is not considered an erro
r. It can occur for a number of reasons in normal operation. The 134 status code
can occur more frequently in an SSO environment. No action is necessary. A 134
status is not logged in the error logs (as of versions 3.4 MP4 and 4.5 MP2). A 1
34 status will cause a new try to show up in the Activity Monitor, but will not
increment the retry count associated with the number of retries allowed.
===============================================================
Error Number: 135
client is not validated to perform the requested operation
This is usually caused by a request to restore files to a client other than the
one that made the request and the request did not come from the root user (on UN
IX) or the administrator (on Windows) on a NetBackup server.
Try the following:
Retry the operation as a root user (on UNIX) or as an administrator (on Windows)
on the master server. Also see status code 131.
===============================================================
Error Number: 136
tir info was pruned from the image file
The TIR information has been pruned from one or more of the component (different
ial or cumulative) backup images that are being synthesized. This situation aris
es when the most recent backup image for the client is a synthetic full or cumul
ative backup and the TIR information from one or more of the component images pr
ior to the synthetic full (or cumulative) backup has been pruned. Now if you exp
ire the synthetic backup (full or cumulative) image and try to rerun the synthet
ic backup job for the client, the TIR information will be automatically restored
to the image catalog. However, if the TIR restore fails due to bad or missing o
r vaulted media, or a bad drive, the synthetic backup job will fail with this er
ror.
Try the following:
You need to reimport the TIR information into the catalog of each component imag
e (from which the TIR information has been pruned) and rerun the synthetic backu
p job. The TIR information can be imported into the image catalog by initiating
a true image restore of any file from that component image. The restore process
will also restore the TIR information in the image catalog.
===============================================================
Error Number: 137
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 138
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 139
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 140
user id was not superuser
The process was started by a user or process that did not have root privileges (
on UNIX) or administrator privileges (on Windows).
Try the following:
If desired, give the user or process administrator privileges (on Windows) or ro
ot privileges (on UNIX) and retry the operation.
===============================================================
Error Number: 141
file path specified is not absolute
The file specification must be an absolute path.
Try the following:
Correct the file specification and retry the command.
===============================================================
Error Number: 142
file does not exist
To use Advanced Client to back up a VxFS file system, the VxFS file system on th
e client has to be patched with the correct dynamic linked libraries. If the cor
rect VxFS libraries are not installed, the backup fails with status 142. For mos
t snapshot backups, the following message appears in the /usr/openv/netbackup/lo
gs/online_util log on the client:
09:36:48.299 [527] <32> fs_dev_rt_check: FTL - snapshot method: nbu_snap abort -
required VxFS dynamic linked libraries for NetBackup are not installed. Please
visit the VERITAS support web site, and refer to Technote number 262225 for furt
her information.For backups run from a FlashBackup policy, the following appears
in the /usr/openv/netbackup/logs/bpbkar log on the client:
10:09:56.566 [1146] <32> bpfsmap: FTL - bpfsmap: FlashBackup abort - required Vx
FS dynamic linked libraries for NetBackup are not installed. Please visit the VE
RITAS support web site, and refer to Technote number 262225 for further informat
ion.
10:09:56.571 [1146] <16> bpbkar Exit: ERR - bpbkar FATAL exit status = 142: file
does not exist
10:09:56.573 [1146] <4> bpbkar Exit: INF - EXIT STATUS 142: file does not exist
Try the following:
Install the VxFS dynamic libraries on the NetBackup client as described in the a
bove technote and try the backup again.
===============================================================
Error Number: 143
invalid command protocol
An ill-formed request was made to the NetBackup request daemon (UNIX) or to the
Request Manager service (Windows). This can be due to mismatched versions of the
product, corrupted network communication, or to a non-NetBackup process sending
data across the port for the daemon or service.
Try the following:
Examine the NetBackup error logs to determine the system that was the source of
the data and on that system determine the process that initiated the request. If
it was a NetBackup process, verify that the process or command is compatible wi
th the version of software on the server.
===============================================================
Error Number: 144
invalid command usage
This status code is due to a NetBackup process being started with improper optio
ns or an incompatibility in the product.
Try the following:
Either correct the command or verify that all NetBackup binaries are at the same
version level.
===============================================================
Error Number: 145
daemon is already running
There is another copy of the process executing.
Try the following:
Terminate the current copy of the process and then restart the process.
===============================================================
Error Number: 146
cannot get a bound socket
The service or daemon could not bind to its socket. A system call failed when th
e daemon (UNIX) or service (Windows) attempted to bind to its configured port nu
mber. This is usually caused by another process having acquired the port before
the daemon or service started.
Try the following:
1. Examine the NetBackup Problems and All Log Entries reports.
2. Create bprd and bpdbm debug log directories and retry the operation. Check t
he resulting logs to see the system error message resulting from the attempt.
If another process has the port, use other system commands to determine the p
rocess. Based on this research, either change the port number in your services f
ile or map or terminate the process that has acquired the port.
On UNIX, another possible cause for this error is terminating bprd or bpdbm w
ith the kill command. If you have to stop bprd, the recommended method is to use
the Terminate Request Daemon option on the Special Actions menu in bpadm (or th
e equivalent option in xbpadm). To stop bpdbm, use the /usr/openv/netbackup/bin/
bpdbm -terminate command. Using the kill command to stop these processes can lea
ve them unable to bind to their assigned ports the next time they are started.
To identify a bprd or bpdbm problem, look for lines similar to the following
in the debug log for the respective process:
<16> getsockbound: bind() failed, Address already in use (114)
<32> listen_loop: cannot get bound socket. errno = 114
<4> terminate: termination begun...error code = 146
Similar entries can appear in the reports.
3. If the problem persists longer than ten minutes, it is possible that it will
be necessary to reboot the server.
===============================================================
Error Number: 147
required or specified copy was not found
The requested copy number of a backup or archive image cannot be found.
Try the following:
Correct the request to specify a copy number that does exist.
===============================================================
Error Number: 148
daemon fork failed
A NetBackup service could not create a child process due to an error received fr
om the system. This is probably an intermittent error based on the availability
of resources on the system.
Try the following:
1. Restart the service at a later time and investigate system problems that lim
it the number of processes.
2. On Windows systems, check the Event Viewer Application and System logs.
===============================================================
Error Number: 149
master server request failed
None
Try the following:
None
===============================================================
Error Number: 150
termination requested by administrator
The process is terminating (or has terminated) as a direct result of a request f
rom an authorized user or process.
Try the following:
None.
===============================================================
Error Number: 151
Backup Exec operation failed
The Global Data Manager console has reported that a Backup Exec job (backup, arc
hive, or restore) did not complete normally.
Try the following:
Consult the Backup Exec job history on the Backup Exec server for details.
===============================================================
Error Number: 152
required value not set
An incomplete request was made to the bpdbm process (on UNIX), or the NetBackup
Database Manager service (on Windows). This usually occurs because different ver
sions of software are being used together.
Try the following:
1. Verify that all software is at the same version level.
2. For detailed troubleshooting information, create bpdbm and admin debug log d
irectories and retry the operation. Check the resulting debug logs.
===============================================================
Error Number: 153
server is not the master server
This status code is reserved for future use.
Try the following:
None.
===============================================================
Error Number: 154
storage unit characteristics mismatched to request
A backup was attempted and the storage unit selected for use had characteristics
that were not compatible with the backup type.
Try the following:
Verify that the characteristics of the storage unit involved are appropriate for
the backup attempted:
* For NetBackup Advanced Client only:
The policy storage unit was set to Any_available and the offhost backup metho
d was set to Third-Party Copy Device or NetBackup Media Server. Do not choose An
y_available. A particular storage unit (such as nut-4mm-robot-tl4-0) must be spe
cified when Third-Party Copy Device or NetBackup Media Server is specified as th
e offhost backup method.
* For an NDMP policy type, verify that a storage unit of type NDMP is defined a
nd the NDMP host value matches the host name of the client. For example, if the
NDMP policy specifies toaster as the client, the configuration for the storage u
nit must specify toaster as the NDMP host.
* For a policy type other than NDMP, verify that the policy specifies a Media M
anager or Disk type storage unit.
===============================================================
Error Number: 155
disk is full
The write to the catalog file failed because the disk containing the catalog dat
abase is full.
Try the following:
Free up space on the disks where NetBackup catalogs reside and retry the operati
on.
===============================================================
Error Number: 156
snapshot error encountered
If a backup on a Windows NetBackup 5.0 or later client fails with status code 15
6 and the client is using Windows Open File Backups to back up open or active fi
les, it is possible that the error was caused by the VSP/VSS cache file being fu
ll as files are being backed up using VSP/VSS. This is caused by the cache files
being too small for the number of files being backed up.
8:51:14.569 AM: [1924.2304] <2> tar_base::V_vTarMsgW: ERR - failure reading file
: D:\ test.file (WIN32 5: Access is denied. )
8:51:14.569 AM: [1924.2304] <4> tar_base::V_vTarMsgW: INF - tar message received
from dos_backup::tfs_readdata
8:51:14.569 AM: [1924.2304] <2> tar_base::V_vTarMsgW: ERR - Snapshot Error while
reading test.file
8:51:14.569 AM: [1924.2304] <4> tar_base::V_vTarMsgW: INF - tar message received
from tar_backup::nextfile_state_switch
8:51:14.569 AM: [1924.2304] <2> tar_base::V_vTarMsgW: FTL - Backup operation abo
rted!
8:51:14.569 AM: [1924.2304] <2> tar_base::V_vTarMsgW: INF - Client completed sen
ding data for backup
8:51:14.569 AM: [1924.2304] <2> tar_base::V_vTarMsgW: INF - EXIT STATUS 156: sna
pshot error encounteredIf this is the case, and bpbkar debug logs are turned on,
a message similar to the one above should appear in the bpbkar debug log for th
e backup.
Try the following:
Increase the sizes of the VSP/VSS cache files used by the backup. This recommend
ed action depend on whether VSP (VERITAS Volume Snapshot Provider) or VSS (Micro
soft Volume Shadow Copy Service) was used as the Windows Open File Backup Snapsh
ot Provider. If VSP is being used as the snapshot provider, try one of the follo
wing:
1. (preferred) Change the VSP Cache File Size configuration for the affected cl
ient in the VSP tab for the client's Host Properties in the NetBackup Administra
tion Console. Ensure that the "Customize the cache sizes" check box is unchecked
to let NetBackup automatically determine the best VSP cache file sizes. In most
cases, NetBackup will be able to create a large enough VSP cache file for backu
ps if the "Customize the cache sizes" check box is unchecked.
2. Increase either the initial VSP cache size and the maximum VSP cache size on
your own, depending on the requirements of your installation and your usage of
VSP. To specify your own Initial and Maximum Cache File sizes, select the Custom
ize the cache sizes checkbox and specify your own Initial and Maximum Cache File
Sizes either in MBs or percentage of disk space. Use caution when manually spec
ifying sizes for the Initial and Maximum Cache Size since it is used regardless
of the sizes of the volumes being backed up. If enough space is not allocated, t
he backup job could fail with a snapshot error.Please see the NetBackup System A
dministrator's Guide for more information on changing the configuration of VSP c
ache file sizes.If backups still abort with error status 156 after making change
s to the VSP cache file size configuration, there may not be enough free disk sp
ace on the affected client. Free up as much disk space on the drives of the affe
cted client as possible.If VSS is being used as the Window Open File Backup Snap
shot Provider, increase the cache size being used by VSS by using the Shadow Cop
y configuration in Windows 2003. Use the following steps to increase the cache s
ize.
1. Open the Windows 2003 Computer Management application. To open Computer Mana
gement, click Start, point to Settings, click Control Panel, double-click Admini
strative Tools, and then double-click Computer Management.
2. In the console tree, right-click Shared Folders, select All Tasks, and selec
t Configure Shadow Copies.
3. Select the volume where you want to make changes, and then select Settings.
4. In the Settings dialog box, change the Maximum Size setting to either No Lim
it or a size large enough to suit the requirements of your installation and your
usage of VSS.
===============================================================
Error Number: 157
suspend requested by administrator
Status code 157 is an informational message indicating that the administrator su
spended the job from the Activity Monitor. The job will be in the suspended stat
e in the Activity Monitor, and may be resumed from the last checkpoint by the ad
ministrator.
Try the following:
The administrator may resume the job from the last checkpoint. This is done from
the Activity Monitor.
===============================================================
Error Number: 158
failed accessing daemon lock file
The process could not lock its lock file because an error was received from a sy
stem call. This lock file synchronizes process activities (for example, preventi
ng more than one daemon from executing at a time).
Try the following:
1. Examine the NetBackup error log to determine why the system call failed and
correct the problem. It could be a permission problem.
2. If the error log does not show the error, create a debug log directory for b
prd, bpdbm, or bpsched (depending on which process encountered the error) and re
try the operation. Examine the resulting debug log.
===============================================================
Error Number: 159
licensed use has been exceeded
A configuration limit has been exceeded. For example, a job fails with this erro
r code if a policy is set up that:
* specifies a storage unit that is on a SAN media server, and
* specifies a client that is not the SAN media server itself.SAN media servers
can only back up themselves.This status code is used when the creation of a stor
age unit on a SAN media server fails because "On demand only" is not selected. "
On demand only" is required for storage units on a SAN media server.
Try the following:
To determine the cause of the error, examine the NetBackup All Log Entries repor
t for the command that was being executed. See also the Activity Monitor details
for informative messages.If the job fails on a SAN media server storage unit, e
nsure that only the local client is specified in the policy. If remote clients a
re specified in the policy, either they need to be removed and placed in a polic
y that specifies a different storage unit or the storage unit needs to be change
d for that policy.If you would like to back up remote clients using the SAN medi
a server, you may purchase a regular NetBackup media server license.
===============================================================
Error Number: 160
authentication failed
A problem was encountered when two systems were attempting to authenticate one a
nother.
Try the following:
See the NetBackup System Administrator's Guide for more information on the files
and commands mentioned here.
1. Ensure that the authentication libraries exist:
Windows:
install_path\NetBackup\lib\libvopie.dll
install_path\NetBackup\lib\libvnoauth.dll
UNIX (except HP-UX):
/usr/openv/lib/libvopie.so
/usr/openv/lib/libvnoauth.so
UNIX (HP-UX only):
/usr/openv/lib/libvopie.sl
/usr/openv/lib/libvnoauth.sl
Macintosh:
:System Folder:Extensions:libvopie.dll
:System Folder:Extensions:libvnoauth.dll
2. Check the methods_allow.txt files on the systems that are having problems to
ensure that authentication is enabled. The files are in the following locations
:
Windows:
install_path\NetBackup\var\auth
UNIX:
/usr/openv/var/auth
Macintosh:
:System Folder:Preferences:NetBackup:var:auth
If one system reports authentication failed (status code 160) and the other s
ystem reports network connection timed out (status code 41), you may have enable
d authentication in the first system's methods_allow.txt file but not in the sec
ond system's methods_allow.txt file.
3. On the systems that are having the authentication problem, remove the remote
host that is not being authenticated from the methods_allow.txt file.
For example, if host A and host B are having the problem, remove host A from
the file on host B and vice versa.
Retry the operation.
* If the problem still exists, it indicates connection problems not related
to authentication.
* If connections are now successful, proceed to the next step.
4. Execute bpauthsync -vopie on the master server to resynchronize the key file
s on the systems.
On Windows:
install_path\NetBackup\bin\admincmd\bpauthsync -vopie -servers -clients
On UNIX:
/usr/openv/netbackup/bin/admincmd/bpauthsync -vopie -servers -clients
5. Add back the names removed in step 3 and retry the operation.
6. Create debug log directories for the processes involved in authentication be
tween NetBackup systems. These include:
* On the server, create debug log directories for bprd, bpdbm, bpcd.
* On the client, create debug log directories for bpbackup, bprestore, bpbka
r (Windows only).
Retry the operation and check the logs.
===============================================================
Error Number: 161
Evaluation software has expired. See www.veritas.com for ordering information
The time allowed for the NetBackup evaluation software has ended.
Try the following:
Obtain a licensed copy of NetBackup.
===============================================================
Error Number: 162
incorrect server platform for license
The platform identifier in the license key does not match the platform type on w
hich the key was installed.
Try the following:
Ensure that you are using a license key that was intended for the platform on wh
ich you are installing.
===============================================================
Error Number: 163
media block size changed prior to resume
Status code 163 is an informational message indicating that the media block size
changed prior to resuming a backup job from the last checkpoint. Since the medi
a block size must be consistent, the job was restarted from the beginning.
Try the following:
Check the Activity Monitor job details for the job ID of the restarted job.
===============================================================
Error Number: 164
unable to mount media because it is in a DOWN drive, misplaced, or otherwise not
available
A restore was attempted and the volume required for the restore was in a DOWN dr
ive in a robot. Or, the slot that should contain the volume is empty.
Try the following:
* If volume is in a DOWN drive, remove it and place it in its designated slot.
Then, retry the restore.
* If the volume is in the wrong slot, use a robot inventory option to reconcile
the contents of the robot with the Media Manager volume configuration.
===============================================================
Error Number: 165
NB image database contains no image fragments for requested backup id/copy numbe
r
A restore was attempted and NetBackup has no record of fragments associated with
the backup ID that has the files.
Try the following:
Check the NetBackup Problems report for additional information about the error.
For detailed troubleshooting information, create a debug log directory for eithe
r bpdm or bptm (whichever applies) and retry the operation. Check the resulting
debug log.
===============================================================
Error Number: 166
backups are not allowed to span media
An end of media (EOM) was encountered while the backup image was being written.
The backup was terminated because the NetBackup DISALLOW_BACKUPS_SPANNING_MEDIA
option was present in bp.conf (on UNIX) or in the registry (on Windows). The bac
kup will be retried automatically with a different volume if this is allowed by
the backup tries attribute in the NetBackup global attribute configuration.
Try the following:
None.
===============================================================
Error Number: 167
cannot find requested volume pool in Media Manager volume database
A backup to a nonrobotic drive was attempted and the tape manager (bptm) could n
ot find or add the specified volume pool.
Try the following:
Verify the Media Manager volume configuration. Check the NetBackup Problems repo
rt for more information about the error. For detailed troubleshooting informatio
n, create a bptm debug log directory and retry the operation. Check the resultin
g debug log.
===============================================================
Error Number: 168
cannot overwrite media, data on it is protected
A catalog backup was attempted to a volume that could not be overwritten because
it contains data that NetBackup, by default, does not overwrite (tar, cpio, ANS
I, and so on).
Try the following:
Replace the volume with a new one or set the NetBackup ALLOW_MEDIA_OVERWRITE opt
ion to the appropriate value.
===============================================================
Error Number: 169
media id is either expired or will exceed maximum mounts
A backup or catalog backup was attempted and the volume selected for use has rea
ched its maximum number of mounts as specified in the Media Manager volume confi
guration. For a regular backup, the volume is automatically set to the SUSPENDED
state and not used for further backups. For a NetBackup catalog backup, the ope
ration terminates abnormally.
Try the following:
If the volume was suspended, wait until it expires and then replace it. For NetB
ackup catalog backups, replace the media.
===============================================================
Error Number: 170
third party copy backup failure
Usually indicates a problem with the 3pc.conf file or the mover.conf file. (For
detailed causes, see recommended actions.) For more information on these files,
refer to the SAN Configuration chapter of the NetBackup Advanced Client System A
dministrator's Guide.
Try the following:
* If a non third-party copy device is listed in 3pc.conf file, correct or remov
e the non third-party copy device entry.
* If an incorrect lun is specified in the 3pc.conf file, or the device does not
exist, correct the 3pc.conf file as appropriate.
* If an appropriate mover.conf file (with or without file-name extension) could
not be found, the /usr/openv/netbackup/logs/bptm log may show the following:
09:51:04 [22281] <2> setup_mover_tpc: no mover.conf.vertex_std_tpc
or mover.conf file exists, cannot perform TPC backup
09:51:04 [22281] <16> bptm: unable to find or communicate with
Third-Party-Copy mover for policy vertex_std_tpc
Make sure that an appropriate mover.conf file exists in /usr/openv/netbackup
on the media server. This file can be any of the following:
* mover.conf.policy_name file, where policy_name exactly matches the name of
the policy.
* mover.conf.storage_unit_name, where storage_unit_name exactly matches the
name of the storage unit selected in the Backup Policy Management Policy attribu
tes dialog (such as nut-4mm-robot-tl4-0).
* mover.conf file (no extention) for configurations that have only one third
-party copy device.
Note that NetBackup looks for an appropriate mover.conf file in the above ord
er.
* If the SCSI pass-through path of the third-party copy device, as entered in t
he mover.conf file (with or without file-name extension), does not exist, the /u
sr/openv/netbackup/logs/bptm log may show the following:
09:50:12 [22159] <16> setup_mover_tpc: open of passthru path
/dev/sg/cXtXlX failed, No such file or directory
09:50:12 [22159] <16> bptm: unable to find or communicate with
Third-Party-Copy mover for policy vertex_std_tpc
Correct the SCSI pass-through path of the third-party copy device that is ent
ered in the mover.conf file.
* If the third-party copy device returned an error, you may see either of the f
ollowing messages in /usr/openv/netbackup/ logs/bptm log:
cannot process extended copy error due to truncated
sense data, may be HBA problem
disk error occurred on extended copy command, key = 0x0,
asc = 0x0, ascq = 0x0 (where key, asc and ascq are all zero)
your host-bus adapter (HBA) and its driver may need to be updated, or may not
be supported by NetBackup Advanced Client. The host-bus adapters supported in t
he release are listed in the NetBackup Release Notes.
===============================================================
Error Number: 171
media id must be 6 or less characters
An operation, such as using bpmedia to suspend or freeze a media ID, was attempt
ed and the media ID specified was longer than six alpha-numeric characters.
Try the following:
Retry the command with a valid media ID.
===============================================================
Error Number: 172
cannot read media header, may not be NetBackup media or is corrupted
When loading a volume for a backup or restore, the tape manager (bptm), did not
find the expected tape header. This can mean that a volume in a robotic device i
s not in the slot number shown in the Media Manager volume configuration or that
a read error (I/O error) occurred.
Try the following:
1. If the volume is in a robot that supports barcodes, verify the robot content
s by using a Media Manager robot inventory option.
2. If the volume was mounted on a nonrobotic drive, verify that the correct vol
ume was mounted and assigned.
3. Check the NetBackup Problems report. If a fatal read error occurred, attempt
the operation again using another drive, if possible.
4. If your configuration has multiple servers / HBAs with access to your tape s
ervices (most likely, an SSO configuration), make sure the SCSI Reserve / Releas
e is configured correctly. For more information, refer to the NetBackup SAN Shar
ed Storage Option System Administrators Guide for UNIX and Windows.
===============================================================
Error Number: 173
cannot read backup header, media may be corrupted
When searching for a backup image to restore, the tape manager (bptm) could not
find the correct backup ID at the position on the media where NetBackup expected
it to be. This can indicate a drive hardware problem.
Try the following:
1. Check the NetBackup Problems report for clues as to what caused the error.
2. Try the restore on another drive if possible.
3. For detailed troubleshooting information, create a debug log directory for b
ptm and retry the operation. Check the resulting debug log.
===============================================================
Error Number: 174
media manager - system error occurred
An abnormal condition occurred causing a tape manager (bptm) or disk manager (bp
dm) failure. This should not occur under normal circumstances.
Note: If this occurs on a Sequent platform and you are attempting to back up mor
e than four gigabytes of data, save all your logs and call VERITAS technical sup
port. For other platforms perform the recommended actions described below.
Try the following:
1. Check the NetBackup Problems report to see if it shows the cause of the prob
lem. If you see a Problems report message similar to
"attempted to write 32767 bytes, not a multiple of 512"
save all logs and call VERITAS customer support.
2. On UNIX, if this occurs during a restore, it may be that the tape drive is i
ncorrectly configured to write in fixed length mode when it should write in vari
able length mode.
Verify your drive's configuration, comparing it to what is recommended in the
Media Manager Device Configuration Guide (also see step 7 of this procedure).
If your configuration incorrectly specifies fixed length mode, change the con
figuration to specify variable length mode and suspend media that were written o
n that device. The images written to those media may be restorable (this is plat
form dependent), but single file restores are almost guaranteed to fail.
3. If you see the problem with only one client, verify that the client binaries
are correct, especially those for bpcd.
4. Can you read or write any other images on this media?
If so, check the following reports for clues:
* Images on Media report
* Media Contents report
5. Verify the following:
* The media by using the NetBackup image verify option.
* That you are using the correct media type for the device.
6. Check the system or console log for errors (on UNIX) or the Event Viewer App
lication log (on Windows).
7. For detailed debug information, create a debug log directory for either bptm
or bpdm (whichever applies) and retry the operation. Check the resulting debug
log.
On UNIX systems, if the bptm debug log shows an error similar to
00:58:54 [2304] <16> write_data: write of 32768 bytes
indicated only 29696 bytes were written, errno = 0
it may be that the tape drive is configured to write in fixed length mode rat
her than variable length mode, and the image being written encountered the end-o
f-media.
Take the corrective action suggested in step 2.
===============================================================
Error Number: 175
not all requested files were restored
When restoring files from an image, the bptm or bpdm process detected a fatal er
ror condition and terminated the restore before it completed. This should not oc
cur under normal circumstances.
Try the following:
1. Check the NetBackup Problems report and the status or progress log on the cl
ient for additional information about the error
2. For detailed troubleshooting information, create a debug log directory for e
ither bptm or bpdm (whichever applies) and retry the operation. Check the result
ing debug log.
===============================================================
Error Number: 176
cannot perform specified media import operation
The tape manager (bptm) detected an error condition when attempting to import a
specific backup image. Possible reasons for this are:
* Media ID is already active in the NetBackup media catalog on this server
* Media ID is not in the Media Manager volume configuration
* Fatal tape manager (bptm) error occurred
* Total image was not obtained from Phase 1 of import
Try the following:
1. Check the NetBackup Problems report to find the exact cause of the failure.
2. Try the following:
* If the media ID is already active, duplicate all images on the original me
dia ID to another volume. Then, manually expire the original media and redo the
import.
* If the media ID is not present in the Media Manager volume configuration,
add it.
* If a fatal bptm error occurred, verify that the Media Manager volume daemo
n (vmd) is active on UNIX or that the NetBackup Volume Manager service is active
on Windows.
* If the entire image is not present, perform import phase 1 on the media ID
s that have the remainder of the image.
===============================================================
Error Number: 177
could not deassign media due to Media Manager error
The tape manager (bptm) could not successfully deassign a media ID.
Try the following:
1. Check the NetBackup Problems report for the cause of the problem.
2. Verify that the Media Manager volume daemon (vmd) is active on UNIX or the N
etBackup Volume Manager service is active on Windows.
3. For detailed troubleshooting information, create a debug log directory for b
ptm and retry the operation. Check the resulting debug log.
===============================================================
Error Number: 178
media id is not in NetBackup volume pool
NetBackup attempted a backup of its catalogs and the media ID specified for the
catalog backup was not in the NetBackup volume pool. Volumes for catalog backups
must be in the NetBackup volume pool.
Try the following:
Check the Media Manager volume configuration to verify that the media IDs are pr
esent and in the NetBackup volume pool.
===============================================================
Error Number: 179
density is incorrect for the media id
An operation such as "list contents" was attempted on an invalid media ID, such
as a cleaning tape. Another possibility is that a media ID in the NetBackup cata
log backup configuration does not match the media type entered in the Media Mana
ger volume configuration.
Try the following:
Check the volume configuration and the NetBackup catalog backup configuration an
d correct any problems found.
===============================================================
Error Number: 180
tar was successful
tar returned a successful exit status.
Try the following:
None.
===============================================================
Error Number: 181
tar received an invalid argument
One of the parameters passed to tar was not valid.
Try the following:
* On a UNIX client:
* Ensure that the tar command in /usr/openv/netbackup/bin is the one provide
d by NetBackup. If you are in doubt, reinstall it.
* Check /usr/openv/netbackup/bin/version on the client to verify that the cl
ient is running the correct level software. If the software is not at the correc
t level, update the software per the directions in the NetBackup release notes.
* On a Windows client, create a tar debug log directory, retry the operation, a
nd check the log.
* On a Macintosh client, check the version file that is in the bin folder in th
e NetBackup folder in the Preferences folder. If the software is not at the corr
ect level, install the correct software as explained in the NetBackup Installati
on Guide for UNIX.
===============================================================
Error Number: 182
tar received an invalid file name
tar cannot write to the file that is specified with the -f parameter.
Try the following:
1. Create a bpcd debug log directory on the client (on a Macintosh NetBackup cr
eates the log automatically).
2. On a Windows client, create a tar debug log directory.
3. Increase the logging level on the client:
* On a UNIX client, add the VERBOSE option to the /usr/openv/netbackup/bp.co
nf file.
* On PC clients, increase the debug or log level as explained in the debug l
og topics in Chapter 3 of the Troubleshooting Guide.
4. Rerun the operation, check the resulting debug logs for the parameters passe
d to tar and call customer support.
===============================================================
Error Number: 183
tar received an invalid archive
The data passed to tar was corrupt.
Try the following:
* If the problem is with a UNIX client, create a /usr/openv/netbackup/logs/tar
debug log directory on the client and rerun the operation.
a. Check the tar debug log file for error messages that explain the problem.
b. Reboot the client to see if this clears the problem.
c. When you are through investigating the problem, delete the /usr/openv/net
backup/logs/tar directory on the client.
* If the problem is with a Microsoft Windows, NetWare, or Macintosh client:
a. Create a bpcd debug log directory on the client (on a Macintosh NetBackup
creates the log automatically).
b. On a Windows client, create a tar debug log directory.
c. Increase the debug or log level as explained in the debug log topics in C
hapter 3 of the Troubleshooting Guide.
d. Rerun the operation and check the resulting debug logs.
e. Reboot the client to see if it clears the problem.
===============================================================
Error Number: 184
tar had an unexpected error
A system error occurred in tar.
Try the following:
* If the problem is with a UNIX client, create a /usr/openv/netbackup/logs/tar
debug log directory on the client and rerun the operation.
a. Check the tar debug log file for error messages that explain the problem.
b. Reboot the client to see if this clears the problem.
c. When you are through investigating the problem, delete the /usr/openv/net
backup/logs/tar directory on the client.
* If the problem is with a Microsoft Windows, NetWare, or Macintosh client:
a. Create a bpcd debug log directory on the client (on a Macintosh NetBackup
creates the log automatically).
b. Increase the debug or log level as explained in the debug log topics in C
hapter 3 of the Troubleshooting Guide.
c. On a Windows client, create a tar debug log directory.
d. Retry the operation and check the resulting debug logs.
e. Reboot the client to see if it clears the problem.
===============================================================
Error Number: 185
tar did not find all the files to be restored
There were files in the tar file list that were not in the image.
Try the following:
* If the problem is with a UNIX client:
a. Enable bpcd debug logging by creating the /usr/openv/netbackup/logs/bpcd
directory on the client.
b. Rerun the operation, check the resulting bpcd log file for the parameters
passed to tar, and call customer support.
* If the problem is with a Microsoft Windows, NetWare, or Macintosh client:
a. Create a bpcd debug log directory on the client (on a Macintosh NetBackup
creates the log automatically).
b. Increase the debug or log level as explained in the debug log topics in C
hapter 3 of the Troubleshooting Guide.
c. On a Windows client, create a tar debug log directory.
d. Retry the operation.
e. Check the resulting debug logs for the parameters passed to tar and call
customer support.
===============================================================
Error Number: 186
tar received no data
The media manager did not send data to tar.
Try the following:
1. Retry the operation and check the status or progress log on the client for e
rror messages that reveal the problem.
2. Verify that the tape is available and readable.
3. Verify that the drive is in an UP state. Use the Device Monitor.
4. For detailed troubleshooting information:
a. Create a bptm debug log on the server.
b. On a Windows client, create a tar debug log.
c. Retry the operation and check the resulting debug logs.
===============================================================
Error Number: 187
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 188
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 189
the server is not allowed to write to the client's filesystems
The client is not allowing writes from the server.
Try the following:
Perform the following to perform restores or install software from the server.
* On a UNIX client, delete DISALLOW_SERVER_FILE_WRITES from the /usr/openv/netb
ackup/bp.conf file.
* On a Microsoft Windows or NetWare nontarget client, select Allow server-direc
ted restores on the General tab in the NetBackup Client Properties dialog box. T
o display this dialog box, start the Backup, Archive, and Restore interface on t
he client and select NetBackup Client Properties from the File menu.
* On a Macintosh client, delete DISALLOW_SERVER_FILE_WRITES from the bp.conf fi
le in the NetBackup folder in the Preferences folder.
* On a NetWare target client, set ALLOW_SERVER_WRITE to yes in the bp.ini file.
===============================================================
Error Number: 190
found no images or media matching the selection criteria
A verify, duplicate, or import was attempted and no images matching the search c
riteria were found in the NetBackup catalog.
Try the following:
Change the search criteria and retry.
===============================================================
Error Number: 191
no images were successfully processed
A verify, duplicate, or import was attempted and failed for all selected images.
Try the following:
* Check the NetBackup Problems report for the cause of the error. To obtain det
ailed troubleshooting information, create an admin debug log directory and retry
the operation. Check the resulting debug log.
* If the error was encountered during duplication of backups, check the duplica
tion progress log to help determine the root cause of the problem.
* If the error was encountered by a Vault job which is doing duplication, check
the duplicate.log files in your sidxxx directories to help determine the root c
ause of the problem:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
===============================================================
Error Number: 192
VxSS authentication is required but not available
The system on one side of a NetBackup network connection requires VxSS authentic
ation. The system on the other side of the connection is not configured to use V
xSS. VxSS authentication is ued with the NetBackup Access Control feature (NBAC)
. The connection has been terminated because VxSS authentication cannot be compl
eted.
Try the following:
Make sure both systems are configured to use NetBackup Access Control VxSS authe
ntication with each other, or make sure both systems are not configured to use V
xSS with each other. The first thing to check is the Use VxSS Host properties va
lue on each system. If one is configured for REQUIRED, the other must be configu
red for REQUIRED or AUTOMATIC. If one is configured for PROHIBITED, the other mu
st be configured for PROHIBITED or AUTOMATIC. Please see chapter 1 of the VERITA
S NetBackup System Administrator's Guide, Volume 2, for information about settin
g the Access Control related host properties, and for information about configur
ing a system to use Access Control.
===============================================================
Error Number: 193
VxSS authentication is requested but not allowed
The system on one side of a NetBackup network connection requires VxSS authentic
ation. The system on the other side of the connection is not configured to use V
xSS. VxSS authentication is ued with the NetBackup Access Control feature (NBAC)
. The connection has been terminated because VxSS authentication cannot be compl
eted.
Try the following:
Make sure both systems are configured to use NetBackup Access Control VxSS authe
ntication with each other, or make sure both systems are not configured to use V
xSS with each other. The first thing to check is the Use VxSS Host properties va
lue on each system. If one is configured for REQUIRED, the other must be configu
red for REQUIRED or AUTOMATIC. If one is configured for PROHIBITED, the other mu
st be configured for PROHIBITED or AUTOMATIC. Please see chapter 1 of the VERITA
S NetBackup System Administrator's Guide, Volume 2, for information about settin
g the Access Control related host properties, and for information about configur
ing a system to use Access Control.
===============================================================
Error Number: 194
the maximum number of jobs per client is set to 0
The NetBackup Maximum jobs per client global attribute is currently set to 0. Se
tting the value to 0 disables backups and archives.
Try the following:
To enable backups and archives, change the Maximum jobs per client value to the
desired nonzero setting. This attribute is on the Global NetBackup Attributes ta
b in the Master Server Properties dialog box. See "Using the Host Properties Win
dow" in the Troubleshooting Guide.
===============================================================
Error Number: 195
client backup was not attempted
A backup job was in the NetBackup scheduler's worklist but was not attempted.
Try the following:
1. Retry the backup either immediately with a manual backup or allow the normal
scheduler retries.
2. For additional information, check the All Log Entries report. For detailed t
roubleshooting information, create a bpsched debug log directory on the master s
erver. After the next backup attempt, check the debug log.
Some actions to perform are:
* Verify that the vmd and ltid daemons (UNIX) or the NetBackup Volume Manage
r and NetBackup Device Manager services (Windows) are running.
* Look for a problem in an earlier backup that made the media or storage uni
t unavailable.
===============================================================
Error Number: 196
client backup was not attempted because backup window closed
A backup or archive operation that was queued by the backup scheduler was not at
tempted because the backup window was no longer open.
Try the following:
* If possible, change the schedule to extend the backup window for this policy
and schedule combination so it does not occur again.
* If the backup must be run, use the Manual Backup command on the Policy menu i
n the Backup Policy Management window to perform the backup. Manual backups igno
re the backup window.
===============================================================
Error Number: 197
the specified schedule does not exist in the specified policy
A user backup or archive request has specified the exact policy and schedule to
use when performing a backup. The policy exists but does not contain the schedul
e.
* On Microsoft Windows and NetWare nontarget clients, you can specify a policy
or schedule on the Backups tab in the NetBackup Client Properties dialog box. To
display this dialog box, start the Backup, Archive, and Restore interface on th
e client and select NetBackup Client Properties from the File menu.
* On UNIX and Macintosh clients, you can specify a policy or schedule by using
the bp.conf options, BPBACKUP_POLICY or BPBACKUP_SCHED.
* On NetWare target clients, you can specify a policy or schedule in the bp.ini
file.
Try the following:
1. Check the client progress log (if available) to determine the policy and sch
edule that were specified.
2. Check the configuration on the master server to determine if the schedule is
valid for the policy. If the schedule is not valid, either add the schedule to
the policy configuration or specify a valid schedule on the client.
===============================================================
Error Number: 198
no active policies contain schedules of the requested type for this client
A user backup or archive has been requested, and this client is not in a policy
that has a user backup or archive schedule.
Try the following:
Determine if the client is in any policy that has a schedule of the appropriate
type (either user backup or archive).
* If the client is in such a policy, check the general policy attributes to ver
ify that the policy is set to active.
* If the client is not in such a policy, either add a schedule of the appropria
te type to an existing policy that has this client or create a new policy that h
as this client and a schedule of the appropriate type.
* Run the NetBackup Configuration Validation Utility (NCVU) -conf on the master server. Note the policy checks in section five.
===============================================================
Error Number: 199
operation not allowed during this time period
A user backup or archive has been requested and this client is not in a policy t
hat has a user backup or archive schedule with an open backup window. This error
implies that there is an appropriate policy and schedule combination for this c
lient.
Try the following:
Determine the policies to which this client belongs that also have a schedule of
the appropriate type (either user backup or archive).
* If possible, retry the operation when the backup window is open.
* If the backup window is not open during appropriate time periods, adjust a ba
ckup window for a schedule in one of the policies.
===============================================================
Error Number: 200
scheduler found no backups due to run
When checking the policy and schedule configuration, the NetBackup scheduler pro
cess (bpsched) did not find any clients to back up. This could be due to:
* No backup time windows are open (applies only to full and incremental schedul
es).
* Policies are set to inactive.
* The clients were recently backed up and are not due for another backup (based
on Frequency setting for the schedules).
* Policies do not have any clients.
Try the following:
Usually, this message can be considered informational and does not indicate a pr
oblem. However, if you suspect a problem:
1. Examine the NetBackup All Log Entries report to see if there are any message
s in addition to one indicating that the scheduler found nothing to do.
2. Examine the policy configuration for all policies or the specific policy in
question and determine if any of the reasons mentioned in the Explanation sectio
n above apply.
3. To obtain detailed troubleshooting information, create a bpsched debug log d
irectory on the master server and retry the operation. Check the resulting debug
log.
===============================================================
Error Number: 201
handshaking failed with server backup restore manager
A process on the master server encountered an error when communicating with the
media host (can be either the master or a media server). This error means that t
he master and media server processes were able to initiate communication, but en
countered difficulties in completing them. This problem can occur during a backu
p, restore, or media list in a single or multiple server configuration.
Try the following:
1. Determine the activity that encountered the handshake failure by examining t
he NetBackup All Log Entries report for the appropriate time period. If there ar
e media servers, determine if:
* The handshake failure was encountered between the master and a media serve
r.
or
* Only the master server was involved.
2. If necessary, create the following debug log directories for the following:
* bpcd on the NetBackup media host (can be either the master or a media serv
er).
* If the error was encountered during a backup operation, bpsched on the mas
ter server.
* If the error was encountered during a restore operation, bprd on the maste
r server.
* If the error was encountered during a media list operation, admin in the N
etBackup logs/admin directory on the master server.
3. Retry the operation and examine the resulting debug logs for information on
why the error occurred.
===============================================================
Error Number: 202
timed out connecting to server backup restore manager
A process on the master server timed out while trying to initiate communications
with the media host (can be either the master or a media server). This problem
can occur during a backup or restore in either a single or multiple server confi
guration.
Try the following:
Determine which activity encountered the connection timeout failure by examining
the All Log Entries report for the appropriate time period. If there are media
servers, determine if the timeout occurred between the master and a media server
or if only the master was involved.
1. Verify that the schedule specifies the correct storage unit.
2. Execute the ping command from one host to another by using the following com
binations:
* From the master server, ping the master and all media servers by using the
host names found in the storage unit configuration.
* From each of the media servers, ping the master server by using the host n
ame specified in the NetBackup server list. On a UNIX server, this is the first
SERVER entry in the bp.conf file. On a Windows server, the master is designated
on the Servers tab in the Master Server Properties dialog. To access this dialog
, see "Using the Host Properties Window" in the Troubleshooting Guide.
3. Verify that the master server can communicate with bpcd on the host that has
the storage unit.
After each backup, the scheduler checks the storage unit to see how many driv
es are available (in case the backup caused a drive to be automatically downed).
If bpsched cannot communicate with bpcd, it sets the number of available drives
in that storage unit to 0 and further backups to that storage unit fail.
The available drives remain at 0 until the scheduler is initialized again. Th
erefore, even if bpcd seems to be operating correctly now, check the bpsched and
bpcd debug logs (see below) for records of an earlier failure.
4. See "Testing Media Server and Clients" in the Troubleshooting Guide and "Res
olving Network Communication Problems" in the Troubleshooting Guide.
5. If necessary, create debug log directories for the following processes and r
etry the operation. Then, check the resulting debug logs on the master server:
* If the error occurred during a backup operation, check the bpsched debug l
ogs. Also, check the bpcd debug logs.
* If the error occurred during a restore operation, check the bprd debug log
s.
===============================================================
Error Number: 203
server backup restore manager's network is unreachable
A process on the master server could not connect to a particular host on the net
work when trying to initiate communication with the media host for a particular
operation. This problem can occur during a backup or restore in either a single
or multiple server configuration.
Try the following:
Determine which activity encountered the network unreachable failure by examinin
g the All Log Entries report for the appropriate time frame. If there is more th
an one NetBackup server (that is, one or more media servers) determine if the ne
twork unreachable failure was encountered between the master and a media server
or if only the master server was involved. Execute the ping command from one hos
t to another by using the following combinations:
1. From the master server, ping the master and all media servers by using the h
ost names in the storage unit configuration.
2. From each of the media servers, ping the master server host by using the hos
t name specified in the NetBackup server list. On a UNIX server, this is the fir
st SERVER entry in the bp.conf file. On a Windows server, the master is designat
ed on the Servers tab in the Master Server Properties dialog. To access this dia
log, see "Using the Host Properties Window" in the Troubleshooting Guide.
3. See "Testing Media Server and Clients" in the Troubleshooting Guide and "Res
olving Network Communication Problems" in the Troubleshooting Guide.
4. If necessary, create debug log directories for the following processes and r
etry the operation. Then, check the resulting debug logs on the master server:
* If the error occurred during a backup, check the bpsched debug logs.
* If the error occurred during a restore, check the bprd debug logs.
5. Run the NetBackup Configuration Validation Utility (NCVU) -conf on the master server for the associated NetBackup media servers. Note
the media server host name checks in sections four and seven.
===============================================================
Error Number: 204
connection refused by server backup restore manager
The media host refused a connection on the port number for bpcd. This error can
be encountered during a backup or restore.
Try the following:
Execute the ping command from one host to another by using the following combina
tions:
Note: Also, see "Resolving Network Communication Problems" in the Troubleshootin
g Guide.
1. From the master server, ping the master and all media servers by using the h
ost names in the storage unit configuration.
2. From each of the media servers, ping the master server by using the name spe
cified in the NetBackup server list. On a UNIX server, this is the first SERVER
entry in the bp.conf file. On a Windows server, the master is designated on the
Servers tab in the Master Server Properties dialog. To access this dialog, see "
Using the Host Properties Window" in the Troubleshooting Guide.
3. On UNIX servers, verify that the bpcd entries in /etc/services or NIS on all
the servers are identical. Verify that the media host is listening on the corre
ct port for connections to bpcd by running one of the following commands (depend
ing on platform and operating system):
netstat -a | grep bpcd
netstat -a | grep 13782 (or the value specified during the install)
rpcinfo -p | grep 13782 (or the value specified during the install)
On UNIX servers, you may have to change the service number for bpcd in /etc/s
ervices and the NIS services map and send SIGHUP signals to the inetd processes
on the clients.
/bin/ps -ef | grep inetd
kill -HUP the_inetd_pid
or
/bin/ps -aux | grep inetd
kill -HUP the_inetd_pid
Note: On a Hewlett-Packard UNIX platform, use inetd -c to send a SIGHUP to inetd
.
4. On Windows servers:
a. Verify that the bpcd entries are correct in:
%SystemRoot%\system32\drivers\etc\services
b. Verify that the NetBackup Client Service Port number and NetBackup Reques
t Service Port number on the Network tab in the NetBackup Client Properties dial
og match the settings in the services file. To display this dialog, start the Ba
ckup, Archive, and Restore interface and select NetBackup Client Properties from
the File menu.
The values on the Network tab are written to the services file when the NetBa
ckup Client service starts.
c. Stop and restart the NetBackup services.
5. See "Testing Media Server and Clients" in the Troubleshooting Guide and "Res
olving Network Communication Problems" in the Troubleshooting Guide.
6. If necessary, create debug log directories for the following processes and r
etry the operation. Then, check the resulting debug logs on the master server:
* If the error occurred during a backup operation, check the bpsched debug l
ogs.
* If the error occurred during a restore operation, check the bprd debug log
s.
7. Run the NetBackup Configuration Validation Utility (NCVU) -conf on the master server for the associated NetBackup media servers. Note
the NetBackup services, ports, and bpcd checks in section one, the media server
hostname and ping checks in sections four and seven.
===============================================================
Error Number: 205
cannot connect to server backup restore manager
A process on the master server could not connect to a process on a host on the n
etwork while trying to initiate communication with the server that has the stora
ge unit for a particular operation. This problem can occur during a backup or re
store in either a single or multiple server configuration. This can also occur w
hen the scheduler process (bpsched) is building its list of available storage un
its to use during backups.
Try the following:
Execute the ping command from one host to another by using the following combina
tions:
Note: Also, see "Resolving Network Communication Problems" in the Troubleshootin
g Guide.
1. From the master server, ping the master and all media servers by using the h
ost names in the storage unit configuration.
2. From each of the media servers, ping the master server by using the name spe
cified in the NetBackup server list. On a UNIX server, this is the first SERVER
entry in the bp.conf file. On a Windows server, the master is designated on the
Servers tab in the Master Server Properties dialog. To access this dialog, see "
Using the Host Properties Window" in the Troubleshooting Guide.
3. On a UNIX server, verify that the bpcd entry in /etc/services or NIS on all
the servers are identical. Verify that the media host is listening on the correc
t port for connections to bpcd by running one of the following commands (dependi
ng on platform and operating system):
netstat -a | grep bpcd
netstat -a | grep 13782 (or the value specified during the install)
rpcinfo -p | grep 13782 (or the value specified during the install)
4. On Windows servers:
a. Verify that the bpcd entries are correct in the services file:
%SystemRoot%\system32\drivers\etc\services
b. Verify that the NetBackup Client Service Port number and NetBackup Reques
t Service Port number on the Network tab in the NetBackup Client Properties dial
og match the settings in the services file. To display this dialog, start the Ba
ckup, Archive, and Restore interface and select NetBackup Client Properties from
the File menu.
The values on the Network tab are written to the services file when the NetBa
ckup Client service starts.
c. Stop and restart the NetBackup services.
5. See "Testing Media Server and Clients" in the Troubleshooting Guide and "Res
olving Network Communication Problems" in the Troubleshooting Guide.
6. Create a bpcd debug log directory on the server that has the storage unit an
d retry the operation. Then, check for additional information in the resulting d
ebug log.
7. Run the NetBackup Configuration Validation Utility (NCVU) -conf on the master server for the associated NetBackup media servers. Note
the NetBackup services, ports, and bpcd checks in section one, the media server
hostname and ping checks in sections four and seven.
===============================================================
Error Number: 206
access to server backup restore manager denied
The master server is trying to start a process on another server (or itself) and
the master server does not appear in the NetBackup server list on that server.
On a UNIX server, the master is the first SERVER entry in the bp.conf file. On a
Windows server, the master is designated on the Servers tab in the Master Serve
r Properties dialog. To access this dialog, see "Using the Host Properties Windo
w" in the Troubleshooting Guide.
Try the following:
1. Verify that the master server appears as a server in its own server list as
well as being listed on all media servers.
If you change the server list on a master server, stop and restart the NetBac
kup database manager and request daemons (UNIX) or the NetBackup Database Manage
r and NetBackup Request Manager services (Windows).
2. If necessary, create debug log directories for the following processes and r
etry the operation. Then, check the resulting debug logs on the master server:
* If the error occurred during a backup operation, check the bpsched debug l
ogs.
* If the error occurred during a restore operation, check the bprd debug log
s.
===============================================================
Error Number: 207
error obtaining date of last backup for client
An error occurred when the backup scheduler (bpsched) tried to obtain the date o
f the last backup for a particular client, policy, and schedule combination.
Try the following:
1. Verify that the NetBackup database manager (bpdbm) process (on UNIX) or the
NetBackup Database Manager service (on Windows) is running.
2. Examine the All Log Entries report for the appropriate time frame to gather
more information about the failure.
3. For detailed troubleshooting information, create debug log directories for b
psched and bpdbm on the master server and retry the operation. Then, check the r
esulting debug logs.
===============================================================
Error Number: 208
failed reading user directed filelist
An error occurred when the backup scheduler (bpsched) attempted to read the list
of files requested for a user backup or archive. This error indicates either a
client-server communication problem, or a system problem on the master server wh
ere the NetBackup scheduler process (bpsched) is running.
Try the following:
For detailed troubleshooting information, create debug log directories for bpsch
ed and bprd on the master server and retry the operation. Then, check the result
ing debug logs.
===============================================================
Error Number: 209
error creating or getting message queue
An error occurred when the backup scheduler (bpsched) attempted to create an int
ernal message queue construct for interprocess communication. This error indicat
es a problem on the master server. On UNIX systems, this may be due to a lack of
system resources for System V interprocess communication.
Try the following:
Create a bpsched debug log directory on the master server and retry the operatio
n. Then, determine the type of system failure by examining the error message in
the bpsched debug log. On UNIX servers, also gather the output of the ipcs -a co
mmand to see what system resources are currently in use.
===============================================================
Error Number: 210
error receiving information on message queue
An error occurred when one of the backup scheduler (bpsched) processes attempted
to receive a message from another bpsched process on an internal message queue
construct. This error indicates a problem on the master server. On UNIX systems,
this may be due to a lack of system resources for System V interprocess communi
cation.
Try the following:
Create a bpsched debug log directory on the master server and retry the operatio
n. Then, determine the type of system failure by examining the error message in
the bpsched debug log on the master server. On UNIX servers, also gather the out
put of the ipcs -a command to see what system resources are currently in use.
===============================================================
Error Number: 211
scheduler child killed by signal
A backup scheduler (bpsched) child process, which interacts with the backup rest
ore manager (bpbrm) on the media host, was terminated. This can occur because of
system administrator action.
Try the following:
Create a debug log directory for bpsched on the master server and retry the oper
ation. Then, to determine the cause of the child termination, examine the messag
es in the bpsched debug log.
===============================================================
Error Number: 212
error sending information on message queue
The backup scheduler (bpsched) encountered an error when attempting to attach to
an already existing internal message queue construct for interprocess communica
tion. This error indicates a problem on the master server. On UNIX systems, this
may be due to a lack of system resources for System V interprocess communicatio
n.
Try the following:
Create a bpsched debug log directory on the master server and retry the operatio
n. Then, determine the type of system failure by examining the error message in
the bpsched debug log. On a UNIX server, also, gather the output of the ipcs -a
command to see what system resources are currently in use.
===============================================================
Error Number: 213
no storage units available for use
The NetBackup scheduler process (bpsched) did not find any of its storage units
available for use. Either all storage units are unavailable or all storage units
are configured for On demand only and the policy and schedule does not require
a specific storage unit.
Try the following:
1. Examine the Backup Status and All Log Entries report for the appropriate tim
e period to determine the policy or schedule that received the error.
2. Verify that the storage unit's drives are not down or waiting for media from
a previous operation that did not complete.
3. Verify that all the storage units do not have their Maximum concurrent jobs
attribute set to 0 (for disk storage units) and Maximum concurrent drives used f
or backup attribute set to 0 (for Media Manager storage units).
4. Verify that the robot number and host name in the storage unit configuration
matches the Media Manager device configuration.
5. Determine if all storage units are set to On demand only for a policy and sc
hedule combination that does not require a specific storage unit. If this is the
case, either specify a storage unit for the policy and schedule combination or
turn off On demand only for a storage unit.
6. If the storage unit is on a UNIX NetBackup media server, it could indicate a
problem with bpcd. Check /etc/inetd.conf on the media server to verify that the
bpcd entry is ok.
If the storage unit is on a Windows NetBackup media server, verify that the N
etBackup Client service has been started on the Windows NetBackup media server.
7. For detailed troubleshooting information, create a bpsched debug log directo
ry on the master server and retry the operation. Then, check the resulting debug
log.
8. Run the NetBackup Configuration Validation Utility (NCVU) -conf on the master server for the associated NetBackup media servers. Note
the storage unit and tpconfig checks in section five.
===============================================================
Error Number: 214
regular bpsched is already running
The NetBackup scheduler (bpsched) performs periodic checking of the policy and s
chedule configuration to determine if there are new backups due. Error 214 indic
ates that when a new instance of NetBackup starts, it finds that a scheduler pro
cess is already checking the policy and schedule configuration.
Try the following:
Usually, no action is required for this condition. However, NEVER kill bpsched b
efore doing some checking. For example, bpsched could be calling bpdbm (NetBacku
p Database Manager service on Windows) to clean up and compress the catalogs.
* To determine what the running bpsched is currently doing, examine the bpsched
debug log on the master server. If necessary, enable bpsched debug logging by c
reating a bpsched debug log directory on the master server and retrying the oper
ation.
* To check for backups do the following:
On a UNIX master server:
1. Check for active or queued backups by using the job monitor.
2. Check for active bp processes with bpps. This reveals if there are bpbrm or
bptm processes running and a backup is active.
3. If there is no reason for bpsched to be running, then use kill -HUP to termi
nate it.
On a Windows NetBackup master server:
1. Check for active or queued backups by using the Activity monitor.
2. Check for active NetBackup processes by using the Activity monitor. This rev
eals if there are bpbrm or bptm processes running and if a backup is active.
3. If there is no reason for bpsched to be running, then kill it from the Activ
ity monitor.
===============================================================
Error Number: 215
failed reading global config database information
During the periodic checking of the NetBackup configuration, the NetBackup sched
uler process (bpsched) was unable to read the global configuration parameters.
Try the following:
1. On a UNIX master server, verify that the NetBackup database manager (bpdbm)
process is running. On a Windows master server, verify that the NetBackup Databa
se Manager service is running.
2. Attempt to view the global configuration settings by using the NetBackup adm
inistration interface (on UNIX systems), or by using Host Properties (on Windows
systems).
3. For detailed troubleshooting information, create debug log directories for b
psched and bpdbm on the master server and retry the operation. Then, check the r
esulting debug logs.
===============================================================
Error Number: 216
failed reading retention database information
During its periodic checking of the NetBackup configuration, the NetBackup sched
uler process (bpsched) could not read the list of retention levels and values.
Try the following:
1. On a UNIX master server, verify that the NetBackup database manager (bpdbm)
process is running. On a Windows master server, verify that the NetBackup Databa
se Manager service is running.
2. For detailed troubleshooting information, create debug log directories for b
psched and bpdbm on the master server and retry the operation. Then, check the r
esulting debug logs.
===============================================================
Error Number: 217
failed reading storage unit database information
During its periodic checking of the NetBackup configuration, the NetBackup sched
uler process (bpsched) could not read the storage unit configuration.
Try the following:
1. On a UNIX server, verify that the NetBackup database manager (bpdbm) process
is running. On a Windows server, verify that the NetBackup Database Manager ser
vice is running.
2. Attempt to view the storage unit configuration by using the NetBackup admini
stration interface.
3. For detailed troubleshooting information, create debug logs for bpsched and
bpdbm on the master server and retry the operation. Then, check the resulting de
bug logs.
Ensure that the correct master server is being specified for the connection.
4. Run the NetBackup Configuration Validation Utility (NCVU) -conf on the master server for the associated NetBackup media servers. Note
the storage unit checks in section five.
===============================================================
Error Number: 218
failed reading policy database information
During the periodic checking of the NetBackup configuration, the NetBackup sched
uler process (bpsched) could not read the policy (backup policy) configuration.
Try the following:
1. On a UNIX server, verify that the NetBackup Database Manager (bpdbm) process
is running. On a Windows server, verify that the NetBackup Database Manager ser
vice is running.
2. Attempt to view the policy configuration by using the NetBackup administrati
on interface.
3. For detailed troubleshooting information, create debug log directories for b
psched and bpdbm on the master server and retry the operation. Then, check the r
esulting debug logs.
Ensure that the correct master server is being specified for the connection.
===============================================================
Error Number: 219
the required storage unit is unavailable
The policy or schedule for the backup requires a specific storage unit, which is
currently unavailable. This error also occurs for other attempts to use the sto
rage unit within the current backup session.
Try the following:
Look in the Job Details window for the failed job.
1. Verify that the schedule specifies the correct storage unit and the storage
unit exists.
2. Verify that the Media Manager device daemon (ltid) is running (if the server
is UNIX) or the NetBackup Device Manager service is running (if the server is a
Windows system). Use bpps on UNIX and the Activity Monitor on Windows or the Se
rvices application in the Windows Control Panel.
3. Verify that the Maximum concurrent jobs attribute is not set to 0 (for a dis
k storage unit) and the Maximum concurrent drives attribute is not set to 0 (for
a Media Manager storage unit).
4. If the storage unit is a tape or optical disk, verify that at least one of t
he drives is in the UP state. Use the Device Monitor.
5. Verify that the robot number and host in the storage unit configuration matc
hes what is specified in the Media Manager device configuration.
6. Verify that the master server can communicate with the bpcd process on the s
erver that has the storage unit.
a. Verify that bpcd is listening on the port for connections.
On a UNIX server, executing
netstat -a | grep bpcd
should return something similar to the following:
*.bpcd *.* 0 0 0 0 LISTEN
Do this on the server where the storage unit is connected.
On a Windows NetBackup server, executing
netstat -a
prints out several lines of output. If bpcd is listening, one of those lines
is similar to the following:
TCP myhost:bpcd 0.0.0.0:0 LISTENING
Do this on the server where the storage unit is connected.
b. If bpcd seems to be operating correctly, create bpsched and bpcd debug lo
g directories and retry the operation. Check the resulting debug logs for record
s of an earlier failure.
After each backup, the scheduler checks the storage unit to see how many driv
es are available (in case the backup caused a drive to be automatically downed).
If bpsched cannot communicate with bpcd, it sets the number of available drives
in that storage unit to 0 and further backups to that storage unit during this
backup session will fail.
The number of available drives remains at 0 until the scheduler is initialize
d again.
c. If the cause of the problem is not obvious, perform some of the steps in
"Resolving Network Communication Problems" in the Troubleshooting Guide.
7. Run the NetBackup Configuration Validation Utility (NCVU) -conf on the master server for the associated NetBackup media servers. Note
the policy, storage unit, and tpconfig checks in section five, and the bpcd chec
ks in section one.
===============================================================
Error Number: 220
database system error
The bpdbm process (on UNIX), or the NetBackup Database Manager service (on Windo
ws) could not create a directory path for its configuration catalogs due to the
failure of a system call. This is usually due to a permission problem or an "out
of space" condition.
Try the following:
Create a debug log directory for bpdbm and retry the operation. Check the result
ing debug log for information.
===============================================================
Error Number: 221
continue
This status code is used in coordinating communication between various NetBackup
processes and normally does not occur. If the logs show that it is associated w
ith a subsequent error, it usually indicates a communication problem. In this ca
se, concentrate your troubleshooting efforts on the subsequent error.
Try the following:
Determine the cause of the status code that follows this one.
===============================================================
Error Number: 222
done
This status code is used in coordinating communication between various NetBackup
processes and is normally not seen. If the error logs show that it is associate
d with a subsequent error, it usually indicates a communication problem. In this
case, concentrate your troubleshooting efforts on the subsequent error.
Try the following:
Determine the cause of the status code that follows this one.
===============================================================
Error Number: 223
an invalid entry was encountered
A request to the bpdbm process (on UNIX) or the NetBackup Database Manager servi
ce (on Windows) had invalid or conflicting information. This is usually a result
of using software from different versions together, but can also be caused by i
ncorrect parameters on a command.
Try the following:
Verify that all NetBackup software is at the same version level and the command
parameters are specified correctly. If neither of these is the problem, obtain d
etailed troubleshooting information by creating a bpdbm debug log directory and
retrying the operation. Check the resulting debug log.
===============================================================
Error Number: 224
there was a conflicting specification
A request to the bpdbm process (on UNIX) or the NetBackup Database Manager servi
ce (on Windows) had conflicting information. This is usually a result of using s
oftware from different version levels together.
Try the following:
Verify that all NetBackup software is at the same version level. If that is not
the problem, obtain detailed troubleshooting information by creating bpdbm and a
dmin debug log directories and retrying the operation. Check the resulting debug
logs.
===============================================================
Error Number: 225
text exceeded allowed length
A request containing text that exceeds a buffer size was made to the bpdbm proce
ss (on UNIX), or the NetBackup Database Manager service (on Windows). This is us
ually a result of using software from different version levels together.
Try the following:
Verify that all NetBackup software is at the same version level. If that is not
the problem, create debug log directories for bpdbm and admin. Then, retry the o
peration and examine the resulting debug logs.
===============================================================
Error Number: 226
the entity already exists
The configuration already has an entity with the same name or definition. For ex
ample, you see this status if you try to add a new policy when an existing polic
y has the same name or definition (attributes, clients, and so on).
Try the following:
Correct your request and re-execute the command.
===============================================================
Error Number: 227
no entity was found
The item requested was not in the catalog. For example, the entity could be a fi
le or policy information.
Try the following:
A common cause for this problem is a query that has no matching images. Specify
different parameters or options for the operation and try it again.
===============================================================
Error Number: 228
unable to process request
An inconsistency exists in the catalog or a request was made that would be impro
per to satisfy.
Try the following:
1. If this involves a media server, verify that its server list specifies the c
orrect master server. On a UNIX server, the master server is the first SERVER en
try in the bp.conf file. On a Windows server, the master is designated on the Se
rvers tab in the Master Server Properties dialog. To access this dialog, see "Us
ing the Host Properties Window" in the Troubleshooting Guide.
2. For detailed troubleshooting information, create a bpdbm debug log directory
and retry the operation. Then, check the resulting debug log.
===============================================================
Error Number: 229
events out of sequence - image inconsistency
A request was made which, if satisfied, would cause the image catalog to become
inconsistent.
Try the following:
Obtain detailed troubleshooting information by creating a debug log directory fo
r bpdbm. Then, retry the operation, save the resulting debug log, and call custo
mer support.
===============================================================
Error Number: 230
the specified policy does not exist in the configuration database
The specified policy name does not exist.
Try the following:
Correct your parameters or options and retry the operation.Run the NetBackup Con
figuration Validation Utility (NCVU) -conf on the master s
erver for the associated NetBackup media servers. Note the policy checks in sect
ion five.
===============================================================
Error Number: 231
schedule windows overlap
The start and duration times specified for one day of the schedule overlap with
another day of the schedule.
Try the following:
Correct the schedule to eliminate the overlapping backup windows.
===============================================================
Error Number: 232
a protocol error has occurred
This is an intermediate status code that usually precedes another status code. I
t indicates that either the bpdbm process (on UNIX) or the NetBackup Database Ma
nager service (on Windows) or the process communicating with it has received une
xpected information.
Try the following:
Create a debug log directory for bpdbm. Then, retry the operation, save the debu
g log, and call customer support.
===============================================================
Error Number: 233
premature eof encountered
This is an intermediate status code that usually precedes another status code an
d is associated with a problem in network communication.
Try the following:
During a restore, this means that tar (on the client) received a stream of data
that was not what it expected. If this is a new configuration, verify that the t
ape drive is configured for variable mode (see the Media Manager Device Configur
ation Guide).If the communication failure is not due to an interrupt on a client
system, save all error information and call customer support.
===============================================================
Error Number: 234
communication interrupted
This is an intermediate status code that usually precedes another status code an
d is associated with a problem in network communication. A process, either serve
r or client, received an interrupt signal.
Try the following:
Save all error information and call customer support.
===============================================================
Error Number: 235
inadequate buffer space
This code usually indicates a mismatch between server and client software versio
ns.
Try the following:
1. Verify that all NetBackup software is at the same version level. Update earl
ier versions of NetBackup software.
* On UNIX NetBackup servers and clients, check the /usr/openv/netbackup/bin/
version file.
* On Windows NetBackup servers, check the install_path\NetBackup\version.txt
file or the About NetBackup item on the Help menu.
* On Microsoft Windows clients, check the About NetBackup item on the Help m
enu.
* On NetWare target clients, check the Version entry in the bp.ini file.
If the client software is earlier than 3.0, verify that the client is in a St
andard type policy.
* On Macintosh clients, check the version file in the bin folder in the NetB
ackup folder in the Preferences folder.
2. If the problem persists, save all error information and call customer suppor
t.
===============================================================
Error Number: 236
the specified client does not exist in an active policy within the configuration
database
A client name was not specified or the specified client does not exist.
Try the following:
Activate the required policy, correct the client name, or add the client to a po
licy that meets your needs. After making the correction, retry the operation.Run
the NetBackup Configuration Validation Utility (NCVU) -conf on the master server for the associated NetBackup media servers. Note the pol
icy checks in section five.
===============================================================
Error Number: 237
the specified schedule does not exist in an active policy in the configuration d
atabase
The specified schedule does not exist in the NetBackup configuration.
Try the following:
Activate the required policy, correct the schedule name, or create a schedule in
a policy that meets your needs. After making the correction, retry the operatio
n.Run the NetBackup Configuration Validation Utility (NCVU) -conf on the master server for the associated NetBackup media servers. Note th
e policy checks in section five.
===============================================================
Error Number: 238
the database contains conflicting or erroneous entries
The catalog has an inconsistent or corrupted entry.
Try the following:
Obtain detailed troubleshooting information for bpdbm (on UNIX) or the NetBackup
Database Manager service (on Windows) by creating a debug log directory for it.
Then, retry the operation, save resulting debug log, and call customer support.
===============================================================
Error Number: 239
the specified client does not exist in the specified policy
The specified client is not a member of the specified policy.
Try the following:
Correct the client name specification, specify a different policy, or add the re
quired client name to the policy. After making the correction, retry the operati
on.Run the NetBackup Configuration Validation Utility (NCVU) -conf on the master server for the associated NetBackup media servers. Note t
he policy checks in section five.
===============================================================
Error Number: 240
no schedules of the correct type exist in this policy
The appropriate schedule was not found in the specified policy. For example, a u
ser backup specified a policy name but no user backup schedule exists in that po
licy.
Try the following:
Specify a different policy or create a schedule of the needed type in the policy
. After making the correction, retry the operation.
===============================================================
Error Number: 241
the specified schedule is the wrong type for this request
The schedule that was specified for an immediate manual backup is not for a full
nor an incremental backup. It must be one of these.
Try the following:
Specify only full or incremental schedules for manual backups. If one does not e
xist in the policy, create one.
===============================================================
Error Number: 242
operation would cause an illegal duplication
Processing the request would cause a duplicate catalog entry. This is usually du
e to a mistake in specifying media IDs for NetBackup catalog backups.
Try the following:
Check the error reports to determine the specific duplication that would occur.
Correct the settings for the operation and retry it.
===============================================================
Error Number: 243
the client is not in the configuration
The specified client name was not in the catalog.
Try the following:
Either correct the client name or add the client to the desired policy.Run the N
etBackup Configuration Validation Utility (NCVU) -conf on the ma
ster server for the associated clients. Note the policy checks in section four.
===============================================================
Error Number: 244
main bpsched is already running
A bpsched process tried to become the main backup scheduler but another process
is currently in this mode.
Try the following:
None.
===============================================================
Error Number: 245
the specified policy is not of the correct client type
A user backup specified a policy that is not the type required for the client.
Try the following:
Retry the operation by specifying a policy that is the correct type for the clie
nt. If such a policy does not exist, create one.
===============================================================
Error Number: 246
no active policies in the configuration database are of the correct client type
A user backup request was not satisfied because no active policies were the type
required for the client.
Try the following:
Create or activate an appropriate policy so the user backup request can be satis
fied.
===============================================================
Error Number: 247
the specified policy is not active
Backups for the specified policy are disabled because the policy is inactive.
Try the following:
Activate the policy and retry the operation.
===============================================================
Error Number: 248
there are no active policies in the configuration database
No active policy was found that would satisfy the request.
Try the following:
Activate the appropriate policy and retry the operation.
===============================================================
Error Number: 249
the file list is incomplete
The server timed out while waiting for the client to finish sending the file lis
t, or a sequencing problem occurred.
Try the following:
Obtain additional information by first creating debug logs and then attempting t
o recreate the error. The debug logs to create are as follows:
* On the server, bptm, bpbrm, and bpdbm.
* On UNIX and Windows clients, bpbkar.
* On other clients, bpcd.
Note: To increase the amount of information included in the logs, see "Debug Log
s on PC Clients" in the Troubleshooting Guide.
===============================================================
Error Number: 250
the image was not created with TIR information
This is an internal error and should not be seen by customers.
Try the following:
Obtain detailed troubleshooting information by creating debug logs for bptm and
bpdbm on the server. Then, retry the operation and check the resulting debug log
s.
===============================================================
Error Number: 251
the tir information is zero length
For a true-image backup, the client sent no file information to the master serve
r. NetBackup discovered this condition when it attempted to write the TIR inform
ation to media.
Try the following:
1. Check the file list for the policy and the exclude and include lists on the
client to verify that the client has files that are eligible for backup. For exa
mple, this status code can appear if the exclude list on the client excludes all
files.
2. To obtain detailed troubleshooting information, create debug logs for bptm a
nd bpdbm on the server. Then, retry the operation and check the resulting debug
logs.
===============================================================
Error Number: 252
the error status has been written to stderr
If a Vault or Synthetic Backup job fails with a status code greater than 255, it
exits with status 252; the actual Vault or Synthetic Backup job status code is
written to stderr. Status codes greater than 255 are not preserved via the exit
system call by all operating systems. The Vault or Synthetic Backup job then rep
orts the actual status code found in stderr (for example, 256) as the job comple
tion status, as seen in the Activity Monitor.
Try the following:
For more information on a Vault or Synthetic Backup status code, refer to this r
esource or to the Activity Monitor's troubleshooter.
===============================================================
Error Number: 253
the catalog image .f file has been archived
The catalog image .f file has been archived.
Try the following:
Refer to catalog archiving help information to restore archived catalog image .f
files.
===============================================================
Error Number: 254
server name not found in the NetBackup configuration
This error should not occur through normal use of NetBackup.
Try the following:
Save all error information and call customer support.Run the NetBackup Configura
tion Validation Utility (NCVU) -conf on the master server
for the associated NetBackup media servers. Note the bp.conf checks in section f
our.
===============================================================
Error Number: 255
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 256
logic error encountered
An internal vault error occurred.
Try the following:
Contact customer support and send appropriate logs.
===============================================================
Error Number: 257
cannot create log file
vltrun cannot create one or more log files
Try the following:
When a Vault session is started, vltrun needs to create log files in the followi
ng directories:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name
Windows: install_path\Netbackup\vault\sessions\vault_name
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path \NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
Ensure that the following directory exists, is writable by root, and that the
disk is not full:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name
Windows: install_path\NetBackup\vault\sessions\vault_name
===============================================================
Error Number: 258
a child process failed for an unknown reason
A child process of the vault job died with an invalid exit status.
Try the following:
Contact customer support and send appropriate logs.
===============================================================
Error Number: 259
vault configuration file not found
This error should not occur.
Try the following:
Contact customer support and send appropriate logs.
===============================================================
Error Number: 260
vault internal error 260
This error code should not occur.
Try the following:
Contact customer support and send appropriate logs.
===============================================================
Error Number: 261
vault internal error 261
This error code should not occur.
Try the following:
Contact customer support and send appropriate logs.
===============================================================
Error Number: 262
vault internal error 262
This error code should not occur.
Try the following:
Contact customer support and send appropriate logs.
===============================================================
Error Number: 263
session id assignment failed
The unique identifier to be assigned to the vault session is bad.
Try the following:
Verify that the session id stored in the session.last file is valid.
UNIX:
/usr/openv/netbackup/vault/sessions/vault_name/session.last
Windows: install_path\Netbackup\vault\sessions\vault_name\session.last
Make sure that the file system is not full and that no one has inadvertently
edited the session.last file. You can correct the problem by storing in the sess
ion.last file the highest session id that has been assigned to a session for thi
s vault. If the problem persists, contact customer support and send the appropri
ate logs.
===============================================================
Error Number: 264
Error: Can't find Troubleshooting Guide, or status code not available.
===============================================================
Error Number: 265
session id file is empty or corrupt
The session id stored in the following file is bad.
UNIX:
/usr/openv/netbackup/vault/sessions/vault_name/session.last
Windows: install_path\NetBackup\vault\sessions\vault_name\session.last
Try the following:
Ensure that the session id stored in the session.last file is not corrupt. Make
sure that the file system is not full and that no one has inadvertently edited t
he file. You can correct the problem by storing in the session.last file the hig
hest session id that has been assigned to a session for this vault. If the probl
em persists, contact customer support and send the appropriate logs.
===============================================================
Error Number: 266
cannot find robot, vault, or profile in the vault configuration
The profile name or triplet robot_name/vault_name/profile_name specified on the
vault command (vltrun, vlteject, vltoffsitemedia), or by means of vltopmenu, was
not found in the vault configuration.
Try the following:
Please rerun the command with the correct profile_name or triplet robot_name/vau
lt_name/profile_name.
===============================================================
Error Number: 267
cannot find the local host name
A vault job obtains the local host name via an OS call. This error occurs when t
he vault job is unable to get the local host name.
Try the following:
Issue a hostname command at the OS command prompt. See the hostname (or gethostb
yname) man page for an explanation of the conditions that would cause it to fail
. Refer to the OS System Administrator Guide for more information
===============================================================
Error Number: 268
the vault session directory is either missing or inaccessible
This error occurs when a vault job cannot access the following:
UNIX: /usr/openv/netbackup/vault/sessions
Windows: install_path\NetBackup\vault\sessions
This directory is created when vault is installed.
Try the following:
Make sure you are running on the master server where vault is installed and conf
igured. Also ensure that no one has accidently removed the sessions directory or
changed permission on the directory path so it is inaccessible to the vault job
.
===============================================================
Error Number: 269
no vault session id was found
This error is encountered when vltopmenu cannot find a sidxxx session id directo
ry for the specified profile. It means that either no vault jobs were run for th
is profile or that the corresponding sidxxx session id directory (or directories
) were removed from the following directory:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name
Windows: install_path\NetBackup\vault\sessions\vault_name
Try the following:
You can either specify a different profile for which vault jobs have been run or
exit vltopmenu, run a vault job for the specific profile and rerun vltopmenu an
d select the profile.
===============================================================
Error Number: 270
unable to obtain process id, getpid failed
This error occurs when a vault process is unable to obtain its process id by mea
ns of the getpid() OS system call.
Try the following:
Look at the system log for any unusual system problems. Wait for a while and try
running the process again when system resources have been freed up.
===============================================================
Error Number: 271
the initialization of the vault configuration file failed
This error occurs when configuration initialization code fails.
Try the following:
Ensure that the following is accessible:
UNIX: /usr/openv/netbackup/lib/libxerces-c1_4nmt.so
Windows: install_path\NetBackup\lib\libxerces-c1_4nmt.so
===============================================================
Error Number: 272
execution of a vault notify script failed
This error occurs when the vault process is unable to execute a vault notify scr
ipt due to permissions problems or coding problems in the script or if an error
is returned by the script.
Try the following:
Ensure that the notify script is executable and runs without errors. You must de
bug the script by running it manually to eliminate coding errors.
===============================================================
Error Number: 273
invalid job id
This error should not occur.
Try the following:
Contact customer support and send appropriate logs.
===============================================================
Error Number: 274
no profile was specified
This error should not occur.
Try the following:
Contact customer support and send the appropriate logs.
===============================================================
Error Number: 275
a session is already running for this vault
This error occurs when you start a session for a vault and another session is al
ready running for this vault. Only one session is allowed for a vault at any giv
en time.
Try the following:
Start the vault session after the previous session has completed.
===============================================================
Error Number: 276
invalid session id
This error should not occur.
Try the following:
Contact customer support and send the appropriate logs.
===============================================================
Error Number: 277
unable to print reports
This error should not occur.
Try the following:
Contact customer support and send the appropriate logs.
===============================================================
Error Number: 278
unimplemented error code
This error should not occur.
Try the following:
Contact customer support and send the appropriate logs.
===============================================================
Error Number: 279
unimplemented error code
This error should not occur.
Try the following:
Contact customer support and send the appropriate logs.
===============================================================
Error Number: 280
unimplemented error code
This error should not occur.
Try the following:
Contact customer support and send the appropriate logs.
===============================================================
Error Number: 281
vault core error
An internal vault error occurred.
Try the following:
Contact customer support and send the appropriate logs.
===============================================================
Error Number: 282
vault core system error
An internal system exception was encountered by the vault job.
Try the following:
Contact customer support and send appropriate logs.
===============================================================
Error Number: 283
vault core unhandled error
The vault job encountered a system exception.
Try the following:
Contact customer support and send appropriate logs.
===============================================================
Error Number: 284
error caused by invalid data in vault configuration file
This error is returned by a vault job or a command when it cannot interpret the
information extracted from the vault configuration file. For example, if the vau
lt configuration file is corrupt or refers to non-existent or misconfigured obje
cts.
Try the following:
Ensure that your vault configuration is correct (that it refers to functional ro
bots, media servers, volume pools, and so forth). Also ensure that the vault pro
file is defined in the configuration and has not been accidently removed after t
he vault job was started. This can happen when more than one vault interface is
changing the configuration at the same time. Examine the vault logs for detailed
information about configuration problems. To correct the problem, you may need
to restore the following file from a backup copy:
UNIX: /usr/openv/netbackup/db/vault/vault.xml
Windows: install_path\NetBackup\db\vault\vault.xml
===============================================================
Error Number: 285
unable to locate vault directory
This error is returned by a vault job or command when it cannot locate the follo
wing directory:
UNIX: /usr/openv/netbackup/vault
Windows: install_path\NetBackup\vault
Try the following:
The vault directory is created when the vault package is installed on the master
server. Ensure that the vault job or command is started as root on the master s
erver and that the vault directory has not been inadvertently removed or made in
accessible to root user.
===============================================================
Error Number: 286
vault internal error
This error should never occur.
Try the following:
Contact customer support and send the appropriate logs.
===============================================================
Error Number: 287
failed attempting to copy (consolidated) report file
This error occurs when a vault job is unable to copy the consolidated reports to
the destination directory specified in the vault profile.
Try the following:
Ensure that the destination directory specified in the profile exists and is wri
table by root. Also the vault job or command must be started with root privilege
s. Correct the path and/or permissions of the destination directory and rerun th
e vault job or command.
===============================================================
Error Number: 288
attempt to open a log file failed
This error occurs when a vault job cannot create the summary.log file in the fol
lowing directory:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\Netbackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id.)
Try the following:
Ensure that the above directory exists and has not been inadvertently removed af
ter the vault job was started. Ensure that this directory is writable by root an
d that the disk is not full. Rerun the vault job after correcting the problem.
===============================================================
Error Number: 289
an error occurred when calling vault core
The error can occur during a normal vault job or when vlteject is executed for a
specific session or when vltopmenu is used to generate individual reports, if a
ny of the following conditions exists:
* vltcore binary is removed
* vltopmenu binary is not executable
* the following directory is removed or made inaccessible to root (where xxx is
the session id):
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\Netbackup\vault\sessions\vault_name\sidxxx
* the disk (on which NetBackup is installed) is full
Try the following:
To identify which of the above conditions led to the failure, review the vault d
ebug log in the following directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Also review the summary.log file in each of the sidxxx directories that had p
roblems:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
Correct the problem and rerun the vault job. If the problem persists, please
contact customer support and send the appropriate logs.
===============================================================
Error Number: 290
one or more errors detected during eject processing
This error occurs when more than one error is encountered during an eject proced
ure via vltopmenu. Any "eject" errors in the range 291 to 300 could have occurre
d in any of the sessions being ejected.
Try the following:
For detailed information, review the vault debug log in the following directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Also review the summary.log in each of the sidxxx directories that had proble
ms:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
The media that was not ejected may need to be ejected manually by means of vl
teject or vltopmenu, after the problem has been identified and corrected.
This error often indicates that the media were left in the offsite vault volu
me group but still physically reside in the robot or in the robotic MAP. To solv
e this problem, do one of the following:
* Manually remove any media that are in the offsite vault volume group but are
still in the robotic library.
* Inventory the robotic library. This puts any media that were in the offsite v
ault volume group back into the robotic volume group. Then, rerun the vault sess
ions that failed.
===============================================================
Error Number: 291
number of media has exceeded capacity of MAP; must perform manual eject using vl
topmenu or vlteject
This error occurs when a vault job is run for a profile that has selected automa
tic eject mode and the number of media to be ejected exceeds the capacity of the
MAP.
Try the following:
Use vltopmenu to manually eject the media for the selected profile and session i
d. The vltopmenu option will let you eject the selected media, a MAP-full (or le
ss) at a time.
===============================================================
Error Number: 292
eject process failed to start
This error occurs when the eject processing cannot be started by the vault job o
r vlteject command or via vltopmenu.
Try the following:
For detailed information about the problem, review the vault debug log in the fo
llowing directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Also review the summary.log in each of the sidxxx directories that had proble
ms:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
Use the robtest utility to ensure that you can communicate with the vault rob
otic library. Once the problem is resolved, rerun the vault session, vlteject co
mmand, or vltopmenu command.
===============================================================
Error Number: 293
eject process has been aborted
This error occurs when the eject processing has been aborted. This error could b
e encountered during a vault job or when using vlteject or the vltopmenu eject c
ommand.This error can occur because of one of the following conditions:
* Could not open a pipe to vmchange -verify_eject call.
* Unexpected output from vmchange -verify_eject call.
* There are no MAP elements to eject media into.
* The robotic library had problems putting media into the MAP.
* The user hit Return in interactive mode without first removing the media from
the MAP. In this case, the media that were in the MAP will be put back into the
ir original slots in the robotic library.
Try the following:
For detailed information about why the process was aborted, review the vault deb
ug log in the following directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Also review the summary.log in each of the sidxxx directories that had proble
ms:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
This error often indicates that the media were left in the offsite vault volu
me group but still physically reside in the robot or in the robotic MAP. To solv
e this problem, do one of the following:
* Manually remove any media that are in the offsite vault volume group but are
still in the robotic library.
* Inventory the robotic library. This puts any media that were in the offsite v
ault volume group back into the robotic volume group. Then, rerun the vault sess
ions that failed.
===============================================================
Error Number: 294
database backup failed
The catalog backup step failed during a vault job.
Try the following:
For detailed information about why the process failed, review the vault debug lo
g in the following directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Also review the summary.log in each of the sidxxx directories that had proble
ms, to find the actual problem that caused the catalog backup (bpbackupdb) to fa
il:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
Correct the problem and rerun the vault job.
===============================================================
Error Number: 295
eject process could not obtain information about the robot
This error occurs when the eject process cannot collect information about the ro
botic library and its associated MAPs and volumes.
Try the following:
For detailed information about why the process failed, review the vault debug lo
g in the following directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Also review the summary.log in each of the sidxxx directories that had proble
ms:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
Correct the error and rerun the vault session, vlteject command, or vltopmenu
eject command.
===============================================================
Error Number: 296
process called but nothing to do
This error occurs in the following situations:vlteject is called with -eject and
there are no tapes to ejectvlteject is called with -eject and the eject is alre
ady donevlteject is called with -report and the reports are already donevlteject
is called with -eject and -report, and both the eject and the reports are done
Try the following:
This is an informative error and does not require any action.
===============================================================
Error Number: 297
all volumes are not available to eject
This error occurs when an attempt is made to eject a non-existent or bad media i
d during the eject phase of a vault session, vlteject command, or vltopmenu comm
and.Possible reasons for this occurring are:
* The bad media id was added by means of the vlt_ejectlist_notify script.
* The bad media id is already in the MAP or not in the robotic library.
* The bad media id is in a robotic drive.
* The bad media id is in transit in the robotic library.
Try the following:
Remove or correct the bad media id from the vlt_ejectlist_notify script and reru
n the vault session. If the bad media id is in the MAP or a drive or in transit,
something is misconfigured.
===============================================================
Error Number: 298
the library is not ready to eject volumes
This error occurs if the robotic library is not in a state to support ejecting m
edia.Possible reasons for this include:
* The library is currently ejecting media
* The library is pending ejecting media
* The library is currently injecting media
* The library is pending injecting media
Try the following:
Wait until the robotic library can support the eject action and rerun the vault
session, vlteject command, or vltopmenu command.
===============================================================
Error Number: 299
there is no available MAP for ejecting
The robotic library you are vaulting from does not have a MAP available for use
and so media cannot be ejected.
Try the following:
Wait until the robotic library's MAP is available for use and rerun the vault se
ssion, vlteject command, or vltopmenu command.
===============================================================
Error Number: 300
vmchange eject verify not responding
During the eject process, the vmchange command is called with a "-verify_eject"
call until all of the volumes for the request are in the MAP. This command call
failed or did not return the proper information to the vault eject process.
Try the following:
For detailed information about why the process failed, review the vault debug lo
g in the following directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Also review the summary.log in each of the sidxxx directories that had proble
ms:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
This error often indicates that the media were left in the offsite vault volu
me group but still physically reside in the robot or in the robotic MAP. To solv
e this problem, do one of the following:
* Manually remove any media that are in the offsite vault volume group but are
still in the robot.
* Inventory the robot. This puts any media that were in the offsite vault volum
e group back into the robotic volume group. Then, rerun the vault sessions that
failed.
===============================================================
Error Number: 301
vmchange api_eject command failed
During the eject process, the vmchange command is called with an "-api_eject" ca
ll to begin the process of ejecting media. This command call failed.
Try the following:
For detailed information about why the process failed, review the vault debug lo
g in the following directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Also review the summary.log in each of the sidxxx directories that had proble
ms:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
Once the problem is resolved, rerun the vault session, vlteject command, or v
ltopmenu command.
===============================================================
Error Number: 302
error encountered attempting backup of catalog (multiple tape catalog backup)
This error occurs when the NetBackup command used for stage one of the two-stage
catalog backup fails.
Try the following:
For the actual error that caused the failure, review the vault debug log in the
following directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Review the summary.log in each of the sidxxx directories that had problems:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
In addition, review the admin debug log in the following directory:
UNIX: /usr/openv/netbackup/logs/admin
Windows: install_path\NetBackup\logs\admin
Correct the error and rerun the vault session.
===============================================================
Error Number: 303
error encountered executing Media Manager command
This error occurs when a Media Manager command fails during a vault job.
Try the following:
For the actual error that caused the Media Manager command to fail, review the v
ault debug log in the following directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Also review the summary.log in each of the sidxxx directories that had proble
ms:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
Try running the Media Manager command (with the same arguments as in the log
file) to see the actual error. Ensure that the Media Manager daemons are running
. Also ensure that the robot is functional and you can communicate with it (for
example, inventory the robot via the GUI).
===============================================================
Error Number: 304
specified profile not found
This error occurs when the profile name specified on the vault command is not de
fined in the vault configuration.
Try the following:
Please rerun the vault command with a profile name that is defined in the vault
configuration.
===============================================================
Error Number: 305
duplicate profile specified, use full robot/vault/profile
This error occurs when duplicate profile names have been defined in two or more
vault configurations and only the profile name is specified on the vault command
.
Try the following:
You must rerun the vault command with the triplet robot_name/vault_name/profile_
name. The triplet will uniquely identify the profile in your vault configuration
.
===============================================================
Error Number: 306
errors encountered, partial success
This error occurs when a vault job is partially successful, in other words, when
not all images have been successfully duplicated and/or the catalog backup fail
ed.
Try the following:
For more information, review the vault debug log in the following directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Also review the summary.log in each of the sidxxx directories that had proble
ms:
UNIX: /usr/openv/netbackup/vault/sessions/vault_name/sidxxx
Windows: install_path\NetBackup\vault\sessions\vault_name\sidxxx
(where xxx is the session id)
A common cause of failure is the lack of resources, such as no more media ava
ilable in the specified pools for duplication and catalog backup. Correct the pr
oblem and rerun the vault job. Note that the NetBackup scheduler will retry a va
ult job that has terminated with this error.
===============================================================
Error Number: 307
eject process has already been run for the requested vault session
This error occurs when vlteject is run to eject media for a session id for which
media has already been ejected.
Try the following:
Rerun vlteject for another session id for which media has not been ejected.
===============================================================
Error Number: 308
no images duplicated
This error occurs when vault failed to duplicate any images.
Try the following:
For more information, review the vault debug log in the following directory:
UNIX: /usr/openv/netbackup/logs/vault
Windows: install_path\NetBackup\logs\vault
Also review the summary.log in each of the sidxxx directories that had proble
ms:
UNIX: /usr/openv/netbackup/vault/sessions/sidxxx
Windows: install_path\NetBackup\vault\sessions\\sidxxx
(where is the name of the vault, and xxx is the session id)
Look for the log entry that gives the total number of images processed. A com
mon cause of failure is a lack of resources, such as no more media available in
the specified pools for duplication. Correct the problem and rerun the vault job
. Note that the NetBackup scheduler will retry a vault job that has terminated w
ith this error. Review the admin debug log for bpduplicate entries and the bptm
debug log.
===============================================================
Error Number: 309
report requested without eject being run
This error occurs when a report is run that requires media to have been ejected
first.
Try the following:
Perform one of these actions:
* Rerun vlteject or vltopmenu to eject the media for the session before generat
ing the reports.
* Reconfigure the profile to allow the eject step to be performed when the next
vault session for this profile runs.
* Disable the report generation in the profile for reports that require media t
o be ejected.
===============================================================
Error Number: 310
invalid configuration for duplication to disk
This error occurs when an invalid disk storage unit is configured in the vault p
rofile used to duplicate images to disk, or when the profile is configured to cr
eate more than one copy and one of the copies is targeted for a disk storage uni
t. The latter configuration will be prevented by the vault interface and should
not occur unless the vault configuration file has been manually altered.
Try the following:
Ensure that a valid disk storage unit is configured in the profile by means of t
he duplication tab. Also ensure that the vault configuration file has not been m
anually altered.
===============================================================
Error Number: 311
Iron Mountain Report is already created for this session
This error occurs when an Iron Mountain report has already been generated for th
e session.
Try the following:
None; this report cannot be generated again.
===============================================================
Error Number: 312
invalid container database entry
NetBackup Vault has found an invalid entry while reading the container database.
Each container entry in the container database must follow the expected format.
The container database exists in file cntrDB, which is located at /netbackup/vault/sessions/cntrDB.
Try the following:
To get the line number of an invalid record in the container database, read the
log file under the directory netbackup/logs/vault. Be aware that a Vault log may
not exist unless the directory netbackup/logs/vault existed before the error oc
cured.Open the container database file cntrDB and correct that invalid entry.
Please note that this error will occur every time Vault reads this entry in cntr
DB until either this invalid entry is deleted or it is corrected.
===============================================================
Error Number: 313
container does not exist in container database
The specified container does not have an entry in the container database. The co
ntainer database exists in file cntrDB, which is located at /netba
ckup/vault/sessions/cntrDB.
Try the following:
Verify that you have put some media into this container using the vltcontainers
command. Verify that you have not deleted it using the vltcontainers -delete com
mand.
===============================================================
Error Number: 314
container database truncate operation failed
An error ocurred while truncating the container database. This error may occur w
hile modifying or deleting an entry from the container database. The container d
atabase exists in file cntrDB, which is located at /netbackup/vaul
t/sessions/cntrDB.
Try the following:
Please see the log file under the directory netbackup/logs/vault for more detail
s. Be aware that a log file will not be created unless the netbackup/logs/vault
directory has already been created.
===============================================================
Error Number: 315
failed appending to container database
This error occurred while appending a container record to the container database
. This error may occur while adding, modifying or deleting an entry from the co
ntainer databse. The container database exists in file cntrDB, which is located
at /netbackup/vault/sessions/cntrDB.
Try the following:
Please read the relevant log file under the directory /netbackup/l
ogs/vault for more details. Be aware that if this directory does not already exi
st, a log file will not be created.
===============================================================
Error Number: 316
container_id is not unique in container database
NetBackup Vault has found a previously-existing entry for this container ID in t
he container database while adding it to the container database. Each container
record in the container database must havea unique container ID. Please note tha
t the container database exists in file cntrDB, which is located at /netbackup/vault/sessions/cntrDB.
Try the following:
Please verify that you have specified the correct container ID.
===============================================================
Error Number: 317
container database close operation failed
This error occurred while closing the container database. This error may occur w
hile reading, adding, modifying, or deleting an entry from the container databa
se. Please note that the container database exists in file cntrDB, which is loca
ted at /netbackup/vault/sessions/cntrDB.
Try the following:
Please read the relevant log file under the directory netbackup/logs/vault for m
ore details. Be aware that if this directory does not already exist, a log file
will not be created.
===============================================================
Error Number: 318
container database lock operation failed
This error occurred while locking the container database. This error may occur w
hile adding, modifying, or deleting an entry from the container database. Please
note that the container database exists in file cntrDB, which is located at /netbackup/vault/sessions/cntrDB.
Try the following:
Please read the relevant log file under the directory netbackup/logs/vault for m
ore details. Be aware that if this directory does not already exist, a log file
will not be created. If some other vault operation is using the container databa
se and has locked it, wait until that operation is complete and the container da
tabase is unlocked.
===============================================================
Error Number: 319
container database open operation failed
This error occurred while opening the container database. This error may occur w
hile reading, adding, modifying, or deleting an entry from the container databa
se. Please note that the container database exists in file cntrDB, which is loca
ted at /netbackup/vault/sessions/cntrDB.
Try the following:
Please read the relevant log file under the directory netbackup/logs/vault for m
ore details. Be aware that if this directory does not already exist, a log file
will not be created.
===============================================================
Error Number: 320
the specified container is not empty
This error occurs if you are trying to delete a container from the container dat
abase, but the container still holds media. You can only delete empty containers
.
Try the following:
Verify that you have specified the correct container ID. If you stil want to del
ete this container from the container database, first empty it either by injecti
ng all the media it contains into a robot, or by clearing the vault container ID
fields for these media from the volume database by using vmchange -vltcid with
a value of - . Attempt to delete the container again.
===============================================================
Error Number: 321
container cannot hold any media from the specified robot
This error occurred while trying to place media from an unexpected volume databa
se host into a container. All the media that are placed in a container should be
long to the same volume database host. You are trying to put media from a robot
that belongs to one volume database host into a container that already holds med
ia from robots that belong to a different volume database host..
Try the following:
Verify that you have specified the correct container ID and/or media IDs. Please
read the relevant log file under the directory /netbackup/logs/va
ult for more details. Be aware that if this directory does not already exist, a
log file will not be created.
===============================================================
Error Number: 322
cannot find vault in vault configuration file
NetBackup Vault could not find an entry for the specified vault name into the va
ult configuration file. Please note that the vault configuration file is located
at /netbackup/db/vault/vault.xml.
Try the following:
Verify that you have specified the correct vault name. Please read the relevant
log file under the directory netbackup/logs/vault for more details. Be aware tha
t if this directory does not already exist, a log file will not be created.
===============================================================
Error Number: 323
cannot find robot in vault configuration file
NetBackup Vault could not find an entry for the specified robot number in the va
ult configuration file. Please note that the vault configuration file is located
at /netbackup/db/vault/vault.xml.
Try the following:
Verify that you have specified the correct robot number. Please read the relevan
t log file under the directory netbackup/logs/vault for more details. Be aware t
hat if this directory does not already exist, a log file will not be created.
===============================================================
Error Number: 324
invalid data found in retention map file for duplication
This error occurs when the retention mapping file (either generic or for a speci
fic vault) contains invalid data. When there is too much or too little data in t
he file, or if the user has defined invalid retention levels in the file, this e
rror will occur.The retention mapping file is used in a vault session when dupli
cation for a vault profile has been configured with the Use mappings retention l
evel configured for one of the copies for duplication. The product will install
a mapping file template named retention_mappings in /netbackup/db
/vault.You can specify a mappings file for any single vault by copying the reten
tion_mappings template to another file and appending the name of the vault. For
example, netbackup/db/vault/retention_mappings.V1
Try the following:
Check the entries in the retention_mappings file.
===============================================================
Error Number: 325
unable to find policy/schedule for image using retention mapping
This error occurs when the backup policy or the schedule of an image that is goi
ng to be duplicated by Vault no longer exists and the Use mappings option on the
Duplication tab of the Profile dialog is selected.
Try the following:
Verify whether or not the backup policy or the schedule that created the image s
till exists. If either one or both do not exist, the image will not be duplicate
d through the vault profile.
===============================================================
Error Number: 326
specified file contains no valid entry
The specified file contains no valid entries for media IDs or the alphanumeric e
quivalent of barcodes. As per the expected format, each line should contain only
one string representing either a media ID or the numeric equivalent of a barcod
e.
Try the following:
Verify that each entry in the specified file doese not exceed the string size li
mit of six characters for media IDs and 16 characters for the numeric equivalent
of barcodes. Correct the invalid entries in the specified file and try the same
operation again. Please read the relevant log file under the directory netbackup/logs/vault for more details. Be aware that if this directory doe
s not already exist, a log file will not be created.
===============================================================
Error Number: 327
no media ejected for the specified vault session
This error occurred while moving media ejected by the specified vault session to
a container. Either the specified vault session has not ejected any media, or y
ou have specified an incorrect vault name and/or session ID.
Try the following:
Verify that you have specified the correct combination of vault name and session
ID. Verify that the specified vault session has ejected at least one piece of m
edia. Please read the relevant log file under the directory netbackup/logs/vault
for more details. Be aware that if this directory does not already exist, a log
file will not be created.
===============================================================
Error Number: 328
invalid container id
This error occurred while adding a container record to the container database. T
he container ID was found invalid. Please note that the container database exist
s in file cntrDB, which is located at /netbackup/vault/sessions/cn
trDB.
Try the following:
Verify that the container ID does not contain any space characters, and that the
string size is a maximum of 29 characters long.
===============================================================
Error Number: 329
invalid recall status
This error occurred while adding a container record to the container database. T
he container recall status was found invalid. Please note that the container dat
abase exists in file cntrDB, which is located at /netbackup/vault/
sessions/cntrDB.
Try the following:
Verify that the recall status is either 1 or 0.
===============================================================
Error Number: 330
invalid volume database host
This error occurred while adding a container record to the container database. T
he volume database host name was found invalid. Please note that the container d
atabase exists in file cntrDB, which is located at /netbackup/vaul
t/sessions/cntrDB.
Try the following:
Verify that the volume database host name does not contain any space characters,
and that the string size is a maximum of 256 characters long.
===============================================================
Error Number: 331
invalid container description
This error occurred while adding a container record to the container database. T
he container description was found invalid. Please note that the container datab
ase exists in file cntrDB, which is located at /netbackup/vault/se
ssions/cntrDB.
Try the following:
Verify that the string size of the container description is a maximum of 25 char
acters long.
===============================================================
Error Number: 332
error getting information from volume database
This error can occur while the backup process is communicating with the volume
database to fetch some information.
Try the following:
* On UNIX, verify that the Media Manager volume daemon (vmd) is running. On Wi
ndows, verify that the NetBackup Volume Manager service is running.
* See the process-specific error log directory for more details.
UNIX: /usr/openv/netbackup/logs/process_name
Windows: install_path\NetBackup\logs\process_name
For example, if you are getting this error while running a vault command (suc
h as vltcontainers or vltopmenu), look at the logs under /usr/openv/netbackup/l
ogs/vault to find the reason for this error.
Note: The log file will not be created unless the appropriate log directory, suc
h as /usr/openv/netbackup/logs/vault, has already been created.
===============================================================