logjam-libs

About

logjam-libs provides methods to compile and install system libraries required by the logjam-tools package.

The following packages are included:

• libzmq
• libczmq
• mongo-c-driver
• libbson
• json-c (0.12 patched)
• libsnappy
• lz4
• microhttpd

Usage

Installing packages locally

Calling script ./bin/install-libs --prefix=DIR will download, compile and install packages in the given directory, following standard Linux conventions. It defaults to /usr/local, populating /usr/local/bin and /usr/local/lib.

Another good choice is --prefix=/opt/logjam, which makes sure that the logjam provided libraries do not interfere with system versions.

If you are using Homebrew as your package manager on Mac OS it is recommended to install the libraries with --without-documentation to prevent issues arising from trying to validate XML files that can seemingly only be validated when docbook-xsl-nons is installed.

If you want to get rid of the installed software, run

./bin/install-libs uninstall

CI/CD pipeline

Upon code push, the GitHub Actions workflow builds docker images and Debian packages for Ubuntu Jammy and Focal and uploads the images to docker hub and the packages to railsexpress.de.

Containers and packages are versioned. Edit bin/version to increment the version number before you push to Github, if you want to build a new package.

The containers are:

• stkaes/logjam-libs:jammy-<version>
• stkaes/logjam-libs:focal-<version>
• stkaes/logjam-libs:jammy-usr-local-<version>
• stkaes/logjam-libs:focal-usr-local-<version>

The packages are:

• jammy/logjam-libs_<version>_amd64.deb
• focal/logjam-libs_<version>_amd64.deb
• jammy/logjam-libs-usr-local_<version>_amd64.deb
• focal/logjam-libs-usr-local_<version>_amd64.deb

The usr-local packages/containers are built with prefix /usr/local, the other ones use /opt/logjam.

Building containers and packages locally

Run make containers packages to build docker images and Ubuntu packages.