Bucky Backup - How to retrieve archives from TSM

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
  

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:

Click on Retrieve above the text, "Retrieve an archive copy from long-term storage."

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 directory

Click the Retrieve button to retrieve your selections

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-directories
  

Click the Retrieve button

When complete you will see this:

Retrieving 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 retrieve" command (see below)

• Note: You may need to use "dsmc.exe" in place of "dsmc" in some Windows environments.
  

UNIX/Linux/Mac

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

• Specify the file(s) you would like to retrieve 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\*"
• Specify an alternate filename/directory for the retrieval (optional)
  
• If not specified it will be put in the original location
• C:\path\to\dir\
• /path/to/dir/newfilename.txt
• Use quotes if there are any spaces
• Retrieve files form a specific archive description (optional)
  
• -description="Description"
• This is recommended as a file could be contained in more than one archive object
• 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 retrieve from
• Enter the number to choose the file you want
• 
  

Examples

• Retrieve a file to its original location

• dsmc retrieve "C:\ArchiveTest\file to archive1.txt"

• Retrieve a file to a new location and new name

• dsmc retrieve "C:\ArchiveTest\file to archive1.txt" "C:\RetrieveTest\file to archive2.txt"

• Retrieve multiple files to original location
  

• dsmc retrieve "C:\ArchiveTest\*"

• Retrieve multiple files to different location
  

• dsmc retrieve C:\ArchiveTest\* C:\RetrieveTest\

• Retrieve a file from a specific archive

• dsmc retrieve "C:\ArchiveTest\file to archive1.txt" -description="Archive Test 3-11-2014 5YEARS"

• Retrieve directories with subfolders to original location
  

• dsmc retrieve "C:\ArchiveTest\*" -subdir=yes -description="Archive Test 3-11-2014 2YEARS"

• Retrieve a file using the pick option (see screenshot above)
  

• dsmc retrieve "C:\ArchiveTest\file to archive1.txt" -pick