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™: $INFORMIXDIR/lib/ibsad001.extension
Windows™: %INFORMIXDIR%\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 $INFORMIXDIR/lib/libbsapsm.so on a Solaris system.

  • Place the storage-manager library in any directory and create a symbolic link from $INFORMIXDIR/lib/ibsad001.platform_extension to it.
  • Set the LD_LIBRARY_PATH environment variable. For example, set LD_LIBRARY_PATH to $INFORMIXDIR/lib.

Windows:

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

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