# Configure the Informix ONCONFIG File

Before you perform backups and restores, you must modify certain parameters in the $INFORMIXDIR/etc/onconfig.<servername> file.

The software uses the ONCONFIG file to administer the number of streams and other capabilities for Informix.

Parameter | Definition | Default value | What to change the value to
--- | --- | --- | ---
BAR_MAX_BACKUP | The number of streams that the software uses for backups. | 0 | Greater than zero, and less than or equal to the maximum number of streams allowed at the storage policy level.
TAPEDEV | The tape device that is used for dbspace backups. | The default values dismiss the logs: UNIX: /dev/null Windows: Nul | A non-existing directory that has full access to perform log backups for an Informix user. For example, change the values to the following: UNIX: TAPEDEV /dev/tmp0 Windows: $INFORMIXDIR\tmp\tape0
LTAPEDEV | The tape device that is used for log file backups. | The default values dismiss the logs: UNIX: /dev/null Windows: Nul | A non-existing directory that has full access to perform log backups for an Informix user. For example, change the values to the following: UNIX: LTAPEDEV /dev/tmp1 Windows: LTAPEDEV C:\Program Files\IBM\Informix\tape1
BAR_BSALIB_PATH | Specifies the location of the shared library for ON-Bar and the storage manager. | None In a Windows configuration, you must specify this parameter. When you create an instance, this parameter is updated. In a UNIX configuration, if you don't specify this parameter, ON-Bar looks for the symbolic link in the $INFORMIX/lib path. | The location that you want to use for ON-Bar and the storage manager.
ALARMPROGRAM | Specifies the path to the script file that triggers automatic log backups. | UNIX: $INFORMIXDIR/etc/alarmprogram.sh In some environments, this may be log_full.sh Windows: $INFORMIXDIR/etc/alarmprogram.bat In some environments, this may be log_full.bat | The ALARMPROGRAM script can point to any valid script file. However, ensure that the BACKUP_CMD parameter in the script uses onbar and not ontape. Commvault uses onbar for log backups. To support point-in-time restore operations, all transaction logs must be backed up through Commvault. Do not configure ontape for log backups. Update the BACKUP_CMD value in all alarmprogram script files to: BACKUP_CMD="onbar -b -l"

### Best Practices

#### Rebuild the ixbar file with continuous logical log entries

After updating the BACKUP_CMD value to use onbar, consider renaming the existing ixbar file so that Informix creates a new ixbar file with continuous logical log entries.

It helps eliminate historical gaps in logical log tracking and prevent missing log conditions during restore operations.

Caution

Before renaming the ixbar file, retain a backup copy of the existing file. The ixbar file is critical for restore and point-in-time recovery operations.

×

Loading...