Icinga快速安装与配置

时间  2019-11-30
标签 icinga 快速 安装 配置 繁體版
原文   原文链接
简体中文     繁體中文

Icinga快速安装与配置

1.1. 绪论
1.2. 前提条件
1.3. 安装软件包
1.4. 建立账户信息
1.5. 编译和安装Icinga(包括IDOUtils)
1.5.1. 编译和安装
1.6. 定制配置
1.6.1. 启用idomod event broker 模块
1.7. 数据库建立和IDOUtils
1.8. 配置经典的Web界面
1.9. 编译和安装Icing插件
2.0. 调整SELinux的设置
2.1. 启动IDOUtils和Icinga
2.1.1. 配置Icinga开机启动
2.1.2. 登陆到经典的Web界面
2.2. 其它修改
2.3. 客户端主机的配置
2.3.1 客户端编译和安装Icinga插件
2.3.2 客户端编译和安装Nrpe
2.3.2 配置客户端Nrpe

1.1. 简述

说明

若是没有安装Icinga,你可以使用适用于您的操做系统的软件包. css

若是你打算从源代码安装，那么请使用官方发布的压缩包.ios
提示

除非你有问题，须要经过目前的开发版原本解决，不然请不要使用git快照.git

本指南旨在为您提供简单的如何从源(代码)安装Icinga的说明，并在20分钟内监控您的本地计算机.web

这里不会对进阶安装选项进行讨论 - 只需基本操做大多数的用户就能够开始使用.sql

目前提供三种不一样的Linux发行版的例子: Fedora, Ubuntu 和 openSuSE. 相似发行版也能够正常使用. 这应该包括 RedHat, CentOS, Debian 和 SLES.数据库

最终您会获得结果是什么apache

若是您按照这些说明操做,最终结果:

  • Icinga和插件将安装到 /usr/local/icinga

  • 配置Icinga监视您本地系统的几个方面 (CPU负载, disk使用率, 例如.)

  • Icinga经典web界面能够经过http://localhost/icinga/ 或 http://yourdomain.com/icinga访问

  • Icinga使用IDOUtils加载数据库

1.2. 前提条件

部分安装过程当中，你须要具备root权限.

