nbstlutil

nbstlutil — run the NetBackup storage lifecycle policies utility

SYNOPSIS

<admin_dir_path>nbstlutil active | inactive [-wait | -force] [[[-lifecycle name] [-destination name]] | -backupid value]

<admin_dir_path>nbstlutil cancel [-wait | -force] [[[-lifecycle name] [-destination name [-nowarn]]] | -backupid value]

<admin_dir_path>nbstlutil list [-l] [-U] [[[-lifecycle name | -lifecycle_only] [-destination name]] | -backupid value] [-client name] [-mediaid value] [-mediaserver name] [-storageserver name] [-image_state value] | -copy_state value | -frag_state value | -image_incomplete | -image_inactive | -copy_incomplete | -copy_inactive]

<admin_dir_path>nbstlutil stlilist [-l] [-U] [[[-lifecycle name] [-destination name]] | -backupid value] [-client name] [-mediaid value] [-mediaserver name] [-storageserver name] [-image_state value | -image_incomplete | -image_inactive]

<admin_dir_path>nbstlutil diskspaceinfo [-stype name]

On Windows systems, <admin_dir_path> is <install_path>\NetBackup\bin\admincmd\

DESCRIPTION

The nbstlutil command provides a way for users to intervene in storage lifecycle operations. The following are the utility functions:

active

Activates the lifecycle operations on selected image copies.

cancel

Cancels a list of image copies as selected by the -lifecycle option or the -destination option. Cancelling a storage lifecycle policy cancels all the pending copies for it. Cancelling a specific destination cancels all the pending copies that are bound for the named destination regardless of lifecycle policy. Any new work that shows up afterwards is processed normally.

diskspaceinfo

Reports on the space that are used by all disk volumes or only the disk volumes that the specified type uses.

inactive

Deactivates future lifecycle operations on selected image copies, but retains the image information so that processing can resume.

list

Shows the contents of an image list (EMM database). The tables can be listed that hold the information about the images that lifecycles process. This option is primarily a debugging tool, but support may use the information to troubleshoot problems.

stlilist

Shows the status for incomplete copies of lifecycle managed images.

OPTIONS

-backupid value

Selects a specific image that is specified by value.

-client name

Restricts the listing of images for storage lifecycle operations to only those on the client that is specified by name.

-copy_inactive value

Selects the images for which one or more copies are marked as inactive in the EMM database. This option is used primarily for debugging.

-copy_incomplete value

Selects the images for which one or more copies are not marked as duplication complete in the EMM database. This option is used for debugging.

-copy_state value

Selects the images with the specified copy state in the EMM database. This option is used primarily for debugging. Valid values for copy state are as follows:

  • 1 - NOT_STARTED

  • 2 - IN_PROCESS

  • 3 - COMPLETE

  • 9 - NOT_STARTED | INACTIVE

  • 10 - IN_PROCESS | INACTIVE

-destination name

Selects the images that are scheduled to be duplicated to the storage unit or storage unit group that is specified by name.

-force

Forcefully cancels the pending lifecycle operations at a specified destination.

-frag_state value

Selects the images with the specified fragment state in the EMM database. This option is used for debugging. Valid values for frag state are as follows:

  • 1 - ACTIVE

  • 2 - TO_BE_DELETED

  • 3 - ELIGIBLE_FOR_EXPIRATION

-image_inactive value

Selects the images that are marked as inactive in the EMM database. This option is used for debugging.

-image_incomplete value

Selects the images that are not marked as lifecycle complete in the EMM database. This option is used for debugging.

-image_state value

Selects the images with the specified image state in the EMM database. This option is used primarily for debugging. The valid values for image state are as follows:

  • 1 - NOT_STARTED

  • 2 - IN_PROCESS

  • 3 - COMPLETE

  • 9 - NOT_STARTED | INACTIVE

  • 10 - IN_PROCESS | INACTIVE

-l

Produces a condensed parsable output of the listing.

-lifecycle name

Selects the images that the specified lifecycle has created.

-mediaid value

Restricts the listing of images for storage lifecycle operations to only those on the media ID that value specifies.

-mediaserver name

