# IPMI Agent plugin

# Introduction

  
These plugins provide modules for each of the sensors from IPMI. They set  
Warning and Critical Status based on the thresholds provided by IPMI. The  
Module Group can also be specified.

For Unix systems the freeipmi package must be installed. The IPMI information  
can be retrieved from the local system or using the network interface to the  
IPMI device.

For Windows a version of freeipmi built with cygwin is provided. The IPMI  
information is retrieved using the network interface to the IPMI device.

# Compatibility matrix

<table border="1" id="bkmrk-sistemas-donde-se-ha" style="border-collapse: collapse; width: 100%; height: 84px;"><tbody><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Systems where it has been tested**</td><td style="width: 50%; height: 28px;">CentOS 7

</td></tr><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Systems where it should work**</td><td style="width: 50%; height: 28px;">Any linux system or windows

</td></tr></tbody></table>

# Prerequisites

For Unix systems the freeipmi package must be installed.

# Configuration

For Unix systems the freeipmi package must be installed.

**CentOS7**

Install wget on CentOS7 with the following command

```
sudo yum install wget -y

```

Get the freeipmi-1.5.7-3.el7.x86\_64 file using wget

```
wget http://mirror.centos.org/centos/7/os/x86_64/Packages/freeipmi-1.5.7-3.el7.x86_64.rpm
```

Now Install the freeipmi-1.5.7-3.el7.x86\_64

```
yum install freeipmi-1.5.7-3.el7.x86_64.rpm -y
```

# General parameters

**Unix**

For IPMI local access use:

```
ipmi_sensors.pl -l
```

For IPMI network access use:

```
ipmi_sensors.pl -h <hostname> -u <username> -p <password>
```

If you wish the modules to be in a module group add "-g &lt;group&gt;;". For example:

```
ipmi_sensors.pl -l -g "IPMI Sensors"
```

**Windows**

```
ipmi_sensors.pl /h:<hostname> /u:<username> /p:<password>
```

# Configuration in pandora

**Unix**

To install, copy ipmi\_sensors to the plugins directory which is usually

```
/usr/share/pandora_agent/plugins
```

This plugin requires freeipmi to be installed  
and available on the agent's path.

Then add it to the configuration file, usually

```
/etc/pandora/pandora_agent.conf
```

For IPMI local access use:

```
module_plugin ipmi_sensors.pl -l
```

For IPMI network access use:

```
module_plugin ipmi_sensors -h <hostname> -u <username> -p <password>
```

Replace hostname,username, andpassword, with appropriate values.

If you wish the modules to be in a module group add "-g group". For example:

```
module_plugin ipmi_sensors.pl -l -g "IPMI Sensors"
```

Note: The module group must be created in PandoraFMS in advance.

**Windows**

The following installation instructions refer to the pandora\_agent\_install directory.  
On 32-bit windows this is usually C:\\Program Files\\pandora\_agent, on 64-bit Windows  
it is usually C:\\Program Files (x86)\\pandora\_agent.

  
To install, copy ipmi\_sensors to the util subdirectory of the pandora\_agent\_install  
directory. Copy the freeipmi directory to the pandora\_agent\_install directory.

Then add it to the configuration file, usually pandora\_agent.conf in the pandora\_agent\_install  
directory.

```
module_plugin ipmi_sensors.pl /h:<hostname> /u:<username> /p:<password>
```

Replace hostname, username and password with appropriate values.

If you wish the modules to be in a module group add "/g group". For example:

```
module_plugin ipmi_sensors.pl /h:myipmihost /u:myusername /p:mypassword /g:"IPMI Sensors"
```

Note: The module group must be created in PandoraFMS in advance.