cfgmaker: en línea en la nube

PROGRAMA:

NOMBRE

cfgmaker: crea archivos mrtg.cfg (para mrtg-2.17.4)

SINOPSIS

cfgmaker [opciones] [comunidad @] enrutador [[opciones] [comunidad @] enrutador ...]

CAMPUS

--ifref = nombrar referencias de interfaz por nombre de interfaz (predeterminado)
--ifref = ip ... por dirección IP
--ifref = eth ... por número de Ethernet
--ifref = descr ... por Descripción de interfaz
--ifref = nr ... por número de interfaz
--ifref = tipo ... por tipo de interfaz
También puede utilizar varias opciones separadas por comas,
en cuyo caso se utiliza el primero disponible:
por ejemplo, --ifref = ip, nombre, nr

--ifdesc = nr descripción de la interfaz utiliza el número de interfaz (predeterminado)
--ifdesc = ip ... usa la dirección IP
--ifdesc = eth ... usa el número de Ethernet
--ifdesc = descr ... usa la descripción de la interfaz
--ifdesc = nombre ... usa el nombre de la interfaz
--ifdesc = catname ... usa el nombre de la interfaz CatOS
--ifdesc = ppname ... usa el nombre del puerto del pasaporte
--ifdesc = alias ... usa Interface Alias
--ifdesc = type ... usa el tipo de interfaz
También puede utilizar varias opciones separadas por comas,
en cuyo caso se utiliza el primero disponible:
por ejemplo, --ifdesc = catname, ppname, descr, alias, ip, name, nr

--if-filter = f Prueba cada interfaz con el filtro f para decidir si
o no incluir esa interfaz en la colección.
Actualmente, f se está evaluando como una expresión de Perl.
y su valor de verdad se utiliza para rechazar o aceptar la
de la interfaz del.
(Experimental, en desarrollo, podría cambiar)

--if-template = archivo de plantilla
Reemplazar las entradas de destino normales para las interfaces
con una entrada según lo especificado por el contenido del archivo
archivo de plantilla. Se supone que el archivo contiene Perl
código que se ejecutará para generar las líneas para el
target en el archivo de configuración.
(Experimental, en desarrollo, podría cambiar)

--host-template = archivo de plantilla
Además de crear destinos para las interfaces de un host
también cree objetivos para el host como se especifica
por el contenido del archivo templatefile. El archivo es
se supone que contiene el código Perl que se ejecutará para generar
las líneas para los destinos relacionados con el host (como CPU,
mediciones de tiempo de respuesta de ping, etc.) en la configuración
archivo de duración.
(Experimental, en desarrollo, podría cambiar)

--global "x: a" agrega entradas de configuración global

--no-down no mira el estado de administrador u opr de las interfaces

--show-op-down muestra interfaces que están operativamente inactivas

--zero-speed = spd usa esta velocidad en bits por segundo como interfaz
velocidad para todas las interfaces que devuelven una velocidad de 0
a través de ifSpeed ​​/ ifHighSpeed. 100 Mbps = 100000000

--subdirs = format dan a cada router su propio subdirectorio, nombrando cada uno por
"formato", en el que HOSTNAME y SNMPNAME serán
reemplazado por los valores de esos elementos, por ejemplo,
--subdirs = HOSTNAME o --subdirs = "HOSTNAME (SNMPNAME)"

--noreversedns no invierte los números de IP de búsqueda

--community = cmty Establece la cadena de comunidad predeterminada en "cmty" en lugar de
"público".

--enable-ipv6 Habilita la compatibilidad con IPv6, si las bibliotecas necesarias son
regalo. Deben incluirse las direcciones IPv6 numéricas
entre corchetes, p. ej. público @ [2001: 760: 4 :: 1]: 161

--use-16bit Use ID de solicitud SNMP de 16 bits para consultar todos los enrutadores.

--snmp-options =: [ ] [: [ ] [: [ ] [: [ ] [: ]]]]

Especifique las opciones de SNMP predeterminadas que se agregarán a todos
enrutadores siguientes. Los campos individuales pueden estar vacíos.
Los enrutadores siguientes pueden anular algunos o todos los
opciones dadas a --snmp-options.

--dns-domain = dominio
Especifica un dominio para agregar al nombre de todos
enrutadores siguientes.

--nointerfaces No genera ninguna línea de configuración para interfaces,
omita el paso de recopilar información de la interfaz y
no ejecute ningún código de plantilla de interfaz.

--interfaces Genera líneas de configuración para interfaces (esta es la
defecto). El propósito principal de esta opción es negar
an --nointerfaces que aparecen anteriormente en la línea de comando.

- ayuda breve mensaje de ayuda
--man documentación completa
--version imprime la versión de cfgmaker

--output = archivo de salida, el nombre de archivo predeterminado es STDOUT

DESCRIPCIÓN

fabricante de cfg crea archivos de configuración MRTG basados ​​en información extraída de un enrutador o
otro dispositivo administrable SNMP.

[vibrante e inclusiva@]enrutador

Comunidad es el nombre de comunidad del dispositivo para el que desea crear una configuración. Si
no especificado, por defecto es 'público'; es posible que desee probar esto primero si no lo hace
conocer el nombre de comunidad de un dispositivo. Si está utilizando el nombre de comunidad incorrecto,
no obtenga respuesta del dispositivo.

Router es el nombre DNS o el número de IP de un dispositivo gestionable por SNMP. Siguiendo el nombre
puede especificar 6 opciones más separadas por dos puntos. La sintaxis completa se ve así:

enrutador[: [prt] [: [fuera] [: [recuperar] [: [Apártate] [:a]]]]]

De especial interés puede ser el último parámetro, a. Si establece esto en '2', entonces su
se consultará el dispositivo con las solicitudes de la versión 2 de SNMP. Esto le permite sondear el 64 bit
contadores de tráfico en el dispositivo y, por lo tanto, funcionará mucho mejor con interfaces rápidas (no
más contraataque). Tenga en cuenta que el orden en el que se especifican los enrutadores en el
La línea de comandos importa, ya que se usa el mismo orden cuando se genera el archivo de configuración.
El primer enrutador especificado tiene sus líneas de configuración generadas primero, seguidas por el
líneas que pertenecen al siguiente enrutador y así sucesivamente.

