Casos de uso del script de actualización de configuración del agente

Puede cambiar la configuración del agente sin realizar ediciones manuales o con scripts en el archivo AgentConfig.xml utilizando scripts de actualización.

Cuando copia un script de actualización en el directorio de parches de WinCollect , el agente realiza las acciones que se describen en el script.

Actualizar acciones de script

Los scripts de actualización pueden incluir las acciones siguientes:

< Addto> -Añade un hijo al nodo relevante. Puede incluir un tipo y determinados pares de clave-valor definidos.

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

< Update> -Actualiza el valor de una clave.

<?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> -Similar a < Addto>, excepto que añade el nombre del objeto a la vía de acceso del objeto.

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

El agente crea una nueva configuración en la carpeta de parches y valida la nueva configuración. Cuando la validación se realiza correctamente, se realiza una copia de seguridad de la configuración de agente antigua. El agente mueve el script de actualización, el archivo AgentConfig.xml antiguo y el nuevo archivo AgentConfig.xml a una carpeta de copia de seguridad (patch_xxxx) y pone en funcionamiento la nueva configuración del agente.

Se instalan varios scripts de actualización de ejemplo con WinCollect 10. Se almacenan en el directorio \IBM\WinCollect\samples .

Ejemplos

Importante: Estos scripts son sólo ejemplos. Todos los módulos de servicio de configuración de agente están soportados para que pueda crear sus propios scripts.

Nota: Los nombres de archivo de script de actualización deben empezar por update_. Todos los demás nombres de archivo se ignoran.

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>

Los siguientes casos de uso son ejemplos de cómo puede utilizar scripts de actualización para cambiar configuraciones de agente: