NetVault Backup 12.3 - CLI Reference Guide

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

nvlistblankmedia

Displays slots containing blank media items on the specified library.

-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.

-libraryname

Specifies the name of the target library.

nvlistmedia

Lists media items marked with the following tags:

Table 40. nvlistmedia

-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.

-libraryname

Specifies the name of the target library.

-readonly

Lists read-only media items.

-reusable

Lists media items marked for reuse.

-unusable

Lists media items with the “unusable” tag.

-bad

Lists media items with the “bad” tag.

-needsimport

Lists media items that need to be imported.

-needsrecovery

Lists media items that need recovery.

-group

Lists media items that belong to any media group

nvloadmedia

Use this command to load specific media items to a drive to read the media header or continue using the media from the CLI or from within a script. You can use nvdeviceeject command to return the media item to a home slot.

Table 41. nvloadmedia

-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.

-barcode

Specifies the barcode of the target media item.

-medialabel

Specifies the label of the target media item.

Use this option only when searching by media label. If a media label contains spaces, enclose it within quotation marks (“”).

Example: “Full DB Backups”

-slotspec

Specifies the name of the library and slot number where the target media item resides. These two values must be separated using a double colon delimiter (“::”). Use this option only when searching by library slot.

-wait

Waits until the task has completed.

nvmakemedia

Increases the capacity of a Virtual Tape Library (VTL) by creating additional media files.

A VTL contains the following directories and files:

...\<vt>

.../<vtl>

VTL root directory.

...\<vtl>\drives

.../<vtl>/drives

Directory under the VTL root directory where the virtual drives are stored. NetVault Backup creates a subdirectory for each virtual drive in this directory.

...\<vtl>\media

.../<vtl>/media

Directory under the VTL root directory where the virtual media items are stored.

...\<vtl>\slots

.../<vtl>/slots

Directory under the VTL root directory where the virtual slots are stored. NetVault Backup creates a subdirectory for each virtual slot in this directory.

...\<vtl>\.serial

.../<vtl>/.serial

 

 

File residing in the VTL root directory. It contains a list of media barcodes and drive numbers.

For example, “4O4HR-2”, where “4O4HR” is the barcode and “2” is virtual drive number; 404HR-2”, where “404HR” is the barcode and “2” is virtual drive 2.

...\<vtl>\drives\<x>\.serial

.../<vtl>/drives/<x>/.serial

File residing in each drive subdirectory. It contains the individual media barcode and drive number.

...\<vtl>\slots\<x>\.serial

.../<vtl>/slots/<x>/.serial

File residing in each slot subdirectory. It contains barcode for the individual media item.

For example, “..\..\4O4HR001”, where “404HR” is the barcode and “001” is the virtual media item.

...\<vtl>\media\<mediafile>

.../<vtl>/media/<mediafile>

Actual virtual media. For example, ...\vtl1\media\4O4HR001.

To add a media item, use the following steps:

2
In the slots directory, create a subdirectory which is one number larger than the existing largest numbered virtual slot directory.
3
Copy the “.media” file from one of the virtual slot directories to the virtual slot directory created in the previous step.
4
Modify the “.media” file in the newly created virtual slot directory from “1Y2NY00*” to “1Y2NY00X”, where X represents the new virtual media number.
5
Use the nvmakemedia command to create the media file.
Table 43. nvmakemedia

<file-size> poplib <library>

This form of the command verifies all media reference files within the specified <library>, and offers to create the file if the corresponding media data file does not exist. Enter “Y” or “y” to confirm media file creation.

<file-size>: File size can be an integer value followed by “k” for kilobytes, “m” for megabytes, “g” for gigabytes, or “t” for terabytes. For example, 102400k, 50m, 4g, 2t. The minimum file size allowed is 50m.
<library>: Full path to the target VTL name.

Example:

nvmakemedia 50M poplib c:\tst-vtl

<file-size> mediafiles <filename>

This form of the command creates a media file of the specified size.

<file-size>: File size can be an integer value followed by “k” for KB, “m” for MB, “g” for GB, or “t” for TB (for example, 102400k, 50m, 4g, 2t). The minimum file size allowed is 50m.
<filename>: Full path to the new media file. The filename is used as the barcode for the media item.

Example:

nvmakemedia 50M mediafiles c:\tst-vtl\1Y2NY006

Documents connexes