bpfis

bpfis — create or delete a snapshot, or return information about existing snapshots

SYNOPSIS

<nbu_dir_path>bpfis create [-rhost host] [-id id] [-v] [-V] [-owner owner] -fim fim_name[:option=value,option=value,...] [-pt policy_type] file1 [file2...]

<nbu_dir_path>bpfis delete [-force] -id id

<nbu_dir_path>bpfis deletedb -id id

<nbu_dir_path>bpfis query [-id id]

<nbu_dir_path>bpfis verify [create_options]

On Windows systems, <nbu_dir_path> is <install_path>\NetBackup\bin\

DESCRIPTION

The bpfis command can create, delete, or query snapshots of a client system (file system or volume).

Note:

To store the image on tape or other media requires that you run a separate backup job.

For more detailed examples and procedures for using bpfis, refer to the NetBackup Snapshot Client Administrator's Guide.

You must have administrator privileges to run this command.

OPTIONS

The bpfis command allows the following operations:

create

Creates a snapshot with the specified snapshot method.

delete

Deletes the snapshot that -id identifies.

deletedb

Deletes from the snapshot database the snapshot entry that -id identifies.

query

Retrieve detailed information on the specified snapshot of a client system.

verify

Verify that the snapshot that create_options describes is able to be created.

The following are the other options for the bpfis command:

-rhost

The remote host or alternate client on which the snapshot is made accessible. The default is the local host.

On Windows systems, the -rhost option can be used with the FlashSnap method only.

-id

For bpfis create, this option is a user-defined snapshot identifier. The default ID is a timestamp that shows when the image was created.

For bpfis delete, this option designates the ID of the snapshot to be deleted.

For bpfis query, this option designates the ID of the snapshot for which to return information.

-v -V

Indicates the verbosity levels in the log files. -V is a higher level of verbosity than -v. Default is non-verbose.

-owner owner

Specifies the owner of this snapshot (default is GENERIC).

-fim fim_name[:option=value,option=value, ...]

Specifies the snapshot method to use to create the image. Select the method by using the type of data and hardware that the client uses.

For details on snapshot methods, refer to the NetBackup Snapshot Client Administrator's Guide.

The available options depend on the snapshot method. For a list of snapshot methods and their options, refer to the <opt_params> area of each snapshot method (FIM) listed in the vfm.conf file.

For example, under the BusinessCopy snapshot method, the first optional parameter is listed as follows:

keep_fi=%b[0]#Keep frozen image after backup

Where keep_fi= is the option, and the value is Boolean (0 for no, 1 for yes).

For an example of the bpfis command that uses the value option, refer to bpfis in the NetBackup Snapshot Client Administrator's Guide.

-pt policy_type

Specifies the NetBackup policy type that the snapshot method must support.

file1 file2

Specifies the path of the file system or volume from which the snapshot is to be made.

-force

Specifies the force delete.

EXAMPLES

EXAMPLE 1

Create a snapshot of E:\ on hostB by using the FlashSnap method on a Windows client.

install path\bin\bpfis create -rhost hostB -fim FlashSnap E:\

Sample output:

INF - BACKUP START 26808
INF - FIS_ID=1034037338
INF - REMAP FILE BACKUP E: USING <GUID>
OPTIONS:ALT_PATH_PREFIX=/tmp/_vrts_frzn_img_26808,FITYPE
INF - EXIT STATUS 0: the requested operation was successfully 
completed

EXAMPLE 2

To obtain information about a particular snapshot on the local host:

# bpfis query -id 1034037338

Sample output:

INF - BACKUP START 26838
INF - Frozen image host : ricochet
INF - Frozen image owner: GENERIC
INF - Time created	: Mon Oct  7 19:35:38 2007

INF - REMAP FILE BACKUP E: USING <GUID> (Windows systems)

OPTIONS:ALT_PATH_PREFIX=/tmp/_vrts_frzn_img_26808,FITYPE=MIRROR,

MNTPOINT=E:\,FSTYPE=NTFS (Windows systems)

INF - EXIT STATUS 0: the requested operation was successfully 
completed

EXAMPLE 3

To delete a snapshot on the local host:

# bpfis delete -id 1034037338

Sample output:

INF - BACKUP START 26839
INF - EXIT STATUS 0: the requested operation was successfully 
completed