vmrule

vmrule — manage barcode rules

SYNOPSIS

<volmgr_dir_path>vmrule [-h EMM_server | volume_database_host] -listall [-b] | -add barcode_tag media_type pool_name max_mounts "description" | -change barcode_tag media_type pool_name max_mounts "description" | -delete barcode_tag

On Windows systems, <volmgr_dir_path> is <install_path>\Volmgr\bin\

DESCRIPTION

Use vmrule to add, change, delete, or list barcode rules. The -h option is not required, but you must choose one and only one of the other four options.

Any authorized user can run this command.

For more information about NetBackup authorization, refer to the NetBackup Security and Encryption Guide.

OPTIONS

-h EMM_server | volume_database_host

This option is only applicable for NetBackup Enterprise Server.

The name of the Enterprise Media Manager database host that contains information about the volumes in a robot. If no host is specified, the configured EMM server is used by default. This server is the EMM server for communicating with pre-NetBackup 6.0 systems not in the EMM domain.

-listall [-b]

Lists information about all barcode rules. You can use the -b option to specify a brief format for the barcode rule information that is displayed.

-add barcode_tag media_type pool_name max_mounts "description"

Adds a new barcode rule.

-change barcode_tag media_type pool_name max_mounts "description"

Changes a barcode rule.

-delete barcode_tag

Deletes a barcode rule.

barcode_tag

Specifies the barcode prefix that activates the barcode rule.

media_type

Specifies the media type of the volume, a barcode rule attribute. This option affects whether the rule is used. It also affects the media type for the volumes that are added by using a robot inventory update.

Valid media types for NetBackup Enterprise Server follow:

4mm, 8mm, 8mm2, 8mm3, dlt, dlt2, dlt3, dtf, hcart, hcart2, hcart3, qcart, 4mm_clean, 8mm_clean, 8mm2_clean, 8mm3_clean, dlt_clean, dlt2_clean, dlt3_clean, dtf_clean, hcart_clean, hcart2_clean, hcart3_clean.

Valid media types for NetBackup Server follow:

4mm, 8mm, dlt, hcart, qcart, 4mm_clean, 8mm_clean, dlt_clean, hcart_clean.

pool_name

Specifies the pool to which the volumes are added.

max_mounts

Maximum number of mounts that are allowed for this volume (when the volume is added). This option is used only for non-cleaning media. When this limit is exceeded, the volume can only be mounted for read operations.

Note:

Numbers larger than 99999 are stored in the database, but vmrule displays the max_mounts as 0 if the value is larger than 99999. A value of zero means that the number of mounts is unlimited.

"description"

Description of the barcode rule. The double quote marks are required if the description contains any spaces.

NOTES

Only limited validation of the option parameters is done.

EXAMPLES

The following command creates a rule that defines any tape with a barcode that starts with ABC is a DLT tape in the NetBackup pool. The tape can be mounted up to 100 times for writes and is given a description.

vmrule -add ABC dlt NetBackup 100 "DLT cleaning tape"