File Restores Using IBM Spectrum Protect Client - Graphical User Interface

In this article

These instructions require you to have configured and backed up your data using the Data Protection service application, IBM Spectrum Protect.

Learn more about the Data Protection service offered by the Division of Information Technology.

Opening the Spectrum Protect client GUI (original system)

Graphical user interfaces (GUI) are similar between all platforms.


From a cmd command-line, use the following command:

C:\Program Files\Tivoli\TSM\baclient>dsm


For Linux, you will need an X Server to render the interface on your workstation. Presuming you have setup the X server on your workstation, run the command:


Mac OS

You can use the terminal utility to open a GUI:

sudo /Applications/IBM\ Spectrum\ Protect/IBM\ Spectrum\


Opening the Spectrum Protect client GUI (replacement system)

If you need to restore data from one system to another of the same operating system type, you will need to configure the IBM Spectrum Protect client on the replacement system to authenticate as the original system.

  1. You must have the node name and node password for the original system. If you do not have that information, request it by emailing Backup administrators will confirm your identity and authorization to restore files from the original system.
  2. Launch the GUI appropriate for your system using the command line options in the section Opening the Spectrum Protect client GUI (original system), but pass the following parameter to access data from the original system:
    -virtualnodename=<original name>
    For example, for Windows:
    C:\Program Files\Tivoli\TSM\baclient>dsm
  3. Enter the node password when prompted.


Navigate and restore a file

Once the GUI is opened and you see files from the system that you want to restore, follow the remaining procedures to restore files using the IBM Spectrum Protect Client GUI:

  1. Select Restore from the first splash screen.
    Restore option with a red border around the button.
  2. If restoring from the most recent backup data, navigate to the file location that needs a restore.
    File selected within the GUI.
  3. Click View > Display active/inactive files if you are locating an older version of backup data. This will switch to the active/inactive view of the navigation tree. 
    • The navigation tree will reset its view. Using the file-level branch, navigate to the original location of the missing file.
      View then display active/inactive files.
  4. In the active/inactive view, you will see all versions of every file backed up. Files with an (x) icon are older or deleted versions of backup files.
    List of backed up files with a red border around the older files.
  5. Select the files to restore and click Restore. Select the destination for restored objects.
    • Check the circle next the Original location option.
    • Or select a new location by clicking Following location.  The restore partial path is normally used. Select Restore complete path, Restore partial without base directory or Do not preserve directory structure depending whether you need directory structures or not.
      Restore destination menu with restore partial path option selected.
  6. Click Restore and view the restore report as it progresses.
    Restore progress report page.
  7. Once the restore is complete, navigate to the restore location to view the file.