Red Hat Bugzilla – Bug 463282
[LTC 6.0 FEAT] 201167:Linux to add Call Home data
Last modified: 2010-11-15 09:44:17 EST
Emily J. Ratliff <firstname.lastname@example.org> - 2008-09-16 18:24 EDT
1. Feature Overview:
Feature Id: 
a. Name of Feature: Linux to add Call Home data
b. Feature Description
The sclp_cpi sysfs interface allows the association of a set of descriptive data called 'Control
Program Identification' (CPI) with an operating system instance (currently LPAR only). This
information is not persistent and has to be set once per IPL. CPI data will be visible at the
HMC/SE. CPI information is also referred to as 'Call Home data' in some contexts. CPI information
could previously be set by loading the sclp_cpi kernel module. This item implements a new CPI
interface in sysfs which complements the existing one. The new interface was included in Linux
kernel 2.6.25. These sysfs-attributes can be used to specify the CPI information locally:
/sys/firmware/cpi/system_name String: arbitrary, user-specified system name (e.g. LPAR12)
/sys/firmware/cpi/sysplex_name String: arbitrary, user-specified sysplex name (e.g. SYSPLEX1)
/sys/firmware/cpi/system_type String: operating system type identifier - must be 'LINUX '
/sys/firmware/cpi/system_level Hex: operating system version information, should be
0x0000000000aabbcc, where aa=kernel version, bb=kernel patch level, cc=kernel sublevel. Example:
Linux kernel 2.6.26 -> 0x000000000002061a
Once all attributes are filled, write an arbitrary string to this attribute to finalize the data
(i.e. to send it to the SE):
/sys/firmware/cpi/system_set Distributor installation/setup tools need to be changed to provide
users with the ability: 'to specify whether they want to set this data 'to enter the actual data
values (only 'system_name' and 'sysplex_name', since 'system_type' and 'system_level' should be set
automaticly by the system)
Using a distributor specific mechanism (e.g. init script), this information needs to be passed to
the sclp_cpi sysfs interface during IPL, depending on the configuration.
2. Feature Details:
Arch Specificity: Purely Arch Specific Code
Affects Core Kernel: Yes
Delivery Mechanism: Request Red Hat development assistance
Request Type: Driver - Feature from IBM
d. Upstream Acceptance: No Code Required
Sponsor Priority 1
f. Severity: High
IBM Confidential: no
Code Contribution: no
g. Component Version Target: n/a
3. Business Case
RAS Improvement by decreasing mean time to resolve problems in case of System Failure.
4. Primary contact at Red Hat:
5. Primary contacts at Partner:
Project Management Contact:
Hans-Georg Markgraf, email@example.com, Boeblingen 49-7031-16-3978
Gonzalo Muelas Serrano, firstname.lastname@example.org
Thomas Schwarz, email@example.com
Hello Red Hat,
update description for installer/tools:
The sclp_cpi sysfs interface allows the association of a set of descriptive data called "Control Program Identification" (CPI) with an operating system instance (currently LPAR only). This information is not persistent and has to be set once per IPL. CPI data will be visible at the HMC/SE. CPI information is also referred to as "Call Home data" in some contexts.
The following support is required:
- During each boot, the distribution uses the CPI sysfs interface to automatically set and send CPI information to the SE.
- The user can turn the automatic setting of CPI information at boot time on and off. With no change by the user, this setting is on.
- The user can specify custom values for the "system_name" and "sysplex_name" attributes of the CPI information set at boot time. With no change by the user, these attributes are set to empty strings.
- The "system_type" attribute set during boot must be "LINUX".
- The "system_level" attribute set during boot must be the version of the currently running Linux kernel.
More details under:
???Control program identification??? in latest version of Device Drivers, Features, and Commands at: http://www.ibm.com/developerworks/linux/linux390/development_documentation.html
Thank you for your support,
Gonzalo Muelas Serrano.
This feature is the required installer tools part for the kernel feature:
51753 - [LTC 6.0 FEAT] Linux to add Call Home data - Kernel Interface 
51753 - RHBZ 486222 [LTC 6.0 FEAT] Linux to add Call Home data - Kernel Interface 
It can resolved in a multi-distro manner with one config file in /etc/sysconfig and one initscript. I will talk to the s390utils developers about this idea.
Created attachment 362044 [details]
Created attachment 362046 [details]
Fixed in 's390utils-1.8.2-3.el6'. 's390utils-1.8.2-3.el6' included in compose 'RHEL6.0-20091111.0'.
Moving to ON_QA.
Can you please confirm that the initscript+config file option resolution provided in comment #8 and comment #9 satisfy this request?
------- Comment From firstname.lastname@example.org 2010-01-11 05:29 EDT-------
Yes, we confirm it. Pending test to close it...
------- Comment From email@example.com 2010-07-23 05:38 EDT-------
This feature is verified on R6 snapshots
Set feature to "verified" Thx
Red Hat Enterprise Linux 6.0 is now available and should resolve
the problem described in this bug report. This report is therefore being closed
with a resolution of CURRENTRELEASE. You may reopen this bug report if the
solution does not work for you.