Tenga en cuenta que la primera línea del archivo cfg generado contendrá toda la línea de comandos
opciones que utilizó para generarlo. Esto es para permitir una fácil 'regeneración' en caso de
desea agregar nuevos hosts o realizar algún otro cambio global.

Configuración
Excepto por el --producción y --global opciones, todas las opciones afectan solo a los enrutadores
siguiéndolos en la línea de comando. Si una opción especificada anteriormente en la línea de comando
vuelve a aparecer más tarde en la línea de comando con otro valor, el nuevo valor anula el antiguo
valor en lo que respecta a los enrutadores restantes. De esta forma, las opciones pueden adaptarse a
grupos de enrutadores o para enrutadores individuales.

See --producción y --global de cómo su comportamiento se ve afectado por dónde o cuántas veces
aparecen en la línea de comando.

Consulte las Ejemplos a continuación sobre cómo configurar una opción de manera diferente para varios enrutadores.

--ayuda
Imprima un breve mensaje de ayuda y salga.

--hombre
Imprime la página del manual y sale.

--versión
Imprima la versión de cfgmaker. Esto debe coincidir con la versión de MRTG para la que config
se están creando archivos.

--si ref nr|ip|eth|descripción|nombre
Seleccione el método de identificación de la interfaz. El valor predeterminado es nr que identifica el enrutador
interfaces por su número. Desafortunadamente, el esquema de numeración de la interfaz en un SNMP
el árbol puede cambiar. Algunos enrutadores cambian su numeración cuando se agregan nuevas interfaces,
otros cambian su numeración cada luna llena solo por diversión.

Para solucionar este triste problema, MRTG puede identificar interfaces mediante otras 4 propiedades.
Ninguno de estos funciona para todas las interfaces, pero debería poder encontrar uno que funcione
bien para ti. Tenga en cuenta que especialmente las direcciones Ethernet pueden ser problemáticas ya que algunas
los enrutadores tienen la misma dirección Ethernet en la mayoría de sus tarjetas de interfaz.

Seleccione ip para identificar la interfaz por su número de IP. Usar eth para usar ethernet
dirección para identificación. Usar descripción para utilizar la descripción de la interfaz. O usar nombre a
utilice el nombre de la interfaz.

Puede especificar varias propiedades si lo desea, separadas por comas. En este caso,
cfgmaker utilizará el primer elemento de la lista que puede proporcionar una identificación única.
Esto le permite especificar, por ejemplo, usar la dirección IP y usar ifName si esto
no está definido:
--ifref ip, nombre

Si el método elegido no permite la identificación de interfaz única en el dispositivo,
están consultando, fabricante de cfg te lo contará.

--ifdesc nr|ip|eth|descripción|nombre |tipo|alias
Seleccione qué usar como descripción de la interfaz. La descripción aparece en
la propiedad "Título []" para el destino, así como el encabezado de texto en el código HTML
definido en el "PageTop []" del destino. El valor predeterminado es usar nr que es solo la interfaz
número que no siempre es útil para el espectador de los gráficos.

Hay otras 6 propiedades que podrían utilizarse. Usar ip si quieres usar el
dirección IP de la interfaz. Usar eth si desea utilizar la dirección ethernet de la interfaz.
Si desea una mejor descripción, puede utilizar descripción, nombre or alias. Exactamente
lo que hace cada uno de estos varía entre los diferentes equipos, por lo que es posible que deba
experimentar. Por ejemplo, para una interfaz serial en un enrutador Cisco que ejecuta IOS usando
nombre puede resultar en que "S0" sea la descripción de la interfaz, descripción podría resultar en
"Serial0" y alias podría resultar en "Enlace a HQ" (siempre que sea lo que se utiliza como el
"descripción" de la interfaz en la configuración del enrutador).

Finalmente, si desea describir la interfaz por su tipo B (es decir, "ethernetCSMA",
"propPointtoPoint", etc.) puede utilizar tipo.

Puede especificar varias propiedades si lo desea, separadas por comas. En este caso,
cfgmaker utilizará el primer elemento de la lista que está disponible para esta interfaz.
Esto le permite especificar, por ejemplo, usar cualquiera de los diferentes alias en orden
de preferencia.

--if-filtro 'expresión-filtro'
En primer lugar, esto está en desarrollo y es experimental.

Use esto si desea tener un mejor control sobre las interfaces que se incluyen en
La configuración. El expresión-filtro se evalúa como un fragmento de código Perl y es
se espera que devuelva un valor de verdad. Si es verdadero, incluya la interfaz y si es falso,
excluir la interfaz.

Para obtener más información sobre cómo funcionan estos filtros, consulte la sección "Detalles sobre
Filtros "a continuación.

--si-plantilla archivo de plantilla
En primer lugar, esto está en desarrollo y es experimental.

Use esto si desea controlar cómo debe verse la línea para cada objetivo en el
archivo de configuración. El contenido del archivo archivo de plantilla será evaluado como un
Programa Perl que genera las líneas usando ciertas variables para entrada y salida.

Para obtener más información sobre cómo funcionan estas plantillas, consulte la sección "Detalles sobre
Temaplates "a continuación.

--host-plantilla archivo de plantilla
En primer lugar, esto está en desarrollo y es experimental.

Use esto si desea tener algunos objetivos adicionales relacionados con el host en sí, como la CPU
utilización, tiempo de respuesta de ping al host, número de módems ocupados, etc.
del archivo archivo de plantilla se evaluará una vez por host como un programa Perl que
genera las líneas usando ciertas variables para entrada y salida.

Para obtener más información sobre cómo funcionan estas plantillas, consulte la sección "Detalles sobre
Plantillas "a continuación.

--comunidad cadena de comunidad
Use esto para configurar la comunidad para los enrutadores que siguen la línea de comando para
cadena de comunidad. Los enrutadores individuales pueden anular esta cadena de comunidad utilizando
la sintaxis comunidad @ enrutador.

--habilitar-ipv6
Esta opción habilita la compatibilidad con IPv6. Requiere los módulos de perl apropiados; si ellos
no se encuentran, entonces IPv6 está deshabilitado (consulte la documentación de ipv6).

