inject_fake_events.pl

Utilice el script inject_fake_events.pl Perl para inyectar sucesos falsos en entidades e interfaces especificadas en la base de datos de topología de NCIM.

Puede utilizar este script para aportar sucesos falsos en entidades que coinciden con una serie especificada junto con todas las interfaces en esas entidades. A menos que se especifique lo contrario, el script aportará sucesos en entidades de los siguientes tipos:

1: Dispositivos de chasis
2: Interfaces
8: Tarjetas hijas

En caso contrario, puede especificar uno o más de los tres tipos de entidad listados sobre los que aportar sucesos falsos.

El script aporta dos tipos de sucesos:

Sucesos PingFail
- Los sucesos aportados en entidades de chasis son siempre sucesos PingFail. Estos sucesos tiene NmosEventMap establecido en 'PrecisionMonitorEvent.300', donde 300 es el valor con prioridad.
- Los sucesos en interfaces son sucesos PingFail si la interfaz tiene una dirección IP. En este caso, estos sucesos tienen NmosEventMap establecido en PrecisionMonitorEvent.300, donde 300 es el valor con prioridad.
Sucesos LinkState: los sucesos en interfaces son sucesos LinkState si la interfaz no tiene una dirección IP. En este caso, estos sucesos tienen NmosEventMap establecido en PrecisionMonitorEvent.910, donde 910 es el valor con prioridad.

El resultado de configuración del valor NmosEventMap es que la Pasarela de sucesos utiliza sólo NmosEntityId para ubicar la entidad exacta a la que pertenece el suceso.

Si desea aportar sucesos en muchas entidades con nombres muy diferentes, ejecute el script de Perl inject_fake_events.pl varias veces utilizando diferentes valores para el parámetro -entityNameString en cada caso. Para hacer que este proceso sea más sencillo, ejecute este script varias veces con diferentes argumentos utilizando un script de shell Bash.

Ejecución del script

Los ejemplos siguientes muestran cómo ejecutar el script:

Inyecte un suceso en una única entidad de chasis denominada "BakerStreetWAN4".

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/inject_fake_events.pl -domain NCOMS -entityNameString 
"BakerStreetWAN4" -entityType 1

Inyecte un suceso en una única interfaz denominada "BakerStreetWAN4[ 0 [ 747 ]

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/inject_fake_events.pl -domain NCOMS -entityNameString 
"BakerStreetWAN4[ 0 [ 747 ] ]" -entityType 1

Inyecte sucesos en todas las entidades de chasis coincidentes y sus interfaces para dispositivos con un nombre como "BakerStreetWAN4"

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/inject_fake_events.pl -domain NCOMS -entityNameString 
"BakerStreetWAN4"

Este ejemplo es similar al ejemplo 3 pero con un parámetro -interfaceDescriptionString para restringir la búsqueda únicamente a interfaces FastEthernet.

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/inject_fake_events.pl -domain NCOMS -entityNameString 
"BakerStreetWAN4" -interfaceDescriptionString "FastEthernet" -entityType 2

Este ejemplo es similar al ejemplo 4, pero utilizando una descripción de interfaz de "Fa2"

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/inject_fake_events.pl -domain NCOMS -entityNameString 
"BakerStreetWAN4" -interfaceDescriptionString "Fa2" -entityType 2

Este ejemplo es similar al ejemplo 5, pero aportando sucesos también en las entidades de chasis

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/inject_fake_events.pl -domain NCOMS -entityNameString 
"BakerStreetWAN4" -interfaceDescriptionString "Fa2"

Cree sucesos de resolución para esos sucesos generados por el ejemplo 6 añadiendo simplemente la opción de línea de mandatos -resolution. Tivoli Netcool/OMNIbus finalmente suprimirá los sucesos de problema y sus sucesos de resolución coincidentes.
```
$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/inject_fake_events.pl -domain NCOMS -entityNameString 
"BakerStreetWAN4" -interfaceDescriptionString "Fa2" -entityType 2 -resolution
```

Para ver las consultas SQL que se están ejecutando, utilice la opción de línea de mandatos -debug 1.

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/inject_fake_events.pl -domain NCOMS -entityNameString 
"BakerStreetWAN4" -debug 1

Para ver las consultas SQL y las entidades encontradas, utilice la opción de línea de mandatos -debug 2.

$NCHOME/precision/bin/ncp_perl $NCHOME/precision/scripts/perl/scripts/inject_fake_events.pl -domain NCOMS -entityNameString 
"BakerStreetWAN4" -debug 2

Opciones de línea de mandatos

La siguiente tabla describe las opciones de línea de mandatos para el script.

Tabla 1. inject_fake_events.pl opciones de la línea de comandos
Opción de línea de mandatos	Descripción
-domain `NombreDominio`	Necesario: El nombre del dominio que contiene las entidades en las que aportar los sucesos.
-entityNameString `serie`	Series utilizadas para hacer coincidir los nombres de entidad donde se van a aportar los sucesos. El script utiliza este argumento para producir una cláusula WHERE de SQL para buscar un entityName `LIKE "%string%"` en el campo entityName de la vista de entidad de base de datos de topología NCIM.
-entityType `entityType`	Opcional: Tipo de entidad al que se van a aportar los sucesos. Debe ser 1, 2 u 8. Si no se especifica este parámetro, los sucesos se inyectan en entidades de los tres tipos de entidad.
-interfaceDescriptionString `serie`	Opcional: Serie utilizada para hacer coincidir los campos ifName y ifDescr en la vista de interfaz de la base de datos de topología NCIM como método para filtrar más las entidades donde se van a aportar los sucesos. El script utiliza este argumento para producir una cláusula WHERE de SQL para buscar un nombre `LIKE "%string%"` en los campos ifName y ifDescr en la vista de interfaz de la base de datos de topología NCIM.
-resolution	Opcional: De forma predeterminada, sólo se aportan los sucesos de problema. El argumento -resolution aporta sucesos de resolución en lugar de sucesos de problemas.
-latencia `latencia`	Opcional: el tiempo máximo de espera en milisegundos entre intentos para enviar un mensaje. Es necesario para redes con mucho tráfico.
-debug `número`	Opcional: Especifica una de las siguientes opciones dependiendo del detalle de depuración que necesite: Especifique `-debug 1` para ver las consultas SQL que se ejecutan. Especifique `-debug 2` para ver las consultas SQL que se ejecutan y los dispositivos encontrados por las consultas.
-help	Proporciona ayuda sobre el mandato.