TapeTrack Documentation

Because there is more to tape management than you ever realized

User Tools

Site Tools

Trace: • config_file
lite:config_file

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:config_file [2021/09/02 01:14] – [Lite Configuration File] Scott Cunliffelite:config_file [2025/01/21 22:07] (current) – external edit 127.0.0.1
Line 31: Line 31:
       },       },
       {       {
-             hidden=true;  +          hidden=true;  
-             text="Custom Command 1"; +          text="Custom Command 1"; 
-             //sequence=100; +          //sequence=100; 
-             command="echo hello > out.txt"; +          command="echo hello > out.txt"; 
-             filters=( "*this string will be excluded*", "*So will this string*" );+          filters=( "*this string will be excluded*", "*So will this string*" );
       }       }
    );    );
  
-   // +   // file truncated for display purposes 
-   // When exporting data to email send to the following addresses +</code> 
-   // +  
-   email = [ "emailto1@tapetrack.com", "emailto2@tapetrack.com" ];+===== Locating The Lite Config File =====
  
-   // +The default installation location of TapeTrack Lite is at C:\Program Files\TapeTrack\TapeTrack Lite. This location can be modified at installation to suit your requirements if required.
-   // If you specify a valid logfile value the logfile dialog will not be displayed  +
-   // +
-   // logfile="%HOMEDRIVE%HOMEPATH\\Documents";+
  
-   // +The Lite config file (TMSSLite.cfg) is located in the TapeTrack directory at \TapeTrack\TapeTrack Lite\TMSSLite.cfg
-   // If you would like to pickup your list files somewhere else then uncomment this. +
-   // +
-   // setlistdirectory="%USERPROFILE\Documents"; +
-    +
-   // +
-   // The localrepositoryfilter value determines which Repositories are show and local to the current user +
-   // +
-   // localrepositoryfilter="*"; +
-    +
-   // +
-   // You can route all log file data to a syslogd service too... +
-   // +
-   // syslogd = { facility="local1"; server="192.168.10.1"; port=514; }; +
  
-   // +<note important>Before modifying the file TMSSLite.cfg make a backup copy in case of any errors</note>
-   // If you're a little put off by a computer telling you about your mistakes you can set disablespeech to true. +
-   // +
-   // disablespeech=true; +
- +
-/* +
-   variables = { +
-       TMSSLEVELNAMES = "A,B,C"; +
-   }; +
-*/ +
- +
-}; +
- +
-/* +
-servers = +
-{ +
-   Server1 = { host = "odpapi-test.tapetrack.com"; };  +
-   Server2 = { host = "odpapi-test.tapetrack.com"; port=433; proxy=true; }; +
-}; +
-*/ +
- +
-//* +
-//* The Allocation table allows you to automatically assign tapes to a container. +
-//* +
-//* The allocation process works like this: +
-//* +
-//* 1. If you have an allocation section the following logic will occur +
-//* 2. If a tapes has no container assigned the program will loop through each element looking for a volume scope match +
-//* 3. If you get a match the program will then look through each available Container looking for a scope match (and looking at container capacity) +
-//* 4. If you get a match the tape will be automatically assigned to that container +
-//* 5. If you don't get a match the program will try and look for a container with capacity that has no data cluster. If a Container is found- +
-//*    the container will be assigned that data cluster and the tape will be assigned to that container. +
-//* +
-//* Notes: that the datacluster value in the volume and container sections are filters, the value in the assignment is a literal data cluster value - +
-//*          for a datacluster than must pre-exist. +
-//* +
- +
-/*        +
-allocation = +
-( +
-   {  +
-       volume = { barcode="*"; datacluster="WEEKLY_TAPES"; }; +
-       container = { barcode="*"; datacluster="WEEKLY_TAPES"; }; +
-       assignment = { barcode="*"; datacluster="WEEKLY_TAPES"; }; +
-   }, +
-   {  +
-       volume = { barcode="*"; datacluster="YEARLY_TAPES"; }; +
-       container = { barcode="*"; datacluster="YEARLY_TAPES"; }; +
-       assignment = { barcode="*"; datacluster="YEARLY_TAPES"; }; +
-   }, +
-   {  +
-       volume = { barcode="*"; datacluster="*"; assignment=false; }; +
-   } +
-); +
- +
- +
-routing = +
-( +
-   {  +
-       volume = { source="OFFS"; target="RACK"; }; +
-   } +
-); +
-*/ +
- +
-//* +
-//* You can preprocess barcodes locally before they are sent to the Server for parsing. +
-//* This allows you to convert a Volume to a fully qualified barcode. +
-//* You can add as many filter/values as you like. The list will be searched in the order they appear in this file +
-//* +
- +
-/* +
-barcodes= +
-{ +
-   translations= +
-   ( +
-      { filter="GAZ*L1"; value="GAZ.LT1.*"; }, +
-      { filter="GAZ*L2"; value="GAZ.LT2.*"; cleanup={volume="0000*";}; } +
-   ); +
-}; +
-*/ +
- +
-//* +
-//* If you want to disable specific popup notifications you can use uncomment the notifications section +
-//*  +
- +
- +
-notifications =  +
-{ +
-   filters=  +
-   ( +
-      {  +
-        title="Library Health Warning"; line1="*"; line2="*"; disable=true; +
-      } +
-   ) +
-}; +
-</code>+
  
 +Open the file in a plain text editor, such as Notepad.
 ===== Customizing the Library Management Tasks Menu ===== ===== Customizing the Library Management Tasks Menu =====
  