cfgmaker utilizará IPv6 o IPv4 según el objetivo. Si el objetivo es numérico
dirección, el protocolo depende del tipo de dirección. Si el objetivo es un nombre de host,
cfgmaker intentará resolver el nombre primero en una dirección IPv6 y luego en una IPv4
dirección.

Las direcciones numéricas IPv6 deben especificarse entre llaves.

Por ejemplo:

cfgmaker --enable-ipv6 [2001:760:4::1]:165:::2

Si el destino tiene una dirección IPv6 y una dirección IPv4 con el mismo nombre de host,
cfgmaker primero consulta el objetivo usando IPv6 y recurre a IPv4 si falla. Esta
es útil para destinos que no admiten SNMP sobre IPv6.

--uso-16 bits
Esta opción fuerza el uso de ID de solicitud SNMP de 16 bits. Algunos agentes SNMP dañados no
aceptar ID de solicitud de 32 bits. Trate de evitar esta opción tanto como sea posible, reclame a
su proveedor de agente en su lugar.

--snmp-opciones :[Puerto] [: [tiempo de espera] [: [reintentos] [: [Apártate] [:versión]]]]
Use esto para configurar las opciones SNMP predeterminadas para todos los enrutadores que siguen el comando
línea. Los valores individuales pueden omitirse, así como los dos puntos finales. Tenga en cuenta que
los enrutadores pueden anular los valores individuales (o todos) especificados por --snmp-opciones mediante el uso
la sintaxis

enrutador[: [Puerto] [: [tiempo de espera] [: [reintentos] [: [Apártate] [:versión]]]]]

--global "bla: abecedario"
Use esto para agregar opciones globales al archivo de configuración generado. Puedes llamar --global
varias veces para agregar múltiples opciones. La línea aparecerá en la configuración justo
antes de la configuración del siguiente enrutador que aparece en la línea de comando.

--global "workdir: / home / mrtg"

Si desea algunas opciones predeterminadas, es posible que desee poner

--global "opciones [_]: growright, bits"

Especificación --global después de que el último enrutador en la línea de comando creará una línea en
el archivo de configuración que aparecerá después de todos los enrutadores.

--noreversedns
No intente invertir los números de IP de búsqueda ... una necesidad para entornos sin DNS.

--no-abajo
Normalmente, cfgmaker no incluirá interfaces que estén marcadas como
administrativa y operativamente ARRIBA. Con este interruptor los obtienes todos.

--mostrar-op-abajo
Incluya interfaces que estén operativamente inactivas.

- velocidad cero velocidad
Asigne esta velocidad en bits por segundo a todas las interfaces que devuelven 0 para ifSpeed ​​y
ifHighSpeed. Algunos interruptores, en particular los equipos de fundición, devuelven una velocidad de cero para
algunas interfaces. Por ejemplo, para que todas las interfaces que informen cero se establezcan en 100 Mbps,
use --zero-speed = 100000000.

--subdirectores formato
Asigne a cada enrutador su propio subdirectorio para los archivos HTML y gráficos (o .rrd). El
el nombre del directorio es el dado formato cadena con un par de reemplazos de patrones. El
La cadena "HOSTNAME" será reemplazada por el nombre de host del enrutador (sin embargo,
lo especificó en el fabricante de cfg línea de comandos: puede ser un nombre de host real o solo una IP
dirección), y "SNMPNAME" se reemplazará con la idea del dispositivo de su propio nombre (el
mismo nombre que aparece en el lado derecho de las líneas de "Título"). Por ejemplo, una llamada
me gusta:

cfgmaker --subdirs = HOSTNAME__SNMPNAME [email protected]

daría como resultado la generación de líneas con un aspecto similar a:

Directory[10.10.0.18_1]: 10.10.0.18__fp2200-bothrip-1.3

--producción presentar
Escribe la salida de fabricante de cfg en el archivo presentar. El valor predeterminado es utilizar "STDOUT".
--producción se espera que aparezca solo una vez en la línea de comando. Si se usa varias veces,
el archivo especificado por el último --producción se utilizará.

--sin interfaces
No genere líneas de configuración para interfaces.

Esto hace que cfgmaker omita todos los pasos relacionados con las interfaces, lo que significa que no funcionará.
cualquier sondeo del enrutador para recuperar información de la interfaz que acelera la
ejecución de cfgmaker y tampoco ejecutará ninguna plantilla de interfaz.

--interfaces
Esto hace que cfgmaker genere líneas de configuración para interfaces (el valor predeterminado
comportamiento).

El uso principal de esta opción es negar una --nointerfaces que aparecen anteriormente en el
línea de comando.

SNMP V3 Opciones
fabricante de cfg admite SNMP V3 utilizando el Red: SNMP módulo perl. Hay parámetros opcionales
afectando el funcionamiento de SNMP.

--enablesnmpv3 {sí | no}
El --enablenmpv3 La opción es una bandera opcional para verificar la presencia del
Red :: SNMP bibliotecas fabricante de cfg intentará determinar si esta bandera es necesaria y
establecerá los valores automáticamente.

SNMPv3 Argumentos

Un contexto SNMP es una colección de información de gestión accesible por una entidad SNMP. Un
El elemento de información de gestión puede existir en más de un contexto y una entidad SNMP
potencialmente tiene acceso a muchos contextos. La combinación de un contextEngineID y un
contextName identifica de forma inequívoca un contexto dentro de un dominio administrativo. en un
El mensaje SNMPv3, contextEngineID y contextName se incluyen como parte del scopedPDU.
Todos los métodos que generan un mensaje SNMP toman opcionalmente un --contextengineid y
--nombre de contexto argumento para configurar estos campos.

ID del motor de contexto
El --contextengineid argumento espera una cadena hexadecimal que representa el deseado
contextEngineID. La cadena debe tener de 10 a 64 caracteres (de 5 a 32 octetos) y puede
tener el prefijo "0x" opcional. Una vez el --contextengineid se especifica se queda
con el objeto hasta que se cambie de nuevo o se restablezca a los valores predeterminados pasando el
valor indefinido. De forma predeterminada, contextEngineID se establece para que coincida con el
AuthoritativeEngineID del motor SNMP autorizado.

