Veritas NetBackup™ Commands Reference Guide
- Appendix A. NetBackup Commands
vmrule — manage barcode rules
[-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 UNIX systems, the directory path to this command is /usr/openv/volmgr/bin/
On Windows systems, the directory path to this command is <install_path>\Volmgr\bin\
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.
- -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.
- -listall [-b]
Lists the information about all barcode rules. You can use the -b option to specify a brief format for the barcode rule information that is displayed.
The following describes the fields that are included in the output of a vmrule -list_all [-b] command:
Field 1 = Barcode tag of the media
Field 2 = Media type
Field 3 = Volume pool for the media
Field 4 = max mounts / cleanings. The maximum mounts or cleanings for the media.
Field 5 = Rule description
- -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.
Specifies the barcode prefix that activates the barcode rule.
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.
Specifies the pool to which the volumes are added.
Specifies the 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.
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 of the barcode rule. The double quote marks are required if the description contains any spaces.
Only limited validation of the option parameters is done.
Example 1 - Create 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"
Example 2 - List all barcode rule information.
# vmrule -list_all [-b] ABC,DLT,NetBackup,100,DataStore DLT Rule EFG,DLT,DataStore,0,DataStore DLT Rule
The barcode tags are ABC and EFG. The media type is DLT. The volume pools are NetBackup and DataStore. The max mounts or cleanings are 100 and 0. The rule description is DataStore DLT rule.