NetBackup Flashback Up Version-3.4
NetBackup Flashback Up Version-3.4
UNIX
June 2000
100-001493
Disclaimer
The information contained in this publication is subject to change without notice.
VERITAS Software Corporation makes no warranty of any kind with regard to this
manual, including, but not limited to, the implied warranties of merchantability and
fitness for a particular purpose. VERITAS Software Corporation shall not be liable for
errors contained herein or for incidental or consequential damages in connection with the
furnishing, performance, or use of this manual.
Copyright
Copyright © 1998-2000 VERITAS Software Corporation. All rights reserved. VERITAS is a
registered trademark of VERITAS Software Corporation in the US and other countries.
VxVM, VxVA, VxFS, and FirstWatch are registered trademarks of VERITAS Software
Corporation. The VERITAS logo, VERITAS NetBackup, VERITAS NetBackup
FlashBackup, VERITAS Volume Manager, VERITAS File System, VERITAS HSM,
VERITAS Media Librarian, CVM, VERITAS Quick I/O, and VxSmartSync are trademarks
of VERITAS Software Corporation. All other trademarks or registered trademarks are the
property of their respective owners.
Portions of this software are derived from the RSA Data Security, Inc. MD5
Message-Digest Algorithm. Copyright 1991-92, RSA Data Security, Inc. Created 1991. All
rights reserved.
Printed in the USA, June 2000.
VERITAS Software Corporation
1600 Plymouth St.
Mountain View, CA 94043
Phone 650–335–8000
Fax 650–335–8050
www.veritas.com
Contents
About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii
Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii
Related Manuals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Type Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Notes and Cautions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Key Combinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Command Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Technical Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Chapter 2. Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Installing FlashBackup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Step 1: Load From Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Step 2: Distribute FlashBackup to the Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Step 3: Install snap Driver (Solaris) or Move FlashBackup Library (HP) . . . . . . . . 11
Deinstalling FlashBackup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
iii
Server Deinstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Client Deinstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Chapter 3. Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
General Class Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Client List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
File List and Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Allow Multiple Data Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
General Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Client Read Timeout Setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Contents v
vi NetBackup FlashBackup System Administrator’s Guide
About This Guide
This guide explains how to install, configure, and use VERITAS NetBackup
FlashBackupTM. In this publication, VERITAS NetBackup is referred to as NetBackup and
VERITAS NetBackup FlashBackup is referred to as FlashBackup.
Audience
This guide is intended for the system administrator responsible for configuring
FlashBackup and assumes a thorough working knowledge of NetBackup administration.
Organization
◆ Chapter 1, “Introduction,” is an overview of the product’s capabilities.
◆ Chapter 2, “Installation,” explains how to install FlashBackup.
◆ Chapter 3, “Configuration,” explains how to configure your system to use
FlashBackup. This chapter supplements the information in the NetBackup System
Administrator’s Guide - UNIX.
◆ Chapter 4, “Using FlashBackup,” explains how to back up a FlashBackup class and
how to restore files from FlashBackup backups.
◆ Appendix A, “Solaris snapctl Driver,” provides information about the snapctl
driver.
Related Manuals
◆ NetBackup Release Notes
Describes the platforms and operating systems that are supported and provides
operating notes that may not be in the manuals or the online help.
◆ NetBackup System Administrator’s Guide - UNIX
Explains how to configure and manage NetBackup on a UNIX platform.
vii
Conventions
Conventions
The following explains typographical and other conventions used in this guide.
Type Style
Typeface Usage
Bold fixed width Input. For example, type cd to change directories.
Fixed width Paths, commands, filenames, or output. For example: The default installation
directory is /opt/VRTSxx.
Italics Book titles, new terms, or used for emphasis. For example: Do not ignore cautions.
Sans serif (italics) Placeholder text or variables. For example: Replace filename with the name of your
file.
Sans serif (no italics) Graphical user interface (GUI) objects, such as fields, menu choices, etc.
For example: Enter your password in the Password field.
Note This is a Note and is used to call attention to information that makes it easier to use
the product or helps you to avoid problems.
Caution This is a Caution and is used to warn you about situations that can cause data
loss.
Key Combinations
Some keyboard command sequences use two or more keys at the same time. For example,
you may have to hold down the Ctrl key before you press another key. When this type of
command is referenced, the keys are connected by plus signs. For example:
Press Ctrl+t
Command Usage
The following conventions are frequently used in the synopsis of command usage.
brackets [ ]
The enclosed command line component is optional.
Vertical bar or pipe (|)
Separates optional arguments from which the user can choose. For example, when a
command has the following format:
command arg1|arg2
the user can use either the arg1 or arg2 variable.
Getting Help
For updated information about this product, including system requirements, supported
platforms, supported peripherals, and a list of current patches available from Technical
Support, visit our web site:
http://www.veritas.com/
For product assistance, contact VERITAS Customer Support.
US and Canadian Customers: 1-800-342-0652
International Customers: +1 (650) 335-8555
VERITAS Customer Support can also be reached through electronic mail at:
[email protected]
Requirements
FlashBackup requires the following components:
◆ A UNIX master server with NetBackup 3.4 or later installed.
◆ NetBackup clients that have Solaris 2.6, Solaris 7, or Solaris 8, and NetBackup 3.4 or
later client software installed, or NetBackup clients that have HP 11.00 and
NetBackup 3.4 or later installed.
◆ The FlashBackup dynamic shared library (libbpfsmap.so for Solaris or
libbpfsmap.sl for HP) must be installed on the clients.
◆ If you are using VxFS file systems, VxFS 3.3.2 or later must be installed on the clients.
If you are using JFS file systems on HP, JFS 3.3 or higher must be installed on the
clients.
◆ For Solaris only, the FlashBackup snapctl driver must be installed on the clients.
◆ A raw disk partition to act as the cache device.
1
Features
Features
The features that distinguish FlashBackup from other raw-partition backups and standard
file system backups are:
◆ FlashBackup backs up the following file systems: ufs (Solaris), VxFS (Solaris and HP),
and JFS (HP)
◆ Allows individual file restores
FlashBackup provides a file system mapping capability that allows individual files to
be restored from FlashBackup raw-partition backups.
◆ Supports multiple data streams
It is possible to split a backup into multiple data streams in order to further increase
the performance of FlashBackup raw-partition backups.
◆ Uses standard NetBackup utilities for raw partition restores
You can restore raw partitions from FlashBackup backups by using the NetBackup
server Java interface (jbpSA), or by using the standard xbp or bp restore raw
partitions mechanism on the FlashBackup client.
◆ The file system remains mounted during raw-partition backups
It is not necessary to unmount the file system or mount it read only, as with standard
raw-partition backups.
FlashBackup has on-line backup capability that allows the file system mounted on the
raw partition to be modified while the backup is in progress.
This on-line backup capability is made possible by backing up a snapshot of the raw
partition. The snapshot is a consistent image of the file system at the moment the
backup began. The snapshot mechanism is provided by the FlashBackup snapctl
driver for Solaris ufs backups, and by VxFS snapshot for VxFS backups.
◆ Provides economical use of kernel resources (Solaris only)
While a snapshot is active, the snapctl driver requires only four kilobytes of
physical RAM per gigabyte of snapped file system.
◆ Has no effect on file system reliability
The snapctl driver does not affect file system reliability. When a file system block is
updated, the write to the snapped partition always completes, regardless of errors
involving the snapshot. For example, the write will complete even if a cache overflow
occurs.
Note While a snapshot is in effect, reads of the snapped file system will execute without
loss of performance. Writes to a snapped file system, however, will suffer speed
degradation of 200 to 300% the first time a particular block is written. After a block
has been cached, subsequent writes to that block will execute without degradation
in speed.
Restrictions
◆ FlashBackup does not support file systems managed by HSM.
Chapter 1, Introduction 3
Technical Overview
Technical Overview
The following figure shows the major NetBackup components involved in FlashBackup
backups.
Master server
Backup Solaris or HP
Request client
jnbSA or bprd
bpadm
Backup
Request
ifrfr
bpdbm
bpsched
info
ck
up
i
nfo
bpcd
Class
info Class bpcd
info
Class
bptm info
(parent) bpbrm
Backup Bac Ba bpbkar
kup ck
image up
ima bptm inf
ge o Class
(child)
info
Bac
ku p im libbpfsmap.so (Solaris)
age
libbpfsmap.sl (HP-UX)
Tape or Optical
Cache Cache
disk disk
Scheduled backups and immediate backups of FlashBackup classes are initiated and processed
in the same manner as standard class backups. However, the Individual file restore from raw
(ifrfr)attribute, which defines FlashBackup classes, causes bpsched to send the special
-ifrfr flag to bpbrm along with the other class information. bpbrm starts bpbkar with
the -ifrfr flag, which causes bpbkar to invoke the FlashBackup dynamic shared library
(libbpfsmap.so on Solaris, libbpfsmap.sl on HP).
During the backup, the dynamic shared library (libbpfsmap.so or
libbpfsmap.sl)performs the following tasks:
◆ Creates a file system map that represents files contained in the raw partition.
◆ If the backup type is a file incremental, the dynamic shared library creates a bit map
that associates blocks belonging to selected files with their physical addresses in the
partition. Note that block level incrementals are not supported.
◆ Turns on the raw-partition snapshot mechanism so that when a block is updated in
the partition, the previous contents of the block are written to the cache partition.
◆ Sends the backup information to bpbrm, which in turn directs the backup information
to bpdbm. The backup information is composed of:
◆ File system map name
◆ Bit map name (if incremental)
◆ Individual file names
◆ Raw-partition name
◆ Transmits the backup image to bptm. The backup image is composed of:
◆ File system map data blocks
◆ Bit map data blocks
◆ Raw-partition data blocks
◆ Turns off the snapshot mechanism.
Chapter 1, Introduction 5
Technical Overview
The following figure shows the major components involved in restoring files from
FlashBackup backup images.
Restore Restore
request request
jbpSA bprd xbp or bp
Backup
info
bpdbm
sfr
Media server ap
m
em
st
sy
le fo
Fi in bpcd
r
fe
ans
t r
le
Fi
bptm
(parent) bpbrm bpcd
Dat
ab
loc
ks
bptm
(child)
Data blocks tar
Tape or Optical
Client
disk
During a restore, the user browses for and selects files from FlashBackup images in the
same manner as standard backup images. The difference is that bprd calls the sfr
program when processing FlashBackup images. During a restore, the sfr program
performs the following tasks:
◆ Retrieves information about the backup from bpdbm. The backup information is
composed of:
◆ File system map name and its media location.
◆ Bit map name and its media location.
◆ Raw-partition name and its media location.
◆ Using the backup information, sfr retrieves the file system map data by directing
bptm to the location of the file system map on the tape and then reading from the
tape. A similar procedure is followed to position bptm to obtain the bit map data
when restoring from incremental backup images and to obtain the raw-partition data
when restoring the raw partition.
◆ Then, using the information contained in the file system map, sfr directs bptm to the
location of the individual file data blocks on the tape.
bptm then reads the file data blocks from the tape and writes them to the client’s tar
program. Finally, tar writes the file data to the client disk.
Chapter 1, Introduction 7
Technical Overview
Prerequisites
◆ A UNIX master server with NetBackup 3.4 or later installed.
◆ NetBackup FlashBackup Solaris clients must have Solaris 2.6, Solaris 7, or Solaris 8
installed. NetBackup FlashBackup HP clients must have HP-UX 11.00 installed.
FlashBackup provides the necessary libraries and drivers for these clients.
◆ NetBackup 3.4 or later client software must also be installed.
◆ If you are going to perform VxFS backups, you must have VxFS 3.3.2 or later installed
on the clients.
Caution If you are using a version of NetBackup that is earlier than the version defined
for your platform, upgrade to the required version before installing
FlashBackup. Otherwise, your FlashBackup backups will work but restores of
files greater than two gigabytes will fail.
Installing FlashBackup
2. Make sure a valid license key for NetBackup FlashBackup has been registered by
entering the following command to list and add keys:
/usr/openv/netbackup/bin/admincmd/get_license_key
9
Installing FlashBackup
Note If the master server is a Solaris or HP system and the master server is also a client,
you do not have to distribute FlashBackup software to the client on the master
server. This distribution is done automatically when you load the software from the
media (see previous step). However, you must distribute the software as explained
below to all other clients that will be using FlashBackup.
1. Distribute FlashBackup client software to the desired UNIX clients by executing the
following commands as the root user on the Netbackup FlashBackup server.
b. If only one bprd shows up in the bpps output, there are no active backups or
restores. In that case, terminate the bprd daemon by executing:
/usr/openv/netbackup/bin/admincmd/bprdreq -terminate
If more than one bprd appears, wait until the backups and/or restores are
complete and then run /usr/openv/netbackup/bin/bpps again. When only
one bprd shows up, terminate the bprd daemon.
2. After FlashBackup client software has been distributed to the desired clients, start the
NetBackup daemons as the root user on the master server by executing:
/usr/openv/netbackup/bin/initbprd
Chapter 2, Installation 11
Deinstalling FlashBackup
Deinstalling FlashBackup
Server Deinstall
On the master server where you initially loaded the FlashBackup software, execute the
following:
For Solaris NetBackup servers, execute:
pkgrm SUNWnbfsh
For other UNIX NetBackup servers, delete the following:
/usr/openv/netbackup/bin/driver/HP9000*/HP_UX11.00/*
/usr/openv/netbackup/bin/driver/Solaris/Solaris2.6/*
/usr/openv/lib/client/*/libbpfsmap.*
Client Deinstall
On each NetBackup client that is using FlashBackup:
1. On Solaris only: execute the following to verify that no snapshots are active:
/usr/openv/netbackup/bin/driver/snaplist
If a snapshot is active, wait until the snapshot completes and then do step 2.
13
Client List
Client List
The client list specifies the clients on which you installed the FlashBackup software. The
clients must be Solaris 2.6, 7, 8, or HP 11.00.
Note A client must contain all the raw partitions that are specified in the file list for
backups to succeed. Otherwise, you must put the clients in separate classes.
The entries in the file list for a FlashBackup class are the same as for a standard
raw-partition backup, except that there must be a special CACHE= entry before any raw
partition entries.
For example:
CACHE=/dev/rdsk/c0t4d0s0
/dev/rdsk/c0t4d0s7
The CACHE= entry specifies the cache partition to be used for storing any updates to the
raw-partition entry while the backup is in progress.
◆ The raw-partition entry specifies the disk partition on the client to be backed up.
◆ For all entries in the file list, enter the full path name of the device file. Do not specify
wildcards (such as /dev/rdsk/c0*) as paths for any entry.
Note Ensure that you are specifying the actual character special device file for each entry.
FlashBackup will not work for block special device files.
/dev/rdsk/c0t4d0s3
◆ The cache partition is part of the snapshot mechanism that preserves a consistent view
of the raw partition for NetBackup.
The basic requirements for the cache partition are:
◆ Must reside on the same host as the raw partitions that you are backing up.
◆ Multiple backups cannot use the same cache partition simultaneously on HP-UX
systems. If multiple classes list the same cache partition on HP-UX systems,
backups naming those classes must be run at different times to prevent a failure.
◆ Cannot be the raw partition being backed up, or one that is used as part of
another file system or virtual partition.
◆ Must be unmounted.
◆ Must have enough space to hold all the writes to the partition that may occur
during the backup. Note that backups during nonworking hours normally
require a smaller cache than a backup during peak activity times. Also see the
introductory section in Appendix A.
◆ You can include directives if Allow multiple data streams is set for the class (see
“Allow Multiple Data Streams,” below).
Note For best performance, use only one data stream to back up each physical device on
the client. Multiple concurrent streams from a single physical device can adversely
affect backup times.
The directives that you can use in the file list for a FlashBackup class are:
NEW_STREAM
CACHE=value (see “File List and Cache” earlier in this chapter)
UNSET
Chapter 3, Configuration 15
File List and Cache
UNSET_ALL
For FlashBackup classes, the NEW_STREAM directive must be the first line of the file list.
This directive causes the following to occur:
◆ The backup is split into a separate stream at each point in the file list where the
NEW_STREAM directive occurs.
◆ All file paths between NEW_STREAM directives are in the same stream.
◆ The end of a stream is defined by the start of a new stream (that is, another
NEW_STREAM directive) or the end of the file list.
For example, consider the file lists below:
Schedules
FlashBackup supports only full and incremental schedule types. User backup and archive
schedule types are not allowed.
General Configuration
Chapter 3, Configuration 17
General Configuration
Performing a Backup
19
Performing a Server-Directed Restore
Note Do not choose Browse backups (restore raw partitions) or Browse backups (Auspex
FastBackup raw partition).
4. In the Backup Images pane, select the desired FlashBackup backup and update the
display (choose Update Display on the Edit menu).
The list of directories and files appears in the Directory Structure and Files panes in
the same way as if you had chosen a regular file system backup.
Note To restore an entire raw partition, select a FlashBackup full backup. You cannot
restore the partition from FlashBackup incremental backups because those
incrementals support only individual file restores.
4. In the Backup Images pane, select the desired FlashBackup full backup and update
the display (choose Update Display on the Edit menu).
The list of device paths appears in the Directory Structure and Files panes.
5. Select the desired directory or device paths and start the restore.
Troubleshooting
This section addresses issues and problems encountered when using FlashBackup.
◆ Backup Messages
During a backup, FlashBackup messages are logged to the bpbkar activity log directory
on the client: /usr/openv/netbackup/logs/bpbkar. If necessary, create this
directory (use access mode of 777 so the client can write to the logs).
◆ Restore Messages
During a restore, FlashBackup messages are logged to the bprd activity log directory on
the master server: /usr/openv/netbackup/logs/bprd. If necessary, create this
directory (use access mode of 777 so the client can write to the logs).
◆ snapctl Driver Messages
Messages from the snapctl driver are logged in the client’s /var/adm/messages file
along with other kernel messages.
If the snap driver files do not exist, install the snap driver as described in Chapter 2 on
page 11.
/usr/openv/netbackup/SFR_TMPDIR
and enter the commands listed above for the server or client, specifying a different
directory for fb_tmp_dir.
a. Determine if there are stale snapshots on your Solaris client by executing the
following:
/usr/openv/netbackup/bin/driver/snaplist
b. For each snapshot listed, execute the following to make sure there is a bpbkar
process associated with it:
ps -eaf |grep ident
where ident is the snapshot process id displayed by the snaplist command.
c. Remove snapshots that do not have an associated bpbkar process by entering the
following:
/usr/openv/netbackup/bin/driver/snapoff snapn
where snapn is the snapshot id displayed by the snaplist command.
◆ On Solaris: The snap.c component of the snap driver snapctl must be at version
1.22 or higher. Earlier versions of this file could cause the backup to fail with status
code 13.
Execute the following to determine the version of the snap.c component of
snapctl.
cd /usr/kernel/drv
strings snapctl |grep Revision
If snap.c is at an earlier version than 1.22, you have a pre-release version of the
product and must install the official release version.
The restore failed with status code 5 after a NetBackup patch was installed
If you receive status code 5 when attempting to restore a FlashBackup file after a
NetBackup patch was installed, the patch may not have been installed properly. Follow
the installation instructions in the patch README file and make sure the libsfr.so file
is copied as instructed.
On Solaris: The backup failed with status code 6, with an ’insane directory
entry’ message in the bpbkar log file
To avoid this error, the snap.c component of the snap driver snapctl must be at version
1.22 or higher. Earlier versions of this file could cause the backup to fail with status code 6
and ’insane directory entry’ messages in the bpbkar log.
Execute the following to determine the version of the snap.c component of snapctl.
cd /usr/kernel/drv
strings snapctl |grep Revision
If snap.c is at an earlier version than 1.22, you have a pre-release version of the product
and must install the official release version.
◆ If this is a new installation, the update_flashclients log file in /tmp will contain
the following entry:
Couldn’t execute sh /usr/openv/netbackup/bin/extract.sh>/dev/null
2>/dev /null on duo
◆ If update_flashclients is being used to install a patch and
update_flashclients is run from the /usr/openv/netbackup/bin directory,
the files will not be updated on the client but there will be no indication of a failure in
the log file.
If you are having this problem, make sure to run the update_flashclients script from
the / (root) directory.
Command Usage
snapoff
snapoff terminates a snapshot that was previously initiated by a backup that failed
abnormally. snapoff must be invoked as:
/usr/openv/netbackup/bin/driver/snapoff snap1 ... snapn
27
Command Usage
snaplist
This command must be invoked as:
/usr/openv/netbackup/bin/driver/snaplist
snaplist displays information about all active snapshots in the following form:
id device size cached cache err time
1 /dev/rdsk/c0t3d0s0 72560 16450 /dev/rdsk/c0t4d0s0 0 12/19/99 13:23:48
Where:
◆ size is the size of the snapped partition in 512-byte blocks.
◆ cached is the number of 512-byte blocks that have been cached (written to) for this
snapshot since it was initiated.
◆ err is an error code; 0 indicates no error.
If a snapshot has encountered an error, then err will be non-zero and the snapshot
will be inaccessible. It can be terminated using snapoff. Error codes are identified in
/usr/include/sys/errno.h. Also, error messages may be found in
/var/adm/messages.
snapcachelist
This command must be invoked as:
/usr/openv/netbackup/bin/driver/snapcachelist
snapcachelist displays information about all partitions currently in use as snapshot
caches. It is useful for monitoring the extent to which caches are full. Displayed output is
of the form:
device free busy
/dev/rdsk/c0t4d0s0 238528 264472
Where:
◆ free is the number of 512-byte blocks available.
◆ busy is the number of 512-byte blocks that have been written to.
When a cache is full, any write to a snapped partition or snapped file system associated
with that cache will cause the snapshot to fail and the snapshot will no longer be readable
or writable. Reads or writes to the snapped partition will remain unaffected. The failed
snapshot will not be terminated automatically and must be terminated using snapoff in
the usual way.
Note Snapshots used by the FlashBackup mechanism in NetBackup are initiated and
terminated by NetBackup. While a FlashBackup backup is in progress, snaplist
and snapcachelist can be used to monitor the snapshot.
snapstat
The snapstat command must be invoked as:
/usr/openv/netbackup/bin/driver/snapstat
snapstat displays diagnostic information about the snap driver.
31
P driver log 22
patch, troubleshooting 25, 26 file 23
performance 3 overview 27
snaplist command 28
R
snapoff command 27
raw partition
snapshot 2
backup 19
cache partition 26
client-directed restore 21
on Solaris client, troubleshooting 24
server-directed restore 20
snapstat command 29
reliability 2
streams, allow multiple data 15
restore
supported platforms 9
client-directed 21
symbolic links 23
individual files 4, 21
overwrite option 20 T
re. device file 20 technical overview 4
server-directed 20 temporary files (/tmp directory) 23, 24
restrictions 3 troubleshooting 22
types of backups supported 17
S
sfr 6 U
SFR_TMPDIR 23 UNSET 17
shared libraries 5 UNSET_ALL 17
snap driver update_flashclients script 25, 26
installation 11
V
not installed 23
VERBOSE setting for logs 22
snap.c component of snapctl 25
snapcachelist command 28 X
snapctl xbp 21
.conf file 23