Differences

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

--- lite:volumeauto [2019/01/01 00:17] – Scott Cunliffe
+++ lite:volumeauto [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Using VolumeAuto.txt To Set Move Dates======
+======  VolumeAuto: Setting Move Dates ======
-**VolumeAuto.txt** uses Volume filters and date values that can be employed to overide default return dates 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
-===== Function =====
+===== Setting Move Dates =====
-When using the Send function in Lite, Volumes will be compared to the filters contained in the VolumeAuto file.
+Open VolumeAuto.txt in a text editor such as Notepad.
-If a matching filter is found the date will be evaluated.
+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.
-if the date value is in the past the search will continue.
+Set the [[general:pattern_matching|volume filter]] using [[general:pattern_matching|string pattern matching]] to include the required [[object:volume|Volumes]]
-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.
+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 =====
-If no matching filter is found the default move date will be applied to the Volume.
+When using the Send function in Lite, [[object:volume|Volumes]] will be compared to the filters contained in the VolumeAuto file.
+  * 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, 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.
 ===== Examples =====
-Today + 10 days
+All Volumes from:
-<sxh>* ACME.DL.*,*+10,Test Description </sxh>
+  * Customer: ACME
+  * Media type: LTO
+  * Move date: Today + 10 days
+  * New Description: Test Description
+<code>ACME.LTO.*,*+10,Test Description </code>
-First of next year, + 7 years
+All Volumes from:
-<sxh>*.DL.*,Y+7,Test Description </sxh>
+  * Customer: all
+  * Media type: LTO
+  * Move date: First of next year, + 7 years
+  * New Description: Test Description
+<code>*.LTO.*,Y+7,Test Description </code>
-First of December 2010
+All Volumes from:
-<sxh>ACME.DL.*,2010-12-01,Test Description </sxh>
+  * Customer: ACME
+  * Media type: LTO
+  * Move date: First of December 2010
+  * New Description: Test Description
+<code>ACME.LTO.*,2010-12-01,Test Description </code>
+Volume 100122L6:
+  * Customer: ACME
+  * Media type: LTO
+  * Move date: Listed set of dates
+  * New Description: Test Description
+<code>
+ACME.LTO.100122L6,2019-01-04,Test Description
+ACME.LTO.100122L6,2019-01-11,Test Description
+ACME.LTO.100122L6,2019-01-18,Test Description
+ACME.LTO.100122L6,2019-01-25,Test Description
+ACME.LTO.100122L6,2019-02-01,Test Description
+ACME.LTO.100122L6,2019-02-08,Test Description
+ACME.LTO.100122L6,2019-02-15,Test Description
+</code>