IBM POS Sensor Drivers for Linux

Version 1.0

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


Package Install

The ibm-ipsd-suse-1.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-1.0.0-1.0.i586.rpm

This will install the libraries, update the SFCB repository with class definitions for RSS_NumericSensor CIM class. 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

Note:

For SLEPOS 11 images an extra step is necessary:-

You should install kernel-pae-extra-2.6.27.19-5.i586.rpm package or the kernel-default-extra2.6.27.19-5.i586.rpm package (depending upon your SLEPOS kernel flavor) This will make the lm_sensors kernel modules for hardware monitoring available. These drivers are excluded on most SLEPOS images. The drivers install to /lib/modules/<kernel-version-flavor>/kernel/drivers/hwmon.


Supported Systems

POS Systems supported by version 1.0 are:

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


Remote Management Agent Support - RMA 2.5

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 R5


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:


OS Support

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


Known Issues

1. For customers using RMA 2.5 you need to do 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>
<CIMFilterElement lifeCycleEvents="true">RSS_SpNumericSensor</CimFilterElement>
<CIMFilterElement lifeCycleEvents="true">RSS_LedAlarmDevice</CimFilterElement>

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


Changelist

Thu Aug 13 - Initial version

Thu Sep 03 - SLEPOS lm_sensors hwmon notes

Mon Sep 07 - RMA 2.5 CIMconfig known issues