comando de clsnmp

Editar online

Propósito

O comando AIX clsnmp fornece a função de gerenciador SNMP do shell AIX para consultar os agentes SNMP em busca de informações de gerenciamento de rede.

Sintaxe

clsnmp [ -d DebugLevel ] [ -h TargetHost ] [ -c Community ] [ -t TimeOutValue ] [ -r RetryNumber ] [ -n NonRepeaters ] [ -m MaxRepetitions ] [ -p PortNumber ] [ -v ] [ -f ConfigurationFile ] [ -? ] Função [ MIBVariable [ VariableType ] [ Value ] [ ... ] ]

Descrição

Use o comando clsnmp para emitir solicitações SNMP aos agentes e para processar respostas SNMP retornadas por agentes. Os comandos AIX clsnmp suportam a emissão de solicitações SNMPv1, SNMPv2ce SNMPv3 .

Tipos de solicitação SNMP

findname
Envia uma solicitação para que seja feita uma procura para obter o nome textual de uma determinada entrada MIBVariable, cujo valor ASN.1 interno melhor corresponda ao valor ASN.1 de entrada. A procura primeiro verifica o arquivo /etc/mib.defs e se um nome textual correspondente não for encontrado, continue com o MIB compilado. Apenas um MIBVariable é permitido por clsnmp findname invocação.
obter
Envia uma solicitação para um agente SNMP para uma variável de base de informações de gestão (MIB) específica. clsnmp então espera por uma resposta ou tempos fora.
getbulk
Obtém o valor das variáveis na árvore MIB especificada pelo nome de variável OID ou MIB. Um único getbulk executa a mesma função de uma série de getnexts com menos trocas de dados entre o comando clsnmp e o agente SNMP.
getnext
Envia uma solicitação para um agente do SNMP para a próxima variável MIB que seguir lexicograficamente o MIBVariable especificado. clsnmp então espera por uma resposta ou tempos fora.
configurar
Envia uma solicitação a um agente SNMP para configurar uma variável MIB específica. clsnmp então espera por uma resposta ou tempos fora.
trap
Atende a armadilhas SNMP e exibe informações de trap quando elas ocorrem. Usa a porta padrão e bem conhecida 162 ou o número da porta especificado na opção -p. A função clsnmp trap continua a ouvir por armadilhas até que o processo seja morto ou cancelado.
walk
Emite uma solicitação getnext para um prefixo especificado e, em seguida, continua a emitir solicitações getnext enquanto houver variáveis que correspondam ao prefixo especificado. Um prefixo pode ser qualquer parte inicial do identificador de objeto completo.

Uso

A operação set não é suportada em todos os objetos MIB. A operação set pode ser rejeitada se o agente ou subagentes que gerenciam o objeto MIB não suportar SET.

getbulk é uma função SNMPv2 . Se o agente de destino apenas suporta SNMPv1, o agente de destino ignora o seu pedido. Como resultado, o seu pedido vezes fora.

As palavras-chave da função não são maiúsculas e minúsculas. As bandeiras, nomes de variáveis e valores são sensíveis ao caso.

Para ouvir os traps do NetView SNMP e do AIX clsnmp ao mesmo tempo, use o parâmetro -p PortNumber no comando clsnmp. Apenas um aplicativo de gerenciamento em um endereço IP pode ouvir em uma porta de cada vez. A especificação -p no comando clsnmp trap permite que uma porta diferente da conhecida porta 162 seja usada. Ambas as portas devem ser configuradas como destinos de armadilha do agente.

Um comando clsnmp que não é autenticado (usando um nome de comunidade aceitável ou nome de usuário) dará tempo de fora.

O comando clsnmp usa dois arquivos de configuração: /etc/mib.defs e clsnmp.conf. Os arquivos de amostra são enviados no diretório /usr/samples/snmpdv3

O comando clsnmp suporta o envio dos pedidos SNMPv1, SNMPv2ce SNMPv3 . O arquivo clsnmp usa para determinar se ele deve enviar uma solicitação SNMPv1,SNMPv2c ou SNMPv3 é o arquivo clsnmp.conf . Se o destino especificado por meio do parâmetro -h corresponder a um nome winSNMP no arquivo clsnmp.conf, o clsnmp enviará a solicitação usando os parâmetros especificados na entrada. Se o parâmetro -h não for especificado, a solicitação será enviada como uma SNMPv1request.

