NetVault 11.4.5 - CLI Reference Guide

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 65. Backup Selection Set
Option	Description
-client <client>	Specifies the name of the NetVault Backup 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 Backup 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”:

nvsetcreate -setname workbackup -type BS -client WinClient
-plugin “File System” -include “Fixed Drives\C:\work” -exclude “C:\work\a.zip”

•

Create a Backup Selection Set for Isilon filer (with no browse capability) to perform level 1 backup of the data in the directory “Isilon/ifs/data/testdata/small”:

nvsetcreate -setname Isilon_Dump1 -type BS -client Interop_r14
-plugin "NDMP Client" -browsesetting NDMPC_TAG_LEVEL=1
-include “Isilon/ifs/data/testdata/small”

Restore Selection Set

Options

Table 66. Restore Selection Set

Option

Description

-client <client>

Specifies the name of NetVault Backup Client from which the data was backed up.

-plugin <plug-in name>

Specifies the name of the plug-in that was used to perform the backup. The plug-in names must appear exactly as they do on the NetVault WebUI.

Example: -plugin “File System”

-saveset <ID>

Specifies the ID of the saveset that you want to restore.

Use this option when you want to restore a particular saveset. Alternatively, use the ‑title option to restore data from the latest saveset for that backup.

-title <title>

Specifies the name of the backup that you want to restore.

If the saveset name contains a tag (backup type identifier), make sure that it is included in the job name (separated by a “-”).

Example: If the job name is “Test Backup” and the tag or backup type identifier is “VSS Full,” then specify:

-title “Test Backup - VSS FULL”

If more than one saveset exists for the job, the latest one is used. To restore data from a particular saveset, use the -saveset option.

-timestamp <HH:MM DD MMM YYYY>

Specifies the timestamp of the saveset that you want to restore. This option can be used with the “-title” option to create a Restore Selection Set without specifying the saveset ID.

The month names are specified in MMM format (for example, “Jan” for “January”). These names are specified in English.

Example: -timestamp “19:25 21 Apr 2016”

-include <path

Specifies the path that you want to restore. It should specify the names of each node under the selected item in the tree as they appear on the NetVault WebUI. The nodes must be separated by “/” or “\” depending on the client operating system.

NOTE: The -include option must be specified before the -rename option when both options are used in a Restore Selection Set.

-exclude <path>

Specifies the paths that you want to omit during restore. 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.

-rename <path> =<new name or path>

Renames or relocates restore items.

You can combine both options or use each independently. If you want to rename an item without relocating it, provide only the new name. To relocate an item, provide he full path.

When relocating data to a different path, verify that the path exists on the target machine before you run the command.

Examples:

•

Rename only:

-rename /usr/joe/diary=diary.old

•

Relocate only:

-rename /usr/joe/diary=/home/joe/diary

•

Rename and Relocate:

-rename /usr/joe/diary=/home/joe/diary.old

-restoreoption <option=value>

Specifies Restore Options for a job.

To use this option, you require the “Tag ID” of the option that you want to set. The Tag ID can either be the backup option name as recognized by the CLI or a numeric value assigned to the option by NetVault Backup. Both of these values are grouped under the [Plugin Options] section in the nvsetmodify.cfg file.

The format for specifying this option is:

-restoreoption <Tag ID=value>

-restoretarget <client>

Specifies the name of the target client.

By default, items are restored to the same client that they were backed up from. When restoring data to an alternate client, ensure that the selected plug-in is installed on the client.

-info <path=value[:value[:…]]>

Specifies plug-in information object attached to a node in the selection tree. The type and order of the values is plug-in dependant. For more information, contact Technical Support.

Examples

•

The following example creates a Restore Selection Set “restorebig” that restores data from saveset ID “320” created with the Plug-in for FileSystem. The data was backed up from client “isp9039.” The set includes the entire volume for restore except directory “/a1”and relocates the file “document” from “/usr/var” to “usr/tmp” directory. Lastly, it enables the restore option “Overwrite Newer Files”:

nvsetcreate -setname restorebig -type RS -client isp9039 -plugin “File System” -saveset 320 -include “/” -exclude /a1
-rename /usr/var/document=/usr/tmp/document
-restoreoption NVFSOPT_OVERNEW=TRUE

•

The following example creates a Restore Selection Set using the -timestamp option:

nvsetcreate -setname fs_time -client Client-A -type RS -plugin "File System"
-title fs_full -timestamp "19:25 21 Apr 2016" -include c:\testdata\small\data

Backup Options Set

Options

Table 67. Backup Options Set
Option	Description
-client <client>	Specifies the name of the NetVault Backup 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”
-backupoption <option=value>	Specifies backup options for a job. To use this option, you require the “Tag ID” of the option that you want to set. The Tag ID can either be the backup option name as recognized by the CLI or a numeric value assigned to the option by NetVault Backup. Both of these values are grouped under the [Plugin Options] section in the nvsetmodify.cfg file. The format for specifying this option is: -backupoption <Tag ID>=<Value> To specify multiple backup options: -backupoption <Tag ID>=<Value> -backupoption <Tag ID>=<Value> ... Example: -backupoption NTFSOPT_SHADOW_COPY=true -backupoption NTFSOPT_TYPEFULL=true -backupoption NTFSOPT_RESTARTABLE=true
-backupoptionspath <path>	Specifies the backup options path. This option is only applicable if a plug-in can specify different backup option page depending on a selection path within that plug-in. It can be used to specify a particular backup options page from a selection path.