Restricts the listing of images for storage lifecycle operations to only those on the media that name specifies.

-nowarn

Skips the interactive warning message.

-state value

Selects a state field that value specifies in the EMM database. This option is used primarily for debugging.

-storageserver name

Restricts the listing of images for storage lifecycle operations to only those on the storage server that name specifies.

-stype name

Specifies the disk space type to be reported on. Variable name can be AdvancedDisk, SharedDisk, NearStore, PureDisk, or a vendor-supplied OpenStorage name.

-U

Produces user-readable output of the listing.

-wait

Waits to cancel the pending lifecycle operations at a specified destination.

EXAMPLE

EXAMPLE 1

The following command displays the information about a lifecycle in-process image.

# nbstlutil -list -U 
Image:
 Master Server			: abc.min.veritas.com
 Backup ID				: abc_1225727
 Client				 : abc
 Backup Time			: 1225727 (Mon Nov  3 09:58:48 2008)
 Policy				 : Pol_SLPTest1
 Client Type			: 0
 Schedule Type			: 0
 Storage Lifecycle Policy : SLP_Test1
 Storage Lifecycle State  : 2 (IN_PROCESS)
 Time In Process		: 1225727940 (Mon Nov  3 09:59:00 2008)
 Data Classification ID   : (none specified)

Copy:
 Master Server	 : abc.min.veritas.com
 Backup ID		 : abc_1225727
 Copy Number		 : 1
 Expire Time		 : 2147483 (Mon Jan 18 21:14:07 2038)
 Try To Keep Time	: 1225735 (Mon Nov  3 11:58:48 2008)
 Residence		 : AdvDisk1
 Duplication Status  : 3 (COMPLETE)
 Job ID			: 0
 Retention Type	: 0 (FIXED)
 MPX State		 : 0
 Source			: 0

Fragment:
 Master Server	 : abc.min.veritas.com
 Backup ID		 : abc_1225727
 Copy Number	 : 1
 Fragment Number   : 1
 Resume Count	: 0
 Media ID		: @ab
 Media Server	: abc.min.veritas.com
 Storage Server	: (none specified)
 Media Type		: 0 (DISK)
 Media Sub-Type	: 6 (STSDYNAMIC)
 Fragment State	: 1 (ACTIVE)
 Fragment Size	 : 32768
 Delete Header	 : 1
 Fragment ID	 : @ab

Copy:
 Master Server	 : abc.min.veritas.com
 Backup ID		 : abc_1225727
 Copy Number		 : 2
 Expire Time		 : 2147483 (Mon Jan 18 21:14:07 2038)
 Try To Keep Time	: 1225735 (Mon Nov  3 11:58:48 2008)
 Residence		 : AdvDisk2
 Duplication Status  : 3 (COMPLETE)
 Job ID			: 0
 Retention Type	: 0 (FIXED)
 MPX State		 : 0
 Source			: 0

The output displays "(none specified)" for blank fields.

EXAMPLE 2

The following command displays the information for a lifecycle incomplete image.

# nbstlutil list -l
V7.0 I abc.min.veritas.com abc_1225727 abc 1225727 Pol_SLPTest1 0 0 SLP_Test1 2	\
1225727 *NULL*
V7.0 C abc.min.veritas.com abc_1225727 1   2147483 1225735 AdvDisk1 3 0 0 0 0
V7.0 F abc.min.veritas.com abc_1225727 1   1 0 @ab abc.min.veritas.com *NULL* 0 6 1  \
32768 1 @ab
V7.0 C abc.min.veritas.com abc_1225727 2   2147483 1225735 AdvDisk2 3 0 0 0 0

EXAMPLE 3

The following command displays the information for an incomplete lifecycle image.

# nbstlutil stlilist -U
Image abc_1225727928 for Lifecycle SLP_Test1 is IN_PROCESS
  Copy to abc-tape1 is IN_PROCESS
  Copy to AdvDisk3 is NOT_STARTED

EXAMPLE 4

The following command displays the information for an incomplete lifecycle image.

# nbstlutil stlilist -l
V6.5 I abc_1225727928 SLP_Test1 2
V6.5 C abc-tape1 2
V6.5 C AdvDisk3 1