Differences

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

--- lite:volumeauto [2019/01/01 00:58] – [Examples] Scott Cunliffe
+++ lite:volumeauto [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Using VolumeAuto To Set Move Dates======
+======  VolumeAuto: Setting Move Dates ======
-**VolumeAuto** uses Volume filters and date values from ''VolumeAuto.txt'' that can be employed to override default return dates and descriptions for matched 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 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.
+{{lite:lite_volumeauto.png}}
 ===== 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
   * Move Date in the following formats:
     *  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
+===== 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 =====
@@ Line 22: / Line 43: @@
   * 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 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.
@@ Line 32: / Line 53: @@
   * Move date: Today + 10 days
   * New Description: Test Description
-<sxh>ACME.LTO.*,*+10,Test Description </sxh>
+<code>ACME.LTO.*,*+10,Test Description </code>
 All Volumes from:
@@ Line 39: / Line 60: @@
   * Move date: First of next year, + 7 years
   * New Description: Test Description
-<sxh>*.LTO.*,Y+7,Test Description </sxh>
+<code>*.LTO.*,Y+7,Test Description </code>
 All Volumes from:
@@ Line 46: / Line 67: @@
   * Move date: First of December 2010
   * New Description: Test Description
-<sxh>ACME.LTO.*,2010-12-01,Test Description </sxh>
+<code>ACME.LTO.*,2010-12-01,Test Description </code>
 Volume 100122L6:
@@ Line 53: / Line 74: @@
   * Move date: Listed set of dates
   * New Description: Test Description
-<sxh>
+<code>
 ACME.LTO.100122L6,2019-01-04,Test Description
 ACME.LTO.100122L6,2019-01-11,Test Description
@@ Line 61: / Line 82: @@
 ACME.LTO.100122L6,2019-02-08,Test Description
 ACME.LTO.100122L6,2019-02-15,Test Description
-</sxh>
+</code>