Comando de lssensor

Propósito

Exibe informações sobre sensores e microsensores que são definidos para o subsistema de monitoramento e controle de recursos (RMC).

Sintaxe

lssensor [-m] [ -a | -n host1[,host2...] | -N { node_file "–" } ] [ -l | -t | -d | -D delimitador ] [-x] [-h] [ -v | -V ] [ -A | sensor_name1 [ sensor_name2…] ]

Descrição

O comando lssensor exibe os atributos de um ou mais sensores. Se você não especificar nenhum parâmetro name , o comando lssensor lista os nomes de todos os sensores. Use a bandeira -A para listar todos os sensores e todos os seus atributos e valores. Use a sinalização -m para exibir informações sobre microsensores.

O comando lssensor exibe valores para atributos que você pode configurar usando um comando de sensor ou um módulo de microsensor, se os atributos forem monitorados. Se os atributos não forem monitorados, lssensor não exibe seus valores. 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. Um módulo de microsensor é um módulo carregável que o gerenciador de recursos do microsensor executa para configurar e atualizar os valores de atributos de um microsensor.

Use as bandeiras -l, -t, -dou -D para exibir a saída em formato longo, formato de tabela ou formato delimitador. A sinalização -x omita títulos quando qualquer uma dessas bandeiras é usada.

O comando lssensor é executado em qualquer nó. Se você deseja que o lssensor seja executado em todos os nós em um domínio, use a bandeira -a . Se você deseja que o lssensor seja executado em um subconjunto de nós em um domínio, use a sinalização -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

Lista 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 houver um domínio de gerenciamento e um domínio de pares, ' lssensor -a com CT_MANAGEMENT_SCOPE não definido será executado no domínio de gerenciamento. Neste caso, para executar no domínio peer, configure CT_MANAGEMENT_SCOPE para 2.

-A

Exibe todos os sensores com seus atributos e valores.

–d

Especifica saída formatada delimitador. O delimitador padrão é um colon (:). Use a sinalização -D se você quiser alterar o delimitador padrão.

-D delimiter

Especifica saída delimitadora-formatada que usa o delimitador especificado. Use esta sinalização para especificar algo diferente do cólon padrão (:). Um exemplo é quando os dados a serem exibidos contêm colons. Use esta sinalização para especificar um delimitador de um ou mais caracteres.

–l

Especifica que as informações sejam exibidas em formato "longo". Cada atributo é exibido em uma linha separada.

-m

Especifica que informações sobre microsensores serão exibidas.

--n host1[,host2...]

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

--N {node_file |"-"}

Especifica que nomes de nós são lidos a partir de um arquivo ou de entrada padrão. Use -N node_file para indicar que os nomes do nó estão em um arquivo.

