as_restore(1)
as_restore --
restore data from an SCO ARCserve/Open tape to a workstation
Synopsis
as_restore [-job_options] [arguments]
-dest [hostname] path
as_restore [-info_option]
Description
as_restore
can be used to restore data from SCO ARCserve/Open tapes to a workstation's
hard disk. It provides full job customization of a restore job, as well
as ways of querying the SCO ARCserve/Open database for available data.
Usage
as_restore
accepts the following job_options (job customization options).
When used in this context,
as_restore
will generate a restore job. The destination (workstation) path
is given by path, which must be a fully qualified directory path.
Optionally, path can reside in a remote workstation hostname.
Additional information on these options can be found in the
SCO ARCserve/Open User Guide.
- at time
-
Run job at time, specified in the format hh:mm.
- -on date
-
Run job on date.
date must be specified in the format appropriate for the current locale.
See the output of the -usage option for the proper format.
- -hold
-
Submit the job on hold.
- -description string
-
Attach string as a brief description to the job,
so that it can be easily referenced later.
- -reportfile filename [mode]
-
Save a report of the job's activity in the ASCII file filename.
filename can be a fully qualified path, or just a name (which will be
created in the current directory.)
The mode allactivity will generate a detailed report,
whereas the mode errorsonly will generate brief output.
The default is errorsonly.
- -createemptydiroff
-
Do not create empty directories when restoring data.
By default, SCO ARCserve/Open will create empty directories.
- -preexec command
-
Execute command prior to starting the restore job.
- -preexectimeout timeout
-
Allow a period of timeout minutes for the -preexec command to
complete. The default is 5 minutes.
- -postexec command
-
Execute command after the restore job has completed.
- -filter [hostname] include|exclude file|dir pattern
-
Include/exclude from [hostname, all files/directories matching pattern.
pattern can be a full path or a name.
The wildcards * and ? are allowed.
- -filter [hostname] include|exclude date filetime before|after date
-
Include/exclude files from [hostname], whose filetime lies before/after date.
filetime can be modify signifying last modification time,
create, signifying creation time, or
lastaccess, signifying last access time.
date must be in the format mm/dd/yy.
- -filter [hostname] include|exclude date filetime between date1 date2
-
Include/exclude files from [hostname], whose filetime
lies between date1 and date2.
filetime can be modify signifying last modification time,
create, signifying creation time, or
lastaccess, signifying last access time.
date1 and date2 must be in the format mm/dd/yy.
- -filter [hostname] include|exclude date filetime within count timeunit
-
Include/exclude files from [hostname], whose filetime
lies within count timeunits of the present date.
filetime can be modify signifying last modification time,
create, signifying creation time, or
lastaccess, signifying last access time.
timeunits can be one of the keywords day(s), month(s),
or year(s).
- -username username
-
When restoring to a remote workstation, the operation will be performed with the
(UNIX) privileges of user username.
Note that the remote node must allow
user username to login without a password, in order for the restore operation
to be successful.
- -base
-
Create the base directories when restoring data.
See the
SCO ARCserve/Open User Guide for details on this feature.
- -entirepath
-
Create the entire path from root when restoring data.
See
the SCO ARCserve/Open User Guide for details on this feature.
- -onconflict method
-
When the files to be restored conflict (i.e. have the same name) with files
already on the disk, SCO ARCserve/Open will by default overwrite the existing
files. This behavior can be altered by choosing method to be one
of the following:
- rename
-
the existing files will be renamed before restore takes place.
- skip
-
conflicting entries will not be restored.
- overwriteold
-
only files whose last modification time is newer than that of the existing
files will be restored.
- -group groupname
-
Choose the group that will process the job. Only tapes in this group can
be used as source tapes. See the SCO ARCserve/Open User Guide
for details on the concept of device group.
- -tape tapename
-
Select the tape to restore data from.
- -session num
-
Restore from session num on the specified tape.
- -tapetimeout timeout
-
Specify a period of timeout minutes that SCO ARCserve/Open will
wait for the correct tape to be loaded before it cancels the job automatically.
The default value is 5 minutes.
- -source hostname files
-
Select source files and directories to be restored.
A hostname must be specified, meaning that
files were backed up from hostname.
Note that this option
can appear only once per job, that is, data from multiple workstations
cannot constitute the source for a single restore operation.
Any of the above options can be used at any time, with the exception of
-base and -entirepath which are mutually exclusive.
Multiple instances of the -filter option are allowed.
as_restore
decides whether or not to use the SCO ARCserve/Open database prior to
starting the job, by following two simple rules:
-
If source is present, the database must be used to obtain file information.
If the options -tape and -session are also present,
the restore job is equivalent to one obtained through the Tape View of the
Restore Manager.
Otherwise, the job is equivalent to one obtained through the Tree View.
-
If the -source option is not present,
the restore job is equivalent to one obtained through the Tape Session View of the
Restore Manager, and the SCO ARCserve/Open database is not needed.
See
the SCO ARCserve/Open User Guide
for a detailed explanation of the
different views available from the Restore Manager.
Alternately, as_restore can be used with one of the following info_options.
When used in this context, as_restore will not generate a restore job,
but simply provide information on possible sources and destinations for a restore operation.
- -listgroups
-
Display list of potential source groups/tapes.
These are the tapes that are currently in the tape or
changer devices available to SCO ARCserve/Open.
Also displays available destinations, namely local and remote workstations.
Only the remote workstations that are in the SCO ARCserve/Open database and
are running a Client Agent will be displayed.
- -listtapes
-
Show a list of tapes in the SCO ARCserve/Open database. Sessions and
files on these tapes can be restored through as_restore.
- -listsessions tapename [tapeid]
-
List all sessions in tape tapename. Should there be more than one
tape named tapename in the SCO ARCserve/Open database, tapeid
can be used to distinguish between them.
tapeid can be obtained from the output of the -listtapes option.
- -version [hostname] path
-
Show all copies of file or directory path currently in the
SCO ARCserve/Open database. Useful when having to restore individual entries,
but not necessarily their most recent versions.
See
the SCO ARCserve/Open User Guide for more details.
- -findfile pattern client|any path flag date|today count timeunit
-
Find all files in the SCO ARCserve/Open database matching pattern.
A specific workstation client can be specified;
the keyword any will broaden the search to include all workstations.
path specifies a beginning point for the search.
If flag is incldir, subdirectories under path will be searched,
whereas if flag is noincldir
only files directly under path will be matched.
The search will only match files whose last modification time lies within
count timeunits of date. The keywords day(s), month(s),
and year(s) are valid timeunits.
date must be specified in the format mm/dd/yy. Alternately, the
keyword today can be used and is replaced by the current date.
- -usage
-
Display the syntax of as_restore.
Only one of the above options can be used at a time.
If no options are present, -usage is assumed.
Diagnostics
-
user does not have ARCserve Queue User privilege:
user is not
a valid SCO ARCserve/Open user. See
the SCO ARCserve/Open User Guide for details.
-
Could not get the status of user user:
The SCO ARCserve/Open scheduler is not running. You must start SCO ARCserve/Open first.
-
Could not get information from the ARCserve database.
The program could not obtain file/job/tape information from the ARCserve database.
Make sure ARCserve is running.
-
There are no tape records in the SCO ARCserve/Open database.
An attempt to list tapes and/or sessions in the ARCserve database failed because
no tape records exist.
-
Could not find the specified tape/session in the SCO ARCserve/Open database.
A non-existent tape or session was requested. This may be
because the tape/session is not currently in the database, or because the
user does not have sufficient privileges to restore from this tape/session.
-
At least one of the source items could not be located in the database.
All source files specified must be in the ARCserve database.
References
as_backup(1),
as_qmgr(1),
as_devmgr(1),
as_dbmgr(1),
as_scan(1),
as_merge(1),
SCO ARCserve/Open User Guide
Notices
When using wildcards in filter options, you will need to enclose them in quotes, so
that the shell will not expand them in the command line. (Of course you may want
the shell to expand wildcards in other instances, for example when specifying the files
to be restored.)
As discussed previously, the combination of the options -tape, -session,
and -source determines which Restore Manger "view" the job corresponds to.
There is only one ambiguous case, which occurs when a Queue Operator specifies only
a tape name and session number. In that instance, the command-line interface
will not consult the SCO ARCserve/Open database.
SCO ARCserve/Open 2.2.0 -- December 1997
© 1997 The Santa Cruz Operation, Inc. All rights reserved.