Apple macOS platform notes

DYLD_LIBRARY_PATH denied in macOS® 10.11

Starting with macOS® 10.11 (El Capitan), if the System Integrity Protection (SIP) is enabled, the DYLD_LIBRARY_PATH environment variable is no longer exported in sub processes. This variable defined the shared library search path for software components used by the Genero runtime system. This was required especially for database client libraries installed in directories other than /usr/lib and /usr/local/lib (the default location for shared libraries).

As DYLD_LIBRARY_PATH cannot be used, a good practice is to create symbolic links to the required shared libraries in $FGLDIR/lib.

For example, with a PostgreSQL client (14):

$ export PGDIR="/opt/homebrew/Cellar/postgresql@14/14.13"
$ ln -s $PGDIR/lib/postgresql@14/libpq.5.dylib $FGLDIR/lib/libpq.5.dylib

To make sure that all required libraries can be found, check the dependencies on a Genero binary (typically, the ODI driver) with the otool -L and otool -l commands:

$ otool -L $FGLDIR/dbdrivers/dbmpgs_9.dylib
... check dependencies and paths

$ otool -l $FGLDIR/dbdrivers/dbmpgs_9.dylib
... check load sequences

Java Interface

Check maxOS platform notes when using the Java Interface on this operating system.