Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
nobody43 authored Mar 2, 2023
1 parent a458a2c commit 2f7a74e
Showing 1 changed file with 28 additions and 27 deletions.
55 changes: 28 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,24 +10,21 @@ CPU and disk temperature monitoring scripts for zabbix. Also support voltage and
- Does not spin idle drives
- RAID passthrough (manual)

![Temperature graph](https://github.com/nobodysu/mini-IPMI/blob/master/screenshots/mini-IPMI-graph.png?raw=true)
![Temperature graph](https://github.com/nobody43/mini-IPMI/blob/master/screenshots/mini-IPMI-graph.png?raw=true)

[More screenshots.](https://github.com/nobodysu/zabbix-mini-IPMI/tree/master/screenshots)

### STANDBY drives
UPD: not relevant anymore. Just use custom 0.8.0.5+.
[More screenshots.](https://github.com/nobody43/zabbix-mini-IPMI/tree/master/screenshots)

### Choosing OHMR version
NEW: [Update](https://github.com/openhardwaremonitor/openhardwaremonitor/pull/1115#issuecomment-616230088) your OHMR version!
#### [0.3.2.0](https://github.com/openhardwaremonitor/openhardwaremonitor/issues/230#issue-102662845)
Version for Windows XP.
#### [0.8.0.5](https://github.com/openhardwaremonitor/openhardwaremonitor/pull/1115#issuecomment-462141642)
Only custom param-capable versions are supported on Windows 7+:
#### [0.9.6.0](https://github.com/openhardwaremonitor/openhardwaremonitor/pull/1115#issuecomment-1189362017)
#### [0.9.2.0](https://github.com/openhardwaremonitor/openhardwaremonitor/pull/1115#issuecomment-616230088)
Only custom param-capable versions are supported on Windows 7+.
#### [0.8.0.5](https://github.com/openhardwaremonitor/openhardwaremonitor/pull/1115#issuecomment-462141642)
Version for Windows XP:
#### [0.3.2.0](https://github.com/openhardwaremonitor/openhardwaremonitor/issues/230#issue-102662845)

## Installation
As prerequisites you need `python3`, `lm-sensors`, `smartmontools`, `sudo` and `zabbix-sender` packages. For testing `zabbix-get` is also required.<br />
Take a look at scripts first lines and provide paths if needed. If you have custom RAID configuration, also provide that by hand. Import `Template_mini-IPMI_v2.xml` in zabbix web interface.
Take a look at scripts first lines and provide paths if needed. If you have custom RAID configuration, also provide that manually. Import `Template_mini-IPMI_v2.xml` in zabbix web interface.
### Debian / Ubuntu
```bash
client# apt install python3 sudo zabbix-agent zabbix-sender smartmontools lm-sensors
Expand All @@ -39,36 +36,37 @@ client# yum install python3 sudo zabbix-agent zabbix-sender smartmontools lm_sen
server# yum install zabbix-get
```
### First step
> **Note**: Your include directory may be either `zabbix_agentd.d` or `zabbix_agentd.conf.d` dependent on the distribution.
#### Linux
```bash
client# mv mini_ipmi_smartctl.py Linux/mini_ipmi_lmsensors.py sender_wrapper.py /etc/zabbix/scripts/
client# mv Linux/sudoers.d/zabbix /etc/sudoers.d/ # place sudoers include here for mini_ipmi_smartctl.py sudo access
client# mv Linux/sudoers.d/zabbix /etc/sudoers.d/ # place sudoers include for smartctl sudo access
client# mv Linux/zabbix_agentd.d/userparameter_mini-ipmi2.conf /etc/zabbix/zabbix_agentd.d/
```

#### FreeBSD
```bash
client# mv mini_ipmi_smartctl.py BSD/mini_ipmi_bsdcpu.py sender_wrapper.py /etc/zabbix/scripts/
client# mv BSD/sudoers.d/zabbix /usr/local/etc/sudoers.d/
client# mv BSD/zabbix_agentd.conf.d/userparameter_mini-ipmi2.conf /usr/local/etc/zabbix/zabbix_agentd.d/
client# mv BSD/zabbix_agentd.d/userparameter_mini-ipmi2.conf /usr/local/etc/zabbix/zabbix_agentd.d/
```
Then, for Intel processor you need to add `coretemp_load="YES"` to `/boot/loader.conf`. For AMD it will be `amdtemp_load="YES"`. Reboot or manual `kldload` is required to take effect.

#### Windows
```cmd
client> move mini_ipmi_smartctl.py C:\zabbix-agent\scripts\
client> move mini_ipmi_ohmr.py C:\zabbix-agent\scripts\
client> move sender_wrapper.py C:\zabbix-agent\scripts\
client> move userparameter_mini-ipmi2.conf C:\zabbix-agent\zabbix_agentd.conf.d\
client> move mini_ipmi_smartctl.py "C:\Program Files\Zabbix Agent\scripts\"
client> move mini_ipmi_ohmr.py "C:\Program Files\Zabbix Agent\scripts\"
client> move sender_wrapper.py "C:\Program Files\Zabbix Agent\scripts\"
client> move userparameter_mini-ipmi2.conf "C:\Program Files\Zabbix Agent\zabbix_agentd.d\"
```
Install [python3](https://www.python.org/downloads/windows/), [adding it to](https://github.com/nobodysu/zabbix-mini-IPMI/blob/master/screenshots/python-installation1.png) `PATH` during installation for [all users](https://github.com/nobodysu/zabbix-mini-IPMI/blob/master/screenshots/python-installation2.png). Install [smartmontools](https://www.smartmontools.org/wiki/Download#InstalltheWindowspackage) and add its bin folder to `PATH` in environment variables. `OpenHardwareMonitorReport` `0.8.0.5+` requires `.NET Framework 4`. `0.3.2.0` requires `.NET Framework 3`.
Install [python3](https://www.python.org/downloads/windows/), [adding it to](https://github.com/nobody43/zabbix-mini-IPMI/blob/master/screenshots/python-installation1.png) `PATH` during installation for [all users](https://github.com/nobody43/zabbix-mini-IPMI/blob/master/screenshots/python-installation2.png). Install [smartmontools](https://www.smartmontools.org/wiki/Download#InstalltheWindowspackage) and add its bin folder to `PATH` in environment variables. `OpenHardwareMonitorReport` `0.8.0.5+` requires `.NET Framework 4`. `0.3.2.0` requires `.NET Framework 3`.

### Second step
Then you need to include your zabbix conf folder in `zabbix_agentd.conf`, like this:
Dependent on the distribution, you may need to include your zabbix conf folder in `zabbix_agentd.conf`, like this:
```conf
Include=/usr/local/etc/zabbix/zabbix_agentd.conf.d/
Include=/usr/local/etc/zabbix/zabbix_agentd.d/
```
Also its recomended to add at least `Timeout=10` to config file to allow drives spun up and OHMR execution.
Its recomended to add at least `Timeout=10` to server and client config files to allow drives spun up and OHMR execution.

Thats all for Windows. For others run the following to finish configuration:
```bash
Expand Down Expand Up @@ -101,7 +99,7 @@ server$ zabbix_get -s 192.0.2.1 -k mini.disktemp.discovery[getverb,"Example host
or locally:
```mixed
client$ /etc/zabbix/scripts/mini_ipmi_lmsensors.py getverb "Example host"
client_admin!_console> python "C:\zabbix-agent\scripts\mini_ipmi_ohmr.py" getverb "Example host"
client_admin!_console> python "C:\Program Files\Zabbix Agent\scripts\mini_ipmi_ohmr.py" getverb "Example host"
```
Verbose mode. Does not detaches or prints LLD. Lists all items sent to zabbix-sender, also it is possible to see sender output in this mode.
<br /><br />
Expand All @@ -116,15 +114,18 @@ These scripts were tested to work with following configurations:
- FreeBSD 10.3 / Zabbix 3.0 / Python 3.6
- Windows XP / Zabbix 3.0 / Python 3.4

## Updating
Overwrite scripts and UserParameters. If UserParameters were changed - agent restart is required. If template had changed from previous version - update it in zabbix web interface [marking](https://github.com/nobody43/zabbix-smartmontools/blob/master/screenshots/template-updating.png) all `Delete missing` checkboxes.

> **Note**: low values in php settings `/etc/httpd/conf.d/zabbix.conf` may result in request failure. Especially `php_value memory_limit`.
## Known issues
- Zabbix web panel displays an error on json discovery, but everything works fine ([#18](https://github.com/nobodysu/zabbix-mini-IPMI/issues/18))
- Windows version does not detaches, and data will only be gathered on second pass (probably permanent workaround)
- Zabbix web panel displays an error on json discovery, but everything works fine ([#18](https://github.com/nobody43/zabbix-mini-IPMI/issues/18))
- Windows version does not detaches, and data will only be gathered on second pass

## Links
- https://www.smartmontools.org
- https://wiki.archlinux.org/index.php/Lm_sensors
- https://github.com/openhardwaremonitor/openhardwaremonitor
- https://unlicense.org
- [Disk SMART monitoring solution](https://github.com/nobodysu/zabbix-smartmontools)
- [Last Zabbix 2.4 version](https://github.com/nobodysu/zabbix-mini-IPMI/tree/last_zabbix24_unsupported)
- [Older unsupported mini-IPMI version with simpler approach](https://github.com/nobodysu/zabbix-mini-IPMI/tree/old_v1_unsupported)
- [Disk SMART monitoring solution](https://github.com/nobody43/zabbix-smartmontools)

0 comments on commit 2f7a74e

Please sign in to comment.