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:

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

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.