Skip to end of metadata
Go to start of metadata



Dec 14, 2018 16:54

Monitoring Wildix PBX with Nagios

This instruction explains how to monitor operations of your PBX using Nagios system.

Supported WMS version: starting from 3.87

Created: December 2017

Permalink: https://confluence.wildix.com/x/C4AlAQ

 

Step 1. Setup of nagios-nrpe-server agent

Access your PBX via SSH as root

  1. Go to WMS and click on Terminal in the top secondary menu

    Note: Terminal is available only for admin users.

  2. Enter the following paramaters:

11 (means Shell, type it in Select an option line)
su
wildix (Password line)
!1 


Note: type !1 in case you have Physical or Virtual PBX.

Add your Nagios server IP and relay host (in case NAT is deployed) to allowed hosts

  1.  Use the following command:

    nano-tiny /rw2/etc/nagios/nrpe_local.cfg
  2. Add your Nagios server IP to allowed_hosts, separated by a comma:

    allowed_hosts=127.0.0.1,192.168.0.100

    where 192.168.0.100 is the IP address of Nagios server or (in case NAT is deployed) IP of a router which detects PBX

    Note: In case you PBX and Nagios server are located in different networks, use Nagios server Public IP.

  3. Enable nagios-nrpe-server autostart by using the following command:

    update-rc.d nagios-nrpe-server defaults
  4. Reboot your PBX using the following command:

    reboot
  5. Start nagios-nrpe-server:

    /etc/init.d/nagios-nrpe-server start

    Step 2. Setup of Nagios server

  1. Download the template file from https://files.wildix.com/images/pbx_template.cfg
  2. Rename pbx_template.cfg to <PBXname>.cfg, for instance, mypbx.cfg  and copy it to Nagios server configuration folder. Location of this folder depends on your Nagios distribution. For example, /opt/nagios/etc/objects/ or /usr/local/nagios/etc/servers/
  3. Edit Nagios configuration file with editor of your choice and add path to your cfg file in it:

    mcedit /usr/local/nagios/etc/nagios.cfg
  4. Add “cfg_file=” parameter with path:

    cfg_file=/path/to/mypbx.cfg
  5. Reload Nagios:

    service nagios reload

    Step 3. Access to PBX for monitoring operations

To access your PBX for monitoring operations:

  1. Go to Nagios interface -> Current Status -> Hosts
  2. Click on your PBX to open detailed information:

  3. Click on View Status Detail For This Host to monitor available services that are active on PBX: 

Not finding the help you need?
Join the Facebook group to ask a question!
facebook_tech-wizards