KB Logo

TOLIS Group Knowledge Base

Browse KB by category:
Go to KB #:
Email   Bookmark

How do I restore a disk archive from the command line using BRU with BRU Server?

Views: 19212
Posted: 23 Oct, 2007

Restoring from BRU Server Using the Command Line

During a restore operation from a staged archive, the restore appears to fail and you receive a message that reads:

"BRU restore summary not seen from agent; Bad restore?"

This in most cases, this is caused by the BRU Server Agent disconnecting due to timing out prior to the restore process being performed by the BRU Server Server or BRU Server restored the files and is unable to confirm that they were restored successfully.  You should check the client system for the files to see if they have been restored or not before continuing.

If you find that the files have not been restored, rest assured that you can still restore your data using BRU's command line capabilities.  The following steps outline what is required to perform the manual restore when restoring from disk.  If you need assistance in this process when restoring from tape, visit KB article #131 - "Restoring from tape with BRU Server using the command line. How is this done?"


Please read completely through the steps below before beginning your restore process. In the commands below, please be aware of spaces, case sensitivity, etc.  This is known as "syntax" - missing letters, spaces, or other characters may result in errors in the command while performing the restore process and may cause the command to not function as desired.

1. You need to obtain a few things that are required to create the command for the BRU restore.  First you need to get the archive ID (from Data Manager -> Archives) for the archive from which you want to restore.  You will also need the full path of the file(s) you want to restore.  If you need to restore the desktop (icons, folders, files, etc.) for user 'bru-user' on Mac OS X , the path will be something like:


You also need to obtain the stage path for BRU Server stage disk.  This will be a path that is known to the person that setup the BRU Server Server system.  In the BRU Server Console for Mac OS X , this path can be found in the BRU Server Console Preferences.  For the BRU Server Console on Linux, this can be found under Tools -> System Parameters.

2. In the command line, you need to use the change directories command (cd) to the path where you want the files restored.  The files can only be restored to the local system with this process, they will then have to be copied to the remote system manually after the restore is complete.

cd /path/to/restore/files/to

3. Next, as the Root user (by using the 'sudo' command), you need to execute the following command to put everything that you've gathered all together:

sudo /usr/local/bru-server/bru -xvvvf "/stage_path/admin/ID" -PA "/stuff/to/restore/"

So, if you're trying to restore the 'bru-users' desktop from archive number '46b123cde964' that has a stage path of '/Volumes/Backups/' from the BRU Server 'admin' user, you're command would be:

sudo /usr/local/bru-server/bru -xvvvf "/Volumes/Backups/admin/46b123cde964" -PA "/Users/bru-user/Desktop/"

The above command needs to be one line. The "-PA" above tells BRU to restore the files in the current directory that you're running the command in, hence the reason that you must "cd" to the directory you want to restore to in step 2.  The stage path has the added 'admin' name because this is the 'admin' user of the BRU Server Server environment.  If you have multiple users and you're trying to restore a from "user1" stage archive, your stage path will then be:


If you would like to overwrite any existing files during your restore process, then you must add "-ua" after the "-PA" option.  Therefore, using the above examples for the stage path, archive ID, and files to restore, your restore command will look like:

sudo /usr/local/bru-server/bru -xvvvf "/Volumes/Backups/admin/46b123cde964" -PA -ua "/Users/bru-user/Desktop/"

NOTE: You will see a pair of messages reporting that the /etc/brutab file could not be read - this is normal and has no bearing on the restore that you are performing.  Additionally, this restore operation will only display information about the files selected for restore and will most likely take longer than 30 minutes since the original restore from within BRU Server timed out.  During this time, BRU will work silently, only displaying warnings or errors and then actual files/fodlers that match the paths you provided on the command line.  Please be patient.  If you would like to see the process and don't mind "watching the grass grow", you may increase the the verbosity level to 5 v's (the -xvvvf becomes -xvvvvvf).  This will display each file and folder as it is skipped because it does not match the restore selection.

If you have trouble with this command or questions, please contact Technical Support.

Others in this Category
document BRU Server uses internal tape ID numbering instead of the tape barcode, why?
document How do I move my BRU Server Environment from one server to another?
document Is it possible to use BRU for client-push backups?
document My Library or drive is not seen by BRU Server During the Hardware Scan, why not?
document My backup stalls shortly after starting, why?
» More Articles

Powered by KnowledgebasePublisher
Page Load Time: 0.037891 seconds / 37.891 milliseconds.
Page File Size: 28483 bytes.