RHEL-based

Calyptia Core Agent is distributed as the calyptia-fluent-bit package and supports the following architectures:

• x86_64

• aarch64 / arm64v8

For CentOS 9+, we use CentOS Stream as the canonical base system.

Dependencies

For RHEL-based installations, Core Agent has the following general dependencies:

• libc

• libsasl

• libsystemd

• libyaml

• OpenSSL

• zlib

To retrieve a list of specific dependencies for your environment, run the following command:

yum -q deplist <package file>

Single line install

A simple installation script is provided to be used for most Linux targets. This will always install the most recent version released.

curl -L https://github.com/calyptia/lts-notifications/releases/latest/download/install-package.sh| bash

This is purely a convenience helper and should always be validated prior to use. The recommended secure deployment approach is to follow the instructions below.

CentOS 7 and 8

Because both CentOS 7 and 8 have entered end-of-life (EOL), the default Yum repositories are unavailable.

Be sure to configure to use an appropriate mirror. For example:

$ sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-* && \
  sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*

Signature Check

Calyptia packages are all signed with the calyptia.key that are included as part of your repositories. You can check the signatures by using the built-in rpm tool.

Import Calyptia Key

rpm --import calyptia.key

Check Signature

rpm -K <package>

Configure Yum

We provide calyptia-fluent-bit through a Yum repository. To add the repository reference to your system, add a new file in /etc/yum.repos.d/ with the following content:

[calyptia-fluent-bit]
name = Calyptia Fluent Bit
baseurl = https://calyptia-lts-release-standard.s3.amazonaws.com/linux/24.4.17/[LINUX_TYPE]-[YOUR VERSION_ID]
gpgcheck=1
gpgkey=https://calyptia-lts-release-standard.s3.amazonaws.com/linux/24.4.17/calyptia.key
repo_gpgcheck=1
enabled=1

Replace [LINUX_TYPE] with either amazonlinux or package-centos accordingly.

It is best practice to always enable the gpgcheck and repo_gpgcheck for security reasons. We sign our repository metadata as well as all of our packages.

Install

After your repository is configured, run the following command to install it:

sudo yum install calyptia-fluent-bit

Now the following step is to instruct Systemd to enable the service:

sudo service calyptia-fluent-bit start

If you do a status check, you should see a similar output like this:

● calyptia-fluent-bit.service - Calyptia Fluent Bit
   Loaded: loaded (/usr/lib/systemd/system/calyptia-fluent-bit.service; enabled; vendor preset: disabled)
   Active: active (running) since Thu 2023-06-08 15:55:03 UTC; 9s ago
     Docs: https://docs.fluentbit.io/manual/
 Main PID: 16631 (calyptia-fluent)
   CGroup: /system.slice/calyptia-fluent-bit.service
           └─16631 /opt/calyptia-fluent-bit/bin/calyptia-fluent-bit -c //etc/calyptia-fluent-bit/calyptia-fluent-bit.conf

The default configuration of calyptia-fluent-bit is collecting metrics of CPU usage and sending the records to the standard output, you can see the outgoing data in your /var/log/messages file.

Support for StartLimitIntervalSec in RHEL 7

In Core Agent version 24.4.17 or later, the Core Agent systemd file doesn't include the StartLimitIntervalSec configuration in RHEL 7 due to incompatibility with systemd 219.

RHEL versions that use systemd 230 or later are unaffected by this change.