エージェント構成更新スクリプトのユース・ケース

更新スクリプトを使用して、 AgentConfig.xml ファイルに対して手動またはスクリプトによる編集を行うことなく、エージェント構成を変更できます。

更新スクリプトを WinCollect パッチ・ディレクトリーにコピーすると、エージェントはスクリプトに記述されているアクションを実行します。

スクリプト・アクションの更新

更新スクリプトには、以下のアクションを含めることができます。

<Addto>-関連するノードに子を追加します。タイプと特定の定義済みキー値のペアを含めることができます。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<WinCollectScript version="10.0">
     <AddTo objPath="LocalSources(Name=Local)" >
        <Source Channel="System" />
    </AddTo> 
</WinCollectScript>

<Update>-キーの値を更新します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<WinCollectScript version="10.0">
     <Update objPath="LocalSources(Name=Local)/Source(Name=System)" setParam="PollingInterval" value="12000" /> 
</WinCollectScript>

<Delete>-<Addto>,と似ていますが、オブジェクトの名前をオブジェクト・パスに追加する点が異なります。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<WinCollectScript version="10.0">
     <Delete objPath="LocalSources(Name=Local)" /> 
</WinCollectScript>

エージェントは、パッチ・フォルダー内に新規構成を作成し、その新規構成を検証します。検証が成功すると、古いエージェント構成がバックアップされます。エージェントは、更新スクリプト、古い AgentConfig.xml ファイル、および新しい AgentConfig.xml ファイルをバックアップ・フォルダー (patch_xxxx) に移動し、新しいエージェント構成を操作できるようにします。

WinCollect 10 には、いくつかのサンプル更新スクリプトがインストールされています。これらは、\IBM\WinCollect\samples ディレクトリーに保管されます。

例

重要: これらのスクリプトは例にすぎません。独自のスクリプトを作成できるように、すべてのエージェント構成サービス・モジュールがサポートされています。

注: 更新スクリプト・ファイル名の先頭は update_でなければなりません。その他のファイル名はすべて無視されます。

update_addXPath.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<WinCollectScript version="10.0">
    <AddTo objPath="LocalSources(Name=Local)" >
        <Source Name="Security XPath" >
            <Parameter name="Query">
                <QueryList>
                  <Query Id="1" Path="Security">
                    <Select Path="Security">*[System[(Level=1  or Level=2 or Level=3) and (EventID=1 or EventID=3 or  (EventID >= 5 and EventID <= 100)  or  (EventID >= 200 and EventID <= 500) )]]</Select>
                  </Query>
                </QueryList>
            </Parameter>
        </Source>
    </AddTo>
</WinCollectScript>

update_delSecurity.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<WinCollectScript version="10.0">
    <Delete objPath="LocalSources(Name=Local)/Source(Name=Security)" />
</WinCollectScript>

update_updtConsPort.xml

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<WinCollectScript version="10.0">
    <Update objPath="SystemSettings" setParam="Console.Port" value="3333" descr="Changing the Config Console's port to 3333" />
</WinCollectScript>

以下のユース・ケースは、更新スクリプトを使用してエージェント構成を変更する方法の例です。