Configuring ON-Bar

Before you begin your first backup, review the default ON-Bar parameters in the onconfig file and adjust the values as needed. You can also set an environment variable.

You can configure the behavior of ON-Bar by setting the following configuration parameters and environment variable.

Table 1. ON-Bar configuration parameters and environment variable
Behavior Configuration parameters
Control the number and size of data buffers and the number of parallel processes. BAR_NB_XPORT_COUNT configuration parameter

BAR_XFER_BUF_SIZE configuration parameter

IFX_BAR_NO_LONG_BUFFERS environment variable

BAR_MAX_BACKUP configuration parameter

BAR_MAX_RESTORE configuration parameter

Set the debugging level and the location of debug log file. BAR_DEBUG configuration parameter

BAR_DEBUG_LOG configuration parameter

Change the path of the ON-Bar boot file. BAR_IXBAR_PATH configuration parameter
Maintain a history of expired backups. BAR_HISTORY configuration parameter
Change the location and contents of ON-Bar activity log. BAR_IXBAR_PATH configuration parameter
Maintain a history of expired backups. BAR_ACT_LOG configuration parameter

BAR_PROGRESS_FREQ configuration parameter

BAR_PERFORMANCE configuration parameter

Set automatic retrying of failed back ups or restores. BAR_RETRY configuration parameter
Allow a failed restore to be restarted. RESTARTABLE_RESTORE configuration parameter
Increase backup size estimate sent to the storage manager. BAR_SIZE_FACTOR configuration parameter
Extend the time an RS secondary server waits for a checkpoint during an external backup. BAR_CKPTSEC_TIMEOUT configuration parameter
Configure continuous log backup. ALARMPROGRAM configuration parameter
Filter or transform backed up data with an external program. BACKUP_FILTER configuration parameter

RESTORE_FILTER configuration parameter

Optimize the deduplication capabilities of storage managers. IFX_BAR_USE_DEDUP environment variable
Disable the ability to replicate, import, or export backup objects among TSM servers. IFX_TSM_OBJINFO_OFF environment variable
Force the use of the sm_versions file. IFX_BAR_NO_BSA_PROVIDER environment variable

Do not set the LTAPEDEV configuration parameter to /dev/null or NUL because logical-log backups would be disabled and you can restore only whole-system backups.