再继续安装以前,请确保你已经安装如下软件包. 若是安装IDOUtils,须要使用libdb和libdbi-drivers的开发库. 下面的例子将显示如何安装icinga和IDOUtils.

  • Apache或Nginx

  • GCC 编译器

  • C/C++ 开发库

  • GD 开发库

  • libdbi/libdbi-drivers, 如MySQL或PostgreSQL数据库(若是不安装IDOUtils请跳过此部分)

    说明

    PostgreSQL: 因为INSERT语句的变化 PostgreSQL 8.1 没法再运做(2010年11月以来已经 结束产品生命期), 因此请使用8.2或高于8.4的版本. 字符串转义在PostgreSQL 9.x处于实验阶段(请参阅 issue #1974).

1.3. 安装软件包

1.3.1 您能够运行如下命令（以root或使用sudo）安装这些软件包.

备注

若是没有发现相应软件包，请使用您的包管理器的搜索选项来得到新的不一样版本之间的变化名称:

  • yum search <package name> ( Fedora/RHEL/CentOS )

  • apt-cache search <package name> ( Debian/Ubuntu )

  • zypper search <package name> ( openSuSE/SLES )

  • Fedora/RHEL/CentOS:

     #> yum install httpd gcc glibc glibc-common gd gd-devel #> yum install libjpeg libjpeg-devel libpng libpng-devel
    备注

    您可能须要使用到libjpeg-turbo和libjpeg-turbo-devel代替

    • MySQL:

       #> yum install mysql mysql-server \ libdbi libdbi-devel libdbi-drivers libdbi-dbd-mysql

    • PostgreSQL:

       #> yum install postgresql postgresql-server \ libdbi libdbi-devel libdbi-drivers libdbi-dbd-pgsql

  • Debian/Ubuntu:

     #> apt-get install apache2 build-essential libgd2-xpm-dev #> apt-get install libjpeg62 libjpeg62-dev libpng12 libpng12-dev
    备注

    Debian 6.0 / Ubuntu 10.10开始使用libpng-12-0包, dev-package名称不变.

    • MySQL:

       #> apt-get install mysql-server mysql-client libdbi1 libdbi-dev libdbd-mysql

    • PostgreSQL:

       #> apt-get install postgresql libdbi0 libdbi0-dev libdbd-pgsql

  • openSuSE:

    请使用YaST安装包 gd, gd-devel, libjpeg, libjpeg-devel, libpng, libpng-devel 和, optionally, net-snmp, net-snmp-devel 和 perl-Net-SNMP.

    使用zypper:

     #> zypper install gd gd-devel libjpeg libjpeg-devel libpng libpng-devel #> zypper install net-snmp net-snmp-devel perl-Net-SNMP
    备注

    开发包可能位于SDK DVDs.

    • MySQL:

      使用YaST安装RDBMS包,你要使用,例如. "mysql", "mysql-devel", "mysql-client" 和 libdbi 包s "libdbi", "libdbi-devel", "libdbi-drivers" 和 "libdbi-dbd-mysql", 或 alternatively zypper.

       #> zypper install mysql mysql-devel mysql-client \ libdbi libdbi-devel libdbi-drivers libdbi-dbd-mysql
      备注

      在OpenSuSE 11 (SLES 11)中 "mysql-devel" 已更改成 "libmysqlclient-devel".

    • PostgreSQL:

      使用YaST安装RDBMS包,你要使用, 例如. "postgresql", "postgresql-devel", "postgresql-server" 和libdbi包 "libdbi", "libdbi-devel" and "libdbi-drivers", 或 alternatively zypper.

       #> zypper install postgresql postgresql-devel postgresql-server #> zypper install libdbi libdbi-devel libdbi-drivers
    备注

    使用旧的OpenSuSE (SLES)版本,包括版本10目前可能尚未任何libdbi包. 因此你必须下载并编译源代码. 您可使用如mysql或pgsql代替所需的 . 请记住，Oracle驱动程序还没法工做和请使用ocilib代替libdbi.

    1.3.2 使用源码安装

    首先须要确认gd是否支持TTC,若是不支持请从新编译gd

    1. 编译GD（freetype+libjpeg+libpng+fontconfig）

       #> tar zxvf libiconv-1.14.1.tar.gz #> cd libiconv-1.14.1 #>./configure --prefix=/usr/local/libiconv  #> make  #> make install  #> /sbin/ldconfig
       #> tar xvzf gd-2.0.35.tar.gz #> cd gd-2.0.35 #> ./configure --prefix=/usr/local/gd2 --with-libiconv-prefix=/usr/local/libiconv #> make #> make install

    2. 安装libdbi. 你还能够指定额外的配置选项(例如 --prefix=/usr ... )

       #> cd libdbi-0.8.3 #> ./configure --disable-docs #> make #> make install

    3. 安装libdbi-drivers

       #> cd libdbi-drivers-0.8.3-1 #> ./configure --with-<rdbm> --disable-docs #> make #> make install
      4. 备注

      在64-bit版本上使用,你必须指定include-和lib-dir的路径:

       #> ./configure --with-<rdbm> \ --with-<rdbm>-incdir=/usr/include/<rdbm>/ \ --with-<rdbm>-libdir=/usr/lib64/ --disable-docs

1.4. 建立账户信息

 $> su -l

建立一个新的Icinga账户,并设置一个密码.

 #> /usr/sbin/useradd -m icinga  #> passwd icinga

在某些发行版本 你须要在这一个步骤中添加组:

 #> /usr/sbin/groupadd icinga
 #> /usr/sbin/usermod -a -G icinga www-data

(或 www, wwwrun, apache取决于发行版本)

1.5. 编译和安装Icinga(包括IDOUtils)

提取Icinga源代码tarball

 #> tar jxvf icinga-cn-1.11.5.tar.gz  #> cd icinga-cn-1.11.5 #> ./configure --prefix=/usr/local/icinga --with-icinga-user=icinga -with-icinga-group=icinga \  --with-command-user=icinga --with-command-group=icinga --with-mail=/usr/bin/mutt \ --with-gd-lib=/usr/local/gd2/lib --with-gd-inc=/usr/local/gd2/include --enable-nanosleep --enable-event-broker
备注

--enable-idoutils #数据库支持(默认)

--enable-embedded-perl #启用嵌入式Perl解释器

--enable-ssl #使本地的SSL支持

--with-mail #设置邮件通知使用的程序，默认为Mutt.

--enable-oraclel #启用oraclel支持.
a.若是没有安装Oracle库路径，您须要指定--with-oracle-lib=/path/to/instantclient
b.若是ocilib没有安装到默认路径(/usr/local), 您须要指定 --with-ocilib-lib=/path/to/ocilib/lib --with-ocilib-inc=/path/to/ocilib/include

此外，若是您要使用PostgreSQL将不宜使用参数--enable-pgsq， 由于它目前还不被支持.

备注

若是您想从Oracle做为MRDB, 您须要从新编译和安装IDOUtils!

Oracle使用IDOUtils1.5.0至少须要OCILIB3.9.2 - 不要安装3.9.0或3.9.1，由于它们仍然有bug。

 
 #> make distclean #> ./configure --prefix=/usr/local/icinga --with-icinga-user=icinga -with-icinga-group=icinga \  --with-command-user=icinga --with-command-group=icinga --enable-idoutils \ --with-httpd-conf=/etc/httpd/conf.d --enable-nanosleep --enable-event-broker

1.5.1. 编译和安装

 #> make all

安装二进制文件, 初始化脚本, 配置文件样本, 一些事件处理函数, 和设置外部命令目录的权限.

 #> make install #> make install-init #> make install-config #> make install-eventhandlers #> make install-commandmode #> make install-idoutils

或使用 

 #> make fullinstall #> make install-config
备注

从Icinga 1.5.0开始 make install-config 不包括在 make fullinstall中,以免意外覆盖您的配置文件.

只要使用 "make install" 就能够安装IDOUtil和适用的event broker模块.

ldd ido2db查看加载模块

libdbi.so.1 => /lib64/libdbi.so.1

libdbi.so.1默认的路径是/lib64或/lib

不要启动Icinga- 还有更多的事情须要作...

1.6. 定制配置

使用 "make install-config" 安装简单配置文件到 /usr/local/icinga/etc/ 

 #> cd /usr/local/icinga/etc/ #> vi idomod.cfg #> vi ido2db.cfg

若是启用 --enable-ssl, 您须要更改 idomod.cfg文件:

 use_ssl=1 output_type=tcpsocket output=127.0.0.1

若是您的数据库没有位于本机,您须要更改ido2db.cfg:

 use_ssl=1 socket_type=tcp
备注

若是在ido2db上启用SSL, 但对于不一样的idomod客户端 - 将会出现数据丢失现象 - 须要在全部的节点上作相同的SSL配置!!!

1.6.1. 启用idomod event broker 模块

提示

在正常状况下，下面的模块定义已经存在于modules/idoutils.cfg-sample

	define module{ module_name idomod module_type neb path /usr/local/icinga/lib/idomod.so args config_file=/usr/local/icinga/etc/idomod.cfg	}

因此没有必要编辑主配置文件启用broker_module条目!

 #> mv idoutils.cfg-sample idoutils.cfg

1.7.数据库建立和IDOUtils

备注

若是刚安装了一个新的数据库系统,在您建立新数据库以前,你必须启动数据库服务. 如 MySQL可能使用 /etc/init.d/mysqld start (或 /etc/init.d/mysql, 这取决于您的发行版本).

  • MySQL:

    建立数据库,用户, 受权:

     #> mysql -u root -p mysql> CREATE DATABASE icinga;
 GRANT USAGE ON icinga.* TO 'icinga'@'localhost' IDENTIFIED BY 'icinga' WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0;
 GRANT SELECT, INSERT, UPDATE, DELETE, DROP, CREATE VIEW, INDEX, EXECUTE ON icinga.* TO 'icinga'@'localhost'; FLUSH PRIVILEGES;
 quit
    备注

    从Icinga 1.8 开始icinga用户另外须要EXECUTE权限.

    向MySQL导入数据库架构:

     #> cd /path/to/icinga-src/module/idoutils/db/mysql #> mysql -u root -p icinga < mysql.sql

    升级MySQL数据库:

     #> cd /path/to/icinga-src/module/idoutils/db/mysql/upgrade #> mysql -u root -p icinga < mysql-upgrade-x.sql

    编辑DB配置文件自定义IDOUtils

     #> vi /usr/local/icinga/etc/ido2db.cfg
     db_servertype=mysql db_port=3306 db_user=icinga db_pass=icinga

  • PostgreSQL:

    建立数据库和用户:

     #> su - postgres $ psql postgres=# CREATE USER icinga; postgres=# ALTER USER icinga WITH PASSWORD 'icinga'; postgres=# CREATE DATABASE icinga; postgres=# \q $ createlang plpgsql icinga;

    从PostgreSQL 9.1开始 "createlang ..."已通过时.

    • Debian:

       #> vi /etc/postgresql/8.x/main/pg_hba.conf

    • Fedora/RHEL/CentOS:

       #> vi /var/lib/pgsql/data/pg_hba.conf

    编辑配置文件 例如. 这样 (本地用户必须信任)

     # database administrative login by UNIX sockets local all postgres ident # TYPE DATABASE USER CIDR-ADDRESS METHOD  #icinga local icinga icinga trust # "local" is for Unix domain socket connections only local all all trust # IPv4 local connections host all all 127.0.0.1/32 md5 # IPV6 local connections host all all ::1/128 md5

    从新载入和配置数据库架构.

     #> /etc/init.d/postgresql-8.x reload
     #> cd /path/to/icinga-src/module/idoutils/db/pgsql #> psql -U icinga -d icinga < pgsql.sql

    升级PostgreSQL数据库.

     #> cd /path/to/icinga-src/module/idoutils/db/pgsql/upgrade #> psql -U icinga -d icinga < pgsql-upgrade-x.sql

    编辑DB配置文件自定义IDOUtils

     #> vi /usr/local/icinga/etc/ido2db.cfg
     db_servertype=pgsql db_port=5432 db_user=icinga db_pass=icinga

  • Oracle:

    建立一个数据库结构描述和用户名/密码 (请参阅Oracle文档 http://www.oracle.com ，或咨询您的DBA). 使用sqlplus导入数据库结构描述 (或 您的首选方法). 复制 module/idoutils/db/oracle/* 到 $ORACLE_HOME 和编辑 icinga_defines.sql 以匹配表空间和用户认证信息.

     #> su - oracle $> sqlplus dbuser/dbpass SQL> @oracle.sql

    编辑DB配置文件自定义IDOUtils. 请记住Oracle忽略的db主机, 代替指向 db_name 到 //DBSERVER/DBNAME

     #> vi /usr/local/icinga/etc/ido2db.cfg
     db_servertype=oracle db_port=1521 db_user=icinga db_pass=icinga

1.8. 配置经典的Web界面

安装Icinga附带的经典web界面("CGIs")

 #> make cgis #> make install-cgis #> make install-html

安装经典web配置文件到Apache的conf.d目录下.

 #> make install-webconf

建立 icingaadmin 帐户,登陆到Icinga经典web界面. 记住您分配给这个账户的密码 -稍后你会须要它.

 #> htpasswd -c /usr/local/icinga/etc/htpasswd.users icingaadmin

若是你想改变用户密码，或添加另外一个用户，请使用如下命令:

 #> htpasswd /usr/local/icinga/etc/htpasswd.users <USERNAME>
备注

这取决于您的发行版本和Apache版本,您还可能使用到 htpasswd2 代替.

从新载入/从新启动Apache使新的设置生效.

  • Fedora/RHEL/CentOS:

     #> service httpd restart

  • Ubuntu/openSuSE:

     #> service apache2 restart

  • Debian:

     #> /etc/init.d/apache2 reload

1.9. 编译和安装Icing插件

#> tar -jxvf nagios-cn-plugins-1.5.tar.bz2 #> cd nagios-cn-plugins-1.5

编译并安装插件安装到目录/usr/local/icinga

 #> ./configure --prefix=/usr/local/icinga \ --with-package-name=icinga-plugins \ --with-icinga-user=icinga --with-icinga-group=icinga  #> make  #> make install
备注

#查看播件文件是否已安装在这个目录

ls /usr/local/icinga/libexec

1.9.1. 安装check_nrpe 插件

#> tar -zxvf nrpe-2.14.tar.gz  #> cd nrpe-2.14  #> ./configure --prefix=/usr/local/icinga --enable-ssl  #> make all #> make install-plugin

2.0. 调整SELinux的设置

RHEL和衍生版本(如Fedora和CentOS) 出厂时激活了SELinux(Security Enhanced Linux) 并运行在"enforcing"模式. 当你尝试调用Icinga-CGIs时,可能致使 "内部服务器错误" 消息.

检查SELinux是否运行在enforcing模式

#> getenforce

设置SELinux处于"permissive"模式

#> setenforce 0

若是要永久更改，你必须调整/etc/selinux/config中的该设置并从新启动系统.

若是不停用SELinux或将它设置成permissive模式,您能够在enforcing/targeted模式下,使用下面的命令来运行CGIs:

 #> chcon -R -t httpd_sys_script_exec_t /usr/local/icinga/sbin/ #> chcon -R -t httpd_sys_content_t /usr/local/icinga/share/ #> chcon -R -t httpd_sys_script_rw_t /usr/local/icinga/var/rw/

此外你也能够看看这个 http://www.linuxquestions.org/questions/blog/sag47-492023/selinux-and-icinga-34926/.

2.1. 启动IDOUtils和Icinga

在启动Icinga以前必须先启动和运行IDOUtils.

启动 IDOUtils:

  • Fedora/RHEL/CentOS/Ubuntu/openSuSE:

     #> service ido2db start

  • Debian:

     #> /etc/init.d/ido2db start

中止 IDOUtils:

  • Fedora/RHEL/CentOS/Ubuntu/openSuSE:

     #> service ido2db stop

  • Debian:

     #> /etc/init.d/ido2db stop

验证Icinga的配置文件样本.

 #> /usr/local/icinga/bin/icinga -v /usr/local/icinga/etc/icinga.cfg

一切正常将显示OK信息。如何有任何错误将会显示相应错误出现的未知. 启动 Icinga.

  • Fedora/RHEL/CentOS/Ubuntu/openSuSE:

     #> service icinga start

  • Debian:

     #> /etc/init.d/icinga start

2.1.1. 配置Icinga开机启动

添加Icinga到服务列表和在系统启动时自动启动 (在次以前确保您已经安装了init脚本).

  • Fedora/RHEL/CentOS/openSuSE:

     #> chkconfig --add icinga chkconfig icinga on

  • Debian/Ubuntu:

     #> update-rc.d icinga defaults

2.1.2. 登陆到经典的Web界面

经过下面的网址,您如今应该可以访问到Icinga的经典Web界面. 系统将提示您先前指定的用户名 (例如. icingaadmin ) 和密码. 

 http://localhost/icinga/

或 

 http://yourdomain.com/icinga/

2.2. 其它修改

请确保您的系统的防火墙规则配置为容许访问到Web服务器,若是您要远程访问的Icinga的经典Web界面.

 #> iptables -A INPUT -p tcp -m tcp --dport 80 -j ACCEPT

2.3. 客户端主机的配置

添加用户（普通帐户）icinga

 #> /usr/sbin/useradd icinga #> passwd icinga

2.3.1. 客户端编译和安装Icinga插件

 #> tar jxvf nagios-cn-plugins-1.5.tar.bz2 #> cd nagios-cn-plugins-1.5  #> ./configure -prefix=/usr/local/icinga \ --with-package-name=icinga-plugins \ --with-nagios-user=icinga --with-nagios-group=icinga  #> make #> make install
备注

#查看播件文件是否已安装在这个目录

ls /usr/local/icinga/libexec

2.3.2. 客户端编译和安装Nrpe

 #> tar xvzf icinga-nrpe-2.14.tar.gz #> cd icinga-nrpe-2.14  #> ./configure --prefix=/usr/local/icinga --with-nrpe-user=icinga --with-nrpe-group=icinga \  --with-icinga-user=icinga --with-icinga-group=icinga #> make all #> make install #> make install-plugin #> make install-daemon #> make install-daemon-config #> make install-init

2.3.3. 配置客户端Nrpe

添加nrpe服务器地址，容许服务器对其读取信息

 #> vi /usr/local/icinga/etc/nrpe.cfg #> allowed_hosts=127.0.0.1,IPADDRESS

增长command字段来添加要监控的服务

 command[check_users]=/usr/local/icinga/libexec/check_users -w 5 -c 10 command[check_load]=/usr/local/icinga/libexec/check_load -w 15,10,5 -c 30,25,20 command[check_hda1]=/usr/local/icinga/libexec/check_disk -w 20% -c 10% -p /dev/hda1  command[check_zombie_procs]=/usr/local/icinga/libexec/check_procs -w 5 -c 10 -s Z  command[check_total_procs]=/usr/local/icinga/libexec/check_procs -w 150 -c 200  command[check_ssh]=/usr/local/icinga/libexec/check_ssh -H localhost  command[check_swap]=/usr/local/icinga/libexec/check_swap -w 20% -c 10%  command[check_mysql]=/usr/local/icinga/libexec/check_mysql -H localhost -uroot -ptomcat2008  command[check_apache]=/usr/local/icinga/libexec/check_apachestatus -H localhost -p 80  command[check_ntp]=/usr/local/icinga/libexec/check_ntp -H localhost -w 0.5 -c 1  command[check_snmp]=/usr/local/icinga/libexec/check_snmp_service -H localhost -C monitor_energysh

启动Nrpe

  • Fedora/RHEL/CentOS:

     #> service icinga-nrpe start

  • Debian/Ubuntu/openSuSE:

     #> /etc/init.d/icinga-nrpe start  或 #> service icinga-nrpe start
备注

检测服务端check_nrpe与客户端运行的nrpedaemon之间的通讯

/usr/local/icinga/libexec/check_nrpe -H ClientIPADDRESS

© 2009-2013 Icinga Development Team, http://www.icinga.org

© 2009-2013 Icinga 中文化项目组, http://sourceforge.net/projects/icinga-cn

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程