• Há um nome de nó por linha em node_file
• Um sinal de número (#) na coluna 1 indica que a linha é um comentário
• Quaisquer caracteres em branco à esquerda de um nome de nó são ignorados
• Quaisquer caracteres à direita de um nome de nó são ignorados

Use -N "-"-" em um domínio de gerenciamento ou um domínio peer para ler os nomes de nós da entrada padrão.

–t

Especifica formato de tabela. Cada atributo é exibido em uma coluna separada, com um recurso de sensor por linha.

-x

Suprime a impressão de cabeçalho quando -l, -t, -dou -D é especificado.

-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

sensor_name1 [ nome_do_sensor2...]

Especifica os nomes de um ou mais sensores a serem exibidos.

Segurança

Para exibir informações do sensor usando este comando, você precisa de permissão de leitura para a classe de recursos IBM®.Sensor . Para exibir informações do microsensor usando esse comando, você precisa de permissão de leitura para o IBM.MicroSensor do MicroSensor As permissões são especificadas no arquivo de lista de controle de acesso (ACL) no sistema contatado. Veja o guia Administrando RSCT 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

1. Para listar os nomes de todos os sensores, digite:

   lssensor

   A saída vai ficar assim:

   sensor1
   sensor2
   sensor3

2. Para listar os nomes e atributos de todos os sensores, digite:

   lssensor -A

   A saída vai ficar assim:

    Name = sensor1
    ActivePeerDomain =
    Command = /usr/local/bin/sensorcmd1
    ConfigChanged = 0
    ControlFlags = 1
    Description =
    ErrorExitValue = 1
    ExitValue = 0
    Float32 = 1.06381e+06
    Float64 = 1.06381e+06
    Int32 = 1063814
    Int64 = 1063814
    NodeNameList = {somenode.pok.ibm.com}
    RefreshInterval = 60
    SavedData = Last SavedData
    SD = [string from sensor1,1063814,1063814,1063814,1063814,1.06381e+06,1.06381e+06]
    String = string from sensor1
    Uint32 = 1063814
    Uint64 = 1063814
    UserName = root
   -------------------
    Name = CFMRootModTime
    ActivePeerDomain =
    Command = /opt/csm/csmbin/mtime/cfmroot
    ConfigChanged = 0
    ControlFlags = 0
    Description =
    ErrorExitValue = 1
    ExitValue = 0
    Float32 = 0
    Float64 = 0
    Int32 = 0
    Int64 = 0
    NodeNameList = {somenode.pok.ibm.com}
    RefreshInterval = 60
    SavedData =
    SD = [,0,0,0,0,0,0]
    String =
    Uint32 = 0
    Uint64 = 0
    UserName = root
   -------------------
    Name = ErrorLogSensor
    ActivePeerDomain =
    Command = /opt/csm/csmbin/monerrorlog
    ConfigChanged = 0
    ControlFlags = 0
    Description =
    ErrorExitValue = 1
    ExitValue = 0
    Float32 = 0
    Float64 = 0
    Int32 = 0
    Int64 = 0
    NodeNameList = {somenode.pok.ibm.com}
    RefreshInterval = 60
    SavedData =
    SD = [,0,0,0,0,0,0]
    String =
    Uint32 = 0
    Uint64 = 0
    UserName = root
   -------------------
   .
   .
   .

3. Para listar os atributos de sensor2, digite:

   lssensor sensor2

   A saída vai ficar assim:

   Name = sensor2
   Command = /usr/local/bin/sensorcmd2
   ConfigChanged = 0
   ControlFlags = 0 
   Description =
   ErrorExitValue = 1
   ExitValue = 127
   Float32 = 0
   Float64 = 0
   Int32 = 0
   Int64 = 0
   NodeNameList = {somenode.pok.ibm.com}
   RefreshInterval = 60
   SavedData = 
   SD = [,0,0,0,0,0,0] 
   String =
   Uint32 = 0
   Uint64 = 0
   UserName = root

4. Para listar todas as informações dos sensores usando saída delimitada, digite:

   lssensor -dA

   A saída vai ficar assim:

   Displaying sensor information:
   Name:ActivePeerDomain:Command:ConfigChanged:ControlFlags:Description:ErrorExitValue:ErrorMessage:ExitValue:
   Float32:Float64:Int32:Int64:MonitorStatus:NodeNameList:RefreshInterval:SD:SavedData:
   String:TimeCommandRun:Uint32:Uint64:UserName:
   JoeExample:JoeDomain:cat /etc/motd:0:0::1::0:
   ::::0:{node1.myhost.com}:60:[,0,0,0,0,0,0]::
   :Fri Feb  6 19:00:00 2009:::root:
   JoeSample:JoeDomain:/opt/rsct/install/bin/ctversion:0:0::1::0:
   ::::0:{node1.myhost.com}:60:[,0,0,0,0,0,0]::
   :Fri Feb  6 19:00:00 2009:::root:
   JoeSens:JoeDomain:/tmp/sensor/numusers:0:1::1::0:
   ::::0:{node1.myhost.com}:0:[,2,0,0,0,0,0]::
   :Tue Mar  3 10:27:19 2009:::root:                  

5. Para listar os nomes de todos os sensores nos nós que estão listados no arquivo /u/joe/common_nodes , digite:

   lssensor -N /u/joe/common_nodes

   onde /u/joe/common_nodes contém:

   # common node file
   #
   node1.myhost.com    main node
   node2.myhost.com    backup node    

   A saída vai ficar assim:

   sensor1
   sensor2
   sensor3

6. Para listar os nomes de todos os microsensores, digite:

   lssensor -m

   A saída vai ficar assim:

   IBM.MSensor1
   IBM.MSensor2
   IBM.MSensor3

7. Para listar os atributos do microsensor IBM.MSensor2, digite:

   lssensor -m IBM.MSensor2

   A saída vai ficar assim:

   Name = IBM.MSensor2
   ActivePeerDomain = 
   Arguments = all
   ConfigChanged = 0
   CustomDynamicAttributes = {[CDA1,19,1,3,0,1],[CDA2,20,2,2,0,1],[CDA3,21,3,2,0,1] 
   Description =  
   Float32 =
   Float32Array =
   Float64 =	
   Float64Array =
   Int32 = 52
   Int32Array = {36, 45, 2, 73}
   Int64 =
   Int64Array =
   LastQueryRC = 0 
   LastQueryTime = Tue Mar 31 18:00:00 2009 
   ModuleName = /usr/slib/msensors/sensor2
   MonitorStatus = 0 
   NodeNameList = {node2.gumby.com}
   RefreshInterval = 600    
   String =
   StringArray =
   UInt32 =
   UInt32Array =
   UInt64 =
   UInt64Array =

Local

/opt/rsct/bin/lssensor