Nombre de contexto
El contextName se pasa como una cadena que debe tener de 0 a 32 octetos de longitud utilizando el
--nombre de contexto argumento. El contextName permanece con el objeto hasta que se cambia.
El nombre de contexto predeterminado es una cadena vacía que representa el contexto "predeterminado".

Basado en el usuario Seguridad Modelo Argumentos

El modelo de seguridad basado en el usuario (USM) utilizado por SNMPv3 requiere que un nombre de seguridad sea
especificado usando el --nombre de usuario argumento. La creación de un objeto Net :: SNMP con el
La versión configurada en SNMPv3 fallará si el --nombre de usuario el argumento no está presente. El --nombre de usuario
El argumento espera una cadena de 1 a 32 octetos de longitud.

El modelo de seguridad basado en el usuario permite diferentes niveles de seguridad que abordan
preocupaciones de autenticación y privacidad. Un objetivo SNMPv3 derivará el nivel de seguridad
(securityLevel) según cuál de los siguientes argumentos se especifican.

De forma predeterminada, se asume un securityLevel de 'noAuthNoPriv'. Si el --Clave de autenticación or
--contraseña de autenticación se especifican argumentos, securityLevel se convierte en 'authNoPriv'. El
--contraseña de autenticación El argumento espera una cadena de al menos 1 octeto de longitud. Opcionalmente
las --Clave de autenticación El argumento se puede utilizar para que no sea necesario utilizar una contraseña de texto sin formato.
especificado en un script. El --Clave de autenticación argumento espera una cadena hexadecimal producida por
localizar la contraseña con el AuthoritativeEngineID para el destino específico
dispositivo. La utilidad "snmpkey" incluida con la distribución Net :: SNMP se puede utilizar para
cree la cadena hexadecimal (vea snmpkey).

SNMPv3 define dos algoritmos hash diferentes que pueden ser utilizados por Security
Modelo de autenticación. Estos algoritmos son HMAC-MD5-96 "MD5" (RFC 1321) y
HMAC-SHA-96 "SHA-1" (NIST FIPS PUB 180-1). El algoritmo predeterminado utilizado por el módulo es
HMAC-MD5-96. Este comportamiento se puede cambiar utilizando el --protocolo de autenticación argumento. Esta
El argumento espera que se pase la cadena 'md5' o 'sha' para modificar el hash
algoritmo.

Especificando los argumentos --clave privada or --contraseñaprivada el securityLevel asociado con
el objeto se convierte en 'authPriv'. Según SNMPv3, la privacidad requiere el uso de
autenticación. Por lo tanto, si alguno de estos dos argumentos está presente y el --Clave de autenticación
or --contraseña de autenticación faltan argumentos, la creación del objeto falla. El --clave privada
y --contraseñaprivada Los argumentos esperan la misma entrada que el --Clave de autenticación y --contraseña de autenticación
argumentos respectivamente.

El modelo de seguridad basado en el usuario descrito en RFC 3414 define un único protocolo de cifrado
para ser utilizado por motivos de privacidad. Este protocolo, CBC-DES "DES" (NIST FIPS PUB 46-1), es utilizado por
predeterminado o si la cadena 'des' se pasa al --protocolo privado argumento. Trabajando con
el Consorcio de Opciones de Seguridad Extendida http://www.snmp.com/eso/, el módulo también
admite protocolos adicionales que se han definido en borradores de especificaciones. El proyecto
http://www.snmp.com/eso/draft-reeder-snmpv3-usm-3desede-00.txt define el apoyo de
CBC-3DES-EDE "Triple-DES" (NIST FIPS 46-3) en el modelo de seguridad basado en el usuario. Esta
El protocolo se puede seleccionar utilizando el --protocolo privado argumento con la cadena '3desede'. El
borrador http://www.snmp.com/eso/draft-blumenthal-aes-usm-04.txt describe el uso de
CFB128-AES-128/192/256 "AES" (NIST FIPS PUB 197) en el USM. Los tres cifrados AES
Los protocolos, diferenciados por sus tamaños de clave, se pueden seleccionar pasando 'aescfb128',
'aescfb192' o 'aescfb256' al -protocolo privado argumento.

Detalles on Filtros
El propósito de los filtros es decidir qué interfaces aceptar y qué interfaces
rechazar. Esta decisión se toma para cada interfaz evaluando la expresión de filtro como un
fragmento de código Perl e investigando el resultado de la evaluación. Si es cierto, acepta la
interfaz de lo contrario rechazarlo.

Cuando trabaje con filtros, recuerde que Perl tiene su propia idea de lo que es verdad y lo falso.
es. La cadena vacía "" y la cadena "0" son falsas, todas las demás cadenas son verdaderas. Esta
implica además que cualquier valor entero de 0 es falso, así como cualquier valor indefinido. También
implica que todas las referencias se consideran verdaderas.

Como el filtro se evalúa como una expresión de Perl, varias construcciones útiles en Perl son
vale la pena mencionar:

Las expresiones se pueden agrupar utilizando paréntesis "()". Las expresiones pueden combinarse
utilizando operadores booleanos como los siguientes:

"y"(equivalente a"&&")
El booleano "y" de las dos expresiones solo es verdadero si ambas expresiones son verdaderas.
Ejemplo: expresión1 y expresión2

"or"(equivalente a"||")
El booleano "o" de las dos expresiones es verdadero si una o ambas expresiones son verdaderas.
Ejemplo: expresión1 or expresión2

"no"(equivalente a"!")
Negación booleana de una sola expresión. Ejemplo: no expresión . Aún otra
ejemplo: !expresión

(Para obtener más detalles sobre esto, recomiendo un libro sobre Perl)

predefinida Filtrar Variables

Para facilitar, hay una serie de valores predefinidos disponibles para usar en el filtro.
Tenga en cuenta que estas variables también están disponibles cuando se evalúan las interfaces de las plantillas (pero
no plantillas de host).

Advertencia: los nombres de todas estas variables comienzan con un signo de dólar ($), que es un
requisito para variables escalares en Perl. El peligro aquí es que el signo de dólar en muchos
shells es un carácter activo (a menudo se usa para variables de shell exactamente como en Perl
variables) por lo que es importante asegurarse de que la expresión de Perl no sea evaluada por el
shell de línea de comando como código de shell antes de pasarlo a cfgmaker como línea de comando
argumentos. En shells como Bourne shell, ksh shell o bash shell, colocando todo el
La expresión dentro de qoutes individuales evitará dicha evaluación accidental:

