Project

General

Profile

Install Icinga2 and Icingaweb2 » History » Version 6

Jon Goldberg, 06/08/2017 08:20 PM

1 1 Jon Goldberg
{{last_updated_at}} by {{last_updated_by}}
2
# Install Icinga2 and Icingaweb2
3
4
{{>toc}}
5
6
### Installation (Master Node)
7
8 4 Jon Goldberg
Steps are adapted from [this guide](http://linoxide.com/ubuntu-how-to/install-icinga2-ubuntu-16-04/).
9 1 Jon Goldberg
10 4 Jon Goldberg
#### Install Icinga2
11
```
12 5 Jon Goldberg
# Install MySQL if you haven't yet
13
14 4 Jon Goldberg
# These lines for Ubuntu 16.04 only:
15
apt install software-properties-common
16
add-apt-repository -y ppa:formorer/icinga
17
apt update
18
apt-get install icinga2
19 5 Jon Goldberg
apt-get install icinga2-ido-mysql
20 4 Jon Goldberg
21
# These 3 lines for Debian 8 only:
22
echo 'deb http://ftp.debian.org/debian jessie-backports main' > /etc/apt/sources.list.d/jessie-backports.list
23
apt-get update
24 1 Jon Goldberg
apt-get -t jessie-backports install icinga2
25 5 Jon Goldberg
apt-get -t jessie-backports install icinga2-ido-mysql
26 4 Jon Goldberg
27
systemctl enable icinga2.service
28 1 Jon Goldberg
systemctl start icinga2.service
29 5 Jon Goldberg
apt install nagios-plugins
30
# nagios-plugins has Samba as a dependency, but you should remove it.
31
apt remove samba-common samba-libs
32
icinga2 feature enable ido-mysql
33
systemctl restart icinga2.service
34
35 4 Jon Goldberg
```
36 1 Jon Goldberg
37
#### Install Icingaweb2
38 4 Jon Goldberg
```
39 5 Jon Goldberg
40
# If Ubuntu 16.04, you need to work around this bug: https://bugs.launchpad.net/ubuntu/+source/icingaweb2/+bug/1574250
41 1 Jon Goldberg
# FIRST, uncomment the second line in /etc/php/7.0/mods-available/zend-framework.ini
42
phpenmod zend-framework
43
systemctl restart apache2.service
44 5 Jon Goldberg
# END Ubuntu 16.04 workaround
45
46
apt install icingaweb2
47 4 Jon Goldberg
```
48 6 Jon Goldberg
* Go to http://<your IP>/icingaweb2/setup.
49
* Finish from here: https://linoxide.com/ubuntu-how-to/install-icinga2-ubuntu-16-04, starting with "Configuring Icinga Web2 plugin"
50 1 Jon Goldberg
51
### Configuration
52
53
-   Run `icinga2 node wizard. `Select "N" to create a master node.
54
-   Enable the command module to allow issuing commands from Icingaweb2:
55
    `icinga2 feature enable command`; service icinga2 restart
56
-   Add an API user for remote checks.  For instance, a user that can
57
    receive backupninja checks:
58
59
    <div class="code panel pdl" style="border-width: 1px;">
60
61
    <div class="codeContent panelContent pdl">
62
63
    ``` 
64
    object ApiUser "backupninja" {
65
      password = "<redacted>"
66
      permissions = [
67
        {
68
          permission = "actions/process-check-result"
69
          filter = {{ match("backupninja", service.display_name) }}
70
        }
71
      ]
72
    }
73
    ```
74
75
### Install additional checks
76
77
#### Install Plugins
78
79
Place the following two scripts in your plugins directory
80
(`/usr/lib/nagios/plugins`) and ensure they're executable:
81
82
-   **check\_drupal** - installs with the Drupal "nagios" plugin, also
83
    available
84 2 Jon Goldberg
    [here](http://cgit.drupalcode.org/nagios/plain/nagios-plugin/check_drupal?id=7da732e2d4943ec5368243f4cd2e33eb02769f23).
85 1 Jon Goldberg
-   **check\_civicrm** - There are two scripts - one for Civi 4.6 and
86
    below, another for 4.7 and up.  4.7 version is available
87
    [here](https://github.com/PalanteJon/check_civicrm){.external-link},
88
    4.6 version is
89 2 Jon Goldberg
    <span>[here](https://raw.githubusercontent.com/aghstrategies/com.aghstrategies.civimonitor/master/check_civicrm.php).</span>
90 1 Jon Goldberg
-   <span>**check\_domain** - This does a WHOIS lookup to ensure domain
91
    names aren't about to expire.  Install from
92 2 Jon Goldberg
    [here](https://raw.githubusercontent.com/glensc/monitoring-plugin-check_domain/master/check_domain.sh).</span>
93 1 Jon Goldberg
-   <span><span>**check\_rbl** - Check spam blacklists.  File is
94 2 Jon Goldberg
    [here](https://raw.githubusercontent.com/matteocorti/check_rbl/master/check_rbl), also install dependencies:
95
    `apt install libreadonly-xs-perl libnagios-plugin-perl libdata-validate-ip-perl libdata-validate-domain-perl libnet-dns-perl`
96 1 Jon Goldberg
97 2 Jon Goldberg
#### Define CheckCommand and Service objects for the new plugins
98 1 Jon Goldberg
99 2 Jon Goldberg
Copy the CheckCommand and Service files from
100 1 Jon Goldberg
`icinga.jmaconsulting.biz:/etc/icinga2/zones.d/global-templates/CheckCommands`
101 2 Jon Goldberg
and `icinga.jmaconsulting.biz:/etc/icinga2/conf.d/services`. See [[Add New Checks to Icinga2]] for details.
102 1 Jon Goldberg
103
104 2 Jon Goldberg
### Set up vim syntax highlighting on the Icinga2 server
105
```
106
mkdir -p ~/.vim/{syntax,ftdetect}
107
cd ~/.vim/syntax
108
wget https://raw.githubusercontent.com/Icinga/icinga2/master/tools/syntax/vim/syntax/icinga2.vim
109
cd ~/.vim/ftdetect
110
wget https://raw.githubusercontent.com/Icinga/icinga2/master/tools/syntax/vim/ftdetect/icinga2.vim
111
```