Client Side Restores and Verification
Also see the following wiki documents:
NOTE: The images in this document are rather old and may not represent the look or location of the buttons in newer versions of the NetBackup client software.
Starting the Backup, Archive, and Restore console
Note: You may need Administrative or "root" privileges to perform some of these actions.
- Start the "Backup, Archive, and Restore" (BAR) application. If there is not a shortcut on the desktop, go to:
Window's button > All Programs > Symantec NetBackup > Backup, Archive, and RestoreOr for older versions it may be under:
Start > All Programs > VERITAS NetBackup > Backup, Archive, and Restore
- When first starting, You may get an error about not finding any backups. Simply acknowledge this and move on.
The GUI should look like this once it has loaded:
If the application has a sub-window inside the main window in the above picture, you will likely want to close the sub-window first before continuing.
Use the command line driven menu:
Or run the Java Admin Console from the system you want to do restores on:
This requires know-how for running X-windows applications
For simple verification purposes you can use this command instead:
For details on how to use this command see page 200 of the NetBackup Commands documentation.
Verifying the correct Servers and clients are listed
Navigate to the "Specify NetBackup Machines and Policy Type" popup window. To do this click on "File" then "Specify NetBackup Machines and Policy Type..."
In the "Specify NetBackup Machines and Policy Type" popup window the first thing is to verify the server list is correct. The first server in the list should be the NetBackup Master Server for the environment.
While still in the "Specify NetBackup Machines and Policy Type" popup window, next is to choose the client name. It is particularly important to make sure you choose the client name as it is configured for backups. For many systems the default should be correct; however, this becomes more critical with clustered environments where the server's name is not used for backups. In such cases you may need to contact the application owner to determine the name used for backups.
If the client is not in the list for selection, then you will need to click on the "Edit Client List" button and add it. After it is added, you will need to select it from the drop-down list as the "Source client for restores..."
Keep in mind that these settings can be used to re-direct restores of one system to a different system; if NetBackup has been configured to allow this action. If doing the restore from a "client" you must be logged into the destination client, or the server the data is to be restored to.
Verify that the "Policy Type for restores:" is correct, if not select the correct type. All Windows servers use the "MS-Windows" policy type. UNIX and VMS servers use the "Standard" policy type. For special backups, such as those using database agents, other restore methods may be required.
Now you can click on "OK" in the "Specify NetBackup Machines and Policy Type" window.
The concepts are all the same, but the Java Admin Console, and command-line utilities are laid only differently. Still they should be intuitive enough to understand.
Finding the Backup Dates and Files
Now click on the "Select for Restore" button. (If you accidentally click on the arrow at the side of this button, the selection you want is typically going to be "Restore from Normal Backup").
You can validate the client and server selections by looking at the top information bar on the window:
You should now see a selection of backup dates to chose from in the top cell, a directory structure on the bottom left cell, and a listing of files on the bottom right cell:
In the above picture, the blue circles represent differential-incrementals and the green represents a full backups.
Now choose the appropriate date(s) and file(s) from the GUI. When selecting dates, use the shift key to select a range, or the control key to select specific dates. If you pause too long between selections, the GUI will try to automatically refresh and cause you to wait between selections.
Notice in the above picture that a black line box is around all the individual backup images for the dates of July. 1st, 2011 back to the previous full done on June 25th, 2011. This represents choosing the Full (green circle) backups for that date, and all subsequent incremental backups for the following week. That means if the file existed while a backed was performed on any of those dates, we should be able to recover the copy as it looked at that point in time. You may even be able to select from a number of different versions of the same file if it was updated throughout the week, but this requires selecting the correct view.
In the picture below you can see the different option buttons that can be used to change the view or perform searches. In red are the selections for showing either the most recent version of a file, or all versions of a file. In yellow is the search button. You can also use the "Actions" and "View" menus in the menu bar to find these same features.
If you need to search for specific files you may click on the "binoculars" icon or go to Actions => Search Backups.
In the Search Backups window, enter either the folder that contains the file, or the file itself, that you are looking for and click on search. If necessary you might want to try changing the start and end dates to cover a longer series of possible backups dates for the data. Keep in mind the wider your search, the longer it will take to produce results.
Again, with UNIX the concepts are the same, but the layout is different. One of the main difference being that instead of having a graphical representation of the backup images, you instead get a pop-up window listing backup images to select from, or a calendar to chose a date range from.
Selecting a directory on the left, or one or more files on the right, will give you different results when performing a restore. The date range you have selected can also cause different results when selecting directories on the left. When selecting files, be aware of the backup date (try changing the view to show all file versions) as that will determine which copy or version of the file that will be restored.
When you have finished choosing the dates and files, just click on the restore button (circled in yellow below) or click on Actions -> Restored marked Files.
Now you will see the Restore Marked Files window. At this point you need to know which way you plan on going with the following:
Where should I put the files? Should I overwrite files that already exist?
For this example we are going to put the restore in a new folder. To avoid possible contention with existing files, it is recommended that you always put the files into a restore folder then move the file(s) to where you want them.
After you click "Start Restore" and the backup is initiated, you will see the box below, click on "Yes".
This is the progress monitor, it is suggested you view it in verbose mode. Take a close look at the initial output were it shows the "Media id"(s) "needed for the restore", and email the NOC with that information.
At this point, monitor the progress to ensure that the backup completes without error and if an error occurs, please notify the NetBackup Admins via a ticket and a detailed email to the appropriate distribution list.
A common reason restores may not finish, is due to the required tapes being off-site. You'll need to contact the NOC Operators and give them a list of ALL the tapes required for the restore (not just the one it's currently asking for).
Once the data has been verified after the restore completes, please email the NOC Operators that the restore is complete and the tapes can be sent offsite for storage.
If Any errors occur during the restore, the restore log on the client will be important to help identify the reason the restore failed. This log is no only specific to the server you are logged into, but also the user you are logged in as.
The main difference with Unix, using the Java console, is mainly just the display is laid out differently. If using the command-line, you will be prompted for a log file to save the restore progress too; typically this file get's put into your home directory.
Back to NetBackup