Chat now with support
Chat with Support

NetVault 11.3 - CLI Reference Guide

Introduction Getting started Using the command-line utilities Using the nvreport utility

Using the include option

The -include option can be used to filter the data for a report. A filter expression is specified in the following format:

[field name]: Real Name of the field.
[operator]: The operator can be any of the following:
[constant]: The value to which the [field name] value is compared. For example, to include only entries that apply to the job assigned the Job ID of “42”, you would include “42” as the [constant].

To join multiple filter expressions, use “AND” and “OR”. In addition, use parenthesis to indicate the priority of the arguments.

Examples:

Table 91. Constant types

Timepassed

Use to compare fields that contain time interval values. For example, the amount of time it took to run a backup job. The value can be specified in the following formats:

Boolean

Use to compare fields that contain boolean values. Examples of boolean values:

Date

Use to compare fields that contain date values.

Example:

nvreport -class “job history” -include “%STARTDATE >= [Date]”

The value can be specified in the following formats:

For example, “now-1YE” would be one year ago.

Daysinweek

Use to compare fields that contain a day of the week.

The value can be specified in the following format:

Daysinmonth

Use to compare fields that contain a specific date in the month. For multiple values use a comma separator and enclose all values in quotation marks.

hdwmycount

Use to compare fields that contain the count (total number) of Hours, Days, Weeks, Months and Years.

The value can be specified in the following format:

