Lifecycle operation administration using the nbstlutil command

The NetBackup storage lifecycle policy utility command (nbstlutil) gives administrators the ability to intervene between pending SLP operations. Specifically, the nbstlutil command can be used to cancel, inactivate, or activate the processing of existing SLP-managed images.

nbstlutil cannot affect the jobs that are currently running or queued. Use the Activity Monitor to intervene in the jobs that are running or queued.

Table: nbstlutil details

nbstlutil information	Details
Where to find	The command is found in the following location: On Windows: install_path\NetBackup\bin\admincmd\nbstlutil On UNIX: /usr/openv/netbackup/bin/admincmd/nbstlutil Note: In NetBackup 10.3 and later, the nbstlutil binary is only present on NetBackup primary servers. Do not port the nbstlutil binary to non-primary servers.
How to use	Use nbstlutil to perform the following administrative actions: List the status of SLP-managed images. You can print the status of SLP-processed images. Support may request this information to troubleshoot an SLP problem. Cancel pending duplication operations on the selected images or image copies. When a duplication is canceled, NetBackup considers the image or image copy to be SLP complete. It does not attempt to create any more copies of the backup image. Deactivate (suspend) pending and future SLP operations on selected images or image copies. NetBackup retains the image information so that processing can be resumed by the administrator at a later time. Activate (resume) suspended SLP operations on selected images or image copies. See the NetBackup Commands Reference Guide for a description of all the options available for nbstlutil.
When to use	NetBackup starts a duplication session every five minutes to copy data from a backup operation for a duplication operation. Five minutes is the default frequency of the Image processing interval parameter in the SLP Parameters host properties. If the copy fails, the next four duplication sessions retry the copy. If the copy fails all four times, the copy is retried every two hours until it succeeds. Two hours is the default frequency of the Extended image retry interval parameter in the SLP Parameters host properties. Use the nbstlutil command in the case of a hardware problem that may require more than 15 minutes to resolve. That is, the problem may take longer to resolve than four duplication sessions five minutes apart. For example, a duplication job fails because the library has a hard failure. It may take longer than two hours to repair the library. The administrator may not want duplication jobs to begin every two hours. Use the nbstlutil command to inactivate the SLP while the library is repaired. When ready, the SLP can be activated and duplication jobs can begin. Note: Once the job is reactivated, the administrator may want to temporarily change the Extended image retry interval parameter to one hour to begin duplication jobs sooner.

nbstlutil information

Details

Where to find

The command is found in the following location:

On Windows:

install_path\NetBackup\bin\admincmd\nbstlutil

On UNIX:

/usr/openv/netbackup/bin/admincmd/nbstlutil

Note:

In NetBackup 10.3 and later, the nbstlutil binary is only present on NetBackup primary servers. Do not port the nbstlutil binary to non-primary servers.

How to use

Use nbstlutil to perform the following administrative actions:

List the status of SLP-managed images. You can print the status of SLP-processed images. Support may request this information to troubleshoot an SLP problem.
Cancel pending duplication operations on the selected images or image copies. When a duplication is canceled, NetBackup considers the image or image copy to be SLP complete. It does not attempt to create any more copies of the backup image.
Deactivate (suspend) pending and future SLP operations on selected images or image copies. NetBackup retains the image information so that processing can be resumed by the administrator at a later time.
Activate (resume) suspended SLP operations on selected images or image copies.

See the NetBackup Commands Reference Guide for a description of all the options available for nbstlutil.

When to use

NetBackup starts a duplication session every five minutes to copy data from a backup operation for a duplication operation. Five minutes is the default frequency of the Image processing interval parameter in the SLP Parameters host properties.

If the copy fails, the next four duplication sessions retry the copy. If the copy fails all four times, the copy is retried every two hours until it succeeds. Two hours is the default frequency of the Extended image retry interval parameter in the SLP Parameters host properties.

Use the nbstlutil command in the case of a hardware problem that may require more than 15 minutes to resolve. That is, the problem may take longer to resolve than four duplication sessions five minutes apart.

For example, a duplication job fails because the library has a hard failure. It may take longer than two hours to repair the library. The administrator may not want duplication jobs to begin every two hours. Use the nbstlutil command to inactivate the SLP while the library is repaired. When ready, the SLP can be activated and duplication jobs can begin.

Note:

Once the job is reactivated, the administrator may want to temporarily change the Extended image retry interval parameter to one hour to begin duplication jobs sooner.

Lifecycle operation administration using the nbstlutil command

Feedback

Feedback