Sinalizações

Item Descrição
-c Comunidade Especifica o nome da comunidade usado para acessar as variáveis especificadas no agente do SNMP de destino. Se você não especificar um nome de comunidade, o nome padrão será público. Os nomes de comunidade não são obrigatórios ao usar o modelo de segurança baseado no usuário.
Nota: Os nomes comunitários são sensíveis ao caso.
-d DebugLevel Especifica o nível de depuração. O nível padrão é 0, o que significa sem debug. Quanto maior o nível de debug, maior será o número de mensagens exibidas. Os níveis de debug são 0-4.
-f ConfigurationFile Especifica o caminho completo e o nome do arquivo de configuração.
-h TargetHost Especifica o host de destino para o qual você deseja enviar uma solicitação. O host pode ser um endereço IPv4 , um endereço IPv6 , um nome do host ou um nome winSNMP no arquivo de configuração clsnmp.conf . Se você não especificar um host, o padrão é o seu host local.
-m MaxRepetitions Só se aplica a getbulk. Isso é ignorado se a solicitação de função não for um getbulk. Repetições máximas é o número de sucessores lexicográficos a serem retornados para cada par de ligação variável após os primeiros sucessores "-n number". Por exemplo, começando com o sucessor "-n number" + 1, retorne "-m número" de sucessores para cada par de ligação variável. O padrão é 10.
-n NonRepeaters Só se aplica aos pedidos getbulk . Isso é ignorado se a solicitação de função não for um getbulk. NonRepeaters é o número de pares de ligação de variáveis (nome/valor), começando com o primeiro, para o qual apenas um único sucessor é retornado. O padrão é 0.
-p PortNumber Especifica o número da porta que atende aos traps. Se um número de porta não for especificado, a função clsnmp trap atende na conhecida porta 162, a porta padrão para armadilhas clsnmp .
-r RetryNumber Especifica o número máximo de vezes para tentar novamente o comando se o tempo limite for atingido. O padrão é 2.
-t TimeOutValue Especifica a quantidade de tempo (em segundos) que o comando clsnmp espera por uma resposta do agente SNMP. O padrão é 3.
-v Especifica que a saída de uma solicitação deve ser exibida usando a saída detalhada, por exemplo, utilizando o nome textual em vez do identificador de objeto MIB.
-? Exibe informações de ajuda.

Parâmetros

