IBM POS Sensor Drivers for Linux

Version 3.0

This package is the IBM POS Sensor Drivers for Linux 3.0 instrumentation. It monitors temperatures, voltages, fan speeds on supported POS Systems mentioned below.

Supported Systems

POS Systems supported by version 3.0 are:

The instrumentation will only run on the IBM machines in the list above.

OS Support

The instrumentation may run on other operating systems but this is not supported by IBM at this time.

Package Install

STEP 1

The ibm-ipsd-suse-3.0.0-1.0.i586.rpm contains the user mode libraries and support files that form the main part of the instrumentation. This rpm requires that the sblim-sfcb cimserver and the sysfsutils packages are already installed.

% rpm -ivh ibm-ipsd-suse-3.0.0-1.0.i586.rpm

This will install the libraries, update the SFCB repository with class definitions for RSS_NumericSensor and RSS_SystemEventLog CIM classes. It will also install a boot script into /etc/init.d called ibm-hwmon which is used to start the appropriate lm_sensors kernel module(s) required for your specific IBM POS System. This script needs to be enabled (by root) as shown below:

% insserv ibm-hwmon

The correct lm_sensors kernel modules need to be loaded for the instrumentation to function

In addition you should install kernel-<kernel-flavor>-extra-<kernel-version>.i586.rpm package if is not found in your current SLEx image.This will make sure that the lm_sensors kernel modules for hardware monitoring are available. The drivers are installed to /lib/modules/<kernel-version-flavor>/kernel/drivers/hwmon.

Remote Management Agent Support - RMA 2.6

Most IBM customers will want to use RMA to allow interconnection of the instrumentation CIM classes to remote systems management software such as IBM Director. After install of the instrumentation the RMA General Agent daemon on the POS machine should be stopped and restarted in order to pick up cimserver repository and other system changes.

More about RMA can be found at: IBM Remote Management Agent V2 R6

Support Logging

The drivers log abnormal conditions to /var/log/ipsd/ipsd.log. For normal production usage there is no need to change this behaviour. In fact it is not recommended. If any problems surface however additional information may be logged for purposes of support.

To enable detailed logging edit the /etc/ipsd/log.conf file. Change the Level property to 4 to enable very detailed trace logging. You may also wish to change the MaxLength property if you wish to log for any length of time as the logfile will fill quickly. Recycle the SFCB cimserver so that the instrumentation libraries pick up the logger configuration changes.

Log Levels:


Known Issues

1. For customers using RMA 2.6 you may need additional configuration to include the Sensor Drivers CIM classes in the filter-list that the RMA General Agent accepts.

Edit /opt/ibm/StoreIntegrator/user/rma/cim/CIMconfig.xml and make sure these lines are included in the filter-list:

<CIMFilterElement lifeCycleEvents="true">RSS_NumericSensor</CimFilterElement>
<CIMFillscleEvents="true">RSS_SystemEventLog</CimFilterElement>

This will allow these CIM classes to be 'seen' by RMA and thus available in the IBM Director JMX Browser.

Changelist

Mon Feb 06 2012 - Initial version

Wed Feb 22 2012 - Added RSS_SystemEventLog,Change location of Supported System and OS support