Page i Introduction to the Backup VAP This manual explains how to use the NetWare Backup VAP to back up and restore data on a file server. It also explains how to install the NetWare Backup VAP. You can use the NetWare Backup VAP to back up and restore data on a NetWare v2.2 file server. The Backup VAP will back up and restore both DOS files and Apple File Protocol (AFP) files. Because the Backup VAP is a process that runs on top of the NetWare operating system, you can use it to back up and restore data while the file server is up and running. The Backup VAP can be operated at the console of either a file server or a router containing a tape drive unit. Organization of the manual This manual contains the following sections, each starting on the indicated page. Installation 1 BACKUP utility 7 RESTORE utility 17 Error messages 32 Page ii Who needs to read what? Installation If the Backup VAP has not been installed on your file server or router, complete the instructions in the "Installation" section. (See page 1.) Installation is usually a one-time process. BACKUP utility To back up network data to a tape cartridge, complete the instructions in the "BACKUP Utility" section. (See page 7.) You should back up data as often as necessary to ensure that losses from accidental file deletions or network disk problems will be minimal. RESTORE utility To restore data in one or more files, directories, or volumes from a tape cartridge to a network disk drive, complete the instructions in the "RESTORE Utility" section. (See page 17.) Error messages This section outlines error messages that can appear on the console screen during the Backup or Restore session. (See page 32.) These error messages are specific to the Backup VAP and are in addition to the error messages listed in the NetWare System Messages manual. Page iii NetWare command format conventions The command format displays the appropriate syntax for entering commands at the console prompts. The example below shows a typical command format used in this manual: BACKUP [path [filename] [option...]] The conventions for this command format are explained below. BACKUP Words that appear in all capital letters must be spelled exactly as shown. Although they appear in capital letters, they can be typed in either upper or lower case. path Words that appear in italics are variables. They should be replaced with the information pertinent to your task. In this case, path would be replaced with the directory path of the directory you want to back up. [ ] Square brackets indicate that the enclosed item is optional: you can enter a command with or without the enclosed item. In the example above, path, filename, and option are optional. ... Ellipses indicate that more than one variable can be used with the command. In this case, more than one option can be entered. Angle brackets indicate that you should press the key that appears between them. In this case, you should press the Enter key. Page 1 Installation This section explains how to install the Backup VAP in a file server or router. Installation is a one-time process that must be completed before you run BACKUP or RESTORE for the first time. Install hardware You can run the Backup VAP from one of the following: o A file server running NetWare v2.2. o A router running NetWare v2.2. This could be a workstation booted as a router (using an alternate boot diskette). Whether you run the Backup VAP from a server or a router, you can back up or restore to any server on your internetwork running NetWare v2.2. The only restriction is that you must be able to log in as SUPERVISOR or as another user with Read and File Scan rights in the directories to be backed up and restored to. Install the tape drive and tape controller board in the file server or router according to the instructions furnished by the computer and tape drive manufacturers. You make hardware configuration settings (interrupt line, I/O base, and DMA channel) on the tape controller board. Page 2 Select one of the 19 configuration options listed in the chart below. If possible, use configuration option 0. Configuration Interrupt I/O DMA Option Line Base Channel 0 5 280h 3 1 3 200h 1 2 3 330h 1 3 4 200h 1 4 4 300h 1 5 4 330h 1 6 5 200h 1 7 5 300h 1 8 3 330h 1 9 7 200h 1 10 7 300h 1 11 3 330h 1 12 3 300h 1 13 5 280h 1 14 7 280h 3 15 3 200h 3 16 3 300h 3 17 5 200h 3 18 5 300h 3 Make the hardware settings according to the board manufacturer's instructions. Make a note of the configuration option you select. Note: Follow the tape drive manufacturer's instructions concerning the types of tape cartridges that you can use with your particular tape drive. Page 3 Install the Backup VAP To install the Backup VAP on a file server or router, complete the following steps: 1. Configure the Backup VAP. The Backup VAP software must be configured for the same hardware configuration option you used when you installed the tape drive hardware. If the hardware and software configurations do not match, the Backup VAP will not run, and other hardware or software in the file server or router may fail as well. The Backup VAP software is shipped configured for option 0. If you select any configuration option other than option 0, you must configure the software to match the hardware configuration using BUCONFIG (see Step 1a). (If you select option 0 and have not previously configured the software for a different configuration option, skip to Step 2.) 1a. To configure the Backup VAP, use the diskette labeled NetWare Backup VAP v1.0. Do one of the following: þ Use the Backup VAP diskette in the floppy disk drive of any workstation or þ Copy the contents of the Backup VAP diskette to a network drive. 1b. To view the configuration of the Backup VAP (without reconfiguring the file), type BUSHOW All configuration options appear on the screen with an asterisk by the option the VAP is configured for. Page 4 BUCONFIG uses DCONFIG (Device CONFIGuration) to configure the Backup VAP. As it does, all configuration options are listed on the screen, with an asterisk ( * ) by the option you selected. 1c. At the DOS prompt for the appropriate local or network drive, use the following command format: BUCONFIG option Replace option with the configuration option number (0 through 18) you selected during the tape drive installation. Example. To configure the Backup VAP for configuration option 1, type BUCONFIG 1 Note: Below the last option, you will probably see a message similar to "WARNING: Specified disk not found. C1: 4,0." This message can be ignored. 2. Copy the Backup VAP. The Backup VAP file, BACKUP.VP0 (the last character is a zero), must be copied to a directory or diskette from which it can be loaded as a VAP. o For a file server, the Backup VAP must be copied to the SYS:SYSTEM directory. This must be done by a user with supervisory privileges. o For a router, the Backup VAP must be copied to the router's boot diskette. Use COPY or NCOPY to copy the BACKUP.VP0 file. Page 5 Note: If your file server or router uses more than one VAP, whenever you boot the file server or router, the Backup VAP (BACKUP.VP0) must load first, before any other VAP. The VAP loading sequence is controlled by the last number in the VAP filename extension, which for the Backup VAP is a 0 (zero). If your SYS:SYSTEM directory (or router boot diskette) contains another VAP file with the .VP0 extension, the other VAP file must be renamed with a .VP1 extension. In turn, any higher-number VAPs must be incremented by one (.VP1 becomes .VP2, and so forth). (For VAP files with the .VAP extension, no change is required.) 3. Load the Backup VAP. Once the BACKUP.VP0 file has been copied to SYS:SYSTEM or the router boot diskette, whenever you boot the file server or router, you see the following: Value Added Processes have been defined. Do you wish to load them? Answer "Yes." As the Backup VAP is loaded, messages similar to the following appear: Loading VAP BACKUP.VP0 BACKUP & RESTORE VAP. Server ADMIN version 2.2 BACKUP/RESTORE VAP Version 1.01. DCONFIG Option 0 (c) Copyright 1991 Novell, Inc. All Rights Reserved. Page 6 Before you type anything further at the console, wait for all VAPs to load and for the console prompt ( : ) to appear. (Do not confuse the console prompt with other colons that may appear on the screen while the VAPs are loading.) If you type anything before the console prompt appears, you may cause the console to "hang." You can then run BACKUP or RESTORE. Page 7 BACKUP Utility This section explains how to back up network files with the BACKUP utility (which is part of the Backup VAP). You can run BACKUP if you have supervisor privileges or if you have Read and File Scan rights in the volumes and directories you want to back up. After you back up files, you can restore damaged or deleted files to their status at the last back up using RESTORE. (See page 17.) Note: Before you follow these instructions for the first time, make sure the Backup VAP has been installed and loaded in the file server or router, explained in the "Installation" section. (See page 1.) Plan the backup session You need to know the following before you start BACKUP. o Whether to back up from the file server console or a router console. This depends on where the Backup VAP was installed. (See page 1.) o Which file server you are backing up. If you have more than one file server, you specify which file server to back up. Page 8 o The username and password to log in with. You must have Read and File Scan rights in the directories to be backed up. Note: References in this manual to the supervisor will generally include the user SUPERVISOR and other users with supervisor equivalence. o Whether to disable logins and log users out (supervisor only). BACKUP uses a large percentage of the file server's processing capacity and may slow the network to an undesirable speed. Also, BACKUP does not back up files that are in use. (Logins are re-enabled after BACKUP is complete.) o Which volumes, directories, or files to back up. You can back up one or more volumes or directories. Or you can back up one or more files that follow a filename pattern (using DOS wildcard characters). o Whether to back up bindery files (supervisor only). If you back up specific directories or files, you can also back up the bindery files. (In full-volume backups by the supervisor, bindery files are automatically backed up.) Although the bindery files are in volume SYS, they will be backed up (if specified) regardless of the volume you back up. o Whether to back up trustee rights. If you back up specific directories or files, you can back up the directories' trustee rights as part of the backup. (Trustee rights are automatically backed up in full- volume backups.) Page 9 Run the BACKUP utility This section explains how to back up network files using the BACKUP utility. You can run BACKUP if you are the network supervisor or equivalent or if you have Read and File Scan rights in the volumes and directories to be backed up. Before you run BACKUP, complete the following steps: 1. Select the file server to back up. To back up your default server at the server console, skip to Step 2. To select the server, at the server or router console prompt ( : ), use the following command format: SELECTSERVER [server] Use SELECTSERVER if you are running BACKUP from a router or a file server other than the target server. Replace server with the name of the file server you want to back up. (Server is optional; if you do not specify a server, you are prompted to enter one.) Example. To specify server ADMIN, type SELECTSERVER ADMIN or SELECTSERVER You are prompted to enter the target file server name. Page 10 2. Start BACKUP and specify variables. 2a. To start BACKUP, at the file server or router console prompt ( : ), use the following command format: BACKUP [path [filename] [option...]] Replace path with the path for the directory you want to back up. If you do not specify a path, BACKUP backs up one or more complete volumes (which you specify later). Replace filename with the names or filename pattern of the files you are backing up. Filename patterns use DOS wildcard characters (* and ?). Example. You can specify *.EXE to back up files with the .EXE extension. Specify a filename only with its path; the filename must be separated from the path by a space, not a slash or a backslash. Replace option with one or more of the options listed below. Specify options only if you specify a path. /S Use to back up files in subdirectories of the specified directory path. /B Use to back up bindery files from volume SYS (supervisor only). You can back up the bindery files no matter which volume or directory you are backing up. /T Use to back up trustee rights associated with the directories that are backed up. Page 11 Examples. To back up one or more volumes, type BACKUP (You specify volumes later.) To back up all files in SYS:HOME/MARIO, type BACKUP SYS:HOME/MARIO To back up all files in SYS:HOME/MARIO and its subdirectories, type BACKUP SYS:HOME/MARIO /S To back up all files with the extension .BAT in SYS:HOME/MARIO and its subdirectories, and to back up all trustee rights associated with these directories, type BACKUP SYS:HOME/MARIO *.BAT /S /T (Note the space between SYS:HOME/MARIO and *.BAT.) 2b. When prompted, type your username and press . 2c. When prompted, type your password and press . (If your username has no password, press .) Note: If you make a mistake while typing your password, use the Delete key, not the Backspace key, to erase your mistake. Page 12 2d. If you did not log in as SUPERVISOR or equivalent, complete one of the following: o If you specified a directory path in your BACKUP command (in Step 2a), skip to Step 3. o If you are doing a full-volume backup and did not specify a directory path in your BACKUP command, skip to Step 2h. If you logged in as SUPERVISOR, when prompted to disable logins, type Y or N. (Logins are re-enabled after BACKUP is complete.) If you answer "No," complete one of the following: o If you specified a directory path in your BACKUP command (in Step 2a), skip to Step 3. o If you are doing a full-volume backup and did not specify a directory path in your BACKUP command, skip to Step 2h. 2e. If you disabled logins, you now have the option to force existing users to log out. The current users are listed on the screen, along with the following prompt: Do you want to FORCE users to log out? (y/n) > If you answer "Yes" users are not logged out at this point. If you answer "No," complete one of the following: o If you specified a directory path in your BACKUP command (in Step 2a), skip to Step 3. o If you are doing a full-volume backup (and did not specify a directory path in your BACKUP command), skip to Step 2h. Each user is notified to log out. Wait a few moments to give users a chance to logout. Page 13 2f. When prompted to clear remaining user connections, type Y or N. If you answer "Yes," the remaining users (except the Backup VAP user) are logged out. Complete one of the following: o If you specified a directory path in your BACKUP command (in Step 2a), skip to Step 3. o If you are doing a full-volume backup (and did not specify a directory path in your BACKUP command), skip to Step 2h. If you answer "No," the remaining users are not cleared. You can continue the backup (with users still connected) or go back and force them to log out. 2g. When prompted to proceed, type Y or N. o If you answer "No," return to Step 2e. o If you answer "Yes" and you specified a directory path in your BACKUP command (in Step 2a), skip to Step 3. o If you answer "Yes" and you did not specify a directory path in your BACKUP command, continue with Step 2h. Page 14 2h. If you are doing a full-volume backup, a list of the file server's volumes appears: Volume: Kilobytes used: SYS: 137464 Kbytes BOOM: 143000 Kbytes BAH: 65796 Kbytes Total 346260 Kbytes In addition, for each volume you are prompted: Back up volume SYS: 137464 Kbytes ? For each volume, type Y or N. 2i. After you specify which volumes to back up, you are prompted: Do you wish to make any changes? (y/n) > Type Y or N. If you answer "Yes," return to Step 2h. If you answer "No," continue with Step 3. 3. Back up network files. 3a. After you specify the BACKUP variables, you are prompted: Insert cartridge No. 1 and press Enter. Insert the tape cartridge into the tape drive and press . If necessary, refer to the tape insertion instructions furnished with the tape drive. A message appears, indicating that the tape cartridge is being mounted (wound to the starting position on the tape). Novell has added a timed release program to the BACKUP utility. This program allows you to delay a backup for up to 24 hours. Page 15 After the tape cartridge is mounted, a prompt similar to the following appears: Would you like to delay the backup for up to 24 hours (y/n)? Answer "no" to begin the backup now. Answer "yes" to select a time for the backup to begin. If you answer "yes," a prompt similar to the following appears: The current time is 3:35 pm Enter desired starting time in the format "hh:mm am/pm."> Enter a starting time for BACKUP. The following screen appears: Backup will begin at 2:55pm. The current time is 1:30pm. The specified files are backed up at the time you specified. 3b. As the files are backed up, they are listed on the screen: 1 SYS:HOME/ 2 SYS:HOME/MARIO/ : SYS:HOME/MARIO/ 0 SYS:HOME/MARIO/APRIL_1.COM 1 SYS:HOME/MARIO/LOGIN SYS:HOME/MARIO/BU/ SYS:HOME/MARIO/BU/161/ 2 SYS:HOME/MARIO/BU/161/GEO.161 3 SYS:HOME/MARIO/BU/161/ALPHA.161 SYS:HOME/MARIO/BU/YUBIN/ SYS:HOME/MARIO/BU/DRIVE-C/ 4 SYS:HOME/MARIO/BU/DRIVE-C/CONFIG.SYS 5 SYS:HOME/MARIO/BU/DRIVE-C/AUTOEXEC.BAT The unnumbered lines are directories. The numbered lines are files. Page 16 The information on the screen is also stored in two files: o VAP_FILE.LOG records the backup date and time, the files that are backed up, and the cartridge number and tape locator information for each file. o VAP_ERR.LOG also records the backup date and time, along with error messages that appear during BACKUP. In a full-volume backup, these files are created in the root directory of each volume backed up. In a specific-directory backup, these files are created in the directory you specified in Step 2a. Note: The VAP_FILE.LOG and VAP_ERR.LOG files are created only for the supervisor or a user with Create rights in the applicable directory. 3c. If the tape cartridge reaches the end during backup, the tape is rewound and you are prompted to insert another tape cartridge. After specified files have been backed up, the following messages appears: Finished Backup Session. Rewinding Tape. After the tape cartridge is rewound, the console prompt ( : ) reappears on the screen, and BACKUP is complete. Label your backup tapes and store them in a safe place. Note: If you booted a workstation as a temporary router to run BACKUP, bring down the router (using the DOWN console command) before rebooting the computer as a workstation. Page 17 RESTORE Utility This section explains how to restore previously backed up network files with the RESTORE utility (part of the Backup VAP). You can run RESTORE if you are the network supervisor or if you have Read and File Scan rights in the volumes and directories you restore files to. If a user deletes a file or if a network disk has problems, you can restore files to their status at the last back up. (See page 7.) Note: Before you follow these instructions for the first time, make sure the Backup VAP has been installed and loaded in the file server or router, as explained in the "Installation" section. (See page 1.) Plan the restore session You must know the following before you start RESTORE. o Whether to restore from the file server console or a router console. This depends on where the Backup VAP was installed. (See page 1.) o Which file server you are restoring to. If you have more than one file server, you specify which file server to restore to. Page 18 o The username and password to log in with. You must log in as a user with Read and File Scan rights in the directories to be restored. In some cases, it may be important to run RESTORE as supervisor. For example, if you are restoring directories that have been deleted, users other than the supervisor may not be able to recreate the subdirectories (and consequently cannot restore files to those subdirectories). If you do not want to run RESTORE as supervisor, make sure the user has Create rights in the directories that do exist. Note: References in this manual to the supervisor will generally include the user SUPERVISOR and other users with supervisor equivalence. o Whether to disable logins and log users out (supervisor only). RESTORE uses a large percentage of the file server's processing capacity and may slow the network to an undesirable speed. Also, RESTORE does not write over files that are in use. (Logins are re-enabled after RESTORE is complete.) o Which volumes, directories, or files to restore. You can restore one or more volumes or directories. Or you can restore one or more files that follow a filename pattern (using DOS wildcard characters). Page 19 o Whether to restore bindery files (supervisor only). If you backed up the bindery files with BACKUP, you can restore them as part of the restore session. Although the bindery files are in volume SYS, they will be restored (if specified) regardless of the volume you are restoring. o Whether to restore trustee rights. If you backed up trustee rights during BACKUP, you can restore the directories' trustee rights as part of the restore session. Run the RESTORE utility This section explains how to restore network files using the RESTORE utility. You can run RESTORE if you are the network supervisor or equivalent or if you have Read and File Scan rights in the volumes and directories to be restored. Before you run RESTORE, complete the following steps: 1. Select the file server to restore to. To restore to your default server at the server console, skip to Step 2. To select the server, at the server or router console prompt ( : ), use the following command format: SELECTSERVER [server] Use SELECTSERVER if you are running RESTORE from a router or a file server other than the target server. Replace server with the name of the file server you want to restore to. (Server is optional; if you do not specify a server, you are prompted to enter one.) Page 20 Example. To specify server ADMIN, type SELECTSERVER ADMIN or SELECTSERVER You are prompted to enter the target file server name. 2. Start RESTORE and specify variables. 2a. To start RESTORE, at the file server or router console prompt ( : ), use the following command format: RESTORE [path [filename] [option...]] Replace path with the path for the directory you want to restore. If you do not specify a path, RESTORE prompts you for the path and additional options later. Replace filename with the name or filename pattern of the files you are restoring. Filename patterns use DOS wildcard characters (* and ?). Example. Specify *.EXE to restore files with the .EXE extension. Specify a filename only with its path; the filename must be separated from the path by a space, not a slash or a backslash. Page 21 Replace option with one or more of the options listed below. You can specify options only if you specify a path. /C Use to confirm whether or not to restore a specific directory or file. /S Use to restore files in subdirectories of the specified directory path. (Only the specified files that were backed up are restored.) /B Use to restore the bindery files to volume SYS (no matter which volume or directory you are restoring). (The bindery files are restored only if you backed them up.) /T Use to restore the trustee rights associated with the directories that are restored. (The trustee rights are restored only if you backed them up.) /R=path Use to restore directories and files to a different directory path than they were backed up from. Replace path with the directory path where you want to restore the directory (and its subdirectories, if applicable). Examples. To start RESTORE (and be prompted later for the restore variables), type RESTORE To restore all files in SYS:HOME/MARIO, type RESTORE SYS:HOME/MARIO Page 22 To set the confirmation feature, type RESTORE [path [filename] /C] If you specify the confirm option, each time a directory or file meeting your specifications is listed, you are prompted to restore the directory or file: SYS:HOME/MARIO/APRIL_1.COM? (y)es (n)o (r)estore_the_rest (s)kip_the_rest Respond to this prompt in one of the following ways: o Type Y to restore or N to not restore the directory or file. o Type R to turn off confirmation and restore all the rest of the directories and files that meet your restore specification within the current directory. o Type S to skip (not restore) the rest of the directories and files that meet your restore specification within the current directory. To restore all files in SYS:HOME/MARIO and its subdirectories, type RESTORE SYS:HOME/MARIO /S To restore all files with the .BAT extension in SYS:HOME/MARIO and its subdirectories, and to restore all trustee rights associated with these directories, type RESTORE SYS:HOME/MARIO *.BAT /S /T (Note the space between SYS:HOME/MARIO and *.BAT.) Page 23 To restore files backed up from SYS:HOME/ MARIO and its subdirectories, and to place the restored files (and subsequent subdirectories) in the directory SYS:HOME/ MARIO/BACKUP, type RESTORE SYS:HOME/MARIO /S /R=SYS:HOME/MARIO/BACKUP RESTORE creates subdirectories as necessary to restore files to the new directory path. 2b. When prompted, type your username and press . 2c. When prompted, type your password and press . (If your username has no password, press .) Note: If you make a mistake while typing your password, use the Delete key, not the Backspace key, to erase your mistake. 2d. If you did not log in as SUPERVISOR or equivalent, skip to Step 2h. If you logged in as SUPERVISOR, when prompted to disable logins, type Y or N. (Logins are re-enabled after RESTORE is complete.) If you answer "No," skip to Step 2h. Page 24 2e. If you disabled logins, you now have the option to force existing users to log out. The current users are listed on the screen, along with the following prompt: Do you want to FORCE users to log out? (y/n) > If you answer "Yes," users are not logged out at this point. If you answer "No," skip to Step 2h. Each user is notified to log out. Wait a few moments to give users a chance to logout. 2f. When prompted to clear remaining user connections, type Y or N. If you answer "Yes," all remaining users (except the Backup VAP user) will immediately be logged out. Skip to Step 2h. If you answer "No," the remaining users are not cleared. You can continue the restore (with the users still connected) or go back and force them to log out. 2g. When prompted to proceed, type Y or N. If you answer "No," return to Step 2e. Page 25 2h. When prompted, insert the tape cartridge into the tape drive and press . If your backup is on more than one tape, be sure to insert the first tape cartridge. If necessary, refer to the tape insertion instructions furnished with the tape drive. A message appears, indicating that the tape cartridge is being mounted (wound to the starting position on the tape). Backup information stamped on the tape cartridge during BACKUP is then displayed: Server: ADMIN NetWare Version: 2.2 Backed up: April 11, 1991 12:05 p.m. Cartridge No. 1 2i. When prompted, examine the backup information on the screen and type Y or N. (If you answer "No," either insert a different cartridge or terminate the restore session.) If you specified a path or filename in your RESTORE command (in Step 2a), skip to Step 3. Backup information from the tape then appears: VOLUME SYS: Backup began at directory: SYS:HOME\MARIO Do you wish to restore from this volume? (y/n) > 2j. When prompted to restore from the volume, type Y or N and press . o If you answer "No," the volume is skipped, and you are given the option to terminate the restore session. o If you answer "Yes," continue with the next step. Page 26 The highest directory level on the backup tape appears: Source Path: SYS:HOME\MARIO Limit the restoration to some subdirectory of the above Source Path? (y/n) > 2k. When prompted to limit the restoration, type Y or N. o If you answer "No," the entire source path shown is restored (subject to restrictions you specify in subsequent prompts). o If you answer "Yes," you are prompted to enter the name of the subdirectory (relative to the source path) from which restoration should begin. For example, to restore only the directory SYS:HOME/MARIO/SCHEDULE to SYS:HOME/MARIO, you would specify SCHEDULE. 2l. When prompted to limit the restore using a file name or pattern, type Y or N. o If you answer "No," all files in the specified directories are restored (subject to restrictions you specify in subsequent prompts). o If you answer "Yes," you are prompted to enter the filename or pattern, using DOS wildcards (* and ?). For example, to restore all files with the .EXE extension, specify the pattern *.EXE. Page 27 2m. When prompted to include subdirectories, type Y or N. o If you answer "Yes," files are restored to the specified root directory and its subdirectories. o If you answer "No," files are only restored to the specified root directory. 2n. When prompted to confirm each file, type Y or N. o If you answer "Yes," each time a directory or a file matching your restore specification is listed, you are prompted to restore the directory or file. (If you specify not to restore a directory, all files in the directory are skipped.) The confirmation prompt allows you to turn off confirmation (and restore all remaining applicable files) or to not restore any more files. o If you answer "No," the specified directories and files are restored without confirmation. 2o. When prompted to restore the bindery, type Y or N. o If you answer "Yes," the bindery files in volume SYS are restored (no matter which volume you are restoring to). However, the bindery files are restored only if they were backed up on the tape you are restoring from (and only if you are logged in as SUPERVISOR). o If you answer "No," the bindery files are not restored. Page 28 2p. When prompted to restore trustees, type Y or N. o If you answer "Yes," the trustee rights associated with the directory and its files are restored. However, the trustee rights are restored only if they were backed up on the tape you are restoring from. o If you answer "No," the trustee rights are not restored. You then see a prompt similar to the following: Files and subdirectories will be restored to the following path: SYS:HOME/MARIO 2q. When prompted to restore to a different volume or directory, type Y or N. o If you answer "No," the files are restored to the same directory they were backed up from. Skip to Step 2r. o If you answer "Yes," you can specify a different destination volume and directory to restore the files to. The directory path for the restored files consists of the destination volume name and directory you specify, plus the subdirectories (if applicable) and files of the original path shown in the prompt. When prompted, specify the destination volume name and directory. (You can retain the default volume name and directory by pressing .) Example. Consider files and subdirectories backed up from SYS:HOME/MARIO. If you specified volume BOOM and directory RESTORE/FILES, the files and subdirectories would be restored to BOOM:RESTORE/FILES. The file backed up as SYS:HOME/MARIO/ SCHEDULE/APRIL.91 would be restored as BOOM:RESTORE/FILES/SCHEDULE/ APRIL.91. Page 29 Note: If you restore AFP (Macintosh) files, you must rebuild the Macintosh desktop file after running RESTORE if both of the following are true: o You have restored AFP files to a different volume than they were backed up from. o The volume to which the files were restored does not contain the application that uses the restored files. If this is the case, as you rebuild the Macintosh desktop file (as instructed in your Macintosh documentation), you also need to re-enter file information comments for the restored files. 2r. When prompted, examine the restore specifications as they appear on the screen, and type Y or N. o If you answer "No," return to Step 2j. o If you answer "Yes," continue with Step 3. Page 30 3. Restore network files. 3a. The restore session now proceeds, according to specifications made in Step 2. The files that were backed up on the tape are listed on the screen as they are either restored or skipped over (according to your restore specifications), in a format similar to the following: SYS:HOME/MARIO/ Restoring SYS:HOME/MARIO/APRIL_1.COM Restoring SYS:HOME/MARIO/LOGIN SYS:HOME/MARIO/BU/ SYS:HOME/MARIO/BU/161/ Restoring SYS:HOME/MARIO/BU/161/GEO.161 Restoring SYS:HOME/MARIO/BU/161/ALPHA.161 SYS:HOME/MARIO/BU/YUBIN/ SYS:HOME/MARIO/BU/DRIVE-C/ Skipping SYS:HOME/MARIO/BU/DRIVE-C/CONFIG.SYS Skipping SYS:HOME/MARIO/BU/DRIVE-C/AUTOEXEC.BAT Error messages that appear on the screen are recorded, along with the restore date and time, in the VAP_ERR.LOG file. This file is created in the directory from which the restore session originated, as you specified in either Step 2a or Step 2j. Note: The VAP_ERR.LOG file is only created for the supervisor or a user with Create rights in the applicable directory. If you restore Apple File Protocol (AFP) files, particularly those with multiple revision numbers, these files may be renamed as they are restored. This applies only to the DOS versions of the filenames and not to the Apple versions. Renamed files are listed in the VAP_ERR.LOG file. 3b. If you answered "Yes" to the "Confirm each file" prompt in Step 2n, each directory and file matching your restore specification is listed on the screen, along with a confirmation prompt: SYS:HOME/MARIO/APRIL_1.COM? (y)es (n)o (r)estore_the_rest (s)kip_the_rest > Page 31 Respond to this prompt as follows: o Type Y to restore or N to not restore the directory or file. (Remember, if you specify not to restore a directory, all files in the directory are skipped.) o Type R to turn off confirmation and restore the remaining directories and files that match your restore specification. o Type S to skip (not restore) the remaining directories and files that match your restore specification. 3c. If the tape cartridge reaches the end during the restore session, the tape is rewound, and you are prompted to insert another tape cartridge. After files have been viewed and the specified files restored, the following messages appear: Reached End of Session Marker. Rewinding Tape. 3c. If the tape cartridge reaches the end during the restore session, the tape is rewound, and you are prompted to insert another tape cartridge. After files have been viewed and the specified files restored, the following messages appear: Reached End of Session Marker. Rewinding Tape. After the tape cartridge has finished rewinding, the file server or router console prompt ( : ) reappears on the screen, and RESTORE is complete. Note: If you booted a workstation as a temporary router to run RESTORE, bring down the router (using the DOWN console command) before rebooting the computer as a workstation. Page 32 Error Messages The following is a list of error messages that can appear while running the Backup VAP. Other error messages are listed in the NetWare System Messages manual. Use this section as a reference guide rather than as a diagnostics or troubleshooting guide. It suggests possible causes for errors and explains steps you can take to correct the errors. Some error messages include a . Use the Extended Error Code section of the DOS Technical Reference manual to trace the error using . Attachment to has been lost. Explanation: The connection to the file server being backed up or restored to has been lost. This message can appear when you run BACKUP or RESTORE from a router or from a file server other than the server being backed up or restored to. Action: Restart BACKUP or RESTORE. If this does not work, make sure the target file server is online and that you have a reliable physical connection. Page 33 Bindery file not restored. Explanation: The bindery files were not restored properly. This can be caused by a file creation error or a physical tape error. A file server's existing bindery files are not deleted until both new bindery files are successfully restored from the backup tape, so the server should still have usable bindery files. Action: No action is necessary. Bindery files were not restored properly. Explanation: The bindery files were not restored properly. This can be caused by a file creation error or a physical tape error. A file server's existing bindery files are not deleted until both new bindery files are successfully restored from the backup tape, so the server should still have usable bindery files. Action: No action is necessary. Cannot continue restoring Bindery files. Explanation: The bindery files were not restored properly. This can occur because the disk or directory table is full, or because one of the bindery files being restored from the tape is damaged. A file server's existing bindery files are not deleted until both new bindery files are successfully restored from the backup tape, so the server should still have usable bindery files. Action: No action is necessary. Page 34 Cartridge has no valid header stamp. Explanation: The tape you inserted during the restore session does not have a valid header stamp (containing tape cartridge number, date and time, and so on). This can occur if the tape header is unreadable for some reason or if you have inserted the wrong tape (that does not have a valid header). Action: Insert the correct tape cartridge into the tape drive. Cartridge is write-protected. Explanation: The tape cartridge is set in the write- protected ("safe") position. Action: Reset the tape cartridge so that it is not write-protected, so that backed-up data can be written to it. (If necessary, refer to the instructions supplied with the tape cartridge.) Cartridge not properly inserted. Explanation: During the tape mounting sequence, the tape cartridge was not securely seated in the tape drive. Action: Insert the tape correctly into the tape drive. (If necessary, refer to the instructions supplied with the tape drive.) Page 35 Encountered header for before was done. Explanation: While a file or a directory (file1) was being restored, the header for another file or directory (file2) was encountered on the tape before the first file was completely restored. When a file or a directory is backed up, it is preceded on the tape by a header that gives the number of 4KB file blocks that the file or the directory is stored in. This error occurs when the next header is encountered before the expected number of blocks has been restored. If this error occurs, the first file is not restored, but the second file is. (Headertype identifies either a file or a directory header.) Action: No action is necessary. Error attempting to open data fork of . Explanation: BACKUP or RESTORE could not open the data fork of an Apple File Protocol (AFP) file. Action: No action is necessary. Page 36 Error attempting to open resource fork of . Explanation: BACKUP or RESTORE could not open the resource fork of an Apple File Protocol (AFP) file. Action: No action is necessary. Error creating directory . Explanation: RESTORE attempted unsuccessfully to create a directory on the file server. This error happens most frequently because the disk or the volume is full, or because the user running RESTORE has insufficient rights to create a directory in the given path. Action: Check whether the disk or the volume is full, and make sure you have sufficient rights to create a directory at the specified location. Error writing to Bindery file . Explanation: The bindery files were not restored properly. A file server's existing bindery files are not deleted until both new bindery files are successfully restored from the backup tape, so the server should still have usable bindery files. Action: No action is necessary. Page 37 Fatal Tape Error. Aborting Backup Session. Explanation: The tape has been removed prematurely during the backup session. Action: Run BACKUP again, making sure the tape remains securely inserted until completion or until you are prompted to remove it. Fatal Tape Error. Aborting Restore Session. Explanation: The tape has been removed prematurely during the restore session. Action: Run RESTORE again, making sure the tape cartridge remains securely inserted until completion or until you are prompted to insert another tape cartridge. File is not a Bindery file. Explanation: While the bindery files were being restored, a file found in the bindery area of the tape did not have a valid bindery filename. The misnamed bindery file is not restored. Action: No action is necessary. Page 38 Insufficient RIGHTS to back up this path. Explanation: You do not have sufficient rights to back up the specified volume or directory path. You must have Read and File Scan rights in the root of the volume or directory you are backing up. Action: Run BACKUP as user SUPERVISOR, or as a user with Read and File Scan rights in the root of the volume or directory you are backing up. Or, get the network supervisor to grant you additional rights to run BACKUP. Invalid Backup option switch. Explanation: When starting BACKUP, you specified an option other than the valid options (/B, /S, and /T). Action: Type the BACKUP command using valid options. Invalid Path specification. Explanation: You used an invalid format when specifying a path in the BACKUP or RESTORE command. Action: Specify the path using the correct format. Page 39 Specified destination path is not valid. Explanation: The path you specified in your RESTORE command using the /R option is not a valid directory path. Action: When you use the /R option, specify a valid directory path. Supervisor access level is required to back up the Bindery. Explanation: You specified (with the /B option) to back up the bindery files. However, to back up the bindery files, you must run BACKUP as SUPERVISOR (or supervisor equivalent). Action: Log in as SUPERVISOR or equivalent. Supervisor access level is required to restore the Bindery. Explanation: You specified (with the /B option) to restore the bindery files. However, to restore the bindery files, you must run RESTORE as SUPERVISOR (or supervisor equivalent). Action: Log in as SUPERVISOR or equivalent. Page 40 The Bindery was not backed up with this volume. Explanation: You are attempting to restore the bindery files from a tape to which the bindery files were not backed up. Action: No action is necessary. The directory table on volume is full. Explanation: While you were restoring to the specified volume, the volume ran out of available directory entries. Action: Increase the number of directory entries on the volume or delete unneeded files. (You can run VOLINFO to view the number of available directory entries.) Page 41 The existing Bindery has been damaged. Explanation: While the bindery was being restored there was a problem with the restored bindery file (from the tape). However, the system could not rename the original bindery back to its correct name. Whenever bindery files are restored, backup copies (with modified filenames) of the original bindery files are kept until new bindery files are successfully restored from the tape. If the new bindery files are not successfully restored, the original bindery files are renamed to their original filename. This message indicates that the original files were not successfully renamed. Action: You may need to repair the original bindery with VREPAIR. The path string contained illegal characters. Explanation: The path you specified contained illegal characters. Action: Retype the path string using only legal path characters. This is Cartridge No. but Cartridge No. was requested. Explanation: RESTORE prompted you to insert a certain tape cartridge and you inserted a different cartridge. Action: Insert the tape cartridge with the specified number. Page 42 Trustees were not backed up with this volume. Explanation: You are attempting to restore trustee rights from a tape to which trustee rights were not backed up. Action: No action is necessary. Unable to create file . Explanation: RESTORE failed to create the specified filename. This could occur if you have insufficient rights or if the hard disk has insufficient space. Action: Make sure you have sufficient rights to restore the file and that there is sufficient disk space. Unable to log in as . Error = . Explanation: You were unable to log in because you entered an invalid username or an incorrect password, or for the reason specified by . Action: Enter a valid username with the correct password, or correct the condition indicated by . Page 43 Unable to transfer data fork of . Explanation: RESTORE was unable to transfer the data fork of the specified Apple File Protocol (AFP) file. Action: No action is necessary. Unable to transfer resource fork of . Explanation: RESTORE was unable to transfer the resource fork of the specified Apple File Protocol (AFP) file. Action: No action is necessary. Unrecoverable data error. Explanation: There is a major problem with the tape cartridge, tape drive, or tape controller. Action: Replace the faulty tape cartridge, or have the tape drive or tape controller serviced. User does not exist on this server. Explanation: When starting BACKUP or RESTORE you specified an invalid username. Action: Restart BACKUP or RESTORE using a valid username. Page 44 Volume does not exist on this server. Explanation: You are attempting to restore to a volume that does not exist on the file server. This could happen when you try to restore a directory path backed up from one server to the same directory path (on a nonexistent volume) on another server. Action: Specify the correct destination directory path when starting RESTORE. WARNING! Restoring AFP files to a DOS server may lose information. Explanation: You are attempting to restore Apple File Protocol (AFP) files (backed up on a file server that does support AFP files) to a file server that does not support AFP calls. In doing so, you will lose the information from the resource forks of the AFP files. Action: No action is necessary. You have entered an invalid Password for user . Explanation: While starting BACKUP or RESTORE you specified the incorrect password for the username. Action: Restart BACKUP or RESTORE using the correct password for the username. Index A AFP (Apple File Protocol) files Macintosh desktop file, rebuilding 29 renamed by RESTORE utility 30 B BACKUP utility. See also Backup VAP bindery files, backing up 10 command, entering 10 file server, selecting 9 logins, disabling 12 planning 7 subdirectories, backing up 10 tape cartridge, inserting 14 trustee rights, backing up 10 volumes, specifying 14 Backup VAP. See also BACKUP utility; RESTORE utility configuring 3 error messages 32 installation 1 loading 5 SELECTSERVER command 9, 19 Bindery files backing up 10 restoring 21, 27 D Directory path specifying in BACKUP 10 specifying in RESTORE 20 E Error messages 32 F File server specifying in BACKUP 9 specifying in RESTORE 19 Filename selecting in BACKUP 10 selecting in RESTORE 20, 25 I Installation Backup VAP 3 configuration options 2 hardware 1 NetWare versions supported 1 VAPs, renaming 5 L Logins disabling in BACKUP 12 disabling in RESTORE 24 reasons to disable 8, 18 Logouts forcing in BACKUP 12 forcing in RESTORE 24 M Macintosh desktop file, rebuilding 29 O Options specifying in BACKUP 10 specifying in RESTORE 21 P Password specifying in BACKUP 11 specifying in RESTORE 23 R Restore destination, specifying 21, 28 RESTORE utility bindery files, restoring 21, 27 command, entering 20 file server, selecting 19 files, confirming 27, 30 logins, disabling 24 Macintosh desktop file, rebuilding 29 planning 17 restore destination, specifying 21, 28 subdirectories, restoring 21, 27 tape cartridge, inserting 25 trustee rights, restoring 21, 28 VAP_ERR.LOG, renamed AFP files listed in 30 volume, specifying 25 Router bringing down 16, 31 selecting file server from 9, 19 using workstation as 1 S SELECTSERVER command selecting the file server to back up 9 selecting the file server to restore to 19 Server, file selecting in BACKUP 9 selecting in RESTORE 19 Subdirectories backing up 10 restoring 21, 27 T Tape cartridge inserting 14, 25 using additional 16, 31 Trustee rights backing up 10 restoring 21, 28 U Username planning which to use 8, 18 specifying 11, 23 V VAP_ERR.LOG file purpose of 16, 30 renamed AFP files listed in 30 backing up 10 restoring 21, 28 W Workstation, using as router 1