Item Descrição
Função Especifica a função / operação SNMP a executar, que é uma das seguintes: get, getnext, getbulk, set, walk, trap, findname.
MIBVariable Especifica o objeto Management Information Base (MIB), usando seu descritor de objeto (nome textual), identificador de objeto em notação ASN.1 ou uma combinação dos dois. Quando usado com walk, este é o prefixo do objeto MIB. Um prefixo pode ser qualquer parte inicial do identificador de objeto completo. Quando usado com findname, este é o identificador de objetos em notação ASN.1 .
Valor Especifica o valor a ser configurado pela função SET. Se o espaço em branco for necessário no valor, deve-se enfechar o valor em cotações duplas ("). Se você deseja configurar uma variável para um valor que também é um tipo, você deve especificar o tipo.
VariableType Especifica o tipo de valor que está sendo configurado. Para concluir uma solicitação SNMP SET, o SMI_type deve ser conhecido. Se nenhum tipo for especificado, clsnmp procura primeiro o arquivo /etc/mib.defs e, em seguida, o MIB compilado para determinar o tipo. Se a variável não for localizada, um erro será retornado. Se um VariableType for especificado, VariableType terá precedência sobre qualquer tipo que possa ser designado no MIB. O VariableType e o valor devem ser compatíveis. Por exemplo, se você especificar um tipo de "número" e um valor de "foo," um erro é retornado porque "foo" não é um número. VariableType não faz distinção entre maiúsculas e minúsculas. Os tipos de variáveis válidos são:
  • bitstring
  • contador
  • counter32
  • counter64
  • display ou displaystring
  • gráfico
  • gauge32
  • inteiro
  • integer32
  • ipaddress
  • nsapaddress
  • nulo
  • objectidentifier ou OID
  • octetstring
  • opaco
  • opaqueascii
  • timeticks
  • uinteger

Limitação

Quando o daemon snmpdv3 encontra SMI-v2 tipo de dados MIB enquanto processa um pedido de protocolo SNMPv1 do gerenciador clsnmp , ele pula o MIB até encontrar um MIB de tipo de dados SMI-v1 .

Trabalhar ao redor

O gerenciador clsnmp deve ser configurado com os pedidos do tipo SNMPv2 ou SNMPv3 tipo pedidos para despejar todas as variáveis MIB com o snmpdv3 daemon.

Exemplos

  1. Obtendo a variável MIB.
    1. A seguir solicita o objeto MIB sysName.0:
      clsnmp get sysName.0
      A saída deste comando parece semelhante a:
      1.3.6.1.2.1.1.5.0 = hostname.austin.ibm.com
    2. O seguinte objeto solicita MIB myName.0, em que myName é definido no arquivo /etc/mib.defs para ser o mesmo objeto identificado por sysName.0:
      clsnmp get myName.0
      A saída deste comando parece semelhante a:
      1.3.6.1.2.1.1.5.0 = myhostname.austin.ibm.com
    3. A seguir solicita o objeto MIB sysName.0 através de um endereço IPv6 :
      clsnmp -h 2000:1:1:1:209:6bff:feae:6d67 get sysName.0
      A saída deste comando parece semelhante a:
      1.3.6.1.2.1.1.5.0 = hostname.austin.ibm.com
  2. Obtendo a próxima variável MIB.
    1. A seguir solicita o próximo objeto MIB lógico:
      clsnmp getnext udp
      A saída deste comando parece semelhante a:
      1.3.6.1.2.1.7.1.0 = 653
    2. A seguir solicita o próximo objeto lógico, usando a opção -v para ter valor exibido com nome textual em vez de identificador de objeto:
      clsnmp -v getnext udp
      A saída deste comando parece semelhante a:
      udpInDatagrams.0 = 653
  3. Configurando a variável MIB.
    1. O seguinte configura o objeto MIB sysName.0 para um valor de 'hostname.austin.ibm.com':
      clsnmp set sysName.0  "hostname.austin.ibm.com"
      Este comando produz saída similar a:
      1.3.6.1.2.1.1.5.0 = hostname.austin.ibm.com
    2. O valor do objeto MIB sysName.0 também pode ser configurado usando o parâmetro VariableType para especificar o tipo de valor que está sendo configurado, como no exemplo a seguir:
      clsnmp set sysName.0 displayname "hostname.austin.ibm.com"
      Este comando produz saída similar a:
      1.3.6.1.2.1.1.5.0 = hostname.austin.ibm.com
  4. Andando a árvore MIB.
    O seguinte retorna por nome todos os objetos iniciados com o mesmo prefixo identificador de objeto, mas com menos pacotes de dados a serem trocados entre o comando clsnmp e o agente SNMP:
    clsnmp -h loopback -v -m 10 bulkwalk udp
    A saída deste comando parece semelhante a seguinte:
    clsnmp -v walk udp 
udpInDatagrams.0 = 653 
udpNoPorts.0 = 22 
udpInErrors.0 = 0 
udpOutDatagrams.0 = 678 
udpLocalAddress.0.0.0.0.7 = 0.0.0.0 
udpLocalAddress.0.0.0.0.9 = 0.0.0.0 
udpLocalAddress.0.0.0.0.13 = 0.0.0.0 
udpLocalAddress.0.0.0.0.19 = 0.0.0.0 
udpLocalAddress.0.0.0.0.37 = 0.0.0.0 
udpLocalAddress.0.0.0.0.161 = 0.0.0.0 
udpLocalAddress.0.0.0.0.5020 = 0.0.0.0 
udpLocalPort.0.0.0.0.7 = 7 
udpLocalPort.0.0.0.0.9 = 9 
udpLocalPort.0.0.0.0.13 = 13 
udpLocalPort.0.0.0.0.19 = 19 
udpLocalPort.0.0.0.0.37 = 37 
udpLocalPort.0.0.0.0.161 = 161 
udpLocalPort.0.0.0.0.5020 = 5020
  5. Obtendo várias variáveis MIB.
    A seguir solicita vários objetos MIB usando o tipo de solicitação getbulk . O tipo de solicitação getbulk retorna o próximo objeto lógico para um ou mais objetos MIB listados no comando. No exemplo a seguir, a opção -n indica que apenas um próximo objeto lógico é solicitado para as primeiras duas variáveis (sysLocation e ifTable)... Para todos os outros objetos da lista (tcp, udp e icmp), a opção -m indica que 5 repetições são solicitadas.
    Nota: O tipo de solicitação getbulk é uma função SNMPv2 . O parâmetro -h identifica um host, loopback, definido no arquivo clsnmp.conf como um agente que suporta SNMPv2 ou SNMPv3.
    clsnmp -h loopback -v -n 2 -m 5 getbulk sysLocation ifTable tcp udp icmp
    Esse comando gera uma saída semelhante à seguinte:
    sysLocation.0 = Research Triangle Park, NC 
ifIndex.1 = 1 
tcpRtoAlgorithm.0 = 4 
udpInDatagrams.0 = 782 
icmpInMsgs.0 = 22 
tcpRtoMin.0 = 0 
udpNoPorts.0 = 22 
icmpInErrors.0 = 0 
tcpRtoMax.0 = 120 
udpInErrors.0 = 0 
icmpInDestUnreachs.0 = 22 
tcpMaxConn.0 = -1 
udpOutDatagrams.0 = 807 
icmpInTimeExcds.0 = 0 
tcpActiveOpens.0 = 1 
udpLocalAddress.0.0.0.0.7 = 0.0.0.0 
icmpInParmProbs.0 = 0
  6. Encontrando o nome de uma variável ASN.1 .
    A seguir envia uma solicitação que uma pesquisa seja feita para obter o nome textual, para uma dada entrada MIBVariable , cujo valor interno ASN.1 melhor corresponde ao valor de entrada ASN.1 . A pesquisa começa com o arquivo /etc/mib.defs e, se não for encontrado, continua com o MIB compilado. Apenas um MIBVariable é permitido por clsnmp findname invocação. Por exemplo, isso pode ser feito com um comando semelhante ao seguinte:
    clsnmp findname 1.3.6.1.2.1.6.13.1.2
    Esse comando gera uma saída semelhante à seguinte:
    1.3.6.1.2.1.6.13.1.2 found as: tcpConnLocalAddress
    Um exemplo semelhante é:
    clsnmp findname 1.3.6.1.2.1.6.13.1.2.0
    Esse comando gera uma saída semelhante à seguinte:
    1.3.6.1.2.1.6.13.1.2.0 found as: tcpConnLocalAddress.0
    Outro exemplo semelhante é:
    clsnmp findname 1.3.6.1.2.
    Esse comando gera uma saída semelhante à seguinte:
    1.3.6.1.2. found as: mgmt
  7. Emissão de um pedido SNMPv3 .
    1. Se uma entrada winSnmpName estiver configurada no arquivo /etc/clsnmp.conf no host do gerenciador com uma entrada como a seguinte (tudo em uma linha):
      target1   9.3.149.26 snmpv3 u1 -          - AuthNoPriv   HMAC-SHA
76784e5935acd6033a855df1fac42acb187aa867 -   -
      e na máquina do agente snmpd 9.3.149.26, o usuário u1 está devidamente configurado, então podemos emitir comando no host manager:
      clsnmp -v -h target1 get sysName.0
      Este comando produzirá saída similar a:
      sysName.0 = somehostname.austin.ibm.com
    2. É simples emitir um comando trap, da seguinte forma:
      clsnmp trap
      Nota: Se o modelo de segurança do trap recebido for SNMPv3, certifique-se de que na estação de gerenciamento em que o trap é atendido tenha o arquivo /etc/clsnmp.conf configurado corretamente para receber o trap

Arquivos

Item Descrição
/etc/clsnmp.conf Arquivo de configuração para o comando clsnmp .
/etc/mib.defs Define as variáveis de Base de Informações de Gerenciamento (MIB) que o agente e o gestor SNMP devem reconhecer e tratar.