'--if-filter = ($ default_iftype && $ if_admin)'

$ if_type
Este es un número entero que especifica el tipo de interfaz según los estándares SNMP y como
informado por el dispositivo encuestado. Una lista completa de tipos de interfaz sería
poco práctico para este documento, pero hay una serie de variables predefinidas a continuación.
Normalmente, cfgmaker pone en el PageTop del objetivo este valor iftype dentro de la paranthesis
después del nombre del tipo de interfaz. (por ejemplo, "propPointToPointSerial (22)").

Aquí hay una lista de algunos de los tipos de interfaz más comunes por número:

6 ethernetCsmacd
7 iso88023Csmacd
9 iso88025TokenRing
15 fdi
19 E1
20 básicoISDN
21 primarioISDN
22 propPuntoAPuntoSerial
23 ppp
24 software Loopback
30 ds3
32 frame relay
33 rs232
atm 37
39 soneto
Servicio de retransmisión de 44 fotogramas
46 hsi
49 aal5
53 propVirtual
62 FastEthernet (100BaseT)
63 ISDN y X.25
69 Fast Ethernet dúplex completo (100BaseFX)
94 Bucle de abonado digital asimétrico (ADSL)
117 Gigabit Ethernet
134 Subinterfaz ATM

$ predeterminado
Verdadero si y solo si cfgmaker normalmente debería aceptar la interfaz basada en el
Interfaces de estado administrativo y operativo (tomando las banderas --no-abajo y
--mostrar-op-abajo en cuenta) y su tipo (y algunas otras cosas).

$ default_ifstate
Verdadero si y solo si cfgmaker hubiera aceptado la interfaz basada en su
estados operativos y administrativos (teniendo en cuenta también la presencia del
banderas --no-abajo y --mostrar-op-abajo).

$ default_iftype
Verdadero si y solo si cfgmaker hubiera aceptado la interfaz en función de su tipo (y
algunos detalles específicos del tipo además).

$ if_admin
Verdadero si y solo si la interfaz está en un estado administrativo activo.

$ if_oper
Verdadero si y solo si la interfaz está en un estado operativo activo.

Varias variables también están predefinidas para decidir fácilmente si una interfaz pertenece a un
cierta categoría o no. A continuación se enumeran todas las variables junto con las que if_type
números para los que será verdadera cada variable. Tenga en cuenta que algunas variables se refieren a otras variables
.

$ if_is_ethernet
Verdadero para interfaces Ethernet (n. ° 6, 7, 26, 62, 69 y 117).

$ if_is_isdn
Verdadero para varios tipos de interfaz ISDN (no 20, 21, 63, 75, 76 y 77)

$ if_is_dialup
Verdadero para interfaces de acceso telefónico como PPP y ISDN. (nr 23, 81, 82 y 108 en
Además de los números de $ if_is_isdn).

$ if_is_atm
Verdadero para diversos tipos de interfaces relacionados con cajeros automáticos (n. ° 37, 49, 107, 105, 106, 114 y
134).

$ if_is_wan
Verdadero para interfaces WAN punto a punto, Frame Relay y Serie de alta velocidad (
22,32,44,46).

$ if_is_lan
Verdadero para las interfaces LAN (8, 9, 11, 15, 26, 55, 59, 60 y 115 además del
numeros de $ if_is_ethernet).

$ if_is_dsl
Verdadero para ADSL, RDSL, HDSL y SDSL (no 94, 95, 96, 97)

$ if_is_loopback
Verdadero para interfaces de bucle invertido de software (n ° 24)

$ if_is_ciscovlan
Verdadero para las interfaces VLAN de Cisco (interfaces con la palabra Vlan o VLAN en su
ifdescs)

$ if_vlan_id
Devuelve el vlan id asociado con un puerto específico en los switches Cisco Catalyst debajo
tanto Catalyst OS como IOS, y conmutadores 3Com. Si no es una interfaz vlan,
volver undef.

$ if_cisco_trunk
Devuelve el estado de enlace troncal de un puerto específico en los switches Cisco Catalyst en ambos
Catalyst OS e IOS. Devuelve "1" si la interfaz es un tronco, sin definir en caso contrario.

$ if_MTU
Devuelve la Unidad de transferencia máxima asociada con un puerto específico.

Además de eso, también puede utilizar las variables definidas para las plantillas a continuación. Además, todos
las variables disponibles en cfgmaker están a disposición de los scripts incluso si el uso de tales
Se desaconsejan las funciones. Más "atajos" en forma de variables y funciones serán
disponible en el futuro en su lugar.

Ejemplos on Filtros

El siguiente filtro no afectará las interfaces que se incluyan o excluyan, lo hará
hacer que cfgmaker se comporte normalmente.

'--if-filter = $ predeterminado'

El siguiente filtro hará que cfgmaker excluya las interfaces PPP (23):

'--if-filter = $ predeterminado && $ if_type! = 23'

El siguiente filtro hará que cfgmaker se comporte como de costumbre, excepto que considerará el
El estado operativo de una interfaz es irrelevante pero aún rechaza todas las interfaces que son
administrativamente abajo.

'--if-filter = $ if_admin && $ default_iftype'

Detalles on Plantillas
El contenido de los archivos de plantilla se evalúa como un programa Perl. Un número o Perl
las variables están disponibles para que el programa las lea y otras se utilizan para escribir.

Como algunas de las variables predefinidas tienen valores que se supone que deben usarse en
Código HTML, algunos de ellos tienen una variante "HTML-escapado", por ejemplo, $ html_syslocation es el HTML
variante de escape de $ syslocation. El escape HTML significa que los caracteres "<", ">" y "&"
se reemplazan por "<", ">" y "&" y las nuevas líneas incrustadas en la cadena son
precedido de " "y se agrega un carácter de espacio (si una nueva línea es la última en el
cuerda no se toca).

Writable Plantilla Variables

