⁠14.3. Power Management Elements

The power_management element provides users with the ability to set a power management configuration, which is required for host fencing. Certain sub-elements are required when configuring power_management.
⁠

Table 14.2. Power management options

Element Type Description Properties
type= fencing device code A list of valid fencing device codes are available in the capabilities collection.
enabled Boolean: true or false Indicates whether power management configuration is enabled or disabled.
address string The host name or IP address of the host.
username string A valid user name for power management.  
password string A valid, robust password for power management.  
options complex Fencing options for the selected type=.  
agent complex Specifies fencing agent options when multiple fences are used. Subelement concurrent is a True|False Boolean that selects concurrent|sequential configuration respectively. Use the order subelement to prioritize the fencing agents. Other subelements include address, username, password, and options.  
The options element requires a list of option sub-elements. Each option requires a name and type attributes. Certain options are only available for specific fencing types as defined in the capabilities collection.
A new host includes an optional power_management configuration when POSTing to the host resource. The power_management configuration is updatable using a PUT request.
⁠

Example 14.2. An XML representation of a host's power management configuration

<host id="2ab5e1da-b726-4274-bbf7-0a42b16a0fc3"
  href="/api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3">
    <name>host1</name>
    ...
    <power_management type="ilo">
        <enabled>true</enabled>
        <address>192.168.1.107</address>
        <username>admin</username>
        <password>p@55w0Rd!</password>
        <options>
            <option name="secure" value="true"/>
            <option name="port" value="54345"/>
            <option name="slot" value="3"/>
        </options>
        <agents>
            <agent type="rsa">
                <address>192.168.1.111</address>
                <username>e.xample</username> order="primary"
                <password>p@55w0rd!</password>
                <options>
                    <option name="443" value="true"/> 
                    <option name="secure" value "false"/>
                </options>
                <concurrent>false</concurrent>
                <order>1</order>
            </agent>
            <agent type="ipmi">
                <address>192.168.1.112</address>
                <username>e.xample</username> order="primary"
                <password>p@55w0rd!</password>
                <options>
                    <option name="443" value="true"/> 
                    <option name="secure" value "false"/>
                </options>
                <concurrent>false</concurrent>
                <order>2</order>
            </agent>
        </agents>
    </power_management>
    ...
</host>
Report a bug