TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace:
cookbook:netbackup

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
cookbook:netbackup [2017/06/17 20:24] – [Example Synchronization Definition] Gerard Nicolcookbook:netbackup [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== NetBackup Sync Cookbook ====== ====== NetBackup Sync Cookbook ======
  
-[[https://en.wikipedia.org/wiki/NetBackup|NetBackup]] is Veritas's enterprise backup solution and is available for Windows, UNIX and Linux.+[[https://en.wikipedia.org/wiki/NetBackup|NetBackup]] is a Veritas enterprise backup solution and is available for Windows, UNIX and Linux. 
  
 ===== NetBackup Vault ===== ===== NetBackup Vault =====
 NetBackup Vault is a component of NetBackup that is used to set the Vault Location field in NetBackup. It may or may not be deployed. NetBackup Vault is a component of NetBackup that is used to set the Vault Location field in NetBackup. It may or may not be deployed.
  
-In the event that it is deployed TapeTrack Sync can use the Vault Location field set in NetBackup to determine the expected location of each tape volume. If Vault is not deployed, TapeTrack can determine the expected location based upon other fields such as the tape expiration date.+In the event that it is deployed TapeTrack Sync can use the Vault Location field set in NetBackup to determine the expected location of each [[object:volume|Volume]]. If Vault is not deployed, TapeTrack can determine the expected location based upon other fields such as the [[object:volume|Volume]] expiration date.
  
 <note tip> <note tip>
-The expiration date value in NetBackup appears to be dynamically generated when reports are run based upon the dates of each image stored on a tape volume. For this reason, reports such as vmquery do not accurately return a valid expiry date value.+The expiration date value in NetBackup appears to be dynamically generated when reports are run based upon the dates of each image stored on a [[object:volume|Volume]]. For this reason, reports such as vmquery do not accurately return a valid expiry date value.
 </note> </note>
  
 +===== Data Extraction From Netbackup Vault =====
 +
 +The first step in Synchronizing your Netbackup Vault Library with TapeTrack is to extract the Volume data from your Netbackup Vault instance.
 +
 +Using the administrative tool vmquery, the Volume data can be extracted into a text file.
 +
 +{{vmquery_extract.png}}
 ===== The vmquery command ===== ===== The vmquery command =====
  
-The vmquery man page describes the command as:+<note important>NetBackup's vmquery must be installed and in current path to access the Volume information.\\ 
 +\\ 
 +If vmquery is not installed please refer to your NetBackup administrator.</note> 
 + 
 +The vmquery main page describes the command as:
  
-> Query the Enterprise Media Manager database, or assign and unassign volumes+> Query the Enterprise Media Manager database, or assign and un-assign volumes
  
 To get a report that is suitable for the TapeTrack Sync command, the following minimum arguments should be used: To get a report that is suitable for the TapeTrack Sync command, the following minimum arguments should be used:
  
-<code> +<code plain;> 
-vmquery -W -a > Inventory.txt+vmquery -W -a > Report.txt
 </code> </code>
 Where: Where:
Line 33: Line 45:
 ==== Example vmquery output ==== ==== Example vmquery output ====
  
-<code>+<code plain;>
 MediaID OpticalPartner MediaType Barcode BarcodePartner RobotHost RobotType RobotNum RobotSlot Side/Face VolumeGroup Pool PoolNum PrevPool NumOfMounts MaxMounts NumOfCleanings CreateDatetime AssignedDatetime FirstMountDatetime LastMountDatetime ExpirationDatetime Status OffsiteLocation OffsiteSentDatetime OffsiteReturnDatetime OffsiteSlotID OffsiteSessionID Version DescriptionLength Description ContainerID MediaID OpticalPartner MediaType Barcode BarcodePartner RobotHost RobotType RobotNum RobotSlot Side/Face VolumeGroup Pool PoolNum PrevPool NumOfMounts MaxMounts NumOfCleanings CreateDatetime AssignedDatetime FirstMountDatetime LastMountDatetime ExpirationDatetime Status OffsiteLocation OffsiteSentDatetime OffsiteReturnDatetime OffsiteSlotID OffsiteSessionID Version DescriptionLength Description ContainerID
 ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Line 49: Line 61:
  
 ==== Post-processing ==== ==== Post-processing ====
 +
 +<note important>You will need to install the [[cli:sync_suite|TapeTrack Sync software]] to complete these instructions.</note>
  
 As previously noted, the ''-W'' argument produces space delimited output, but adds a space between date/time values which will be confused with space delimiters. As previously noted, the ''-W'' argument produces space delimited output, but adds a space between date/time values which will be confused with space delimiters.
Line 55: Line 69:
  
    
-<code> +<code plain;> 
-vmquery -W -a > Inventory.txt +vmquery -W -a > Report.txt 
-TMSS10SingleSpace -d "," -g "??/??/???? ??:??" < Inventory.txt > Inventory.csv+TMSS10SingleSpace -d "," -g "??/??/???? ??:??" < Report.txt > Report.csv
 </code> </code>
 +
 +{{vmquery_extract_csv.png}}
  
 === Example TMSS10SingleSpace output=== === Example TMSS10SingleSpace output===
  
-<code>+<code plain;>
 MediaID,OpticalPartner,MediaType,Barcode,BarcodePartner,RobotHost,RobotType,RobotNum,RobotSlot,Side/Face,VolumeGroup,Pool,PoolNum,PrevPool,NumOfMounts,MaxMounts,NumOfCleanings,CreateDatetime,AssignedDatetime,FirstMountDatetime,LastMountDatetime,ExpirationDatetime,Status,OffsiteLocation,OffsiteSentDatetime,OffsiteReturnDatetime,OffsiteSlotID,OffsiteSessionID,Version,DescriptionLength,Description,ContainerID MediaID,OpticalPartner,MediaType,Barcode,BarcodePartner,RobotHost,RobotType,RobotNum,RobotSlot,Side/Face,VolumeGroup,Pool,PoolNum,PrevPool,NumOfMounts,MaxMounts,NumOfCleanings,CreateDatetime,AssignedDatetime,FirstMountDatetime,LastMountDatetime,ExpirationDatetime,Status,OffsiteLocation,OffsiteSentDatetime,OffsiteReturnDatetime,OffsiteSlotID,OffsiteSessionID,Version,DescriptionLength,Description,ContainerID
 ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Line 78: Line 94:
  
 ==== Barcodes ==== ==== Barcodes ====
-It is common for NetBackup barcodes to be missing the LTO L-Suffix, and also common for the Media Type field to have a HCART value that does not truly reflect the correct LTO generation.+It is common for NetBackup Barcodes to be missing the LTO L-Suffix, and also common for the Media Type field to have a HCART value that does not truly reflect the correct LTO generation.
  
 If is always recommended that where possible volumes be loaded into TapeTrack with their L-Suffix, and this suffix can be established by: If is always recommended that where possible volumes be loaded into TapeTrack with their L-Suffix, and this suffix can be established by:
-  - The Media ID value if it includes the suffix. +  - The Media-ID value if it includes the suffix. 
-  - Adding an appropriate suffix to the Media ID based upon the value of the Media Type field. +  - Adding an appropriate suffix to the Media-ID based upon the value of the Media Type field. 
-  - Adding an appropriate suffix based upon the range of the Media ID.+  - Adding an appropriate suffix based upon the range of the Media-ID.
   - Using TapeTrack's Constructive Barcode feature.   - Using TapeTrack's Constructive Barcode feature.
  
Line 93: Line 109:
   - Command line arguments that instruct the program how to process volumes.    - Command line arguments that instruct the program how to process volumes. 
   - A synchronization definition file that instructs the program how to interpret the vmquery output.   - A synchronization definition file that instructs the program how to interpret the vmquery output.
 +
 +{{networker_sync.png}}
  
 ==== Example Command Line Arguments ==== ==== Example Command Line Arguments ====
  
-<code> +<code plain;> 
-TMSS10Sync -d NBU.ttidef -a -S batch:-password@server < Inventory.csv+TMSS10Sync -d Volume.ttidef -a -S batch:-password@server < Inventory.csv
 </code> </code>
  
Line 103: Line 121:
   * ''-d'' is the path to the Synchronization Definition File.   * ''-d'' is the path to the Synchronization Definition File.
   * ''-a'' tells the program to add new tape volumes if they are encountered.   * ''-a'' tells the program to add new tape volumes if they are encountered.
-  * ''-S'' tells the program what server to connect to.+  * ''-S'' tells the program what [[cli:server_argument|Server]] to connect to.
   * ''Inventory.csv'' is the ''vmquery'' output that has been pre-processed through the [[cli:tmss10singlespace|TMSS10SingleSpace]] program   * ''Inventory.csv'' is the ''vmquery'' output that has been pre-processed through the [[cli:tmss10singlespace|TMSS10SingleSpace]] program
  
 ==== Example Synchronization Definition ==== ==== Example Synchronization Definition ====
  
-<code>+<code plain;>
 # #
 # Set the Customer and Media as literal values as they never change # Set the Customer and Media as literal values as they never change
Line 152: Line 170:
 AddTranslation(REPOSITORY, "*", "LIBR"); AddTranslation(REPOSITORY, "*", "LIBR");
 </code> </code>
 +
 +<- :cookbook:dataprotector|Data Protector Sync Cookbook ^ :cookbook:introduction|Cookbook ^ :cookbook:networker|NetWorker Sync Cookbook->
 +
 +{{tag> cookbook}}
cookbook/netbackup.1497731081.txt.gz · Last modified: 2025/01/21 22:07 (external edit)