NetVault 13.1.2 - CLI Reference Guide

Table 62. nvpolicy
Option	Description
-list	Displays existing policies. To view the list of jobs defined for a policy, use this option with the policy name. For example, the following command lists all jobs defined for policy “p1”: nvpolicy -list p1
-delete	Deletes the specified policy.
-ack	Acknowledges errors.
-addclient	Adds clients to the policy definition. For example, the following command adds clients “Client-A” and “Client-B” to the policy “p1”: nvpolicy -addclient p1 Client-A Client-B
-addgroup	Adds client groups to the policy definition. For example, the following command adds client groups “Group-A” and “Group-B” to the policy “p1”: nvpolicy -addgroup p1 Group-A Group-B
-create	Creates a policy using details specified in the policy definition file. The file must be created in the following format: Example: [Policy] Title=policy3 EvtWarn=Event-Warn-1 EvtFail=Event-Fail-1 Clients=client-1,client-2,client-3,client-4
	[Job] Title=MyJob Selection=MySelection Options=MyOption Target=MyTarget Source=MySource Schedule=MySchedule Advanced=MyAdvanced Active=TRUE NOTE: The Source option is only required when defining a job for the Plug-in for Consolidation and or Plug-in for Data Copy. A policy can contain one or more job definitions. For multiple jobs, include a [Job] section for each job as shown in the following example. Example: [Policy] Title=policy3 EvtWarn=Event-Warn-1 EvtFail=Event-Fail-1 Clients=client1,client2,client3,client4 [Job] Title=MyJob Selection=MySelection Options=MyOption Target=MyTarget Source=MySource Schedule=MySchedule Advanced=MyAdvanced Active=TRUE [Job] Title=MyJob-2 Selection=MySelection-2 Options=MyOption-2 Target=MyTarget-2 Schedule=MySchedule-2 Advanced=MyAdvanced-2 Active=TRUE
-state	Displays the current state of a policy — Dormant, Active, or Quiescing.
quiesce	Places an active policy in a quiesced state.

nvrestore

Description

Performs the following tasks:

•

Displays restore jobs. You can filter the list by date, client, plug-in, or Backup Selection Set used for the job.

•

Creates restore jobs. You can also use this utility to relocate or rename data during restore.

Syntax

nvrestore -list [-targetserver <NetVault Server Name>] [-client <NetVault Client Name>] [-plugin <Plug-in Name>] [-select <Selection Set Name>] [-startdate <DD/MM/YY>] [-enddate <DD/MM/YY>]

nvrestore -create <Saveset> -title <Job Title> -path <Path> [-relocate <New Path>] [-rename <New Name>] [-targetserver <NetVault Server Name>] [-targetclient <NetVault Client Name>] [-run [-wait]]

nvrestore -create <Saveset> -definition <Restore Definition File> [-targetserver <NetVault Server Name>] [-targetclient <NetVault Client Name>] [-run [-wait]]

Options

To list the restore jobs administered by the NetVault Server, use the following options.

Table 63. nvrestore - Options for listing restore jobs
Option	Description
-list	Displays all restore jobs administered by the NetVault Server.
-client	Specifies the name of the target NetVault Client. Use this option filter the list by the specified client.
-plugin	Specifies the plug-in name. Use this option to filter the list by the specified plug-in.
-select	Specifies the name of the Restore Selections Set. Use this option to filter the list by the specified set. NOTE: The -plugin and -select options are mutually exclusive and cannot be used together in the same instance of a nvrestore -list command.
-startdate	Specifies the start date. Use this option to display the jobs performed between the start date and end date. If the end date is not specified, all jobs starting from the start date up to the last job are listed. The valid format for the start date is DD/MM/YY.
-enddate	Specifies the end date. Use this option to display the jobs performed between the start date and end date. If the start date is not specified, all jobs starting from the first job up to the specified end data are listed. The valid format for the start date is DD/MM/YY.
-targetserver	Specifies the name of the NetVault Server to access and perform the nvrestore task. Use this option to select a NetVault Server that will perform nvrestore accessing the Savesets hosted in the NetVault Server. If -targetserver is not specified, nvrestore attempts to access and run in the local machine. Use the option -targetserver to run nvrestore in a remote NetVault Server.

To create a restore job, use the following options.

