Legato NetWorker ClientPak™ for MPE/iX User’s Guide ®
Copyright © 1997, 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.
Contents Preface ............................................................................................................ 7 Audience ............................................................................................................................ 8 About This Guide ............................................................................................................... 8 Customer Feedback...................................................................................................
Contents Listing Groups in an MPE Volume Set.......................................................................26 Chapter 3: Recovering Files........................................................................27 The NetWorker NSRRECOV Program .............................................................................27 Setting System Variables .................................................................................................28 Preserving the Original Backup Date ..................
Contents Retrieving Archived Files ................................................................................................. 59 Appendix A: Error Messages...................................................................... 61 Error Messages................................................................................................................ 61 Valid Time Formats ..........................................................................................................
Contents vi
Preface The Legato NetWorker ClientPak for MPE/iX 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’s HP 3000 business servers. This guide explains how to back up data on MPE/iX client to aNetWorker server. It also explains how to browse the online file index to recover data. Instructions for using the optional Legato NetWorker Archive Application are also included.
Audience Audience Users and system administrators who do client-initiated backups, recovers, and archives from an HP 3000 MPE Networker client will benefit from this guide. This guide assumes that you are an experienced MPE/iX user. About This Guide This guide contains information on backing up and recovering data using the NetWorker MPE/iX NSRSAVE and NSRRECOV programs. Instructions for using the NSRARCH and NSRRETRV programs are also included.
Preface Information and Services Legato offers a variety of services, including electronic, telephone, and fax support that provide company, product, and technical information. Legato Service or Resource Technical Bulletins Binary Patches http://www.legato.com Yes Yes ftp.legato.com, Internet address 137.69.200.1 (log in as anonymous) Yes Yes FaxWorker, interactive fax service, (650) 812-6156 Yes e-mail request server, request@legato.
Technical Support Technical Support If you purchased technical support from HP, please refer to your HP Support Contract. You must register the Legato NetWorker CleintPak 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.
Preface 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 This chapter gives an overview of Legato NetWorker. It also gives an overview of volume sets, the new feature added to release 5.0 of NetWorker ClientPak for MPE/iX. Overview of Legato NetWorker Legato NetWorker is a software product for network storage management. A NetWorker client is a machine on the network configured to have its files automatically backed up by the NetWorker server.
Overview of Legato NetWorker To conserve space, you can groom files from your system after archiving. Mission-critical data remains safely preserved for as long as you need it. 1 The optional Legato NetWorker Archive Application provides the ability to take a snapshot of finished project files, directories, or MPE volume sets residing on primary media.
Chapter 1: Introduction Only system administrators should backup, recover, or archive volume sets. The primary purpose of the MPE volume set function is for backing up entire MPE volume sets as part of a disaster recovery plan. Should a disaster occur, you can recover the NetWorker save sets for the MPE volume sets and restore them. Displaying the Man Pages Man pages are online descriptions of the NetWorker commands. You must display the man pages from the /SYS/NETWRKR directory.
Chapter 2: Backing Up Files You can do two types of backups with Legato NetWorker ClientPak for MPE/iX: server-initiated backups and client-initiated backups. This chapter describes how to do client-initiated backups. This chapter also briefly discusses server-initiated backups of an MPE client. However, for comprehensive information on how to configure your MPE client to do serverinitiated backups, refer to the Legato NetWorker Administrator’s Guide that is distributed with the NetWorker server software.
Client-Initiated Backups Backing up files is short-term insurance against data loss. The NetWorker server to which your HP 3000 is a client automatically backs up your files according to a backup schedule determined by your system administrator. 2 For an overview on how to perform manual backups of directories, files, or volume sets on an as-needed basis from your HP 3000, see “Client-Initiated Backups” (on page 18). NetWorker saves directories, files, or MPE volume sets in groups called save sets.
Chapter 2: Backing Up Files Setting System Variables for Client-Initiated Backups You can set system variables in a CI session to affect client-initiated backups that you perform from that specific session. Once you have set a system variable in a CI session, then the setting affects all manual backups done during that session until you turn the setting off in that CI session.
Backing Up a Directory For information about the value to set the TZ variable, display the timezone man page from the POSIX prompt only: 2 $ man timezone Creating Logs of Your NetWorker Manual Backups You can set the NSR_MPE_LOGNAME variable to save information on clientinitiated backups in a log file.
Chapter 2: Backing Up Files : RUN NSRSAVE;INFO="-s server /directory_pathname" 2 For example, : RUN NSRSAVE;INFO="-s jupiter /projects/project1/reports" In the example, jupiter is the name of the server and /projects/project1/reports is the directory pathname. Backing up your files can take a fair amount of time. NetWorker displays the following message while the backup is in progress : Legato NetWorker for MPE/iX version 5.0 (C) 1997 Legato Systems Inc. >> TURBO-STORE/RESTORE VERSION C.55.
Backing Up a File ONLINE BACKUP UTILIZED DISC SPACE FOR LOG ON THE FOLLOWING VOLSETS: 2 MPEXL_SYSTEM_VOLUME_SET : 0 KB HFS DIRECTORIES STORED : 1 FILES STORED : 5 TOTAL MEDIA WRITTEN : 0 NSRSAVE: /projects/project1/reports 15 KB 00:00:04 files 9 The last four items in the message are TurboSTORE information items that are not interpreted by NetWorker.
Chapter 2: Backing Up Files Backing Up a Group of Files You can back up a group of files with common character patterns in their filename, but only from the POSIX shell. For example, if you have a directory with five files starting with the letter r, then you can back up all those files at once by entering the minimum number of characters that form a pattern and substituting an asterisk for the different characters.
Backing Up MPE Volume Sets if you were backing up all your project files that reside exclusively on an MPE volume set, PROJECTS, you would name the volume set PROJECTS_VOLUME_SET. 2 Important: NetWorker identifies the MPE volume set, PROJECTS_VOLUME_SET, as PROJECTS_VOLUME_SET_VOLUME_SET; NetWorker does not consider the first _VOLUME_SET string. When NetWorker saves an MPE volume set it saves the file directory information in the file PROJECTS_VOLUME_SET.
Chapter 2: Backing Up Files :S 32 GROUP 1 /DOCTOR/SURGEON/ :C 0 1 /DOCTOR/SURGEON/ pcadir :S 32 ACCT 1 /SYS/ :S 32 GROUP 1 /SYS/PUB/ :S 32 GROUP 1 /SYS/PROJG001/ DISC :C 32 HFSDIR 1 /SYS/PUBKG001/ tempreloc/ DISC :C 16 1 /SYS/PROJG001/ testfile.
Backing Up MPE Volume Sets Listing Groups in an MPE Volume Set 2 You can get a list of all accounts and groups in an MPE volume set that NetWorker backs up in a server-initiated backup.
Chapter 3: Recovering Files This chapter describes how to recover entire directories, individual files, groups of files, or MPE volume sets. It also describes how to browse the NetWorker save sets for available recovery files, view the backup history of files, or recover files with an earlier backup dates. Finally, it describes how to recover and relocate a file into a different client directory.
Setting System Variables You can do two types of recoveries: 3 • • Interactive-browse recoveries Noninteractive recoveries With interactive recoveries, you browse the save sets and mark specific files that you want to recover. With noninteractive recoveries, you do not browse the save sets or mark specific files; you enter the NSRRECOV command, the command parameters, and the file path of the file that you want to recover.
Chapter 3: Recovering Files Setting the NetWorker Time Zone to Match the HP STORE Process The HPSTORE runs in in the Command Interpreter which uses the time zone set for your MPE client. NetWorker runs in POSIX, which by default is Greenwich Mean time. To correct a potential discrepancy between time zones, you must set the TZ variable.
The NSRRECOV Program The NSRRECOV Program 3 You can start the NSRRECOV program from the MPE/iX Command Interpreter (CI) or from the POSIX if you prefer. You can only recover files that you have previously backed up. You can start the NSRRECOV program from any directory; however, if you start it from a directory that has not been previously backed up by NetWorker, then NetWorker prompts you to enter the name of the save set that you want to browse.
Chapter 3: Recovering Files • • • -iN, which turns overwrite prompt off; consistently does not overwrite existing files, directories, or MPE volume set directory information files; and turns parallelism on. -a, the automatic parameter for noninteractive recoveries. The file path of the file, directory, or MPE volume set that you want to recover.
Browsing Save Sets for Available Recovery Files The following prompt is displayed: 3 NSRRECOV: Current working directory is /projects From POSIX, enter the following command to start the NSRRECOV program: $ NSRRECOV -s server -c client (The client name is optional). Once you have started the NSRRECOV program, you can browse saves sets for individual files, groups of files, directories, or volume sets.
Chapter 3: Recovering Files Table of NSRRECOV Program Commands 3 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 3 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 (C) 1986 HEWLETT-PACKARD CO. 3 RESTORE ; ;SHOW;NW3K;CREATE WED, DEC 17, 1997, 4:58 PM 'CREATE' OPTION DEFAULTING TO 'CREATE=ACCOUNT,GROUP,CREATOR,PATH' BASED ON YOUR CAPABILITIES (S/R 502) WARNING: YOUR DEFAULT FILESET BECOMES '@.@.
Recovering a File Recovering a File 3 If more than one version of a backed-up file exists, NetWorker automatically recovers the file with the most recent backup date. This section describes how to recover a file or files with the most recent backup date. This section assumes that you have started the NSRRECOV program. To recover files with the latest backup date, follow these steps: 1. Change to the save set where the file resides, for example: recover> cd reports 2.
Chapter 3: Recovering Files >> TURBO-STORE/RESTORE VERSION C.55.29 B5152AA 3 << (C) 1986 HEWLETT-PACKARD CO. RESTORE ; ;SHOW;NW3K;CREATE WED, DEC 17, 1997, 5:00 PM 'CREATE' OPTION DEFAULTING TO 'CREATE=ACCOUNT,GROUP,CREATOR,PATH' BASED ON YOUR CAPABILITIES (S/R 502) WARNING: YOUR DEFAULT FILESET BECOMES '@.@.
Recovering a Group of Files 1. 3 Mark the files that you want to recover by entering the NetWorker add command, then enter the characters that create a common pattern in the filename and substitute an asterisk for the different characters in the filename, as in the following example: recover> add r* The following message is displayed: 5 file(s) marked for recovery 2.
Chapter 3: Recovering Files DISC :C /projects/project1/reports* 0 1 3 /rep3 DISC :C /projects/project1/reports* 0 1 0 1 /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 can display the different versions by displaying the backup history.
Recovering a File with an Earlier Backup Date 491520 -rw-rw-rw- 3 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.
Chapter 3: Recovering Files time of 14:08:10, you could change the browse time to 14:08:50. If you change the browse time to 14:09:00, then the file with the save time of 14:08:55 would be recovered. This section assumes that you have started the NSRRECOV program and have displayed the backup history of the file. 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.
Recovering a File That Already Exists Recovering a File That Already Exists 3 If you try to recover a file that already exists in the client directory, NetWorker tells you that the file exists and gives you the options of discarding the recovered file, overwriting the existing file with the recovered file, or renaming the recovered file. This section assumes that you have started the NSRRECOV program, changed to the save set where the saved file resides, marked the file, and started the file recovery.
Chapter 3: Recovering Files • r – NetWorker does not overwrite the existing file, but recovers and renames the file with a .R extension, for example, rep1.R. NetWorker displays the following message: 3 renaming /projects/project1/reports/rep1 to /projects/project1/reports/rep1.R DISC :C /projects/project1/reports/rep* 16 1 1.
Recovering a File That Already Exists Requesting 1 file(s), this may take a while... 3 /projects/project1/reports/rep2 /projects/project1/reports/rep2: file exists, overwriting DISC :C /projects/project1/reports/rep2 16 1 Received 1 file(s) from NSR server `jupiter' • R – NetWorker recovers and renames the file with a .R extension and displays the following message: Recovering 1 file into its original location renaming /projects/project1/reports/rep3 to /projects/project1/reports/rep3.
Chapter 3: Recovering Files Recovering and Relocating Files You can recover files into a different directory from where they were originally stored by using the NetWorker relocate command. When you relocate files, they will retain the same name and file attributes. Marking a group of files to relocate to another directory is the same as recovering a group of files.
Recovering and Relocating Files 4. 3 Enter the relocate command and the client directory pathname to which you want to relocate the files, for example: recover> relocate /projects/project1/reports 5. Start the recovery process: recover> recover 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...
Chapter 3: Recovering Files Received 2 file(s) from NSR server `jupiter' 3 Recover completion time: Wed Dec 17 17:13:32 1997 6. (Optional) Verify that the files have been recovered: a. Quit the NSRRECOV program as follows: recover> quit b. Change to the relocation client directory; for example: $ cd ../ $ pwd /projects/project1 $ cd reports c.
Recovering Volume Sets The NSRRECOV program for recovering MPE volume sets includes the special directory information file that allows you to rebuild the accounts and groups of the volume set. 3 For information on recovering an entire MPE volume set in case of a disaster, see “Restoring an Entire MPE Volume Set: Disaster Recovery” (on page 50).
Chapter 3: Recovering Files directory information in the file PROJECTS_VOLUME_SET. Using the example, when you recover this specific file, it will contain only the file directory information. To recover all the files and directories on an MPE volume set, you use the save set identification (ssid) for the volume set. Refer to “Recovering Volume Sets” in “Chapter 3: Recovering Files” of the Legato NetWorker ClientPak for MPE/iX User’s Guide for more information on recovering MPE volume sets.
Recovering Volume Sets To recover MPE volume sets with the latest backup date, follow these steps: 3 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 NetWorker displays the following information: PROJECTS_VOLUME_SET SYS PROJGRP1 3.
Chapter 3: Recovering Files 4. Obtain the save-set identification (ssid) with the following server command: 3 $ mminfo -s jupiter -aV -t /PROJECTS_VOLUME_SET or $ mminfo - s tempest -aV -t "nov10" Note that you can also obtain this information through the nwadmin Graphics User Interface. 5. Once you have recreated and mounted a nonsystem volume set, do a saveset 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 directories or individual files. Like backup and recover, you can start the NSRARCH program during an MPE/iX CI session or from the POSIX shell if you prefer. 4 When you archive, you have the options of verifying the archive, cloning the archive, and grooming directories once the archive is complete. Cloning and grooming are discussed under separate sections (see “Cloning an Archive” on page 56 and “Grooming Your Directories” on page 57).
Chapter 4: Archiving and Retrieving Files • • If you do not specify a volume pool for your archive, the volume pool defaults to Archive. If you do not know which volume pool to choose, contact the system administrator.
Cloning an Archive Cloning an Archive 4 NetWorker clones an archive by making a duplicate copy of the archive. Usually system administrators clone archives. Before making a clone of your archive, you might want to check with your system administrator. Two backup devices are required to make a clone: one for the original archive volume and the other for the archive clone volume. Each backup device must have a valid, writable archive volume mounted.
Chapter 4: Archiving and Retrieving Files When archiving and cloning the archive are completed, NetWorker displays the following information: Archive Completion Information Completed: Mon Dec 15 14:55:12 1997 Save set(s): /projects/project1 Cloned: Yes Volume(s): projects.archive.
Grooming Your Directories For example: 4 : 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. NSRARCH:/rene/projectx/documents 23 KB 00:00:08 9 files ONLINE BACKUP UTILIZED DISC SPACE FOR LOG ON THE FOLLOWING VOLSETS: remove all files and directories archived (y/n)? [n] 2.
Chapter 4: Archiving and Retrieving 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 need to own 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, recover, and archive problems that you might encounter. Error Messages The error messages in Table 4 are listed in alphabetical order. Table 4. NetWorker Error Messages Message Cause Solution Nothing marked for backup You started a backup without marking files. Start the backup or archive again; mark at least one file.
Valid Time Formats Table 4. NetWorker Error Messages (Continued) A Message Cause Solution Unable to relocate to /directory NetWorker was unable to relocate the recovered data to the path you specified. Start the recovery again and enter a valid pathname. You must have write permission for the directory you want to use. Unable to start backup NetWorker was unable to execute the NSRSAVE program.
Appendix B: Recover Commands This appendix contains a table of NSRRECOV program commands. Table of NSRRECOV Program Commands Table 5 provides NSRRECOV program commands to enter at the recover prompt. You can run the NSRRECOV commands with arguments. Table 5.
Table of NSRRECOV Program Commands Table 5.
Appendix C: Common NetWorker Commands This appendix contains a table of common NetWorker commands. Table of Common NetWorker Commands Table 6 lists some commonly used NetWorker client commands, the manual page reference, and a description of the command. Where you see uppercase and lowercase under the heading Manual Page, you can use either uppercase or lowercase to display the man page.
Displaying the Man Pages Table 6.
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 68 autochanger A mechanism that uses a robotic arm to move media among various components—including slots, media drives, media access ports, and transports—located in a device. Autochangers automate media loading and mounting functions during backups and recoveries. back up The process of saving a copy of your files or directories onto a separate media. backup volume Backup media, such as magnetic tape or optical disk.
Glossary The backup device (tape drive, optical drive, or autochanger) connected to the NetWorker server, used for backing up and recovering client files. directive An instruction that directs NetWorker to take special actions on a given set of files. file index A database of information maintained by NetWorker that tracks every file or filesystem backed up. fileserver A machine with disks that provides services to other machines on the network. filesystem 1.
Glossary Glossary 70 media Magnetic tape or optical disks used to back up files. media index A database of information maintained by NetWorker that tracks every backup volume. media manager The NetWorker component that tracks save sets to backup volumes. NetWorker Legato’s network-based software product to back up and recover filesystems. NetWorker client A machine that can access the backup and recover services from a NetWorker server.
Glossary The NetWorker command used to browse the server index and recover files from a backup volume to a client’s disk. recycle A volume whose data has passed both its browse and retention policies and is available for relabeling. retention policy Policy that determines how long entries will be retained in the media index and thus be recoverable. retrieval The process of locating and copying back files and directories that NetWorker has archived.
Glossary Glossary 72 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. system administrator The person normally responsible for installing, configuring, and maintaining NetWorker. user The person who can use NetWorker from his or her workstation to back up and recover files. volume Backup media, such as magnetic tape or optical disk.
Index A about this guide 8 add NSRRECOV command description 33, 63 example 34 archive archive volumes 13, 53 archiving and verifying 54 cloning 56 retrieving files 59 audience 8 available recovery files browsing directories 32 B backing up directories 20 files 22 group of files 23 how to backup MPE volume sets 24 MPE volume sets 23 backup dates preserving original backup dates 28 backup history of a file information explained 40 viewing 39 backups client-initiated 18 server-initiated 17 browsing directorie
Index F file already exists canceling recovery 42 renaming a recovered file 43 files archiving 53 backing up 22 backing up a group 23 browsing directories for available recovery 32 recovering a file with an earlier backup date 40 recovering a group of files 37 recovering a single file 36 recovering and relocating recovered files 45 recovering if file already exists 42 retrieving after archive 59 viewing the backup history 39 force NSRRECOV command 33, 63 G grooming directories 57 H help NSRRECOV command
Index N O overview archiving and retrieving files 53 backing up files and directories 17 NetWorker 13 NSRRECOV program 27 P parallelism turning on for recovers 30 parallelism, turning off 29 POSIX 23 NSRARCH archiving and verifying 55 cloning an archive 57 NSRRECOV starting the NSRRECOV program 32 NSRRETRV retrieving files 59 NSRSAVE backing up a file 22 prompts turning on for recovers 30 pwd NSRRECOV command description 33, 64 example 32 Q quit NSRRECOV command 33, 64 quitting the Recover program 47 In
Index Index R recover commands 33, 63 recover NSRRECOV command description 33, 64 example 34 recover program starting 30 recovering a single file 36 directories 34 file that already exists 42 file with an earlier backup date 40 group of files 37 recovering and relocating files 45 recovering files browsing directories 32 overview 27 recovery, disaster 50 relocate NSRRECOV command description 33, 64 relocating files rules for groups and accounts 45 when recovering 45 renaming a recovered file if file alread
Index V valid time formats 41, 62 verbose NSRRECOV command 33, 64 versions NSRRECOV command description 33, 64 example 39 viewing the backup history of a file 39 volume sets 47–49 backing up 23 how to manually backup 24 interactive-browse recovery of directory information files 49 listing groups in an MPE volume set 26 naming conventions 23, 48 naming conventions for recovering 48 recovering entire MPE volume sets 50 volumes NSRRECOV command 33, 64 Index 77
