Performing a Restore

Home | Previous Page | Next Page The ontape Backup and Restore System (IDS) > Restoring with ontape >

Performing a Restore

Use the -r option to perform a full physical and logical restore of the database server data with ontape. Use the -D option to restore selected storage spaces. Use the -rename option to rename chunks during the restore.

Performing a Data Restore:
 
|--+-+- -r--+----------------------+-+--+------------------+--+--------------------+-+--|
   | |      '-| Renaming a Chunk |-' |  |      .---------. |  '- -t STDIO--+-----+-' |
   | '- -p--+-----+------------------'  |      V         | |               '- -v-'   |
   |        '- -e-'                     '- -D----dbspace-+-'                         |
   '-+- -l-+-------------------------------------------------------------------------'
     '- -S-'
 
Renaming a Chunk:
 
|--+----------------------------------------------------------------------------------+--|
   |             .----------------------------------------------------------------.   |
   |             V                                                                |   |
   '- -rename--+--- -p--old_path-- -o--old_offset-- -n--new_path-- -o--new_offset-+-+-'
               '- -f--filename------------------------------------------------------'

Element	Purpose	Key Considerations
-D	Directs ontape to restore only the storage spaces you specify.	The database server must go into online or quiescent mode to do a warm restore. When you use the -D option, you can restore selected storage spaces. When you do not specify the -D option, ontape performs a full-system restore. The database server must go offline to do a full-system restore. For more information, see Restoring Selected Storage Spaces.
dbspace	Is the name of a storage space to restore.	You can specify multiple storage spaces, but you must include the root dbspace.
-e	Directs ontape to perform an external restore	For more information, see Performing an External Backup and Restore Using ontape.
-f filename	Specifies a file containing the names and offsets of chunks to be renamed and their new locations. Use to rename a large number of chunks at one time.	The filename can be any valid UNIX or Windows filename, including simple (listfile_1), relative (../backup_lists/listfile_2 or ..\backup_lists\listfile2), and absolute (/usr/informix/backup_lists/listfile3 or c:\informix\backup_lists\listfile3) filenames. In the file, list the old chunk pathname and offset and the new chunk pathname and offset, with a blank space or a tab between each item. Put information for each chunk on a separate line. Blank lines are ignored. Begin comment lines with a # symbol.
-l	Directs ontape to perform a logical restore.	The -l option restores data from the logical-log backup tapes you created after (and including) your last level-0 backup.
-p	Directs ontape to perform a physical data restore.	The -p option restores data from the backup tape you created after (and including) your last level-0 backup. During the restore, the database server is in single-user mode.
-p old_path -o old_offset -n new_path -o new_offset	Specifies the chunk to be renamed and its new location. Use to rename one or more chunks at one time.	The variables for this element are: old_path is the current path and filename of the chunk old_offset is the current offset of the chunk, in kilobytes new_path is the new path and filename of the chunk new_offset is the new offset of the chunk
-r	Directs ontape to perform a data restore (both physical and logical).	The -r option restores data from the backup tape and the logical-log backup tapes you created after (and including) your last level-0 backup.
-rename	Directs ontape to rename the specified chunks.	For more information on renaming chunks during a restore, see Renaming Chunks During a Restore.
-S	Directs ontape to perform a logical log salvage.	If you want to salvage logical logs, you must use the -S option prior to performing a restore from standard input. The LTAPEDEV configuration parameter must be set to the logical log tape device.
-t STDIO	Directs ontape to restore from standard input.	The -t option overrides the value of the TAPEDEV configuration parameter for the current restore.
-v	Directs ontape to write informational message to stderr during a restore from standard input.	Verbose mode is useful for monitoring the progress of a restore from standard input.