Bucky Backup - How to delete archives from TSM

This document explains how to delete archives from the TSM server for Bucky Backup.

How to Delete Archives

This document assumes that you have installed and configured the TSM client. 

What is an archive?

For more information on archives see: Bucky Backup - What is an archive?

Deleting an archive in the GUI client

  1. Start the TSM GUI
  • Windows: Start -> Programs -> Tivoli Storage Manager -> Backup Archive GUI
  • Mac: Applications -> Tivoli Storage Manger -> TSM Tools for Administorators -> Tivoli Storage Manger
  • UNIX/Linux(requires X-windows client): as root or with sudo run dsmj or /path/to/tsm/bin/dsmj if it's not in your path
  • Once you start the GUI, the interface should look very similar across all platforms
  • Enter your TSM node name and password if necessary (it will likely already be saved)
  • You should now see a window that looks something like this:

    TSM Main Window

  • Click on the Utilities menu near the top of the screen and choose "Delete Archive Data..."
  • Browse the tree on the left to find the files or folders you want to delete.
    • You can delete individual files from an archive object.
    • Check the box in front of the description (if you didn't add a description it will look like the image below) to remove all files in that archive. If you made more than one archive with the same name they will appear to be one archive object.Choose files to delete.
  • Click the Delete button (upper left) and confirm that you wish to delete the selected file(s).
  • When complete you will see this:


    Deletion complete.

  • Deleting an archive from the command line

    Windows

    1. Run a command prompt as an administrator
    • Start -> Programs -> Accessories -> Right click on "Command Prompt" and choose "Run as administrator"
  • Change to the directories where the TSM executables are located
    • cd "\Program Files\Tivoli\TSM\baclient" (default install location)
  • Run your "dsmc delete archive" command (see below)
    • Note: You may need to use "dsmc.exe" in place of "dsmc" in some Windows environments.
  • Confirm that you want to delete archive files
  • UNIX/Linux/Mac

    1. Open a root command shell or use sudo
    2. Run your "dsmc delete archive" command (see below) (include full path to dsmc if necessary)
    3. Confirm that you want to delete archive files

    Basic Syntax

    > dsmc delete archive c:\path\to\files\* -description="Description" 

    DSMC Command options

    • Specify the file(s) you would like to delete from an archive
      • Use the full path to a file
      • Use "*" for wildcard
        • C:\path\to\dir\*
        • /path/to/dir/*.txt
      • Be sure you use quotes if specifying directory or file names with spaces
        • "/path/to/files/file 1.txt"
        • "E:\Research Project\*"
    • Delete files form a specific archive description (optional)
      • -description="Description"
      • This is recommended since a file could be contained in more than one archive object and would be deleted from all archives where it is present
    • Pick option (optional)
      • -pick
      • If a file is contained in multiple archives, TSM will display a list of archives and allow you to choose which one to delete from
      • Enter the number to choose the file you want
      • delete archive pick
    • Delete files from subdirectories
      • -subdir=yes
      • This will delete any subdirectories in the location specified

    Examples

    • Delete a file from all archive objects
      • dsmc delete archive "C:\ArchiveTest\deleteme.txt"
    • Delete a file from a specific archive
      • dsmc delete archive "C:\ArchiveTest\deleteme.txt" -description="Archive Test 3-11-2014 5YEARS"
    • Delete directories with subfolders
      • dsmc delete archive "C:\ArchiveTest\*" -subdir=yes -description="Archive Test 3-11-2014 2YEARS"
    • Delete a file using the pick option (see screenshot above)
      • dsmc delete archive "C:\ArchiveTest\deleteme.txt" -pick



    Keywords:
    Bucky Backup Enterprise Lite delete remove Archive TSM Windows Apple Mac Linux AIX Solaris UNIX 
    Doc ID:
    37201
    Owned by:
    Kevin K. in Bucky Backup
    Created:
    2014-01-30
    Updated:
    2017-08-02
    Sites:
    Bucky Backup, DoIT Help Desk, DoIT Staff, Systems Engineering