Veritas Status Codes and Messages
Veritas Status Codes and Messages
Veritas Status Codes and Messages
This document lists all the status codes and messages provided by NetBackup.
10 | 20 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | 100 | 110 | 120 | 130 | 140 | 150 | 160 | 170 | 180 | 190 | 200
1 2 3 4 5 6 7 8 9
Check the All Log Entries report and also the progress log (if there is one).
Some of the problems that can show up under Status Code 1 are:
• A file or directory path that is more than 1023 characters long.
• Could not open a file.
• 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.
• On a UNIX system, the lstat system call fails on a file that is eligible to be backed up. This may be a
problem.
• On UNIX, a file could not be locked that has mandatory locking enabled.
Recommended Action: Check for a new core file to see if rbak aborted. Check the ps output to see if rbak is hung
and try again. Check the progress log for any unusual messages from rbak.
Status Code: 9
Message: an extension package is needed but was not installed
Explanation: A NetBackup extension product is required in order to perform the requested operation.
Recommended Action: Install the required extension product.
11 12 13 14 15 16 18 19 Top
Windows NT).
System requirements vary; thus, no absolute recommendations can be made. One customer running both
and ORACLE on their Solaris server made the following changes to their /etc/system file and then rebooted
(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 applications on your system.
5. Check for a shared memory problem. This error can occur if the system cannot allocate enough sha
This usually occurs when you use multiplexing, which increases the shared memory requirements. A
an entry similar to the following in a NetBackup log (or report) could not allocate enough shared mem
If you see this type of message, refer to the vendor documentation for your platform for instructions on incr
amount of shared memory on your system.
Because system requirements vary, we can make no absolute recommendations, other than to use values
to provide resources to all applications. Although, in at least one instance, the following was found to be ad
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 rebooting with boot -r, the problem
resolved. Note that in the above, shminfo_shmmin must be less than or equal to 100 for NetBackup proces
6. Examine other activity logs or the progress log on the client.
7. If a backup on a Windows NT NetBackup client fails with status code 11 and the client is using Ope
Manager (OTM) for open file management, it is possible that the error was caused by the OTM cach
full. If this is the case and bpbkar activity logs are turned on, a message similar to the following shou
the end of the backup:
04/28/99 11:27:56 AM: [216]: ERR - OTM Error:0xe0001005
04/28/99 11:27:59 AM: [216]: INF - OTM Terminate - disabled for all processes
04/28/99 11:27:59 AM: [216]: FTL - Backup operation aborted!
If this error is encountered, you may need to increase either the initial OTM cache size or the maximum OT
size, depending on the requirements of your installation and your usage of OTM.
troubleshooting information, create an activity log directory for the process that returned this status code, retry the
Recommended Action: Check the NetBackup Problems report for clues on why the failure occurred. For detailed
troubleshooting information, create an activity log directory for the process that returned this status code, retry the
and check the resulting activity log.
21 22 23 24 25 26 27 28 29 Top
1. Check the NetBackup Problems report for clues on where and why the failure occurred. If you cann
the cause from the Problems report, create activity log directories for the processes that could have
status code. Then retry the operation and check the resulting activity logs.
2. A possible cause could be a high network load. For example, this has been seen in conjunction with
to STDOUT when a Windows NT system that is monitoring network load has detected a high load a
ICMP packet to other systems that says the route being used by those systems was disconnected. T
messages were similar to the following:
01/31/96 14:05:23 ruble crabtree.null.com from client crabtree.null.com: ERR - Cannot write to STDOUT. E
No route to host
01/31/96 14:05:48 ruble crabtree.null.com successfully wrote backup id crabtree.null.com_0823125016, co
fragment 1, 440864 Kbytes at 628.538 Kbytes/sec
01/31/96 14:05:51 netbackup crabtree.null.com CLIENT crabtree.null.com CLASS Remote3SysFullW SCH
EXIT STATUS 24 (socket write failed)
3. On Sun Solaris, verify that all operating system patches are installed (see the Operating Notes sect
NetBackup Release Notes - UNIX).
4. On Windows NT, verify that the recommended service packs are installed.
Recommended Action:
1. Check the NetBackup All Log Entries report for clues on where and why the failure occurred.
2. Check the permissions on the command to be executed.
3. For detailed troubleshooting information, create an activity log directory for the process that returne
code, retry the operation, and check the resulting activity log.
31 32 33 34 35 36 37 38 39 Top
and NetBackup Database Manager daemon (bpdbm) for the changes to take effect. If you change the server list o
NT master server, stop and then restart the NetBackup Request Manager and NetBackup Database Manager ser
41 42 43 44 45 46 47 48 49 Top
Explanation: The server did not receive any information from the client for too long a period of time.
Recommended Action:
1. On a UNIX or Windows NT clients, check for the following problems with the bpbkar client process.
o •The bpbkar client process is hung on a file that has mandatory locking set. For this case, ad
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 activity log file in
the /usr/openv/netbackup/logs/bpbkar directory before bpbkar processes them. The last file in the lo
file that is causing problems.
Note: Also, use the above procedure for other, "unknown" bpbkar hangs. If the problem is due to ma
locking, you can have NetBackup skip the locked files by setting LOCKED_FILE_ACTION to SKIP i
the /usr/openv/netbackup/bp.conf file on the client.
o •The bpbkar client process is not hung, but due to the files and directories it is scanning, it ha
to the server within CLIENT_READ_TIMEOUT or CLIENT_CONNECT_TIMEOUT. This has b
occur during backups when directories have thousands of unmodified files; it has also been s
backing up file systems or directories that reside on optical disk, which is considerably slower
magnetic disk.
For this case, try adding or modifying the CLIENT_READ_TIMEOUT and CLIENT_CONNECT_TIM
in the server's /usr/openv/netbackup/bp.conf file. The default for the CLIENT_READ_TIMEOUT and
CLIENT_CONNECT_TIMEOUT is 300 seconds if unspecified.
Use your system's ps command and monitor CPU utilization to help decide which of the above cond
When you are through investigating the problem, delete the /usr/openv/netbackup/logs/bpbkar direc
log files can become quite large and are not deleted automatically. Also
delete /usr/openv/netbackup/bpbkar_path_tr so you do not generate larger log files than needed the
you create directory /usr/openv/netbackup/logs/bpbkar.
2. If the server cannot connect to the client, create bpcd or bpbkar (UNIX and Windows NT only) activi
directories on the client, retry the operation, and check the resulting logs. If these logs do not provid
create a bpbrm activity log on the server, retry the operation again, and check the resulting activity l
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
service that is being used. On UNIX, if both NIS and DNS files are used, verify that they match. Also, see
Network Communication Problems" on page 21.
3. If you are using an AIX token ring adapter and the routed daemon is running, the timeout can occur
token ring adapter creates dynamic routes, causing the routed daemon to crash.
4. For a FlashBackup client, this can happen if the file system being backed up is very large and has a
number of files. It can also occur if a large number of concurrent data streams are active at the sam
corrective action is to add CLIENT_READ_TIMEOUT to the /usr/openv/netbackup/bp.conf file and s
increase the timeout interval.
Recommended Action: If the server is a valid server, add its name to the client's server list:
• On Windows NT, 98, and 95 clients, add the server on the Servers tab in the NetBackup Configurat
box. To display this dialog box, start the Backup, Archive, and Restore interface on the client and cli
on the Actions menu (also see "Using the Configure - NetBackup Window" on page 57).
• On UNIX, and Macintosh clients, add a SERVER entry in the bp.conf file. • On NetWare target and
add a SERVER entry in the bp.ini file.
If you continue to have problems, review "Resolving Network Communication Problems" on page 21 and "Verifyin
Names and Services Entries" on page 31.
51 52 53 54 55 56 57 58 59 Top
2. If this occurs during a read operation (restore, duplicate, verify), the drives could be busy. Try increa
media mount timeout specified by the NetBackup global attribute in order to allow more time for mou
positioning the 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 the ACSLS system is u
5. If this is an initial installation, refer to "Common Configuration Problems" in chapter 2.
6. On Windows NT, check the Event Viewer Application log for error messages that indicate why the ta
not complete. On UNIX, check the system log.
61 62 63 64 65 66 67 68 69 Top
messages that indicate why the tape mount did not complete.
71 72 73 74 75 76 77 78 Top
81 82 83 84 85 86 87 88 Top
Explanation: The tape manager (bptm) or disk manager (bpdm) was terminated by another process or a user.
Recommended Action: This should not occur in normal operation. If you want to terminate an active backup, use
NetBackup Activity Monitor (on Windows NT) or the job monitor (on UNIX).
When backing up a DomainOS client (for example, Apollo), this has been seen to occur after the server has not re
anything on the socket for at least 300 seconds, thus causing a client read timeout and breaking the connection. T
activity log had an entry 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 resolved this problem.
2. If NetBackup was writing backups to a disk file, verify that the disk has enough space for the backup
For NetBackup database backup to a disk path on a UNIX system, you may be trying to write a image grea
gigabytes. File sizes greater than two gigabytes is a limitation on many UNIX file systems. Tape files do no
limit.
3. If the media is tape or optical disk, check for:
o A defective or dirty drive, in which case, clean it or have it repaired (refer to the tpclean comm
robotic drives).
o The wrong media type. Verify that the media matches the drive type you are using. On an op
platters may not be formatted correctly.
o Defective media. If this is the case, use the bpmedia command to set the volume to the FRO
it is not used for future backups.
o Incorrect drive configuration. Verify the Media Manager and system configuration for the driv
For example, on UNIX the drive could be configured for fixed mode when it must be variable mode.
Media Manager Device Configuration Guide for more information.
• The wrong media type. Verify that the media matches the drive type you are using.
91 92 93 94 95 96 97 98 99 Top
• If the volume is in a robot and the robot supports barcodes, perform a Compare Contents with Volume Configura
Robot Contents on UNIX). The resulting report shows which media ID was found and validates its slot number wit
the Media Manager volume configuration. Then, either change the physical location in the robot or change the vo
configuration to show the correct slot.
• If the volume was mounted on a nonrobotic drive, verify that the correct volume was mounted and assigned.
Message: specified media or path does not have a valid NB database backup header
Explanation: The bprecover command was issued and the media ID specified does not have valid database back
Recommended Action: Validate that the correct media ID is being used.
/usr/openv/lib/libvopie.sl
/usr/openv/lib/libnoauth.sl
Macintosh:
:System Folder:Extensions:libvopie.dll
:System Folder:Extensions:libnoauth.dll
2. Check the methods_allow.txt files on the systems that are having problems to ensure that authentication is ena
files are in the following locations:
Windows NT, 98, 95:
install_path\NetBackup\var\auth
UNIX:
/usr/openv/var/auth
Macintosh:
:System Folder:Preferences:NetBackup:var:auth
3. On the systems that are having the authentication problem, remove the remote host that is not being authentic
methods_allow.txt file.
For example, if hosta and hostb are having the problem, remove hosta from the file on hostb 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 files on the systems.
On Windows NT:
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 activity log directories for the processes involved in authentication between NetBackup systems. These
• On the server, create activity log directories for bprd, bpdbm, bpcd.
• On the client, create activity log directories for bpbackup, bprestore,
bpbkar (Windows NT only).
Retry the operation and check the logs.
troubleshooting information, create an activity log directory for either bpdm or bptm (whichever applies) and retry
Check the resulting activity log.
171 172 173 174 175 176 177 178 179 Top
3. For detailed troubleshooting information, create an activity log directory for bptm and retry the operation. Check
activity log.
b. Rerun the operation, check the resulting bpcd log file for the parameters passed to tar, and call customer suppo
• If the problem is with a Microsoft Windows, NetWare, or Macintosh client: a. Create a bpcd activity log directory
(on a Macintosh NetBackup creates the log automatically).
b. Increase the debug or log level as explained in the activity log topics in Chapter 3, "Using the Logs and Reports
c. On a Windows NT client, create a tar activity log directory.
d. Retry the operation.
e. Check the resulting activity logs for the parameters passed to tar and call customer support.
Explanation: A verify, duplicate, or import was attempted and failed for all selected images.
Recommended Action: Check the NetBackup Problems report for the cause of the error. To obtain detailed troubl
information, create an admin activity log directory and retry the operation. Check the resulting activity log.
201 202 203 204 205 206 207 208 209 Top
3. To obtain detailed troubleshooting information, create a bpsched activity log directory on the master server and
operation. Check the resulting activity log.
• If the error occurred during a restore operation, check the bprd activity logs.
On UNIX servers, you may have to change the service number for bpcd in /etc/services and the NIS
and send SIGHUP signals to the inetd processes on the clients.
/bin/ps -ef | grep inetd
settings in the services file. To display this dialog box, start the Backup, Archive, and Restore int
click Configure on the Actions menu (also see "Using the Configure-NetBackup Window" on
The values on the Network tab are written to the services file when the NetBackup Client serv
c. Stop and restart the NetBackup services.
5. See "Testing Slave Server and Clients" on page 18 and "Resolving Network Communication Proble
21.
6. Create a bpcd activity log directory on the server that has the storage unit and retry the operation. T
for additional information in the resulting activity log.
If you change the server list on a master server, stop and restart the NetBackup database manager
daemons (UNIX) or the NetBackup Database Manager and NetBackup Request Manager services (
NT).
2. If necessary, create activity log directories for the following processes and retry the operation. Then
resulting activity logs on the master server:
o If the error occurred during a backup operation, check the bpsched activity logs.
o If the error occurred during a restore operation, check the bprd activity logs.
master server and retry the operation. Then, check the resulting activity logs.
211 212 213 214 215 216 217 218 219 Top
Explanation: The NetBackup scheduler process (bpsched) did not find any of its storage units available for use. E
storage units are unavailable or all storage units are configured for "on demand only" and the class and schedule
require a specific storage unit.
Recommended Action:
1. Examine the Backup Status and All Log Entries report for the appropriate time period to determine t
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
complete.
3. Examine the storage unit configuration to verify that all the storage units do not have their "Concurre
attribute set to 0.
4. Verify that the robot number and host name in the storage unit configuration matches the Media Ma
configuration.
5. Determine if all storage units are set to "On Demand Only" for a class and schedule combination tha
require a specific storage unit. If this is the case, either specify a storage unit for the class and sche
combination or turn off "On Demand Only" for a storage unit.
6. If the storage unit is on a UNIX NetBackup slave server, it could indicate problem with bpcd.
Check /etc/inetd.conf on the slave server to verify that the bpcd entry is ok. If the storage unit is on
NT NetBackup slave server, verify that the NetBackup Client service has been started on the Windo
NetBackup slave server.
7. For detailed troubleshooting information, create a bpsched activity log directory on the master serve
the operation. Then, check the resulting activity log.
3. For detailed troubleshooting information, create activity log directories for bpsched and bpdbm on th
server and retry the operation. Then, check the resulting activity logs.
221 222 223 224 225 226 227 228 229 Top
231 232 233 234 235 236 237 238 239 Top
Recommended Action: Activate the required class, correct the client name, or add the client to a class that meets
After making the correction, retry the operation.
241 242 243 244 245 246 247 248 249 Top