NetVault 13.0.1 - Administration Guide

The deviceconfig utility is a console application that can be used to configure advanced device settings for all types of tape libraries and drives. This utility is automatically installed on the NetVault Server and Client machines.

The deviceconfig utility is located in the “bin” directory under the NetVault installation directory.

To use this utility, you must be logged-in with Administrator privileges on Windows machine and root user privileges on Linux and UNIX.

Configuring default settings for tape libraries

To configure default settings for a tape library:

Start a terminal session or command window, and navigate to the “bin” directory under the NetVault installation directory.

Type the following command:

deviceconfig [-servername <FQDN> (-httpport <HTTP port> |
-httpsport <HTTPS port>)] -username <NetVault user>
-password <user password>
‑librarymachine <library machine name> -libraryname <library name>

These options are described in the following table.

Table 150. Options for modifying tape library settings using deviceconfig
Option	Description
-servername	Specifies the FQDN, or IP Address of the NetVault Server. With this option, you must specify either the HTTP or HTTPS port to connect to the remote Web Service. If you omit this option, the local server is used. The deviceconfig utility connects to the local Web Service and automatically detects the local Web Service configuration.
-httpport	Specifies the HTTP port for Web Service. This option is only required if the server name is supplied.
-httpsport	Specifies the HTTPS port for Web Service. This option is only required if the server name is supplied.
-username	Specifies a valid NetVault user name.
-password	Specifies the password for the user account.
-librarymachine	Specifies the name of the NetVault machine to which the library is attached.
-libraryname	Specifies the name of the library.

Press Enter.

The deviceconfig utility displays the Changer Configuration screen. You can access the configuration settings by pressing the corresponding option number. The available setting types include the following:

•

Configuration: To configure general settings for a tape library, select this option. For more information about these settings, see General settings for tape libraries.

•

Cleaning: To configure drive cleaning settings for a tape library, select this option. For more information about these settings, see Drive cleaning settings.

•

Mixed Media: To configure mixed media settings, select this option. For more information about these settings, see Mixed media settings.

To save the changes and quit, press s.

(To quit without saving the changes, press q.)

Examples

•

deviceconfig -username default -librarymachine Server-A ‑libraryname MyCustomName

•

deviceconfig -username admin -password mypassword -librarymachine Server-A ‑libraryname “Server-A: 2-0.4.0 (SONY LIB-304)”

•

deviceconfig -servername 10.11.25.125 -httpsport 8443 -username admin ‑password mypassword -librarymachine Client-A -libraryname MyCustomName-2

General settings for tape libraries

On the Configuration screen, the following settings are available.

Table 151. General settings for tape libraries
Setting	Description
Need command to open entry/exit port	The default setting is OFF. To change it, press the option number.
Do not issue unload commands to drives	The default setting is OFF. To change it, press the option number.
Must unload drive(s) to open door	The default setting is OFF. To change it, press the option number.
Do not overlap commands to arm and drive	The default setting is OFF. To change it, press the option number.
Return inactive media to slot delay	Type the timeout period for media inactivity. The timeout period is specified in number of seconds. NetVault returns the media to the slot if no activity occurs within the specified period. The default value for this option is 30 seconds. To retain the media indefinitely in the drive, set this option to zero (0). The default value of device config in ACSLS libraries is 120 seconds.
Mark Unknown Media Blank	The default setting is OFF. To change it, press the option number. When it is set ON, NetVault marks unknown tapes as BLANK without reading the tape headers. You still need to run the Blank command to actually delete the data and use the media for backups.
Do Not Scan Unknown Media	When you add tapes to a library, and close the door (or restart the library), NetVault takes an inventory by reading the media barcodes. If NetVault cannot find the barcode for a piece of media in the Media Database, it marks that tape as UNKNOWN. You can use the Mark Unknown Media Blank option to mark such tapes as BLANK. If you do not mark the unknown tapes as BLANK, NetVault starts loading each unknown tape into one of the drives to scan for backups and on-tape indices. On large systems, this process can increase the burden on the drive resources. If you do not want to scan the unknown tapes automatically, change the setting to ON. When it is set ON, the unknown tapes are marked as UNKNOWN.
Check if Offline Media is Available	Enter or select the amount of time. NetVault waits for an offline media to become online. The request times out if the media does not become available within the specified period. The timeout for the availability of offline media is specified in minutes. The default value for this parameter is 10 minutes.
Entry / Exit Port Locks Arm	The default setting is OFF. To change it, press the option number.

Documents connexes

The document was helpful.

Sélectionner une évaluation

I easily found the information I needed.

Sélectionner une évaluation

Veuillez sélectionner votre produit

Afin de mieux répondre à vos besoins, précisez l'objet du tchat:

Solutions recommandées pour votre problème

NetVault 13.0.1 - Administration Guide

Using the deviceconfig utility

About deviceconfig

Configuring default settings for tape libraries

General settings for tape libraries