README.txt

-------------------------------------------------------------------------------
1. Overview

"check_lenovo_xcc.py" provides the capabilities to monitor Lenovo ThinkSystem 
through SNMPv3 protocol. This Lenovo Nagios SNMP plugin can collect hardware 
health status of the following components: 
•    System health
•    Power Supply
•    Temperature
•    Fans (Cooling Devices)
•    Voltage 
•    CPU
•    Storage
•    Memory


2. System Requirements

2.1 Protocol
SNMPv3 protocol is the only supported protocol

2.2 Prerequisite
SNMPv3 agent and account has been enable on the monitored system.

2.3 Hardware Requirements
Lenovo ThinkSystem

2.4 Software Requirements
•    python2.7 or python3.5
•    net-snmp-utils (e.g, "yum install net-snmp-utils" on RHEL)


3. Usage

3.1 File organization
|-- check_lenovo_xcc.py
|  
|-- sample_lenovo_snmp_command.cfg
|
|-- README.txt
|
|-- sample_lenovo_group.cfg

3.2 How to use
1) Copy the check_lenovo_xcc.py to the installation path of 
   nagios. (e.g, /usr/local/nagios/libexec/) Make sure it has executable 
   permission with command "chmod +x check_lenovo_xcc.py"
2) Enter /usr/local/nagios/libexec, run "./check_lenovo_xcc.py -h" for usage
    (e.g, check_lenovo_xcc.py -H 192.168.0.1 --snmp_version 3 --snmp_username
    USERID --snmp_aprotocol=SHA --snmp_apassword PASSW0RD --snmp_security_level
    authPriv --snmp_pprotocol DES --snmp_ppassword passw0rd --mode cpu)
3) Create or modify a command definition file to add Lenovo SNMP command in 
    /usr/local/nagios/etc/objects/ (e.g, sample_lenovo_snmp_command.cfg)
4) Create or modify a service configuration file to add the monitored Lenovo 
    ThinkSystem in /usr/local/nagios/etc/objects/ (e.g, sample_group.cfg, 
    You can refer the example to modify your configuration file)
5) Add the new configuration file to /usr/local/nagios/etc/nagios.cfg
    (e.g, cfg_file=/usr/local/nagios/etc/objects/sample_lenovo_snmp_command.cfg
    cfg_file=/usr/local/nagios/etc/objects/sample_lenovo_group.cfg)
6) Restart nagios service: service nagios restart