IBM POS Sensor Drivers for Linux

Version 2.2 for Service Processor Systems

IBM POS Sensor Drivers for Linux 2.2 provides instrumentation that monitors temperatures, voltages, fan speeds. It also monitors other critical events which are indicated with a set of Lightpath LEDs. This data is made available by Common Information Model (CIM) classes: RSS_SpNumericSensor, RSS_LedAlarmDevice and may be accessed in IBM Director or other systems management tools.

There are two packages that make up the instrumentation:

Together - user mode libraries and kernel module aipsvcp.ko - form the instrumentation for IBM RSS Point of Sale systems with Service Processor.

Both user mode and kernel module components must be installed for the instrumentation to run correctly.


Installation steps:

1. Kernel Module

Download the appropriate kernel module rpm from the PLDP release site:

http://forgeftp.novell.com/driver-process/staging/pub/update/ibm/sle11/slepos/i586/

Customers using SLED 11 or SLEPOS 11 should download a binary rpm for the exact kernel as indicated by the uname tool

% uname -r

For SLED/SLEPOS 11 the kernel version is currently 2.6.27.19-5 and the particular flavor may (typically) be 2.6.27.19-5-pae on many IBM RSS POS machines. You should however check this as the driver installed from a binary rpm will only run on the correct target kernel version and flavor.

For the pae kernel flavor the rpm would be named: ibm-aipsvcp-suse11-kmp-pae-1.0_2.6.27.19_0.i586.rpm

% rpm -ivh ibm-aipsvcp-suse11-kmp-pae-1.0_2.6.27.19_0.i586.rpm

The pae module installs to /lib/modules/2.6.27.19-5-pae/updates/IBM/ipsd-sp/

2. User Mode Provider and Driver libraries

The ibm-ipsd-sp-suse-2.2.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 package is already installed.

% rpm -ivh ibm-ipsd-sp-suse-2.2.0-1.0.i586.rpm

This will install the libraries, update the SFCB repository with class definitions for RSS_SpNumericSensor, RSS_SpNumericSensorAlert and RSS_LedAlarmDevice. It will also install a boot script into /etc/init.d called aipsvcp which is used to start the aipsvcp.ko kernel module mentioned above. This script needs to be enabled (by root) as shown below:

% insserv aipsvcp

The aipsvcp.ko module needs to be loaded for the instrumentation to function

Finally restart the RMA General Agent daemon


Supported Systems

POS Systems supported by version 2.2 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 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-sp/ipsd-sp.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-sp/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

None at this time


Changelist

Wed Jun 24 - Initial version

Tue Aug 11 - v2.1

Tue Dec 01 - v2.2