VERITAS NetBackup Guide de dépannage

June 2000100-001518VERITAS NetBackup™ 3.4Troubleshooting GuideUNIX

Related Manualsx NetBackup Troubleshooting Guide - UNIX◆ Appendix C, “Robotic Test Utilities,” explains how to start the tests that are included with

Status Codes88 NetBackup Troubleshooting Guide - UNIX◆ On Windows NT/2000 NetBackup servers, check the install_path\netbackup\version.txt file or the

Chapter 4, Status Codes and Messages 89Status Codes1. Check the NetBackup Problems report for clues on where and why the failure occurred. If you cann

Status Codes90 NetBackup Troubleshooting Guide - UNIXSET Maximum Directory Cache Buffers = 4000SET Maximum Concurrent Disk Cache Writes = 2000SET Maxi

Chapter 4, Status Codes and Messages 91Status Codes◆ Change to or add the following settings in the Novell sys:system\autoexec.ncf file:SET Maximum Pa

Status Codes92 NetBackup Troubleshooting Guide - UNIX◆ On NetWare target and OS/2 clients, the master server name is the first SERVER entry in the bp.

Chapter 4, Status Codes and Messages 93Status CodesStatus Code: 26Message: client/server handshaking failedExplanation: A process on the server encoun

Status Codes94 NetBackup Troubleshooting Guide - UNIXStatus Code: 29Message: failed trying to exec a commandExplanation: A command could not be execut

Chapter 4, Status Codes and Messages 95Status CodesRecommended Action: Check the NetBackup All Log Entries report for clues on where and why the failu

Status Codes96 NetBackup Troubleshooting Guide - UNIX1. Check the NetBackup All Log Entries report to determine which directory could not be created a

Chapter 4, Status Codes and Messages 97Status CodesIf you change the server list on a UNIX master server, you must stop and then restart the NetBackup

Preface xiGetting HelpKey CombinationsSome keyboard command sequences use two or more keys at the same time. For example, you may have to hold down th

Status Codes98 NetBackup Troubleshooting Guide - UNIX◆ On Windows NT/2000, 98, and 95 systems, the master server is designated on the Servers tab in t

Chapter 4, Status Codes and Messages 99Status Codes◆ The bpbkar client process is not hung, but due to the files and directories it is scanning, it ha

Status Codes100 NetBackup Troubleshooting Guide - UNIX4. If you are using an AIX token ring adapter and the routed daemon is running, the timeout can

Chapter 4, Status Codes and Messages 101Status Codes◆ On clients, create a bpcd activity log directory (created automatically on Macintosh clients). ◆

Status Codes102 NetBackup Troubleshooting Guide - UNIX◆ If this is a NetBackup for NetWare client and has a version of NetBackup earlier than 3.0, ver

Chapter 4, Status Codes and Messages 103Status CodesStatus Code: 48Message: client hostname could not be foundExplanation: The system function gethost

Status Codes104 NetBackup Troubleshooting Guide - UNIX◆ On PC clients, increase the debug or log level as explained in the activity log topics in Chap

Chapter 4, Status Codes and Messages 105Status CodesOn a Windows NT/2000 client, check the bpinetd.exe, bpcd.exe, bpbkar32.exe, and tar32.exe executab

Status Codes106 NetBackup Troubleshooting Guide - UNIX4. When the robot is controlled by an Automated Cartridge System, verify that the ACSLS system i

Chapter 4, Status Codes and Messages 107Status Codes3. Perform “Resolving Network Communication Problems” on page 24.4. On UNIX clients, verify that t

Getting Helpxii NetBackup Troubleshooting Guide - UNIX

Status Codes108 NetBackup Troubleshooting Guide - UNIXc. Verify that the NetBackup Client Service Port number and NetBackup Request Service Port numbe

Chapter 4, Status Codes and Messages 109Status CodesStatus Code: 59Message: access to the client was not allowedExplanation: The master or media serve

Status Codes110 NetBackup Troubleshooting Guide - UNIX4. On Macintosh clients, check the inetd and bpcd activity logs. Both logs are created automatic

Chapter 4, Status Codes and Messages 111Status Codes1. Execute a df to see if the system can read the mount table. 2. On an SCO system, code 60 can oc

Status Codes112 NetBackup Troubleshooting Guide - UNIXRecommended Action: 1. On all but Macintosh clients, enable bpcd activity logging as follows:a.

Chapter 4, Status Codes and Messages 113Status Codes1. Create a bptm activity log directory on the server.2. On a UNIX NetBackup server, add the VERBO

Status Codes114 NetBackup Troubleshooting Guide - UNIXStatus Code: 67Message: client backup failed to read the file listExplanation: The client could

Chapter 4, Status Codes and Messages 115Status CodesStatus Code: 69Message: invalid file list specificationExplanation: The file list received from th

