Toshiba POS Sensor Drivers for Linux 2.2 provides instrumentation that monitors temperatures, voltages and 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 Toshiba Point of Sale systems with Service Processor.
Both user mode and kernel module components must be installed for the instrumentation to run correctly.
1. Kernel Module
Download the appropriate kernel module rpm from the PLDP release site:
Customers should download a binary rpm for the exact kernel as indicated by the uname tool
% uname -r
For example on SLED/SLEPOS 11 SP3 if the kernel version is currently 3.0.x then the PAE flavor would be 3.0.x-pae. 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: toshiba-aipsvcp-suse11-kmp-pae-1.1_3.0.x_0.i586.rpm
% rpm -ivh toshiba-aipsvcp-suse11-kmp-pae-1.1_3.0.x_0.i586.rpm
The pae module installs to /lib/modules/3.0.x-pae/updates
2. User Mode Provider and Driver libraries
The toshiba-ipsd-sp-suse-2.2.1-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 toshiba-ipsd-sp-suse-2.2.1-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
POS Systems supported by version 2.2 are:
The instrumentation will only run on the Toshiba machines in the list above.
Most Toshiba 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: Toshiba Remote Management Agent
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:
The instrumentation may run on other operating systems but this is not supported by Toshiba at this time.
None at this time
Wed Jun 24 2009 - Initial version
Tue Aug 11 2010 - v2.2
Wed Oct 12 2011 - v2.2 for SP2
Mon Apr 23 2013 - Toshiba v2.2 for SP3