Estas son las variables disponibles para almacenar las líneas de configuración. Algunas de ellas son
inicializado antes de la evaluación de la plantilla, pero dicho contenido normalmente son comentarios
para su inclusión en el archivo de configuración final para que esas variables se puedan restablecer al
cadena vacía en el código de la plantilla para eliminar los comentarios. Al revés también es
posible, el contenido de estas variables podría ampliarse con más información para
Varias razones, como depuración, etc.

Una vez que se ha evaluado la plantilla, ocurre lo siguiente: si la plantilla es un
La plantilla de interfaz y la interfaz real por alguna razón se rechazan y, por lo tanto, es necesario
ser comentado, todas las líneas de la variable $ target_lines son convertidos en comentarios por
agregando una marca de almohadilla ("#") al principio. Entonces todas las variables $ titulares,
$ problem_lines , $ target_lines y $ separator_lines están concatenados juntos para formar el
líneas para agregar al archivo de configuración.

$ target_lines
Esta variable es el marcador de posición para las líneas de configuración creadas por la plantilla.
$ target_lines está predefinido para estar vacío cuando se evalúa el código de la plantilla.

$ titulares
Esta variable está destinada a ser el marcador de posición para la línea de comentario que aparece solo
antes del destino en el archivo de configuración. Se inicializa con esa línea de comentario.
antes de la evaluación del código de la plantilla y si la plantilla no se modifica
$ titulares durante la evaluación, el comentario se verá como de costumbre en el archivo de configuración.

$ problem_lines
Esta variable está destinada a ser el titular de las líneas de comentarios que describen cualquier
problemas que podrían haberse encontrado al intentar agregar el objetivo en el
configuración. En el caso de las plantillas de host, normalmente no se utiliza y en el caso de
predefinido como la cadena vacía. Para plantillas de interfaz $ problem_lines está predefinido
con los comentarios de descripción de error que cfgmaker normalmente usaría para rechazados
interfaces o como la cadena vacía para interfaces aceptadas.

Es posible probar contra $ problem_lines para saber si una interfaz será
incluido o rechazado, pero esto no se recomienda. Prueba contra $ if_ok preferiblemente.

$ separator_lines
Esta variable es el marcador de posición de la cadena que se utilizará como separador entre
código para objetivos individuales. El contenido de esta variable se coloca después de cada objetivo.
(por lo que las líneas también aparecerán después del final del último objetivo en la configuración).

predefinida Plantilla Variables

Todas las variables siguientes están disponibles para que las utilicen las plantillas de interfaz. Para plantillas de host,
sólo están disponibles los que se enumeran en "Variables del sistema y del host".

Para las plantillas de interfaz, las variables enumeradas en "Variables de filtro predefinidas" también se
para todos.

Anfitrión y System Variables

$ nombre_enrutador
Este es el nombre completo del enrutador. Se ve afectado por lo siguiente
elementos en la línea de comando: el nombre del enrutador y --dns-dominio.

$ router_connect
Esta es la cadena de referencia del enrutador que se está sondeando. Está en el formulario
community @ router posiblemente seguido de algunas opciones de snmp. Se ve afectado por el
siguientes elementos en la línea de comando: el nombre del enrutador en sí, --comunidad,
--snmp-opciones y --dns-dominio. (No hay ninguna variante de escape HTML disponible)

$ nombre_directorio
Esta variable debe contener el nombre del directorio como cfgmaker normalmente usaría como
valor para la directiva "Directorio []". El valor está determinado por el --subdirectores
opción de línea de comando. Si --subdirectores no está especificado $ nombre_directorio será el vacío
cuerda. (No hay ninguna variante de escape HTML disponible)

$ syscontact
Esta variable es el valor sysContact de SNMP del enrutador. (Variante de escape HTML:
$ html_syscontact)

$ sysname
Esta variable es el valor SNMP sysName del enrutador. (No hay ninguna variante de escape HTML disponible)

$ syslocation
Esta variable es el valor de sysLocation SNMP del enrutador. (Variante de escape HTML:
$ html_syslocation)

$ sysdescr
Esta variable es el valor sysDescr SNMP del enrutador. Normalmente no es utilizado por
cfgmaker, pero podría ser útil en una plantilla. (Variante de escape HTML: $ html_sysdescr)

Interfaz Target Relacionado: Variables

$ target_name
Esto es lo que cfgmaker normalmente usaría como el nombre del objetivo. El objetivo
nombre es lo que se encuentra entre corchetes, "[]", para las directivas de destino.
(No hay ninguna variante de escape HTML disponible)

$ if_ref
Esta es la cadena de referencia para la interfaz. Se espera que se utilice en el
Directiva "Target [xyz]" para distinguir qué interfaz usar. El valor de esto
variable se ve afectada por la --si ref opción de línea de comando. Normalmente se usa junto
$ router_connect. (No hay ninguna variante de escape HTML disponible)

$ if_ok
Esta variable es verdadera si la interfaz se va a incluir en la configuración.
archivo, de lo contrario falso. No pruebe con otras variables como $ problem_lines a
averigüe si una interfaz será rechazada o no, use esto $ if_ok preferiblemente.

$ default_target_lines
Esta variable contiene todas las líneas de destino que cfgmaker produce por defecto para este
interfaz. Es útil si desea tener el "objetivo estándar" pero desea agregar algunos
líneas adicionales mediante el uso de una plantilla.

De forma predeterminada, cfgmaker usa las siguientes directivas para cada objetivo que genera: Target [],
SetEnv [], MaxBytes [], Título [], PageTop [] y si hay algún directorio especificado también el
Directiva de directorio [].

Para facilitar la creación de plantillas que generan configuraciones de destino que son similares
a la predeterminada, cada una de las líneas directivas mencionadas anteriormente tiene un correspondiente
La variable que contiene la línea como cfgmaker la habría generado de forma predeterminada.

Tenga en cuenta que ninguno de estos tiene una variante de escape HTML, el texto en ellos es HTML escapado donde
necesario. También tenga en cuenta que no tienen ninguna línea nueva al final.

$ default_target_directive
Esta variable contiene la cadena predeterminada para la línea de directiva Target [].

$ default_setenv_directive
Esta variable contiene la cadena predeterminada para la línea de directiva SetEnv [].

$ default_directory_directive
Esta variable contiene la cadena predeterminada para la línea de directiva Directory [] que
significa que es una cadena vacía (sin nueva línea) si no hay directorio.

