Configuration - Informix iDataAgent

Relinking Instances

For UNIX configurations, you must relink the instance before you perform backups. If you did not relink the instance when you installed the Informix Agent, you must run the Ifx_install script and then relink the instance. The Ifx_install script creates a symbolic link in the $INFORMIXDIR/lib directory that points to the SnapProtect XBSA shared library. ON-Bar loads the shared library from the SnapProtect Base path for backup and restore operations.

Procedure

  1. On the command line, go to the SnapProtect/iDataAgent directory and run the Ifx_install script .
  2. You must provide the following Informix instance credentials:
    • The user name
    • The group name
    • The INFORMIXDIR
    • The ONCONFIG
    • The INFORMIXSERVER
    • The BAR_BSALIB_PATH

Validating the Relinking of the Informix Instance

Use this procedure to validate the relinking of the Informix instance.

  • On the command line, go to the $INFORMIXDIR/lib directory and type the following command to verify that the symbolic link was created.

    ls -l $INFORMIXDIR/lib | grep ibsad*

If the relinking was successful, the result points to the XBSA shared library, "ibsad001".

Configuring the ONCONFIG File

Before you perform backup and restore operations, you must modify the following parameters in the ONCONFIG file.

  1. BAR_MAX_BACKUP

    Use this parameter to define the number of parallel streams used in backup and restore operations. By default, this is set to 0.

  2. TAPEDEV, LTAPEDEV

    Use the TAPEDEV parameter to define the device that is used for dbspace backups. Use the LTAPEDEV parameter to define the tape device log file backups.

    Change the value of each parameter to a non-existing directory that has full access to perform log backups for an Informix user.

    UNIX Configuration Example

    TAPEDEV /dev/tmp0
    LTAPEDEV /dev/tmp1

    Windows Configuration Example

    LTAPEDEV C:\Program Files\IBM\Informix\tape1

  3. BAR_BSALIB_PATH

    Use this parameter to define the location of the shared library for ON-Bar and the CommVault storage manager.

    You must specify this parameter in a Windows configuration. This parameter is updated when you create an instance in the CommCell Console.

    In a UNIX configuration, ON-Bar looks for the symbolic link in the $INFORMIX/lib path when you do not specify this parameter.

    Note: If you use INFORMIX version 12.10 and you do not specify the BAR_BSALIB_PATH parameter, the backups are not available for the SnapProtect software to restore.

CommCell Console

Configure the Informix Instance

Once the Informix iDataAgent is installed, configure the Informix instance as follows:

  1. In the CommCell Browser, click Client Computers | <Client>.
  2. Right-click Informix, point to All Tasks, and then click New Instance (INFORMIX SID).

    The Create New Instance (INFORMIX SID) screen appears.

  3. In the Informix Server Name box, type the Informix server name.
  4. In the Informix User box, type the Informix administrator user name.
  5. In the Informix DIR box, type the path to the directory where the Informix application files are stored or click Browse to select the location of the Informix application files.
  6. In the ONCONFIG File box, type the name of the configuration file or click Browse to select the location of the configuration file.
  7. In the Storage Policy used for the data of default subclient box, select the storage policy name from the list.
  8. Click the Storage Device > Command Line Backup.
  9. In the Storage Policy used for user command backup of data box, select the storage policy name from the list.
  10. Click the Log Backup tab.
  11. In the Storage Policy used for all Logical Log Backups box, select the storage policy name from the list.
  12. Click OK.

Configure the Subclient

Configure the subclient by assigning it to a Storage Policy.

For instructions on how to create a Storage Policy, refer to the Storage Policy documentation.

  1. In the CommCell Browser, navigate to Client Computers | <Client> | Informix | <Instance>. 
  2. Right-click the default subclient and then click Properties.
  3. Click the Storage Device tab.
  4. In the Data Storage Policy list, select a Storage Policy name.
  5. Click OK.