Restoring data with the HFS Spectrum Protect client

Below are instructions for restoring data using the Spectrum Protect graphical user interface (GUI).  Details are also available on using the Spectrum Protect client command line interface.

For the best advice please select the reason that you want to restore:

Expand All

If you are upgrading to a new machine, using the HFS Spectrum Protect backup/restore client software to move your data from one machine to another can be a convenient way to move your data.  If you can no longer access the data on your old machine (such as if it has been lost or stolen, or its hard drive is no longer working), then a restore is the way to get your data back.

The first thing to check is that you are moving data between two similar operating systems.  For example, moving data from a Windows 10 machine to a Windows 11 machine is not likely to be problematic; but the client does not support cross-platform restores, so you cannot restore Windows or Linux data to a Mac for example.  If you are moving between different types of operating systems please contact hfs@ox.ac.uk and let us know what you are trying to achieve; we will then advise you on the best course of action.

If you are moving between two similar Windows operating systems:

  1. If possible, ensure that you have an up-to-date backup of the old machine, this can be done by following the instructions for completing a manual backup.
  2. Ensure that the new machine is itself registered for the HFS Spectrum Protect backup service and that it has the Spectrum Protect client software installed and working.  This can be done by following our instructions on getting started.
  3. With both old and new machines registered, go to the HFS Portal.
  4. You should see your old node and new node, plus others if you have multiple nodes.
  5. Select your old node.
  6. Select the Details tab and make a note of the Server, Server IP name, and Server TCP port entries.
  7. Select List my nodes to return to the list of your nodes.
  8. Select your new node.
  9. Select the Details tab and make a note of the Server, Server IP name, and Server TCP port entries.
  10. If the server details are:

Nodes are on the same server

If both old and new nodes are registered with the same Spectrum Protect server:

  1. On the new machine, create a new shortcut on the desktop by right clicking on the Windows desktop and selecting New > Shortcut.
  2. Add the location below, replacing OLDNODE with the old node name
    "C:\Program Files\tivoli\TSM\baclient\dsm.exe" -virtualnodename=OLDNODE
  3. Name the shortcut something like "Temp Spectrum Protect Client"
  4. Double click on the new shortcut.
  5. When prompted, provide the Spectrum Protect password for your old node.
  6. You can follow the instructions for restoring files and folders, with the following limitations:
    • You will have to select Restore files to an alternative location.
    • You can not Restore files to their current location.

Nodes are on different servers

If both old and new nodes are registered with different Spectrum Protect servers:

  1. On the new machine, make a copy of the file dsm.opt within C:\Program Files\Tivoli\TSM\baclient\.
  2. Move the copied file from to the root C:\.
  3. Rename the moved to dsm-temp.opt.
  4. Open dsm-temp.opt in notepad:
  5. Replace the entry directly after TCPServeraddress with the Server IP Name noted earlier.
  6. Replace the entry directly after TCPPort with the Server Port noted earlier.
  7. Create a new shortcut on the desktop by right clicking on the Windows desktop and selecting New > Shortcut.
  8. Add the location below, replacing OLDNODE with the old node name
    "C:\Program Files\tivoli\TSM\baclient\dsm.exe" -virtualnodename=OLDNODE -optfile="c:\dsm-temp.opt"
  9. Name the shortcut something like "Temp Spectrum Protect Client", then Finish.
  10. Double click on the new shortcut.
  11. When prompted, provide the Spectrum Protect password for your old node.
  12. You can follow the instructions for restoring files and folders, with the following limitations:
    • You will have to select Restore files to an alternative location.
    • You can not Restore files to their current location.

Tidying up after restoring to a new machine

If you have restored to a new machine then there are some tasks that need to be completed: only perform these tasks when you have finished restoring data from the old node, and it is no longer required.

  • Tidying up the new node

If you created a dsm-temp.opt file then delete this file from the root of your C:\ drive.
If you created a temporary shortcut on your desktop (suggested name was Temp Spectrum Protect Client), delete the shortcut.

  • Tidying up the old node

If you are still able to access the machine, remove the Spectrum Protect client.
Deregister the old node using the deregistration instructions.

If you are moving between two similar Mac operating systems:

  1. If possible, ensure that you have an up-to-date backup of the old machine, this can be done by following the instructions for completing a manual backup.
  2. Contact hfs@ox.ac.uk, mentioning this web page, to ask the HFS Team to rename your filespace that you want to restore from.  This is so that you do not accidentally back up your new machine's data in the same filespace as that would mark your old, wanted data, for deletion.
  3. Once you have heard that the filespace has been set aside, you can proceed with the restore.
  4. You will need to access the old filespace for your node, for which you will need your Spectrum Protect password for the node. To obtain the password go to the HFS Portal, select the node name, then Change node password in the side menu.
  5. To restore the data from your backup to the new machine, you need install the Spectrum Protect client on your new machine.  Use the nodename of the account where your old data set is held.

  6. You can follow the instructions for restoring files and folders, with the following limitations:

    • You will be able to select Restore files to an alternative location.
    • Depending on the location of the files that you want to restore, you may not be able to Restore files to their current location.

