TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • cannnot_update_slot_to_zero • components • move_status • volume_edit_paste_value • lite_start • tmssreportformat • tools_plugins
technote:rename_volumes

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
technote:rename_volumes [2021/08/05 01:16] – [Volume File] Scott Cunliffetechnote:rename_volumes [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 1: Line 1:
-====== Renaming A Batch Of Volume-ID's ======+====== Renaming Volume-ID's Using A Batch File  ======
  
 Renaming a batch of Volumes can be completed in one process using a configuration file, definition file, Volume List and [[cli:tmss10volumerename|TMSS10VolumeRename]]. Renaming a batch of Volumes can be completed in one process using a configuration file, definition file, Volume List and [[cli:tmss10volumerename|TMSS10VolumeRename]].
Line 31: Line 31:
  
 ==== Definition File ==== ==== Definition File ====
 +
 +rename.ttidef
  
 <code> <code>
Line 37: Line 39:
  
 # Set Customer and Media values # Set Customer and Media values
-SetLiteral(CUSTOMER, US44);+SetLiteral(CUSTOMER, US04);
 SetLiteral(MEDIA, LTO); SetLiteral(MEDIA, LTO);
  
Line 43: Line 45:
 Extract(BARCODE, 0, 6, 0); Extract(BARCODE, 0, 6, 0);
 </code> </code>
 +
 +==== Configuration File ====
 +
 +rename.cfg
 +
 +Compare all Volumes to Scan file.
 +
 +If present in the Scan file (scanfile=true) then process that Volume (skip=false)
 +
 +If not present in the Scan file discard Volume (skip=true)
 +
 +<code>
 +traversal =
 +{
 +   scanfile= { file="rename.ttidef"; };
 +   customer =
 +   (
 +      {
 +         id="*";
 +         media =
 +         (
 +            {
 +               id="*";
 +               volume =
 +               (
 +                   {
 +                      id="*";
 +                      scanfile=true;
 +                      skip=false;
 +                   },
 +                   {
 +                      id="*";
 +                      skip=true;
 +                   }
 +               );
 +            }
 +         );
 +      }
 +   );
 +};
 +</code>
 +
 +==== Batch File ====
 +
 +Run TMSS10VolumeRename in test mode.  Test mode allows you to execute TMSS10VolumeRename without making any alterations to the database to check the output is as expected.
 +
 +  * ''-S'' The Logon String argument sets the [[cli:server_argument|Server Logon Information]].
 +  * ''-V'' The volume filter limiting input from just Customer US04 and Media LTO.
 +  * ''-c'' The config file argument specifies the path to the Configuration File rename.cfg.
 +  * ''-N'' New Volume-ID, *L4 adds L4 to the current Volume_id.
 +  * '' > '' Redirects standard output stream to file rename_out.txt
 +  * ''2>''  Redirects standard error stream to file rename_err.txt
 +
 +
 +<code>
 +TMSS10VolumeRename -S user:-password@serveraddress -V "US04.LTO.*" -c rename.cfg -N "*L4" > rename_out.txt 2> rename_err.txt
 +</code>
 +
 +Adding the ''-l'' attribute places the execution into live mode, where the alterations are made to the Volumes in the database.
 +
 +<code>
 +TMSS10VolumeRename -S user:-password@serveraddress -V "US04.LTO.*" -c rename.cfg -N "*L4" -l > rename_out.txt 2> rename_err.txt
 +</code>
 +
 +=== Standard Output ===
 +
 +Test Mode - rename_out.txt
 +
 +
 +
 +<code>
 +
 +             System: TapeTrack
 + Report Description: Scan-File Load Report
 +    Production Time: Thursday, August 05, 2021 - 10:48:36 (AUS Eastern Standard Time)
 +       Report Width: 149 bytes
 +
 + Seq.   Record Barcode                                  Resolved As          Status Notes                                                            
 + ------ ------ ---------------------------------------- -------------------- ------ ---------------------------------------------------------------- 
 +      1      1 100001                                   US04.LTO.100001      OK                                                                      
 +      2      2 100002                                   US04.LTO.100002      OK                                                                      
 +      3      3 100003                                   US04.LTO.100003      OK                                                                      
 +      4      4 100004                                   US04.LTO.100004      OK                                                                      
 +      5      5 100005                                   US04.LTO.100005      OK                                                                      
 +      6      6 100006                                   US04.LTO.100006      OK                                                                      
 +      7      7 100007                                   US04.LTO.100007      OK                                                                      
 +      8      8 100008                                   US04.LTO.100008      OK 
 +      9      9 100009                                   US04.LTO.100009      OK
 +     10     10 100010                                   US04.LTO.100010      OK                                  
 + ------ ------ ---------------------------------------- -------------------- ------ ---------------------------------------------------------------- 
 +
 +             System: TapeTrack
 + Report Description: Volume Rename Report
 +    Production Time: Thursday, August 05, 2021 - 10:48:36 (AUS Eastern Standard Time)
 +       Report Width: 111 bytes
 +
 + Seq.   Old Identity         New Identity         Messages                                                     
 + ------ -------------------- -------------------- ------------------------------------------------------------ 
 +      1 US04.LTO.100001      US04.LTO.100001L4    Not running in Live mode                                     
 +      2 US04.LTO.100002      US04.LTO.100002L4    Not running in Live mode                                     
 +      3 US04.LTO.100003      US04.LTO.100003L4    Not running in Live mode                                     
 +      4 US04.LTO.100004      US04.LTO.100004L4    Not running in Live mode                                     
 +      5 US04.LTO.100005      US04.LTO.100005L4    Not running in Live mode                                     
 +      6 US04.LTO.100006      US04.LTO.100006L4    Not running in Live mode                                     
 +      7 US04.LTO.100007      US04.LTO.100007L4    Not running in Live mode                                     
 +      8 US04.LTO.100008      US04.LTO.100008L4    Not running in Live mode
 +      9 US04.LTO.100007      US04.LTO.100009L4    Not running in Live mode                                     
 +     10 US04.LTO.100008      US04.LTO.100010L4    Not running in Live mode                                     
 + ------ -------------------- -------------------- ------------------------------------------------------------ 
 +
 +</code>
 +
 +Live Mode - rename_out.txt
 +
 +<code>
 +
 +             System: TapeTrack
 + Report Description: Scan-File Load Report
 +    Production Time: Thursday, August 05, 2021 - 10:48:36 (AUS Eastern Standard Time)
 +       Report Width: 149 bytes
 +
 + Seq.   Record Barcode                                  Resolved As          Status Notes                                                            
 + ------ ------ ---------------------------------------- -------------------- ------ ---------------------------------------------------------------- 
 +      1      1 100001                                   US04.LTO.100001      OK                                                                      
 +      2      2 100002                                   US04.LTO.100002      OK                                                                      
 +      3      3 100003                                   US04.LTO.100003      OK                                                                      
 +      4      4 100004                                   US04.LTO.100004      OK                                                                      
 +      5      5 100005                                   US04.LTO.100005      OK                                                                      
 +      6      6 100006                                   US04.LTO.100006      OK                                                                      
 +      7      7 100007                                   US04.LTO.100007      OK                                                                      
 +      8      8 100008                                   US04.LTO.100008      OK 
 +      9      9 100009                                   US04.LTO.100009      OK
 +     10     10 100010                                   US04.LTO.100010      OK                                  
 + ------ ------ ---------------------------------------- -------------------- ------ ---------------------------------------------------------------- 
 +
 +             System: TapeTrack
 + Report Description: Volume Rename Report
 +    Production Time: Thursday, August 05, 2021 - 10:48:36 (AUS Eastern Standard Time)
 +       Report Width: 111 bytes
 +
 + Seq.   Old Identity         New Identity         Messages                                                     
 + ------ -------------------- -------------------- ------------------------------------------------------------ 
 +      1 US04.LTO.100001      US04.LTO.100001L4    Request OK                                     
 +      2 US04.LTO.100002      US04.LTO.100002L4    Request OK                                     
 +      3 US04.LTO.100003      US04.LTO.100003L4    Request OK                                    
 +      4 US04.LTO.100004      US04.LTO.100004L4    Request OK                                     
 +      5 US04.LTO.100005      US04.LTO.100005L4    Request OK                                     
 +      6 US04.LTO.100006      US04.LTO.100006L4    Request OK                                     
 +      7 US04.LTO.100007      US04.LTO.100007L4    Request OK                                    
 +      8 US04.LTO.100008      US04.LTO.100008L4    Request OK
 +      9 US04.LTO.100007      US04.LTO.100009L4    Request OK                                    
 +     10 US04.LTO.100008      US04.LTO.100010L4    Request OK                                    
 + ------ -------------------- -------------------- ------------------------------------------------------------ 
 +
 +</code>
 +
 +{{tag> technote cli rename config}}
technote/rename_volumes.1628126217.txt.gz · Last modified: 2025/01/21 22:07 (external edit)