$ default_maxbytes_directive
Esta variable contiene la cadena predeterminada para la línea de directiva MaxBytes [].

$ default_title_directive
Esta variable contiene la cadena predeterminada para la línea de la directiva Título [].

$ default_pagetop_directive
Esta variable contiene la cadena predeterminada para las líneas de la directiva PageTop [].

Interfaz Nuestra red Configuración Variables

$ if_ip
Esta variable debe contener la dirección IP de la interfaz, si se ha asignado alguna
lo. (No hay ninguna variante de escape HTML disponible)

$ ifindex
Esta variable es el ifIndex de SNMP para la interfaz que, por definición, siempre es un
entero. (No hay ninguna variante de escape HTML disponible)

$ if_index
Equivalente a $ ifindex.

$ if_eth
Contiene la dirección Ethernet de la interfaz, si la hubiera. (No hay HTML escapado
variante disponible)

$ if_speed
Esta variable es la velocidad en bytes / segundo (con prefijos). (No hay HTML escapado
variante disponible)

$ if_speed_str
Esta variable es una descripción de velocidad cocida que está en bits o bytes dependiendo
si la opción de bits está activa o no y también con el prefijo adecuado para el
velocidad (k, M, G, etc.). (No hay ninguna variante de escape HTML disponible)

$ if_type_desc
Esta variable es una descripción textual del tipo de interfaz. (Variante de escape HTML:
$ html_if_type_desc)

$ if_type_num
Esta variable el valor entero correspondiente al tipo de interfaz (para un listado de
el valor para los tipos de interfaz más comunes, consulte la sección DETALLES SOBRE LOS FILTROS
sobre). (No hay ninguna variante de escape HTML disponible)

$ if_dns_name
Este es el nombre DNS de la interfaz. (No hay ninguna variante de escape HTML disponible)

Interfaz Nombre, Descripción y alias Variables

Puede parecer confuso con ambos Nombre, Descripción y alias en este contexto y para algunos
medida que es. Nombre y Descripción generalmente son compatibles con la mayoría de los equipos, pero cómo
se utilizan varía, tanto entre fabricantes como entre diferentes categorías de
equipos del mismo fabricante. El alias es al menos compatible con Cisco IOS, y
esa variable contiene todo lo que se utiliza en la declaración de IOS llamada "descripción" para el
interfaz (no confundir con las variables SNMP para Descripción).

Para un mejor control desde la línea de comandos, considere $ if_title_desc que contenidos son
controlado por el --si-descr opción de línea de comando.

$ if_snmp_descr
Esta variable debe contener la descripción "sin procesar" de la interfaz según lo determinado por
el sondeo SNMP del enrutador. (Variante de escape HTML: $ html_if_snmp_descr)

$ if_snmp_name
El nombre "sin formato" de la interfaz proporcionado por el sondeo SNMP. (Variante de escape HTML:
$ html_if_snmp_name)

$ if_snmp_alias
El ifAlias ​​"sin procesar" para la interfaz proporcionado por el sondeo SNMP. (HTML escapado
variante: $ html_if_snmp_alias)

$ if_cisco_descr
El CiscolocIfDescr "sin procesar" para la interfaz proporcionada por el sondeo SNMP. (HTML
variante escapada: $ html_if_cisco_descr)

$ if_description
Esta es la cadena de descripción "preparada" para la interfaz, teniendo en cuenta la
Valores SNMP encontrados para RDescr, ifAlias ​​y CiscolocIfDescr de la interfaz. (HTML
variante escapada: $ html_if_description)

$ if_title
La cadena completa cfgmaker por defecto se habría utilizado para la directiva Title [] en el
configuración, así como el contenido de la etiqueta H1 superior en PageTop []. Es
compuesto por el contenido de $ desc_prefix, $ if_title_desc y $ sysname.

As $ if_title depende $ if_title_desc, es posible controlar indirectamente $ if_title
usando la opción de línea de comando --si-descr.

(Variante de escape HTML: $ html_if_title)

$ if_port_name
Si el host es un conmutador LAN Cisco Catalyst, esta variable es el nombre de ese puerto.
(No hay ninguna variante de escape HTML disponible)

$ if_pp_port_name
Si el host es un conmutador LAN Nortel Passport, esta variable es el nombre de ese puerto.
(No hay ninguna variante de escape HTML disponible)

$ desc_prefix
Esta variable es un prefijo de la descripción de lo que el objetivo va a usar en el
Directiva "Título []" y en la sección H1 de "PageTop []". El valor predeterminado es "Tráfico
análisis para ". (HTML escapado variante: $ html_desc_prefix)

$ if_title_desc
Esta es la descripción de la interfaz que normalmente usa cfgmaker como parte del
variable $ if_title. Este último se utiliza como la cadena completa en la dirección "Título []".
y la sección H1 en PageTop [].

$ if_title_desc está controlado por la opción de línea de comando --si-descr que indirectamente
controla el contenido de $ if_title

(Variante de escape HTML: $ html_if_title_desc)

Ayuda Clave para Plantillas

Las siguientes funciones existen para facilitar la escritura de plantillas de interfaz y host.

html_escape (cadena)
html_escape () toma una cadena como argumento y devuelve una nueva cadena donde el
se han realizado las siguientes sustituciones: los caracteres "<", ">" y "&" se sustituyen por
"<", ">" y "&" y que las nuevas líneas incrustadas en la cadena se anteponen con
" "y se agrega con un carácter de espacio (las nuevas líneas al final de la cadena no son
tocado).

oid_pick ($ router_connect, $ v3opt, "oid1", "oid2" ...)
Esta función intentará sondear cada uno de los oids especificados hasta que tenga éxito o
se ha quedado sin oids. Devolverá el nombre del primer oid que funcionó o undef si
no es exitoso

Ejemplo Plantilla archivos

Ejemplo de plantilla 1: eliminación de la aparición de objetivos rechazados

Este archivo de plantilla genera exactamente el mismo código de configuración por interfaz que cfgmaker
lo hace de forma predeterminada, con la excepción de que elimina todas las líneas (comentarios y
config code) para una interfaz si la interfaz resulta ser rechazada.

