BAR_BSALIB_PATH configuration parameter

Use the BAR_BSALIB_PATH configuration parameter to specify the path name and file name of the XBSA shared library for the storage manager that you use.

default value
UNIX™: $ONEDB_HOME/lib/ibsad001.extension
Windows™: %ONEDB_HOME%\lib\ibsad001.extension
The extension is platform specific.
onconfig.std value
Not set.
takes effect
When onbar-driver starts
When you reset the value dynamically in your onconfig file by running the onmode -wf or equivalent SQL administration API command.

Usage

ON-Bar and the storage manager rely on a shared library to integrate with each other. Configure the BAR_BSALIB_PATH configuration parameter for your storage-manager library. Support for BAR_BSALIB_PATH is platform-specific. Check your machine notes to determine whether you can use this configuration parameter with your operating system. You can change the value of BAR_BSALIB_PATH between a backup and restore.

To ensure that this integration takes place, specify the shared-library path name. Set one of the following options:

UNIX:

  • Place the storage-manager library in the default directory.

    For example, the suffix for Solaris is so, so you specify $ONEDB_HOME/lib/ibsad001.so on a Solaris system.

    For example, the suffix for Solaris is so, so you specify $ONEDB_HOME/lib/libbsapsm.so on a Solaris system.

  • Place the storage-manager library in any directory and create a symbolic link from $ONEDB_HOME/lib/ibsad001.platform_extension to it.

    If you use HCL® OneDB® Storage Manager , create a symbolic link to $ONEDB_HOME/lib/libbsa.platform_extension or set BAR_BSALIB_PATH to this absolute path value.

    If you use HCL Tivoli® Storage Manager (TSM), create a symbolic link to $ONEDB_HOME/lib/libtxbsa.platform_extension or set BAR_BSALIB_PATH to this absolute path value.

  • Set the LD_LIBRARY_PATH environment variable. For example, set LD_LIBRARY_PATH to $ONEDB_HOME/lib.

Windows:

  • Place the storage-manager library in the default directory.
  • Set the path name for the ISM shared library to the installation directory for ISM: %ISMDIR%\bin\libbsa.dll.

    The %ismDIR% variable includes a version or release number. For example: set ISMDIR=C:\program files\informix\ism\2.20. This directory is set when the database server is installed on Windows. This path name is different if you use a different storage manager.

If the parameter BAR_BSALIB_PATH is missing or has no value and the database server cannot open the XBSA shared library for your platform, ON-BAR tries to use the HCL OneDB Primary Storage Manager as the storage manager in all platforms.

Tip: Be sure that the shared library can access the backup data in the storage manager in a restore. You cannot back up on to one storage manager and restore from a different storage manager.