Anwendungsfälle für Scripts zur Aktualisierung der Agentenkonfiguration

Sie können die Agentenkonfiguration ändern, ohne manuelle oder scriptgesteuerte Bearbeitungen an der Datei AgentConfig.xml mithilfe von Aktualisierungsscripts vorzunehmen.

Wenn Sie ein Aktualisierungsscript in das Patchverzeichnis WinCollect kopieren, führt der Agent die Aktionen aus, die in Ihrem Script beschrieben sind.

Aktionen zum Aktualisieren von Scripts

Aktualisierungsscripts können die folgenden Aktionen enthalten:

< Hinzufügen> -Fügt dem relevanten Knoten ein untergeordnetes Element hinzu Sie können einen Typ und bestimmte definierte Schlüssel/Wert-Paare einschließen.

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

< Update> -Aktualisiert den Wert eines Schlüssels.

<?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> -Ähnlich wie < Addto>, außer dass Sie den Namen des Objekts zum Objektpfad hinzufügen.

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

Der Agent erstellt eine neue Konfiguration im Patchordner und validiert die neue Konfiguration. Wenn die Validierung erfolgreich ist, wird die alte Agentenkonfiguration gesichert. Der Agent verschiebt das Aktualisierungsscript, die alte Datei AgentConfig.xml und die neue Datei AgentConfig.xml in einen Sicherungsordner (patch_xxxx) und setzt die neue Agentenkonfiguration in Betrieb.

Mit WinCollect 10 werden mehrere Beispielaktualisierungsscripts installiert. Sie werden im Verzeichnis \IBM\WinCollect\samples gespeichert.

Beispiele

Wichtig: Diese Scripts sind nur Beispiele. Alle Servicemodule für die Agentenkonfiguration werden unterstützt, damit Sie eigene Scripts erstellen können.

Hinweis: Namen von Aktualisierungsscriptdateien müssen mit update_beginnen. Alle anderen Dateinamen werden ignoriert.

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>

Die folgenden Anwendungsfälle sind Beispiele für die Verwendung von Aktualisierungsscripts zum Ändern von Agentenkonfigurationen: