Ubuntu存储库
apt update
apt -y install apt-transport-https wget gnupg
wget -O - https://packages.icinga.com/icinga.key | gpg --dearmor -o /usr/share/keyrings/icinga-archive-keyring.gpg
. /etc/os-release; if [ ! -z ${UBUNTU_CODENAME+x} ]; then DIST="${UBUNTU_CODENAME}"; else DIST="$(lsb_release -c| awk '{print $2}')"; fi; \
echo "deb [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/ubuntu icinga-${DIST} main" > \
/etc/apt/sources.list.d/${DIST}-icinga.list
echo "deb-src [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/ubuntu icinga-${DIST} main" >> \
/etc/apt/sources.list.d/${DIST}-icinga.list
apt update
安装 Icinga 2
您可以使用发行版的包管理器来安装 Icinga 2
icinga2
。
root
除非另有说明,否则必须使用权限执行以下命令。
在 Fedora 上安装 Icinga 2
添加 Icinga 包存储库
我们建议使用我们的官方存储库。以下是将其添加到系统的方法:
Fedora 仓库
rpm --import https://packages.icinga.com/icinga.key
dnf install -y 'dnf-command(config-manager)'
dnf config-manager --add-repo https://packages.icinga.com/fedora/$(. /etc/os-release; echo "$VERSION_ID")/release
安装 Icinga 2
您可以使用发行版的包管理器来安装 Icinga 2 icinga2
。root
除非另有说明,否则必须使用权限执行以下命令。
提示
如果启用了
SELinuxicinga2-selinux
,则还需要该软件包。
dnf install icinga2
systemctl enable icinga2
systemctl start icinga2
系统服务
大多数受支持的发行版都使用 systemd。Icinga 2 软件包会自动安装必要的 systemd 单元文件。
如果遇到配置错误,您可以手动调用 配置验证。
提示
如果您在启用 systemd 的发行版中遇到分叉错误,请查看
故障排除章节。
设置检查插件
没有插件 Icinga 2 不知道如何检查外部服务。Monitoring Plugins Project提供了一组广泛的插件,可以与 Icinga 2 一起使用来检查服务是否正常工作。
需要这些插件才能使示例配置 开箱即用。
根据您的插件安装到哪个目录,您可能需要更新Icinga 2 配置PluginDir
中的全局常量。Icinga 模板库中包含的检查命令定义使用此常量来确定在哪里可以找到插件二进制文件。
提示
有关如何将其他检查插件集成到 Icinga 2 设置中的详细信息,请参阅
服务监控章节。
dnf install nagios-plugins-all
设置 Icinga 2 API
几乎每个 Icinga 2 设置都需要 Icinga 2 API,因为 Icinga Web 连接到它,Icinga DB 需要它,并且它为高可用性和分布式设置启用集群通信功能。
信息
如果您设置了高可用性和/或分布式 Icinga 监控环境,请阅读
分布式监控一章,因为设置 API 的命令不同于设置单节点设置。
详情请见API章节,或按照以下步骤快速设置 API:
运行以下命令以:
- 启用该
api
功能,
- 设置证书,以及
root
在配置文件中添加具有自动生成密码的 API 用户/etc/icinga2/conf.d/api-users.conf
。
重新启动 Icinga 2 以使这些更改生效。
systemctl restart icinga2
备份
确保在备份中包含以下内容:
- 配置文件在
/etc/icinga2
/var/lib/icinga2/ca
(主 CA 密钥对)和/var/lib/icinga2/certs
(节点证书)中的证书文件
- 运行时文件在
/var/lib/icinga2
在 Raspbian 上安装 Icinga 2
添加 Icinga 包存储库
我们建议使用我们的官方存储库。以下是将其添加到系统的方法:
树莓派存储库
apt update
apt -y install apt-transport-https wget gnupg
wget -O - https://packages.icinga.com/icinga.key | gpg --dearmor -o /usr/share/keyrings/icinga-archive-keyring.gpg
DIST=$(awk -F"[)(]+" '/VERSION=/ {print $2}' /etc/os-release); \
echo "deb [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/raspbian icinga-${DIST} main" > \
/etc/apt/sources.list.d/icinga.list
echo "deb-src [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/raspbian icinga-${DIST} main" >> \
/etc/apt/sources.list.d/icinga.list
apt update
安装 Icinga 2
您可以使用发行版的包管理器来安装 Icinga 2
icinga2
。
root
除非另有说明,否则必须使用权限执行以下命令。
系统服务
大多数受支持的发行版都使用 systemd。Icinga 2 软件包会自动安装必要的 systemd 单元文件。
如果遇到配置错误,您可以手动调用
配置验证。
提示
如果您在启用 systemd 的发行版中遇到分叉错误,请查看
故障排除章节。
设置检查插件
没有插件 Icinga 2 不知道如何检查外部服务。Monitoring
Plugins Project提供了一组广泛的插件,可以与 Icinga 2 一起使用来检查服务是否正常工作。
需要这些插件才能使
示例配置 开箱即用。
根据您的插件安装到哪个目录,您可能需要更新
Icinga 2 配置PluginDir
中的全局常量。Icinga 模板库中包含的检查命令定义使用此常量来确定在哪里可以找到插件二进制文件。
提示
有关如何将其他检查插件集成到 Icinga 2 设置中的详细信息,请参阅
服务监控章节。
apt install monitoring-plugins
设置 Icinga 2 API
几乎每个 Icinga 2 设置都需要 Icinga 2 API,因为 Icinga Web 连接到它,Icinga DB 需要它,并且它为高可用性和分布式设置启用集群通信功能。
信息
如果您设置了高可用性和/或分布式 Icinga 监控环境,请阅读
分布式监控一章,因为设置 API 的命令不同于设置单节点设置。
详情请见
API章节,或按照以下步骤快速设置 API:
运行以下命令以:
- 启用该
api
功能,
- 设置证书,以及
root
在配置文件中添加具有自动生成密码的 API 用户/etc/icinga2/conf.d/api-users.conf
。
重新启动 Icinga 2 以使这些更改生效。
systemctl restart icinga2
备份
确保在备份中包含以下内容:
- 配置文件在
/etc/icinga2
/var/lib/icinga2/ca
(主 CA 密钥对)和/var/lib/icinga2/certs
(节点证书)中的证书文件
- 运行时文件在
/var/lib/icinga2
在 Debian 上安装 Icinga 2
添加 Icinga 包存储库
我们建议使用我们的官方存储库。以下是将其添加到系统的方法:
Debian 仓库
apt update
apt -y install apt-transport-https wget gnupg
wget -O - https://packages.icinga.com/icinga.key | gpg --dearmor -o /usr/share/keyrings/icinga-archive-keyring.gpg
DIST=$(awk -F"[)(]+" '/VERSION=/ {print $2}' /etc/os-release); \
echo "deb [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/debian icinga-${DIST} main" > \
/etc/apt/sources.list.d/${DIST}-icinga.list
echo "deb-src [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/debian icinga-${DIST} main" >> \
/etc/apt/sources.list.d/${DIST}-icinga.list
apt update
Debian Backports 存储库
自 Icinga v2.11 以来,Debian Stretch 需要此存储库。
Debian 延伸:
DIST=$(awk -F"[)(]+" '/VERSION=/ {print $2}' /etc/os-release); \
echo "deb https://deb.debian.org/debian ${DIST}-backports main" > \
/etc/apt/sources.list.d/${DIST}-backports.list
apt update
安装 Icinga 2
您可以使用发行版的包管理器来安装 Icinga 2
icinga2
。
root
除非另有说明,否则必须使用权限执行以下命令。
apt install icinga2
详细步骤请查看以下网址