comando de chsensor

Propósito

Altera os atributos de um sensor de monitoramento e controle de recursos (RMC).

Sintaxe

chsensor [-m[-i segundos] [ -a | -n host1 [ , host2 , … ] | -N { node_file | "- " } ] [-h] [ -v │ -V ] nome_do_sensor attr1=valor1 [ attr2=valor2...]

Descrição

O comando chsensor altera os atributos de um sensor de monitoramento e controle de recursos (RMC). Use o parâmetro sensor_name para especificar qual sensor você está alterando.

O comando chsensor é executado em qualquer nó. Se você deseja que chsensor seja executado em todos os nós em um domínio, use a bandeira -a . Se você deseja que chsensor seja executado em um subconjunto de nós em um domínio, use a bandeira -n . Em vez de especificar vários nomes de nós usando a sinalização -n , você pode usar a sinalização -N node_file para indicar que os nomes do nó estão em um arquivo. Use -N "-" para ler os nomes de nós da entrada padrão.

Se o Cluster Systems Management (CSM) estiver instalado em seu sistema, você poderá utilizar grupos de nós definidos do CSM como valores de nome do nó para referir-se a mais de um nó. Para obter informações sobre como trabalhar com grupos de nós CSM e usar o comando CSM nodegrp , consulte o CSM: Guia de Administração e o CSM: Command and Technical Reference.

Sinalizações

-a

Altera sensores que correspondem ao nome especificado em todos os nós do domínio. A variável de ambiente CT_MANAGEMENT_SCOPE determina o escopo do cluster. Se CT_MANAGEMENT_SCOPE não for configurado, primeiro o escopo de domínio de gerenciamento será escolhido se ele existir, então o escopo de domínio de ponto será escolhido se ele existir e, então, o escopo local será escolhido, até que o escopo seja válido para o comando. O comando será executado uma vez para o primeiro escopo válido encontrado. Por exemplo, se ambos um domínio de gerenciamento e um domínio de mesmo nível existirem, chsensor -a com CT_MANAGEMENT_SCOPE não configurado será executado no domínio de gerenciamento. Neste caso, para executar no domínio peer, configure CT_MANAGEMENT_SCOPE para 2.

--i segundos

Especifica o intervalo em que o comando do sensor é executado para atualizar os valores dos atributos do sensor. segundos é um valor inteiro e deve ser maior ou igual a 10. O comando do sensor é executado no intervalo especificado apenas quando um recurso de sensor é monitorado. Se o intervalo for configurado como 0, o comando do sensor não será executado automaticamente. O uso do comando refsensor é independente de atualizações de intervalos.

-m

Especifica que o recurso a ser alterado é um recurso de microsensor.

--n host1[,host2...]

Especifica o nó no qual o sensor deve ser alterado. Por padrão, o sensor é alterado no nó local. Esta sinalização é apropriada apenas em um domínio de gerenciamento ou um domínio de ponto.

--N {node_file |"-"}

Especifica um arquivo ou entrada padrão listando os nós sobre os quais o sensor deve ser removido. Esta sinalização é apropriada apenas em um Cluster Systems Management (CSM) ou um cluster de domínio de pares.

-h

Grava a instrução de uso do comando para saída padrão.

-v │ -V

Grava as mensagens verbosas do comando para a saída padrão.

Parâmetros

nome_do_sensor

Especifica o nome do sensor a alterar.

attr1 = valor1 [ attr2 = valor2 ...]

Especifica um ou mais atributos de sensor ou de microsensor e os seus novos valores.

Você pode alterar os valores desses atributos do sensor:

Nome

Especifica o novo nome do sensor. Se o novo nome for uma string que contenha espaços ou caracteres especiais, ele deverá ser enfechado entre aspas.

ControlFlags

Especifica se o manuseio especial é necessário para este sensor. Você pode especificar qualquer combinação desses valores:

0

Indica que não é necessária nenhuma manipulação especial. Esse é o padrão.

O comando do sensor é executado no intervalo que é definido para sensor_name. O comando sensor não é executado quando o monitoramento começa ou quando o comando lssensor é executado. Um comando sensor é um comando ou script que o gerenciador de recursos do sensor executa para configurar e atualizar os valores de atributos de um sensor.

1

Indica que o comando do sensor é executado quando o monitoramento começa. O comando do sensor também é executado no intervalo que é definido para sensor_name. O comando do sensor não é executado quando o comando lssensor é executado.

Especificar este valor não é recomendado, a menos que você espere que o comando do sensor seja executado rapidamente. Se o comando do sensor não for executado rapidamente, ele poderia bloquear outras solicitações para o gerenciador de recursos do sensor. Essas solicitações não são processadas até que o comando do sensor finalize a execução.

2

Indica que a saída do comando no campo SavedData não é salva permanentemente para SavedData atributos persistentes de recursos. Se este valor não for especificado, o gerenciador de recursos do sensor atualiza dados na tabela de recursos do registro sempre que a saída padrão do comando contém a linha: SavedData="any-string".

3

Indica uma combinação de valores 1 e 2

4

Indica que o gerenciador de recursos do sensor executa o comando após o monitoramento ser interrompido.

5

Indica uma combinação de valores 1 e 4.

6

Indica uma combinação de valores 2 e 4.

7

Indica uma combinação de valores 1, 2e 4.

8

Indica que o gerenciador de recursos do sensor reconfigura os valores de atributos dinâmicos após o monitoramento ser interrompido.

UserName

Especifica o nome de um usuário cujos privilégios são usados para executar o comando. O usuário já deve estar definido no sistema.

Descrição

Fornece uma descrição do sensor e o que ele está monitorando.

ErrorExitValue

Especifica quais valores de saída são interpretados como erros, da seguinte forma:

0

Nenhum valores de saída são interpretados como erros.

1

Os valores de saída diferentes de 0 são interpretados como erros.

2

Um valor de saída de 0 é interpretado como um erro.

Se o valor de saída indicar um erro como especificado por este atributo, nenhum valor de atributo dinâmico (exceto ExitValue) são atualizados.

Você pode alterar os valores desses atributos de microsensor:

Nome

Especifica o novo nome do microsensor. Se o novo nome for uma string que contenha espaços ou caracteres especiais, ele deverá ser enfechado entre aspas.

Descrição

Fornece uma descrição do microsensor e o que ele está monitorando.

Segurança

O usuário precisa de permissão de gravação para a classe de recursos IBM.Sensor a fim de executar chsensor. As permissões são especificadas no arquivo de lista de controle de acesso (ACL) no sistema contatado. Veja o RSCT: Guia de Administração para obter detalhes sobre o arquivo ACL e como modificá-lo.

Status de saída

0

O comando foi executado com sucesso.

1

Uma combinação incorreta de sinalizadores e parâmetros foi inserida.

6

Nenhum recurso de sensor foi encontrado.

n

Com base em outros erros que podem ser retornados pelo subsistema RMC.

Variáveis de ambiente

CT_CONTACT

Quando a variável de ambiente CT_CONTACT é configurada para um nome de host ou endereço IP, o comando entra em contato com o daemon de monitoramento e controle de recursos (RMC) no host especificado. Se esta variável de ambiente não for definida, o comando entra em contato com o daemon RMC no sistema local onde o comando está sendo executado. A classe de recursos ou recursos que são exibidos ou modificados pelo comando estão localizados no sistema para o qual a conexão é estabelecida.

CT_IP_AUTHENT

Quando a variável de ambiente CT_IP_AUTHENT existe, o daemon RMC usa autenticação de rede baseada em IP para entrar em contato com o daemon RMC no sistema que é especificado pelo endereço IP ao qual a variável de ambiente CT_CONTACT está configurada. CT_IP_AUTHENT só tem significado se CT_CONTACT for configurado para um endereço IP; ele não depende do serviço de DNS (domain name system).

CT_MANAGEMENT_SCOPE

Determina o escopo de gerenciamento que é usado para a sessão com o daemon RMC para monitorar e controlar os recursos e classes de recursos. O escopo de gerenciamento determina o conjunto de nós de destino possíveis onde os recursos e as classes de recursos podem ser monitorados e controlados.

Os valores válidos são os seguintes:

0

Especifica o escopo local .

1

Especifica o escopo local .

2

Especifica o escopo domínio peer .

3

Especifica o escopo domínio de gerenciamento .

Se esta variável de ambiente for not set, o escopo local é usado.

Especificações de implementação

Esse comando faz parte do conjunto de arquivos RSCT ( Reliable Scalable Cluster Technology ) para AIX.

Exemplos

Local

/opt/rsct/bin/chsensor