Configuring 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"