KEY:Archive TITLE:Archive: Archive Program To start the ${NETWORKER} Archive program at a system prompt, type: nwarchive. The nwarchive program is client-side software that you can use to select files or filesystems to archive, initiate the archive operation, and monitor the progress of the archive operation. The menu bar contains the following choices: File - Start the archive or exit the nwarchive program. Tree - Allows changing the level of file information displayed, if needed: - Select Expand One Level or double-click the directory folder in the directory display to expand the directory display one level. - Select Expand Branch or click a directory folder in the display to expand a directory branch to display subdirectory levels contained in a directory. - Select Collapse Branch or double-click the directory folder in the display to collapse a branch. View - Allows display of the Search dialog box, or allows the viewing of detailed information about files in a directory. Change - Same function as the Change Server button on the speedbar. Mark - Same function as the Mark button on the speedbar. Note that selecting (highlighting) the file or directory name does not mark it for backup. Marking must be done by using the Mark pull-down menu or the speedbar's Mark button on selected files or directories, or by selecting the small check box immediately to the left of the file or directory name (for this, the file or directory name need not already be highlighted). Options - Toggles between displaying or not displaying the speedbar. The top portion of the Archive window contains the following speedbar buttons: Change Server - Switches to a different ${NETWORKER} server. Mark - Selects the highlighted file or directory for archiving. Unmark - Deselects the highlighted file or directory for archiving. Search - Displays the Search dialog box. Start - Starts the archive. If you have not marked any data for archiving, ${NETWORKER} displays an error message and does not begin the archive operation. In the lower part of the window, mark directories and files to include in the archive. YEK KEY:Archive Options TITLE:Archive: Archive Options Dialog Box The Archive Options dialog box appears after you start an archive operation. In the Archive Options dialog box, specify the details about the archive operation. The Archive Options dialog box contains the following attributes: Archive Title - Displays the pathname of the directory or file selected for archiving. (Read-only attribute) Annotation - Enter a comment to help identify the contents of this archive. Older versions of the ${NETWORKER} server limit the length to 1024 characters. Newer versions do not limit the length of an annotation. Archive Pool - Specify the pool to which ${NETWORKER} will write archive data. Enter either a volume pool name in the field or select a pool name from the list. The default pool is either the Archive pool, or the Indexed Archive or PC Archive Pools (which have browsable client file indexes associated with them). Operations - Select any of the following option buttons to control further how the archive is written: - Compress - Saves the archive data in compressed format. - Clone - Makes an exact duplicate of the archive data on different media. - Verify - Tells ${NETWORKER} to ensure that data on the archive media matches data on the local disk. - Groom - Tells ${NETWORKER} to remove files and directories from the local disk after archiving. Clone Pool - Specifies the pool to which ${NETWORKER} writes the clone of the archive data. The default pool is the Archive Clone pool. See also: Other Archive topics. YEK KEY:Remove Archived File TITLE:Archive: Remove Archived File Dialog Box If you have selected the "Groom" option in the Archive Options Dialog Box, ${NETWORKER} displays the Remove Archived File Dialog Box after the files have been archived. If cloning or verification is requested, no removal is performed until those operations have completed successfully. The Remove Archived File dialog box has two questions for you to answer concerning archived file removals. 1. To decide whether to remove the file displayed in the dialog box title bar, click one of the choices below: - Remove the archived file - Keep the archived file 2. The Remove Archived File Dialog Box displays the following prompt: "Do you want to be prompted for more file removals?" If you select "Yes" (the default selection), ${NETWORKER} will display the Remove Archived File dialog box for remaining archived files and directories. If you select "No", ${NETWORKER} will apply the same removal decision you have made for the current file on remaining archived files and directories. YEK KEY:Archive Status TITLE:Archive: Archive Status Dialog Box The Archive Status dialog box appears after you start an archive using the ${NETWORKER} archive program, nwarchive. It displays progress messages during an archive. To discontinue the archive and dismiss this dialog box, click Cancel. YEK KEY:Backup TITLE:Backup: Backup Program To open the ${NETWORKER} Backup window at a system prompt, type: nwbackup. The nwbackup program is client-side software used to select files or filesystems to back up, initiate an on-demand (ad hoc) backup operation, and monitor the progress of the backup operation. The menu bar contains the following choices: File - Start the backup or exit the nwbackup program. Tree - Allows changing the level of file information displayed, if needed: - Select Expand One Level or double-click the directory folder in the directory display to expand the directory display one level. - Select Expand Branch or click a directory folder in the display to expand a directory branch to display subdirectory levels contained in a directory. - Select Collapse Branch or double-click the directory folder in the display to collapse a branch. View - Allows display of the Search dialog box, or allows the viewing of detailed information about files in a directory. Change - Same function as the Change Server button on the speedbar. Mark - Same function as the Mark button on the speedbar. Note that selecting (highlighting) the file or directory name does not mark it for backup. Marking must be done by using the Mark pull-down menu or the speedbar's Mark button on selected files or directories, or by selecting the small check box immediately to the left of the file or directory name (for this, the file or directory name need not already be highlighted). Options - Toggles between displaying or not displaying the speedbar. The top portion of the Backup window contains the following speedbar buttons: Change Server - Switches to a different ${NETWORKER} server. Mark - Selects the highlighted file or directory for backup. Unmark - Deselects the highlighted file or directory for backup. Search - Displays the Search dialog box. Start - Begins the on-demand backup. If you have not marked any data for backup, ${NETWORKER} displays an error message and does not begin the backup operation. In the lower part of the window, mark files and directories for backup. YEK KEY: TITLE:Backup: Backup Concepts You can use ${NETWORKER} for both scheduled, network-wide backups coordinated on the ${NETWORKER} server and manual backups of files and directories initiated by a ${NETWORKER} client. Use scheduled backups to systematically protect the data stored across your network. To use scheduled backups, first set up the resources to control clients, groups, schedules, and backup levels on the ${NETWORKER} server, then enable the Autostart attribute in the backup group resource. The backups run automatically according to the schedule set for the backup. Scheduled backups are configured using NetWorker Management Console. Use manual backups for quickly saving a few files to backup media. IMPORTANT: To recover from disasters such as disk failure or operating system corruption, you must have included all clients in scheduled backups. Bootstrap reports, which are required for disaster recovery, are only created during scheduled backups. See also: Other Backup topics. YEK KEY: TITLE:Backup: Manual Backup Concepts To request a manual backup, run the nwbackup program. A manual backup, also called an ad hoc or on-demand backup, is initiated on the ${NETWORKER} client machine, and it backs up the selected files and filesystems immediately. Information regarding the backed-up files and directories is recorded in the client's online file index. The location of these files and directories on backup media is recorded in the media database. For manual backups, however, ${NETWORKER} does not save to backup media either the index or the bootstrap (of which the media database is a part). IMPORTANT: To recover from disasters, such as disk failure or operating system corruption, you must include all clients in scheduled backups. Bootstrap reports, which are required for disaster recovery, are only created during scheduled backups. YEK KEY: TITLE:Backup: Starting a Manual Backup To start a manual backup: 1. Start the nwbackup program. 2. In the ${NETWORKER} Backup window, check the Server field to verify that the correct ${NETWORKER} server is selected. You can change servers by clicking the Change Server speedbar button or selecting Server from the Change menu. This is the Server to which the client files will be backed up. 3. The hostname of the current client is displayed in the Client field. The pathname of the current directory is displayed in the Selection field. Change directories by entering the full pathname in the Selection field or by highlighting the icon in the Backup window. 4. Mark the files and directories that you want to back up by highlighting them and clicking the Mark speedbar button or clicking their checkboxes. 5. Click Start or select Start Backup from the File menu of the Backup window. To continue the backup, you must select whether to compress files or exclude patterns in the Backup Options dialog box. 6. Monitor the progress of the backup in the Backup Status window. Check to see that a volume is mounted in the Pending display of the ${NETWORKER} Administrator window. See also: Backup: Backup Options Dialog Box, Backup: Backup Status Window. YEK KEY:Backup Levels TITLE:Backup: Backup Levels In ${NETWORKER}, the backup level controls how much data in the save set will be saved to backup media, based on which files have changed since the previous backup and what types of backup have happened earlier in the backup cycle. ${NETWORKER} supports the following backup levels for filesystem data: Full - ${NETWORKER} backs up every file in the save set, no matter when the files last changed. 1 through 9 - ${NETWORKER} backs up only the files that have changed since the most recent lower backup level. Each backup level is represented by a number, 1 through 9, where 1 represents the fullest backup and 9 represents the most minimal backup. Incremental - ${NETWORKER} backs up files that have changed since the previous backup, regardless of the level of the previous backup. Consolidate - ${NETWORKER} creates a full backup by replicating stored data on tape. It minimizes the load on your network by performing a differential level 1 backup of all the files that have changed since the last full backup. ${NETWORKER} then merges the data from the last full backup and the differential level 1 backup to generate a new full backup. Skip - ${NETWORKER} skips the backup entirely. Skip is useful if you want to skip the backup on a holiday if you know that no one will be around to change the tapes. Use the ${NETWORKER} scheduling calendar to configure backup schedules from simple to complex. Backup levels let you trade off the amount of media and amount of time required to complete a backup versus the number of tapes and amount of time it takes to recover lost files. YEK KEY:Backup Options TITLE:Backup: Backup Options Dialog Box The Backup Options dialog box appears when you start a manual backup with the ${NETWORKER} Backup program. It is invoked by entering the nwbackup command at the command line. This dialog box prompts you with the following questions: - Do you want to compress this backup? Click Yes to enable client-side compression for this backup. Click No to disable client-side compression for this backup. - Do you want to exclude any patterns from this backup? Click Yes to enable the Pattern field, where you enter or select filenames or partial filenames with wildcards. Click No to disable the Pattern field. ${NETWORKER} starts the manual backup after you click the OK button. YEK KEY:Backup Status TITLE:Backup: Backup Status Window The Backup Status window appears after you complete the Backup Options dialog box for a manual backup and click OK. Use the Backup Status window to monitor the progress of the manual backup. The Backup Status window displays the following information: - Backup start time - Backup completion time - The names of the files and directories included in backup - Save message, which gives information about the backup, including the full pathname of the directory and the number of kilobytes and files being saved If you do not see any progress messages in the Backup Status window after you wait a few minutes, the ${NETWORKER} server probably needs attention from the system administrator. Cancel the backup by clicking Cancel. A completion message appears in the Backup Status window when the backup finishes. See also: Other Backup topics. YEK KEY: TITLE:Backup: Excluding Patterns Before starting a backup, you can exclude files from the backup in the Backup Options dialog box. This feature is useful, for example, if you are backing up an entire directory, but do not want to back up certain files or subdirectories in that directory. Excluding data from the backup also reduces network traffic and saves space on backup media. To exclude data, specify alphanumeric patterns that occur in the names of the files that you want to exclude from the backup. Use the UNIX shell pattern characters to specify any number of patterns to exclude. Notice that No is highlighted as the default answer to the question "Do you want to exclude any patterns from this backup?" If you do not want to exclude any patterns of filenames from the backup, click OK to continue the backup of your file compression choice. To exclude patterns from the backup, follow these steps: 1. Select Yes to answer the question "Do you want to exclude any patterns from this backup?." This activates the lower half of the Backup Options dialog box. 2. In the Pattern field, enter the first pattern. 3. Click Add to add the pattern to the list. 4. You can enter any number of patterns and add them to the pattern list. If you want to change a pattern, select it in the pattern list. The selected pattern is displayed in the Pattern field. Enter the new pattern and click Change. The new pattern replaces the old pattern in the pattern list. 5. To delete a pattern, select it in the pattern list and click Delete. 6. Click OK to continue the backup with the excluded file patterns. YEK KEY: TITLE:Recover: Recover Concepts After ${NETWORKER} backs up your data to storage media, records of the data are kept in the online client file index and media database. The online client file index maintains information about all instances of a file or filesystem backed up in a predefined period called the browse policy. During the period of the browse policy, instances of each file or filesystem backed up are available to browse and recover in the ${NETWORKER} Recover window. The media database tracks which save sets are stored on which volumes. Records of the contents of each volume are maintained during a predefined period called the retention policy. The retention policy is required to be longer than, or equal to, the browse policy for any given save set. During the period of the retention policy, you can recover data using the save set recover function in the ${NETWORKER} Administrator program. After a save set has passed both its browse and retention criteria it can still be recovered using the save set recover function in the ${NETWORKER} Administrator program. After every save set on a volume has passed its own browse and retention criteria, the volume itself becomes eligible to be recycled by ${NETWORKER} software. YEK KEY:Recover TITLE:Recover: ${NETWORKER} Recover Program To open the ${NETWORKER} Recover window, run the nwrecover program. ${NETWORKER} displays entries in the ${NETWORKER} Recover window for the files that it saved during a backup. You can select a file that is listed in the ${NETWORKER} Recover window for recovery. ${NETWORKER} has powerful recover functions that allow you to browse the index for previous backups, select various versions of the file to recover, view your marked files, relocate files upon recovery, and recover files from another authorized system. An authorized system is a client from which you have permission to recover data. YEK KEY: TITLE:Recover: Recovering Files or Directories To recover files or directories: 1. At the command line, type nwrecover to open the ${NETWORKER} Recover window. 2. If necessary, choose a server by clicking Change Server on the speedbar. If applicable, choose a client by choosing Client from the Change menu. 3. Change the level of file information displayed, if needed: - To expand the directory display one level, double-click the directory folder in the directory display. - To expand a directory branch to display subdirectory levels contained in a directory, click a directory folder in the display and select Expand Branch from the Tree menu. - To collapse a branch, double-click the directory folder in the display. - To view detailed information for files in a directory, select File Details from the View menu. 4. Using the mouse, highlight the icons for files or directories you want to recover, and click Mark for these. 5. Choose Volumes from the View menu to see whether the volumes are on-line for the recovery. 6. Click Start to begin the recovery. 7. Click OK in the Conflict Resolution dialog box. 8. When you see the recover completion time message in the Recover Status window, click Cancel to close the window. See also: Recover: Changing the Browse Time, Recover: Recover Status Window, Recover: Versions Window. YEK KEY:Changing the Browse Time TITLE:Recover: Changing the Browse Time The Browse Time field in the ${NETWORKER} Recover window displays the current date and time unless you change them. The ${NETWORKER} Recover window displays the index entries for previously backed-up files. Changing the browse time displays the entries for files backed up at that time. NOTE: If ${NETWORKER} has no entries for files backed up for the selected time in the Browse Time field, ${NETWORKER} displays files that were backed up at the closest preceding time. For example, if you change the selected time to 11 in the morning on May 15, and the two closest backups to that time took place at 12 noon and 9 in the morning on the same day, ${NETWORKER} does not display the entries for the noon backup, but rather for the backup done at 9 in the morning, because it was the closest preceding backup. Note, however, that you may not set the browse time before the first browsable backup. If you do so, you receive an error message that informs you that there is nothing in the index for that time. Changing the browse time lets you view the files as they existed at some time in the past. This is useful if you do not remember the name or location of the files you want to recover, but you know the backup took place. The Change browse time command also helps you find files that you deleted and which no longer appear in the Versions window. You can recover deleted files by changing the browse time to locate past versions of the files in the index. IMPORTANT: Use the Change Browse time to browse and mark past versions of directories. If you mark a directory, all its nested files and subdirectories are also marked. To change the browse time to recover a past version of a file, follow these steps: 1. Open the ${NETWORKER} Recover window and select Browse Time from the Change menu. The Previous, Today, and Next buttons control the month in the calendar. After choosing a month, click a day in calendar to select the browse time. 2. You can also change the browse time by entering a date and time in the Browse Time field and clicking OK. The following format is valid for entering browse time in numbers: mm/dd/yyyy hh:mm:ss (using a 24-hour clock) For example: 12/30/2001 23:59:59 is December 30, 2001, at 1 second before midnight. 3. Click OK when you are finished choosing a browse time. The Browse Time field in the ${NETWORKER} Recover window changes to reflect the new browse time. Both the file display and the directory display of the ${NETWORKER} Recover window show the files that were backed up at that time. You can now mark past versions of files for recovery. NOTE: Any files or directories that you marked for recovery before changing the browse time remain marked. See also: Recover: Versions Window. YEK KEY:Versions TITLE:Recover: Versions Window The Versions window lists all the versions of a file or directory that have been backed up by the ${NETWORKER} server. It also lists the location of the versions (in other words, the backup media). Use the Versions command to view the backup history of a file and to mark a particular version of a file for recovery. IMPORTANT: ${NETWORKER} displays versions of directories and files in the Versions window. There you can mark files for recovery. You cannot not mark directories for recovery. The Versions window provides the following information about each file version: number of blocks, mode, permissions, number of links, owner, group, size in bytes, last modified time, and filename. It also provides the backup time and location of the version. Use the backup time to identify different versions of a file. The location includes the name of the volume, the device, if any, where the volume is mounted, or the location of the volume (for example, an off-site storage place). If no device is listed, it means that the volume must be mounted before you can recover the file. YEK KEY: TITLE:Recover: Viewing Versions of a File or Directory To view the backup history of a file or directory: 1. Open the ${NETWORKER} Recover window. 2. Highlight a file or directory in the file display by selecting its name or icon. NOTE: Selecting the small checkbox immediately to the left of the file icon does not select the file; it merely marks it for backup. In order to view the various versions of the file, you must select the name or the file icon. 3. Select Versions from the View menu. ${NETWORKER} retrieves up to 10 versions of the highlighted file or directory from the index and lists them by backup time, beginning with the most recent. Use the scrollbar to view the backup history. 4. Click More to retrieve 10 more versions from the online file index. The More button turns to gray when all versions have been retrieved. IMPORTANT: You cannot mark directories in the Versions window. If you want to mark a past version of a directory, use the Change Browse Time command, instead. To select a version of a file for recovery: 1. Click the check box of the version that you want to recover. 2. Click OK to place the checked versions in the file display. TIP: When you mark a past version of a file in the Versions window, this version appears in the ${NETWORKER} Recover window file display with the same name as the recent version. You will then have more than one version of a file in the file display. If you do not know which version is which, use File Details to display their backup times. YEK KEY: TITLE:Recover: Starting a Recovery To start a recovery: 1. In the ${NETWORKER} Recover window, select the files or directories you want to recover. 2. Click Start in the ${NETWORKER} Recover window, or choose Start Recover from the File menu. YEK KEY: TITLE:Recover: Choosing the Recover Server Normally you recover files from the ${NETWORKER} backup server designated by your system administrator. If you have backed up files to a different server, you must use that server to recover your files. In other words, if you changed servers in the ${NETWORKER} Backup window, select the same server in the ${NETWORKER} Recover window. The Change Server dialog box lists all the ${NETWORKER} servers on the network. You can only recover files from a server that lists your system as a client. To choose a recover server: 1. In the ${NETWORKER} Recover window, click Change Server, or select Server from the Change menu. 2. Click OK after selecting a server. YEK KEY:Changing Recover Clients TITLE:Recover: Choosing the Recover Client To recover files from a client other than the system currently in use, you can change to any client known to the ${NETWORKER} server. Check with your system administrator to recover files other than your own. You might not be authorized to recover files for other client systems. Only ${NETWORKER} administrators and users listed in the client's Remote Access list can perform recoveries for a remote client. To choose a recover client: 1. ${NETWORKER} Recover window, select Client from the Change menu in the Recover window. You can update the list of ${NETWORKER} clients by clicking the Update Client List button. 2. Choose a client from which you are authorized to recover files. The Client field changes to reflect the current selection. YEK KEY: TITLE:Recover: Save Set Recover Topics dealing with save set recover are listed under Save Set. YEK KEY:Showing Files Marked for Recovery TITLE:Recover: Showing Files Marked for Recovery You can list the files you marked for recovery by selecting Show Marked command in the ${NETWORKER} Recover window. Use the Show Marked command to check which files you have marked for recovery before starting the recover operation. The Files Marked for Recovery window lists the pathnames and backup time of files marked for recovery. To show the files you marked for recovery: 1. Select Show Marked from the Mark menu of the ${NETWORKER} Recover window. The Files Marked for Recovery window appears, listing the pathnames and backup time of all marked files. 2. Click Cancel to close the window. The Show Marked command lets you verify that you have indeed marked all the files you need to recover before starting the recovery. YEK KEY:Relocating Files TITLE:Recover: Relocating Files Before starting a recovery, use the optional Relocate command to place the recovered files in a directory other than the one where they originally were when they were backed up. The Relocate command first creates the directory if it does not already exist and then places the recovered files in the new directory. You can also relocate files to an existing directory by entering the complete pathname. To relocate recovered files into a new or existing directory: 1. Open the ${NETWORKER} Recover window and select Relocate from the Options menu. 2. In the Relocate to field, enter the name of the directory where you want to place the recovered files. You can relocate files to a new directory or to an existing directory. Be sure to include the complete pathname of the directory. 3. Click OK to relocate files to the new directory. See also: Recover: Conflict Resolution Dialog Box, other Recover topics. YEK KEY:Conflict Resolution TITLE:Recover: Conflict Resolution Dialog Box The Conflict Resolution dialog box appears automatically after you issue the Start Recover command. Select how ${NETWORKER} will handle cases in which a file you are recovering already exists in the current or relocated directory before the recovery process actually starts. The Conflict Resolution dialog box displays the following prompt: "Do you want to be prompted when conflict occurs?" If you select "Yes" (the default selection), ${NETWORKER} displays the Filename Conflict dialog box each time it encounters a conflict between a recovered file and an existing one. Resolve each conflict individually, telling ${NETWORKER} whether to rename or discard the recovered file, or overwrite the existing file. If you select "No", you must select one of the following global resolutions to conflicts: - Rename the recover file - ${NETWORKER} renames the recover file with a .R extension and preserves the existing file. - Discard the recover file - ${NETWORKER} discards the recover file and preserves the existing file. - Overwrite the existing file - ${NETWORKER} replaces the existing file with the recovered file. The existing file is lost. The recovered file becomes current. IMPORTANT: NDMP recovers always overwrite the existing file. "Rename the recover file" and "Discard the recover file" are not supported for NDMP save sets. YEK KEY:Filename Conflict TITLE:Recover: Filename Conflict When you start a recover, ${NETWORKER} displays the Conflict Resolution dialog box, where you decide whether to rename recovered files or overwrite existing files when a naming conflict occurs. A naming conflict is when a file you are recovering already exists or has the same name as one in the current directory. ${NETWORKER} will not overwrite existing files unless you specifically tell it to do so. The Conflict Resolution dialog box has two questions for you to answer concerning conflicts between recover files and existing files. 1. To resolve the conflict, first answer the question, "Do you want to be prompted when conflict occurs?" If you select No, then you must make a choice for the next question in the box, "When conflict occurs, ${NETWORKER} should?" Answering this question allows you to resolve conflicts on a global basis per recover session without being prompted for each individual file. 2. If you select Yes, the default selection, ${NETWORKER} will prompt you for instructions in the Filename Conflict dialog box every time it encounters a conflict between a recovered file and an existing file. For each recovered file that has the same name as an existing file, choose whether to rename the recovered file, discard the recovered file, or overwrite the existing file. This allows you to resolve conflicts on a file-by-file basis. In either case, click one of the choices below to solve naming conflicts: - Rename the recover file - ${NETWORKER} renames the recover file with a .R extension. If the .R file already exists, ${NETWORKER} adds another .R. - Discard the recover file - ${NETWORKER} discards the recover file. The existing file remains current. - Overwrite the existing file - ${NETWORKER} replaces the existing file with the recovered file. The existing file is lost and the recovered file becomes current. 3. After completing the Conflict Resolution dialog box, click OK to continue the recovery. See also: Recover: Conflict Resolution Dialog Box, Recover: Relocating Files, other Recover topics. YEK KEY:Recover Status TITLE:Recover: Recover Status Window After completing the Conflict Resolution dialog box, ${NETWORKER} displays the Recover Status window. You can monitor the progress of the recovery in the Recover Status window. The Recover Status window displays the following information: - The name of the required backup media and their location (Volumes needed). - The pathname of the recover files and the directory where they are stored. - The approximate amount of disk space required to recover the requested files. - The number of files being recovered. During the recover, the pathnames of the files should scroll across the Recover Status window. If no pathnames appear, check the Pending display of the Administrator window to see whether the correct volume is mounted. When the recover is complete, the following message appears: Successfully received X files. See also: Other Recover topics. YEK KEY: TITLE:Recover: Browsing Filesystems The ${NETWORKER} user interface allows you to browse filesystems, including directories, subdirectories, and nested files. Since a graphical representation of the filesystem appears on the screen, it is easy to select files and directories for backup. When recovering files, the index of saved files is displayed in the same way, making it convenient to select files for recovery. The ${NETWORKER} browsing features allow you to view directories, mark and unmark files, search for files, view file details, and change the current directory. NOTE: The browsing features are common to both Backup and Recover windows. YEK KEY: TITLE:Retrieve: Retrieve Concepts Use the ${NETWORKER} retrieve program to copy files back to local disk from long-term storage media called archive volumes. You can only retrieve data that has previously been archived. To retrieve data you have backed up, use the ${NETWORKER} recover function. To run the ${NETWORKER} retrieve program, enter nwretrieve at the command prompt. See also: Other Archive topics. YEK KEY:Retrieve TITLE:Retrieve: Retrieve Program To start the ${NETWORKER} retrieve program, type nwretrieve at the command line. Use the ${NETWORKER} retrieve program to copy files back to local disk from their archive location on long-term storage media called archive volumes. The retrieve program main window contains the following attributes: Server - Displays the name of the current ${NETWORKER} server. To change the value in this field click Change Server, or select Change Server from the Change menu. (Read-only attribute) Client - Enter or view the name of the client for which you want to retrieve archived files. Do not enter wildcard characters in this field, but it may be left blank. Save Set Name - Enter the name of a save set you want to retrieve for the specified client. Do not enter wildcard characters in this field, but it may be left blank. Search Annotation For - Specify a string in this field if you remember at least part of the archive's notation. All archive save sets with matching annotations appear in the Archives list. You can enter wildcard characters in this field. Query - Click this to see a list of archived save sets that match the criteria you specified in the Client, Save Set Name, and Search Annotation For fields. Archives - Lists the archives that match your search criteria. Select one or more archives from this list to retrieve. Details - Click this to display the Retrieve Details dialog box, which displays detailed information about the highlighted save set. YEK KEY:Retrieve Details TITLE:Retrieve: Retrieve Details Dialog Box To see details about the most recently highlighted archive save set in the Retrieve window, click Details. The Retrieve Details dialog box displays the save set name, its date, the number of files it contains, the save set ID, its size, and the annotation string. YEK KEY: TITLE:Retrieve: Retrieving an Archived Save Set To select save sets for retrieval: 1. Start the ${NETWORKER} retrieve program by typing nwretrieve at the command line. 2. Enter values in one or more of the filtering fields in the ${NETWORKER} retrieve program window (Client, Save Set Name, or Search Annotation For), then click Query. All archive save sets that meet your criteria appear in the Archives list. 3. Highlight one or more save sets in the Archives list. 4. Click Start or select Start Retrieve from the File menu. YEK KEY:Retrieve Status TITLE:Retrieve: Retrieve Status Window After you start the retrieve operation, the Retrieve Status window appears. The Retrieve Status window contains the following attributes: Archives - Lists all archive save sets selected for retrieval. Relocate To - Enter a new or existing directory where retrieved files can be copied. (Optional) Overwrite Existing Files - Click this to tell ${NETWORKER} to replace any files on local disk having the same pathname as files being retrieved. Status - Displays informational messages during the retrieve operation to show the progress of the operation. OK - Click this to start the retrieve. The appropriate archive volumes must be mounted beforehand. To stop a retrieve in progress, or to dismiss the Retrieve Status window before retrieval has begun, click Cancel. YEK KEY:Save Sets TITLE:Save Set: Concepts A save set is a collection of files from a single client resource backed up by ${NETWORKER} in a single backup session. ${NETWORKER} automatically appends save sets onto a volume until that volume is full. Thus, multiple save sets are frequently stored on the same volume. YEK KEY: TITLE:Save Set: Save Set Recover Concepts Index entries that have been removed from the online file index have passed their browse policy and consequently are no longer available for recovery through the ${NETWORKER} recover program (nwrecover). They might, however, still be available for recovery from the media where the files were originally backed up, if the volumes have not been relabeled. Use the Save Set Recover window to recover data from the backup volume. When you recover by save set, you recover only the data; you do not recover the data's index entries. Save set recover is good for restoring large amounts of data or data that has been lost due to a disk crash. System administrators who are familiar with the setup of their systems' disks can easily determine which save sets they need to recover a disk partition or an entire disk. TIP: Use save set recover to recover data whose entries have been removed from the online file index. Recover data whose online file index entries are still in the online file index with the ${NETWORKER} Recover program (nwrecover command). YEK KEY:Save Set Recover TITLE:Save Set: Save Set Recover Window To display the Save Set Recover window, select Save Set Recover from the Options menu in the ${NETWORKER} Recover program (nwrecover command) Use this window to select save sets to recover from backup volumes. The Save Set Recover window contains the following attributes: Client - Select the name of the client system for which you want to recover a save set from the list of clients known to the current ${NETWORKER} server. Save Set - Lists the selected client's save sets. The versions of the selected save set are listed in the Instances list. Instances - Lists the versions of the selected save set. The list provides information about the Date, Level, Size, and Status and cloning. To select a save set, click it once. To deselect a save set, click once again. The highlighting is removed. You can select an unlimited number of versions for the same save set for simultaneous recovery. If you do not choose a save set from the list, the ${NETWORKER} server automatically selects the last save set on the list. If you do not choose a save set instance to recover, the ${NETWORKER} server automatically selects a save set instance. NOTE: Recovering by save set ID is not supported if the save set name includes a symbolic link. Details - Click this to open the Save Set Recover Details window for more detailed information on a specific save set version. Details about the most recently selected save set selected are displayed. Recover - Click this to begin the save set recover process and open the Save Set Recover Status window. YEK KEY:Save Set Recover File Conflict TITLE:Save Set: Save Set Recover File Conflict Window If a recovery operation encounters a save set that already exists in the current or relocated directory, the Save Set Recover File Conflict window automatically appears. You can choose to Rename, Discard, or Overwrite the existing save set: - Rename the recover file - ${NETWORKER} renames the recovered file with a .R extension and preserves the existing file. - Discard the recover file - ${NETWORKER} discards the recovered file and preserves the existing file. - Overwrite the existing file - ${NETWORKER} replaces the existing file with the recovered file. The existing file is lost. The recovered file becomes current. A "Prompt on Further Conflicts" button allows you to decide whether to apply a particular resolution to all conflicts encountered, or to have the system prompt you to choose the method of resolution for each conflict. YEK KEY:Save Set Instances TITLE:Save Set: Instances in Save Set Recover Window The Instances pane shows the instances, or versions, of the save set selected in the Save Sets pane, backed up at different times. The Instances pane lists the save set ID, the number of files in the save set, the size of the save set (in megabytes or kilobytes), the date on which it was saved, and the level at which the save set was backed up: full, incr, or level. Use the information to determine how resources are being used. For example, you might want to see how large a save set is so that you can plan the amount of disk space needed for the online indexes. You might want to generate a report that details the ${NETWORKER} client backups to fulfill administrative requirements. To view the instances of a particular save set: 1. In the Save Set Recover window, select a client from the Clients list. 2. Select one of that client's save sets from the Save Sets list. The Instances pane displays the instances of the selected save set. The Instances list contains information about Date, Level, Size, Status, and cloning. YEK KEY:Save Set Recover Options TITLE:Save Set: Save Set Recover Options Window To open the Save Set Recover Options window, click Options in the Save Set Recover Status window. The Save Set Recover Options window contains the following attributes: Relocate Recovered Data To - Enter the full pathname of the directory where you want to put the recovered data. If you do not enter a pathname, ${NETWORKER} automatically recovers the data to its original location. Duplicate File Resolution - Click one of the following buttons to determine what ${NETWORKER} does in cases where a file you recover already exists. The default selection is Rename Recovered File. - Rename Recovered File - Click this to rename the recovered file with a .R extension and preserve the existing file. - Discard Recovered File - Click this to discard the recovered file and preserve the existing file. - Overwrite Existing File - Click this to replace the existing file with the recovered file. The existing file is lost. The recovered file becomes current. Always Prompt - Click this to be prompted each time there is a filename conflict. If Always Prompt is not selected, the Duplicate file resolution choice will be applied without confirmation. YEK KEY:Save Set Recover Status TITLE:Save Set: Save Set Recover Status Window To open the Save Set Recover Status window, click Recover in the Save Set Recover window. In the Save Set Recover Status window, you can customize save set recoveries. For example, you can recover individual files, rather than whole save sets, and determine where and how you will locate the recovered data. The Save Set Recover Status window contains the following attributes: Save Sets - Lists the save sets selected for recovery. After you open the Recover Save Set Status window, the Save Set Recover window stays open, and you can still add or delete save sets to the Save Sets list by changing your selections in the Instances list. Paths to Recover - Enter the complete pathnames of individual files or directories you want to recover. Press [Return] to add them to the Paths to Recover list. Only pathnames beginning with the supplied value are recovered. Append a trailing slash ('/') to the end of the pathname to limit the recovery to a directory that exactly matches the supplied pathname. Pathnames can be changed, added, or deleted by using the Change, Add, and Delete buttons, respectively. NOTE: The Paths to Recover attribute is not supported with NDMP, but leave the attribute at the default path of the save set that is being recovered. IMPORTANT: Save set recover parses a directory string and restores all instances that match the leading string, unless limited by a forward slash (virgule). When specifying directory paths, be sure to place a forward slash after the directory name. For example, use '/user/user-a/test/' instead of '/user/user-a/test'. This ensures that only directory 'test' is restored, instead of 'test1', 'test2', and so on. See the recover(8) man page (especially the -S option) to understand the behavior of this attribute's filename pattern-matching. Volumes - Click this to open the Save Set Recover Volumes Required window, which lists the backup volumes that contain your data. All of the volumes required for all of the save sets listed in the Save Sets list are displayed. Use this information to verify that all required volumes are available or loaded in devices before you start the recovery process. For example, you might need to get a backup volume that has been stored at another site. Options - Click this to open the Save Set Recover Options window. Use this window to determine where and how you will recover the data. Status - Displays messages that report the status of the recovery. The Messages display of the ${NETWORKER} Administrator window displays the same information. Raw Device - Specifies the raw device on which an NDMP destructive restore is done. NOTE: If the raw device name of the destination is not specified, the save set is restored and the files are overwritten, but the current filesystem structure is retained. This attribute is used only with NDMP. Mount Point - Specifies the UNIX mount point at which the raw device would be mounted after an NDMP destructive restore. NOTE: This attribute is used only with NDMP. Start - Click this to start a recovery. YEK KEY:Save Set Recover Details TITLE:Save Set: Save Set Recover Details Window The Save Set Recover Details window is useful because it provides detailed information, including the size of the data you are recovering, and the name and location of the backup volume. To open the Save Set Recover Details dialog box, click Details in the Save Set Recover window. The Save Set Recover Details window contains the following items: name - Save set name date - Time and day the save set was backed up files - Number of files in the save set. The number could be zero if the save set was an incremental backup and the files had not changed since the last backup. ssid - Internal number assigned to the save set by ${NETWORKER} for purposes of tracking the data size - Size of the save set in bytes pool - Name of the pool to which the backup volume belongs status - Status of the backup volume volume - Backup volume name and its location (if it has one) YEK KEY: TITLE:Browsing Filesystems You can view or browse the contents of your filesystems, including directories, subdirectories, and nested files, in the user interfaces for the ${NETWORKER} backup and recover programs, nwbackup and nwrecover. This interface displays a graphical representation of the filesystem, and you can select files and directories to back up or recover. The ${NETWORKER} browsing features allow you to view directories, mark and unmark files, search for files, view file details, and change the current directory. YEK KEY:Changing the Server TITLE:Changing to a Different Server In all the ${NETWORKER} programs (nwbackup, nwrecover, nwarchive, and nwretrieve), you can select the ${NETWORKER} server to which to connect using the Change Server command. To change to another ${NETWORKER} server: 1. Select Change from the Server menu or click Change Server to open the Change Server dialog box. 2. Click Update Server List to display all of the ${NETWORKER} servers on your network. 3. Highlight the hostname of the desired server in the Server list, or enter a valid hostname in the Server field. 4. Click OK to complete the operation and close the window. YEK KEY:Disaster Recovery TITLE:Disaster Recovery ${NETWORKER} not only helps recover individual lost files, but also helps in case an entire disk, filesystem, or entire machine is lost. To recover a client system, re-install the operating system and the ${NETWORKER} software on the client. Then use the ${NETWORKER} recover program (nwrecover) to recover the client's lost files. Recovering a server system is somewhat more complex, because the server maintains the online indexes that ${NETWORKER} needs in order to recover files. If you have set up the network and enabled ${NETWORKER} to execute scheduled, network-wide backups, you are well prepared for such a disaster. Each time ${NETWORKER} backs up a group of clients, it also backs up all the online indexes for those clients, including the indexes for the server itself. The server's index backup (also called a bootstrap) is assigned an identification number, or save set id (ssid). ${NETWORKER} prints a record of the bootstrap so you have a piece of paper with the date, the name of the volume where the bootstrap is stored, and the save set id for bootstrap. You can also manually back up the $ {NETWORKER} server's indexes by using the savegrp command with the -O option. Refer to the savegrp man page for details. To recover a server system, re-install the server operating system and boot the server. Re-install ${NETWORKER} software on the server and configure the server as it was during the original installation. Mount the backup tape that contains the most recent backup named bootstrap (bootstrap contains the online indexes) and use the mmrecov command to extract the contents of the bootstrap backup. This recovers the online index. Then you can recover the server's filesystems using the ${NETWORKER} recover program. If you do not have the bootstrap information, you can still find the save set id of the most recent bootstrap by using the scanner command. For more information about this, and on the subject of disaster recovery, refer to the ${NETWORKER} Disaster Recovery Guide. YEK KEY: TITLE:Exiting ${NETWORKER} To exit ${NETWORKER} and return to the system prompt, select Exit from the File menu, or press both the [Alt] key and the [F] key at the same time, release them, and then press [X]. YEK KEY:Help TITLE:Help on Online Help ${NETWORKER} provides online Help to help you understand concepts, tasks, and the graphical user interface. For Help on concepts, such as, "What is a save set?", select On Topic from the Help menu, then scroll in the list to find the topic about which you want to read. For example, to answer the question, "What is a save set?", select Save Set: Save Set Concepts from the list. For help with doing a particular task, such as performing a manual backup, select On Topic from the Help menu, then scroll in the list to find the topic you want to read. For example, select Backup: Starting a Manual Backup from the list. For an explanation of the attributes in a ${NETWORKER} window, select On Window from the Help menu or click Help in the window. YEK KEY: TITLE:Marking and Unmarking Files In the nwbackup and nwrecover programs, choose files and directories for backup and recovery by marking them. To the left of the icons is a check box that displays a check mark when the file is marked. Mark or unmark files and directories by using either the Mark and Unmark speedbar buttons or by clicking the check box next to the file or directory. To mark a file or directory for backup or recovery using the speedbar buttons: 1. Highlight a file or directory icon by selecting it with the mouse. 2. Click Mark. This places a check mark in the check box beside the highlighted icon to mark it for backup or recovery. 3. If you decide that a file should not be included in the backup or recovery, highlight the icon and click Unmark to remove the check mark. To mark (or unmark) a file for backup or recovery using the check box next to the file icon: 1. Use the mouse to click the check box next to the file. This places a check mark in the check box. 2. Click the check mark to unmark the file. TIP: When a directory is marked for backup or recovery, all of its subdirectories and nested files are also marked. The check boxes of the parent directories turn gray to indicate that some or all of the directory contents are marked for backup or recovery. YEK KEY: TITLE:${NETWORKER} Programs ${NETWORKER} software consists the following programs: nwbackup - The ${NETWORKER} program used to back up data manually from the client side. nwrecover - The ${NETWORKER} program used to recover files. nwarchive - The ${NETWORKER} program used to archive files. (Optional program purchased separately) nwretrieve - The ${NETWORKER} program used to retrieve files that have been archived. Comes with optional archive program. YEK KEY:Permissions TITLE:Permissions To use the ${NETWORKER} software, you must make sure that the directory where you installed ${NETWORKER} is in the UNIX PATH variable for root on the ${NETWORKER} server and on each ${NETWORKER} client. For more information on permission issues, refer to the ${NETWORKER} Administrator's Guide, UNIX Version. YEK KEY:Searching for Files TITLE:Searching for Files If you know the name or partial name of a file or directory, you can use the Search window to locate it in the filesystem while performing a backup or in the online client file index while performing a recovery. You can use the Search speedbar button to bring up the Search window, or choose Search from the View menu. To search for a file, specify the filename or partial filename and the directory name where you want to begin the search. ${NETWORKER} begins searching in that directory and then searches through its subdirectories and nested files. To search for files or directories by name: 1. Click Search to open the Search window or select the Search command from the View menu. 2. Enter the name of the file or directory in the Search for field. Use standard UNIX shell pattern characters when specifying partial filenames. 3. Enter a valid pathname for the directory where you want to begin the search in the Begin search in field. ${NETWORKER} searches through that directory and all nested subdirectories. 4. Click OK. The pathname of the first match appears in the Selection field and is also highlighted in the file display. 5. Click Continue to highlight the next match. You can continue the search until ${NETWORKER} finds the last match. YEK KEY:Topics TITLE:Topics Select On Topics from the Help menu to display the list of Help topics. Select any topic from the list to display the Help text about it. YEK KEY:Version TITLE:${NETWORKER} Version ${VERSION} ${NETWORKER} Copyright (c) 2004-2006, ${COMPANY} Copyright (c) 2004-2006 EMC Corporation. All rights reserved. YEK KEY: TITLE:Viewing File Details The View menu contains the File Names and File Details command, where you choose to view the file details or only the file names in the file display. This command toggles between the choices. Viewing File Names is the default selection. The File Names command lists the files in alphabetical order, with only the file names displayed. The File Details command displays the file name, number of blocks, permissions, number of links and where they point (only applies to symbolic links), owner, group, size, and date each file was last modified. In the ${NETWORKER} Recover window, the File Details command displays an additional bit of information: the backup time for each file. You can use this to identify different backup versions of a file. To display the file details or just the file names: 1. Select File Details (or File Names) from the View menu. 2. If necessary, adjust the size of the window to display the contents of the window. YEK KEY: TITLE:Viewing Your Directories Use the Tree menu to select the level at which you want to browse the directories in the filesystem. You can expand a directory one level to view its subdirectories, or you can view all levels of a directory by expanding a branch. This makes it easy to find files deeply embedded in your filesystem. Expanding One Level The Expand One Level command opens a directory to display the subdirectories one level below. The subdirectories are graphically displayed as a tree structure in the directory display. You can scroll in the directory display to find the subdirectory that contains the file you want. To expand a directory one level: 1. Highlight a directory folder in the directory display. 2. Select Expand One Level from the Tree menu. Expanding a Branch The Expand Branch command displays all the levels of subdirectories in a directory. Large directories might take a few minutes to expand. To expand a directory to view the branch: 1. Highlight a directory in the directory display. 2. Select Expand Branch from the Tree menu. Collapsing a Branch The Collapse Branch command closes all subdirectories and returns to the level of the highlighted directory. To collapse a branch (close all subdirectories), follow these steps: 1. Highlight an expanded directory in the directory display. 2. Select Collapse Branch from the Tree menu. YEK