logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

ipmctl-set-sensor - Sets the threshold or enabled state for PMem modules sensors

Description

       Changes the alarm threshold or enabled state for one or more PMem modules sensors. Use the command Show
       Sensor to view the current settings.

Examples

       Changes the media temperature alarm threshold to 51C on the specified PMem module and enables the alarm.

           ipmctl set -sensor MediaTemperature -dimm 0x0001 AlarmThreshold=51 AlarmEnabled=1

Limitations

       In order to successfully execute this command:

       •   The caller must have the appropriate privileges.

       •   The specified PMem modules must be manageable by the host software.

Name

       ipmctl-set-sensor - Sets the threshold or enabled state for PMem modules sensors

Options

       -f, -force
           Changing the sensor settings is a potentially destructive operation which requires confirmation from
           the user for each PMem module. This option suppresses the confirmation.

       -h, -help
           Displays help for the command.

       -ddrt
           Used to specify DDRT as the desired transport protocol for the current invocation of ipmctl.

       -smbus
           Used to specify SMBUS as the desired transport protocol for the current invocation of ipmctl.

           Note

           The -ddrt and -smbus options are mutually exclusive and may not be used together.

       -o (text|nvmxml), -output (text|nvmxml)
           Changes the output format. One of: "text" (default) or "nvmxml".

Properties

       AlarmThreshold
           The threshold value at which an alarm for the respective sensor will be triggered. The upper (for
           temperatures) or lower (for percentage remaining) alarm threshold of the sensor. Temperatures may be
           specified to a precision of 1 degree Celsius.

           Table1.AllowedAlarmThreshold
           ┌───────────────────────┬────────────────────────┬─────────┐
           │                       │                        │         │
           │ Sensor                │ Allowed AlarmThreshold │ Units   │
           │                       │ values                 │         │
           ├───────────────────────┼────────────────────────┼─────────┤
           │                       │                        │         │
           │ MediaTemperature      │ 0-85                   │ Celsius │
           ├───────────────────────┼────────────────────────┼─────────┤
           │                       │                        │         │
           │ ControllerTemperature │ 0-102                  │ Celsius │
           ├───────────────────────┼────────────────────────┼─────────┤
           │                       │                        │         │
           │ PercentageRemaining   │ 1-99                   │ %       │
           └───────────────────────┴────────────────────────┴─────────┘

       AlarmEnabled
           Enable or disable the alarm threshold, where applicable. One of:

           •   "0": Disable

           •   "1": Enable

Return Data

       For each PMem module, the CLI will indicate the status of the operation. If a failure occurs when
       modifying multiple PMem modules, the process will exit and not continue modifying the remaining PMem
       modules.

Sample Output

           Modify (Sensor) settings on DIMM (DimmID): Success

           Modify (Sensor) settings on DIMM (DimmID): Error (Code) -
           (Description)

ipmctl                                             2024-04-22                               IPMCTL-SET-SENSOR(1)

Sensors

       MediaTemperature
           The PMem module media temperature in Celsius.

       ControllerTemperature
           The PMem module controller temperature in Celsius.

       PercentageRemaining
           Remaining PMem module’s life as a percentage value of factory expected life span.

Synopsis

           ipmctl set [OPTIONS] -sensor (SENSORS) [TARGETS]
           AlarmThreshold=(temperature) AlarmEnabled=(0|1)

Targets

       -dimm [DimmIDs]
           Update specified sensors on specific PMem modules by optionally supplying the PMem module target and
           one or more comma separated PMem module identifiers. The default is to update the specified sensors
           for all manageable PMem modules.

See Also