1IPMCTL-SHOW-SENSOR(1)               ipmctl               IPMCTL-SHOW-SENSOR(1)
2
3
4

NAME

6       ipmctl-show-sensor - Shows health statistics for one or more DCPMMs
7

SYNOPSIS

9       ipmctl show [OPTIONS] -sensor [SENSORS] [TARGETS]
10

DESCRIPTION

12       ipmctl-show-device to view more detailed information about a DCPMM.
13

OPTIONS

15       -a, -all
16           Shows all attributes.
17
18           Note
19           The all and display options are exclusive and may not be used
20           together.
21
22       -d (attributes), -display (attributes)
23           Filters the returned attributes by explicitly specifying a
24           comma-separated list of any of the attributes defined in the Return
25           Data section.
26
27           Note
28           The all and display options are exclusive and may not be used
29           together.
30
31       -h, -help
32           Displays help for the command.
33
34       -o (text|nvmxml), -output (text|nvmxml)
35           Changes the output format. One of: "text" (default) or "nvmxml".
36

SENSORS

38       Health
39           (Default) The current DCPMM health as reported in the SMART log
40
41       MediaTemperature
42           (Default) The current DCPMM media temperature in Celsius
43
44       ControllerTemperature
45           (Default) The current DCPMM controller temperature in Celsius
46
47       PercentageRemaining
48           (Default) Remaining DCPMM’s life as a percentage value of factory
49           expected life span
50
51       LatchedDirtyShutdownCount
52           (Default) The number of shutdowns without notification over the
53           lifetime of the DCPMM
54
55       UnlatchedDirtyShutdownCount
56           (Default) The number of shutdowns without notification over the
57           lifetime of the DCPMM. This counter is the same as
58           LatchedDirtyShutdownCount except it will always be incremented on a
59           dirty shutdown, even if Latch System Shutdown Status was not
60           enabled
61
62       PowerOnTime
63           (Default) The total power-on time over the lifetime of the DCPMM
64
65       UpTime
66           (Default) The total power-on time since the last power cycle of the
67           DCPMM
68
69       PowerCycles
70           (Default) The number of power cycles over the lifetime of the DCPMM
71
72       FwErrorCount
73           The total number of firmware error log entries
74

TARGETS

76       -dimm (DimmIDs)
77           Restricts output to the sensors on specific DCPMMs by supplying the
78           DIMM target and one or more comma-separated DCPMM identifiers. The
79           default is to display sensors for all manageable DCPMMs.
80

EXAMPLES

82       Gets all sensor information for all DCPMMs.
83
84       ipmctl show -sensor
85
86       Shows the media temperature sensor for the specified DCPMM.
87
88       ipmctl show -sensor MediaTemperature -dimm 1234
89

LIMITATIONS

91       The specified DCPMM(s) must be manageable by the host software.
92

RETURN DATA

94       This command displays a table with a row for each sensor on each DCPMM.
95       Applying a specific DCPMM or sensor type target limits the number of
96       rows. Applying options can be used to expand or restrict the output.
97
98       DimmID
99           (Default) The DCPMM identifier
100
101       Type
102           (Default) The sensor type. Refer to the sensor table above.
103
104       CurrentValue
105           (Default) The current reading followed by the units of measurement
106           (e.g., 57 °C or 25%)
107
108       CurrentState
109           (Default) The current value in relation to the threshold settings
110           (if supported). One of:
111
112           ·   Unknown: The state cannot be determined.
113
114           ·   Normal: The current reading is within the normal range. This is
115               the default when the sensor does not support thresholds.
116
117           ·   NonCritical: The current reading is within the non-critical
118               range. For example, an alarm threshold has been reached.
119
120           ·   Critical: The current reading is within the critical range. For
121               example, the firmware has begun throttling down traffic to the
122               DCPMM due to the temperature.
123
124           ·   Fatal: The current reading is within the fatal range. For
125               example, the firmware is shutting down the DCPMM due to the
126               temperature.
127
128       LowerThresholdNonCritical
129           The threshold value below which the state is considered
130           "NonCritical".
131
132       UpperThresholdNonCritical
133           The threshold value at or above which the state is considered
134           "NonCritical".
135
136       LowerThresholdCritical
137           The threshold value below which the state is considered "Critical".
138
139       UpperThresholdCritical
140           The threshold value at or above which the state is considered
141           "Critical".
142
143       UpperThresholdFatal
144           The threshold value at or above which the state is considered
145           "Fatal".
146
147       SettableThresholds
148           A list of user settable thresholds. Zero or more of:
149
150           ·   "LowerThresholdNonCritical"
151
152           ·   "UpperThresholdNonCritical"
153
154       SupportedThresholds
155           A list of supported thresholds. Zero or more of:
156
157           ·   "LowerThresholdNonCritical"
158
159           ·   "UpperThresholdNonCritical"
160
161           ·   "LowerThresholdCritical"
162
163           ·   "UpperThresholdCritical"
164
165           ·   "UpperThresholdFatal"
166
167       EnabledState
168           Whether the critical threshold alarm is enabled, disabled or not
169           applicable. One of:
170
171           ·   0: Disabled
172
173           ·   1: Enabled
174
175           ·   N/A
176
177
178
179ipmctl                            2019-10-23             IPMCTL-SHOW-SENSOR(1)