blob: a495e808d142150180861f3d640336c53ebafd4a [file] [log] [blame]
Andrew Geissler2477d9a2016-11-22 12:09:21 -06001description: >
2 Implement to provide host state management
3
4properties:
5 - name: RequestedHostTransition
6 type: enum[self.Transition]
7 default: 'Off'
8 description: >
9 The desired host transition. This will be preserved across AC
10 power cycles of the BMC.
11
12 - name: CurrentHostState
13 type: enum[self.HostState]
14 description: >
15 A read-only property describing the current state of the host
16 firmware. A user can determine if a system is in transition by
17 comparing the CurrentHostState and the RequestedHostTransition
18 properties.
19
Vijay Khemka6bcf4ff2020-03-03 15:20:08 -080020 - name: RestartCause
21 type: enum[self.RestartCause]
22 default: 'Unknown'
23 description: >
24 A property to define restart cause of a host.
25
Andrew Geissler2477d9a2016-11-22 12:09:21 -060026enumerations:
27 - name: Transition
28 description: >
29 The desired transition for host firmware
30 values:
31 - name: 'Off'
32 description: >
33 Host firmware should be off
34 - name: 'On'
35 description: >
36 Host firmware should be on
37 - name: 'Reboot'
38 description: >
Andrew Geissler7adacdc2020-01-29 10:38:09 -060039 Host firmware should be rebooted. Chassis power will be cycled from
40 off to on during this reboot
41 - name: 'GracefulWarmReboot'
42 description: >
43 Host firmware be will notified to shutdown and once complete, the
44 host firmware will be rebooted. Chassis power will remain on
45 throughout the reboot
46 - name: 'ForceWarmReboot'
47 description: >
48 Host firmware will be rebooted without notification and chassis
49 power will remain on throughout the reboot
Andrew Geissler2477d9a2016-11-22 12:09:21 -060050
51 - name: HostState
52 description: >
53 The current state of the host firmware
54 values:
55 - name: 'Off'
56 description: >
57 Host firmware is not running
Andrew Geissler9f65dfe2020-11-05 13:57:51 -060058 - name: 'TransitioningToOff'
59 description: >
60 Host firmware is transitioning to an Off state
Andrew Geissler2477d9a2016-11-22 12:09:21 -060061 - name: 'Running'
62 description: >
63 Host firmware is running
Andrew Geissler9f65dfe2020-11-05 13:57:51 -060064 - name: 'TransitioningToRunning'
65 description: >
66 Host firmware is transitioning to a Running state
Saqib Khanb0360fa2017-02-16 13:56:51 -060067 - name: 'Quiesced'
68 description: >
Andrew Geissler3a77dc42021-01-25 14:36:47 -060069 Host firmware is quiesced. The host firmware is enabled but either
70 unresponsive or only processing a restricted set of commands. This
71 state can be a result of the host entering an error state or booting
72 into a BIOS setup environment. The BootProgress property will
73 provide details on which it is.
Andrew Geissler688ed122019-12-04 11:14:41 -060074 - name: 'DiagnosticMode'
75 description: >
76 Host firmware is capturing debug information. Powering off your
77 system while the host is in this state will prevent the debug data
78 from being properly collected. The host will move to one of the
79 other states once complete.
Vijay Khemka6bcf4ff2020-03-03 15:20:08 -080080
81 - name: RestartCause
82 description: >
83 The reason for host restart.
84 values:
85 - name: 'Unknown'
86 description: >
87 Reason Unknown
88 - name: 'RemoteCommand'
89 description: >
90 Remote command issued
91 - name: 'ResetButton'
92 description: >
93 Reset button pressed
94 - name: 'PowerButton'
95 description: >
96 Power button pressed
97 - name: 'WatchdogTimer'
98 description: >
99 Watchdog Timer expired
100 - name: 'PowerPolicyAlwaysOn'
101 description: >
102 Power Policy Host Always on
103 - name: 'PowerPolicyPreviousState'
104 description: >
105 Power Policy Previous State of Host
106 - name: 'SoftReset'
107 description: >
108 Soft reset of Host