icingabeat/docs/02-installation.md

2.4 KiB

Installation

Packages

Packages are available on packages.icinga.com.

Depending on your distribution and version you need to run one of the following commands:

Debian

wget -O - https://packages.icinga.com/icinga.key | apt-key add -
echo 'deb http://packages.icinga.com/debian icinga-stretch main' > etc/apt/sources.list.d/icinga.list
apt-get update
apt-get install icingabeat

Ubuntu

wget -O - https://packages.icinga.com/icinga.key | apt-key add -
echo 'deb http://packages.icinga.com/ubuntu icinga-xenial main' > etc/apt/sources.list.d/icinga.list
apt-get update
apt-get install icingabeat

CentOS

yum install epel-release
rpm --import https://packages.icinga.com/icinga.key
yum install https://packages.icinga.com/epel/icinga-rpm-release-7-latest.noarch.rpm
yum install icingabeat

RHEL

yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
rpm --import https://packages.icinga.com/icinga.key
yum install https://packages.icinga.com/epel/icinga-rpm-release-7-latest.noarch.rpm
yum install icingabeat

SLES

rpm --import https://packages.icinga.com/icinga.key
zypper ar https://packages.icinga.com/SUSE/ICINGA-release.repo
zypper ref
zypper install icingabeat

Run

Make sure you have configured Icingabeat properly before starting it. Use one of the following commands to start Icingabeat:

  • service icingabeat start or
  • systemctl start icingabeat or
  • /etc/init.d/icingabeat start

Dashboards

We have dashboards prepared that you can use when getting started with Icingabeat. They are meant to give you some inspiration before you start exploring the data by yourself.

Note: The dashboards require Kibana >= 6.0

Import dashboards and index pattern:

icingabeat setup

Set Kibana host, user and password if necessary:

icingabeat setup -E setup.kibana.host=127.0.0.1:5601 -E setup.kibana.username=elastic -E setup.kibana.password=secret

Manual Installation

Download and install a package or tarball from the latest release page.

Development

Please follow README.md for instructions about how to build icingabeat.