® VERITAS NetBackup™ Microsoft Windows User’s Guide Release 3.
© 1994 - 1999 VERITAS® Software Corporation. All rights reserved. Portions of this software are derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm. Copyright 1991-92, RSA Data Security, Inc. Created 1991. All rights reserved. TRADEMARKS VERITAS, VxVM, VxVA, VxFS, FirstWatch, and the VERITAS logo are registered trademarks of VERITAS Software Corporation in the United States and other countries.
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Backup and Archive Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 User Directed Backups and Archives . . . . . . . . . . . . . . . . . . . . . . . . . 2 Server Directed Backups and Archives . . . . . . . . . . . . . . . . . . . . . . . .
Start the Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Perform Backups or Archives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Perform Restores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 View the Status of a User Directed Operation . . . . . . . . . . . . . . . . . . . . . . 27 Advanced Restore Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
NetBackup Backup Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 Panes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 NetBackup Restore Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
NetBackup Backup Options Dialog Box . . . . . . . . . . . . . . . . . . . . . . . 94 Servers Property Sheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 Backups Property Sheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 NetBackup Restore Options Dialog Box . . . . . . . . . . . . . . . . . . . . . . . 98 Clients Property Sheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 Servers Property Sheet . . . . . . . . . . . . . .
bprestore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
viii NetBackup User’s Guide - Microsoft Windows
Preface This manual describes how to use NetBackup to back up and restore folders and files that reside on a Microsoft Windows PC. For specific information about the NetBackup Server software, refer to: • NetBackup Release Notes - UNIX, if you have a UNIX server, or • NetBackup Release Notes - Windows NT Server if you have a Windows NT server.
Organization This guide is intended primarily for administrators and users of Microsoft Windows PCs that are NetBackup clients. The guide will also be useful to system administrators of the NetBackup master server. It is arranged as follows: • Chapter 1, “Introduction” provides an overview of NetBackup, describes how the end user operates NetBackup, and describes technical terms and concepts. Read this chapter to become familiar with the world of NetBackup.
Related Documents Books The following documents provide related information. For a more detailed listing of NetBackup documents, refer to NetBackup Release Notes - UNIX or NetBackup Release Notes - Windows NT Server. If you have a UNIX server, refer to these documents: • NetBackup Release Notes - UNIX Provides important information about UNIX NetBackup server software, such as the platforms and operating systems that are supported and operating notes that may not be in the manuals or the online help.
Conventions The following explains typographical and other conventions used in this guide. Type Style The following table describes the typographic conventions used in this guide. Typeface Usage Examples courier Computer output; user input; names of commands, files, and directories You have mail. The mkdir command creates a new directory.
Command Usage The following conventions are frequently used in the synopsis of command usage. brackets [ ] The enclosed command line component is optional. Vertical bar or pipe (|) Separates optional arguments from which the user can choose. For example, when a command has the following format: command [arg1|arg2] the user can use either arg1 or arg2. Getting Help For license information or information about VERITAS service packages, contact VERITAS Customer Support.
xiv NetBackup User’s Guide - Microsoft Windows
Introduction 1 During installation, the NetBackup Browser is configured to work with a specific NetBackup client. When a user starts an operation using the NetBackup Browser, the browser software sends the appropriate messages to its designated NetBackup client. The software on the NetBackup client then communicates with the server and handles the client side of the operation.
1 Backup and Archive Operations A backup saves copies of selected files and folders from a NetBackup client to a storage device on a NetBackup master server or NetBackup slave server. An archive saves copies of selected files and folders to a storage device on a NetBackup master server or NetBackup slave server, then deletes the original files from the NetBackup client.
1 Cumulative-Incremental Backup When the NetBackup master server is configured to perform a cumulativeincremental backup, NetBackup backs up all files that have changed since the last successful full backup. Cumulative incremental backups can be configured to use either the datetime stamp or the archive bit. If the datetime stamp is used, the cumulativeincremental backup includes all files with a datetime stamp that are more recent than the last full backup.
1 Restore Operations A restore reads backups from the storage device on the NetBackup master server or the NetBackup slave server and restores them to the NetBackup client. NetBackup allows you to select a combination of files, folders with files, or entire drives to restore. File Permissions and Open Files File permissions require write permission on the destination folder in order to restore a file. A file will not be restored when a file with the identical name is open on the NetBackup client.
1 User Directed Restores You can start a restore operation at any time. Restored folders and drives include all files that were backed up or archived during a range of backups. NetBackup is also able to perform an alternate-client restore and a true image restore. Alternate Client Restore Files or folders, that were backed up or archived from one NetBackup client, can be restored to a different NetBackup client.
1 View Status You can view, print and delete status reports.
User Directed Operations 2 This section provides step-by-step instructions on using the NetBackup Browser to perform backups, archives and restores. For information on scheduled backups and other server directed operations, see the NetBackup System Administrator’s Guide - UNIX or NetBackup System Administrator’s Guide Windows NT Server.
2 Start the Browser 1. Start the NetBackup Browser. a. Click the Windows Start menu. b. Click Programs, NetBackup, NetBackup - Client. The Backup, Archive, and Restore - NetBackup window will appear. t Toolbar For most operations, it is easier to use the buttons on the toolbar. The horizontal toolbar on the Backup, Archive, and Restore - NetBackup window opens windows to browse for backups or restores and to view the progress report of a NetBackup operation.
2 t Helpful Hints Marking Files and Folders • Select the folder mark circle to mark a folder and all its files and subfolders for a NetBackup operation. The folder mark circle will appear filled. • Select the file mark circle to mark a file within a folder, or to mark a sub folder within the folder. The folder mark circle will appear half filled when only some files or subfolders are marked.
2 Perform Backups or Archives This section includes a tutorial. It walks you through a simple backup of the README.TXT file installed in the NetBackup folder. 1. Start NetBackup as described in "Start the Browser" on page 8. The Backup, Archive, and Restore - NetBackup window should appear. 2. Open the NetBackup Backup window. There are two ways to open the NetBackup Backup window. • Click Backup Files and Folders on the Actions menu.
2 The NetBackup Backup window will appear.
2 3. Mark a file to backup. a. Open the VERITAS\NetBackup folder. b. Find the README.TXT file and click the mark circle to the left of the item. 4. Start the backup operation. a. Open the Backup Marked Files dialog box. There are two ways to open the Backup Marked Files dialog box • Click Backup Marked Files... on the Backup menu.
2 • Click Backup on the NetBackup Backup window vertical toolbar. The Backup Marked Files dialog box will appear. b. Review your selections in the Name list box. • If the README.TXT file is not listed, click Cancel. This will return you to the NetBackup Backup window. Repeat Step 3 on page 8. • If the README.TXT file is listed, go to Step 3c.
2 c. Enter a keyword in the Keyword Phrase to Associate With the Backup (Optional) box. In this example use test as the keyword. d. Click Start Backup. The backup request goes to the NetBackup master server. A NetBackup message will indicate that the backup was successfully started.
2 e. Click Yes on the NetBackup Message dialog box to open the View Status dialog box. The View Status dialog box allows you to view the progress report of a NetBackup operation. f. Enter a refresh rate of 10 to update both panes every 10 seconds. The Progress pane will reflect the progress of the item selected in the top pane. Only the selected item in the top pane is updated. The NetBackup operation is finished when the Operation Status changes to Successful.
2 Perform Restores This section walks you through a simple restore of the README.TXT file backed up in "Perform Backups or Archives" on page 10 of this manual. 1. Start NetBackup as described in "Start the Browser" on page 8 of this tutorial. 2. Open the NetBackup Restore window. There are two ways to open the NetBackup Restore window. • Click Restore, then Restore from Backup on the Actions menu. or • Click Browse Restore on the Backup, Archive, and Restore - NetBackup window vertical toolbar.
2 The NetBackup Restore window will appear. There may be a delay before lists appear in the NetBackup Restore window. NetBackup has to obtain the file information from the catalogs on the NetBackup master server. If files or folders do not appear in the NetBackup Restore window, it can be due to one of the following: • Perform Default Search: is not enabled on the General property sheet. In this case, start a search manually by clicking Search Backups... on the Restore menu.
2 • The NetBackup server does not have any backups of files for your client. Ensure that the client is connecting to the correct server (see "Servers Property Sheet" on page 71). Also, ensure that you are using the correct client name (see "Clients Property Sheet" on page 73). You can also refer to the title bar. If these settings are correct and you believe there are backups available, contact your system administrator. 3. Select a file to restore.
2 • Click Search Backups on the vertical toolbar. The Search Backups dialog box will appear.
2 b. Type the path to the backed up file in the Search Folder: box. For this example we will enter C:\VERITAS\NetBackup\. c. Type test in the Keyword Phrase (Optional): box.
2 d. Press Search. NetBackup will display the tree to the lowest levels of folders which contain files that were backed up.
2 e. Select the mark circle to the left of the README.TXT file. Notice that the mark circles in the All Folders pane are half-filled.
2 4. Start the restore operation a. Open the Restore Marked Files dialog box. There are two ways to open the Restore Marked Files dialog box • Click Restore Marked Files... on the Restore menu.
2 • Click Restore from the vertical toolbar. The Restore Marked Files dialog box will open.
2 b. Select the Overwrite Existing Files checkbox. c. Click Start Restore to start the restore operation. A NetBackup message will indicate that the restore was successfully started. d. Click Yes on the NetBackup Message box to open the View Status dialog box. The View Status dialog box allows you to view the progress report of a NetBackup operation.
2 e. Enter a refresh rate of 10 to update both panes every 10 seconds. The Progress pane will reflect the progress of the item selected in the top pane. Only the selected item in the top pane is updated. The NetBackup operation is finished when the Operation Status changes to Successful. Note: The NetBackup operation may take a few minutes to complete. After starting a restore operation, you can close the NetBackup browser and perform other tasks on your computer.
2 View the Status of a User Directed Operation 1. Open the View Status dialog box to check the progress report. There are two ways to open this dialog box. • Click the View Status button on the toolbar in the Backup, Archive, and Restore - NetBackup window. or • Press Alt-a to open the Actions menu and then click View Status.... The status will appear in the top pane under Operation Status.
2 If you require more details on the netbackup operation, follow these instructions. a. Select one of the NetBackup operations in the Operations List. The Progress box will display the progress report of the selected operation. b. Click Refresh to update the report. 2. Click Close to return to the previous window.
2 Advanced Restore Procedures The following is a detailed explanation of how to perform advanced restores. Selecting Specific Backup Dates to Restore By default, the NetBackup Restore window shows the files and folders that were backed up from the time of the last full backup to the most-recent backup. If the client belongs to more than one 1class, the default display starts with the last full backup that occurred first. For example, assume that the client belongs to ClassW1 and ClassW2.
2 Search Procedure 1. Open the NetBackup Restore window. 2. Click Show All Backups on the View menu to display all copies of files and folders from all of the backups. Show Most Recent Backup will display the most recent copy of the file or folder. 3. Select the images, from the NetBackup History pane, that you believe contain the files and folders you want to restore. 4. Narrow the search range as much as possible to speed up your search. • Select a specific backup image in the NetBackup History pane.
2 6. Enter the search path that you want NetBackup to use in its search for files and folders. The number of files you can list during a search is limited by the amount of free memory you have on your computer. If you reach the limit, modify the date or file path parameters to narrow the scope of the search. By default, the search dialog box shows the information for the folder that is currently selected in the All Folders pane of the NetBackup Restore window. 7. Click Search to start the search.
2 Restore an Earlier Version of a Folder Note: This procedure will restore all files that were backed up during the range of backup dates. This includes files that were deleted from your on-line folder after they were backed up. If you do not want the deleted files, refer to "Restoring a True Image of a Folder" on page 34. 1. Open the NetBackup Restore window. 2. Open the backup NetBackup History pane. If the NetBackup History pane is not open, click and drag the horizontal splitter bar down. 3.
2 b. Enter a filename or keyword. c. Click Search to start the search. When the search is complete, the NetBackup Restore window updates. 4. Select the folder you want to restore from the folder in the All Folders pane of the NetBackup Restore window. 5. Mark the files or folders you need in the Contents of ’’ pane. By default, NetBackup restores files and folders to their original location. 6. Click Restore Marked Files... on the Restore menu.
2 Restoring a True Image of a Folder You can restore a true image of a folder only if the NetBackup class that is backing up your files and folders is configured to collect true image restore information prior to backup. If in doubt, ask your NetBackup administrator. 1. Open the NetBackup Restore window. If you get a No Entity Found message at this point, notify the administrator. The TIR option on the NetBackup server must be set before you can perform a true image restore.
2 Note: When a file in the folder has the same filename as a file in the true image backup, NetBackup will delete the file from the folder and replace, or restore, the file from the true image backup. NetBackup will not delete files from the folder that are not in the true image restore. 6. Click Restore Marked Files... on the Restore menu.
2 Restoring All Files, Folders, or Registry Keys to an Alternate Path 1. Open the NetBackup Restore window. 2. Select README.TXT from the NetBackup folder. 3. Click Restore Marked Files... on the Restore menu. The Restore Marked Files dialog box will appear. 4. Click Restore Everything To a Different Location (maintaing existing structure):. 5. Enter the folder from which the README.TXT file was backed up in the Source:. In this case: c:\VERITAS\netbackup\ 6.
2 Restoring Specific Files, Folders, or Registry Keys to an Alternate Path 1. Open the NetBackup Restore window. 2. Select the NetBackup folder. 3. Click Restore Marked Files... on the Restore menu. The Restore Marked Files dialog box will appear. 4. Click Restore Individual Folders and Files To Different Locations (double-click to modify):. 5. Select the files, folders, or registry keys you want to restore. a. Double click the README.TXT.
2 b. Type a new path to restore to. or Click the Browse button to browse for and select a new path to restore to. In this case, we are going to restore to c:\temp. c. Press OK. The Enter New Destination dialog box will close. The new path entered in Step b will appear in the Destination column. d. Repeat these steps for each file, folder, or registry key you want to restore 6. Select Overwrite Existing Files. 7. Click Start Restore. NetBackup will restore the README.TXT file to the specified path.
2 Restore Using a Temporary Filename 1. Open the NetBackup Restore window. 2. Select README.TXT from the NetBackup folder. 3. Click Restore Marked Files... on the Restore menu. The Restore Marked Files dialog box will appear. 4. Select Restore the File Using a Temporary Filename. 5. Click Start Restore. NetBackup will restore the README.TXT file to READMEXXXXXX.TMP. XXXXXX will be something that is generated based on the current date and time.
2 Proxy Restore 1. Open the NetBackup Restore window. a. Click Restore, then Proxy Restore from Backup from the Actions menu. A Browse for Computer dialog box will appear. b. Select the computer whose backup image you want to restore from. For this tutorial we will select a computer called pansy. A NetBackup Restore window will appear.
2 2. Select README.TXT from the NetBackup folder. 3. Open the Restore Marked Files dialog box. 4. There are two ways to open the Restore Marked Files dialog box. • Click Restore Marked Files... on the Restore menu. or • Click Restore from the vertical toolbar.
2 The Restore Marked Files dialog box will open. 5. Select Overwrite Existing Files. 6. Click Start Restore. NetBackup will restore the README.TXT file to the c:\temp folder.
Reference 3 This chapter provides reference information on the NetBackup Browser. It includes a description of the Browser menus, windows and dialog boxes.
3 NetBackup Icons The following table describes NetBackup icons you may see on the Microsoft Windows desktop. Description Represents NetBackup. It is used on the title bar in the Browser, in the program start menu, and Windows Explorer. Indicates that the NetBackup Client Job Tracker is running, but there are currently no backups or restores processing. Used in the system tray. Indicates that the NetBackup Client Job Tracker is running, with at least one restore processing. Used in the system tray.
3 Menus This section explains the menu bar commands on the NetBackup Browser. Actions Menu The commands on the Actions menu provide overall control of your NetBackup session. Backup Files and Folders Opens the NetBackup Backup window. From this window, you can select files, folders, or registry keys to back up and then start a backup or archive operation. Restore... Opens the submenu and provides access to the following commands. Restore from Backup Opens a NetBackup Restore window.
3 Proxy Restore from Backup This feature allows a user on a Windows NT machine to browse the backups of the local Windows NT machine. The remote user can select files, folders, or registry keys from the backup and restore to the remote machine. NetBackup will see all the requests as if they were coming from the remote Windows NT machine. Proxy Restore from Archived Backup This feature allows a user on a Windows NT machine to browse the archive backup of the local Windows NT machine.
3 Edit Menu The commands on the Edit menu modify your selections in the currently selected backup or restore window. It appears when the NetBackup Backup window or the NetBackup Restore window are opened. Mark Displayed Files Marks only the files, folders, or registry keys that currently appear in the Contents of ’’ pane of the NetBackup Backup window or NetBackup Restore window.
3 View Menu The commands on the View menu control the contents of the NetBackup Backup window and the NetBackup Restore window. During a backup or archive operation, the following menu will appear. During a restore operation the following menu will appear.
3 Options... Opens the Options dialog box. Go to "Options Dialog Box" on page 82" for more details. Save Settings on Exit When selected, this command will save window specific settings upon exit. Brief Descriptions of Files Shows files, folders, or registry keys without details. You can also execute this command on the NetBackup Backup window toolbar and on the NetBackup Restore window toolbar. Full Descriptions of Files Shows file, folder or registry key details such as size and file permissions.
3 Backup Menu The Backup menu appears when the NetBackup Backup window is active. The commands on the Backup menu control backup operations. 50 Backup Marked Files... Opens the Backup Marked Files dialog box. You can also execute this command by clicking Backup on the NetBackup Backup window toolbar. Specify NetBackup Machines... Opens the NetBackup Backup Options dialog box to the Servers property sheet. Refer to "NetBackup Backup Options Dialog Box" on page 94 for more details. Options...
3 Restore Menu The Restore menu appears when the NetBackup Restore window is active. The commands on the Restore menu control restore operations. Search Backups... Opens the Search Backups dialog box. You can also execute this command by clicking Search Backups on the NetBackup Restore window toolbar. Restore Marked Files... Opens the Restore Marked Files dialog box. You can also execute this command by clicking Restore on the NetBackup Restore window toolbar. Select Restore Type...
3 Proxy Archive Backups This feature allows a user on a Windows NT machine to browse the archives of the local Windows NT machine. The remote user can select files, folders, or registry keys from the backup and restore to the remote machine. NetBackup will see all the requests as if they were coming from the remote Windows NT machine. Proxy Raw Partition This feature allows a user on a Windows NT machine to browse Backups the raw partition backups of the local Windows NT machine.
3 Window Menu The Window menu has commands for arranging your NetBackup windows. It appears when the NetBackup Backup window or the NetBackup Restore window is opened. Cascade Arranges NetBackup windows so they overlap, but the title bars will still be visible. Tile Horizontally Modifies the size of NetBackup windows and arranges them horizontally on the desktop. Tile Vertically Modifies the size of NetBackup windows and arranges them vertically on the desktop.
3 Help Menu This menu provides access to the on-line instructions for using NetBackup.
3 Windows This section explains the windows on the NetBackup Browser. NetBackup Window Icons This section describes all icons displayed in the windows. Description Icon Represents NetBackup. It is used on the title bar in the Browser, in the program start menu, and Windows Explorer. Represents a backup. It is used on the title bar of the backup window. Represents a restore. It is used on the title bar of the restore window. Represents a floppy drive. Used in the All Folders pane.
3 Description Represents a file or a folder, with all of its contents, that has been marked for backup or restore. Used in the All Folders pane and the Contents of ’’ pane. Represents a folder with some of its contents marked for backup or restore. Used in the All Folders pane and the Contents of ’’ pane. Represents a file or folder that has not been marked for backup or restore, but could be. Used in the All Folders pane and the Contents of ’’ pane.
3 Description Icon Represents the entire network. Used in the All Folders pane. Represents a specific network. Used in the All Folders pane and the Contents of ’’ pane. Represents a domain within a network. Used in the All Folders pane and the Contents of ’’ pane.
3 Backup, Archive, and Restore - NetBackup Window This window appears when you start NetBackup. Button Description Opens the NetBackup Backup window. Opens the NetBackup Restore window. Opens the View Status dialog box.
3 NetBackup Backup Window This window shows the files, folders, or registry keys you can mark for back up. Access this window: • From the Actions menu, click Backup Files and Folders • From the toolbar, click Browse Backup You can position this window separately. You can also cascade, tile or minimize the window by using commands from the Window menu.
3 Buttons Button Description Opens the Backup Marked Files dialog box. Unmarks all files, folders and registry keys in this window. You can also execute this command by selecting Unmark All from the Edit menu. Opens the Preview List dialog box during a backup operation. You can also execute this command by selecting Preview List of Marked Files... from the Edit menu. Shows files and folders only. You can also execute this command by selecting Brief Descriptions of Files from the View menu.
3 NetBackup Restore Window This window shows the files, folders, or registry keys that you can mark for restore. Access this window: • From the Actions menu, click Restore, then Restore from Backup • From the toolbar, click the Browse Restore The folder trees in this window contain only files and folders that were backed up. You can position this window separately. You can also cascade, tile or minimize the window by using the command from the Window menu.
3 Buttons Button Description Opens the Search Backups dialog box. Opens the Restore Marked Files dialog box. Unmarks all files, folders, or registry keys in this window. You can also execute this command by selecting Unmark All from the Edit menu. Opens the Preview List dialog box during a restore operation. You can also execute this command by selecting Preview List of Marked Files... from the Edit menu. Shows files and folders only.
3 Panes The NetBackup Restore window is split into three panes: the NetBackup History pane on the top, the All Folders pane on the left and the Contents of ’’ pane on the right. Note: If the client belongs to more than one class, the default display starts with the last full backup that occurred first. For example, assume that the client belongs to Class A and Class B and full backups occur for both of them.
3 NetBackup History Pane The NetBackup History pane shows the NetBackup image(s). When first opened, the following backup images are selected by default: • The most recent full backup. • All cumulative-incremental backups and differential-incremental backups since the most recent full backup. • All user directed backups that have occurred since the most recent full backup. If there is no full backup, only the most recent image will be selected.
3 t Backup History as a Timeline To show the NetBackup History pane as a timeline from the View menu, click Options... to open the Options dialog box. Select Show Backup History as a Timeline checkbox. The icons, representing images, appear directly underneath the date of the backups. Icons with a square represent selected backup images. Several backup image icons may appear below a date. The most current backup image is on top of the list.
3 t Backup History as a Detailed List To show the NetBackup History pane as a detailed list, clear the Keep Status of User-Directed Backups, Archives, and Restores For: checkbox on the Options dialog box. The list starts with the most recent backup and includes the following information (reading from left to right). • Date and time when the backup occurred. • Date when NetBackup will expire the backup and delete it from the NetBackup History pane. • Number of files in the backup.
3 NetBackup Configuration Dialog Box This section explains the property sheets found on the NetBackup Configuration dialog box on the NetBackup Browser. General Property Sheet To access this property sheet: 1. From the Actions menu, select Configure.... 2. Click the General tab to open the property sheet. Use this property sheet to set any of the configuration parameters for your client. Only the system administrator should change the following parameters.
3 System administrators should refer to "General Property Sheet" on page 115 for details on these parameters. The NetBackup client user as well as the system administrator can change following parameters. Client Name: Specify the name of your client. This name is used when backing up, archiving and restoring files, folders, or registry keys. It must match the one in the NetBackup server class configuration.
3 Exclude List Property Sheet Only the system administrator should change the parameters on this property sheet. System administrators should refer to "Exclude List Property Sheet" on page 119 for details on these parameters.
3 Include List Property Sheet Only the system administrator should change the parameters on this property sheet. System administrators should refer to "Include List Property Sheet" on page 121 for details on these parameters.
3 Servers Property Sheet To access this property sheet: 1. From the Actions menu, select Configure... 2. Click the Servers tab to open the property sheet. Use this property sheet to add new NetBackup servers and to specify the default master server for clients. Note: Most changes made to the this property sheet will not apply to currently open backup or restore windows. If, however, a server is added, the open windows will be able to switch to them.
3 72 New Server Name: To add another NetBackup server to the Server List:, type the name of the new server in the New Server Name: text box and click Add. The name must be as defined by the system administrator on that server. Add Adds the server, entered in the New Server Name: text box, to the Server List:. Server List: Shows the names of the NetBackup servers that require access to the client. The master server and any slave servers must appear in this list.
3 Clients Property Sheet To access this property sheet: 1. From the Actions menu, select Configure... 2. Click the Clients tab to open the property sheet. Use this property sheet to specify the name of the client whose backups you want to browse for files, folders, or registry keys to restore. You can also add names of remote clients. Note: Most changes made to the this property sheet will not apply to currently open backup or restore windows.
3 74 New Client Name: To add another client name to the Client List:, type the name of the client in the New Client Name: and click Add. The client name entered must also be defined in a class on the NetBackup server. Add Adds the client, entered in the New Client Name: box, to the Client List:. Client List: The Client List: contains the client name for your computer. It can also contain the names of remote NetBackup clients.
3 Backups Property Sheet To access this property sheet: 1. From the Actions menu, select Configure... 2. Click the Backups tab to open the property sheet. Use this property sheet to specify specific class and schedules to use when you start a backup from the client. Note: Changes made to the this property sheet will not apply to currently open backup window. The changes will apply to all backup window opened after the property sheet modifications have been saved.
3 76 Backup Class: Specify the class to use for user-directed backups of this client. If you set this value to any (default), NetBackup uses the first class that it finds with both the client name and a user-directed backup schedule. Backup Schedule: Specify the schedule to use for the user-directed backups for this client.
3 Network Property Sheet Only the system administrator should change the parameters on this property sheet. System administrators should refer to "Network Property Sheet" on page 123 for details on these parameters.
3 Virus Protection Property Sheet To access this property sheet: 1. From the Actions menu, select Configure.... 2. Click the Virus Protection tab to open the property sheet. Use this property sheet to configure the NetBackup client to pre-scan data before it is backed up. By default, virus scanning is turned off. Note: The changes and options in this dialog box do not apply to any open windows. The values are set on a machine basis.
3 Backup Infected Files Select this option to include infected files in the backup. However, backing up infected files is not recommended. The data still contains the virus when restored to another system. The activity log is updated with the infected file name and its associated virus name. Perform Virus Select this option to perform virus scanning and detect any Scanning for Restore infected files. NetBackup does not attempt to correct or restore the infected files.
3 Limitations Files with the following conditions are not scanned for viruses: • Fully qualified file names longer than 256 characters • Compressed or zipped files • Open files that are locked Suggestions Running another anti-virus software, while running NetBackup with the virus scanning option enabled: • may slow down the NetBackup's virus scanning operation • result in unnecessary alerts or unexpected warning message boxes New viruses constantly appear, so it is important to keep the protection signatur
3 Troubleshooting Property Sheet Only the system administrator should change the parameters on this property sheet. System administrators should refer to "Troubleshooting Property Sheet" on page 124 for details on these parameters.
3 Dialog Boxes This section describes the dialog boxes on the NetBackup Browser. Options Dialog Box To access this dialog box, select Options... from the View menu. Use this dialog box to control display options on the NetBackup Browser. Show Toolbar Shows the NetBackup toolbars. Show Tool Tips Shows tool tips. When the mouse pointer moves over the different elements of the NetBackup Browser, the tool tips appear. Show Status Bar Shows the NetBackup status bar.
3 Preview List Dialog Box Access this dialog box: • From the NetBackup Backup window, select Preview List of Marked Files.... The following will appear. • From the NetBackup Restore window, select Preview List of Marked Files.... The following will appear. • From the Edit menu, select Preview List of Marked Files.... The Preview List dialog box which appears depends upon the backup or restore window currently selected.
3 Use this dialog box to view all of the files, folders, or registry keys you have marked. This is a view-only dialog box. Name Lists the file or folder being restored. Time Backed Up Lists the time the backup was initiated. 84 Time Modified Lists the time that the file or directory, that was backed up, was changed. Close Closes the dialog box. Close does not terminate NetBackup or affect other dialog boxes or windows. Help To view on-line help for this dialog box, click this button.
3 View Status Dialog Box Access this dialog box: • From the Actions menu, select View Status.... • From the toolbar on the Backup, Archive, and Restore - NetBackup window, click View Status.
3 Use this dialog box to view the results of each user operation in a progress report. Operations List Lists operation status reports for NetBackup operations. The most current NetBackup operation is on top of the list. By default NetBackup operation status reports will be stored on your computer for three days. Refer to "General Property Sheet" on page 67 for more information on changing the Keep Status of User-Directed Backups, Archives, and Restores For: configuration setting.
3 Print... Opens the Microsoft Windows print dialog box and prints out the progress report for the selected NetBackup operation. Progress Displays the progress of the selected operation. To update the display every ten seconds, set the Refresh Rate (seconds): parameter to 10. If the Refresh Rate (seconds): parameter is not set, the user can click Refresh to view the progress of the selected NetBackup operation.
3 Search Backups Dialog Box Access this dialog box: • From the NetBackup Restore window toolbar, select Search Backups • From the Restore menu, select Search Backups... Use this dialog box to narrow the backup history search parameters for your restore.
3 Search Folder: Shows the folder or registry key for which you are searching. The initial value for the Search Folder: is ":\". If you select a folder in the NetBackup Restore window, that folder becomes the new default. To change the path, enter a new value and press Return. If you enter a full path name, NetBackup will search for the specific path and file in the selected backup images. Or you can enter only the filename (csb.tmp or *.
3 90 Cancel To cancel and return to the previous display without accepting changes to the parameters in this dialog box, click this button. Help To view on-line help for this dialog box, click this button.
3 Backup Marked Files Dialog Box This dialog box appears after you have initiated a backup or archive. Use this dialog box to view your selections before proceeding with the operation. List box Contains a list of objects to be backed up. Archive Files (Delete Select to perform an archive instead of a backup. Files or folders Files After Successful will be deleted after they have been backed up successfully.
3 Restore Marked Files Dialog Box This dialog box appears after you have initiated a restore operation. Use this dialog box to view your selections before proceeding with the operation. If the list is longer than the list box, a vertical scroll bar appears along the right edge of the pane. Restore Destination Choices This pane contains radio buttons which determine the destination for restored files. The user must choose one of the radio buttons in the pane.
3 Browse This button is enabled when the Restore Individual Folders and Files To Different Locations (double-click to modify): checkbox is selected. Click this button to open the Browse for Folder dialog box. Restore Individual Folders and Files To Different Locations (doubleclick to modify): Restore Options Restore files, folders, or registry keys to an alternate path on a file by file, folder by folder, or registry key by registry key basis. The default is to restore to the original path.
3 NetBackup Backup Options Dialog Box This dialog box appears when you select Specify NetBackup Machines... from the Backup menu. Servers Property Sheet To access this dialog box, open the Backup menu, select Specify NetBackup Machines..., then select the Servers tab to open the property sheet. Use this dialog box to change the current master server. 94 New Server Name: To add another NetBackup server to the Server List:, type the name of the new server in the New Server Name: text box and click Add.
3 Server List: Shows the names of the NetBackup servers that require access to the client. The master server and any slave servers must appear in this list. The master server manages user operations and must be marked as CURRENT. To mark a master server as CURRENT, select a server from the Server List: and click Make Current. The word CURRENT appears in parentheses beside the name of the new master server. Remove Removes a server. First highlight the server in the Server List:, then click Remove.
3 Backups Property Sheet To access this dialog box, open the Backup menu, select Specify NetBackup Machines..., then select the Backups tab to open the property sheet. Use this dialog box to select the backup class and the backup schedule for the selected backup window. Note: Modifications will only affect the current window. 96 Backup Class: Specify the class to use for user-directed backups of this client.
3 Archive Schedule: Specify the user-directed archive schedule to use for user-directed archives of this client. If you set this value to any (default), NetBackup uses the first user-directed archive schedule in the first class that it finds with both the client name and a user-directed archive schedule. OK To accept changes to the parameters, click this button. Cancel To cancel and return to the previous display without accepting changes to the parameters in this dialog box, click this button.
3 NetBackup Restore Options Dialog Box Clients Property Sheet To access this dialog box, open the Restore menu, select Specify NetBackup Machines..., then select the Clients tab to open the property sheet. Use this dialog box to select the remote client whose backups you want to restore to your client. 98 New Client Name: To add another client name to the Client List:, type the name of the client in the New Client Name: and click Add.
3 Client List: The Client List: contains the client name for your computer. It can also contain the names of remote NetBackup clients. You can select local or remote NetBackup clients on which to perform NetBackup operations. The NetBackup server administrator must set up the required permissions before you can browse and restore from any remote client. To perform a NetBackup operation on a NetBackup client, select the name from the Client List: and click Make Current.
3 Servers Property Sheet To access this dialog box, open the Restore menu, select Specify NetBackup Machines..., then select the Servers tab to open the property sheet. Use this dialog box to change the current master server. 100 New Server Name: To add another NetBackup server to the Server List:, type the name of the new server in the New Server Name: text box and click Add. The name must be as defined by the system administrator on that server.
3 Remove Removes a server. First highlight the server in the Server List:, then click Remove. Make Current Designates a master server. First highlight the server in the Server List:, then click Make Current. Changing the current server will affect only the selected window. This setting will not be saved after the currently selected window is closed. OK To accept changes to the parameters, click this button.
3 NetBackup Client Job Tracker Dialog Box To open the NetBackup Client Job Tracker dialog right click on the NetBackup Client icon in the system tray and select Details. If Details is disabled, there have not been any backups or restores since the NetBackup Client Job Tracker was started. If the NetBackup Client icon is not in the system tray, see "Start the Browser" on page 8 for information on starting the Job Tracker.
3 Job Tracker only reports on the status of a backup as it is running on the client. Once a backup is sent to the NetBackup Server, it will not update the status of that job. Example: the client sends all of the data to be backed up to the server successfully. It reports the backup status as successful. Later an error occurs on the server which causes the backup to fail, the status shown by the Job Tracker is not updated. Job ID Displays the NetBackup Job ID.
3 KBytes Data 104 Displays the total amount of data, in kilobytes, to be processed by the NetBackup operation. This is rounded to the nearest whole number, so it is possible this number may be 0 if the number of bytes being backed up is less then 500. Previous Shows the operating status of the previous NetBackup operation in the queue. Next Shows the operating status of the next NetBackup operation in the queue. OK Closes the NetBackup Client Job Tracker dialog box.
System Administrator A This section contains information for the NetBackup Administrator.
A Free Browse The Free Browse feature allows users without restore privileges to restore from scheduled backups. In previous versions of NetBackup, when a scheduled backup was performed by a system administrator using a root user id, the client user was not able to restore from that backup. The Free Browse feature allows the user to use a scheduled backup to restore files. The user will be able to restore only those files to which they have write access.
A The following table displays the different combinations. NetBackup Client NetBackup Server Use ’Free Browse’ Deny Deny Deny Allow Allow Allow Use Use Use Deny Allow Use Deny Allow Use Deny Allow Use No No No No No Yes No Yes Yes The Free Browse feature will only be used when either the NetBackup client or the NetBackup server has been configured to Use it, and neither have been set to Deny it. By default, all users get the Allow privilege.
A 2. Set the user share permissions on each key. 3. Enter a data value for each key with the name of Flag (type = DWORD). Only when a key has a non-zero Flag value will that privilege be turned on. If both of the Flag values are zero, then all users will get the Allow privilege. For example: • If USERA has read access to the Deny key and the Flag value is non-zero, then USERA will get the Deny privilege.
A NetBackup Restore Options for System Administrators When the NetBackup Restore Options dialog box is opened on a NetBackup Browser running on a master or slave server, three property sheets are displayed: • Servers • Source Clients • Destination Clients Servers Property Sheet System Administrator 109
A To access this dialog box, open the Restore menu, select Specify NetBackup Machines..., then select the Servers property sheet. Use this dialog box to change the current master server. 110 New Server Name: To add another NetBackup server to the Server List:, type the name of the new server in the New Server Name: text box and click Add. The name must be as defined by the system administrator on that server.
A Source Clients Property Sheet To access this dialog box, open the Restore menu, select Specify NetBackup Machines..., then select the Clients property sheet. Use this dialog box to select select the client whose backups you want to restore. New Client Name: To add another client name to the Client List:, type the name of the client in the New Client Name: and click Add. The client name entered must also be defined in a class on the NetBackup server.
A 112 Make Current Designates the client backup images you can browse for restore operations. First highlight the server in the Client List:, then click Make Current. Changing the current client will affect only the selected window. This setting will not be saved after the currently selected window is closed. OK To accept changes to the parameters, click this button. Cancel To cancel and return to the previous display without accepting changes to the parameters in this dialog box, click this button.
A Destination Clients Property Sheet To access this dialog box, open the Restore menu, select Specify NetBackup Machines..., then select the Clients property sheet. Use this dialog box to select the client which will receive the restored backups. New Client Name: To add another client name to the Client List:, type the name of the client in the New Client Name: and click Add. The client name entered must also be defined in a class on the NetBackup server.
A 114 Make Current Designates the client that will receive the restore operations. First highlight the server in the Client List:, then click Make Current. Changing the current client will affect only the selected window. This setting will not be saved after the currently selected window is closed. OK To accept changes to the parameters, click this button. Cancel To cancel and return to the previous display without accepting changes to the parameters in this dialog box, click this button.
A NetBackup Configuration This section contains information on the NetBackup Configuration dialog box for the system administrator. Configuration information is kept in the registry key \HKEY_LOCAL_MACHINE\Software\VERITAS\NetBackup \CurrentVersion\Config. General Property Sheet To access this property sheet: 1. From the Actions menu, select Configure... 2. Click the General property sheet.
A Use this property sheet to set any of the configuration parameters for your client. Client Name: Specify the name of your client. This name is used when backing up, archiving and restoring files, folders, or registry keys. It must match one in the NetBackup server class configuration. List Files Timeout (Timeout Period): This parameter should be changed only by a system administrator. Specify the number of seconds to wait for a response from the NetBackup master server when listing files.
A Perform Incrementals This parameter should be changed only by a system administrator. Based on Archive Bit: Select this check box to have NetBackup include files in an incremental backup only if their archive bit is set. The system sets this bit whenever a file is changed and it will remain set until NetBackup clears it. A full backup always clears the archive bit.
A 118 Cancel To cancel and return to the previous display without accepting changes to the parameters in this dialog box, click this button. Help To view on-line help for this dialog box, click this button.
A Exclude List Property Sheet Note: Parameters in this dialog box should be changed only by a system administrator. To access this property sheet: 1. From the Actions menu, select Configure... 2. Click the Exclude List property sheet. Use this property sheet to view and change the list of files to exclude from a master server directed backup. For example, if you add C:\*.bat to the Exclude File List:, all files with a .bat extension that appear in the root of the C: drive will not be backed up.
A 120 Class The Exclude File List: applies only to server directed backups for the specified class. Schedule: The Exclude File List: applies only to server directed backups for the specified class. This requires that a class be specified. Exclude File: Enter the file or folder, that you want to exclude, in the list box. Click Add to move the file or folder to the Exclude File List:. The exclude list is case sensitive unless the case_sensitive_exclude_list data value in the registry is set to no.
A Include List Property Sheet Note: Parameters in this dialog box should be changed only by a system administrator. To access this property sheet: 1. From the Actions menu, select Configure... 2. Click the Include List property sheet. Use this property sheet to view and change the list of files which would otherwise have been excluded during a master server directed backup. For example, if you add *.bat in the Exclude File List:, all files with a .bat extension will not be backed up.
A 122 Class The Exclude File List: applies only to server directed backups for the specified class. Schedule: The Exclude File List: applies only to server directed backups for the specified class. This requires that a class be specified. Include File: Enter the file or folder, that you want to include, in the list box. Click Add to move the file or folder to the Include List File. The include list is case sensitive unless the case_sensitive_exclude_list data value in the registry is set to no.
A Network Property Sheet Note: Parameters in this dialog box should be changed only by a system administrator. To access this property sheet: 1. From the Actions menu, select Configure... 2. Click the Network property sheet. Use this property sheet to view and change the port numbers used during communications between your client and the NetBackup master server. NetBackup Client Service Port: Specify the port the NetBackup server uses to communicate with the NetBackup client. The default is 13782.
A Troubleshooting Property Sheet Note: Parameters in this dialog box should be changed only by a system administrator. To access this property sheet: 1. From the Actions menu, select Configure... 2. Click the Troubleshooting property sheet. Use this property sheet to view and change the amount of information that NetBackup saves in its activity/troubleshooting logs. NetBackup only creates log files if the log folders are created. See "Troubleshooting Logs" on page 127 for more details.
A Note: Troubleshooting logs can consume a lot of disk space. Delete them when they are no longer needed. For more details on the BPCD logs, refer to "Troubleshooting Logs" on page 127. General: Controls the amount of information that NetBackup writes to the troubleshooting logs. Supported values are 0, 1, or 2. The higher the level, the more information is written. The default is 0. TCP: Used for debug purposes and enables TCP debugging. Supported values are: 0 No extra logging. This is the default.
A 126 Database: Controls the amount of information the NetBackup Database Extensions write to their log files. Supported values are 0 through 9. The higher the level, the more information is written. The default is 0. OK To accept changes to the parameters, click this button. Cancel To cancel and return to the previous display without accepting changes to the parameters in this dialog box, click this button. Help To view on-line help for this dialog box, click this button.
A Troubleshooting Logs NetBackup will generate troubleshooting logs only if you create the following folders on your client. Windows NT C:\ \VERITAS \NetBackup \Logs \BPBKAR \BPCD \BPINETD \NBWIN \TAR Windows 95/98 C:\ \VERITAS \NetBackup \BPCD \NBWIN All log files use the format yymmdd.LOG. BPBKAR Log files in this folder contains info about backups, both user and server directed.
A Syntax Rules for Exclude Lists and Include Lists Syntax Rules The following syntax rules apply to exclude lists and include lists. • Only one pattern per line is allowed. • The following meta or wildcard characters are recognized: [] ? * • To use the wildcard characters literally (that is, as non wildcard characters), precede them with a backslash (\).
A • End a file path with \ to exclude only folders with that path name (for example, C:\home\test\). If the pattern does not end in \ (for example, C:\usr\test) NetBackup excludes both files and folders with that path name. • To exclude all files with a given name, regardless of their folder path, just enter the name without a preceding slash. For example: test rather than C:\test This is equivalent to prefixing the file pattern with C:\ C:\*\ C:\*\*\ C:\*\*\*\ and so on.
A Example of an Exclude List If an exclude list has the following entries: C:\home\doe\john C:\home\doe\abc\ C:\home\*\test C:\*\temp temp the following are excluded from server directed backups: • The file or folder named C:\home\doe\john. • The folder C:\home\doe\abc (because the exclude entry ends with \). • All files or folders named test that are two levels below home. • All files or folders named temp that are two levels below the root. • All files or folders named temp at any level.
NetBackup Commands B This section describes commands specific to the NetBackup product. Execute these commands in an MS-DOS window so you can see the results. The following are special conventions used in the command descriptions. • Brackets [ ] mean that the enclosed command line component is optional. • A vertical bar (or pipe) symbol | separates optional arguments from which the user can choose.
B bparchive NAME bparchive - archive files to the NetBackup server SYNOPSIS install_path\NetBackup\bin\bparchive [-c class] [-s schedule] [-S master_server [,master_server,...]] [-t class_type] [-L progress_log] [w [hh:mm:ss]] [-help] [-k "keyword_phrase"] -f listfile | filenames DESCRIPTION bparchive processes files that you list on the command line or in the file you specify with the -f listfile option. Any file path entered can be a file or directory name.
B OPTIONS -c class Names the class to use for the user archive. If it is not specified, the NetBackup server uses the first class it finds that includes the client and a user archive schedule. -s schedule Names the schedule to use for the user archive. If it is not specified, the NetBackup server uses the first user archive schedule it finds in the class it is using (see the -c option). S master_server [,master_server,...] Specifies the name of the NetBackup master server.
B 19 = NDMP 20 = FlashBackup 21 = Split-Mirror 22 = AFS The default is 3 on Apollos and 0 (Standard) on other clients. -L progress_log Specifies the name of an existing file in which to write progress information. For example: c:\proglog. The default is to not use a progress log. -w [hh:mm:ss] Causes NetBackup to wait for a completion status from the server before returning you to the system prompt. You can optionally specify a wait time in hours, minutes, and seconds.
B The default keyword phrase is the null (empty) string. -f listfile Specifies a file (listfile) containing a list of files to be archived and can be used instead of the filenames option. In listfile, place each file path on a separate line. The format required for the file list depends on whether the files have spaces or returns in the names. To archive files that do not have spaces or returns in the names, use this format: filepath Where filepath is the path to the file you are archiving.
B EXAMPLES Example 1 To archive a single file, enter: bparchive c:\usr\user1\file1 Example 2 To archive files listed in a file named archive_list, enter: bparchive -f archive_list Example 3 To associate the keyword phrase "Archive My Home Directory 01/01/97" to the archive of the directory c:\home\kwc and use a progress log named c:\home\kwc\arch.log enter the following (all on one line): bparchive -k "Archive My Home Directory 01/01/97" -L c:\home\kwc\arch.
B bpbackup NAME bpbackup - back up files to the NetBackup server SYNOPSIS install_path\NetBackup\bin\bpbackup [-c class] [-s schedule] [-S master_server [,master_server,...]] [-t class_type] [-L progress_log] [w [hh:mm:ss]] [-help] [-k "keyword_phrase"] -f listfile | filenames install_path\NetBackup\bin\bpbackup -i [-c class] [-h hostname] [-s schedule] [-S master_server [,master_server,...
B • bpbackup does not back up the "." or ".." directory entries. By default, you are returned to the system prompt after bpbackup is successfully submitted. The command works in the background and does not return completion status directly to you. The -w option lets you change this behavior so the command works in the foreground and returns completion status after a specified time period.
B Names the schedule to use for the backup. If it is not specified, the NetBackup server uses the first user backup schedule it finds for the client in the class it is using (see the -c option). -S master_server [,master_server,...] Specifies the name(s) of the NetBackup master server(s). The default is the server designated as current on the Servers tab of the NetBackup Configuration dialog box. To display this dialog box, start the user interface on the client and click Configure on the Actions menu.
B 22 = AFS The default is 3 on Apollos and 0 (Standard) on other clients. -L progress_log Specifies the name of an existing file in which to write progress information. For example: c:\proglog The default is to not use a progress log. -w [hh:mm:ss] Causes NetBackup to wait for a completion status from the server before returning you to the system prompt. You can optionally specify a wait time in hours, minutes, and seconds. The maximum wait time you can specify is 23:59:59.
B -f listfile Specifies a file (listfile) containing a list of files to be backed up. This option can be used instead of the filenames option, but cannot be used with the -i option. List each file on a separate line. The format required for the file list depends on whether the files have spaces or returns in the names. To back up files that do not have spaces or returns in the names, use this format: filepath Where filepath is the path to the file you are backing up.
B EXAMPLES Example 1 To perform a user backup of a single file, enter: bpbackup c:\users\user1\file1 Example 2 The following command starts a user backup of the files that are listed in a file named backup_list. bpbackup -f backup_list Example 3 The following command (all on one line) starts an immediate-manual backup of the client host named diablo, in the class named cis_co. The class type is Standard class and is in the configuration on the master server named hoss. The progress log is c:\home\hrp\prog.
B FILES install_path\NetBackup\logs\bpbackup\*.
B bplist NAME bplist - lists backed up and archived files on the NetBackup server SYNOPSIS install_path\NetBackup\bin\bplist [-A | -B] [-C client] [-S master_server] [-t class_type] [-k class] [-F] [-R [n]] [-b | -c | -u] [-l] [-r] [-T] [-unix_files] [-nt_files] [-s mm/dd/yy [hh:mm:ss]] [-e mm/dd/yy [hh:mm:ss]] [I] [PI] [-help] [-keyword "keyword_phrase"] [filename] DESCRIPTION bplist shows a list of previously archived or backed up files according to the options that you specify.
B Specifies the name of the NetBackup server. The default is the server designated as current on the Server tab of the NetBackup Configuration dialog box. To display this dialog box, start the user interface on the client and click Configure on the Actions menu.
B -k class Names the class to search to produce the list. If not specified, all classes are searched. -R [n] Recursively lists subdirectories encountered to a depth of n. The default for n is 999. -b | -c | -u Specifies an alternate date and time to be used for printing with the -l option: -b displays the backup date and time of each file. -c displays the last modification date and time for each file. -u displays the last access date and time of each file.
B The valid range of dates are from 01/01/70 00:00:00 to 01/19/2038 03:14:07. The default is 01/01/70 00:00:00. -e specifies an end date and time for the listing. The resulting list shows only files from backups or archives that occurred at or before the specified date and time. Use the same format as explained above for start date and time. The default is the current date and time. -I Specifies a case-insensitive search.
B [ - ] matches one of the range of characters separated by the "-". The keyword phrase can be up to 128 characters in length. All printable characters are permitted including space (" " ) and period ("."). The phrase must be enclosed in double quotes ("...") or single quotes (‘...’ ). The default keyword phrase is the null (empty) string. filename Names the file or directory to list. If you do not specify a path, the default is the current working directory.
B "My Home Directory" in directory C:\home\kwc enter the following: bplist -A -keyword "*My Home Directory*" -l C:\home\kwc Example 4 To list, recursively and with details, the files that were backed up on drive D of Windows NT client slater and associated with all or part of the keyword phrase "Win NT" enter the following: bplist -keyword "*Win NT*" -C slater -t 13 -R -l D:\ FILES install_path\NetBackup\logs\bplist\*.
B bprestore NAME bprestore - restores files from the NetBackup server SYNOPSIS install_path\NetBackup\bin\bprestore [-A | -B] [-K] [-l | -H | -y] [-r] [-T] [-L progress_log] [-R rename_file] [-C client] [-D client] [S master_server] [-t class_type] [-s mm/dd/yy [hh:mm:ss]] [-e mm/dd/yy [hh:mm:ss]] [-w [hh:mm:ss]] [-k "keyword_phrase"] -f listfile | filenames DESCRIPTION bprestore lets users restore a backed up or archived file or list of files. You can also name directories to restore.
B For detailed troubleshooting information, create a directory named install_path\NetBackup\logs\bprestore with write access. bprestore then creates an activity log file in this directory. The following restrictions apply to bprestore: • You can restore files and directories that you own and those owned by other users if you have read access. You need write access to another user’s directories and files to restore that user’s files to their original location.
B Specifies the name of an existing file in which to write progress information. For example: c:\proglog The default is to not use a progress log. -R rename_file Specifies the name of a file with name changes for alternate-path restores.
B 3 = Apollo-wbak 4 = Oracle 6 = Informix-On-BAR 7 = Sybase 10 = NetWare 11 = DataTools-SQL-BackTrack 12 = Auspex-FastBackup 13 = MS-Windows-NT 14 = OS/2 15 = MS-SQL-Server 16 = MS-Exchange-Server 17 = SAP 18 = DB2 19 = NDMP 20 = FlashBackup 21 = Split-Mirror 20 = AFS The default is 3 on Apollos and 0 (Standard) on other clients. -s mm/dd/yy [hh:mm:ss] -e mm/dd/yy [hh:mm:ss] Specifies the start and end date range for the listing.
B mm/dd/yy [hh[:mm[:ss]]] The valid range of dates are from 01/01/70 00:00:00 to 01/19/2038 03:14:07. The default start date is 01/01/70 00:00:00. -e specifies an end date and time for the restore window. bprestore restores only files in backups or archives that occurred at or before the specified date and time. Use the same format as for the start date and time. The end backup date and time do not need to be exact.
B You can use this option in place of or in combination with the other restore options in order to make it easier to restore your backups and archives. The following meta characters can simplify the task of matching keywords or parts of keywords in the phrase: * matches any string of characters. ? matches any single character. [ ] matches one of the sequence of characters specified within the brackets. [ - ] matches one of the range of characters separated by the "-".
B To restore files that have spaces or newlines in the names, use one of the following formats: filepathlen filepath filepathlen filepath start_date_time end_date_time filepathlen filepath -s datetime -e datetime Where: filepath is the path to the file you are restoring. filepathlen is the total number of characters in the file path. start_date_time and end_date_time are the decimal number of seconds since 01/01/70 00:00:00. datetime is the same as the command line (mm/dd/yy [hh[:mm[:ss]]]).
B EXAMPLES Example 1 To restore a file from backups of C:\user1\file1 that were performed between 04/01/93 06:00:00 and 04/10/93 18:00:00, enter the following (all on one line): bprestore -s 04/01/93 06:00:00 -e 04/10/93 18:00:00 C:\user1\file1 Example 2 To restore files listed in a file named restore_list by using the most recent backups, enter the following: bprestore -f c:\restore_list Example 3 To restore the directory C:\kwc from the backups or archives that are associated with all or part of the keywo
B To restore the hard link named /home/kwc/linkback to alternate path /home/kwc/linkback_alt on that client, execute: bprestore -H -R /home/kwc/rename /home/kwc/linkback FILES install_path\NetBackup\logs\bprestore\*.
Glossary activity logs administrator Logs that can be optionally enabled for specific NetBackup programs and processes and then used to investigate problems. A user that is granted special privileges to install, configure, and manage the operation of a system, network, or application alternate-client restore Restores files to a different client than the one from which they were backed up.
attributes for a class Configuration parameters that control the behavior of NetBackup during operations involving this class. automatic backup A scheduled backup by the master server. back up backup bp.ini file bprd catalogs class client compression configuration 160 The act of copying and saving files and folders to storage media Refers to the process of copying and saving files and directories to storage media.
cumulative-incremental backup A backup that is scheduled by the administrator on the master server and backs up all files that have changed since the last successful full backup. All files are backed up if no prior backup has been done. daemon A program on a UNIX system that runs in the background and performs some task (for example, starting other programs when they are needed). Daemons are generally referred to as services or processes on Windows NT NetBackup servers and clients.
flush level Controls how often Netbackup clears its log files on a Novell NetWare or Microsoft Windows client platform. frequency (backup) How often NetBackup performs scheduled backups. For example, if the frequency is seven days then backups occur once a week. full backup Copies to a storage unit all files and directories that are beneath a specified directory. global attributes NetBackup configuration attributes that affect all classes.
logs Files where a computer or application records information about its activities. master server NetBackup server that provides administration and control for backups and restores of client data. media Physical magnetic tapes, optical disks, or magnetic disks where data are stored. media ID multiplexing NLM pathname PC Clients port progress report registry resource restore An identifier that is written on a volume as part of the label.
schedules slave server Controls when backups can occur in addition to other aspects of the backup, such as: the type of backup (full, incremental) and how long NetBackup retains the image. NetBackup servers whose attached storage units provide additional storage. The master server schedules and manages the backup and restore operations. server directed restore Using the client interface on the master server to restore files to any client. Only the administrator can perform this operation.
target service A Novell NetWare service that needs storage management. The SMS views all services (for example, print services, communication services, workstations) as targets. Target Service Agent A Target-service agent is a Novell NetWare agent that prepares the target’s data for SMS during a backup and for the target during a restore. timeout period TIR The period of time that an application has allotted for an event to occur. See "true image restore.
166 NetBackup User’s Guide - Microsoft Windows
Index A Administrator configuration, 115 exclude list tab, 119 include list tab, 121 troubleshooting tab, 124 directed, 1 backup, 2, 5 restore, 4 reference, 105 restore options, 109 true image restore procedure, 34 Alternate path restore, 93 Alternate client restores definition, 159 Alternate path restore definition, 159 Alternate target restore definition, 159 Archive class, 76, 96 schedule, 76, 97 Archive bit cumulative incremental backup, 3 definition, 159 diferential incremental backup, 3 full backup, 2
C Class archive, 76, 96 backup, 29, 76, 96, 120, 122 backup history pane, 66 more than one, 63 server configuration, 68, 74, 98, 111, 113, 116 true-image restore, 34 type, 99, 111, 113 Client daemon port, 123 Clients adding and removing, 73 restore options, 98, 111, 113 Clients, NetBackup definition, 160 Commands, NetBackup, 131 Cumulative-incremental backup, 3 D DAT files, 80 Database Extension Level, 126 Datetime stamp, 66, 117 cumulative-incremental, 3 Days to keep operation status, 116 Debug, 124 Defau
H Heap level debug, 125 History pane description, 63 detailed list, 66 refresh, 49 restore procedure, 32 timeline, 65 to open, 64 to select backups, 29 true-image restore procedure, 34 I Include list add from backup menu, 50 configuration tab, 70, 121 syntax rules, 128 Incremental backup archive bit, 117 cumulative, 3 differential, 3 K Keyword phrase backup procedure, 14 restore procedure, 20 M Menu actions, 45 backup, 50 edit, 47 help, 54 restore, 51 view, 48 window, 53 N NetWare Loadable Module, 163
backup history pane, 66 Scheduled administrator-directed operations, 2 backup server list, 72 backups exclude file list, 120 include file list, 122 servers list, 95, 100, 110 Search backups, dialog box, 89 default search, 117 procedure, 30 specific backup dates, 29 Server adding and removing, 71, 100 configuration, 68, 71, 74, 98, 100, 106, 111, 113, 116 Server directed restore definition, 164 Session, NetBackup, 164 SMDR (see Storage Management Data Requestor) SMS (see Storage Management Services) Specific
W Wildcard characters escaping on UNIX, 128 in UNIX exclude lists, 128 Window description backup, 59 backup, archive and restore, 58 restore, 61 menu, 53 restore does not display backed up files or folders, 17 open from actions menu, 45 restore (archive), 51 open from actions menu, 45 restore (true-image), 51 open from actions menu, 45 save settings, 49 toolbar, 8 unmarking files and folders, 9 Index 171
172 NetBackup User’s Guide - Microsoft Windows