Table 64. nvrestore - Options for creating a restore job
Option	Description
-create	Creates and optionally schedules a restore job. Specify the ID of the backup saveset that you want to restore. In addition to the saveset number, you can preface the saveset number with the name of the client from which the backup was taken and the name of the plug-in used to take the backup, each separated with a colon. Example: 59:NVCLIENT:filesystem This format helps in reducing the time taken to locate the saveset.
-title	Specifies the name of the job.
-path	Specifies the directory or file that you want to restore. Provide the full path to the items.
-relocate	Relocates the selected items to the specified path or directory. Ensure that the specified path is created before you run the restore job.
-rename	Renames the selected items. You can use this option if you do not want to overwrite existing files or directories.
-run	Runs the job. Without this option, the restore job is created and saved, but it is not scheduled to run.
-wait	Waits until the task has completed. With this option, the utility return a result of “job succeeded” or “job failed” before releasing the prompt for additional commands.
-targetserver	Specifies the name of the NetVault Server to access and perform the nvrestore task. Use this option to select a NetVault Server that will perform nvrestore accessing the Savesets hosted in the NetVault Server. If -targetserver is not specified, nvrestore attempts to access and run in the local machine. Use the option -targetserver to run nvrestore in a remote NetVault Server.
-targetclient	Specifies the name of the target NetVault Client destination of the restore. Use this option to select a NetVault Client where the data will be restored. The option -targetclient applies only to nvrestore -create option. If -targetclient is not specified, nvrestore attempts to restore the data in the local machine. Use the option -targetclient to instruct nvrestore to restore the data to a remote NetVault Client.

To create a restore job from a job definition file, use the following options.

Table 65. nvrestore - Options for creating a job from a job definition file
Option	Description
-create	Creates and optionally schedules a restore job. Specify the ID of the backup saveset that you want to restore. In addition to the saveset number, you can preface the saveset number with the name of the client from which the backup was taken and the name of the plug-in used to take the backup, each separated with a colon. Example: 59:NVCLIENT:filesystem This format helps in reducing the time taken to locate the saveset.
-definition	Specifies the name of the job definition file. Provide the full file path. The definition file includes a list of files or directories that you want to include or exclude. It must use the following format: [Restore] Title=<Job Title> Schedule=<Schedule Set name> Advanced=<Advanced Options Set name> [Include] Path=<Full path to restore items> Relocate=<Relocation path> (Ensure that the path is created before you run the job.) Rename=<New name for the item> (You can use this option if you do not want to overwrite existing files or directories.)
-run	Runs the job. Without this option, the restore job is created and saved, but not scheduled to run.
-wait	Waits until the task has completed. With this option, the utility return a result of “job succeeded” or “job failed” before releasing the prompt for additional commands.
-targetserver	Specifies the name of the NetVault Server to access and perform the nvrestore task. Use this option to select a NetVault Server that will perform nvrestore accessing the Savesets hosted in the NetVault Server. If -targetserver is not specified, nvrestore attempts to access and run in the local machine. Use the option -targetserver to run nvrestore in a remote NetVault Server.
-targetclient	Specifies the name of the target NetVault Client destination of the restore. Use this option to select a NetVault Client where the data will be restored. The option -targetclient applies only to nvrestore -create option. If -targetclient is not specified, nvrestore attempts to restore the data in the local machine. Use the option -targetclient to instruct nvrestore to restore the data to a remote NetVault Client.

Notes

The following rules apply to Restore Definition File:

•

The “Schedule” and “Advanced” entries must be included in the [Restore] stanza even if specific Schedule and Restore Advanced Options Sets are not required. You can use the NetVault WebUI or the nvsetcreate utility to create these sets.

•

Only one item can be specified per line in the [Include] stanza.

•

For the Rename and Relocate options, a separate [Include] stanza must be created for each item. Correct

path=C:\Program Files

relocate=C:\Old Program Files

Incorrect

[Include]

path=C:\data\files

path=C:\Program Files

relocate=C:\data\new

relocate=C:\Old Program Files

•

Both the Rename and Relocate options can be specified within the same instance of the [Include] stanza to perform both operations for a single file or directory.

[Include]

path=C:\data\new (data that you want to restore and its original path)

relocate=C:\saved\data (the relocation path)

rename=C:\saved\data\old (the relocation path along with the new directory name)

•

The relocation directory must exist on the target system before you run the restore job. You can create and save the job without using the “-run” parameter and establish a new directory for relocation in the command, but when you runt the job, the target relocation directory must exist.

nvsetcreate

Description

Creates a set.

Syntax

nvsetcreate [-setname <Set Name>] -type <set type> <Set Type Specific Options>
-assign <Assignment Character> -delimit <Delimiter Character>
-parameters <Parameter Filename>] [-version]


	NOTE: When used to select nodes for backup and restore, the nvsetcreate command does not interpret a single quote and instead changes it to a blank space. To avoid this issue, write the string arguments that use single quote in a parameter file and indicate the file in the nvsetcreate -parameters switch.

