Bucky Backup - How to retrieve archives from TSM

This document explains how to restore archives in TSM from Bucky Backup.

How to Retrieve 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?

Restoring 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
  2. Once you start the GUI, the interface should look very similar across all platforms
  3. Enter your TSM node name and password if necessary (it will likely already be saved)
  4. You should now see a window that looks something like this:

    TSM Main Window

  5. Click on Retrieve above the text, "Retrieve an archive copy from long-term storage."
  6. Browse the tree on the left to find the files or folders you want to retrieve from your archive object.
    • In the left pane, you will see all of your archives by date
    • Check the box in front of a file or files in the right pane to select individual files
    • Check the box in front of a directory in the left pane to retrieve the entire directoryChoose files to retrieve.
  7. Click the Retrieve button to retrieve your selections
  8. A new window will display with options for where to put the files
    • Original location will put the files back where they were originally located, if that location exists
    • You can specify another location to put the files
      • Complete path - restores the entire directory structure(s) in the specified location
      • Partial path (default) - restores most of the directory structure
      • Partial path without the base directory - restores only the directories required without the base directories
      • Do not preserve directory structure - files are restored in the specified location without any sub-directoriesRetrieval destination
  9. Click the Retrieve button
  10. When complete you will see this:

    Retrieve complete.

Retrieving an archive from the command line


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


  1. Open a root command shell or use sudo
  2. Run your "dsmc retriev" command (see below) (include full path to dsmc if necessary)

Basic Syntax

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

DSMC Command options