NetVault 11.4.5 - CLI Reference Guide

Table 56. nvjobresume
Option	Description
-servername	Specifies the name of the NetVault Backup 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.
-jobid	Specifies the ID of the job that you want to resume. Only one Job ID can be specified with this option.
-phaseid	Specifies the phase ID. Use this option if you want to resume a particular job phase. If you omit this option, all known phases of the specified job are resumed.
-version	Displays the build date of the NetVault Backup distribution installed on the machine.

nvjobstart

Description

Runs a job using its Job ID, phase number, and instance number.

Syntax

nvjobstart [-servername <NetVault Backup Server Name>] -jobid <Job ID>
-phase <Phase ID> -instance <Instance ID> [-wait] [-version]

Options

Table 57. nvjobstart
Option	Description
-servername	Specifies the name of the NetVault Backup 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.
-jobid	Specifies the ID of the job that you want to run.
-phaseid	Specifies the Phase ID. The default value for this option is 1.
-instance	Specifies the Instance ID. If this option is not specified or the specified instance does not exist, the last instance of the job is started.
-wait	Waits until the task has completed.
-version	Displays the build date of the NetVault Backup distribution installed on the machine.

Notes

•

By default, the nvjobstart utility returns the following messages depending on the job exit codes.

Table 58. Default job exit codes and status messages

Exit code

Status message

Job completed successfully

Job failed with error: ‘Job Failed’

This message is returned for the following job completion states:

•

Job failed

•

Job completed with warnings

•

Job aborted

•

Job stopped

•

Job died

If you enable the option nvjobstart Enhanced Job Completion Status, the utility returns the following codes and messages:

Table 59. Enhanced job exit codes and status messages
Exit code	Status message
0	Job completed successfully
1	Job Failed
2	Job Completed with Warnings
3	Job Aborted
4	Job Stopped
5	Job Died
-1	Job Failed with Undefined Error

For more information about this option, see the Quest NetVault Backup Administrator’s Guide.

nvpolicy

Description

Performs the following tasks:

•

Creates a policy definition

•

Displays policy jobs

•

Deletes a policy

•

Checks whether a policy job exists or not

•

Defines clients for a policy job

•

Places a policy in quiesced state

Syntax

nvpolicy -list [<Policy Name>] -delete <Policy Name> -ack <Policy Name>
-addclient <Policy Name> <client name> [ <Client Name> ... ] -addgroup <Policy Name> <Group Name> [ <Group Name> ...] create <Policy Definition File>
-state <Policy Name> -quiesce <Policy Name>

Options

Table 60. 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 [-client <NetVault Backup 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 <Path>]
[-rename <Path>] [-run [-wait]]

nvrestore -create <Saveset> -definition <Restore Definition File> [-run [-wait]]

Options

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

Table 61. nvrestore - Options for listing restore jobs
Option	Description
-list	Displays all restore jobs administered by the NetVault Backup Server.
-client	Specifies the name of the target NetVault Backup 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.

To create a restore job, use the following options.

Table 62. 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 target client name and the plug-in used, each separated with a colon. Example: 59:NVSERVER: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.

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

Table 63. 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 target client name and the plug‑in used, each separated with a colon. Example: 59:NVSERVER: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.

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.

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem

NetVault 11.4.5 - CLI Reference Guide

nvjobresume

nvjobstart

nvpolicy

nvrestore