TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • tmss10mirror
cli:tmss10mirror

Table of Contents

 
 

TMSS10Mirror

TMSS10Mirror will replicate location information from one TapeTrack Server to another.

Synopsis

TMSS10Mirror [-P phases] [-S logon string] [-c configuration file]

Options

  • -P Phases to execute.
  • -S The Logon string argument sets the Server Logon Information.
  • -c The config file argument specifies the path to the Batch Configuration File. The Batch Configuration File allows you to perform advanced traversal of Customer, Media and Volumes, perform advanced Barcode pre and post processing and route program output to syslogd.

If an argument value starts with the value FI:, the value for that attribute will be read from the file name specified immediately after it. For example, if a file named ACME_volumes has the content ACME_*.*, specifying FI:/etc/ACME_volumes will have the same effect as -V ACME.*.*. Using FI: to refer to a file for an attribute value works for all attributes.

If the pattern being matched starts with *LIST: then rather than matching the literal value, each record in the file specified as *LIST:filename will be tested. If one matches the match will succeed.

Technical Support

The TapeTrack Software is commercially supported by a full time help desk staff.

If you are experiencing problems or want some advice on how to configure or use the product please see the Accessing Technical Support page.

Exit Statuses

  1. zero Program has ended successfully.
  2. non-zero Program has not ended successfully.

Environment

Files

stdout: Output Reports.
stderr: Diagnostic messages.
stdin: Program input.

Example

Config File

mirror.cfg contains the IP address of the mirror server as well as the user/password to login in. 

traversal =
{
   customer = 
   (
      {
         id = "*";
         media =
         (
            {
                id = "*";
                remote = 
                { 
                    address="mirror_server.tapetrack.com"; 
                    userid="mirror_user"; 
                    password="mirror_password";
                };
             }
         );
      }
   );
};

Command line syntax

TMSS10Mirror -S user:-password@server -c "C:\Program Files\TapeTrack\TapeTrack Framework Server\etc\mirror.cfg"

Output

Mirror Report (Detail)
             System: TapeTrack
 Report Description: Mirror Report (Detail)
       Report Notes: Local Customer(Nashville Data Center) Media(LTO Cartridge)
    Production Time: Thursday, April 19, 2018 - 11:26:51 (AUS Eastern Standard Time)
       Report Width: 163 bytes

 Seq.   Step Volume-ID  Remote-ID            Notes                                                                            Source User-ID   Source Date/Time    
 ------ ---- ---------- -------------------- -------------------------------------------------------------------------------- ---------------- ------------------- 
                                             Local server set to 127.0.0.1                                                                                         
                                             Remote server set to 192.168.0.177                                                                                    
      1    1 000017L5   US04.LTO.000017L5    New Volume added to Remote Server                                                doco             2018-04-19 11:30:50 
      2    1 000018L5   US04.LTO.000018L5    New Volume added to Remote Server                                                doco             2018-04-19 11:30:50 
      3    3 000001L5   US04.LTO.000001L5    Target Repository updated from LIBR to OFFS                                      doco             2018-04-19 11:25:50 
      4    3 000002L5   US04.LTO.000002L5    Target Repository updated from LIBR to OFFS                                      doco             2018-04-19 11:25:50 
      5    3 000003L5   US04.LTO.000003L5    Target Repository updated from LIBR to OFFS                                      doco             2018-04-19 11:25:50 
      6    3 000007L6   US04.LTO.000007L6    Target Repository updated from OFFS to LIBR                                      doco             2018-04-19 11:26:19 
      7    3 000008L5   US04.LTO.000008L5    Target Repository updated from OFFS to LIBR                                      doco             2018-04-19 11:26:19 
      8    3 000008L6   US04.LTO.000008L6    Target Repository updated from OFFS to LIBR                                      doco             2018-04-19 11:26:19 
      9    4 000004L5   US04.LTO.000004L5    Remote Scanned Repository updated to LIBR                                       doco             2018-04-19 11:29:02 
     10    4 000004L6   US04.LTO.000004L6    Remote Scanned Repository updated to LIBR                                       doco             2018-04-19 11:29:02 
     11    4 000005L5   US04.LTO.000005L5    Remote Scanned Repository updated to LIBR                                       doco             2018-04-19 11:29:02 
     12    4 000009L5   US04.LTO.000009L5    Remote Scanned Repository updated to OFFS                                       doco             2018-04-19 11:28:21 
     13    4 000009L6   US04.LTO.000009L6    Remote Scanned Repository updated to OFFS                                       doco             2018-04-19 11:28:21 
     14    5 000008L6   US04.LTO.000008L6    Local Scanned Repoisitory updated to LIBR                                        doco             2018-04-19 11:28:21 
 ------ ---- ---------- -------------------- -------------------------------------------------------------------------------- ---------------- -------------------
