Casos de uso do script de atualização de configuração do agente

É possível mudar a configuração do agente sem fazer edições manuais ou com scrip no arquivo AgentConfig.xml usando scripts de atualização.

Quando você copia um script de atualização para o diretório de correção WinCollect , o Agente executa as ações descritas em seu script.

Atualizar ações de script

Os scripts de atualização podem incluir as seguintes ações:

<Addto> - inclui um filho no nó relevante. É possível incluir um tipo e determinados pares de valores de chave 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> - atualiza o valor de uma chave.

<?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> - semelhante ao <Addto>, exceto que você inclui o nome do objeto no Caminho do objeto.

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

O agente cria uma nova configuração na pasta de correção e valida a nova configuração. Quando a validação é bem-sucedida, a configuração antiga do agente é submetida a backup. O agente move o script de atualização, o arquivo AgentConfig.xml antigo e o novo arquivo AgentConfig.xml para uma pasta de backup (patch_xxxx) e coloca a nova configuração do agente em operação.

Vários scripts de atualização de amostra são instalados com WinCollect 10. Eles são armazenados no diretório \IBM\WinCollect\samples.

Exemplos

Importante: Esses scripts são exemplos apenas. Todos os módulos de serviço de configuração do agente são suportados para que você possa criar seus próprios scripts.

Nota: Atualizar nomes de arquivos de script deve começar com update_. Todos os outros nomes de arquivos são ignorados.

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>

Os casos de uso a seguir são exemplos de como você pode usar scripts de atualização para mudar configurações do agente: