> Software > Protect > Databases > Informix > Configuration

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...