Shelf Manager IPMI Extension Commands and Sensors
|
The Shelf Manager implements several OEM-defined IPMI commands and sensors for the convenience of the System Manager.
The first set of mechanisms provides an alternative for Telco alarm control to the PEF-based mechanism. The mechanisms consist of one sensor and two OEM extension commands. The commands can be issued by the System Manager over the RMCP interface and implement the following functionality:
- Set/clear specified Telco alarms (both the set and clear operations are performed atomically within the same command)
- Get the number of the Telco alarm sensor. This sensor can then be used to read the current state of Telco alarms in an IPMI-compliant way.
Some ShMM carriers support general purpose digital output pins that are intended to be accessible by the System Manager and other external applications. There is no explicit support for such entities in the IPMI specification, so a second set of extension commands is provided to allow the System Manager to work with such digital outputs.
The commands can be issued by the System Manager over the RMCP interface and provide the following functionality:
- query the properties and number of available digital outputs
- get the current state of digital outputs
- set/clear digital outputs
Currently, these commands are implemented for selected carriers on some FRUs of the Shelf Manager (IPMB address 20h). However, in future they may be implemented on other IPM controllers/FRUs.
A final set of extensions provide additional functionality, currently including the following:
- Reading the contents of a Shelf FRU Information multirecord
- Notifying the Shelf Manager about an extracted FRU
- Initiating a Shelf Manager switchover
- Subscribing for event notifications
The commands in this set are implemented as OEM Group commands (Network Function Code 2Eh) and require that the first three bytes of the request and response be the Pigeon Point Systems IANA: (0Ah, 40h, 00h).
IPMI Extension Commands
The Pigeon Point Systems (PSS) extension IPMI commands are listed in TABLE B-1 and described in the following sections
TABLE B-1 Shell Manager IPMI Extension Commands
|
Command
|
NetFn
|
Opcode
|
|
Notify Shelf Manager About an Extracted FRU
|
2Eh
|
2h
|
|
Initiate Shelf Manager Switchover
|
2Eh
|
3h
|
|
Reset IPMC Configuration Variables
|
0x2E
|
0x9A
|
|
Set AMC Time Out Parameter
|
0x2E
|
0xF1
|
|
Get AMC Time Out Parameter
|
0x2E
|
0xF0
|
|
Set Boot Page
|
0x2E
|
0x81
|
|
Get Boot Page
|
0x2E
|
0x82
|
|
Set Front Panel Reset Button State
|
0x2E
|
0x83
|
|
Get Front Panel Reset Button State
|
0x2E
|
0x84
|
|
Set IPMC Control Bits
|
0x2E
|
0xE9
|
|
Get IPMC Control Bits
|
0x2E
|
0xE8
|
|
Set Management Port
|
0x2E
|
0x9B
|
|
Get Management Port
|
0x2E
|
0x9C
|
|
Get Shelf FRU Record Data
|
2Eh
|
1h
|
|
Set Shelf FRU Record Data
|
2Eh
|
05h
|
|
Set SOL Fail Over Link Change Timeouts
|
0x2E
|
0xE7
|
|
Get SOL Fail Over Link Change Timeouts
|
0x2E
|
0xE6
|
|
Get Version
|
0x2E
|
0x80
|
|
Set Thermal Trip
|
0x2E
|
E5
|
|
Get Thermal Trip
|
0x2E
|
0xE4
|
|
Subscribe for Event Notifications
|
2Eh
|
4h
|
Notify Shelf Manager About an Extracted FRU
This extension command is sent to the logical Shelf Manager (20h) and informs the Shelf Manager that the specified FRU (which is typically in the communication lost (M7) state) is not in the shelf any more and can be moved to state M0, and have all its resources released. If the FRU Device ID is 0, the command applies to all FRUs represented by the specified IPM controller. This command is similar in effects to the CLI command setextracted.
Unless the Forced Mode is specified, the Shelf Manager verifies that the target FRU is indeed in the Communication Lost (M7) state; if not, the completion code D5 (Command Not Supported in Present State) is returned.
|
Command
|
NetFn
|
Opcode
|
|
Notify Shelf Manager About an Extracted FRU
|
2Eh
|
2h
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
PPS IANA Low Byte. A value 0Ah shall be used.
|
|
2
|
PPS IANA Middle Byte. A value 40h shall be used.
|
|
3
|
PPS IANA High Byte. A value 00h shall be used.
|
|
4
|
IPMB Address. Indicates IPMB address of the target IPM Controller
|
|
5
|
Target FRU Device ID. Indicates the FRU Device ID that is targeted by this command.
|
|
6
|
Flags. An optional bit field:
[7:1] Reserved; shall be set to 0
[0] Forced Mode. This bit is set to 1b if "forced mode" is to be used; in this mode the Shelf Manager does not check that the target FRU is indeed in state M7.
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[ CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
2
|
PPS IANA Low Byte. A value 0Ah shall be used.
|
|
3
|
PPS IANA Middle Byte. A value 40h shall be used.
|
|
4
|
PPS IANA High Byte. A value 00h shall be used.
|
Initiate Shelf Manager Switchover
This Pigeon Point extension command can be targeted to the logical Shelf Manager address (20h) or alternatively to the physical address for either the active or backup Shelf Managers. It initiates a switchover from the active to the backup Shelf Manager. If a switchover cannot be performed (for instance, if there is no backup Shelf Manager available), the completion code D5 (Command Not Supported in Present State) is returned.
|
Command
|
NetFn
|
Opcode
|
|
Initiate Shelf Manager Switchover
|
2Eh
|
3h
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
PPS IANA Low Byte. A value 0Ah shall be used.
|
|
2
|
PPS IANA Middle Byte. A value 40h shall be used.
|
|
3
|
PPS IANA High Byte. A value 00h shall be used.
|
|
4
|
Flags. A bit field that specifies the action
[0]: 1b = subscribe for event notifications on the
current session;
0b = unsubscribe
[7:1] Reserved. Shall be set to 0.
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[ CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
2
|
SPPS IANA Low Byte. A value 0Ah shall be used.
|
|
3
|
PPS IANA Middle Byte. A value 40h shall be used.
|
|
4
|
PPS IANA High Byte. A value 00h shall be used.
|
Reset IPMC Configuration Variables
IPMC configuration variables are retained across firmware upgrades and downgrades, as long as the version being downgraded to supports this feature.
IPMC has a group of parameters that are stored in SEEPROM (NV Storage). All variables are part of one data structure. Each of these variables performs a function and can be set or read via commands. These variables are stored across IPMC resets. However, previously, these variables were reset to default values when new or upgraded firmware was installed.
Set AMC Time Out Parameter
Use the following command from ShMM, Payload, or Debug interface to set the timeout values of AMC.
|
Command
|
NetFn
|
Opcode
|
|
Set AMC Time Out Parameter
|
0x2E
|
0xF1
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F or 2A (Sun legacy)
|
|
|
4
|
Delay LSB
|
|
|
5
|
Delay MSB
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F or 2A (Sun legacy)
|
Get AMC Time Out Parameter
Use the following command from ShMM, Payload, or Debug interface to read the default timeout values of AMC.
|
Command
|
NetFn
|
Opcode
|
|
Get AMC Time Out Parameter
|
0x2E
|
0xF0
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F or 2A (Sun legacy)
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
[CB] If parameter is not set.
|
|
|
|
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F or 2A (Sun legacy)
|
|
|
5
|
Delay LSB
|
|
|
6
|
Delay MSB
|
Set Boot Page
Use the following command from ShMM, Payload, or Debug interface to set the BIOS boot page. The default value for the boot page is 0. Bits 7 to 1 should be set to zeroes. The value set by the user is stored in SEEPROM. Upon next boot, the same value of the boot page will be used.
|
Command
|
NetFn
|
Opcode
|
|
Set Boot Page
|
0x2E
|
0x82
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F or 2A (Sun legacy)
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
[CB] If parameter is not set.
|
|
|
|
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F or 2A (Sun legacy)
|
|
|
5
|
Boot page value. 0 = page 0, 1 = page 1.
|
Get Boot Page
Use the following command from ShMM, Payload, or Debug interface to read the BIOS boot page.
|
Command
|
NetFn
|
Opcode
|
|
Get Boot Page
|
0x2E
|
0x81
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F or 2A (Sun legacy)
|
|
|
4
|
Boot page: 0 or 1
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F or 2A (Sun legacy)
|
Set Front Panel Reset Button State
Use the following command to change the way the front panel reset is handled by CPLD when this button is pressed. Default on CPLD power up is 10.
|
Command
|
NetFn
|
Opcode
|
|
Set Front Panel Reset Button State
|
0x2E
|
0x83
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F or 2A (Sun legacy)
|
|
|
4
|
Front panel settings
- Bits 0 and 1 = front panel reset state:
- 00 = Reset IPMC and hard reset to system
- 01 = NMI to system
- 10 = Hard reset to system
- 11 = Front panel reset button disabled
- Bits 2 to 7 = 0
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F or 2A (Sun legacy)
|
Get Front Panel Reset Button State
Use the following command to read settings of the front panel reset button handling. By default on CPLD, power on it comes up as 10, i.e., pressing this button causes Power on Reset to CPU.
|
Command
|
NetFn
|
Opcode
|
|
Get Front Panel Reset Button State
|
0x2E
|
0x84
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F or 2A (Sun legacy)
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F or 2A (Sun legacy)
|
|
|
5
|
Front panel settings
- Bits 0 and 1 = front panel reset state:
- 00 = Reset IPMC and hard reset to system
- 01 = XIR to CPU
- 10 = Hard reset to system (POR to CPU)
- 11 = Front panel reset button disabled
- Bits 2 to 7 = 0
|
Set IPMC Control Bits
Use the following command to set the configuration of the blade server’s LED and the AMC shutdown behavior.
|
Command
|
NetFn
|
Opcode
|
|
Set IPMC Control Bits
|
0xE9
|
0xE9
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F or 2A (Sun legacy)
|
|
|
4
|
Control byte.
- Bit 0 = LED 2 (Green LED) control bit:
- 1 = IPMC controls green LED.
- 0 = IPMC does not control green LED.
- Bit 1 = LED1 (Amber/Red LED) control bit.
- 1 = IPMC controls LED1 for default behavior.
- 0 = IPMC does not control LED1.
- Bit 2= AMC latch control bit.
- 1 = IPMC intiates shutdown of AMC upon latch opening.
- 0 = IPMC does not initiate shutdown of AMC upon latch opening.
- Bits 3 to 7 = Reserved for future use. Write as 1s. (See Note.)
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F or 2A (Sun legacy)
|
| Note - If an attempt is made to write 0 to any reserved bit (3 to 7), IPMC will reject the command with completion code 0xCC.
|
Get IPMC Control Bits
Use the following command to display the current configuration of the blade server’s OOS LED behavior.
|
Command
|
NetFn
|
Opcode
|
|
Get IPMC Control Bits
|
0x2E
|
0xE8
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F or 2A (Sun legacy)
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F or 2A (Sun legacy)
|
|
|
5
|
IPMC control bit:
- Bit 0: Green LED control bit.
- Bit 1: LED1 control bit.
- Bit 2: AMC latch control bit.
- Bits 3 to 7: Reserved for future use.
|
Set Management Port
Use the following command to configure management port access to font or rear panel.
|
Command
|
NetFn
|
Opcode
|
|
Set Management Port
|
0x2E
|
0x9B
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F
|
|
|
4
|
Control byte
- Bit 0 = port access setting:
0 = Route to rear panel
1 = Route to front panel (default)
- Bits 1 to 7 = Reserved. Write zeros.
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F
|
Get Management Port
Use the following command to display the current settings of the management port configuration (rear or front access).
|
Command
|
NetFn
|
Opcode
|
|
Get Management Port
|
0x2E
|
0x9C
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F
|
|
|
5
|
IPMC control bit:
0 = Port routed to rear.
1 = Port routed to front (default).
- Bits 1 to 7: Reserved for future use.
|
Set Shelf FRU Record Data
Using this Pigeon Point extension command, a specified range of bytes can be written into any multirecord in the Shelf FRU Information. This command can be applied to any PICMG-defined or OEM-defined record in the Shelf FRU Information, including the Address Table Record (PICMG Record ID = 10h), Shelf Power Distribution Record (PICMG Record ID = 11h), etc.
The type of the record to be written is specified by the Manufacturer IANA and manufacturer-specific record type. The 0-based record number can be used to distinguish different instances of the same type of record. (There may be several records of the same type in the Shelf FRU Information.)
The implementation of the command takes care of updating the checksum of the target record so that the checksum stays correct.
The number of bytes to be written by this command is limited by the size of IPMB packet and must be 15 bytes or fewer. This number is specified by the parameter "Byte Count" and must be equal to the actual number of data bytes in the command. If the actual number of data bytes in a command does not correspond to the value of the parameter "Byte Count", the command is rejected.
|
Command
|
NetFn
|
Opcode
|
IANA:
|
|
Set Shelf FRU Record Data
|
2Eh
|
05h
|
0400Ah (Assigned to PPS
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
PPS IANA Low Byte.
|
|
2
|
PPS IANA Middle Byte.
|
|
3
|
PPS IANA High Byte.
|
|
4
|
Record Manufacturer IANA Low Byte.
|
|
5
|
Record Manufacturer IANA Middle Byte.
|
|
6
|
Record Manufacturer IANA High Byte.
|
|
7
|
Record Type.
|
|
8
|
Record Number. This field specifies the number of the record to be accessed. The record numbers are 0-based.
|
|
9
|
Offset. This field specifies the offset from the beginning of the record in bytes.
|
|
10
|
Byte Count.This field specifies the number of bytes to be written.
|
|
|
11:N+10
|
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[ CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
2
|
PPS IANA Low Byte.
|
|
3
|
PPS IANA Middle Byte.
|
|
4
|
PPS IANA High Byte.
|
|
5
|
Count written. Indicates the number of bytes written to the record.
|
|
6:N+5
|
Data. This variable length field contains data retrieved from the record. N is specified in the Count read byte.
|
For example, to set the first 9 bytes of the first Address Table record in the Shelf FRU Information, use the following parameters:
Record Manufacturer IANA Low Byte = 5Ah (PICMG)Record Manufacturer IANA Middle Byte = 31h (PICMG)Record Manufacturer IANA High Byte = 00h (PICMG)Record type = 10h (Address Table)Record Number = 00h (first record)Offset = 00hByte Count = 09
Data = 41h 08h 00h 12h 09h 00 43h 0Ah 00(9 bytes)
|
This feature retains any custom values you configured for the following variables.
TABLE B-2 IPMC Variables for Which You Can Retain Configurations
|
Variable
|
Description
|
|
log_level
|
Controls the log level of the debug messages.
|
|
Payload timeout
|
Controls the timeout for payload response. IPMC, after sending payload alert, expects OS to respond within this time. Used in graceful reboot and graceful shutdown features.
|
|
Payload shutdown timeout
|
Controls the payload shutdown timeout as described in the graceful reboot/shutdown specification. This is the time that an OS would take to shutdown its applications before IPMC shuts it down or resets the payload.
|
|
Verbosity
|
Controls the debug mode verbosity of the messages. Selectively, messages from/to a particular interface can be enabled/disabled. Used for debugging only.
|
|
AMC power up timeout
|
Controls the time it would take for the AMCs/ARTM to come up before the payload is brought to M4 state.
|
|
IPMC Control
|
Reflects IPMC’s control bits. Currently two bits, Bit 0 and Bit 1 control LED2 and LED1 on the boards.
|
|
Set SOL Fail Over Link Change Timeouts
|
Controls the time for which IPMC waits to switch to second serial over LAN (SOL) link when primary link fails, and the time it waits to switch back to primary channel if the primary channel link comes back up.
|
|
Get SOL Fail Over Link Change Timeouts
|
Gets the time for which IPMC waits to switch to second serial over LAN (SOL) link when primary link fails.
|
If you want to reset these variables to their default, use the Reset IPMC Configuration Variables command.
|
Command
|
NetFn
|
Opcode
|
|
Reset IPMC Configuration Variables
|
0x2E
|
0x9A
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
2
|
00
|
|
3
|
6F or 2A (Sun legacy)
|
|
4
|
Parameter to be set.
00 = Reset all parameters to default value. NOTE: Any custom configuration parameters will be erased.
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
[C8] Request data field length limit exceeded.
(Refer to IPMI specification for more completion codes)
|
|
2
|
00
|
|
3
|
00
|
|
4
|
6F or 2A (Sun legacy)
|
Get Shelf FRU Record Data
Using this Pigeon Point extension command, a specified range of bytes can be retrieved from any multirecord in the Shelf FRU Information. This command can be applied to any PICMG-defined or OEM-defined record from the Shelf FRU Information, including the Address Table Record (PICMG Record ID = 10h), Shelf Power Distribution Record (PICMG Record ID = 11h), etc.
The type of the record to be retrieved is specified by the Manufacturer IANA and manufacturer-specific record type. The 0-based record number can be used to distinguish different instances of the same type of record. (There may be several records of the same type in the Shelf FRU Information.).
|
Command
|
NetFn
|
Opcode
|
|
Get Shelf FRU Record Data
|
2Eh
|
1h
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
PPS IANA Low Byte. A value 0Ah shall be used.
|
|
2
|
PPS IANA Middle Byte. A value 40h shall be used.
|
|
3
|
PPS IANA High Byte. A value 00h shall be used.
|
|
4
|
Record Manufacturer IANA Low Byte.
|
|
5
|
Record Manufacturer IANA Middle Byte.
|
|
6
|
Record Manufacturer IANA High Byte.
|
|
7
|
Record Type.
|
|
8
|
Record Number. This field specifies the number of the record to be accessed. The record numbers are 0-based.
|
|
9
|
Offset. This field specifies the offset from the beginning of the record in bytes.
|
|
10
|
Byte Count.This field specifies the number of bytes to be read.
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[ CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
2
|
PPS IANA Low Byte. A value 0Ah shall be used.
|
|
3
|
PPS IANA Middle Byte. A value 40h shall be used.
|
|
4
|
PPS IANA High Byte. A value 00h shall be used.
|
|
5
|
Count read. Indicates the number of bytes in the Data field.
|
|
6:N+5
|
Data. This variable length field contains data retrieved from the record. N is specified in the Count read byte.
|
For example, to retrieve the first 10 bytes of the first Address Table record in the Shelf FRU Information, use the following parameters:
Record Manufacturer IANA Low Byte = 5Ah (PICMG)Record Manufacturer IANA Middle Byte = 31h (PICMG)Record Manufacturer IANA High Byte = 00h (PICMG)Record type = 10h (Address Table)Record Number = 00h (first record)Offset = 00hByte Count = Ah (10 bytes)
|
Set SOL Fail Over Link Change Timeouts
Use the following command to set the time for which IPMC waits to switch to second serial over LAN (SOL) link when primary link fails, and the time it waits to switch back to primary channel if the primary channel link comes back up. Wait times are useful to filter out the link up/down bounces.
| Note - The default settings are recommended over user-customized settings.
|
Wait times are in seconds. For example, a number 10 (0xA) in Byte 4 means IPMC will wait 10 seconds before switching the link to secondary channel. And a number 15(0xf) means IPMC will wait for 15 seconds before switching back to primary channel once it comes back up.
|
Command
|
NetFn
|
Opcode
|
|
Set SOL Fail Over Link Change Timeouts
|
0x2E
|
0xE7
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F or 2A (Sun legacy)
|
|
|
4
|
Primary Link down, fail-over wait time.
|
|
|
5
|
Primary Link up, wait time to switch to primary.
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F or 2A (Sun legacy)
|
Get SOL Fail Over Link Change Timeouts
Use the following command to read the time for which IPMC waits to switch to second serial over LAN (SOL) link when primary link fails, and the time it waits to switch back to primary channel if the primary channel link comes back up.
|
Command
|
NetFn
|
Opcode
|
|
Get SOL Fail Over Link Change Timeouts
|
0x2E
|
0xE6
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F or 2A (Sun legacy)
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F or 2A (Sun legacy)
|
|
|
5
|
Primary Link down, fail-over wait time.
|
|
|
6
|
Primary Link up, wait time to switch to primary.
|
Get Version
Use the following command to read IPMC firmware version and standby CPLD version. Although this command returns IPMC firmware version with CPLD version, the primary reason for this command is to provide CPLD version for IPMC version. To obtain IPMC version, use the IPMI get device ID command.
|
Command
|
NetFn
|
Opcode
|
|
Get Version
|
0x2E
|
0x80
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
|
2
|
00
|
|
|
3
|
6F or 2A (Sun legacy)
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
|
2
|
00
|
|
|
3
|
00
|
|
|
4
|
6F or 2A (Sun legacy)
|
|
|
5
|
CPLD version
|
|
|
6
|
REV1 byte of IPMC firmware
|
|
|
7
|
REV2 Byte of IPMC Firmware
|
|
|
8
|
Bit 7 to Bit 1: Reserved
Bit 8 to Bit 1: Reserved
1 => Test release.
0 => Regular release.
|
|
|
9
|
Reserved for future use (ignore).
|
|
|
A
|
Reserved for future use (ignore).
|
| Note - IPMC version is read as low nibble of REV1, high nibble of REV2, and low nibble of REV2.
|
Set Thermal Trip
Use the following command to enable or disable the thermal trip that determines when a board shuts down because maximum temperature is reached.
|
Caution - Damage to boards and systems can occur if temperature thresholds are reached and shut down does not occur. Unless the operating situation warrants overriding the default, use the default value.
|
In extreme situations such as operating in a war zone, there may be a requirement by the user to override the maximum temperature thresholds. Referred to as “war zone mode,” users can override thermal trip to keep boards and systems running even if they reach maximum temperature thresholds.
|
Command
|
NetFn
|
Opcode
|
|
Set Thermal Trip
|
0x2E
|
E5
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
2
|
00
|
|
3
|
6F or 2A (Sun legacy)
|
|
4
|
Bit 7 to Bit 1: Reserved. Shall be set as 0.
Bit 0: Thermal trip bit value:
1 => Enable thermal trip (Default)
0 => Disable thermal trip.
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
2
|
00
|
|
3
|
00
|
|
4
|
6F or 2A (Sun legacy)
|
Get Thermal Trip
Use the following command to read the current thermal trip value.
|
Command
|
NetFn
|
Opcode
|
|
Get Thermal Trip
|
0x2E
|
0xE4
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
00
|
|
2
|
00
|
|
3
|
6F or 2A (Sun legacy)
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
2
|
00
|
|
3
|
00
|
|
4
|
6F or 2A (Sun legacy)
|
|
|
5
|
Thermal trip value:
1 => Thermal trip enabled. Board will shut down if maximum temperature occurs.
0 => Thermal trip disabled. Board will not shut down if maximum temperature occurs.
|
Subscribe for Event Notifications
This Pigeon Point extension command can be used by an RMCP client to subscribe or unsubscribe for event notification on the current RMCP session. This command should be targeted to the logical Shelf Manager address (20h). It either subscribes or unsubscribes for event notification on the current session, depending on the value of the parameter Flags. If a session is subscribed for notifications, each time a new entry is placed in the SEL, a notification in the form of an Add SEL Entry request is sent to the RMCP client over this session. The client should confirm the notification by sending an Add SEL Entry response, according to the normal IPMI rules. The subscription is automatically terminated when the corresponding session is closed.
|
Command
|
NetFn
|
Opcode
|
|
Subscribe for Event Notifications
|
2Eh
|
4h
|
Data Bytes
|
Type
|
Byte
|
Data Field
|
|
Request Data
|
1
|
PPS IANA Low Byte. A value 0Ah shall be used.
|
|
2
|
PPS IANA Middle Byte. A value 40h shall be used.
|
|
3
|
PPS IANA High Byte. A value 00h shall be used.
|
|
4
|
Flags. A bit field that specifies the action
[0]: 1b = subscribe for event notifications on the
current session;
0b = unsubscribe
[7:1] Reserved. Shall be set to 0.
|
|
Response Data
|
1
|
Completion Code:
[00] OK
[C1] Command not supported
[ CC] Invalid data in request
(Refer to IPMI specification for more completion codes)
|
|
2
|
SPPS IANA Low Byte. A value 0Ah shall be used.
|
|
3
|
PPS IANA Middle Byte. A value 40h shall be used.
|
|
4
|
PPS IANA High Byte. A value 00h shall be used.
|
| Sun Netra CT900 Server Administration and Reference Manual
|
819-1177-18
|
   
|
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.