vmupdate

vmupdate — inventory media contents of a robotic library and update the EMM database

SYNOPSIS

<volmgr_dir_path>vmupdate -rt robot_type -rn robot_number [-rh robot_host] [-h EMM_Server | volume_database_host] [[-if inventory_filter_value] [-if inventory_filter_value] ...] [-full] [-recommend] [-interactive] [-involgrp volume_group] [-outvolgrp volume_group] [-mt media_type] [-p pool_name] [-use_barcode_rules] [-use_seed] [-mp media_id_prefix] [-empty_map]

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

DESCRIPTION

Inventory the media contents of a robotic library and update the Enterprise Media Manager database. If no options are specified, the volume configuration is updated to match the robot contents.

Any authorized user can run this command.

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

OPTIONS

-rt robot_type

Specifies the robot type of the robot to inventory.

Valid robot types for NetBackup Enterprise Server follow:

none, acs, tl4, tl8, tld, tlh, tlm.

Valid robot types for NetBackup server follow:

none, tl4, tl8, tld.

-rn robot_number

Unique, logical identification number for the robot to inventory.

-rh robot_host

Name of the host that controls the robot. If no host is specified, the host where you execute this command is assumed.

-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. For communicating with pre-NetBackup 6.0 systems not in the EMM domain, this server is the EMM server. If no host is specified, but -rh specifies a pre-NetBackup 6.0 robotic control host, the robotic control host is used as the EMM server.

-if inventory_filter_value

This option is only applicable for NetBackup Enterprise Server.

Specifies the inventory filter values. Multiple -if options may be specified. The inventory filter value is an ACS scratch pool ID, or a TLH volume category.

The -if and -full options cannot be specified together.

-full

Specifies full the inventory. The -full and -if options cannot be specified together.

-recommend

Lists the changes that are required to update the volume configuration.

-interactive

Prompts you before it updates the volume configuration.

-involgrp volume_group

Specifies the volume group for the media that is moved into the robot.

-outvolgrp volume_group

Specifies the volume group for the media that is moved out of the robot.

-mt media_type

Specifies the media type of the volume.

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.

-p pool_name

Specifies the name of the volume pool to which new media are assigned.

-use_barcode_rules

Specifies that barcode rules are used for assigning attributes to new media.

-use_seed

Specifies the automatic generation of media IDs for media with no bar codes.

-mp media_id_prefix

Specifies the prefix that is used as a seed to generate new media IDs for media with no bar codes. This prefix should be between 1 and 5 characters in length and contain only valid media ID characters (alpha-num, "+", "_", ".", and "-" if it is not the first character).

-empty_map

Specifies that volumes in the media access port (map) are moved into the robot before the robot inventory is started. This option is only valid for TL8, TLD, or TLM robot types.

NOTES

Only limited validation of the option parameters is done.

EXAMPLES

The following updates the volume configuration on the EMM server named mymaster to match the contents of TLD robot 7 connected to the host macris:

# vmupdate -rt tld -rn 7 -rh macris -h mymaster

SEE ALSO

vmcheckxxx