TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace:
lite:volumeauto

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
lite:volumeauto [2019/01/01 22:43] – [VolumeAuto: Setting Move Dates] Scott Cunliffelite:volumeauto [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 3: Line 3:
 **VolumeAuto** uses Volume filters and date values from ''VolumeAuto.txt'' that can be employed to override default return dates and descriptions for matched [[object:volume|Volumes]]. **VolumeAuto** uses Volume filters and date values from ''VolumeAuto.txt'' that can be employed to override default return dates and descriptions for matched [[object:volume|Volumes]].
  
-The VolumeAuto process can be useful for setting next move dates of selected [[object:volume|Volumes]] where the retention dates don't follow a regular schedule that could be handled by Simple Management rules. +The VolumeAuto process can be useful for setting next move dates of selected [[object:volume|Volumes]] where the retention dates don't follow a regular schedule that could be handled by Simple Management rules. 
 + 
 +The VolumeAuto process also has the advantage of being able to automatically set next move dates using Lite as opposed to having Simple Management rules that require access to TapeMaster. 
  
 ''VolumeAuto.txt'' can be found in the Lite install directory, default location C:\Program Files\TapeTrack\TapeTrack Lite\VolumeAuto.txt. ''VolumeAuto.txt'' can be found in the Lite install directory, default location C:\Program Files\TapeTrack\TapeTrack Lite\VolumeAuto.txt.
Line 10: Line 12:
 ===== File Format ===== ===== File Format =====
  
-The file is in CSV Format, and contains the following fields:+The file VolumeAuto.txt is in a comma delimitered CSV Format using the format volume_filter,date,new_description. 
 + 
 +The file contains the following fields:
  
   * Volume Filter in Customer.Media.Volume Format   * Volume Filter in Customer.Media.Volume Format
   * Move Date in the following formats:   * Move Date in the following formats:
     *  YYYY-MM-DD     *  YYYY-MM-DD
-    * *+n (where * is today, and n is an integer days offset +    * *+n (where * is today, and n is an Integer days offset 
-    *  Y+n (where Y is the first day of the next year, and n is an integer years offset) +    *  Y+n (where Y is the first day of the next year, and n is an Integer years offset) 
-    * y+n (where y is the last day of the next year, and n is an integer years offset)  +    * y+n (where y is the last day of the next year, and n is an Integer years offset)  
-    * M+n (where M is the first day of the next month, and n is an integer months offset)  +    * M+n (where M is the first day of the next month, and n is an Integer months offset)  
-    * m+n (where m is the last day of the next month, and n is an integer months offset) +    * m+n (where m is the last day of the next month, and n is an Integer months offset)
   * Description   * Description
  
 +===== Setting Move Dates =====
 +
 +Open VolumeAuto.txt in a text editor such as Notepad.
 +
 +At the bottom of the file, under the comment lines (#) and insert the required filters and move dates in the format
 +volume_filter,date,new_description.
 +
 +Set the [[general:pattern_matching|volume filter]] using [[general:pattern_matching|string pattern matching]] to include the required [[object:volume|Volumes]]
 +
 +Set the next move date using the relevant [[general:pattern_matching#date-pattern-matching|date format]].
 +
 +Add new description.  If no description is added to the filter (ie volume_filter,date) the move date will still be added but description will be left as the current value.
 ===== Function ===== ===== Function =====
  
Line 27: Line 43:
   * If a matching filter is found the date will be evaluated.   * If a matching filter is found the date will be evaluated.
     * if the date value is in the past the search will continue.     * if the date value is in the past the search will continue.
-    * If the date value is in the future and is past the default date value, the move date will be overridden with the date value.+    * If the date value is in the future, the move date will be overridden with the date value.
   * If no matching filter is found the default move date will be applied to the Volume.   * If no matching filter is found the default move date will be applied to the Volume.
  
Line 37: Line 53:
   * Move date: Today + 10 days   * Move date: Today + 10 days
   * New Description: Test Description    * New Description: Test Description 
-<sxh>ACME.LTO.*,*+10,Test Description </sxh>+<code>ACME.LTO.*,*+10,Test Description </code>
    
 All Volumes from:  All Volumes from: 
Line 44: Line 60:
   * Move date: First of next year, + 7 years   * Move date: First of next year, + 7 years
   * New Description: Test Description    * New Description: Test Description 
-<sxh>*.LTO.*,Y+7,Test Description </sxh>+<code>*.LTO.*,Y+7,Test Description </code>
  
 All Volumes from:  All Volumes from: 
Line 51: Line 67:
   * Move date: First of December 2010   * Move date: First of December 2010
   * New Description: Test Description     * New Description: Test Description  
-<sxh>ACME.LTO.*,2010-12-01,Test Description </sxh> +<code>ACME.LTO.*,2010-12-01,Test Description </code> 
  
 Volume 100122L6: Volume 100122L6:
Line 58: Line 74:
   * Move date: Listed set of dates   * Move date: Listed set of dates
   * New Description: Test Description   * New Description: Test Description
-<sxh>+<code>
 ACME.LTO.100122L6,2019-01-04,Test Description ACME.LTO.100122L6,2019-01-04,Test Description
 ACME.LTO.100122L6,2019-01-11,Test Description ACME.LTO.100122L6,2019-01-11,Test Description
Line 66: Line 82:
 ACME.LTO.100122L6,2019-02-08,Test Description ACME.LTO.100122L6,2019-02-08,Test Description
 ACME.LTO.100122L6,2019-02-15,Test Description ACME.LTO.100122L6,2019-02-15,Test Description
-</sxh>+</code>
  
  
lite/volumeauto.1546382594.txt.gz · Last modified: 2025/01/21 22:07 (external edit)