Q/RESTORE User’s Guide
QSA Enterprises, LLC
100 Dry Mills Rd.
Leesburg, VA 20175
Ph 703.771.9447
Fx 703.771.9448
Table of Contents
Q/RESTORE Overview
Q/RESTORE Installation
Q/Restore Stand-Alone
Q/Restore for Q/Tos
Q/Restore for TMF
Q/Restore for DSM/TC
Q/RESTORE Operation
Q/Restore Stand-Alone
Q/Restore for Q/Tos
Q/Restore for TMF
Q/Restore for DSM/TC
Contact
QSA, Q/RESTORE, and Q/TOS are all trademarks of QSA Enterprises, LLC
NonStop, TMF, DSM/TC, BACKUP, and RESTORE are all trademarks of Hewlett Packard.
Q/RESTORE Overview
Q/RESTORE provides fast access to BACKUP tape data and is used as an acceleratorfor the HP NonStop RESTORE product. Q/RESTORE is a tape server that scans the tape for the exact location of the requested fileset(s) and only sends the necessary data to the RESTORE process.
Q/Restore gets its knowledge of the backup tape set from a listing source. The listing source is different for each version of Q/Restore. The stand-alone version uses the backup listing stored in the spooler. The other versions use data stored in various databases.
Q/Restore runs in several different environments and because of the unique requirements presented by those environments, there is a different program object file for each one. All program versions except the TMF version use the same tape scan engine. The TMF version is exclusive because TMF uses a different tape record format than BACKUP does.
The versions of Q/Restore are:
Q/Restore Version / Q/RestoreProgram Name / HP Nonstop Environment / Listing Source
Stand-Alone / QrestSA / Guardian / Backup Listing (spooler)
Q/Tos / Qrestore / QSA Q/Tos / Q/Tos database
TMF / QrestTMF / TMF / TMF database
DSM/TC / QrestDT / DSM/TC / DSM/TC database
The individual versions of Q/Restore are also started differently from one another. The Stand-Alone version is started from a TACL prompt, the same as guardian restore. The Q/Tos version is started from a QTOSCOM prompt. The TMF and DSM/TC versions are integrated into those environments and are started from TMFCOM and MEDIACOM prompts with their respective RECOVER command.
Q/Restore works by eliminating unnecessary tape reads. So a tape with many small files will produce a better result (compared to a non-accelerated restore) than a tape utilizing the same amount of tape, but with fewer larger files. However, the time saving in either case is substantial. Also, the way the file list is constructed can affect the elapsed time of the restore. A large number of NOT files in the command line will cause unnecessary reads. And, of course, if all of the files of a tape are restored Q/Restore will show no time benefit since all reads are necessary.
Q/RESTORE Installation
All versions
IXF or FTP the archived (PAK) file to your system and place the contents into $Vol.Subvol.qrestsa (use binary).
FUP alter <archive file>, code 700
Run <archive file>,*.*.*,listall,open,tapedate,vol $vol.subvol
(if RUN doesn’t work, try “UNPAK”)
The QRESTORE files will now exist in the $vol.subvol location.
Stand-Alone version
Move QRESTSA to the $SYSTEM.SYSTEM subvolume or anywhere the system administrator prefers. QRESTSA can be run from any disk location on the HP Nonstop.
Q/Tos version
Move the QRESTORE program to the Q/Tos object subvolume. You should have already upgraded your Q/Tos environment to the appropriate release level for Q/Tos (4.10 minimum) to support the QRESTORE command.
TMF version
1. Move the three files (qresttmf, qrtcnfg, qlibrt) to a separate subvolume.The name of the subvolume is unimportant. (Example: $data.qresttmf)
2. Edit the qrtcnfg file. This is where QRestTMF gets its run-time information. Leave the DEBUG and TRACE flags to OFF. With the TRACE flag set to off there is no reason to alter the TRACE-LOCATION filename. The following entries should be verified:
TMFDR-LOCATIONthe location of the TMFDR file.
$SYSTEM.SYSxx.TMFDR
REPORT-LOCATIONthe spooler location where QRESTTMF will send its output.
If this is blank, no output will be produced.
TMFCONFIG-LOCATIONthe location of the FRLIST file.
$SYSTEM.ZTMFCONF.FRLIST
3. Make sure no occurrences of TMFDR are running.
STATUS *,PROG $*.*.TMFDR
4. Run $system.sys##.tmfdr/lib qlibrt/
There will be errors. Ignore them.
5.tacl 15> tmfcom
TMFCOM - T8652G08 - (12AUG2005 - TMF)
(C)2005 Hewlett-Packard Development Company, L.P.
6. TMF 1>alter process (onlinerestore,auditrestore),programfiles $vol.subvol.qresttmf
To uninstall:
1. run $system.sys##.tmfdr/lib/
Again, there will be errors. Again, ignore them.
2.tacl 15> tmfcom
TMFCOM - T8652G08 - (12AUG2005 - TMF)
(C)2005 Hewlett-Packard Development Company, L.P.
3. TMF 1>alter process (onlinerestore,auditrestore),programfiles $system.sys##.tmfdr
DSM/TC version
1. Make sure no occurrences of MEDIASRV are running.
STATUS *,PROG $*.*.MEDIASRV
2. Run $system.sys##.mediasrv/lib qlibrd/
<break>
STOP
3.Move the QRESTDT program to the same volume as the guardian RESTORE is.
To uninstall:
1. Make sure no occurrences of MEDIASRV are running.
STATUS *,PROG $*.*.MEDIASRV
2. run $system.sys##.mediasrv/lib/
<break>
STOP
Q/RESTORE Operation
Stand-Alone version
Starting Q/RESTORE is similar in syntax to that of the HP NonStop RESTORE program. The same options and parameters are valid with Q/Restore as with Restore. But because Q/RESTORE has to get information from the backup listing there has to be a way to pass the listing location information to the Q/RESTORE program; this is done by placing the spooler supervisor name and job number of the listing within the command string. This is done by encasing this information within the “<” and “>” characters (i.e. <$SPLS.#712> ). This is imbedded within the run parameters whether on the command line or within an IN file, and can be anywhere within the restore options data. This does not add any commas to the syntax. The only other requirements are that the process MUST be named and the tape set used in the BACKUP must be labeled tapes.
Q/RESTORE can be used with both Class Tapecatalog and Tape Defines.
i.e.
delete define =tape
add define =tape,class tapecatalog, catalog on,&
use in,filecat \qsa.qsafcat,&
labels backup,&
volcat \QSA.qsavcat,volume(SP0027,SP0004),device \qsadev.$dat,fileid catlog
The Q/RESTORE program is called qrestsa
Examples:
1.Restore a file from listing stored in spool supervisor $SPLS job 712 from a command line
Run qrestsa/out$s.#rest.out,name/=tape,$data.qsa.dump<$SPLS.#712>,listall,open
2.Restore files from listing stored in spool supervisor $SPLS job 712 using an in file
Run qrestsa/out$s.#rest.out,in infil,name/
INFIL contents
$tape,
($data.qsa.dump,$obj.qsa.test),
listall,
open
Q/Tos version
Starting a Q/RESTORE through Q/TOS is syntactically the same as starting a RESTORE process, except the command is QRESTORE instead of RESTORE. When the QRESTORE command is executed, a qrestore process is started. The qrestore process then starts a restore process, thus becoming the central hub for communication between the restore process, the tape system and Q/TOS.
The Q/RESTORE for Q/TOS program is called qrestore.
Examples:
1.Restore files from a QTOSCOM prompt.
Qtoscom> Qrestore (test(1)) $tape, (system.qtosobj.*,$prod.qsparc.*), listall, open
2.Restore files from a restore file created by the FILE FINDER function of QTOSDB.
Qtoscom> Qrestore $tape,file,listall,open
3.Restore files from an input file.
Qtoscom>Qrestore(test(1))/out$s.#rest.out,in infil/
INFIL contents
$tape,
($data.qsa.dump,$obj.qsa.test),
listall,
open
TMF version
Q/Restore works within the TMF environment and is completely transparent to the user. Files are restored via the RECOVER FILES command in TMFCOM.
Example:
~ recover file $system.subvol.fn,fromarchive
DSM/TC version
Q/Restore works within the DSM/TC environment and is completely transparent to the user. Files are restored via the RECOVER DISKFILES command in MEDIACOM.
Example:
MC> recover diskfile $system.subvol.fn,tapefile catlog
Contact
QSA Enterprises, LLC
100 Dry Mill Rd.
Leesburg, VA 20175
Phone 703.771.9447
Fax 703.771.9448
1 | Page