Backup Syntax

Home | Previous Page | Next Page Overview of the ON-Bar Backup and Restore System > Backing Up with ON-Bar > Backing Up Storage Spaces and Logical Logs >

Backup Syntax

Backing Up Storage Spaces and Logical Logs:
 
|-- -b--+----------+--+-------------------+--+----------+------->
        |     (1)  |  |              (1)  |  |     (1)  |
        '- -p------'  '- -q--session------'  '- -S------'
 
>--+----------+------------------------------------------------->
   |     (1)  |
   '- -v------'
 
>----+-+------------+--+----------+--+------------------+-+-----|
     | '- -L--level-'  |     (2)  |  +- -f--filename----+ |
     |                 '- -O------'  | .--------------. | |
     |                               | V              | | |
     |                               +---dbspace_list-+-+ |
     |                               |     (2)          | |
     |                               '- -w--------------' |
     |     (2)                                            |
     '- -F------------------------------------------------'

Notes:

Extended Parallel Server Only
Dynamic Server Only

Element	Purpose	Key Considerations
-b	Specifies a backup Backs up the storage spaces, logical logs, including the current logical log, and the ISM catalog, if it exists.	You must specify the -b parameter first. Important: During a backup, if ON–Bar encounters a down dbspace, it skips it and later returns an error.
dbspace_list	Names storage spaces to be backed up On XPS, if you enter a dbslice name, it backs up all the dbspaces in that dbslice.	If you do not enter dbspace_list or -f filename, ON-Bar backs up all online storage spaces on the database server. If you enter more than one storage-space name, use a space to separate the names.
-f filename	Backs up the storage spaces that are listed in the text file whose pathname filename provides Use this option to avoid entering a long list of storage spaces every time that you back up.	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. For the format of this file, see Figure 10. The file can list multiple storage spaces per line.
-F	Performs a fake backup (IDS)	You can execute this option whether or not a storage-manager application is running. ON–Bar ignores dbspace_list if you specify it. Use fake backups to change database logging modes; to allow the user to use new logs, chunks, or mirrors without performing a backup; or in special situations when you, the administrator, judge that a backup is not needed. No backup actually occurs, so no restore is possible from a fake backup. It is recommended that you use fake backups sparingly, if at all.
-L level	Specifies the level of backup to perform on storage spaces: 0 for a complete backup (The default.) 1 for changes since the last level-0 backup 2 for changes since the last level-1 backup	If you request an incremental backup and ON-Bar finds that no previous level backup has been performed for a particular storage space, ON-Bar backs up that storage space at the previous level. For example, if you request a level-1 backup, and ON-Bar finds no level-0 backup, it makes a level-0 backup instead. For more information, see Performing an Incremental Backup.
-O	Overrides normal backup restrictions	Use this option to back up logical logs when blobspaces are offline. If a log backup occurs when blobspaces are offline, return code 178 displays in the ON–Bar activity log.
-p	Performs a physical backup (XPS)	Backs up storage spaces and the ISM catalog. (If you omit the -p option, ON-Bar also backs up the logical logs.)
-q session	Allows you to assign a name to the backup session (XPS)	DBSERVERNAMErandom_number is the default session name. The session name must be unique and can be up to 128 characters. This name appears in the output from the onstat utility so that you can follow the progress of the backup. For more information, see Monitoring the Backup Scheduler Status.
-S	Skips backing up read-only storage spaces if archives taken after the storage spaces became read-only exist (XPS)	By default, read-only (static) dbspaces are backed up. Use this option to avoid backing up read-only storage spaces if they have already been backed up since becoming read-only. If you use this option, ON-Bar checks if a storage space is static, and if so, whether the storage space has an existing backup that was performed after the storage space became read-only. If both conditions are satisfied, then ON-Bar does not back up the storage space, even if you explicitly specify that storage space with the -f option or by including the storage space name in the backup command. For more information on static storage spaces, see How to Avoid Repeatedly Archiving Read-Only Storage Spaces and the IBM Informix: Administrator's Reference.
-w	Performs a whole-system backup (IDS)	Backs up all storage spaces, critical dbspaces, and logical logs serially. If you do not save the logical logs, you must use the -w option.
-v	Verifies a backup (XPS) If verification is successful, you can restore the storage spaces safely.	Specify onbar -v to verify the backup. You cannot verify the logical logs.