Chat now with support
Chat with Support

NetVault 11.4.5 - CLI Reference Guide

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

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 39. 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 40. 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:

1
Stop the NetVault Backup Service on the machine where the VTL is located.
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.
6
Restart the NetVault Backup Service.
Syntax
nvmakemedia <file-size> poplib <library>
 
nvmakemedia <file-size> mediafiles <filename>
Options
 
Table 41. 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.

nvmediadetails

Description

Displays details pertaining to media items and media groups.

Syntax
nvmediadetails [-label <Media Label>] [-group <Group Label>] [-all]
[-listlabels] [-listgroups] [-version]
Options
 
Table 42. nvmediadetails
Option
Description

-label

Specifies the media a label for the target media item.

You can specify a few initial characters to search for media items with matching labels.

-group

Specifies the media group label of the target media item.

-all

Displays details for all media items.

-listlabels

Displays details for all media items that are assigned a media label. The “-group” option can be used with this option to displays media details for a particular media group.

-listgroups

Lists available media groups.

-version

Displays the build date of the NetVault Backup distribution installed on the machine.

Examples
•
Display details for a piece of media labeled “MyTape”:
nvmediadetails -label MyTape
•
Display details of all media items belonging to the Media Group “MyGroup”:
nvmediadetails -group MyGroup -all

nvremovemedia

Description

Deletes all information about a piece of media from NetVault Database.

 
* 
NOTE: The target media item must be taken offline before issuing this command.
Syntax
nvremovemedia [-medialabel <Media Label>] [-displaymedialist] [-version]
Options
 
Table 43. nvremovemedia
Option
Description

-label

Specifies the media a label for the target media item.

-displaymedialist

Provides a list of media items that have a media label.

-version

Displays the build date of the NetVault Backup distribution installed on the machine.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating