NetVault 12.4 - CLI Reference Guide

Table 39. nvlistblankmedia
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.
-libraryname	Specifies the name of the target library.

nvlistmedia

Description

Lists media items marked with the following tags:

•

•

•

•

•

•

•

Table 40. nvlistmedia
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.
-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

Description

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.

Syntax

nvloadmedia [-servername <Server Name>] -barcode <Barcode> |
-medialabel <Media Label> | -slotspec <Library Name::Slot Number> [-wait]

Options

Table 41. nvloadmedia
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.
-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

Description

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

A VTL contains the following directories and files:

Table 42. VTL directories and files
Windows	Linux and UNIX	Description
...\<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:

Stop the NetVault Backup Service on the machine where the VTL is located.

In the slots directory, create a subdirectory which is one number larger than the existing largest numbered virtual slot directory.

Copy the “.media” file from one of the virtual slot directories to the virtual slot directory created in the previous step.

Modify the “.media” file in the newly created virtual slot directory from “1Y2NY00*” to “1Y2NY00X”, where X represents the new virtual media number.

Use the nvmakemedia command to create the media file.

Restart the NetVault Backup Service.

Syntax

nvmakemedia <file-size> poplib <library>

nvmakemedia <file-size> mediafiles <filename>

Options

Table 43. nvmakemedia

Option

Description

<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

Notes

•

To use this utility on Windows-based systems, you must be logged in with Administrator privileges.

This utility can only be used on systems that are not added to any domain or on systems that are added to the primary domain or a domain where there is a trust relationship with the primary domain.