BAR_RETRY

The BAR_RETRY configuration parameter specifies how many times onbar should retry a data backup, logical-log backup, or restore operation if the first attempt fails.

BAR_RETRY on Dynamic Server (IDS)

onconfig.std value

1

if value not present

1

range of values

BAR_ABORT(0), BAR_CONT(1), or n

takes effect

When onbar starts

The setting of the BAR_RETRY parameter determines ON–Bar behavior in the following ways:

• If set to BAR_ABORT, ON–Bar aborts the backup or restore session when an error occurs for a storage space or logical log, returns an error, and quits. If ON–Bar is running in parallel, the already running processes finish but no new ones are started.
• If set to BAR_CONT, ON–Bar aborts the backup or restore attempt for that particular storage space, returns an error, and attempts to back up or restore any storage spaces or logical logs that remain.
• If set to a specific number (n), ON–Bar attempts to back up or restore this storage space or logical log the specified number of times before it gives up and moves on to the next one.

BAR_RETRY on Extended Parallel Server

onconfig.std value

0. Does not retry

range of values

0 to 5

takes effect

When the database server starts

If a backup or restore fails, ON–Bar attempts to back up or restore the object the specified number of times before it gives up and moves on to the next object.

The Backup Scheduler maintains two retry counts: object retries and storage-manager retries.

Object retries is the number of times that the Backup Scheduler attempts a backup or restore operation. If the backup or restore of a particular object gets an error, the Backup Scheduler retries it BAR_RETRY times. If it continues to fail, the Backup Scheduler removes the object from the backup session.

Storage-manager retries is the number of times that the Backup Scheduler attempts to start an onbar-worker process before giving up. If an onbar-worker process registers with the Backup Scheduler but exits with an error, then the Backup Scheduler tries to start another onbar-worker process, up to BAR_RETRY times. If the onbar-worker process fails before it registers or if the Backup Scheduler already has tried to start an onbar-worker process BAR_RETRY times, it does not start another onbar-worker process.

You can monitor the storage-manager retry count with onstat -g bus_sm. For more information, see Monitoring the Backup Scheduler Status.