Line 171: Line 61:
 Being a local modification, means it only affects the local installation so will need to be executed on all local machines you want to alter the display on.</note> Being a local modification, means it only affects the local installation so will need to be executed on all local machines you want to alter the display on.</note>
  
-{{:lite:lite_config_menu.png}}+{{lite_config_menu.png}}
  
 There are several commands that can be used under the ''menu'' command: There are several commands that can be used under the ''menu'' command:
Line 220: Line 110:
            filter="*Send*";            filter="*Send*";
            hidden=false;            hidden=false;
-           text="Transmit to Offsite Vault";+           text="Send to Offsite Vault";
            sequence=01;            sequence=01;
        },        },
Line 226: Line 116:
            filter="*Recall*";            filter="*Recall*";
            hidden=false;            hidden=false;
-           text="Return from Offsite Vault";+           text="Recall from Offsite Vault";
            sequence=02;            sequence=02;
        },        },
Line 246: Line 136:
        
 The above script provides the necessary components to: The above script provides the necessary components to:
-  * Hide any command with the String Guide, Users, Upload or Outlook. +  * Hide any command with the String Guide, Users, Upload, SCSI, Excel, Library Management, List or Outlook. 
-  * Change the displayed name of the **[[lite:function_send|Send]]** function to **Transmit to Offsite Vault**.+  * Change the displayed name of the **[[lite:function_send|Send]]** function to **Send to Offsite Vault**.
   * Place the **Send** function at the top of the drop-down list.   * Place the **Send** function at the top of the drop-down list.
-  * Change the name of the **[[lite:function_recall|Recall]]** function to **Return from Offsite Vault**.+  * Change the name of the **[[lite:function_recall|Recall]]** function to **Recall from Offsite Vault**.
   * Place the **Recall** function second in the drop-down list.   * Place the **Recall** function second in the drop-down list.
   * Add a command to the Tape Management Task Menu that runs [[cli:tmss10ping|TMSS10Ping]] for the local TapeTrack Server with the text **Ping TapeTrack Server**.  Replace the server address ''localhost'' with your TapeTrack Framework Server address (dotted IP or DNS) to run the command against your server.   * Add a command to the Tape Management Task Menu that runs [[cli:tmss10ping|TMSS10Ping]] for the local TapeTrack Server with the text **Ping TapeTrack Server**.  Replace the server address ''localhost'' with your TapeTrack Framework Server address (dotted IP or DNS) to run the command against your server.
Line 255: Line 145:
   * Change the Save Location for Log Files.   * Change the Save Location for Log Files.
  
-**Note**: the sequence numbers 01 and 02 were used to indicate that they came before the default first sequence number of "10" that is typically assigned to **Scan-In**.+**Note**: the sequence numbers 01 and 02 were used to indicate that they came before the default first sequence number of "10" that is typically assigned to ''Scan-In''.
  
  
 ===Modified Menu View=== ===Modified Menu View===
-{{:lite:lite_config_altered.png}}+{{modified_menu.png}}
  
  
Line 327: Line 217:
 ===== Notifications ===== ===== Notifications =====
  
 +Lite will display various notifications in the lower right of your display at different times.
  
 +For example when logging on to Lite, a notification will display a welcome message and the last IP address used to logon.
 +
 +{{logon_notification.png}}
 +
 +By default the notifications section of Lite blocks Library Health Warnings as this notification is more relevant in TapeMaster.  
 +
 +<code>
 +notifications = 
 +{
 +   filters= 
 +   (
 +      { 
 +        title="Library Health Warning"; line1="*"; line2="*"; disable=true;
 +      }
 +   )
 +};
 +</code>
 +
 +It is possible to block other notifications, if required, by adding additional blocks of code for the required notifications. For example to remove, or block, the ''Logged-On'' notification modify the ''notifications'' block of code to include the following code.
 +
 +<code>
 +notifications = 
 +{
 +   filters= 
 +   (
 +      { 
 +        title="Library Health Warning"; line1="*"; line2="*"; disable=true;
 +      },
 +      {
 +     title="Logged-On"; line1="*"; line2="*"; disable=true;
 +      }
 +   )
 +};
 +</code>
  
  
  
  
lite/config_file.1630545271.txt.gz · Last modified: 2025/01/21 22:07 (external edit)