Cas d'utilisation du script de mise à jour de la configuration de l'agent

Vous pouvez modifier la configuration de l'agent sans apporter de modifications manuelles ou par script au fichier AgentConfig.xml à l'aide de scripts de mise à jour.

Lorsque vous copiez un script de mise à jour dans le répertoire de correctifs WinCollect , l'agent effectue les actions décrites dans votre script.

Mettre à jour les actions de script

Les scripts de mise à jour peuvent inclure les actions suivantes :

<Addto> - Ajoute un enfant au nœud correspondant. Vous pouvez inclure un type et certaines paires clé-valeur définies.

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

<Update> - Met à jour la valeur d'une clé.

<?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> - Similaire à <Addto>, sauf que vous ajoutez le nom de l'objet au chemin de l'objet.

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

L'agent crée une nouvelle configuration dans le dossier de correctifs et la valide. Lorsque la validation aboutit, l'ancienne configuration de agent est sauvegardée. L'agent déplace le script de mise à jour, l'ancien fichier AgentConfig.xml et le nouveau fichier AgentConfig.xml dans un dossier de sauvegarde (patch_xxxx) et met la nouvelle configuration de l'agent en service.

Plusieurs exemples de script de mise à jour sont installés avec WinCollect 10. Ils sont stockés dans le répertoire \IBM\WinCollect\samples.

Exemples

Important: Ces scripts sont uniquement des exemples. Tous les modules de service de configuration d'agent sont pris en charge afin que vous puissiez créer vos propres scripts.

Remarque: les noms de fichier de script de mise à jour doivent commencer par update_. Tous les autres noms de fichier sont ignorés.

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>

Les cas d'utilisation suivants sont des exemples d'utilisation de scripts de mise à jour pour la modification des configurations d'agent :