Legato NetWorker ClientPak and Storage Node User’s Guide ® Release 6.
Copyright © 1998, Legato Systems, Inc. All rights reserved. Legato NetWorker is a registered trademark of Legato Systems, Inc. All other trademarks are the property of their respective owners. LICENSE AGREEMENT THIS PRODUCT CONTAINS CERTAIN COMPUTER PROGRAMS AND OTHER PROPRIETARY MATERIAL, THE USE OF WHICH IS SUBJECT TO THIS LICENSE AGREEMENT. YOU ARE CONSENTING TO BE BOUND BY AND BECOME A PARTY TO THIS LICENSE AGREEMENT.
Contents Preface....................................................................................................................... 7 About This Guide............................................................................................................................. 7 Audience ................................................................................................................................... 7 Legato Product Manuals and Documentation .............................................
Contents Backing Up MPE Volume Sets...................................................................................................... 20 Naming Conventions for Backing Up MPE Volume Sets ....................................................... 20 How to Manually Back Up MPE Volume Sets ........................................................................ 21 Using the Command Interpreter....................................................................................... 21 Using the POSIX Shell ...
Contents Chapter 4: Archiving and Retrieving Files ........................................................... 45 Archiving Data ...............................................................................................................................45 Using the Command Interpreter..............................................................................................46 Using the POSIX Shell ........................................................................................................
Preface About This Guide The Legato NetWorker® User’s Guide, MPE/iX, Version, Release 5.5 contains instructions on how to use the NetWorker backup, recover, and archive software from an MPE/iX client workstation. MPE/iX is the operating system for Hewlett-Packard® HP 3000 business servers.
How to Navigate Through This Guide How to Navigate Through This Guide The guide is organized into chapters and sections to help you locate the kind of information you need, such as step procedures with examples: • The Preface on page 7 describes the typographic conventions and symbols used in this guide, as well as customer and technical support information. • Chapter 1 on page 11 provides an overview of NetWorker and MPE volume sets. • Chapter 2 on page 13 describes how to back up your data.
Preface Technical Support If you purchased technical support from HP, please refer to your HP Support Contract. You must register Legato NetWorker for MPE/iX with Legato Systems, Inc. before you can purchase Legato technical support. Please complete the registration form found on the last page of this guide. Legato also provides several sources to fulfill your technical support needs. Technical Support Service Address Hotline (650) 812-6100 E-mail support@legato.
Conventions Conventions This guide uses the following typographic conventions and symbols to make information easier to access and understand. • boldface, lowercase or UPPERCASE – Indicates references to NetWorker programs or commands within paragraphs as in the following example: You can start the NetWorker NSRSAVE program either from the MPE/iX Command Interpreter (CI) or from the POSIX shell if you prefer.
Chapter 1: Introduction to NetWorker Overview Legato NetWorker for MPE/iX is tightly integrated with HP’s TurboSTORE software to provide enterprise storage management capability. HP’s TurboSTORE/iX products provide high-performance backup solutions. NetWorker ClientPak for MPE/iX If you have used NetWorker software on a UNIX or NT server, then you know that NetWorker normally has a graphical user interface (GUI). The NetWorker ClientPak for MPE/iX does not have a GUI.
About Legato NetWorker for MPE/iX Archiving involves long-term storage of data on media called archive volumes. Archive volumes are similar to backup volumes, but are stored for long periods of time and are not automatically recycled. They are also not browsable if you want to recover them. 1 To conserve space, you can groom files from your system after archiving. Missioncritical data remains safely preserved for as long as you need it.
Chapter 2: Backing Up Files You can perform two types of backups with Legato NetWorker for MPE/iX: serverinitiated backups and client-initiated backups. This chapter describes how to perform client-initiated backups and briefly discusses server-initiated backups of an MPE client.
Client-Initiated Backups NetWorker saves directories, files, or MPE volume sets in groups called save sets. The save sets are saved to backup volumes on a NetWorker backup device. A NetWorker backup volume is a unit of media used for backup, such as a magnetic tape, a disk, or an optical disk. NetWorker stores and tracks your data on backup volumes on a regular basis. MPE volumes are disks on an MPE client; MPE volume sets are sets of disks.
Chapter 2: Backing Up Files Setting the NetWorker Time Zone to Match the HP STORE Program The HP STORE program runs in the Command Interpreter, which uses the local time zone for your MPE client. NetWorker runs in POSIX, which by default uses Greenwich Mean Time. To correct the potential discrepancy between time zones, you can set the TZ variable.
Setting System Variables for Client-Initiated Backups Storing Temporary Shadow Logs for Online Backups You can set the NSR_MPE_ONLINE_SAVE_LOGVOLSET system variable to specify the MPE volume set on which the 7x24 TurboSTORE will store the temporary shadow logs for online backups. Shadow logs contain the before-backup images of any files that are changed during the backup.
Chapter 2: Backing Up Files Controlling the 7x24 True Online Backup You can set three different controls for the 7x24 True Online Backup: • The ONLINE=START option allows you to perform file, database application, and system backups without closing the files or disks. This setting is the default. • The ONLINE option allows you to specify ONLINE without START or END. • The OFF option allows you to turn the ONLINE option off if changes are being made to files.
Backing Up a Directory Backing up your files can take a fair amount of time. NetWorker displays the following message while the backup is in progress: >> TURBO-STORE/RESTORE VERSION C.55.29 B5152AA << (C) 1986 HEWLETT-PACKARD CO.
Chapter 2: Backing Up Files Backing Up a File Backing up files is very similar to backing up directories. You can back up files from the CI or from the POSIX shell.
Backing Up MPE Volume Sets Backing Up MPE Volume Sets Only system administrators should back up volume sets. A backup of an MPE volume set takes a snapshot of the volume sets, including the directory information. Having this information backed-up prepares you for a disaster recovery. The system administrator should have configured your HP 3000 NetWorker MPE client to do server-initiated backups of volume sets.
Chapter 2: Backing Up Files How to Manually Back Up MPE Volume Sets You can save MPE volume sets manually from the MPE Command Interpreter (CI) or from the POSIX shell. Using the Command Interpreter From the CI, enter the following command to save an MPE volume set: : RUN NSRSAVE;INFO="-s jupiter /PROJECTS_VOLUME_SET"" 2 Backing up a volume set can take a fair amount of time. NetWorker displays the following message while the backup is in progress: >> TURBO-STORE/RESTORE VERSION C.55.
Backing Up MPE Volume Sets Note that in the sample display, the line entry "PROJECTS VOLUMESET MPE DIRECTORY ACCOUNTING FILE" corresponds to the directory accounting information file, which is identified in the NSRRECOV program as /PROJECTS_VOLUME_SET_DAF. In the previous version of NetWorker, the file was displayed as /PROJECTS_VOLUME_SET.
Chapter 3: Recovering Files This chapter describes how to: • Recover entire directories, individual files, groups of files, or MPE volume sets • Browse the NetWorker save sets for available recovery files and view the backup history of files • Recover files with earlier backup dates • Recover and relocate a file into a different client directory The NetWorker NSRRECOV Program The NetWorker NSRRECOV program replaces lost or damaged files from a copy stored on a NetWorker backup volume.
Setting System Variables for a Recovery Session Setting System Variables for a Recovery Session You can set system variables during a CI session to affect the recoveries that you perform during that specific CI session. Once you have set a system variable during a CI session, then the setting affects all recoveries performed during that session unless you turn the setting off.
Chapter 3: Recovering Files For information about the value used to set the TZ variable, display the timezone man page from the POSIX prompt only: $ man timezone Turning Off Parallel Backups If you turned on parallelism, then you can turn it off with the NSR_MPE_RECOV_PARALLELISM_OFF system variable.
The NSRRECOV Program To relocate files from one group to another, enter the following system variable during the current CI session: : SETVAR NSR_MPE_RECOV_GROUP "" You can also set this system variable from the POSIX shell: $ export NSR_MPE_RECOV_GROUP="" To relocate files from one account to another, enter the following system variable during the current CI session: : SETVAR NSR_MPE_RECOV_ACCOUNT "" You can also set this system variable from the POSIX shell: $ export NS
Chapter 3: Recovering Files • If you enter -iY, the i turns on parallelism and the Y overwrites any existing files. • If you enter -iN, the i turns on the parallelism and the N instructs the NSRRECOV program not to overwrite any existing files or directories. • If you turn on parallelism, you can set a system variable to turn it off again. See “Turning Off Parallel Backups” on page 25.
Browsing Save Sets that are Available for Recovery Interactive Browse Recovery To browse save sets and recover specific files, groups of files, directories, or MPE volume sets, start the NSRRECOV program and enter only the server and client parameters. You can also turn the overwrite prompt off and turn parallelism on during interactive browse recoveries.
Chapter 3: Recovering Files NSRRECOV Program Commands Table 1 provides NSRRECOV program commands to enter at the recover prompt. You can run the NSRRECOV commands with arguments. Table 1.
Recovering a Directory Recovering a Directory Once you have started the NSRRECOV program, you can recover an entire directory. This section assumes that you have started the NSRRECOV program and have changed to the save set where the recovery directory resides. To recover an entire directory, follow these steps: 1.
Chapter 3: Recovering Files VOLUME RESTRICTIONS SECTORS CODE DISC C MEDIA FILENAME 0 1 /projects/project1/reports* /rep1 /projects/project1/reports* /rep2 DISC :C /projects/project1/reports* 0 1 0 1 /rep3 DISC :C /projects/project1/reports* 3 /rep4 DISC :C /projects/project1/reports* 0 1 0 HFSDIR 1 /rep5 DISC :C /projects/project1/reports* // Received 6 file(s) from NSR server ‘jupiter’ Recover completion time: Wed Dec 17 16:58:31 1997 recover> Recovering a File If more than one version
Recovering a File 3. Mark the file that you want to recover as follows: recover> add rep1 The following message is displayed: 1 file(s) marked for recovery To add other files to the recovery list, repeat the add command. 4. (Optional) Verify the marked files in the recover list as follows: recover> list /projects/project1/reports/rep1 @ Wed Dec 4 10:36:07 1996 1 file(s) marked for recovery 3 5.
Chapter 3: Recovering Files Recovering a Group of Files You can recover a group of files with common character patterns in their filenames. For example, if you have a directory with five files starting with the letter r, you can recover those files by entering the minimum number of characters that form a pattern and substituting an asterisk for the different characters. NetWorker searches for the files with the matching patterns. Table 2 shows some sample search patterns. Table 2.
Viewing the Backup History VOLUME RESTRICTIONS DISC :C /projects/project1/reports* SECTORS CODE MEDIA FILENAME 0 1 0 1 0 1 0 1 0 1 /rep1 DISC :C /projects/project1/reports* /rep2 DISC :C /projects/project1/reports* /rep3 3 DISC :C /projects/project1/reports* /rep4 DISC :C /projects/project1/reports* /rep5 Received 5 file(s) from NSR server ‘jupiter’ Recover completion time: Wed Dec 17 17:02:39 1997 Viewing the Backup History If you have several backups of the same directory or file, you ca
Chapter 3: Recovering Files 491520 -rw-rw-rw- 0 MANAGER.SYS 211 Jan 31 14:06 rep1 save time: Tues Sep 30 14:08:10 1997 location: projects.001 at /dev/rmt/0mbn Display more versions of ‘projects/project1/reports/rep1’ [y]? Table 3 explains the information in the previous example of a backup history. Table 3.
Recovering a File That Already Exists To recover files with an earlier backup date, follow these steps: 1. To recover an earlier backup, enter the changetime command and the new browse time.
Chapter 3: Recovering Files Enter one of the following responses to the message: • n – NetWorker does not overwrite the existing file and displays the following message: skipping recover of /projects/project1/reports/rep1 Received 1 file(s) from NSR server ‘jupiter’ • y – NetWorker overwrites the original file and displays the following message: overwriting /projects/project1/reports/rep1 VOLUME RESTRICTIONS DISC :C /projects/project1/reports/rep1 SECTORS CODE 16 MEDIA FILENAME 1 3 Received 1 file(s
Recovering a File That Already Exists The second time that you recover an existing file in the same recovery session, NetWorker automatically overwrites the existing file without displaying a warning prompt. When the recovery is complete, NetWorker displays the following message: Recovering 1 file into its original location Volumes needed (all on-line): jupiter.012 at /source/rmt/data Requesting 1 file(s), this may take a while...
Chapter 3: Recovering Files Recovering and Relocating Files You can recover files to a different directory, group, or account from the one where they were originally stored by using the NRSRECOV program relocate command. The relocate command overrides the NSR_MPE_RECOVER_GROUP and the NSR_MPE_RECOVER_ACCOUNT system variables if you set them for the current recovery session. See “Relocating Files from One Group or Account to Another” on page 25.
Recovering and Relocating Files The following message is displayed: Recovering 2 files within /projects/project1/documents/ into /projects/project1/ reports Volumes needed (all on-line): jupiter.012 at /source/rmt/data Requesting 2 file(s), this may take a while... >> TURBO-STORE/RESTORE VERSION C.55.29 B5152AA << (C) 1986 HEWLETT-PACKARD CO.
Chapter 3: Recovering Files Recovering Volume Sets Only system administrators should recover volume sets. You can perform three types of recoveries of MPE volume sets: 1. Non-interactive recovery of the directory accounting information file (DAF) for an MPE volume set. A directory accounting information file contains the group and account information for the MPE volume set and any other file or directory on that volume set. 2.
Recovering Volume Sets Important: Do not append _VOLUME_SET to the end of an MPE system volume set. When an HP system is installed, it automatically creates the MPE system volume, MPEXL_SYSTEM_VOLUME_SET. The name of the directory accounting information file for an MPE volume set is the same as the name of the MPE volume set for previously saved data. The new name has an extra tag, _DAF.
Chapter 3: Recovering Files To recover MPE volume sets with the most recent backup date, follow these steps: 1. Change to the save set where the MPE volume set resides, for example: recover> cd / 2. (Optional) List the files in the current save set as follows: recover> ls /PROJECTS_VOLUME_SET_DAF NetWorker displays the following information: PROJECTS_VOLUME_SET_DAF SYS PROJGRP1 3.
Recovering Volume Sets 5. Once you have recreated and mounted a non-system volume set, perform a save set recovery.
Chapter 4: Archiving and Retrieving Files This chapter describes how to archive and retrieve files using the optional NetWorker Archive Application. Archiving Data The backup and archive processes serve very different purposes. Backup is short-term insurance against data loss. NetWorker keeps track of backups in the online file index to enable you to recover lost or corrupted files quickly. This online file index requires considerable disk space.
Archiving Data You can archive a directory and verify the archive in one step. NetWorker verifies the archive by comparing the data on the archive volume with the data on the local disk, byte for byte, attribute for attribute. If there are any discrepancies, NetWorker lets you know. The NSRARCH command for archiving and verifying the archive includes the following parameters: 4 • -s, the parameter for the server. The name of the server to which you are archiving the directory.
Chapter 4: Archiving and Retrieving Files HFS DIRECTORIES STORED : 10 FILES STORED : 29 TOTAL MEDIA WRITTEN : 0 Archive Completion Information Completed: Mon Dec 15 14:45:26 1997 Save set(s): /projects/project1 Verified: Yes Volume(s): projects.archive.
Grooming Your Directories Cloning an Archive from the Command Interpreter From the CI, enter the following command to archive and clone the archive: : RUN NSRARCH;INFO=“-s server -b volume pool -V -C “clone volume pool“ -T “annotation text“ directory_pathname“ For example: : RUN NSRARCH;INFO=“-s jupiter -b “Project Archive“ -V -C “Projects Clone“ -T “project1“ /projects/project1“ Archiving and cloning an archive might take a long time.
Chapter 4: Archiving and Retrieving Files To archive and groom a directory, follow these steps: 1. From the CI, archive and groom a directory as follows: : RUN NSRARCH;INFO=“-s server -G remove -T “annotation text“ directory_pathname“ For example: : RUN NSRARCH;INFO=“-s jupiter -G remove -T “project1“ /projects/project1“ NetWorker displays the list of directories and files and prompts you to confirm the removal of the directory.
Retrieving Archived Files Retrieving Archived Files NetWorker retrieves archived files by copying files from an archive volume to a local disk. Unless you are manager.sys, you must own the directories or files to retrieve them. You need to know the save set ID (identification) number and the name of the archive pool. If you are not sure, ask your system administrator to check the information with the NetWorker software on the server of which you are a client.
Appendix A: Error Messages NetWorker provides error messages to help you solve backup, recovery, and archive problems that you might encounter. This section contains a list of error messages for the NSRSAVE, NSRARCH, NSRRECOV, NSRRETRV, and SAVEFS programs for the NetWorker ClientPak for MPE/iX. Error Messages The error messages, listed in Table 4, are listed in alphabetical order. The tables also provides the cause of each error message and a solution. Table 4.
Appendix A: Error Messages Table 4. Error Messages (Continued) Error Message ‘12:20:14:00’ not valid, time not changed Displayed in the following NetWorker program: NSRRECOV Cause The change time you entered while trying to recover was an invalid time format. Solution Enter the time using a valid time format. Error Message: Annotation must contain only alphanumeric characters on MPE/iX systems.
Appendix A: Error Messages Table 4. Error Messages (Continued) Error Message: Cannot build recover list - volume set violation Displayed in the following NetWorker programs: NSRRECOV, NSRRETRV Cause: You tried to recover a directory accounting information file for a volume set along with a version of some other file or directory from another save set or save time. NetWorker does not allow you to mix save times to ensure data integrity.
Appendix A: Error Messages Table 4. Error Messages (Continued) Error Message: filter_mpe_volsets failed Displayed in the following NetWorker programs: NSRSAVE, NSRARCH Cause: NetWorker found a temporary memory problem. Solution: Try one of the following solutions: • Retry the command. • Reboot the host system.
Appendix A: Error Messages Table 4. Error Messages (Continued) Error Message Nothing marked for backup Displayed in the following NetWorker programs: NSRSAVE, NSRARCH Cause You started a backup or archive without marking files. Solution Start the backup or archive again; mark at least one file. Error Message NSRSAVE: invalid time specification: ‘20d1978’ Displayed in the following NetWorker program: NSRSAVE Cause You entered the time with an invalid time format.
Appendix A: Error Messages Table 4. Error Messages (Continued) Error Message Unable to relocate to /directory Displayed in the following NetWorker program: NSRRECOV Cause NetWorker was unable to relocate the recovered file to the path you specified. Solution Start the recovery again and enter a valid pathname. Note that you must have write permissions for the directory you specify.
Appendix A: Error Messages Table 4.
Appendix B: Common NetWorker Commands This appendix contains a table of common NetWorker commands and instructions on how to display the man pages. Common NetWorker Commands Table 5 lists some commonly used NetWorker client commands, the command used to display the man page, and a brief description of the command. Table 5. Common NetWorker Commands MPE/iX Command UNIX Manual Page Description JBCONFIG jbconfig Configures a jukebox (Media Changer Device) for a NetWorker server.
Appendix B: Common NetWorker Commands Table 5. Common NetWorker Commands (Continued) B MPE/iX Command UNIX Manual Page Description NSRIZE nsr_ize Installs and removes NetWorker NSRJB nsrjb Manages jukeboxes for NetWorker servers. NSRMM nsrmm Labels, mounts, unmounts, deletes, and purges volumes NSRMMD nsrmmd The nsrmmd daemon provides RPCbased media multiplexing and demultiplexing service.
Glossary This glossary contains terms and definitions found in this manual. Most of the terms are specific to NetWorker products. annotation A comment that you associate with an archive save set to help identify that data. Annotations are stored in the media index for ease of searching and are limited to 1024 characters. Application-Specific Module (ASM) A program that, when used in a directive, specifies the way a set of files or directories is to be backed up and recovered.
Glossary Glossary 62 back up The process of saving a copy of your files or directories onto a separate medium. backup volume Backup media, such as magnetic tape or optical disk. bootstrap Information that includes the server index, media index, and configuration files needed for recovering NetWorker after a disk crash. browse policy The policy that determines how long entries for your files remain in the online file index.
Glossary 1. A file tree on a specific disk partition or other mount point. 2. The entire set of all files. 3. A method of storing files. full (f) A backup level in which all files are backed up, regardless of when they last changed. grooming The process of removing files after a successful archive. group A client or group of clients that starts backing up their files at a designated time.
Glossary Glossary 64 operator The person who monitors the server status, loads backup volumes into the server devices, and otherwise executes day-to-day tasks using NetWorker. override An interim backup level that takes place instead of the scheduled one. pathname Instructions for accessing a file. An absolute pathname tells you how to find a file beginning at the root directory and working down the directory tree.
Glossary Client backups scheduled on a server to occur automatically. shell prompt A cue for input in a shell window where you enter a command. skip (s) A backup level in which files are skipped and not backed up. stand-alone device A backup device that contains a single drive for backing up data. Stand-alone devices cannot store or automatically load backup volumes.
Index A about this guide 9 add NSRRECOV command description 29 example 30 archive archive volumes 12, 45 archiving and verifying 46 cloning 47 retrieving files 50 audience 7 available recovery files, browsing directories 28 B backing up 21 directories 17 files 19 group of files 19 how to backup MPE volume sets 21 MPE volume sets 20 backup dates, preserving original backup dates 24 backup history of a file information explained 35 viewing 34 backups client-initiated 14 server-initiated 13 browsing director
Index browsing for recovery 41 how to perform a manual back up 21 interactive-browse recovery of directory information files 42 listing groups in an MPE volume set 22 naming conventions 20, 42 naming conventions for recovering 27 non-interactive recovery 27 non-interactive recovery of directory information files 42 recovering entire MPE volume sets 43 save set-based recovery 43 turning off prompts 26 turning on parallel recovers 26 a group of files 33 groups of files 33 if file already exists 36 relocatin
Index backing up a file from CI 19, 21 backing up a file from POSIX 18–19 backing up a group of files (POSIX) 19 backing up directories from CI 17 O overview archiving and retrieving files 45 backing up files and directories 13 NSRRECOV program 23 owner, name change 25 P parallelism turning off 25 turning on for recovers 26 POSIX NSRARCH archiving and verifying 47 cloning an archive 48 NSRRECOV starting the NSRRECOV program NSRRETRV retrieving files 50 NSRSAVE backing up a file 18–19 backing up a group o
Index specifying notification at start or end of online backup 16 storing temporary shadow logs 16 turning off parallel recovers 25 T table commands for displaying man pages 59 common NetWorker commands 59 information in the backup history of a file 35 recover commands 29 search patterns for recovering groups of files 33 time formats, valid 36 time zone, setting NetWorker time zone to match HP STORE process 15 True Online Backup, controlling 17 TurboSTORE online backups, storing temporary shadow logs 16