Scroll to navigation

IPMCTL-CHANGE-SENSOR(1) ipmctl IPMCTL-CHANGE-SENSOR(1)

NAME

ipmctl-change-sensor - Changes the threshold or enabled state for DCPMMs sensors

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

-f, -force

Changing the sensor settings is a potentially destructive operation which requires confirmation from the user for each DCPMM. 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".

SENSORS

MediaTemperature

The current DCPMM media temperature in Celsius.
Valid values: 0-2047

ControllerTemperature

The current DCPMM controller temperature in Celsius.
Valid values 0-2047

PercentageRemaining

Remaining DCPMM’s life as a percentage value of factory expected life span.
Valid values: 1-99

TARGETS

-dimm [DimmIDs]

Restricts output to the sensors on specific DCPMMs by optionally supplying the DIMM target and one or more comma-separated DCPMM identifiers. The default is to display sensors for all manageable DCPMMs.

PROPERTIES

AlarmThreshold

The threshold value at which an alarm for the respective sensor will be triggered. The upper (for temperatures) or lower (for spare capacity) alarm threshold of the sensor. Temperatures may be specified in degrees Celsius to a precision of 1/16 a degree.

AlarmEnabled

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

•"0": Disable

•"1": Enable

EXAMPLES

Changes the media temperature threshold to 51 on the specified DCPMM and enable 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 DCPMM(s) must be manageable by the host software.

RETURN DATA

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

SAMPLE OUTPUT

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

Modify (Sensor) settings on DIMM (DimmID): Error (Code) -
(Description)
2019-12-15 ipmctl