Mirror Report (Extract)
             System: TapeTrack
 Report Description: Mirror Report (Extract)
    Production Time: Thursday, April 19, 2018 - 11:26:51 (AUS Eastern Standard Time)
       Report Width: 122 bytes

 Phase                                                                            Executed   Elapsed    Updates  Errors   
 -------------------------------------------------------------------------------- ---------- ---------- -------- -------- 
 Phase 1: Adding missing Volumes to remote server (Local to Remote)               Run                S0        2        0 
 Phase 2: Adding missing Volumes to local server (Remote to Local)                Run                S0        0        0 
 Phase 3: Synchronizing Target Repositories (Local to Remote)                     Run                S0        6        0 
 Phase 4: Synchronizing Scanned Repositories (Local to Remote)                    Run                S0        5        0 
 Phase 5: Synchronizing Scanned Repositories (Remote to Local)                    Run                S0        1        0 
 -------------------------------------------------------------------------------- ---------- ---------- -------- --------
Changelog
2021-05-24Fixed bug when using TMSSLEVELNAME and TMSSNOLEVELSLOT variables (#127)
2020-11-24Added support for JSON output
2019-02-25Added support for HTML output
2019-02-09Added support for Excel output
2019-01-06Added return code list to end of all command line programs that use the TapeTrack API
2017-05-25Fixed bug where new tapes were not adding
2017-05-25Fixed bug where unconfirmed Volumes in Phase 4 could compromize valid updates in Phase 5
2017-05-25Enhanced program to work around unconfirmed tapes that were not in a move status.
2017-04-08Fixed bug where unconfirmed Volumes in Phase 4 could compromize valid updates in Phase 5.
2017-01-14Added step runtime to the extract report
2017-01-14Added step to confirm Volumes on the remote machine when confirmed on the local
2016-11-18Added fast forward code to reduce runtime
2016-11-18Enhanced argument parser to allow arguments in format *FI:filename that allows loading of arguments from a file
2015-12-26Added flags to Volume Filter syntax (customer.media.volume@repository+flags)
2015-08-24Changed hascontents to contentcount and change contentcount to a filter rather than bool
2015-08-24Added iscontainer and hascontents to the config file filter logic
2015-05-16Added environmental varialbe TMSSCANFILEUNQUALIFIED which will load and check volumes without Customer-ID and Media-ID qualifiers
2015-05-16Added environmental varialbe TMSSSCANFILENOPARSE which will presume scanfile items are only Volumes and not parse them, saving time
2015-05-16When loading scanfile from import definition, added CUSTOMER and MEDIA keywords to set defaults
2015-05-16When loading scanfile from import definition, changed keyword from VOLUME to BARCODE
2015-05-16Added TMSSUNQUALIFIEDVOLUME environmental variable which forces all barcodes to be printed without Customer-ID and Media-ID
2015-05-04Added support for AD passwords to all command line programs (check for environmental variable TMSSNOMD5)
2015-02-13Upgraded development environment from Visual Studio 2012 to Visual Studio 2013
2015-02-13Changed server argument parser to allow colon in password to support z/OS DD name files
2015-02-09Changed translate_repository to translate_repository_id for consistency
2015-02-09Fixed bug in message when Volume is added to Local server
2015-02-09Added translate_customer_id support to config file
2015-02-09Initial version
 
Command Line Utilities 
 
cli/tmss10mirror.txt · Last modified: 2022/05/31 01:18 by scunliffe

Page Tools