How to use the new configurable media ID generation vm.conf rules for LTO barcodes

Article:TECH10824  |  Created: 2001-01-01  |  Updated: 2013-10-23  |  Article URL http://www.symantec.com/docs/TECH10824
Article Type
Technical Solution

Product(s)

Environment

Issue



How to use the new configurable media ID generation vm.conf rules for LTO barcodes

Error



Update failed: could not add new media ID '0006L1' into slot 18
Insert media failed:
Media ID not unique to database (34)

Solution



The LTO barcode format consists of eight characters nnnnnnLx, where nnnnnn ranges from 0-999999 and x varies from 1-9. VERITAS NetBackup 3.4 generates media ID based on the last six characters of the media barcode. Using LTO barcodes will limit the media IDs generated since the Lx is common for numerous barcodes. A problem can occur when a robotic library contains multiple media with barcodes that have the same last six characters.

For example, a library has media with barcodes "S00006L1" and "120006L1". The media ID generated for both pieces of media is identical,  and when a robot inventory update is performed, the following error occurs:

Update failed: could not add new media ID '0006L1' into slot 18
Insert media failed:
Media ID not unique to database (34)

With NetBackup 3.4 patch NB_34_1 or (NB_341_1 on NT) or NetBackup 4.5 installed on all NetBackup media servers and master server, how media IDs are generated is now configurable.

Media ID generation rules can be added to the vm.conf file to specify the robot number and barcode length with multiple configuration entries for each robot or for each barcode format. With NetBackup 4.5, media ID generation rules can also be added to the vm.conf file via the "Inventory Robot" function of the NetBackup administration console graphical user interface.

The media ID generation rule has the following syntax:

MEDIA_ID_BARCODE_CHARS <robot_number> <barcode_length> <c1>:<c2>:<c3>:<c4>:<c5>:<c6>

where robot_number is the robot number, barcode_length is the number of characters in the media's barcode format,
c1 is the first character of the Media ID
c2 is the second character of the Media ID
c3 is the third character of the Media ID  
c4 is the fourth character of the Media ID
c5 is the fifth character of the Media ID
      c6 is the sixth character of the Media ID

c1-c6 can specify a character from the media barcode or specify a fixed character by prefixing the character with a "#".

For example, the rule:

MEDIA_ID_BARCODE_CHARS 0 8 #N:1:3:4:5:6

generates media IDs for robot 0 using the character N and the 1st, 3rd, 4th-6th characters of the 8 character barcode, and for the barcode, 123456L1 generates media ID N13456.

The rule:

MEDIA_ID_BARCODE_CHARS 0 8 1:2:3:4:5:6

generates media IDs for robot 0 using the 1st-6th characters of the 8 character barcode,  and for the barcode 006498L2 generates media ID 006498.




Legacy ID



236271


Article URL http://www.symantec.com/docs/TECH10824


Terms of use for this information are found in Legal Notices