Mac OS X configuration notes

DYLD_LIBRARY_PATH denied in OS X 10.11

Starting with Mac OS X 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 could be used to define 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, the proper workaround is to install all required shared libraries in /usr/local/lib. A good practice is to create the installation directory of the software component in /usr/local/product/version, and create symbolic links to the required shared libraries in /usr/local/lib.

Important: You might need to install several shared libraries in /usr/local/lib: To make sure that all required libraries are available, check the dependencies with the otool -L shared-library.dylib command.

For example:

$ mkdir /usr/local/postgresql
$ mkdir /usr/local/postgresql/9.5.1

... install PostgreSQL in /usr/local/postgresql/9.5.1 ...

$ cd /usr/local/lib
$ ln -s /usr/local/postgresql/9.5.1/lib/libpq.5.dylib libpq.5.dylib
$ otool -L /usr/local/lib/libpq.5.dylib
...

Java™ Interface

When using the Java Interface, the runtime system is able to find automatically the libjvm.dylib according to the JAVA_HOME environment variable.

For more details, see Platform-specific notes for the JVM