Este é o comando cfgmaker que pode ser executado no provedor de hospedagem gratuita OnWorks usando uma de nossas várias estações de trabalho online gratuitas, como Ubuntu Online, Fedora Online, emulador online do Windows ou emulador online do MAC OS
PROGRAMA:
NOME
cfgmaker - Cria arquivos mrtg.cfg (para mrtg-2.17.4)
SINOPSE
cfgmaker [opções] [comunidade @] roteador [[opções] [comunidade @] roteador ...]
OPÇÕES
--ifref = nome das referências da interface por nome da interface (padrão)
--ifref = ip ... por endereço IP
--ifref = eth ... por número Ethernet
--ifref = descr ... por descrição de interface
--ifref = nr ... por número de interface
--ifref = tipo ... por tipo de interface
Você também pode usar várias opções separadas por vírgulas,
nesse caso, o primeiro disponível é usado:
por exemplo --ifref = ip, nome, nr
--ifdesc = nr a descrição da interface usa o número da interface (padrão)
--ifdesc = ip ... usa endereço IP
--ifdesc = eth ... usa número Ethernet
--ifdesc = descr ... usa a descrição da interface
--ifdesc = nome ... usa o nome da interface
--ifdesc = catname ... usa o nome da interface CatOS
--ifdesc = ppname ... usa o nome da porta do passaporte
--ifdesc = alias ... usa Interface Alias
--ifdesc = type ... usa o tipo de interface
Você também pode usar várias opções separadas por vírgulas,
nesse caso, o primeiro disponível é usado:
por exemplo --ifdesc = catname, ppname, descr, alias, ip, nome, nr
--if-filter = f Teste cada interface em relação ao filtro f para decidir se
ou não incluir essa interface na coleção.
Atualmente f está sendo avaliado como uma expressão Perl
e seu valor de verdade é usado para rejeitar ou aceitar o
interface.
(Experimental, em desenvolvimento, pode mudar)
--if-template = templatefile
Substitua as entradas de destino normais para as interfaces
com uma entrada conforme especificado pelo conteúdo do arquivo
templatefile. O arquivo deve conter Perl
código a ser executado para gerar as linhas para o
destino no arquivo de configuração.
(Experimental, em desenvolvimento, pode mudar)
--host-template = templatefile
Além de criar destinos para as interfaces de um host
também cria destinos para o próprio host conforme especificado
pelo conteúdo do arquivo templatefile. O arquivo é
deveria conter código Perl a ser executado para gerar
as linhas para os destinos relacionados ao host (como CPU,
medições de tempo de resposta de ping, etc.) na configuração
arquivo de uração.
(Experimental, em desenvolvimento, pode mudar)
--global "x: a" adiciona entradas de configuração global
--no-down não olha para o status admin ou opr das interfaces
--show-op-down mostra as interfaces que estão operativamente inativas
--zero-speed = spd usa esta velocidade em bits por segundo como a interface
velocidade para todas as interfaces que retornam uma velocidade de 0
via ifSpeed / ifHighSpeed. 100 Mbps = 100000000
--subdirs = format dá a cada roteador seu próprio subdiretório, nomeando cada um por
"formato", no qual HOSTNAME e SNMPNAME serão
substituídos pelos valores desses itens - por exemplo,
--subdirs = HOSTNAME ou --subdirs = "HOSTNAME (SNMPNAME)"
--noreversedns não inverte a pesquisa de números IP
--community = cmty Defina a string de comunidade padrão para "cmty" em vez de
"público".
--enable-ipv6 Ativa o suporte IPv6, se as bibliotecas necessárias forem
presente. Os endereços IPv6 numéricos devem ser incluídos
entre colchetes, por exemplo, public @ [2001: 760: 4 :: 1]: 161
--use-16bit Usa IDs de solicitação SNMP de 16 bits para consultar todos os roteadores.
--snmp-options =: [ ] [: [ ] [: [ ] [: [ ] [: ]]]]
Especifique as opções SNMP padrão a serem anexadas a todos
roteadores seguindo. Os campos individuais podem estar vazios.
Os roteadores a seguir podem substituir alguns ou todos os
opções fornecidas para --snmp-options.
--dns-domain = domínio
Especifica um domínio para anexar ao nome de todos
roteadores seguindo.
--nointerfaces Não gera nenhuma linha de configuração para interfaces,
pule a etapa de coleta de informações de interface e
não execute nenhum código de modelo de interface.
--interfaces Gera linhas de configuração para interfaces (este é o
predefinição). O principal objetivo desta opção é negar
um --nointerfaces aparecendo anteriormente na linha de comando.
--help breve mensagem de ajuda
- documentação completa do homem
--version imprime a versão do cfgmaker
--output = o padrão do nome do arquivo de saída do arquivo é STDOUT
DESCRIÇÃO
Cfgmaker cria arquivos de configuração MRTG com base nas informações obtidas de um roteador ou
outro dispositivo SNMP gerenciável.
[comunidade@]roteador
Comunidade é o nome da comunidade do dispositivo para o qual você deseja criar uma configuração. Se
não especificado, o padrão é 'público'; você pode querer tentar isto primeiro, se você não
saber o nome da comunidade de um dispositivo. Se você estiver usando o nome de comunidade errado, você
não obtenha resposta do dispositivo.
router é o nome DNS ou o número IP de um dispositivo gerenciável por SNMP. Seguindo o nome
você pode especificar mais 6 opções separadas por dois pontos. A sintaxe completa é semelhante a esta:
roteador[: [pronto] [: [tmout] [: [retr] [: [saia de perto] [:vers]]]]]
De especial interesse pode ser o último parâmetro, vers. Se você definir isso para '2', então o seu
dispositivo será consultado com solicitações SNMP versão 2. Isso permite que você pesquise os 64 bits
contadores de tráfego no dispositivo e, portanto, funcionarão muito melhor com interfaces rápidas (não
mais saturação do contador). Observe que a ordem em que os roteadores são especificados no
a linha de comando é importante, pois a mesma ordem é usada quando o arquivo de configuração é gerado.
O primeiro roteador especificado tem suas linhas de configuração geradas primeiro, seguidas pelo
linhas pertencentes ao próximo roteador e assim por diante.
Observe que a primeira linha do arquivo cfg gerado conterá todas as linhas de comando
opções que você usou para gerá-lo. Isso é para permitir a fácil 'regeneração' no caso
você deseja adicionar newhosts ou fazer alguma outra mudança global.
Configuração
Exceto para o --resultado e --global opções, todas as opções afetam apenas os roteadores
seguindo-os na linha de comando. Se uma opção especificada anteriormente na linha de comando
reaparece mais tarde na linha de comando com outro valor, o novo valor substitui o antigo
valor no que diz respeito aos demais roteadores. Desta forma, as opções podem ser personalizadas para
grupos de roteadores ou para roteadores individuais.
See --resultado e --global para saber como seu comportamento é afetado por onde ou quantas vezes
eles aparecem na linha de comando.
veja a Exemplos abaixo sobre como definir uma opção diferente para vários roteadores.
--Socorro
Imprima uma breve mensagem de ajuda e saia.
--cara
Imprime a página do manual e sai.
--versão
Imprima a versão do cfgmaker. Deve corresponder à versão do MRTG para a qual config
arquivos estão sendo criados.
--ifref nr|ip|eth|descrição|nome
Selecione o método de identificação da interface. O padrão é nr que identifica o roteador
interfaces por seu número. Infelizmente, o esquema de numeração de interface em um SNMP
a árvore pode mudar. Alguns roteadores mudam sua numeração quando novas interfaces são adicionadas,
outros mudam sua numeração a cada lua cheia apenas por diversão.
Para contornar este triste problema, o MRTG pode identificar interfaces por 4 outras propriedades.
Nada disso funciona para todas as interfaces, mas você deve ser capaz de encontrar uma que funcione
bem para você. Observe que especialmente os endereços de ethernet podem ser problemáticos, pois alguns
os roteadores têm o mesmo endereço Ethernet na maioria de suas placas de interface.
Selecionar ip para identificar a interface por seu número de IP. Usar eth usar a ethernet
endereço para identificação. Usar descrição para usar a descrição da interface. Ou use nome para
use o nome da interface.
Você pode especificar várias propriedades, se desejar, separadas por vírgulas. Nesse caso,
O cfgmaker usará o primeiro item da lista, que pode fornecer uma identificação única.
Isso permite que você especifique, por exemplo, para usar o endereço IP e usar ifName se este
não está definido:
--ifref ip, nome
Se o método escolhido não permitir a identificação única da interface no dispositivo, você
estão questionando, cfgmaker vai te contar sobre isso.
--ifdesc nr|ip|eth|descrição|nome|tipo|aliás
Selecione o que usar como descrição da interface. A descrição aparece em
a propriedade "Title []" para o destino, bem como o cabeçalho do texto no código HTML
definido no "PageTop []" do destino. O padrão é usar nr que é apenas a interface
número que nem sempre é útil para o visualizador dos gráficos.
Existem 6 outras propriedades que podem ser utilizadas. Usar ip se você quiser usar o
endereço IP da interface. Usar eth se você quiser usar o endereço Ethernet da interface.
Se você quiser uma descrição melhor, você pode usar qualquer descrição, nome or aliás. Exatamente
o que cada um deles faz varia entre os diferentes equipamentos, então você pode precisar
experimentar. Por exemplo, para uma interface serial em um roteador Cisco executando IOS usando
nome pode resultar em "S0" sendo a descrição da interface, descrição pode resultar em
"Serial0" e aliás pode resultar em "Link para HQ" (desde que seja o que é usado como o
"descrição" da interface na configuração do roteador).
Finalmente, se você quiser descrever a interface por seu Btype (ou seja, "ethernetCSMA",
"propPointtoPoint" etc) você pode usar tipo.
Você pode especificar várias propriedades, se desejar, separadas por vírgulas. Nesse caso,
O cfgmaker usará o primeiro item da lista disponível para esta interface.
Isso permite que você especifique, por exemplo, o uso de qualquer um dos diferentes aliases em ordem
de preferência.
--if-filtro 'expressão-filtro'
Em primeiro lugar, isso está em desenvolvimento e é experimental.
Use isto se você quiser ter um melhor controle sobre quais interfaces são incluídas
a configuração. o expressão-filtro é avaliado como um pedaço de código Perl e é
espera-se que retorne um valor verdadeiro. Se verdadeiro, inclui a interface e se falso,
excluir a interface.
Para uma discussão mais aprofundada sobre como esses filtros funcionam, consulte a seção "Detalhes sobre
Filtros "abaixo.
--if-modelo arquivo-modelo
Em primeiro lugar, isso está em desenvolvimento e é experimental.
Use isto se você deseja controlar como a linha de cada alvo deve se parecer no
arquivo de configuração. O conteúdo do arquivo arquivo-modelo será avaliado como um
Programa Perl que gera as linhas usando certas variáveis para entrada e saída.
Para uma discussão mais aprofundada sobre como esses modelos funcionam, consulte a seção "Detalhes sobre
Temaplates "abaixo.
--host-modelo arquivo-modelo
Em primeiro lugar, isso está em desenvolvimento e é experimental.
Use isto se você quiser ter alguns alvos extras relacionados ao próprio host, como CPU
utilização, tempo de resposta do ping para o host, número de modems ocupados, etc. O conteúdo
do arquivo arquivo-modelo será avaliado uma vez por host como um programa Perl que
gera as linhas usando certas variáveis para entrada e saída.
Para uma discussão mais aprofundada sobre como esses modelos funcionam, consulte a seção "Detalhes sobre
Modelos "abaixo.
--comunidade cadeia de comunidade
Use isso para definir a comunidade para os roteadores que seguem a linha de comando para
cadeia de comunidade. Roteadores individuais podem substituir esta string de comunidade usando
a sintaxe comunidade @ roteador.
--enable-ipv6
Esta opção ativa o suporte IPv6. Requer os módulos perl apropriados; se eles
não forem encontrados, então o IPv6 está desabilitado (consulte a documentação do ipv6).
O cfgmaker usará IPv6 ou IPv4 dependendo do destino. Se a meta for numérica
endereço, o protocolo depende do tipo de endereço. Se o destino for um nome de host,
O cfgmaker tentará resolver o nome primeiro para um endereço IPv6 e depois para um IPv4
endereço.
Os endereços numéricos IPv6 devem ser especificados entre colchetes.
Por exemplo:
cfgmaker --enable-ipv6 [2001:760:4::1]:165:::2
Se o destino tiver um endereço IPv6 e um endereço IPv4 com o mesmo nome de host,
O cfgmaker primeiro consulta o destino usando IPv6 e retorna ao IPv4 se falhar. Esse
é útil para destinos que não oferecem suporte a SNMP sobre IPv6.
--use-16 bits
Esta opção força o uso de IDs de solicitação SNMP de 16 bits. Alguns agentes SNMP corrompidos não
aceitar IDs de solicitação de 32 bits. Tente evitar esta opção tanto quanto possível, reclame
seu fornecedor de agente em vez disso.
--snmp-opções :[porta] [: [tempo limite] [: [novas tentativas] [: [saia de perto] [:versão]]]]
Use isto para definir as opções SNMP padrão para todos os roteadores seguindo o comando
linha. Os valores individuais podem ser omitidos, bem como dois pontos finais. Observe que
roteadores podem substituir valores individuais (ou todos) especificados por --snmp-opções usando
a sintaxe
roteador[: [porta] [: [tempo limite] [: [novas tentativas] [: [saia de perto] [:versão]]]]]
--global "blá: abc"
Use isso para adicionar opções globais ao arquivo de configuração gerado. Você pode ligar --global
várias vezes para adicionar várias opções. A linha aparecerá na configuração apenas
antes da configuração do próximo roteador aparecer na linha de comando.
--global "workdir: / home / mrtg"
Se você quiser algumas opções padrão, você pode querer colocar
--global "opções [_]: growright, bits"
Especificando --global após o último roteador na linha de comando criará uma linha em
o arquivo de configuração que aparecerá após todos os roteadores.
--norversedns
Não tente inverter os números de IP de pesquisa ... uma obrigação para ambientes sem DNS.
--sem baixo
Normalmente, o cfgmaker não inclui interfaces que são marcadas com qualquer coisa, exceto
UP administrativamente e operacionalmente. Com esta opção, você obtém todos eles.
- show-op-down
Inclui interfaces que estão operacionalmente inativas.
- velocidade zero velocidade
Atribua essa velocidade em bits por segundo a todas as interfaces que retornam 0 para ifSpeed e
ifHighSpeed. Alguns interruptores, especialmente equipamentos de fundição, retornam uma velocidade de zero para
algumas interfaces. Por exemplo, para ter todas as interfaces com relatório de zero definido para 100 Mbps,
use --zero-speed = 100000000.
--subdiretórios formato
Dê a cada roteador seu próprio subdiretório para os arquivos HTML e gráficos (ou .rrd). o
o nome do diretório é o dado formato string com algumas substituições de padrão. o
string "HOSTNAME" será substituído pelo nome do host do roteador (no entanto, você
especificou no cfgmaker linha de comando - pode ser um nome de host real ou apenas um IP
endereço), e "SNMPNAME" será substituído pela ideia do dispositivo de seu próprio nome (o
mesmo nome que aparece no lado direito das linhas de "Título"). Por exemplo, uma ligação
gostar:
cfgmaker --subdirs = HOSTNAME__SNMPNAME [email protegido]
resultaria na geração de linhas parecidas com:
Directory[10.10.0.18_1]: 10.10.0.18__fp2200-bothrip-1.3
--resultado lima
Escreva a saída de cfgmaker no arquivo lima. O padrão é usar "STDOUT".
--resultado espera-se que apareça apenas uma vez na linha de comando. Se usado várias vezes,
o arquivo especificado pelo último --resultado será usada.
--nointerfaces
Não gere linhas de configuração para interfaces.
Isso faz com que o cfgmaker pule todas as etapas relacionadas às interfaces, o que significa que não fará
qualquer pesquisa do roteador para recuperar informações da interface que acelera o
execução do cfgmaker e não executará nenhum modelo de interface.
--interfaces
Isso faz com que o cfgmaker gere linhas de configuração para interfaces (o padrão
comportamento).
O principal uso desta opção é negar um --nointerfaces que aparece anteriormente no
linha de comando.
SNMP V3 Opções
Cfgmaker suporta SNMP V3 usando o Rede: SNMP módulo perl. Existem parâmetros opcionais
afetando a operação SNMP.
--enablesnmpv3 {sim | não}
A --enablesnmpv3 opção é um sinalizador opcional para verificar a presença do
Net :: SNMP bibliotecas. Cfgmaker tentará determinar se este sinalizador é necessário e
irá definir os valores automaticamente.
SNMPV3 Argumentos
Um contexto SNMP é uma coleção de informações de gerenciamento acessíveis por uma entidade SNMP. Um
item de informações de gerenciamento pode existir em mais de um contexto e uma entidade SNMP
potencialmente tem acesso a muitos contextos. A combinação de um contextEngineID e um
contextName identifica inequivocamente um contexto dentro de um domínio administrativo. Em um
A mensagem SNMPv3, o contextEngineID e o contextName são incluídos como parte do scopedPDU.
Todos os métodos que geram uma mensagem SNMP opcionalmente aceitam um --contextengineid e
--contextname argumento para configurar esses campos.
ID do mecanismo de contexto
A --contextengineid argumento espera uma string hexadecimal que representa o desejado
contextEngineID. A string deve ter de 10 a 64 caracteres (5 a 32 octetos) e pode
ser prefixado com um "0x" opcional. Uma vez o --contextengineid é especificado que permanece
com o objeto até que seja alterado novamente ou redefinido para o padrão passando no
valor indefinido. Por padrão, o contextEngineID é definido para corresponder ao
authoritativeEngineID do mecanismo SNMP autorizado.
Nome do Contexto
O contextName é passado como uma string que deve ter de 0 a 32 octetos de comprimento usando o
--contextname argumento. O contextName permanece com o objeto até que ele seja alterado.
O contextName é padronizado para uma string vazia que representa o contexto "padrão".
Baseado no usuário Segurança Modelo Argumentos
O modelo de segurança baseado no usuário (USM) usado pelo SNMPv3 requer que um securityName seja
especificado usando o --nome do usuário argumento. A criação de um objeto Net :: SNMP com o
versão definida para SNMPv3 falhará se o --nome do usuário argumento não está presente. o --nome do usuário
argumento espera uma string de 1 a 32 octetos de comprimento.
Diferentes níveis de segurança são permitidos pelo modelo de segurança baseado no usuário que aborda
autenticação e privacidade. Um alvo SNMPv3 derivará o nível de segurança
(securityLevel) com base em qual dos seguintes argumentos são especificados.
Por padrão, um securityLevel de 'noAuthNoPriv' é assumido. Se o --chave de autenticação or
--authpassword os argumentos são especificados, o securityLevel torna-se 'authNoPriv'. o
--authpassword argumento espera uma string que tenha pelo menos 1 octeto de comprimento. Opcionalmente,
que o --chave de autenticação argumento pode ser usado para que uma senha de texto simples não tenha que ser
especificado em um script. o --chave de autenticação argumento espera uma string hexadecimal produzida por
localizando a senha com o authoritativeEngineID para o destino específico
dispositivo. O utilitário "snmpkey" incluído na distribuição Net :: SNMP pode ser usado para
crie a string hexadecimal (consulte snmpkey).
Dois algoritmos hash diferentes são definidos pelo SNMPv3 que podem ser usados pelo Security
Modelo para autenticação. Esses algoritmos são HMAC-MD5-96 "MD5" (RFC 1321) e
HMAC-SHA-96 "SHA-1" (NIST FIPS PUB 180-1). O algoritmo padrão usado pelo módulo é
HMAC-MD5-96. Este comportamento pode ser alterado usando o --authprotocol argumento. Esse
argumento espera que a string 'md5' ou 'sha' seja passada para modificar o hash
algoritmo.
Especificando os argumentos --privkey or --privpassword o securityLevel associado com
o objeto se torna 'authPriv'. De acordo com SNMPv3, a privacidade requer o uso de
autenticação. Portanto, se qualquer um desses dois argumentos estiver presente e o --chave de autenticação
or --authpassword faltam argumentos, a criação do objeto falha. o --privkey
e --privpassword argumentos esperam a mesma entrada que o --chave de autenticação e --authpassword
argumentos respectivamente.
O modelo de segurança baseado no usuário descrito na RFC 3414 define um único protocolo de criptografia
para ser usado para privacidade. Este protocolo, CBC-DES "DES" (NIST FIPS PUB 46-1), é usado por
padrão ou se a string 'des' é passada para o --privprotocol argumento. Trabalhando com
o Consórcio de Opções de Segurança Estendida http://www.snmp.com/eso/, o módulo também
suporta protocolos adicionais que foram definidos nas especificações preliminares. O rascunho
http://www.snmp.com/eso/draft-reeder-snmpv3-usm-3desede-00.txt define o suporte de
CBC-3DES-EDE "Triple-DES" (NIST FIPS 46-3) no modelo de segurança baseado no usuário. Esse
protocolo pode ser selecionado usando o --privprotocol argumento com a string '3desede'. o
rascunho http://www.snmp.com/eso/draft-blumenthal-aes-usm-04.txt descreve o uso de
CFB128-AES-128/192/256 "AES" (NIST FIPS PUB 197) no USM. A criptografia três AES
protocolos, diferenciados por seus tamanhos de chave, podem ser selecionados passando 'aescfb128',
'aescfb192' ou 'aescfb256' para o - protocolo privado argumento.
Adicionar ao carrinho on Filtros
O objetivo dos filtros é decidir quais interfaces aceitar e quais interfaces
rejeitar. Essa decisão é feita para cada interface, avaliando a expressão do filtro como um
pedaço de código Perl e investigando o resultado da avaliação. Se for verdade, aceite o
interface caso contrário, rejeitá-lo.
Ao trabalhar com filtros, lembre-se de que Perl tem sua própria ideia do que é verdade e falso
é. A string vazia "" e a string "0" são falsas, todas as outras strings são verdadeiras. Esse
além disso, implica que qualquer valor inteiro de 0 é falso, assim como qualquer valor undef. Isso também
implica que todas as referências são consideradas verdadeiras.
Como o filtro é avaliado como uma expressão Perl, várias construções úteis em Perl são
Vale a pena mencionar:
As expressões podem ser agrupadas usando parênteses "()". As expressões podem ser combinadas
usando operadores booleanos, como o seguinte:
"e"(equivalente a"&&")
O "e" booleano das duas expressões só é verdadeiro se as duas expressões forem verdadeiras.
Exemplo: expressão1 e expressão2
"or"(equivalente a"||")
O "or" booleano das duas expressões é verdadeiro se uma ou ambas as expressões forem verdadeiras.
Exemplo: expressão1 or expressão2
"não"(equivalente a"!")
Negação booleana de uma única expressão. Exemplo: não expressão . Ainda outra
exemplo: !expressão
(Para mais detalhes sobre isso, recomendo um livro sobre Perl)
Predefinido filtros Variáveis
Para facilitar, há uma série de valores predefinidos disponíveis para uso no filtro.
Observe que essas variáveis também estão disponíveis quando as interfaces dos modelos são avaliadas (mas
não modelos de host).
Advertência: os nomes de todas essas variáveis começam com um cifrão ($), que é uma sintaxe
requisito para variáveis escalares em Perl. O perigo aqui é que o cifrão em muitos
shellséum carácter activo (frequentemente usado para variáveis de shell exactamente como no Perl
variáveis), por isso é importante garantir que a expressão Perl não seja avaliada pelo
shell de linha de comando como código de shell antes de ser passado para cfgmaker como linha de comando
argumentos. Em shells como Bourne shell, ksh shell ou bash shell, colocando todo o
expressão dentro de uma única pergunta evitará tal avaliação acidental:
'--if-filter = ($ default_iftype && $ if_admin)'
$ if_type
Este é um número inteiro que especifica o tipo de interface de acordo com os padrões SNMP e conforme
relatado pelo dispositivo pesquisado. Uma lista completa de tipos de interface seria
impraticável para este documento, mas há uma série de variáveis predefinidas abaixo.
Normalmente, o cfgmaker coloca no PageTop do destino este valor iftype entre parênteses
após o nome do tipo de interface. (por exemplo, "propPointToPointSerial (22)").
Aqui está uma lista de alguns dos tipos de interface mais comuns por número:
6 ethernetCsmacd
7 iso88023Csmacd
9iso88025TokenRing
15 FDDI
19 E1
20 básicoISDN
21 ISDN primário
22 propPointToPointSerial
23 ppp
24 software Loopback
30ds3
Retransmissão de 32 quadros
33 rs232
37 atm
Soneto 39
44 frameRelayService
46hssi
49 aal5
53 prop Virtual
62 Ethernet rápida (100BaseT)
63 ISDN e X.25
69 Fast Ethernet Full Duplex (100BaseFX)
94 Loop de Assinante Digital Assimétrico (ADSL)
Ethernet Gigabit 117
134 Subinterface ATM
$ default
Verdadeiro se e somente se o cfgmaker normalmente deve aceitar a interface com base no
interfaces de estado administrativo e operacional (tomando as sinalizações --sem baixo e
- show-op-down em consideração) e seu tipo (e algumas outras coisas).
$ default_ifstate
Verdadeiro se e somente se o cfgmaker teria aceitado a interface com base em
estados operacionais e administrativos (considerando também a presença do
bandeiras --sem baixo e - show-op-down).
$ default_iftype
Verdadeiro se e somente se cfgmaker teria aceitado a interface com base em seu tipo (e
além de alguns detalhes específicos do tipo).
$ if_admin
Verdadeiro se e somente se a interface estiver em um estado administrativo ativo.
$ if_oper
Verdadeiro se e somente se a interface estiver em um estado operacional ativo.
Uma série de variáveis também são predefinidas para decidir facilmente se uma interface pertence a um
determinada categoria ou não. Abaixo estão todas as variáveis listadas junto com as quais if_type
números para os quais cada variável será verdadeira. Observe que algumas variáveis se referem a outras variáveis
tão bem.
$ if_is_ethernet
Verdadeiro para interfaces Ethernet (nr 6, 7, 26, 62, 69 e 117).
$ if_is_isdn
Verdadeiro para vários tipos de interface ISDN (nº 20, 21, 63, 75, 76 e 77)
$ if_is_dialup
Verdadeiro para interfaces dial-up como PPP e também ISDN. (nr 23, 81, 82 e 108 em
além dos números de $ if_is_isdn).
$ if_is_atm
Verdadeiro para diversos tipos de interface relacionados com ATM (nº 37, 49, 107, 105, 106, 114 e
$ if_is_wan
Verdadeiro para interfaces WAN ponto a ponto, Frame Relay e High Speed Serial (
22,32,44,46)
$ if_is_lan
Verdadeiro para interfaces LAN (8, 9, 11, 15, 26, 55, 59, 60 e 115, além do
números de $ if_is_ethernet).
$ if_is_dsl
Verdadeiro para ADSL, RDSL, HDSL e SDSL (nr 94, 95, 96, 97)
$ if_is_loopback
Verdadeiro para interfaces de loopback de software (nr 24)
$ if_is_ciscovlan
Verdadeiro para interfaces Cisco VLAN (interfaces com a palavra Vlan ou VLAN em seus
ifdesc)
$ if_vlan_id
Retorna o vlan id associado a uma porta específica nos switches Cisco Catalyst em
Catalyst OS e IOS, e switches 3Com. Se não for uma interface vlan,
retornar indefeso.
$ if_cisco_trunk
Retorna o estado de entroncamento de uma porta específica nos switches Cisco Catalyst em ambos
Catalyst OS e IOS. Retorna "1" se a interface for um tronco, undef caso contrário.
$ if_MTU
Retorna a unidade máxima de transferência associada a uma porta específica.
Além disso, você também pode usar as variáveis definidas para os modelos abaixo. Além disso, todos
as variáveis disponíveis no cfgmaker estão à disposição dos scripts mesmo que o uso de tal
recursos é desencorajado. Mais "atalhos" na forma de variáveis e funções serão
disponibilizados no futuro.
Exemplos on Filtros
O seguinte filtro não afetará quais interfaces serão incluídas ou excluídas, ele irá
fazer com que o cfgmaker se comporte normalmente.
'--if-filter = $ default'
O seguinte filtro fará com que o cfgmaker exclua as interfaces PPP (23):
'--if-filter = $ default && $ if_type! = 23'
O seguinte filtro fará com que o cfgmaker se comporte como de costume, exceto que irá considerar o
estado operacional de uma interface irrelevante, mas ainda rejeita todas as interfaces que são
administrativamente para baixo.
'--if-filter = $ if_admin && $ default_iftype'
Adicionar ao carrinho on Modelos
O conteúdo dos arquivos de modelo é avaliado como um programa Perl. Um número ou Perl
variáveis estão disponíveis para o programa ler e outras são usadas para escrita.
Como algumas das variáveis predefinidas têm valores que devem ser usados em
O código HTML alguns deles têm uma variante "HTML-escaped", por exemplo, $ html_syslocation é o HTML
variante de escape de $ syslocation. O escape HTML significa que os caracteres "<", ">" e "&"
são substituídos por "<", ">" e "&" e que as novas linhas incorporadas na string são
prefixado com " "e anexado com um caractere de espaço (se uma nova linha for a última no
string não é tocada).
Gravável Modelo Variáveis
Estas são as variáveis disponíveis para armazenar as linhas de configuração. Algumas delas são
inicializado antes da avaliação do modelo, mas esse conteúdo normalmente são comentários
para inclusão no arquivo de configuração final para que essas variáveis possam ser redefinidas para o
string vazia no código do modelo para eliminar os comentários. O contrário também é
possível, o conteúdo dessas variáveis pode ser estendido com mais informações para
vários motivos, como depuração, etc.
Uma vez que o modelo foi avaliado, o seguinte acontece: se o modelo é um
modelo de interface e a interface real por algum motivo são rejeitados e, portanto, precisa
ser comentada, todas as linhas na variável $ target_lines são transformados em comentários por
adicionar uma marca de hash ("#") no início. Então todas as variáveis $ head_lines,
$ problem_lines , $ target_lines e $ separator_lines são concatenados para formar o
linhas para adicionar ao arquivo de configuração.
$ target_lines
Esta variável é o espaço reservado para as linhas de configuração criadas pelo modelo.
$ target_lines é predefinido como vazio quando o código do modelo é avaliado.
$ head_lines
Esta variável destina-se a ser o espaço reservado para a linha de comentário que aparece apenas
antes do destino no arquivo de configuração. É inicializado com essa linha de comentário
antes da avaliação do código do modelo e se o modelo não modificar
$ head_lines durante a avaliação, o comentário terá a aparência usual no arquivo de configuração.
$ problem_lines
Esta variável destina-se a ser o titular das linhas de comentários que descrevem qualquer
problemas que podem ter sido encontrados ao tentar adicionar o alvo no
configuração. Para modelos de host normalmente não é usado e para aqueles é
predefinido como a string vazia. Para modelos de interface $ problem_lines é pré-definido
com os comentários de descrição de erro que o cfgmaker normalmente usaria para rejeitados
interfaces ou como a string vazia para interfaces aceitas.
É possível testar contra $ problem_lines para descobrir se uma interface será
incluído ou rejeitado, mas isso não é recomendado. Teste contra $ if_ok ao invés.
$ separator_lines
Esta variável é o espaço reservado para a string a ser usada como separador entre o
código para alvos individuais. O conteúdo desta variável é colocado após cada destino
(portanto, as linhas também aparecerão após o final do último destino na configuração).
Predefinido Modelo Variáveis
Todas as variáveis abaixo estão disponíveis para uso dos modelos de interface. Para modelos de host,
apenas aqueles listados em "Host and System Variables" estão disponíveis.
Para modelos de interface, as variáveis listadas em "Variáveis de filtro predefinidas" também são
disponível.
Proprietário e System Variáveis
$ router_name
Este é o nome totalmente qualificado do roteador. É afetado pelo seguinte
itens na linha de comando: o próprio nome do roteador e --domínio-dns.
$ router_connect
Esta é a string de referência para o roteador que está sendo pesquisado. Está no formulário
community @ router possivelmente seguido por algumas opções snmp. É afetado pelo
os seguintes itens na linha de comando: o próprio nome do roteador, --comunidade,
--snmp-opções e --domínio-dns. (Não há variante com escape de HTML disponível)
$ directory_name
Esta variável deve conter o nome do diretório como cfgmaker normalmente usaria como o
valor para a diretiva "Directory []". O valor é determinado pelo --subdiretórios
opção de linha de comando. Se --subdiretórios não é especificado $ directory_name será o vazio
fragmento. (Não há variante com escape de HTML disponível)
$ syscontact
Esta variável é o valor SNMP sysContact do roteador. (Variante com escape de HTML:
$ html_syscontact)
$ sysname
Esta variável é o valor SNMP sysName do roteador. (Nenhuma variante com escape de HTML disponível)
$ syslocation
Esta variável é o valor SNMP sysLocation do roteador. (Variante com escape de HTML:
$ html_syslocation)
$ sysdescr
Esta variável é o valor SNMP sysDescr do roteador. Normalmente não é usado por
cfgmaker, mas pode ser útil em um modelo. (Variante com escape de HTML: $ html_sysdescr)
Interface Target Relacionado Variáveis
$ target_name
Isso é o que o cfgmaker normalmente usaria como o nome do destino. O alvo
nome é o que se encontra entre colchetes, "[]", para as diretivas de destino.
(Não há variante com escape de HTML disponível)
$ if_ref
Esta é a string de referência para a interface. Espera-se que seja usado no
Diretiva "Target [xyz]" para distinguir qual interface usar. O valor disso
variável é afetada pelo --ifref opção de linha de comando. Normalmente é usado junto
com $ router_connect. (Não há variante com escape de HTML disponível)
$ if_ok
Esta variável é verdadeira se a interface for incluída na configuração
arquivo, caso contrário, false. Não teste contra outras variáveis, como $ problem_lines para
descobrir se uma interface será rejeitada ou não, use este $ if_ok ao invés.
$ default_target_lines
Esta variável contém todas as linhas de destino que o cfgmaker por padrão produz para este
interface. É útil se você deseja ter o "alvo padrão", mas deseja adicionar alguns
linhas extras usando um modelo.
Por padrão, o cfgmaker usa as seguintes diretivas para cada destino que gera: Destino [],
SetEnv [], MaxBytes [], Title [], PageTop [] e se houver algum diretório especificado também o
Diretiva Directory [].
Para facilitar a criação de modelos que geram configurações de destino semelhantes
ao padrão, cada uma das linhas de diretiva mencionadas acima tem um correspondente
variável contendo a linha como cfgmaker teria a saída por padrão.
Observe que nenhum deles tem uma variante de escape de HTML, o texto neles é de escape de HTML onde
precisava. Observe também que eles não têm nenhuma nova linha no final.
$ default_target_directive
Esta variável contém a string padrão para a linha de diretiva Target [].
$ default_setenv_directive
Esta variável contém a string padrão para a linha de diretiva SetEnv [].
$ default_directory_directive
Esta variável contém a string padrão para a linha de diretiva Directory [] que
significa que é uma string vazia (sem nova linha) se não houver diretório.
$ default_maxbytes_directive
Esta variável contém a string padrão para a linha de diretiva MaxBytes [].
$ default_title_directive
Esta variável contém a string padrão para a linha de diretiva Title [].
$ default_pagetop_directive
Esta variável contém a string padrão para as linhas da diretiva PageTop [].
Interface Network Configuração Variáveis
$ if_ip
Esta variável deve conter o endereço IP da interface, se algum foi atribuído
para isso. (Não há variante com escape de HTML disponível)
$ ifindex
Esta variável é o SNMP ifIndex para a interface que, por definição, é sempre um
inteiro. (Não há variante com escape de HTML disponível)
$ if_index
Equivalente a $ ifindex.
$ if_eth
Contém o endereço Ethernet da interface, se houver. (Não há escape de HTML
variante disponível)
$ if_speed
Esta variável é a velocidade em bytes / segundo (com prefixos). (Não há escape de HTML
variante disponível)
$ if_speed_str
Esta variável é uma descrição da velocidade de cozimento que pode ser em bits ou bytes, dependendo
se a opção de bits está ou não ativa e também com o prefixo adequado para o
velocidade (k, M, G etc). (Nenhuma variante com escape de HTML disponível)
$ if_type_desc
Esta variável é uma descrição textual do tipo de interface. (Variante com escape de HTML:
$ html_if_type_desc)
$ if_type_num
Esta variável é o valor inteiro correspondente ao tipo de interface (para uma lista de
o valor para os tipos de interface mais comuns, consulte a seção DETALHES SOBRE FILTROS
acima de). (Nenhuma variante com escape de HTML disponível)
$ if_dns_name
Este é o nome DNS da interface. (Nenhuma variante com escape de HTML disponível)
Interface Nome, Descrição e aliás Variáveis
Pode parecer confuso com ambos Nome, Descrição e aliás neste contexto e para alguns
extensão é. Nome e Descrição são geralmente suportados na maioria dos equipamentos, mas como eles
são usados variam, tanto entre os fabricantes quanto entre as diferentes categorias de
equipamento do mesmo fabricante. o aliás é pelo menos compatível com Cisco IOS e
essa variável contém tudo o que é usado na declaração IOS chamada "descrição" para o
interface (não deve ser confundido com as variáveis SNMP para Descrição).
Para um melhor controle da linha de comando, considere $ if_title_desc quais conteúdos são
controlado pelo --if-descr opção de linha de comando.
$ if_snmp_descr
Esta variável deve conter a descrição "bruta" da interface conforme determinado por
o SNMP polling do roteador. (Variante com escape de HTML: $ html_if_snmp_descr)
$ if_snmp_name
O nome "bruto" da interface, conforme fornecido pela pesquisa SNMP. (Variante com escape de HTML:
$ html_if_snmp_name)
$ if_snmp_alias
O ifAlias "bruto" para a interface, conforme fornecido pela pesquisa SNMP. (HTML com escape
variante: $ html_if_snmp_alias)
$ if_cisco_descr
O CiscolocIfDescr "bruto" para a interface, conforme fornecido pela pesquisa SNMP. (HTML
variante de escape: $ html_if_cisco_descr)
$ if_description
Esta é a string de descrição "cozida" para a interface, levando em consideração o
Valores SNMP encontrados para RDescr, ifAlias e CiscolocIfDescr da interface. (HTML
variante de escape: $ html_if_description)
$ if_title
A string completa cfgmaker por padrão teria sido usada para a diretiva Title [] no
configuração, bem como o conteúdo da tag H1 superior no PageTop []. É
composto pelo conteúdo de $ desc_prefix, $ if_title_desc e $ sysname.
As $ if_title depende $ if_title_desc, é possível controlar indiretamente $ if_title
usando a opção de linha de comando --if-descr.
(Variante com escape de HTML: $ html_if_title)
$ if_port_name
Se o host for um switch LAN Cisco Catalyst, esta variável é o nome dessa porta.
(Nenhuma variante com escape de HTML disponível)
$ if_pp_port_name
Se o host for um switch Nortel Passport LAN, esta variável é o nome dessa porta.
(Nenhuma variante com escape de HTML disponível)
$ desc_prefix
Esta variável é um prefixo da descrição do que o alvo deve ser usado no
Diretiva "Title []" e na seção H1 de "PageTop []". O padrão é "Tráfego
análise para ". (variante com escape de HTML: $ html_desc_prefix)
$ if_title_desc
Esta é a descrição da interface normalmente usada pelo cfgmaker como parte do
variável $ if_title. Este último é usado como a string completa no diretório "Title []"
e a seção H1 no PageTop [].
$ if_title_desc é controlado pela opção de linha de comando --if-descr que indiretamente
controla o conteúdo de $ if_title
(Variante com escape de HTML: $ html_if_title_desc)
Ajuda Funções para Modelos
As funções a seguir existem para facilitar a escrita de modelos de host e interface.
html_escape (corda)
html_escape () recebe uma string como argumento e retorna uma nova string onde o
as seguintes substituições foram feitas: os caracteres "<", ">" e "&" são substituídos por
"<", ">" e "&" e que as novas linhas incorporadas na string são prefixadas com
" "e anexado com um caractere de espaço (as novas linhas no final da string não são
tocado).
oid_pick ($ router_connect, $ v3opt, "oid1", "oid2" ...)
Esta função tentará pesquisar cada um dos oids especificados até ser bem sucedido ou
ficou sem oids. Ele retornará o nome do primeiro oid que funcionou ou undef se
não é bem sucedido
Exemplo Modelo Arquivos
Exemplo de modelo 1: Eliminando a exibição de alvos rejeitados
Este arquivo de modelo gera exatamente o mesmo código de configuração por interface que cfgmaker
faz por padrão, com a exceção de que elimina todas as linhas (comentários, bem como
código de configuração) para uma interface se ela for rejeitada.
if (não $ problem_lines)
{
$ target_lines. = <
Destino [$ target_name]: $ if_ref: $ router_connect
SetEnv [$ target_name]: MRTG_INT_IP = "$ if_ip" MRTG_INT_DESCR = "$ if_snmp_descr"
ECHO
if ($ directory_name) {
$ target_lines. = "Diretório [$ target_name]: $ directory_name \ n";
}
$ target_lines. = <
MaxBytes [$ target_name]: $ if_speed
Título [$ target_name]: $ html_desc_prefix $ html_if_title_desc - $ sysname
PageTop [$ target_name]: $ html_desc_prefix $ html_if_title_desc - $ sysname
Sistema:
$ sysname em $ html_syslocation
Mantenedor:
$ html_syscontact
Descrição:
$ html_if_description
ifType:
$ html_if_type_desc ($ if_type_num)
ifName:
$ html_if_snmp_name
ECHO
$ target_lines. = <
Nome da porta:
$ if_port_name
ECHO
$ target_lines. = <
Nome da porta:
$ if_pp_port_name
ECHO
$ target_lines. = <
Velocidade máxima:
$ if_speed_str
ECHO
$ target_lines. = <
Ip:
$ if_ip ($ if_dns_name)
ECHO
$ target_lines. = <
</div>
ECHO
Else {}
$ head_lines = "";
$ problem_lines = "";
$ target_lines = "";
$ separator_lines = "";
}
Modelo Exemplo 2: Mais simples Versão of Exemplo 1
O Exemplo 1 foi parcialmente destinado a demonstrar como personalizar a geração da interface
alvos, mas também para fornecer uma dica de como as variáveis são usadas no modelo "padrão"
qual pode ser considerado que o cfgmaker normalmente usa.
Se você está interessado apenas na maneira mais fácil de eliminar totalmente aqueles rejeitados
interfaces, o modelo abaixo também faria o trabalho usando $ default_target_lines.
if ($ if_ok) {
$ target_lines = $ default_target_lines;
Else {}
$ head_lines = "";
$ problem_lines = "";
$ target_lines = "";
$ separator_lines = "";
}
Modelo Exemplo 3: Criar CPU Alvos para Hosts
Abaixo está um exemplo de um modelo de host.
$ head_lines. = <
# ------------------------------------------------- --------------------
ECHO
meu $ target_name = $ router_name. ".CPU";
$ target_lines. = <
YLegend [$ target_name]: Porcentagem de carga da CPU
ShortLegend [$ target_name]:%
Legend1 [$ target_name]: carga da CPU em%
Legend2 [$ target_name]:
Legend3 [$ target_name]: Carga máxima de CPU observada
Legend4 [$ target_name]:
LegendI [$ target_name]: Carga da CPU:
LegendO [$ target_name]:
WithPeak [$ target_name]: ywm
MaxBytes [$ target_name]: 100
Opções [$ target_name]: growright, gauge, nopercent
Título [$ target_name]: $ router_name carga da CPU
Destino [$ target_name]: 1.3.6.1.4.1.9.2.1.58.0 e 1.3.6.1.4.1.9.2.1.58.0: $ router_connect
PageTop [$ target_name]: $ router_name carga de CPU
Sistema:
$ router_name em $ html_syslocation
Mantenedor:
$ html_syscontact
Descrição:
$ html_sysdescr
Recurso:
CPU.
</div>
ECHO
EXEMPLOS
O primeiro exemplo cria um arquivo de configuração para roteador.lugar.xyz: o roteador tem o
nome da comunidade público. As interfaces são identificadas por seu número de IP. Duas opções globais
seja adicionado ao arquivo de configuração. O arquivo de configuração é redirecionado para mrtg.conf. O '\'
sinais no final da linha significam que este comando deve ser escrito em uma única linha.
cfgmaker --global "WorkDir: / home / tobi" \
--global "Opções [_]: growright, bits" \
--ifref = ip \
[email protegido] > mrtg.cfg
Observação: se cfgmaker não estiver em seu caminho, mas você estiver no diretório em que cfgmaker está
armazenado, você pode iniciá-lo com ./cfgmaker
O próximo exemplo cria um arquivo de configuração para quatro dispositivos: roteador1.lugar.xyz,
roteador2.lugar.xyz, switch1.place.xyz e switch2.place.xyz tudo com a comunidade público.
Os dois roteadores terão --ifref definido para descrição enquanto os dois interruptores usarão --ifref
definido para nome. Além disso, os roteadores usarão --ifdesc definido para aliás e switch1.place.xyz
usará --ifdesc definido para descrição enquanto switch2.place.xyz usar nome ao invés.
Finalmente, haverá duas linhas de Opções inseridas na configuração: Uma estará no
começando, enquanto o outro será inserido após as linhas relacionadas aos dois roteadores
mas antes dessas linhas relacionadas aos interruptores.
cfgmaker --global "WorkDir: / home / tobi" \
--global "Opções [_]: growright, bits" \
--ifref = descr \
--ifdesc = alias \
[email protegido] \
[email protegido] \
--global "Opções [_]: growright" \
--ifref = nome \
--ifdesc = descr \
[email protegido] \
--ifdesc = nome \
[email protegido] > mrtg.cfg
O próximo exemplo demonstra como usar o --comunidade, --snmp-opções e --domínio-dns
para tornar a linha de comando mais simples. Todo o equipamento utilizará a comunidade escondido, exceto
para o servidor ppp que usa a comunidade Acesso. Todos os equipamentos usam estas opções SNMP: 1s
tempo limite, 1 tentar novamente e SNMP versão 2 (saia de perto e porta não é especificado, o que significa que eles usam
os valores padrão). A exceção novamente é o servidor ppp que usa SNMP versão 1.
Por fim, todo o equipamento faz parte do domínio lugar.xyz, exceto para o servidor ppp
que faz parte do domínio local.remoto.xyz. Observe que o último é alcançado simplesmente por
especificando o nome do servidor ppp a ser servidor PPP.remoto .
cfgmaker --global "WorkDir: / home / tobi" \
--global "Opções [_]: growright, bits" \
--dns-domain = place.xyz \
--community = oculto \
--snmp-options = :: 1: 1 :: 2 \
roteador1 \
roteador2 \
roteador3 \
roteador4 \
roteador5 \
mudar1 \
mudar2 \
mudar3 \
mudar4 \
mudar5 \
mudar6 \
mudar7 \
[email protegido]::::: 1> mrtg.cfg
Use o cfgmaker online usando os serviços onworks.net