si (no $ problem_lines)
{
$ target_lines. = <

Objetivo [$ target_name]: $ if_ref: $ router_connect
SetEnv [$ target_name]: MRTG_INT_IP = "$ if_ip" MRTG_INT_DESCR = "$ if_snmp_descr"
ECHO

if ($ nombre_directorio) {
$ target_lines. = "Directorio [$ target_name]: $ directorio_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 en $ html_syslocation


Mantenedor:
$ html_syscontact


Descripción:
$ html_if_description


ifType:
$ html_if_type_desc ($ if_type_num)


ifName:
$ html_if_snmp_name

ECHO

$ target_lines. = <

Nombre del puerto:
$ if_port_name

ECHO

$ target_lines. = <

Nombre del puerto:
$ if_pp_port_name

ECHO

$ target_lines. = <

Máxima velocidad:
$ 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 = "";
}

Plantilla Ejemplo 2: Más simple Versión of Ejemplo 1

El ejemplo 1 estaba destinado en parte a demostrar cómo personalizar la generación de interfaz
objetivos, sino también para proporcionar una pista de cómo se utilizan las variables en la plantilla "predeterminada"
que se podría considerar que normalmente usa cfgmaker.

Si solo está interesado en la forma más fácil de eliminar por completo los rechazos
interfaces, la plantilla a continuación también haría el trabajo usando $ default_target_lines.

if ($ if_ok) {
$ target_lines = $ default_target_lines;
} Else {
$ head_lines = "";
$ problem_lines = "";
$ target_lines = "";
$ separator_lines = "";
}

Plantilla Ejemplo 3: Creamos CPU Orden de Targets o Metas para Tu guía

A continuación se muestra un ejemplo de una plantilla de host.

$ titulares. = <
# ------------------------------------------------- --------------------
ECHO

my $ target_name = $ nombre_enrutador. ".UPC";

$ target_lines. = <

YLegend [$ target_name]: Porcentaje de carga de CPU
ShortLegend [$ target_name]:%
Legend1 [$ target_name]: carga de CPU en%
Leyenda2 [$ target_name]:
Legend3 [$ target_name]: carga máxima de CPU observada
Leyenda4 [$ target_name]:
LegendI [$ target_name]: Carga de CPU:
LegendO [$ target_name]:
WithPeak [$ target_name]: ywm
MaxBytes [$ target_name]: 100
Opciones [$ target_name]: growright, gauge, nopercent
Título [$ target_name]: $ router_name carga de CPU
Destino [$ target_name]: 1.3.6.1.4.1.9.2.1.58.0 y 1.3.6.1.4.1.9.2.1.58.0: $ router_connect
PageTop [$ target_name]: $ router_name carga de CPU
<div></div>


Sistema:
$ nombre_enrutador en $ html_syslocation


Mantenedor:
$ html_syscontact


Descripción:
$ html_sysdescr


Recurso:
UPC.


</div>
ECHO

EJEMPLOS

El primer ejemplo crea un archivo de configuración para enrutador.lugar.xyz: el enrutador tiene el
nombre de la comunidad público. Las interfaces se identifican por su número de IP. Dos opciones globales
ser agregado al archivo de configuración. El archivo de configuración se redirige a mrtg.conf. El '\'
Los signos al final de la línea significan que este comando debe escribirse en una sola línea.

cfgmaker --global "WorkDir: / home / tobi" \
--global "Opciones [_]: growright, bits" \
--ifref = ip \
[email protected] > mrtg.cfg

Nota: si cfgmaker no está en su ruta, pero está en el directorio donde está cfgmaker
almacenado, puede iniciarlo con ./cfgmaker

El siguiente ejemplo crea un archivo de configuración para cuatro dispositivos: enrutador1.lugar.xyz,
enrutador2.lugar.xyz, interruptor1.lugar.xyz y interruptor2.lugar.xyz todo con la comunidad público.

Los dos enrutadores tendrán --si ref establecido en descripción mientras que los dos interruptores usarán --si ref
establecido en nombre . Además, los enrutadores utilizarán --ifdesc establecido en alias y interruptor1.lugar.xyz
utilizará --ifdesc establecido en descripción mientras que interruptor2.lugar.xyz utilizan el nombre preferiblemente.

Finalmente, habrá dos líneas de Opciones insertadas en la configuración: Una estará en el
al principio, mientras que el otro se insertará después de las líneas relacionadas con los dos enrutadores
pero antes de esas líneas relacionadas con los interruptores.

cfgmaker --global "WorkDir: / home / tobi" \
--global "Opciones [_]: growright, bits" \
--ifref = descr \
--ifdesc = alias \
[email protected] \
[email protected] \
--global "Opciones [_]: growright" \
--ifref = nombre \
--ifdesc = descr \
[email protected] \
--ifdesc = nombre \
[email protected] > mrtg.cfg

El siguiente ejemplo demuestra cómo utilizar el --comunidad, --snmp-opciones y --dns-dominio
para simplificar la línea de comandos. Todo el equipo lo usará la comunidad. oculto, excepto
para el servidor ppp que usa community de la máquina. Todos los equipos utilizan estas opciones de SNMP: 1s
tiempo de espera, 1 rever y SNMP versión 2 (Apártate y Puerto no está especificado, lo que significa que usan
los valores predeterminados). La excepción de nuevo es el servidor ppp que usa SNMP versión 1.
Finalmente, todo el equipamiento es parte del dominio. lugar.xyz, a excepción del servidor ppp
que es parte del dominio lugar.remoto.xyz. Tenga en cuenta que esto último se logra simplemente
especificando el nombre del servidor ppp a ser servidor ppp.sanaciones .

cfgmaker --global "WorkDir: / home / tobi" \
--global "Opciones [_]: growright, bits" \
--dns-domain = place.xyz \
--comunidad = oculta \
--snmp-options = :: 1: 1 :: 2 \
enrutador1 \
enrutador2 \
enrutador3 \
enrutador4 \
enrutador5 \
interruptor1 \
interruptor2 \
interruptor3 \
interruptor4 \
interruptor5 \
interruptor6 \
interruptor7 \
[email protected]::::: 1> mrtg.cfg

Use cfgmaker en línea usando los servicios de onworks.net