[#H] [#D] [#W] [#M] [#Y]

For example, “12H 2W 10M 18Y” indicates 12 hours, two weeks, 10 months, and 18 years.

Each time variable can be added or omitted as required.

Integer (large value)

Use to compare fields that contain large integer values (for example, 764874497498723497)

Number

Use to compare fields that store a numeric value.

Example:

nvreport -class “job history” -include %INSTANCEID = 2

pluginscreen

N/A

selectiontree

N/A

String

Use to compare fields that contain a string value.

Example:

nvreport -class “job history” -include “%EXITSTATUS !=Failed”

Strings of text with spaces must be enclosed in quotation marks.

Systime

Use to compare fields that contain system time.

The value can be specified in the following format:

For example, “now-30mi” would be 30 hours ago.

Time

Use to compare fields that contain any time value.

Example

nvreport -class "job history" -include "%STARTTIME >= [Time]"

The value can be specified in the following format:

For example, “now-12ho” would be 12 hours ago.

Unique

N/A

weeksinmonth

Use to compare fields that store a specific week in the month.

The value can be specified in the following format:

[Week Number]: Required week numbers

“L” refers to the last week in the month. For example, 134L would include the first, third, fourth, and last week in the month.

Using the title option

When a report is run and viewed from the command line, it is given the default title Report “CLI Report” in the output. The -title option can be used to change the report title. The -title option is specified in the following format:

If a title is to contain any spaces, the entire value must be enclosed in quotation marks. While the “-title” option can be used to label a CLI-output report, it is better suited to label a report that is output to file, and viewed outside of the CLI.

Creating external report files

The report files generated using the nvreport utility can be saved to the output subdirectory in the reports directory (<NetVault Backup home>\reports\output on Windows and <NetVault Backup home>/reports/output on Linux) and used as required. For example, they can be opened for viewing in a browser or sent as email attachments. The procedure for creating an external report file includes the steps outlined in the following sections:

There are two types of report template files.

HTML template files: These templates are used to by the NetVault WebUI. You can use them with the ‑outputdir option to create HTML-based external files. For more information about these templates, see HTML template files.
Plain text template files: These templates are used by the CLI utilities to display output in the terminal window. You can use them with the ‑outputdir option to create plain text external files. The plain-text template files contain the text “clidefault” in their filename or “cli default file” or “textual” in their “Nice Name.” For more information about these templates, see Plain text template files.

Use the following options to create the report file:

-templatename: Specifies the “nice name” of the template file
-templatefile: Specifies the name of the template file. You must specify the full file path with this option. The report templates are located in the <NetVault Backup home>\reports\ templates directory.

The output directory is created in <NetVault Backup home>\reports\output on Windows and <NetVault Backup home>/reports/output on Linux.

The syntax for this option is:

Example:

Note the following:

If an existing subdirectory is specified with the -outputdir option, it is overwritten when a new report is generated. To retain the contents of an existing report file, use the -appendoutput option. It allows you to append the new report data to the existing report file.

Example:

Note the following:

The -appendoutput option must be used with the -outputdir option.

The -title option can be used with the -outputdir option to assign a user-defined to the saved report file. This syntax for using this option is:

If a title is to contain any spaces, the entire value must be enclosed in quotation marks.

Example:

Note the following:

This option can be used with the -outputdir option to add a title to any format of template (HTML or plain text.
When used with the -appendoutput option, the -title option is used as the title of the report that is appended to the existing “output.html” file. The existing report maintains its existing title.

HTML template files

The following table provides the “nice name” and filename of the HTML template files.

activejobs

Currently Active Jobs

Lists all active jobs. The report includes:

alldrives

All Drives

Lists all drives controlled by the NetVault Backup Server. The report includes:

allfailedpolicyjobs

Failed Policy Jobs

Provides a summary of failed policy jobs for the specified period. The report includes:

clientgroups

Client Groups

Lists all client groups. The report includes:

clientstatuses

Client Statuses

Displays the status of added clients. The report includes:

errorlogs

Recent Error Logs

Lists error logs generated during the specified period. The report includes:

events

NetVault Events

Lists events raised during the specified period. The report includes:

expiredofflinemedia

Expired Offline Media

Lists expired offline media. The report includes:

failedrequests

Failed ULA Requests

Provides a summary of failed user requests for the specified period.

fullonlinemedia

Full Online Media

Lists online storage devices that are full. The report includes:

globalnotifications

Global Notifications

Lists events that are included in the global notification profile. The report includes:

historicjobs

Historic Jobs - By Date

Displays date-wise summary of jobs performed during the specified period. The report includes:

historicjobsbysize

Historic Jobs - By Size

Displays size-wise summary of jobs performed during the specified period. The report includes:

jobdefinitions

Defined Jobs

Displays all job definitions. The report includes:

jobhistory

Executed Job History

Provides a summary of jobs performed during the specified period. The report includes:

libraryblankcounts

Blank Media Items In Libraries

Displays the number of blank media items residing in the libraries controlled by the NetVault Backup Server. The report includes:

librarycontents

Libraries' Media Contents

Provides a summary of currently online media items. The report includes:

logs

NetVault Logs

Displays system logs generated during the specified period. The report includes:

mediacontentsquery

Media Contents Query

Provides a summary of data stored on individual media items. The report includes:

mediageneral

Media — General

Provides a summary of used media items. The report includes:

mediasegmentcontents
query

Media Segment Contents Query

Provides a summary of data stored on each segment. The report includes:

mediautilization

Media Utilization

Displays the storage utilization statistics for devices controlled by the NetVault Backup Server. The report includes:

notifications

Users' Selected Notifications

Lists all events that have been included in any user notification profile. The report includes:

offlinedevices

Offline Devices

Lists devices that are currently offline.

outstandingopmsgs

Outstanding Operator Messages

Lists operator messages that have not been acknowledged. The report includes:

If all messages have been acknowledged or deleted, this report returns no information

overnight_jobs_failed

Failed Overnight Backup Jobs

Provides a summary of overnight backup jobs that failed. The report includes:

overnight_jobs_failed_
count

Count Of Failed Overnight Backup Jobs

Displays the total number of the overnight backup jobs that failed (for example, “0 backup jobs failed”).

overnight_jobs_
successful_count

Count Of Successful

Overnight Backup Jobs

Displays the total number of the overnight backup jobs that completed successfully (for example, “12 backup

jobs finished successfully”).

overnight_jobs_total_
data_stored

Count of Data Stored

In Overnight Jobs

Displays the total amount of the data stored in overnight jobs (for example, “Approx. 348GB of data was stored”).

overnight_jobs_

warnings_count

Count Of Overnight

Backup Jobs Finished

With Warnings

Displays the total number of the overnight backup jobs that completed with warnings (for example, “1 backup job finished with warnings”).

policiessummary

Policy Basics

Provides a summary of backup policies. The report includes:

restoresummary

Restore Summary

Provides a summary of all restore jobs. The report includes:

serverlicensecapabilities

Server License Capabilities And Usage

Displays available and used licenses for NetVault Backup. The report includes:

serverlicenseflags

Server License Flags

Lists the functionality offered by current Server License type.

single_job_drives_events

Single Job's Drive Events

Displays the transfer rates for the drives used in a specific job.

single_job_logs

Single Job's Logs

 

Displays the log entries for a particular job. The report includes:

single_job_media

Media Used by Single Backup

 

Displays the media usage details for a particular job. The report includes:

single_job_media_
transfers

Single Job's Media Transfers

Displays the data transfer details for a particular job. The report includes:

single_job_summary

Single Job Main Summary

Provides a summary of a particular job. The report includes:

single_job_xfer_rates

Single Job's Data Transfer

Rate

Displays the data transfer rate for a particular job. The report includes:

singlepolicybytecounts

Policy Totals

Displays the backup size and transfer rate for a backup policy. The report includes:

singlepolicyclients

Policy Clients

Lists all clients included in a policy. The report includes:

singlepolicyfailedjobs

Failed Jobs Within Single Policy

Lists all failed jobs for a backup policy. The report includes:

singlepolicyjobs

Defined Policy Jobs

Provides a summary of jobs added to a policy. The report includes:

singlepolicystatus

Policy Status Information

Displays the status of a particular policy. The report includes:

singleusersaudittrail

Single User's Audit Trail

Displays auditor logs for the specified user account.

userdefinedeventtypes

User-Defined Event Types

Lists all user-defined events. The report includes:

userdetails

User Details

Displays the details of NetVault Backup users. The report includes:

userprivileges

User Privileges

Lists privileges granted to individual users.

usersmediausage

Quotas And Media Usage

Provides a summary of used and assigned media quota for each user account. The report includes:

workstationclientfailed
jobs

Failed Workstation Client Jobs

Lists all failed backups jobs for Workstation Clients.

workstationclienthistoricjobsbyclient

Workstation Client Jobs — By Client

Displays client-wise summary of Workstation client backup jobs.

workstationclienthistoricjobsbydate

Workstation Client Jobs — By Date

Displays date-wise summary of Workstation client backup jobs (latest first).

workstationclientinactiveforaweek

Workstation Clients Inactive For A Week

Lists Workstation Clients that have not had a backup attempted for more than seven (7) days. This report can be used to determine which Workstation Clients have not connected to the network where the NetVault Backup Server resides long enough for a backup to occur. It helps you to identify the workstation data that may be at risk by not being protected for long-term retention or disaster recovery.

workstationclientsuccessfuljobs

Workstation Client Successful Backup Jobs

Lists Workstation Client backups that completed successfully.

 

Related Documents