Status Codes116 NetBackup Troubleshooting Guide - UNIX◆ On other PC clients except Macintosh, create an activity log directory for bpcd (the bpcd log

Chapter 4, Status Codes and Messages 117Status CodesExplanation: The bpstart_notify script returned a nonzero exit code.Recommended Action: Check the

1Introduction1This chapter explains the basic steps to take if you encounter a problem while using NetBackup. Other chapters provide more specific inf

Status Codes118 NetBackup Troubleshooting Guide - UNIXTo increase the amount of information that appears in the logs, see the logging topics in Chapte

Chapter 4, Status Codes and Messages 119Status CodesNote ltid or the NetBackup Device Manager service is used only if devices are attached to the syst

Status Codes120 NetBackup Troubleshooting Guide - UNIXRecommended Action:1. For additional information, check the following:◆ NetBackup Problems repor

Chapter 4, Status Codes and Messages 121Status Codese. On UNIX systems, look at the /usr/openv/netbackup/db/media/errors log (which is also included

Status Codes122 NetBackup Troubleshooting Guide - UNIXStatus Code: 85Message: media read errorExplanation: The system device driver returned an I/O er

Chapter 4, Status Codes and Messages 123Status Codes◆ Event Viewer Application and System logs (Windows NT/2000)2. Check for the following:◆ A defecti

Status Codes124 NetBackup Troubleshooting Guide - UNIXExplanation: NetBackup detected a problem when backing up an Auspex FastBackup client.Recommende

Chapter 4, Status Codes and Messages 125Status CodesRecommended Action: 1. Check the All Log Entries report for more information.2. Check the NetBacku

Status Codes126 NetBackup Troubleshooting Guide - UNIXIn this case, configure the drive for variable-mode block sizes and suspend media written on tha

Chapter 4, Status Codes and Messages 127Status Codes◆ NetBackup Problems report to determine the device or volume that caused the error◆ System and er

Record All Information2 NetBackup Troubleshooting Guide - UNIXSome questions to ask here are:◆ What operation was being attempted? ◆ What method were

Status Codes128 NetBackup Troubleshooting Guide - UNIXThis script lists all volumes in the Media Manager volume configuration, and augments that list

Chapter 4, Status Codes and Messages 129Status Codes/usr/openv/volmgr/debug/daemon/log.xxxxxxOn Windows NT/2000, the vmd log is:install_path\Volmgr\de

Status Codes130 NetBackup Troubleshooting Guide - UNIXExplanation: A system call failed in bparchive, bpbackup, bplist, or bprestore.Recommended Actio

Chapter 4, Status Codes and Messages 131Status CodesRecommended Action: Verify that full path names are used (they start with / on UNIX), and they are

Status Codes132 NetBackup Troubleshooting Guide - UNIXStatus Code: 120Message: cannot find configuration database record for requested NB database bac

Chapter 4, Status Codes and Messages 133Status CodesStatus Code: 124Message: NB database backup failed, a path was not found or is inaccessibleExplana

Status Codes134 NetBackup Troubleshooting Guide - UNIXExplanation: An error occurred that prevents the product from operating in a consistent fashion.

Chapter 4, Status Codes and Messages 135Status CodesExplanation: One of two explanations exist.◆ A request was made that is unrecognized. This usually

Status Codes136 NetBackup Troubleshooting Guide - UNIXRecommended Action: Retry the operation as a root user (administrator on Windows NT/2000) on the

Chapter 4, Status Codes and Messages 137Status CodesRecommended Action: Either correct the command or verify that all NetBackup binaries are at the sa

Chapter 1, Introduction 3Record All Information◆ Client hardware type and operating system level, if a client is involved.◆ Storage units being used,

Status Codes138 NetBackup Troubleshooting Guide - UNIX3. If the problem persists longer than ten minutes, it is possible that it will be necessary to

Chapter 4, Status Codes and Messages 139Status CodesExplanation: An incomplete request was made to the bpdbm process (NetBackup Database Manager servi

Status Codes140 NetBackup Troubleshooting Guide - UNIX1. Examine the NetBackup error log to determine why the system call failed and correct the probl

Chapter 4, Status Codes and Messages 141Status CodesWindows NT/2000, 98, 95:install_path\NetBackup\var\authUNIX: /usr/openv/var/authMacintosh: :System

Status Codes142 NetBackup Troubleshooting Guide - UNIXStatus Code: 161Message: Evaluation software has expired. See www.veritas.com for ordering infor

Chapter 4, Status Codes and Messages 143Status CodesStatus Code: 167 Message: cannot find requested volume pool in Media Manager volume databaseExplan

Status Codes144 NetBackup Troubleshooting Guide - UNIXExplanation: When loading a volume for a backup or restore, the tape manager (bptm), did not fin

Chapter 4, Status Codes and Messages 145Status Codes1. Check the NetBackup Problems report to see if it shows the cause of the problem. If you see a P

Status Codes146 NetBackup Troubleshooting Guide - UNIXStatus Code: 175Message: not all requested files were restoredExplanation: When restoring files

Chapter 4, Status Codes and Messages 147Status CodesStatus Code: 177Message: could not deassign media due to Media Manager errorExplanation: The tape

Troubleshooting the Problem4 NetBackup Troubleshooting Guide - UNIXTroubleshooting the ProblemAfter defining the problem, use the information in the o

Status Codes148 NetBackup Troubleshooting Guide - UNIXStatus Code: 181Message: tar received an invalid argumentExplanation: One of the parameters pass

Chapter 4, Status Codes and Messages 149Status CodesRecommended Action: ◆ If the problem is with a UNIX client, create a /usr/openv/netbackup/logs/tar

Status Codes150 NetBackup Troubleshooting Guide - UNIXa. Create a bpcd activity log directory on the client (on a Macintosh NetBackup creates the log

Chapter 4, Status Codes and Messages 151Status Codes1. Retry the operation and check the progress log on the client for error messages that reveal the

Status Codes152 NetBackup Troubleshooting Guide - UNIXExplanation: A verify, duplicate, or import was attempted and failed for all selected images.Rec

Chapter 4, Status Codes and Messages 153Status CodesExplanation: A backup or archive operation that was queued by the backup scheduler was not attempt

Status Codes154 NetBackup Troubleshooting Guide - UNIX◆ If the client is not in such a class, either add a schedule of the appropriate type to an exis

Chapter 4, Status Codes and Messages 155Status CodesStatus Code: 201Message: handshaking failed with server backup restore managerExplanation: A proce

Status Codes156 NetBackup Troubleshooting Guide - UNIX1. Verify that the schedule specifies the correct storage unit.2. Execute the ping command from

Chapter 4, Status Codes and Messages 157Status Codesnetwork unreachable failure was encountered between the master and a media server or if only the m

Chapter 1, Introduction 5Problem Report InformationProblem Report InformationGeneral InformationDate: _________________________Servers (master and med

Status Codes158 NetBackup Troubleshooting Guide - UNIX3. On UNIX servers, verify that the bpcd entries in /etc/services or NIS on all the servers are

Chapter 4, Status Codes and Messages 159Status Codes◆ If the error occurred during a restore operation, check the bprd activity logs. Status Code: 205

Status Codes160 NetBackup Troubleshooting Guide - UNIXThe values on the Network tab are written to the services file when the NetBackup Client service

Chapter 4, Status Codes and Messages 161Status Codes1. Verify that the NetBackup database manager (bpdbm) process (NetBackup Database Manager service

Status Codes162 NetBackup Troubleshooting Guide - UNIXRecommended Action: Create a bpsched activity log directory on the master server and retry the o

Chapter 4, Status Codes and Messages 163Status Codes1. Examine the Backup Status and All Log Entries report for the appropriate time period to determi

Status Codes164 NetBackup Troubleshooting Guide - UNIXTo check for backups do the following:On a UNIX master server:1. Check for active or queued back

Chapter 4, Status Codes and Messages 165Status Codes1. On a UNIX master server, verify that the NetBackup database manager (bpdbm) process is running.

Status Codes166 NetBackup Troubleshooting Guide - UNIX3. For detailed troubleshooting information, create activity log directories for bpsched and bpd

Chapter 4, Status Codes and Messages 167Status CodesDo this on the server where the storage unit is connected.On a Windows NT/2000 NetBackup server, e

Problem Report Information6 NetBackup Troubleshooting Guide - UNIXDid this occur during or shortly after any of the following:_____ Initial Installati

Status Codes168 NetBackup Troubleshooting Guide - UNIXRecommended Action: Determine the cause of the status code that follows this one.Status Code: 22

Chapter 4, Status Codes and Messages 169Status CodesRecommended Action: Verify that all NetBackup software is at the same version level. If that is no

Status Codes170 NetBackup Troubleshooting Guide - UNIXRecommended Action: Obtain detailed troubleshooting information by creating an activity log dire

Chapter 4, Status Codes and Messages 171Status CodesStatus Code: 234Message: communication interruptedExplanation: This is an intermediate status code

Status Codes172 NetBackup Troubleshooting Guide - UNIXStatus Code: 237Message: the specified schedule does not exist in an active class in the configu

Chapter 4, Status Codes and Messages 173Status CodesStatus Code: 242Message: operation would cause an illegal duplicationExplanation: Processing the r

Status Codes174 NetBackup Troubleshooting Guide - UNIXRecommended Action: Activate the class and retry the operation. Status Code: 248Message: there a

Chapter 4, Status Codes and Messages 175Status Codes1. Check the file list for the class and the exclude and include lists on the client to verify tha

Status Codes176 NetBackup Troubleshooting Guide - UNIXRecommended Action: Check the /usr/openv/java/auth.conf file on the machine (host name) specifie

Chapter 4, Status Codes and Messages 177Status CodesExplanation: The initial connection from the NetBackup-Java interface to its authentication servic

Chapter 1, Introduction 7Problem Report InformationFollow these steps to get debug data for VERITAS support to analyze:1. If the application does not

Status Codes178 NetBackup Troubleshooting Guide - UNIXRecommended Action:1. Retry the last operation.2. If the problem persists, restart the NetBackup

Chapter 4, Status Codes and Messages 179Status Codes◆ A job (started by either the NetBackup-Java authentication service or user service) cannot be mo

Status Codes180 NetBackup Troubleshooting Guide - UNIX3. Restart the NetBackup-Java interface and examine the logs.Note The error is probably the resu

Chapter 4, Status Codes and Messages 181MessagesStatus Code: 514Message: NB-Java: bpjava-msvc is not compatible with this application version (applica

Messages182 NetBackup Troubleshooting Guide - UNIXallocation failed(Status Code 10)an entry in the filelist expanded to too many characters(Status Cod

Chapter 4, Status Codes and Messages 183Messagesbpjava-msvc: the client is not compatible with this server version (server_version)(Status Code 513)bp

Messages184 NetBackup Troubleshooting Guide - UNIXcannot make required directory(Status Code 35)cannot overwrite media, data on it is protected(Status

Chapter 4, Status Codes and Messages 185Messagesclient backup was not attempted because backup window closed(Status Code 196)client cannot read the mo

Messages186 NetBackup Troubleshooting Guide - UNIXclient timed out waiting for the continue message from the media manager(Status Code 65)client timed

Chapter 4, Status Codes and Messages 187Messagescould not set user id for process(Status Code 31)daemon fork failed(Status Code 148)daemon is already

DisclaimerThe information contained in this publication is subject to change without notice. VERITAS Software Corporation makes no warranty of any kin

Problem Report Information8 NetBackup Troubleshooting Guide - UNIX

Messages188 NetBackup Troubleshooting Guide - UNIXevaluation software has expired. See www.veritas.com for ordering information(Status Code 161)events

Chapter 4, Status Codes and Messages 189Messagesfailed trying to allocate memory (Status Code 36)failed trying to exec a command (Status Code 29)faile

Messages190 NetBackup Troubleshooting Guide - UNIXfile pathname exceeds the maximum length allowed(Status Code 105)file read failed(Status Code 13)fil

Chapter 4, Status Codes and Messages 191Messagesinvalid command protocol(Status Code 143)invalid command usage(Status Code 144)invalid file pathname f

Messages192 NetBackup Troubleshooting Guide - UNIXmedia id must be 6 or less characters(Status Code 171)Media Manager device daemon (ltid) is not acti

Chapter 4, Status Codes and Messages 193Messagesmedia write error(Status Code 84)NB database backup failed, a path was not found or is inaccessible(St

Messages194 NetBackup Troubleshooting Guide - UNIXnetwork read failed(Status Code 42)network write failed(Status Code 44)no active classes contain sch

Chapter 4, Status Codes and Messages 195Messagesnone of the files in the file list exist(Status Code 71)none of the requested files were backed up(Sta

Messages196 NetBackup Troubleshooting Guide - UNIXrequest attempted on a non reserved port(Status Code 45)requested media id is in use, cannot process

Chapter 4, Status Codes and Messages 197Messagesserver not allowed access(Status Code 46)SERVER was not specified in /usr/openv/netbackup/bp.conf(Stat

9Troubleshooting Procedures2This chapter has procedures for finding the cause of NetBackup errors. These procedures are general in nature and do not a

Messages198 NetBackup Troubleshooting Guide - UNIXsystem call failed(Status Code 11)system error occurred (Status Code 130)system error occurred while

Chapter 4, Status Codes and Messages 199Messagestext exceeded allowed length(Status Code 225)the archive failed to back up the requested files(Status

Messages200 NetBackup Troubleshooting Guide - UNIXthe requested operation was successfully completed(Status Code 0)the required storage unit is unavai

Chapter 4, Status Codes and Messages 201Messagesthe specified schedule is the wrong type for this request(Status Code 241)the TIR information is zero

Messages202 NetBackup Troubleshooting Guide - UNIXunable to mount media because its in a DOWN drive or misplaced (Status Code 164)unable to process re

203Disaster Recovery5This chapter has procedures for recovering your data in case of a server or client disk failure. The recovery procedures are as f

Master Server Disk Recovery204 NetBackup Troubleshooting Guide - UNIXFigure 1. Recover Master Server - Root Intact (overview)1. Verify that the operat

Chapter 5, Disaster Recovery 205Master Server Disk RecoveryRecovering Master Server When Root is LostThis procedure assumes that the root file system

Master Server Disk Recovery206 NetBackup Troubleshooting Guide - UNIX3. Install NetBackup on the alternate disk. See the NetBackup Installation Guide

Chapter 5, Disaster Recovery 207Media Server Disk RecoveryMedia Server Disk RecoveryNote The term media server, as distinct from master server or serv

Preliminary Troubleshooting10 NetBackup Troubleshooting Guide - UNIXa. Use the All Log Entries report and check for NetBackup errors for the appropria

Client System Disk Recovery - Windows NT/2000, 98, 95208 NetBackup Troubleshooting Guide - UNIXClient System Disk Recovery - Windows NT/2000, 98, 95Th

Chapter 5, Disaster Recovery 209Client System Disk Recovery - Windows NT/2000, 98, 95◆ NetBackup 3.0 or later client software to install on the client

Client System Disk Recovery - Windows NT/2000, 98, 95210 NetBackup Troubleshooting Guide - UNIX5. Enable debug logging by creating the following debug

Chapter 5, Disaster Recovery 211Recovering the NetBackup DatabasesWhen the boot process is complete, the system is restored to the state it was in at

Recovering the NetBackup Databases212 NetBackup Troubleshooting Guide - UNIXinstall_path\netbackup\db\mediainstall_path\volmgr\databaseFor install_pat

Chapter 5, Disaster Recovery 213Recovering the NetBackup DatabasesNote If the /dev file for the device you will use for listing the database informati

Recovering the NetBackup Databases214 NetBackup Troubleshooting Guide - UNIX ---- IMAGE1 /usr/openv/netbackup/dbIMAGE2 /usr/openv/volmgr/databas

Chapter 5, Disaster Recovery 215Recovering the NetBackup DatabasesBefore Starting◆ Reinstall the NetBackup software (if necessary) as explained in “Ma

Recovering the NetBackup Databases216 NetBackup Troubleshooting Guide - UNIXFigure 3. Recover Databases to Same Disk - UNIX2. Stop the NetBackup reque

Chapter 5, Disaster Recovery 217Recovering the NetBackup DatabasesRecover shark:/usr/openv/volmgr/database y/n (n)? yRecovering shark:/usr/openv/volmg

Chapter 2, Troubleshooting Procedures 11Preliminary Troubleshooting◆ On the NetBackup master or media server, the partition where the NetBackup (or Me

Recovering the NetBackup Databases218 NetBackup Troubleshooting Guide - UNIXRecovering eel:/usr/openv/netbackup/db/mediaRecover eel:/usr/openv/volmgr/

Chapter 5, Disaster Recovery 219Recovering the NetBackup Databases1. Stop the NetBackup request daemon (bprd) and NetBackup database manager daemon (b

Recovering the NetBackup Databases220 NetBackup Troubleshooting Guide - UNIXc. Restart ltid by executing:/usr/openv/volmgr/bin/ltidThis automatically

Chapter 5, Disaster Recovery 221Recovering the NetBackup DatabasesFigure 6. Restore Databases From Disk4. After recovering the databases, start the fo

Recovering the NetBackup Databases222 NetBackup Troubleshooting Guide - UNIX

223Functional OverviewAThis appendix provides a functional overview of NetBackup for both UNIX and Windows NT/2000. Such comprehensive treatment is va

Backup and Restore Functional Description224 NetBackup Troubleshooting Guide - UNIXStartup ProcessBefore NetBackup can perform scheduled operations or

Appendix A, Functional Overview 225Backup and Restore Functional DescriptionFigure 7. Starting NetBackupThe Media Manager device components of NetBack

Backup and Restore Functional Description226 NetBackup Troubleshooting Guide - UNIXBackup and Archive ProcessesThe backup and archive processes vary d

Appendix A, Functional Overview 227Backup and Restore Functional DescriptionFigure 8. Backup or Archive to Tape or OpticalbprdMaster Server Notes:* Fo

Preliminary Troubleshooting12 NetBackup Troubleshooting Guide - UNIXa. Use the NetBackup Activity Monitor, or the Services application in the Windows

Backup and Restore Functional Description228 NetBackup Troubleshooting Guide - UNIXFor all three types of backup and archive operations, bpsched uses

Appendix A, Functional Overview 229Backup and Restore Functional DescriptionFigure 9. Multiplexed Backups Example (two streams)bpdbmNetBackup ServerUN

Backup and Restore Functional Description230 NetBackup Troubleshooting Guide - UNIXBackups and Archives - Windows 95/98 ClientsNetBackup supports the

Appendix A, Functional Overview 231Backup and Restore Functional DescriptionBackups and Archives - Windows NT/2000 ClientsNetBackup supports the same

Backup and Restore Functional Description232 NetBackup Troubleshooting Guide - UNIXBackups and Archives - NetWare ClientsNetBackup supports the same t

Appendix A, Functional Overview 233Backup and Restore Functional DescriptionBackups - Macintosh ClientsNetBackup supports the same types of operations

Backup and Restore Functional Description234 NetBackup Troubleshooting Guide - UNIXNetBackup Database BackupsThe administrator can use an option in th

Appendix A, Functional Overview 235Backup and Restore Functional DescriptionFigure 10. NetBackup Database Backup3. Starts the actual backup by using b

Backup and Restore Functional Description236 NetBackup Troubleshooting Guide - UNIX◆ A second bpbackupdb process checks the file information to ensure

Appendix A, Functional Overview 237Backup and Restore Functional DescriptionIf the storage unit on which the files reside attaches to the master serve

Chapter 2, Troubleshooting Procedures 13Troubleshooting Installation and Configuration ProblemsTroubleshooting Installation and Configuration Problems

Backup and Restore Functional Description238 NetBackup Troubleshooting Guide - UNIXFigure 12. Restore operation From Tape or OpticalServerUNIX ClientB

Appendix A, Functional Overview 239Backup and Restore Functional DescriptionRestores - Windows 95/98 ClientsNetBackup supports the same types of resto

Backup and Restore Functional Description240 NetBackup Troubleshooting Guide - UNIXRestores - Windows NT/2000 ClientsNetBackup supports the same types

Appendix A, Functional Overview 241Backup and Restore Functional DescriptionRestores - NetWare ClientsNetBackup supports the same types of restore ope

Backup and Restore Functional Description242 NetBackup Troubleshooting Guide - UNIXRestores - Macintosh ClientsNetBackup supports the same types of op

Appendix A, Functional Overview 243Backup and Restore Functional DescriptionNetBackup Directories and FilesFigure 13 shows the NetBackup file and dire

Backup and Restore Functional Description244 NetBackup Troubleshooting Guide - UNIXTable 6. NetBackup Directories and Files - Servers and UNIX Clients

Appendix A, Functional Overview 245Backup and Restore Functional DescriptionNetBackup Programs and DaemonsTable 7 describes the programs and daemons t

Backup and Restore Functional Description246 NetBackup Troubleshooting Guide - UNIXbpbackup On UNIX clients, this program communicates with bprd on th

Appendix A, Functional Overview 247Backup and Restore Functional Descriptionbpcd On UNIX clients, bpcd is the NetBackup client daemon and lets NetBack

Troubleshooting Installation and Configuration Problems14 NetBackup Troubleshooting Guide - UNIX1. Check for the following device configuration proble

Backup and Restore Functional Description248 NetBackup Troubleshooting Guide - UNIXbpdbm On master servers, the NetBackup program that manages the con

Appendix A, Functional Overview 249Backup and Restore Functional Descriptionbpjava-usvc NetBackup-Java user server application program. This program s

Backup and Restore Functional Description250 NetBackup Troubleshooting Guide - UNIXbpsched On master servers, the Scheduler uses class information fro

Appendix A, Functional Overview 251Backup and Restore Functional DescriptionjbpSA A Java-based program for performing backups, archives and restores o

Backup and Restore Functional Description252 NetBackup Troubleshooting Guide - UNIXNBNW95.EXE For NetWare nontarget clients, this is the executable fi

Appendix A, Functional Overview 253Backup and Restore Functional DescriptionTAR32 On Windows NT/2000 clients, the TAR32 program is a special version o

Media Manager Functional Description254 NetBackup Troubleshooting Guide - UNIXNetBackup DatabasesTable 8 describes the NetBackup databases. These data

Appendix A, Functional Overview 255Media Manager Functional Description◆ Barcode Operations◆ Media Manager ComponentsNote In this section, the term Me

Media Manager Functional Description256 NetBackup Troubleshooting Guide - UNIXFigure 14. Starting Media ManagerltidvmdavrdExecute:/usr/openv/volmgr/bi

Appendix A, Functional Overview 257Media Manager Functional DescriptionMedia and Device Management ProcessWhen the Media Manager daemons are running,

Chapter 2, Troubleshooting Procedures 15Troubleshooting Installation and Configuration Problemsa. Check the All Log Entries report for NetBackup error

Media Manager Functional Description258 NetBackup Troubleshooting Guide - UNIXFigure 15. Media and Device Management Example ProcessMount media IDUser

Appendix A, Functional Overview 259Media Manager Functional DescriptionBarcode OperationsBarcode reading is mainly a function of the robot hardware ra

Media Manager Functional Description260 NetBackup Troubleshooting Guide - UNIXFigure 16. Barcode RequestMount media IDUserltidvmdDevice-management uti

Appendix A, Functional Overview 261Media Manager Functional DescriptionMedia Manager ComponentsMedia Manager Directories and FilesFigure 17 shows the

Media Manager Functional Description262 NetBackup Troubleshooting Guide - UNIXCaution DO NOT under any circumstances attempt to modify the Media Manag

Appendix A, Functional Overview 263Media Manager Functional DescriptionTable 10. Media Manager Daemons and ProgramsProgram/DaemonDescriptionacssel Ava

Media Manager Functional Description264 NetBackup Troubleshooting Guide - UNIXlmfd The Library Management Facility daemon works in conjunction with lm

Appendix A, Functional Overview 265Media Manager Functional Descriptionrsmd The Tape Library RSMD daemon is the interface between ltid and the Microso

Media Manager Functional Description266 NetBackup Troubleshooting Guide - UNIXtl8cd The Tape Library 8MM Control daemon provides the robotic control f

Appendix A, Functional Overview 267Media Manager Functional Descriptiontlhd The Tape Library Half-inch daemon works in conjunction with tlhcd to handl

Troubleshooting Installation and Configuration Problems16 NetBackup Troubleshooting Guide - UNIXMessage: Robot does not support serializationExplanati

Media Manager Functional Description268 NetBackup Troubleshooting Guide - UNIXtpconfig tpconfig is a command line administrator utility for configurin

Appendix A, Functional Overview 269Media Manager Functional Descriptionts8d The Tape Stacker 8MM daemon is the interface between ltid and the 8-mm Tap

Media Manager Functional Description270 NetBackup Troubleshooting Guide - UNIXxvmadm Available only on UNIX. An administrator utility with options for

271Networks and HostnamesBIn a configuration with multiple networks and clients with more than one hostname, the NetBackup administrator must configur

272 NetBackup Troubleshooting Guide - UNIXThe comparison is first a simple string comparison which, if successful, is verified by comparing hostnames

Appendix B, Networks and Hostnames 273The destination client name is a factor only if an administrator is pushing a restore to a client from a server.

274 NetBackup Troubleshooting Guide - UNIXYou can create and edit this file to force the desired translation of NetBackup client host names. Each line

275Robotic Test UtilitiesCEach of the robotic software packages includes a robotic test utility for communicating directly with robotic peripherals. T

Robotic Tests on UNIX276 NetBackup Troubleshooting Guide - UNIXODL/usr/openv/volmgr/bin/odltest -r roboticpathTL4/usr/openv/volmgr/bin/tl4test -r robo

Appendix C, Robotic Test Utilities 277Robotic Tests on Windows NT/2000Robotic Tests on Windows NT/2000If the robot has been configured (that is, added

Chapter 2, Troubleshooting Procedures 17Troubleshooting Installation and Configuration ProblemsRecommended Action: Ask the manufacturer for a newer fi

Robotic Tests on Windows NT/2000278 NetBackup Troubleshooting Guide - UNIX

279Glossaryaccess control list (ACL)Security information associated with files on some file systems. ACSAutomated Cartridge System. This robot type is

280 NetBackup Troubleshooting Guide - UNIXalternate-client restoreRestoring files to your client when they were originally backed up from a different

Glossary 281backup, archive, and restore interfaceThe name of the NetBackup Microsoft Windows and Java based user interfaces for clients. On servers,

282 NetBackup Troubleshooting Guide - UNIXCDFContext-dependent file, which is a type of directory structure on a Hewlett-Packard system.classDefines t

Glossary 283daemonA program on a UNIX system that runs in the background and performs some task (for example, starting other programs when they are ne

284 NetBackup Troubleshooting Guide - UNIXdirectory treeThe hierarchical structure in which files are organized on a disk. Each directory lists the fi

Glossary 285exclude listA list that designates files or directories to exclude from automatic backups.expiration (image)The date and time when NetBack

286 NetBackup Troubleshooting Guide - UNIXfull backupA backup that copies, to a storage unit, all files and directories that are beneath a specified d

Glossary 287hierarchical storage managementThe process of automatically migrating selected files from a managed file system to specified migration lev

iiiContentsPreface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ixAud

General Test and Troubleshooting Procedures18 NetBackup Troubleshooting Guide - UNIXExplanation: A device has been detected without the corresponding

288 NetBackup Troubleshooting Guide - UNIXjbpSAThe Java-based NetBackup interface for performing user backups, archives, and restores.jnbSAThe Java-ba

Glossary 289load(noun) Amount of work that is being performed by a system or the level of traffic on a network. For example, network load affects perf

290 NetBackup Troubleshooting Guide - UNIXMedia ManagerSoftware that is part of NetBackup and manages the storage devices and removable media.Media Ma

Glossary 291multiplexingThe process of sending concurrent-multiple backups from one or more clients to a single storage device and interleaving those

292 NetBackup Troubleshooting Guide - UNIXNetBackup Request Manager serviceThe NetBackup Windows NT/2000 service that runs on the master server and st

Glossary 293pathnameThe list of directories in the path to a destination directory or file.PC clientsNetBackup clients that have Microsoft Windows (NT

294 NetBackup Troubleshooting Guide - UNIXrbakThe program that Apollo clients use to read data from tape during a restore.registryA Microsoft Windows

Glossary 295Also, a UNIX user name having administration capability.RS-232An industry-standard interface for serial communications and sometimes used

296 NetBackup Troubleshooting Guide - UNIXserver listThe list of servers that a NetBackup client or server refers to when establishing or verifying co

Glossary 297storage migratorRefers to the VERITAS Storage Migrator line of hierarchical storage management products for UNIX and Windows NT/2000. Thes

Chapter 2, Troubleshooting Procedures 19General Test and Troubleshooting Procedures3. Verify that the NetBackup daemons are running on the master serv

298 NetBackup Troubleshooting Guide - UNIXtarget serviceA Novell NetWare service that needs storage management. The SMS views all services (for exampl

Glossary 299timeout periodThe period of time that an application has allotted for an event to occur.TIRSee “true image restore.” tpconfigA Media Manag

300 NetBackup Troubleshooting Guide - UNIXverifyAn operation that compares the list of files that are actually on a volume with what NetBackup has rec

Glossary 301wakeup intervalThe time interval at which NetBackup checks for backups that are due.wbakThe program that Apollo clients use to write data

302 NetBackup Troubleshooting Guide - UNIX

303IndexAacssel, description 263acsssi, description 263acstest 275, 277Activity logs 62, 74admin log 63admincmd, directory 244Administration interface

304 NetBackup Troubleshooting Guide - UNIXbpcddescription 247Mac client log 68server log 63UNIX client log 65, 67BPCD.NLM 247BPCDW32 230, 239BPCDW32.E

Index 305Debug level 67, 68, 74Debug logsNetBackup (see Activity logs)vmd 69, 262Define the problem 1Device configuration problems 15Device database 2

306 NetBackup Troubleshooting Guide - UNIXLog levelMacintosh clients 68Windows and NetWare clients 67Logsoverview 59activity, enabling detailed 74acti

Index 307start and stop 12NetBackup configuration optionsdefinition 291NetBackup Database Manager servicedefinition 291start and stop 12NetBackup Devi

General Test and Troubleshooting Procedures20 NetBackup Troubleshooting Guide - UNIX5. If you previously configured a nonrobotic drive and your system

308 NetBackup Troubleshooting Guide - UNIXacstest 275, 277odltest 276RSM robot 277tl4test 276, 277tl8test 276, 277tldtest 276, 277tlhtest 277ts8test 2

Index 309tsdd, description 268tsdtest 276, 277tshd, description 268tshtest 276Uuser_ops log 63Utility, robotic test 275VVerbose option 64VERITAS NetBa

310 NetBackup Troubleshooting Guide - UNIX

Chapter 2, Troubleshooting Procedures 21General Test and Troubleshooting Procedures8. Reconfigure your test class to name a client that is located els

General Test and Troubleshooting Procedures22 NetBackup Troubleshooting Guide - UNIX1. Enable appropriate activity and debug logs on the servers (see

Chapter 2, Troubleshooting Procedures 23General Test and Troubleshooting Procedures◆ On a Windows NT/2000 server, the Event Viewer Application log◆ vm

General Test and Troubleshooting Procedures24 NetBackup Troubleshooting Guide - UNIX7. When all clients and storage units are working, test the remain

Chapter 2, Troubleshooting Procedures 25General Test and Troubleshooting Procedures2. Verify basic network connectivity between client and server by t

General Test and Troubleshooting Procedures26 NetBackup Troubleshooting Guide - UNIX◆ /etc/services (or applicable NIS file) does not have the correct

Chapter 2, Troubleshooting Procedures 27General Test and Troubleshooting ProceduresIn this example, telnet can establish a connection to the client an

iv NetBackup Troubleshooting Guide - UNIXTo Resolve Installation Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

General Test and Troubleshooting Procedures28 NetBackup Troubleshooting Guide - UNIXNote We suggest that you not change the port number for bpcd or ot

Chapter 2, Troubleshooting Procedures 29General Test and Troubleshooting Procedures2. If this is a new client, verify the client and server names in y

General Test and Troubleshooting Procedures30 NetBackup Troubleshooting Guide - UNIXc. Verify that the same NetBackup client Service (bpcd) port numbe

Chapter 2, Troubleshooting Procedures 31General Test and Troubleshooting Proceduresa. Ensure that NetBackUpListen and NetBackupBPCD are in the Extensi

General Test and Troubleshooting Procedures32 NetBackup Troubleshooting Guide - UNIX7. Verify that the hosts file or its equivalent contains the NetBa

Chapter 2, Troubleshooting Procedures 33General Test and Troubleshooting Proceduresstart the Backup, Archive, and Restore interface on the client. For

General Test and Troubleshooting Procedures34 NetBackup Troubleshooting Guide - UNIXPay particular attention to requirements for host.xlate file entri

Chapter 2, Troubleshooting Procedures 35General Test and Troubleshooting Proceduresc. On Macintosh clients, check the mac.conf file in the NetBackup f

General Test and Troubleshooting Procedures36 NetBackup Troubleshooting Guide - UNIXbpclntcmd options that are useful for testing the functionality of

Chapter 2, Troubleshooting Procedures 37General Test and Troubleshooting Procedures◆ expecting response from server rabbit.friendlyanimals.com is the

Contents vActivity Logs on Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62Activity Logs

General Test and Troubleshooting Procedures38 NetBackup Troubleshooting Guide - UNIXExample 1: UNIX Master Server and ClientUNIX Master ServerjupiterE

Chapter 2, Troubleshooting Procedures 39General Test and Troubleshooting ProceduresUNIX Example 2: Master and Media ServersThe network in this example

General Test and Troubleshooting Procedures40 NetBackup Troubleshooting Guide - UNIXExample 2: UNIX Master and Media ServersUNIX Master ServerjupiterE

Chapter 2, Troubleshooting Procedures 41General Test and Troubleshooting ProceduresUNIX Example 3: Windows, NetWare, and Macintosh ClientsThe network

General Test and Troubleshooting Procedures42 NetBackup Troubleshooting Guide - UNIXExample 3: PC ClientsUNIX Master ServerjupiterEthernetClass Client

Chapter 2, Troubleshooting Procedures 43General Test and Troubleshooting ProceduresUNIX Example 4: Clients in Multiple NetworksThis network in this ex

General Test and Troubleshooting Procedures44 NetBackup Troubleshooting Guide - UNIXFirst, we examine the configuration of the router system. The NetB

Chapter 2, Troubleshooting Procedures 45General Test and Troubleshooting ProceduresThe first thing to note about this configuration is that the NetBac

General Test and Troubleshooting Procedures46 NetBackup Troubleshooting Guide - UNIXThe solution, in this case, is also identical to that discussed in

Chapter 2, Troubleshooting Procedures 47General Test and Troubleshooting ProceduresHost Name and Service Entry Examples- Windows NT/2000 Windows NT/20

vi NetBackup Troubleshooting Guide - UNIXIdentifying the Most Recent Database Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Exa

General Test and Troubleshooting Procedures48 NetBackup Troubleshooting Guide - UNIX.../etc/services 2bpcd 13782/tcp bpcdbprd 13720/tcp bprdbpdbm 1372

Chapter 2, Troubleshooting Procedures 49General Test and Troubleshooting ProceduresWindows NT/2000 Example 2: Master and Media ServersThe network in t

General Test and Troubleshooting Procedures50 NetBackup Troubleshooting Guide - UNIXNetBackup Configuration 1ServersGeneralClient Name: jupiterClass C

Chapter 2, Troubleshooting Procedures 51General Test and Troubleshooting ProceduresWindows NT/2000 Example 3: NetWare and Macintosh ClientsThe network

General Test and Troubleshooting Procedures52 NetBackup Troubleshooting Guide - UNIXMaster ServerWindows NT/2000NetBackup Configuration 1ServersGenera

Chapter 2, Troubleshooting Procedures 53General Test and Troubleshooting ProceduresWindows NT/2000 Example 4: Clients in Multiple NetworksThe network

General Test and Troubleshooting Procedures54 NetBackup Troubleshooting Guide - UNIXFirst, we examine the configuration of the router system. The NetB

Chapter 2, Troubleshooting Procedures 55General Test and Troubleshooting ProceduresWindows NT/2000 Example 5: Server Connects to Multiple NetworksThe

General Test and Troubleshooting Procedures56 NetBackup Troubleshooting Guide - UNIXClientWindowsClass Client ListjupitermarssaturnplutomarsEthernetEx

Chapter 2, Troubleshooting Procedures 57Using the Configure - NetBackup WindowUsing the Configure - NetBackup WindowNote Available only in the NetBack

Contents viiMedia Manager Functional Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254Startup Process . . .

Using the Configure - NetBackup Window58 NetBackup Troubleshooting Guide - UNIX

59Using the Logs and Reports3NetBackup produces the following categories of information that you can use for troubleshooting problems.◆ Reports◆ Statu

60 NetBackup Troubleshooting Guide - UNIXNote The term media server, as distinct from master server or server, does not apply to the NetBackup Busines

Chapter 3, Using the Logs and Reports 61ReportsReportsNetBackup provides a set of standard reports that gives you most of the status and error informa

Status for User Operations62 NetBackup Troubleshooting Guide - UNIXStatus for User OperationsNetBackup allows you to view status on the progress of us

Chapter 3, Using the Logs and Reports 63Activity LogsThe following is a list of facts to be familiar with before using activity logs:◆ NetBackup retai

Activity Logs64 NetBackup Troubleshooting Guide - UNIXNote NetBackup can automatically delete the activity logs only if all clients are running at lea

Chapter 3, Using the Logs and Reports 65Activity Logs◆ On Windows NT/2000 systems, set the Verbose level to 1 or more on the TroubleShooting tab of th

Activity Logs66 NetBackup Troubleshooting Guide - UNIXActivity Logs on PC ClientsActivity Logs on Windows and Netware ClientsTo enable detailed activi

Chapter 3, Using the Logs and Reports 67Activity LogsBefore using the activity logs, note the following:◆ For Windows clients, logs are kept for the n

viii NetBackup Troubleshooting Guide - UNIX

Media Manager Logs68 NetBackup Troubleshooting Guide - UNIX◆ On Windows clients, set the debug level on the TroubleShooting tab of the NetBackup Confi

Chapter 3, Using the Logs and Reports 69Media Manager LogsOn UNIXMedia Manager on a UNIX system automatically records robotic and network errors in th

Windows NT/2000 Event Viewer Logging Option70 NetBackup Troubleshooting Guide - UNIXlog.110894To disable vmd debug logging, either delete the director

Chapter 3, Using the Logs and Reports 71Windows NT/2000 Event Viewer Logging OptionTo Enable the Logging Tool1. Create the following file on the NetBa

Troubleshooting the Java Administration Interface72 NetBackup Troubleshooting Guide - UNIX64 = Backup Status128 = Media Device◆ If the file is empty,

Chapter 3, Using the Logs and Reports 73Troubleshooting the Java Administration InterfaceThe following are the four kinds of error messages seen in th

Troubleshooting the Java Administration Interface74 NetBackup Troubleshooting Guide - UNIXEnabling Detailed Activity LoggingThe NetBackup Java Adminis

Chapter 3, Using the Logs and Reports 75Troubleshooting the Java Administration Interface4. If you are using the Windows Display Console, you should a

Troubleshooting the Java Administration Interface76 NetBackup Troubleshooting Guide - UNIX

77Status Codes and Messages4This chapter lists all the status codes and messages provided by NetBackup. There are two parts to the chapter:◆ The first

ixPrefaceThis guide explains how to isolate and resolve problems encountered when installing, configuring, or using VERITAS NetBackup™ for UNIX. This

Status Codes78 NetBackup Troubleshooting Guide - UNIXRecommended Action: None, unless this was a database backup performed through a database extensio

Chapter 4, Status Codes and Messages 79Status Codes◆ On PC clients, check the exclude list per the instructions in the user’s guide for the client.◆ O

Status Codes80 NetBackup Troubleshooting Guide - UNIXRecommended Action:1. Ensure that the client’s server list contains entries for the master server

Chapter 4, Status Codes and Messages 81Status CodesStatus Code: 7Message: the archive failed to back up the requested filesExplanation: Errors caused

Status Codes82 NetBackup Troubleshooting Guide - UNIXRecommended Action:1. Check the All Log Entries and Problems reports to determine which system ca

Chapter 4, Status Codes and Messages 83Status CodesSystem requirements vary; thus, no absolute recommendations can be made. One customer running both

Status Codes84 NetBackup Troubleshooting Guide - UNIX04/28/99 11:27:59 AM: [216]: FTL - Backup operation aborted!If this error is encountered, try one

Chapter 4, Status Codes and Messages 85Status CodesThis indicates that the cache partition is not large enough. If possible, increase the size of the

Status Codes86 NetBackup Troubleshooting Guide - UNIX◆ A bad network interface card on the NetBackup server.◆ Faulty routers.◆ Other applications inte

Chapter 4, Status Codes and Messages 87Status Codes1. Check the NetBackup Problems report for clues on why the failure occurred. 2. On a UNIX system,