Options

Table 66. nvsetcreate

Option

Description

-setname

Specifies the name of the set that you want to create.

-type

Specifies the set type and set-specific options.

The set type can be one of the following:

•

BS: Backup Selection Set

•

BO: Backup Options Set

•

S: Schedule Set

•

BT: Backup Target Set

•

AB: Backup Advanced Options Set

•

RS: Restore Selection Set

•

AR: Restore Advanced Options Set

To obtain a list of available options for any set type, use the following command:

nvsetcreate -type <set type> -- help

Example:

nvsetcreate -type BS -- help

For information about set-specific options, see the following sections:

•

Backup Selection Set

•

Restore Selection Set

•

Backup Options Set

•

Schedule Set

•

Backup Target Set

•

Backup Advanced Options Set

•

Restore Advanced Options Set

-assign

Specifies the assignment operator that you want to use in change descriptions. The default assignment operator is the “=” character. This option must be specified if the old or new values contain the “=” character.

-delimit

Specifies the character that you want to use as a delimiter in change descriptions. The default delimiter is the “:” character. This option must be specified if old or new values contain the “:” character.

-parameters

Reads options from a parameter file.

You can use any text editor to create the parameter file. Specify one option with its value per line and omit “-” before the option. Use spaces or tabs to separate the option and values. To include comments, begin the line with a “#” character.

Example:

# nvsetcreate example file

setname workbackup

type BS

client WinClient

This file can be used with the -parameters option as follows:

./nvsetcreate -parameters example.txt

Notes

•

The Plug-in for NDMP allows you to create only Backup Selection Sets using the nvsetcreate utility.

•

When creating a set for the Plug-in for NDMP, if you specify an existing set name, the nvsetcreate utility overwrites the set. You can use the nvsetcreate utility to modify a set for this plug-in instead of nvsetmodify.

Backup Selection Set

Options

Table 67. Backup Selection Set
Option	Description
-client <client>	Specifies the name of the NetVault Client that you want to back up.
-plugin <plug-in name>	Specifies the name of the plug-in that you to use for the backup. The plug-in names must appear exactly as they do on the NetVault WebUI. Example: -plugin “File System”
-include <path	Specifies the backup path. Include the names of each node under the selected item in the tree as they appear on the NetVault WebUI. Separate the nodes using “/” or “\” depending on the client operating system.
-exclude <path>	Specifies the paths that you want to omit during backup. It must be specified in the same way as the included paths. This option can only be used to exclude items that appear under items that have already been named for inclusion.
-info <path=value[:value[:…]]>	Specifies plug-in information object attached to a node in the selection tree. This information is unavailable to the plug-in at backup time. It can only be specified for nodes where the default values are always added by the plug-in. The type and order of the values is plug-in dependant. For more information, contact Technical Support.
-browsesetting <entry>	Specifies the Tag name and setting for the selected option. Use this option to create Selection Set for filers with limited or no browse capability. To list the tags, type: nvsetcreate -type BS -helpndmptags The available tags are: LEVEL – NDMPC_TAG_LEVEL HIST – NDMPC_TAG_GET_FILE_INFO UPDATE – NDMPC_TAG_UPDATE DIRECT –NDMPC_TAG_DIRECT_IF_POSSIBLE

Notes

•

When creating a Selection Set for backing up the root directory using NetVault Plug-in for FileSystem, do not include the last “\” character. Specify only the drive letter. Thus, use the path C: instead of C:\.

Example:

nvsetcreate -setname testset -type BS -client WINCLIENT1 -plugin “File System” -include “Fixed Drives\C:”

•

When using the -include option in Backup Selection Sets for Plug-in for Consolidation, Plug-in for Data Copy, or Plug-in for Raw Devices, specify the full file path as displayed on the NetVault WebUI.

•

Use “/” to separate the tree items. Regardless of the OS in use, the forward slash (“/”) can be used as a separator.

•

Delimit the path with double quotation marks

•

Include the complete Saveset Title:

/JobTitle(Savesetnum) hh:mm DD MM YYYY

Example:

nvsetcreate -setname DataCopy1 -type BS -client ukwk1115 -plugin “Data Copy”
-include “Backups/ukwk1115/File System/spanningTapes (Saveset 106) 11:00 31 jul 2011”

Examples

•

Create a Backup Selection Set for a Windows-based client “WinClient” to back up all files in the “C:\work” directory using the Plug-in for FileSystem, while excluding the file “a.zip”: