This is an old revision of the document!
Table of Contents
Managing Scratch Volumes With TMSS10LibraryManager
TMSS10LibraryManager is used to automatically manage Scratch Volume levels for your Backup Library.
Steps to manage:
- Set Library Repository Capacities.
- Set Scratch Repository preferences.
- Designate a Target Repository to eject Library Volumes to when space is required.
- Create a batch file
- Schedule batch file to run automatically
Set Library Capacities
Open TapeMaster, select the required Customer and Media Type from the Customer Tree.
For this example we will use Customer-ID US01 and Media-ID LTO along with the Repository-ID LIBR.
Right click on the Repository, or double click, and select the Options tab.
Towards the bottom, expand the Capacity section by clicking on the + sign.
In the field Capacity, enter the number of Volume Slots in your Library.
In the field Minimum Scratch enter the minimum number of Scratch Volumes required in the Library.
Click Save to update the Repository data.
Set Scratch Repository Preferences
From the other Repositories within the Customer's Media Type, decide the Repositories that Scratch Volumes should be harvested and in what order. The higher the Scratch Priority the more prference it is given for Scratch selection. Any Repository with a Scratch Priority of 0 will not be selected for Scratch Volume selection.
To set the Scratch Priority of a Repository, right click on the selected Repository and select Properties, or double click, and select the Options tab.
In the field Scratch Priority set the required number, remembering the higher the number the earlier it is used for Scratch Volume selection.
Click Save to update the Repository data.
Create a Scheduled File
Windows Batch File
Open a new Notepad file and click File > Save As to open up the File Save dialog.
Save the file under and appropriate name, such as runTMSSLibraryManager.bat
Select All Types from the Save As Type drop box.
Click Save to create the batch file.
Add Command Line Code to Scheduled File
Minimum requirements for the Command Line code include:
- Program call TMSS10LibraryManager
- Logon string (-S user:-pass@server).
- Customer-ID (-C XXXX).
- Media-ID (-M XXXX).
- Repository-ID to manage (-R XXXX).
Using the example Customer-ID US01 and Media-ID LTO along with the Repository-ID LIBR:
TMSS10LibraryManager -S user:-pass@serveraddress -C "US01" -M "LTO" -R "LIBR"
Additional options include
- Target Repository to eject Volumes to (-T XXXX).
- Volume Selection Filter to include only Volumes that match (-V).
- Configuration file (-c).
- Volume ejection exclusion filter (-e).
- Minimum free slots required in Repository (-f).
- Repository Scratch order override.
- Minimum Scratch Volumes required in Repository
Redirecting output to file
TMSS10LibraryManager outputs, by default, reports to standard out and diagnostic information to standard error. This information can be captured and redirected to file using the redirection pipes > and 2>.
To redirect the reports to LibraryManager_Reports_stdout.txt and diagnostic information to LibraryManager_Diagnostic_stderr.txt.
TMSS10LibraryManager -S user:-pass@serveraddress -C "US01" -M "LTO" -R "LIBR" > LibraryManager_Reports_stdout.txt 2> LibraryManager_Diagnostic_stderr.txt