NetVault 13.1.2 - CLI Reference Guide

Table 48. nvsyncronizesilomedia
Option	Description
-servername	Specifies the name of the NetVault Server that administers the job. This option is required when a remote server administers the job. It can be omitted when a local server administers the job. The server name is case‑sensitive.
-libraryname	Specifies the name of the target library.

nvupdateserialnumber

Description

Updates the serial number of any drive in the specified library back to its original number.

Syntax

nvupdateserialnumber [-servername <Server Name>] -libraryname <Library Name>
[-bayname <Bay Name>] [-checkonly]

Options

Table 49. nvupdateserialnumber
Option	Description
-servername	Specifies the name of the NetVault Server that administers the job. This option is required when a remote server administers the job. It can be omitted when a local server administers the job. The server name is case‑sensitive.
-libraryname	Specifies the name of the target library.
-bayname	Specifies the name of the drive bay in which the target drive is located.
-checkonly	Checks the media serial number.

Job-specific utilities

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•

•


	NOTE: You cannot use the command-line utilities to create jobs or sets for Virtual Clients.


	IMPORTANT: Several utilities described in this section reference a file named nvsetmodify.cfg. This configuration file includes a list of options used to define a backup job and the associated code number that can be used to identify the option in the CLI. You can find nvsetmodify.cfg in <NetVault home>\config on Windows and <NetVault Home>/config on Linux. When you use the file, verify that you do not modify the contents in any manner. You can take a printout of this file and use the print for reference purposes. This functionality is intended for highly experienced users. Any attempt to use the values provided in this configuration file must be performed under the guidance of Technical Support.

nvexpiresaveset

Description

Performs the following functions:

•

Deletes the specified saveset. Optionally, deletes the duplicates of the specified saveset. The savesets are deleted immediately.

•

Marks multiple savesets for deletion. Optionally, includes the duplicates of the specified savesets. The marked savesets are deleted when the Media Manager performs the next “retirement check.”

•

Changes the expiry of more than one saveset using the expiry date or generation count.

Syntax

nvexpiresaveset [-duplicates] [-duplicateonly] -savesetid <Saveset ID>

nvexpiresaveset [-duplicates] [-duplicateonly] [-success] -markforexpiry -infile <input file>
-outfile <output file>

nvexpiresaveset [-version]

nvexpiresaveset -changeexpiry [-savesetid <saveset id>] [-retiretime <DD/MM/YYYY-HH:MM:SS>][-generationcycle <no. of full backup count>]

nvexpiresaveset -changeexpiry [-infile <input file>] [-outfile <output file>] [-retiretime <DD/MM/YYYY-HH:MM:SS>] [-generationcycle <number of full backups>]

nvexpiresaveset -changeexpiry -allsavesets [-retiretime <DD/MM/YYYY-HH:MM:SS>] [-generationcycle <number of full backups>]

Options

To delete a specific saveset and its duplicates, use the following options.

Table 50. nvexpiresaveset — Options for deleting a specific saveset and its duplicates
Option	Description
-savesetid	The NetVault saveset ID number of the instance to expire immediately or to change the expiry date. The immediate expiry option can cause dependent incremental or differential backups to retire prematurely.
-duplicates	Deletes duplicates of the specified saveset. This option can also be used to delete only the saveset of a phase 1 or phase 2 Data Copy backup, since they have different saveset IDs. Accordingly, the required saveset ID can be provided as the input to nvexpiresaveset.
-duplicateonly	Specifies whether only the phase 2 saveset is to be deleted. Use this option ONLY for deleting a phase 2 Duplicate copy.

To mark multiple savesets and their duplicates for deletion, use the following options.

Table 51. nvexpiresaveset — Options for marking multiple savesets and their duplicates
Option	Description
-markforexpiry	Marks savesets specified in the input file (infile) for deletion. If no dependent Incremental or Differential Backups exist for a saveset, the saveset is removed when the Media Manager performs the next retirement check. By default, these checks are performed at the interval of 60 minutes. To change the interval between two checks, configure the Retirement Check Granularity in Mins setting in the mediamgr.cfg file. For more information about this setting, see Quest NetVault Administrator’s Guide. If any dependent Incremental or Differential Backups exist for a saveset, the saveset is removed only after all dependent backups have reached their retirement date.
-changeexpiry	The option that sets or changes the expiry of savesets using an expiry date or generation count.
-duplicates	Marks duplicates of the specified savesets for deletion. This option can also be used to delete only the saveset of a phase 1 or phase 2 Data Copy backup, since they have different saveset IDs. Accordingly, the required saveset ID can be provided as the input to nvexpiresaveset.
-success	Includes ID numbers of the successful savesets in the output file. Without this option, the utility includes ID numbers of the failed savesets in the output file.
-infile	Specifies the name of the input file. The input file contains the ID numbers of the savesets that you want to mark for deletion. You can use any text editor to create this file. Specify one saveset ID per line. Provide the complete path if the input file is not located in the directory from which you run the utility.
-outfile	Specifies the name of the output file. By default, the file is created in the directory from which you run the utility. Provide the complete path if you want to save the file in a different location.
-retiretime	The expiry date of saveset you want to change Enter the expiry time in the following format: DD/MM/YYYY-HH:MM:SS (GMT/UTC time zone).
-generationcycle	The number of full backups you want to keep.
-allsavesets	When changing the expiry date, this flag includes all savesets.