NetVault 11.4.5 - CLI Reference Guide

Table 76. 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.
-wait	Waits until the task has completed.
-verbose	Displays additional information when the job starts and completes. When the job starts, the details such as the Job ID, Instance ID, Job Title, and Start Time are displayed. When the job completes, the end time is displayed.
-killonexit	Aborts a job by terminating the trigger execution. This option must be used with the ‑wait option.
<trigger name>	Specifies the trigger name. This option must be the last option when the tool is invoked as shown in the following example: nvtrigger -server <server name> -wait -verbose -killonexit <triggername>

Notes

•

The nvtrigger utility returns the following exit codes and messages when the job it is associated with completes execution:

•

0: Backup Completed

•

1: Backup Failed

•

2: Backup Completed with Warnings

•

3: Backup Aborted

•

Without the -wait option, the nvtrigger utility can support multiple jobs. With this option, the utility can only be used to trigger a single job. This limitation also applies to -wait -killonexit options. Therefore, you cannot use this option for policy jobs that contains multiple job definitions.

•

If you specify the -wait option in a script, control is returned to the script only after the triggered job completes. If you do not specify this option, control is returned immediately back to the script even if the triggered job is still running.

Log-specific utilities

•

nvlogdump

•

nvlogpurge

•

nvreadlog

nvlogdump

Description

Dumps NetVault Backup logs to a text or binary file.

Syntax

nvlogdump [-jobid <Job ID>] [-filename <Dump File>] [-text]
[-starttime <Start Time>] [-endtime <End Time>]

Options

Table 77. nvlogdump
Option	Description
-jobid	Specifies the job ID for which logs are exported.
-filename	Specifies the name of the file to which logs are exported. Depending on the dump format selected, the dump files are created in the binary or text directories under <NetVault Backup home>\logs\dumps (on Windows) or <NetVault Backup home>/logs/dumps (on Linux). If you omit the -filename option, NetVault Backup creates a file named CLI_DUMP_<YYYYMMDD>_<HHMMSS> in the specified format. The binary file has the extension “.nlg”; the text file does not have any extension.
-text	Exports logs in text format. If you omit this option, then logs are dumped in binary format.
-starttime	Specifies the time that serves as the starting point for the log dump. The format to specify start time is YYYYMMDDHHMMSS.
-endtime	Specifies the time that serves as the stopping point for the log dump. The format to specify end time is YYYYMMDDHHMMSS.

Notes

At least the jobid option or a combination of the starttime and endtime options must be specified to properly use this utility. A combination of the options jobid, starttime, and endtime can be specified to dump logs for a particular job that were generated within the given period.

Examples

•

Dump logs for Job ID 50, starting from August 1, 2014, 20:33:04, to a binary file named “nvlogdmp.nlg”:

nvlogdump -filename c:\temp\nvlogdmp -starttime 20140801203304 -jobid 50