Building on macOS
The syslog-ng OSE application has been resurrected on macOS by our developer team.
We hope our product can be useful for Mac users who want to increase the security of their system through reliable logging.
Introduction
At present we are not supporting macOS syslog-ng OSE on our official repository on GitHub. However, you can compile syslog-ng OSE yourself following this guide.
Note: The guide is tested on ARM macOS Sonoma 14.2.1, Ventura 13.4, and Intel macOS Monterey 12.6.6 machines, we do our bests to keep it update, but your actual system may require additional steps or slightly different settings.
Compiling from source
Like every project syslog-ng OSE also uses different libraries and build-systems that must be installed for compiling and running properly. These dependencies can be satisfied by compiling every-each libs and tools manually, but it might be preferred to do it the easy way. Homebrew is a package manager for macOS that has great community and support. You can also use it to install the dependencies you need.
Dependencies
-
Install Homebrew on your system.
Hint: Don’t forget to set up the homebrew environment, follow the instructions in your terminal! Here you can find an even more detailed instruction about the topic.
Note: This will install Command Line Tools for Xcode as well if not already presented on the system that would also be required anyway for a seamless syslog-ng OSE build.
- Perform
brew update
if you have not done it yet. - The following packages should be installed for syslog-ng:
- autoconf
- autoconf-archive
- automake
- bison
- flex
- glib
- ivykis
- json-c
- libtool
- openssl
- pcre
- pkg-config
- The following package might be needed too depending on your macOS version and architecture:
- net-snmp
- The extra modules would require the following
- hiredis
libdbi- See bellow!- libmaxminddb
- libnet
- librdkafka
- mongo-c-driver
- python3
- rabbitmq-c
- riemann-client
- Extra tools you might require
- cmake
- criterion
- gcc@11
Hint: If you have syslog-ng OSE installed via brew, as a reference, you can check the dependencies of the brew built version using brew deps syslog-ng
This is how it might look like if you start from the ground:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
eval "$(brew shellenv)"
brew update
brew install \
autoconf \
autoconf-archive \
automake \
bison \
flex \
glib \
ivykis \
json-c \
libtool \
net-snmp \
openssl \
pcre \
pkg-config \
# Optional syslog-ng OSE module dependencies
hiredis \
# Do not use the homebrew provided one, see bellow!
# libdbi
libmaxminddb \
libnet \
librdkafka \
mongo-c-driver \
python3 \
rabbitmq-c \
riemann-client
# Optional development modules
# cmake - Optional, a better replacement of autotools making system
# criterion - Optional, needed for unit testing
# gcc@11 - Optional, clang now should compile all modules nicely
Note:
- bison is required to be installed when using homebrew, because the options provided by Apple Developer Tools are incomplete. (for example: missing -W option) The reason is why bison is ?>required to be installed from homebrew is that the -W option is supported only after 2.3.
- net-snmp might be needed as well when using homebrew, because the options provided by Apple Developer Tools are bogus a bit. The reason is why net-snmp might be required from homebrew is that the by default provided pkgconfig might give back bogus lib and include values.
- openssl - since macOS provides LibreSSL by default, you might need to expand the search path of pkg-config to find the freshly installed openSSL, see bellow. (seems it was an issue only with 1.1.x version of openssl)
- libdbi and libdbi-drivers are maintained and updated in syslog-ng OSE repositories, use the latest master version from there
- actual state of supported features, and the required dependencies can also be found here.
Preparations
-
Depending your macOS architecture and version homebrew is using different location for storing its data, so worth using generic references to it, for this, just follow the instructions during homebrew installation.
In a nutshell, you either have to use
brew shellenv
, or set manually the env like thisexport HOMEBREW_PREFIX=$(brew --prefix) export HOMEBREW_CELLAR=${HOMEBREW_PREFIX}/Cellar export HOMEBREW_REPOSITORY=${HOMEBREW_PREFIX} export MANPATH=${HOMEBREW_PREFIX}/share/man:${MANPATH} export INFOPATH=${HOMEBREW_PREFIX}/share/info:${INFOPATH} export PATH=${HOMEBREW_PREFIX}/bin:${HOMEBREW_PREFIX}/sbin:${HOMEBREW_PREFIX}/opt/python/libexec/bin:${PATH}
-
Force the building process to use bison, net-snmp (and libnet if) installed through homebrew instead of provided by Apple Developer Tools and macOS.
Add them to the
${PATH}
export PATH=${HOMEBREW_PREFIX}/opt/bison/bin:${HOMEBREW_PREFIX}/opt/libnet/bin:${HOMEBREW_PREFIX}/opt/net-snmp/bin:${PATH}
-
Extend the search path of pkg-config to use the homebrew version of openssl, net-snmp and pkgconfig
export PKG_CONFIG_PATH=${HOMEBREW_PREFIX}/opt/openssl/lib/pkgconfig:${HOMEBREW_PREFIX}/opt/net-snmp/lib/pkgconfig:${HOMEBREW_PREFIX}/lib/pkgconfig:${PKG_CONFIG_PATH}
-
Some of the modules will not, or will incorrectly provide pkg-config support (even if added to PKG_CONFIG_PATH, e.g. libmaxminddb), to help the automatic configurations find them you can add brew to
CFLAGS
,CPPFLAGS
, andLDFLAGS
export CFLAGS="-I${HOMEBREW_PREFIX}/include/ ${CFLAGS}" export CPPFLAGS="${CFLAGS} ${CPPFLAGS}" export LDFLAGS="-L${HOMEBREW_PREFIX}/lib ${LDFLAGS}"
Note: It could also happen that you must provide here further library inlcude and lib paths, e.g. for openssl 1.1.x, etc.
Getting the source
To get the latest master from syslog-ng OSE git you can use
cd YOUR_PREFERRED_WORKING_DIR # Replace `YOUR_PREFERRED_WORKING_DIR` with your actual preferred working dir
git clone https://github.com/syslog-ng/syslog-ng .
Select the compiler
Latest version of syslog-ng OSE has dropped support of gcc, so now the platform default llvm/clang must be used to complie the source
To make sure clang is used (optional) you can use:
export CC=clang
export CXX=clang++
Configuration
Using autotool
./autogen.sh
# it is always a good idea keeping as clean the source folder as pissible, so
# use a dedicated build folder for easier cleanup
mkdir build; cd build
# you might want to use --prefix /example/installdir/ as well, see bellow
../configure --with-ivykis=system --with-systemd-journal=no --disable-java --disable-java-modules
Warning: By a good chance, you might want to install the self built instance first to a custom location to prevent overwriting a possibly already existing brew installation version. In that case pass --prefix /full_path_of/installdir/
to the configure
script in the above steps.
For a full (urrently supported) feature set you can add further configure flags (excluded the not yet supported modules on macOS), for example
../configure --enable-all-modules --with-ivykis=system --with-systemd-journal=no --disable-java --disable-java-modules --disable-smtp --disable-mqtt --disable-pacct --disable-grpc
Note:
- for various reasons not all modules can be configured, built and used on all macOS versions and architectures
- for using all the available modules you might have to install further dependencies
For more details please see the actual state of supported features, and the required dependencies.
Using cmake
For the full feature set you can use
cmake --install-prefix /full_path_of/installdir -B build . -Wno-dev -DIVYKIS_SOURCE=system -DENABLE_JAVA=OFF -DENABLE_JAVA_MODULES=OFF -DENABLE_PYTHON=ON -DENABLE_PYTHON_MODULES=ON -DBUILD_TESTING=OFF -DENABLE_AFSMTP=OFF -DENABLE_MQTT=OFF -DENABLE_PACCT=OFF -DENABLE_CPP=ON -DENABLE_GRPC=OFF --fresh
Compile and install
autotools
# add AM_DEFAULT_VERBOSITY=1 before -j4 option for detailed compilation logging
make -j4
make install
# or, in a single line
# make -j4 install
cmake
# add -v as well for detailed compilation logging
cmake --build build/. --target install -j4
Testing
In order to run the tests, you have to install first the Criterion testing framework (for example: brew install criterion
), and re-configure the build with testing enabled. After that use the command below:
make check -j4
Note: For more read testing guide.
Run
`/full_path_of/installdir`/syslog-ng -F
Note: For more information read the run first guide and the syslog-ng OSE documentation