home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Black Box 4
/
BlackBox.cdr
/
lan
/
22bkup.arj
/
BACKUP.DOC
next >
Wrap
Text File
|
1991-04-29
|
179KB
|
2,234 lines
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.
<Enter> 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 <Enter>
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 <Enter>
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 <Enter>
or
SELECTSERVER <Enter>
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 <Enter>
(You specify volumes later.)
To back up all files in SYS:HOME/MARIO,
type
BACKUP SYS:HOME/MARIO <Enter>
To back up all files in SYS:HOME/MARIO
and its subdirectories, type
BACKUP SYS:HOME/MARIO /S <Enter>
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
<Enter>
(Note the space between SYS:HOME/MARIO
and *.BAT.)
2b. When prompted, type your username and
press <Enter>.
2c. When prompted, type your password and
press <Enter>. (If your username has no
password, press <Enter>.)
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 <Enter>. 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 <Enter>
or
SELECTSERVER <Enter>
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 <Enter>
To restore all files in SYS:HOME/MARIO,
type
RESTORE SYS:HOME/MARIO <Enter>
Page 22
To set the confirmation feature, type
RESTORE [path [filename] /C] <Enter>
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 <Enter>
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
<Enter>
(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 <Enter>
RESTORE creates subdirectories as necessary
to restore files to the new directory path.
2b. When prompted, type your username and
press <Enter>.
2c. When prompted, type your password and
press <Enter>. (If your username has no
password, press <Enter>.)
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 <Enter>. 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 <Enter>.
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 <Enter>.)
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 <value>. Use
the Extended Error Code section of the DOS
Technical Reference manual to trace the error
using <value>.
Attachment to <server> 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 <filename> 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 <headertype> for <file2> before <file1>
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 <value> attempting to open data fork of <filename>.
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 <value> attempting to open resource fork of
<filename>.
Explanation:
BACKUP or RESTORE could not open the
resource fork of an Apple File Protocol (AFP)
file.
Action:
No action is necessary.
Error <value> creating directory <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 <filename>.
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 <filename> 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 <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 <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. <number> but Cartridge No. <number>
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 <filename>.
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 <username>. Error = <value>.
Explanation:
You were unable to log in because you
entered an invalid username or an incorrect
password, or for the reason specified by
<value>.
Action:
Enter a valid username with the correct
password, or correct the condition indicated
by <value>.
Page 43
Unable to transfer data fork of <filename>.
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 <filename>.
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 <username> 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 <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
<username>.
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