14.4. 電源管理の要素

power_management 要素は、ホストのフェンシングに必要な電源管理設定を指定する機能をユーザーに提供します。power_management を設定する際には、特定のサブ要素が必要です。

表14.2 電源管理のオプション

要素タイプ説明プロパティー
type=フェンスデバイスコード有効なフェンスデバイスコードの一覧は capabilities コレクション内にあります。
enabledブール値: true または false電源管理設定が有効化または無効化されているかを示します。
address文字列ホストの IP アドレスまたはホスト名
username文字列電源管理の有効なユーザー名 
password文字列電源管理用の有効かつ堅固なパスワード 
options複合型選択した type= のフェンシングオプション。オプションの name=""value="" の文字列で指定します。 
agents複合型複数のフェンスが使用されている場合に、フェンスエージェントのオプションを指定します。order サブ要素を使用して、フェンスエージェントの優先順位付けをします。エージェントは、フェンスアクションが成功するまで、この順番に従い順次実行されます。同じ order が指定されるフェンスエージェントが複数ある場合には、同時に実行されます。他のサブ要素には、typeipuserpasswordoptions などがあります。 
automatic_pm_enabledブール値: true または false節電のためのホストの自動電源制御を切り替えます。この値を true に設定すると、クラスターの負荷が低下した場合にホストは自動的にオフになり、必要に応じて再度電源が投入されます。この値は、ユーザーが無効にしない限り、ホストの作成時に true に設定されます。 
kdump_detectionブール値: true または falseホストがシャットダウンする前に kdump が実行中かどうかを確認する設定を切り替えます。この値を true に指定すると、kdump プロセスの間はホストのシャットダウンは行われません。この値は、ユーザーによって無効にされない限り、ホストの電源管理が有効化されている場合は true に指定されます。 
options 要素には option サブ要素の一覧が必要です。各 option には nametype の属性が必要です。capabilities コレクションに定義されているように、特定のフェンシングタイプにしか使用できないオプションがあります。
ホストリソースに対して POST 要求を実行する場合には、新規のホストにオプションの power_management 設定を記載します。power_management 設定は PUT 要求を使用して更新することができます。

例14.3 ホストの電源管理設定の XML 表現

<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 id="07f0b9ce-923a-4a96-a532-3c898fa8b6da">
                <type>apc</type>
                <order>1</order>
                <ip>192.168.1.111</ip>
                <user>example</user>
                <password>p@55w0rd!</password>
                <port>9</port>
                <options>
                    <option name="power_wait" value="5"/> 
                    <option name="secure" value="false"/>
                </options>
            </agent>
            <agent id="50c71ba2-8495-11e0-b931-e20e458819ed">
                <type>rsa</type>
                <order>2</order>
                <ip>192.168.1.112</ip>
                <user>example</user>
                <password>p@55w0rd!</password>
                <port>9</port>
                <options>
                    <option name="power_wait" value="5"/> 
                    <option name="secure" value="false"/>
                </options>
            </agent>
        </agents>
        <automatic_pm_enabled>true</automatic_pm_enabled>
        <kdump_detection>true</kdump_detection>
    </power_management>
    ...
</host>