Tidying up after restoring to a new machine

If you have restored to a new machine then there are some tasks that need to be completed: only perform these tasks when you have finished restoring data from the old node, and it is no longer required.

  • Tidying up the new node

Please contact hfs@ox.ac.uk when you are finished restoring and have backed up your new machine, so that the HFS Team know that they may delete the old data set.

  • Tidying up the old node

If you are still able to access the machine, remove the Spectrum Protect client.
Deregister the old node using the deregistration instructions.

If you are moving between two similar Linux operating systems:

  1. If possible, ensure that you have an up-to-date backup of the old machine, this can be done by following the instructions for completing a manual backup.
  2. Contact hfs@ox.ac.uk, mentioning this web page, to ask the HFS Team to rename your filespace that you want to restore from.  This is so that you do not accidentally back up your new machine's data in the same filespace as that would mark your old, wanted data, for deletion.
  3. Once you have heard that the old filespace has been set aside, you can proceed with the restore.
  4. You will need to access the old filespace for your node, for which you will need the Spectrum Protect password for the node. To obtain this go to the HFS Portal, select the node name, then Change node password in the side menu.
  5. To restore the data from your backup to the new machine, you need install the HFS Spectrum Protect client on your new machine.  Use the nodename of the account where your old data set is held.

  6. You can follow the instructions for restoring files and folders, with the following limitations:

    • You will be able to select Restore files to an alternative location.
    • Depending on the location of the files that you want to restore, you may not be able to Restore files to their current location.

Tidying up after restoring to a new machine

If you have restored to a new machine then there are some tasks that need to be completed: only perform these tasks when you have finished restoring data from the old node, and it is no longer required.

  • Tidying up the new node

Please contact hfs@ox.ac.uk when you are finished restoring and have backed up your new machine, so that the HFS Team know that they may delete the old data set.

  • Tidying up the old node

If you are still able to access the machine, remove the Spectrum Protect client.
Deregister the old node using the deregistration instructions.

If you have deleted a file from your machine that had previously been backed up then it may well still be available to restore.  Similarly, if you have modified and saved a file which has subsequently been backed up, then you may still be able to restore the earlier version of the file.

Access the Spectrum Protect restore window

  1. From the Windows Start menu search for backup, then launch Backup-Archive GUI.
  2. In the application, select the Restore link.

Access the Spectrum Protect restore window

  1. Run Applications > IBM Spectrum Protect > IBM Spectrum Protect Tools for Administrators > IBM Spectrum Protect
  2. When prompted, provide your local administrator password.

Access the Spectrum Protect restore window

  1. Run dsmj as root.

The restore window

  1. Select View > Display active/inactive files.
  2. When advised that Changing criteria will cause the current selections to be lost select Yes.
  3. You will now be able to see files both active and inactive files, inactive files have an x on their icon.
  4. Continue from the Restoring files section of Restoring files and folders

For more information on active/inactive files please see our FAQ item What are active and inactive files?.

Access the Spectrum Protect restore window

  1. From the Windows Start menu search for backup, then launch Backup-Archive GUI.
  2. In the application, select the Restore link.
  3. The restore window will appear, giving you a choice of areas to restore from.

Access the Spectrum Protect restore window

  1. Run Applications > IBM Spectrum Protect > IBM Spectrum Protect Tools for Administrators > IBM Spectrum Protect
  2. When prompted, provide your local administrator password.
  3. The restore window will appear, giving you a choice of areas to restore from.

Access the Spectrum Protect restore window

  1. Run dsmj as root.
  2. The restore window will appear, giving you a choice of areas to restore from.

The restore window

  1. Select the +  or small square next to File Level to expand it, then expand all other partitions from which you wish to restore data.

  2. Tick the grey boxes next to the files and folders you wish to restore (ticking a folder automatically selects all of its files and sub folders).

  3. If you cannot see some files you were expecting, they may be inactive (see Recovering previous versions or deleted data).

  4. If you plan to skip many files during the restoration process because they already exist in the chosen location, go to Options and tick the Disable No Query Restore method box. Failing to do so may lead to performance problems with the Spectrum Protect server.

  5. When you are happy with your selection, select the Restore button.
  6. You are now prompted to either restore to the original location or select a new location. If files which you have selected to restore are already present at the location chosen for restore, then Spectrum Protect will ask you, "File already exists – replace?".
  7. Task List window displays the backup process until the completion notification appears.
  8. Restore Report will now provide a brief summary:
    • The number of files inspected and restored should be identical.
    • Zero failed items indicates a successful restore of your data.
    • If the number of failed items is greater than zero, see the FAQ links below.

Get support


If you cannot find the solution you need here then we have other ways to get IT support

Get IT support