Académique Documents
Professionnel Documents
Culture Documents
Versin 6.2.0
SC11-3144-01
Versin 6.2.0
SC11-3144-01
Nota Antes de utilizar esta informacin y el producto al que da soporte, lea la informacin que figura en el Apndice L, Avisos, en la pgina 281.
Esta edicin se aplica a la versin 6, release 2, modificacin 0 de IBM Tivoli Monitoring (nmero de producto 5724-C04) y a todos los releases y modificaciones siguientes a no ser que se afirme lo contrario en nuevas ediciones. Copyright International Business Machines Corporation 2003, 2007. Reservados todos los derechos.
Contenido
Figuras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii Tablas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Acerca de esta publicacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii A quin va destinada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii Publicaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii Biblioteca de IBM Tivoli Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . xvii IBM Tivoli Open Process Automation Library (OPAL) . . . . . . . . . . . . . . . . . . xviii Acceso a la terminologa en lnea . . . . . . . . . . . . . . . . . . . . . . . . . xviii Acceso a las publicaciones en lnea . . . . . . . . . . . . . . . . . . . . . . . . xviii Solicitud de publicaciones . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii Accesibilidad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix Formacin tcnica de Tivoli . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix Informacin de soporte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix Convenios empleados en esta gua . . . . . . . . . . . . . . . . . . . . . . . . . . xix Convenios de tipo de letra . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx Variables y vas de acceso que dependen del sistema operativo . . . . . . . . . . . . . . xx Sintaxis de mandatos de Tivoli . . . . . . . . . . . . . . . . . . . . . . . . . . . xx Captulo 1. Visin general de Tivoli Universal Agent . . Funcionamiento de Tivoli Universal Agent . . . . . . . Definicin de datos para Tivoli Universal Agent . . . . . Suministro de datos a Tivoli Universal Agent . . . . . . Trabajo con los datos . . . . . . . . . . . . . . Un caso de supervisin sencillo . . . . . . . . . . Seleccin del proveedor de datos . . . . . . . . . Preparacin de la fuente de datos . . . . . . . . . Definicin de la aplicacin de Tivoli Universal Agent . . Visualizacin de datos de atributos desde FTPLOGFILE Creacin de una poltica de automatizacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1 4 4 5 5 5 6 6 7 7
Captulo 2. Cmo comenzar . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Introduccin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Configuracin de Tivoli Universal Agent . . . . . . . . . . . . . . . . . . . . . . . . 9 Seleccin de un proveedor de datos . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Seleccin de los datos que se desean supervisar . . . . . . . . . . . . . . . . . . . . 9 Determinacin de la ubicacin de los datos . . . . . . . . . . . . . . . . . . . . . . 9 Determinacin del proveedor de datos . . . . . . . . . . . . . . . . . . . . . . . . 10 Determinacin del nmero necesario de agentes de Tivoli Universal Agent . . . . . . . . . . . 10 Determinacin de cuntas instancias de Tivoli Universal Agent se pueden ejecutar en el mismo host 11 Determinacin de cuntos proveedores de datos se pueden iniciar con un Tivoli Universal Agent 11 Establecimiento de las variables de entorno . . . . . . . . . . . . . . . . . . . . . . . 11 Nombre y ubicacin del archivo de variables de entorno . . . . . . . . . . . . . . . . . 11 Edicin de variables de entorno en los sistemas operativos Windows . . . . . . . . . . . . 12 Edicin de variables de entorno en los sistemas operativos UNIX . . . . . . . . . . . . . . 12 Establecimiento del directorio de trabajo . . . . . . . . . . . . . . . . . . . . . . . 12 Utilizacin de las variables de entorno para determinar los nombres de host de las aplicaciones 13 Inicio de Tivoli Universal Agent y de sus proveedores de datos. . . . . . . . . . . . . . . . 14 Especificacin de proveedores de datos . . . . . . . . . . . . . . . . . . . . . . . 15 Especificacin de parmetros de inicio en los sistemas operativos Windows . . . . . . . . . . 15 Especificacin de parmetros de inicio en los sistemas operativos UNIX . . . . . . . . . . . 16
iii
Captulo 3. Creacin de una aplicacin . . . . . . . . . . . . . . . . . . Introduccin a la aplicacin de Tivoli Universal Agent . . . . . . . . . . . . . . Creacin de una aplicacin de Tivoli Universal Agent . . . . . . . . . . . . . . Construccin de un metarchivo de definicin de datos . . . . . . . . . . . . . . Denominacin de metarchivos . . . . . . . . . . . . . . . . . . . . . . Creacin de ayuda para aplicaciones, grupos de atributos y atributos . . . . . . . Almacenamiento de metarchivos . . . . . . . . . . . . . . . . . . . . . Validacin de las definiciones de datos . . . . . . . . . . . . . . . . . . . Ejecucin del programa de validacin . . . . . . . . . . . . . . . . . . . Ejemplo de salida de informe de validacin . . . . . . . . . . . . . . . . . Activacin de metarchivos . . . . . . . . . . . . . . . . . . . . . . . . Activacin de metarchivos mediante mandatos de consola . . . . . . . . . . . Activacin de metarchivos mediante los mandatos de Actuacin . . . . . . . . . Activacin de metarchivos con un archivo de configuracin . . . . . . . . . . . Creacin de un servidor de metarchivos . . . . . . . . . . . . . . . . . . . Designacin de un servidor de metarchivos . . . . . . . . . . . . . . . . . Almacenamiento de metarchivos de servidor . . . . . . . . . . . . . . . . Determinacin de los roles de cliente y servidor en el mismo host . . . . . . . . Sincronizacin del servidor y el cliente de metarchivos . . . . . . . . . . . . . Alteracin temporal de la definicin central de metarchivo . . . . . . . . . . . Interaccin con otros componentes de IBM Tivoli Monitoring . . . . . . . . . . . Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent . . . . . . . . Incremento del nmero de versin y de los nmeros de modificacin . . . . . . . Otras versiones de los sistemas gestionados, espacios de trabajo y grupos de atributos Cambios que no afectan al nmero de modificacin o de versin . . . . . . . . . Cambios que afectan al nmero de modificacin (cambios de menor importancia) . . Cambios que afectan al nmero de versin (cambios de gran importancia) . . . . . Restablecimiento de los nmeros de versin . . . . . . . . . . . . . . . . Aplicaciones SNMP de Tivoli Universal Agent . . . . . . . . . . . . . . . . . Nombres de metarchivos . . . . . . . . . . . . . . . . . . . . . . . . Ubicacin de los metarchivos SNMP . . . . . . . . . . . . . . . . . . . Importacin de metarchivos SNMP . . . . . . . . . . . . . . . . . . . . Metarchivos SNMP slo de condicin de excepcin . . . . . . . . . . . . . . Mantenimiento de versiones de aplicaciones . . . . . . . . . . . . . . . . Visualizacin de metarchivos de aplicaciones . . . . . . . . . . . . . . . . Creacin de aplicaciones SNMP personalizadas . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17 17 17 17 19 19 20 20 21 21 21 21 22 24 25 25 25 25 26 26 26 27 27 27 28 28 29 29 32 33 33 34 34 34 34 35 37 37 37 38 41 41 41 42 42 43 43 43 44 44 44 44 45 45 45
Captulo 4. Acerca de los proveedores de datos . . . . . . . . . . . . . . . . . . Visin general de los proveedores de datos . . . . . . . . . . . . . . . . . . . . . Tipos de proveedores de datos . . . . . . . . . . . . . . . . . . . . . . . . Ejecucin de varias instancias de un proveedor de datos . . . . . . . . . . . . . . . Proveedor de datos de servidor de API . . . . . . . . . . . . . . . . . . . . . . Invocacin de las API . . . . . . . . . . . . . . . . . . . . . . . . . . . . Paquete de cliente de API . . . . . . . . . . . . . . . . . . . . . . . . . . Invocacin de programas . . . . . . . . . . . . . . . . . . . . . . . . . . Mandatos de consola API . . . . . . . . . . . . . . . . . . . . . . . . . . Especificacin del host del proveedor de datos de servidor de API . . . . . . . . . . . Especificacin del puerto de escucha del proveedor de datos del servidor de API . . . . . . Nombres de sistemas gestionados de aplicaciones del proveedor de datos de servidor de API . Proveedor de datos de archivo . . . . . . . . . . . . . . . . . . . . . . . . . Ubicacin del proveedor de datos de archivo . . . . . . . . . . . . . . . . . . . Nombres de sistemas gestionados en las aplicaciones del proveedor de datos de archivo . . Frecuencia de muestreo de archivos . . . . . . . . . . . . . . . . . . . . . . Rutinas de extraccin especiales . . . . . . . . . . . . . . . . . . . . . . . . Entrada de varios registros . . . . . . . . . . . . . . . . . . . . . . . . . . Supervisin de archivos globalizados . . . . . . . . . . . . . . . . . . . . . .
iv
Soporte de nombres de archivo dinmicos . . . . . . . . . . . . . . . . . . . . . Proceso de un archivo desde el principio . . . . . . . . . . . . . . . . . . . . . . Espacio de archivo preasignado . . . . . . . . . . . . . . . . . . . . . . . . . Opciones adicionales de supervisin de archivos . . . . . . . . . . . . . . . . . . . Proveedor de datos de HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . Inicio del proveedor de datos de HTTP . . . . . . . . . . . . . . . . . . . . . . Nombre de sistema gestionado de la aplicacin de proveedor de datos de HTTP . . . . . . . Supervisin de un URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . Atributos de URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Proveedor de datos de ODBC . . . . . . . . . . . . . . . . . . . . . . . . . . . Inicio del proveedor de datos de ODBC . . . . . . . . . . . . . . . . . . . . . . Nombres de sistemas gestionados de aplicaciones del proveedor de datos de ODBC . . . . . Metarchivos ODBC de muestra . . . . . . . . . . . . . . . . . . . . . . . . . Parmetros y sentencias . . . . . . . . . . . . . . . . . . . . . . . . . . . . Generacin automtica de metarchivos ODBC . . . . . . . . . . . . . . . . . . . . Proveedor de datos de envo . . . . . . . . . . . . . . . . . . . . . . . . . . . Configuracin predeterminada . . . . . . . . . . . . . . . . . . . . . . . . . . Nombre de sistema gestionado de la aplicacin de proveedor de datos de envo . . . . . . . Categoras de mensajes . . . . . . . . . . . . . . . . . . . . . . . . . . . . Indicacin de reconocimiento . . . . . . . . . . . . . . . . . . . . . . . . . . Personalizacin del proveedor de datos de envo con el metarchivo KUMPOST . . . . . . . Personalizacin de las especificaciones en tiempo de ejecucin del proveedor de datos de envo Datos suministrados por el proveedor de datos de envo . . . . . . . . . . . . . . . . El programa KUMPSEND . . . . . . . . . . . . . . . . . . . . . . . . . . . Cdigos de retorno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Envo de datos al proveedor de datos de envo . . . . . . . . . . . . . . . . . . . Proveedor de datos de script . . . . . . . . . . . . . . . . . . . . . . . . . . . Metarchivos de script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ubicacin del proveedor de datos de script . . . . . . . . . . . . . . . . . . . . . Utilizacin del proveedor de datos de script . . . . . . . . . . . . . . . . . . . . . Variables de entorno de script . . . . . . . . . . . . . . . . . . . . . . . . . . Modalidades de ejecucin de script . . . . . . . . . . . . . . . . . . . . . . . . Directorio de scripts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Nombres de sistemas gestionados de aplicaciones del proveedor de datos de script . . . . . Autentificacin de script . . . . . . . . . . . . . . . . . . . . . . . . . . . . Manejo de errores de script . . . . . . . . . . . . . . . . . . . . . . . . . . . Tiempos de espera excedidos de los scripts . . . . . . . . . . . . . . . . . . . . Metarchivo de ejemplo de script . . . . . . . . . . . . . . . . . . . . . . . . . Proveedor de datos de SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . Inicio del proveedor de datos de SNMP . . . . . . . . . . . . . . . . . . . . . . Nombres de sistemas gestionados de las aplicaciones del proveedor de datos de SNMP . . . . Caractersticas del proveedor de datos de SNMP. . . . . . . . . . . . . . . . . . . Especificacin de nombres de comunidad . . . . . . . . . . . . . . . . . . . . . Asignacin de nombres de red simblicos . . . . . . . . . . . . . . . . . . . . . Aplicacin SNMP-MANAGER . . . . . . . . . . . . . . . . . . . . . . . . . . Envo de condiciones de excepcin de SNMP al proveedor de datos . . . . . . . . . . . Supervisin de las aplicaciones SNMP . . . . . . . . . . . . . . . . . . . . . . Proveedor de datos de socket . . . . . . . . . . . . . . . . . . . . . . . . . . Establecimiento de contacto con el proveedor de datos de socket . . . . . . . . . . . . Modificacin del puerto de escucha predeterminado . . . . . . . . . . . . . . . . . Conversin de nombres de host y de direcciones TCP/IP . . . . . . . . . . . . . . . Varias mquinas host . . . . . . . . . . . . . . . . . . . . . . . . . . . . Nombres de sistemas gestionados de aplicaciones del proveedor de datos de socket . . . . . Asociacin de fuentes de datos con metarchivos . . . . . . . . . . . . . . . . . . Formato de un almacenamiento intermedio de sockets para la transmisin . . . . . . . . . Tiempo de espera excedido . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . .
Contenido
Envo de mandatos de accin a clientes de socket . Registro CLEAR-PRIOR-DATA . . . . . . . . Fin de sesin de la entrada de datos . . . . . . Conversin de cdigo de caracteres . . . . . . Utilizacin del formato de caracteres para los datos Deteccin de interrupciones TCP . . . . . . . Retraso de la notificacin de desconexin TCP . . Reconocimiento de datos . . . . . . . . . . Limitaciones del proveedor de datos de socket . .
. . . . . . . . . . . . . . . . numricos . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
108 109 109 109 110 110 111 111 111 113 113 113 114 114 114 115 115 115 116 116 116 117 117 117 118 119 119 119 120 120 120 121 121 121 123 123 124 124 124 124 125 125 125 129 129 130 130 130 130 131 131 131 131
Captulo 5. Supervisin de aplicaciones . . . . . . . . . Supervisin de los datos de Tivoli Universal Agent . . . . . . Sistemas gestionados por Tivoli Universal Agent . . . . . . Nombres de sistemas gestionados . . . . . . . . . . . Truncamiento de los nombres de sistemas gestionados . . . Nmeros de versin de sistemas gestionados . . . . . . Cambios de versin de sistemas gestionados . . . . . . Espacios de trabajo de aplicaciones . . . . . . . . . . . Fsica . . . . . . . . . . . . . . . . . . . . . Lgica . . . . . . . . . . . . . . . . . . . . . Personalizacin del contenido de espacios de trabajo . . . . Acceso a la ayuda para grupos de atributos y atributos . . . Espacios de trabajo UAGENT . . . . . . . . . . . . . Nombres de sistemas gestionados de UAGENT . . . . . . Espacio de trabajo DPLOG . . . . . . . . . . . . . Espacio de trabajo ACTION . . . . . . . . . . . . . Situaciones de Tivoli Universal Agent . . . . . . . . . . . Acerca de las situaciones predefinidas . . . . . . . . . Utilizacin de situaciones . . . . . . . . . . . . . . Nombres de atributos y grupos de atributos . . . . . . . Creacin de situaciones con atributos de distintos grupos . . Distribucin de situaciones a sistemas gestionados . . . . Intervalo de situacin y valor de tiempo de vida (TTL) . . . Reglas especiales para conjuntos de muestras de varias filas Recopilacin de datos histricos . . . . . . . . . . . . Captulo 6. Introduccin al emisor de SNMP . . . . . . Visin general del emisor de SNMP . . . . . . . . . . Variables de entorno del emisor de SNMP . . . . . . . Instalacin e integracin del emisor de SNMP . . . . . . Instalacin del emisor de SNMP . . . . . . . . . . Integracin del emisor de SNMP en soluciones de terceros Visualizacin de los datos del emisor de SNMP . . . . . Utilizacin del emisor de SNMP y sus datos . . . . . . . Establecimiento de los parmetros del emisor de SNMP . Apndice A. Sentencias Introduccin . . . . . Sentencia SNMP . . . Descripcin . . . . Sintaxis . . . . . Parmetro . . . . . Sentencia APPL . . . Descripcin . . . . Sintaxis . . . . . Parmetros . . . . de control de definicin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . de . . . . . . . . . datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vi
Sentencia NAME . . . . . . . . . . Descripcin . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parmetros . . . . . . . . . . . Grupos de atributos invisibles . . . . Sentencia SOURCE . . . . . . . . . Descripcin . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parmetros . . . . . . . . . . . Sentencia INTERNAL . . . . . . . . Descripcin . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parmetros . . . . . . . . . . . Sentencia RECORDSET . . . . . . . Descripcin . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parmetros . . . . . . . . . . . Delimitadores de atributos ausentes . . Sentencia CONFIRM . . . . . . . . . Descripcin . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parmetros . . . . . . . . . . . Sentencia SQL . . . . . . . . . . . Descripcin . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parmetros . . . . . . . . . . . Sentencia SUMMARY . . . . . . . . Descripcin . . . . . . . . . . . Sintaxis . . . . . . . . . . . . Parmetros . . . . . . . . . . . Ejemplo 1 . . . . . . . . . . . . Ejemplo 2 . . . . . . . . . . . . Ejemplo 3 . . . . . . . . . . . . Nmero total de un intervalo de resumen Ejemplo 4 . . . . . . . . . . . . Creacin de nuevos atributos . . . . Ejemplo 5 . . . . . . . . . . . . Sentencia ATTRIBUTES . . . . . . . Sintaxis . . . . . . . . . . . . Parmetros . . . . . . . . . . . Ejemplos de metarchivos . . . . . . . Ejemplo 1 de metarchivo . . . . . . Ejemplo 2 de metarchivo . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
134 134 134 134 138 140 140 140 140 150 150 150 150 153 153 153 153 156 157 157 157 157 158 158 158 158 159 159 159 159 160 161 161 162 162 163 163 164 164 164 167 167 167 169 169 169 169 169 177 177 178 178 179 179 180
Apndice B. Definiciones de atributos . . . . . . . . . . Definicin de atributos . . . . . . . . . . . . . . . . . Descripcin . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . Parmetros . . . . . . . . . . . . . . . . . . . . Exploracin de las caractersticas de los atributos . . . . . . . Duplicacin de atributos . . . . . . . . . . . . . . . Atributos invisibles . . . . . . . . . . . . . . . . . Truncamiento por la izquierda de atributos de visualizacin . . Derivacin de atributos . . . . . . . . . . . . . . . . . Atributos derivados incorporados como nmeros reales . . . . Concatenacin de cadenas de caracteres de atributos derivados
Contenido
vii
Funciones de atributos derivados . . Filtrado de atributos . . . . . . . . Sintaxis . . . . . . . . . . . Descripcin . . . . . . . . . . Secuenciado de definiciones de atributos
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
180 181 182 182 186 191 191 191 191 191 192 193 193 194 194 194 194 194 194 195 195 196 196 196 196 197 197 197 197 197 197 198 198 198 198 198 198 198 198 199 199 200 200 200 200 200 200 200 200 202 202 202 202 202 202
Apndice C. Atributos de SNMP . . . . . . . . . . Acerca de los atributos y los grupos de atributos . . . . Correlacin de variables MIB con atributos . . . . . Denominacin de grupos de atributos . . . . . . . Determinacin de las caractersticas de los atributos . . Grupos de atributos MIB-2. . . . . . . . . . . . Dnde encontrar ms informacin acerca de los atributos Grupos de atributos SNMP-MANAGER . . . . . . . Grupo de atributos MANAGED-NODES . . . . . . . . Address . . . . . . . . . . . . . . . . . . Current_Response_Time_ms . . . . . . . . . . . Name . . . . . . . . . . . . . . . . . . . Node_Description . . . . . . . . . . . . . . . Node_Status . . . . . . . . . . . . . . . . . Node_Type . . . . . . . . . . . . . . . . . Status_TimeStamp . . . . . . . . . . . . . . Grupo de atributos MIBNODATA . . . . . . . . . . Enterprise_Module . . . . . . . . . . . . . . No_Data_Tables . . . . . . . . . . . . . . . Node_Name . . . . . . . . . . . . . . . . . Grupo de atributos MIBSTATUS. . . . . . . . . . . Attribute_Group . . . . . . . . . . . . . . . . Enterprise . . . . . . . . . . . . . . . . . . Monitor_Agent_Info . . . . . . . . . . . . . . Monitor_Interval . . . . . . . . . . . . . . . Last_Sample_TimeStamp . . . . . . . . . . . . Grupo de atributos NETSUMMARY . . . . . . . . . Active_Nodes . . . . . . . . . . . . . . . . Curr_RespTime_ms . . . . . . . . . . . . . . Inactive_Nodes . . . . . . . . . . . . . . . . Managed . . . . . . . . . . . . . . . . . . Max_RespTime_ms . . . . . . . . . . . . . . Min_RespTime_ms . . . . . . . . . . . . . . Network_Address . . . . . . . . . . . . . . . Network_Mask . . . . . . . . . . . . . . . . Network_Routers . . . . . . . . . . . . . . . Grupo de atributos NETWORK . . . . . . . . . . . Address . . . . . . . . . . . . . . . . . . Description . . . . . . . . . . . . . . . . . Location . . . . . . . . . . . . . . . . . . Name . . . . . . . . . . . . . . . . . . . SNMP_Enabled . . . . . . . . . . . . . . . Status . . . . . . . . . . . . . . . . . . . Type . . . . . . . . . . . . . . . . . . . . Grupo de atributos ROUTER . . . . . . . . . . . . Destination_Networks . . . . . . . . . . . . . Route_Count. . . . . . . . . . . . . . . . . Router_Address . . . . . . . . . . . . . . . Router_Description . . . . . . . . . . . . . . Router_Name . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . MIB-2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
viii
Router_Status . . . Grupo de atributos TRAP Alert_Name . . . . Category . . . . . Description . . . . Enterprise_Name . . Generic_Trap . . . Object ID . . . . . Severity . . . . . Source_Name . . . Source_Status . . . Source_Type. . . . Specific_Trap . . . Time_Stamp . . . . Value_List . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
202 204 204 204 204 204 205 205 205 205 205 205 206 206 206 207 207 207 207 208 208 208 208 210 210 210 210 211 211 211 211 212 214 214 214 215 215 215 215 216 216 216 217 217 217 218 218 218 219 219 219 220 220 220 221
Apndice D. Mandatos de consola . . . . . . . . . . . . . . . . . . . Utilizacin de mandatos de consola . . . . . . . . . . . . . . . . . . . Invocacin de la interfaz de mandatos de consola en el sistema operativo Windows Invocacin de la interfaz de mandatos de consola en los sistemas operativos UNIX Especificacin de nombres de metarchivo y de aplicacin en los mandatos . . . Sistemas de varias interfaces . . . . . . . . . . . . . . . . . . . . Cdigos de retorno . . . . . . . . . . . . . . . . . . . . . . . . Envo de mandatos de consola a una instancia de Tivoli Universal Agent alternativa DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parmetros . . . . . . . . . . . . . . . . . . . . . . . . . . . Utilizacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . GENERATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parmetros . . . . . . . . . . . . . . . . . . . . . . . . . . . Ejemplos . . . . . . . . . . . . . . . . . . . . . . . . . . . . Utilizacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parmetros . . . . . . . . . . . . . . . . . . . . . . . . . . . LIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parmetros . . . . . . . . . . . . . . . . . . . . . . . . . . . Salida . . . . . . . . . . . . . . . . . . . . . . . . . . . . . LOADCOMM. . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parmetros . . . . . . . . . . . . . . . . . . . . . . . . . . . LOADLIST . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parmetros . . . . . . . . . . . . . . . . . . . . . . . . . . . LOADNAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parmetros . . . . . . . . . . . . . . . . . . . . . . . . . . . MNL ADD NODE . . . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parmetros . . . . . . . . . . . . . . . . . . . . . . . . . . . MNL REMOVE NODE . . . . . . . . . . . . . . . . . . . . . . . . Sintaxis . . . . . . . . . . . . . . . . . . . . . . . . . . . . Parmetros . . . . . . . . . . . . . . . . . . . . . . . . . . . REFRESH . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contenido
ix
Sintaxis . Parmetros Utilizacin . SET . . . . Sintaxis . Parmetros SHOW . . . Sintaxis . Parmetros Mensajes . SHUTDOWN. Sintaxis . Parmetros TRAPCNFG . Sintaxis . Parmetros UNPACK . . Sintaxis . Parmetros VALIDATE. . Sintaxis . Parmetros
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
221 221 221 222 222 222 223 223 223 223 224 224 224 225 225 225 226 226 226 227 227 227 229 229 229 229 229 232 232 232 233 233 234 234
Apndice E. Configuracin de condiciones de excepcin de SNMP . . El archivo de configuracin de condiciones de excepcin de SNMP, trapcnfg Ubicacin del archivo de configuracin . . . . . . . . . . . . . Utilizacin del archivo trapd.conf de HP OpenView . . . . . . . . Tipos de registros . . . . . . . . . . . . . . . . . . . . . Valores predeterminados del archivo trapcnfg . . . . . . . . . . . Categoras soportadas . . . . . . . . . . . . . . . . . . . Estatus soportados . . . . . . . . . . . . . . . . . . . . ID de fuente soportados . . . . . . . . . . . . . . . . . . Modificacin del archivo trapcnfg . . . . . . . . . . . . . . . . Modificacin de las definiciones predeterminadas . . . . . . . . . Mandato de consola TRAPCNFG . . . . . . . . . . . . . . .
Apndice F. Expresiones regulares ICU . . . . . . . . . . . . . . . . . . . . . . . 235 Texto de sustitucin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238 Opciones de distintivos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Apndice G. Referencia de variables de entorno . . . . . . . . . . . . . . . . . . . 241 Tivoli Universal Agent y las variables de entorno del proveedor de datos . . . . . . . . . . . 241 Apndice H. Actualizacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 Actualizacin a la versin 6.2.0 de Tivoli Universal Agent . . . . . . . . . . . . . . . . . 255 Proceso de actualizacin . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255 Apndice I. Inicio de proveedores de datos Inicio de los proveedores de datos. . . . . Programas de inicio . . . . . . . . . Entorno de ejecucin . . . . . . . . Conexin con Tivoli Universal Agent . . . Secuencia de inicio . . . . . . . . . Detencin de los proveedores de datos . . . El mandato SHUTDOWN . . . . . . . Retrasos en la terminacin . . . . . . como procesos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . independientes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 257 257 257 258 259 259 260 260
Sistema gestionado fuera de lnea . . . . . . . . . . . . . . . . . . . . . . . . . 260 Apndice J. Determinacin de problemas . . . . Rastreo de Tivoli Universal Agent . . . . . . . . Valores de depuracin especiales . . . . . . . Aplicacin UAGENT . . . . . . . . . . . . . Espacio de trabajo DPLOG . . . . . . . . . Espacio de trabajo ACTION . . . . . . . . . Recopilacin de la documentacin correcta . . . . Lectura del registro de Tivoli Universal Agent . . . . Qu hay que buscar . . . . . . . . . . . . . Reconocimiento de un registro incorrecto . . . . . Categoras habituales de problemas . . . . . . . Problemas de condiciones de excepcin de SNMP Errores de inicio de Tivoli Universal Agent . . . . Ninguna salida en el espacio de trabajo de portal . Datos personalizados no resumidos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261 261 261 262 262 263 263 265 265 268 269 269 271 273 276
Apndice K. Accesibilidad . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279 Desplazamiento por la interfaz mediante el teclado . . . . . . . . . . . . . . . . . . . 279 Ampliacin de lo que aparece en la pantalla . . . . . . . . . . . . . . . . . . . . . . 279 Apndice L. Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281 Marcas registradas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282 ndice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Contenido
xi
xii
Figuras
1. Funcionamiento de Tivoli Universal Agent . . . . . . . . . . . . . . . . . . . . . . 3 2. Flujo de datos de Tivoli Universal Agent e interrelaciones con otros componentes clave de IBM Tivoli Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 3. Ejemplo de metarchivo NTLOG.MDL . . . . . . . . . . . . . . . . . . . . . . . . 6 4. Creacin de un metarchivo de definicin de datos: ejemplo TCPIOQ.MDL . . . . . . . . . . 19 5. Activacin de metarchivos . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 6. Ejemplo de un archivo de proveedor de datos . . . . . . . . . . . . . . . . . . . . 24 7. Metarchivo de aplicacin SNMP personalizado . . . . . . . . . . . . . . . . . . . . 36 8. Relacin entre las fuentes de datos, metarchivos y proveedores de datos . . . . . . . . . . 37 9. Implementacin del Proveedor de datos del servidor de API . . . . . . . . . . . . . . . 42 10. Metarchivo de definicin de datos KUMPOST . . . . . . . . . . . . . . . . . . . . 61 11. Especificacin de acceso de escritura en la definicin de variable MIB-2 . . . . . . . . . . 98 12. Rol del proveedor de datos de socket. . . . . . . . . . . . . . . . . . . . . . . 101 13. Ejemplo de KUMPCON GENERATE (en ingls) . . . . . . . . . . . . . . . . . . . 212 14. Ejemplos de tipos de registros de configuracin 2 y 3 . . . . . . . . . . . . . . . . . 231
xiii
xiv
Tablas
1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. Proveedores de datos de Tivoli Universal Agent . . . . . . . . . . . . . . . . . . . . 2 Proveedores de datos preferidos . . . . . . . . . . . . . . . . . . . . . . . . . 10 Nombre y ubicacin del archivo de variables de entorno en funcin del sistema operativo . . . . 12 Ubicacin predeterminada de los metarchivos . . . . . . . . . . . . . . . . . . . . 20 Numeracin de versiones. . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Atributos de URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53 Objetos URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 Atributos MAS del proveedor de datos de envo . . . . . . . . . . . . . . . . . . . 60 Categoras de mensajes del proveedor de datos de envo . . . . . . . . . . . . . . . 61 Variables de entorno del proveedor de datos de envo . . . . . . . . . . . . . . . . . 62 Variables de entorno generadas . . . . . . . . . . . . . . . . . . . . . . . . . 69 Formatos de nombres de sistemas gestionados . . . . . . . . . . . . . . . . . . . 75 Columnas del espacio de trabajo MANAGED-NODES . . . . . . . . . . . . . . . . . 85 Columnas del espacio de trabajo MIBNODATA . . . . . . . . . . . . . . . . . . . . 85 Columnas del espacio de trabajo MIBSTATUS . . . . . . . . . . . . . . . . . . . . 86 Columnas del espacio de trabajo NETSUMMARY . . . . . . . . . . . . . . . . . . . 86 Columnas del espacio de trabajo NETWORK . . . . . . . . . . . . . . . . . . . . 87 Columnas del espacio de trabajo ROUTER . . . . . . . . . . . . . . . . . . . . . 88 Columnas del espacio de trabajo TRAP . . . . . . . . . . . . . . . . . . . . . . 88 Situaciones proporcionadas por el producto . . . . . . . . . . . . . . . . . . . . . 95 Sistemas gestionados por Tivoli Universal Agent . . . . . . . . . . . . . . . . . . . 113 Columnas del espacio de trabajo DPLOG . . . . . . . . . . . . . . . . . . . . . 117 Categoras del espacio de trabajo DPLOG . . . . . . . . . . . . . . . . . . . . . 118 Columnas del espacio de trabajo ACTION . . . . . . . . . . . . . . . . . . . . . 119 Valores predeterminados para diferentes tipos de atributos . . . . . . . . . . . . . . . 171 Descripciones de funciones de atributos derivados . . . . . . . . . . . . . . . . . . 180 Caractersticas de funciones de filtro . . . . . . . . . . . . . . . . . . . . . . . 183 Tabla de conversin de ASN.1 a tipos de IBM Tivoli Monitoring . . . . . . . . . . . . . 191 Resumen de los mandatos de consola . . . . . . . . . . . . . . . . . . . . . . 209 Categoras soportadas por el Proveedor de datos de SNMP . . . . . . . . . . . . . . 232 Niveles de gravedad soportados por el Proveedor de datos de SNMP . . . . . . . . . . . 232 Estatus soportados por el Proveedor de datos de SNMP . . . . . . . . . . . . . . . 232 IDs de fuente que soporta el Proveedor de datos de SNMP . . . . . . . . . . . . . . 233 Metacaracteres de expresiones regulares . . . . . . . . . . . . . . . . . . . . . 235 Operadores de expresiones regulares . . . . . . . . . . . . . . . . . . . . . . 236 Caracteres del texto de sustitucin . . . . . . . . . . . . . . . . . . . . . . . . 238 Opciones de distintivo . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239 Variables de entorno de Tivoli Universal Agent . . . . . . . . . . . . . . . . . . . 241 Inicio de proveedores de datos . . . . . . . . . . . . . . . . . . . . . . . . . 257
xv
xvi
A quin va destinada
Esta gua est diseada para los responsables de la configuracin de Tivoli Universal Agent y sus proveedores de datos, de la preparacin y definicin de los datos que hay que enviar a Tivoli Universal Agent, de la creacin de programas y scripts para recopilar datos o de la supervisin de datos de Tivoli Universal Agent utilizando Tivoli Enterprise Portal. Esta gua est pensada para proporcionar la informacin necesaria para utilizar Tivoli Universal Agent e IBM Tivoli Monitoring para supervisar datos definidos por el usuario. Est diseada para complementar la ayuda en lnea de Tivoli Enterprise Portal que se proporciona con Tivoli Universal Agent y Tivoli Enterprise Portal, as como los temas tratados en la publicacin Tivoli Enterprise Portal Administrators Guide.
Publicaciones
Este apartado lista las publicaciones de la biblioteca de Tivoli Universal Agent. Tambin describe cmo acceder a las publicaciones de Tivoli en lnea y cmo realizar pedidos de publicaciones de Tivoli.
xvii
Ofrece una introduccin a Tivoli Universal Agent, un agente de IBM Tivoli Monitoring. Tivoli Universal Agent permite utilizar las funciones de supervisin y automatizacin de IBM Tivoli Monitoring para supervisar cualquier tipo de datos que se recopile. v IBM Tivoli Universal Agent - Gua de consulta de programacin de API y de mandatos, SC11-3680-01 Explica los procedimientos para implementar las API de Tivoli Universal Agent, y proporciona descripciones, sintaxis y cdigos de estado de retorno de las llamadas a las API y de los mandatos de interfaz de lnea de mandatos. v IBM Tivoli Monitoring: IBM Tivoli Monitoring 5.x Endpoint Agent Users Guide IBM Tivoli Monitoring 5.x Endpoint Agent ampla las caractersticas de IBM Tivoli Monitoring V5.1.2. Permite que los datos recopilados por los puntos finales de IBM Tivoli Monitoring V5.1.2 desplegados aparezcan en Tivoli Enterprise Portal y se almacenen en Tivoli Data Warehouse.
Solicitud de publicaciones
Puede solicitar en lnea muchas de las publicaciones de Tivoli en la siguiente pgina web: http://www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss
xviii
Tambin es posible solicitarlas por telfono llamando a uno de estos nmeros: v En los Estados Unidos: 800-879-2755 v En Canad: 800-426-4968 En el resto de pases, pngase en contacto con el representante de la cuenta de software para solicitar las publicaciones de Tivoli. Para localizar el nmero de telfono del representante local, realice los pasos siguientes: 1. Vaya a: http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi. 2. Seleccione su pas en la lista y pulse Go (Ir). 3. Pulse About this site (Acerca de este sitio) en el panel principal para ver una pgina de informacin que incluye el nmero de telfono del representante local.
Accesibilidad
Las funciones de accesibilidad ayudan a los usuarios con alguna discapacidad fsica, como puede ser de movilidad o de visin, a utilizar satisfactoriamente los productos de software. Con este producto, se pueden utilizar tecnologas de asistencia para escuchar y desplazarse por la interfaz. Tambin se puede usar el teclado en lugar del ratn para utilizar todas las funciones de la interfaz grfica de usuario. Para obtener informacin adicional, consulte el apndice sobre accesibilidad de la gua del usuario de este producto.
Informacin de soporte
Si tiene un problema con el software de IBM, desear resolverlo rpidamente. IBM proporciona los siguientes mtodos para obtener el servicio de soporte que necesite: En lnea Acceda al sitio web de soporte de IBM en http://www.ibm.com/software/support/probsub.html y siga las instrucciones. IBM Support Assistant IBM Support Assistant (ISA) es un entorno de trabajo de prestacin de servicios de software local libre, que ayuda al usuario a resolver cuestiones y problemas relacionados con los productos de software de IBM. ISA ofrece acceso rpido a las herramientas de prestacin de servicios e informacin relacionada con el soporte para determinar los problemas. Para instalar el software ISA, visite la pgina web: http://www.ibm.com/software/support/isa. Ayuda para la determinacin de problemas Para obtener ms informacin sobre la resolucin de problemas, vea la informacin de determinacin de problemas de este producto.
xix
xx
| {}
Indica informacin mutuamente excluyente. Puede utilizar la opcin de la izquierda o de la derecha de la barra vertical. Delimita un conjunto de elementos mutuamente excluyentes cuando un mandato necesita uno de estos elementos. Los elementos opcionales se incluyen entre corchetes ([ ]).
Adems de los caracteres especiales, la sintaxis de mandatos de Tivoli utiliza los convenios de tipo de letra que se describen en Convenios de tipo de letra en la pgina xx. Los siguientes ejemplos muestran los convenios de tipo de letra utilizados en la sintaxis de mandatos de Tivoli: v wcrtpr [a admin]... [s regin] [m recurso]... nombre El argumento nombre es el nico elemento obligatorio para el mandato wcrtpr. Los corchetes indican que las opciones que contienen son opcionales. Los puntos suspensivos que van a continuacin de la opcin a admin indican que se pueden especificar varios administradores varias veces. Los puntos suspensivos que van a continuacin de la opcin m recurso indican que se pueden especificar varios recursos varias veces. v wchkdb [o archivo_salida] [u] [x] {f archivo_entrada | i | objeto...} Los elementos f, i y objeto son mutuamente excluyentes. Las llaves indican que el elemento que contienen es obligatorio. Si especifica el argumento objeto, podr especificar ms de un objeto.
xxi
xxii
v Acepta las solicitudes de informacin de Tivoli Enterprise Portal acerca de la supervisin de espacios de trabajo y de sucesos. v Gestiona el control de versin de las definiciones de datos. v Distribuye solicitudes de automatizacin a los proveedores de datos. En la Tabla 1 se listan los proveedores de datos que estn disponibles actualmente con Tivoli Universal Agent. En la Figura 1 en la pgina 3 se muestra la relacin entre los proveedores de datos, agentes de Tivoli Universal Agent, servidor de Tivoli Enterprise Monitoring y Tivoli Enterprise Portal.
Tabla 1. Proveedores de datos de Tivoli Universal Agent Tipo Servidor de API Descripcin Permite recopilar datos de recursos en sistemas remotos donde el software cliente de la API de Tivoli Universal Agent est soportado. Consulte Proveedor de datos de servidor de API en la pgina 41 para obtener ms informacin. Unifica los cuatro tipos de proveedores de datos en un nico paquete, iniciado como un nico subproceso para ahorrar en utilizacin de recursos. Este es el proveedor de datos predeterminado al instalar Tivoli Universal Agent. Supervisa archivos secuenciales, como registros del sistema o de mensajes. Proporciona el mtodo ms directo y sencillo de recopilar datos. Consulte Proveedor de datos de archivo en la pgina 44 para obtener informacin adicional. Permite la supervisin de URL de Internet acerca de su disponibilidad y tiempo de respuesta. Puede especificar qu URL supervisar en un archivo de configuracin de inicio o dentro de las situaciones de Tivoli Enterprise Portal. Consulte Proveedor de datos de HTTP en la pgina 51 para obtener informacin adicional. Permite la recopilacin de datos a partir de bases de datos que cumplan la norma ODBC utilizando sentencias Select de SQL y procedimientos almacenados. Consulte Proveedor de datos de ODBC en la pgina 56 para obtener informacin adicional. Aplicacin de sockets de TCP/IP con datos predefinidos. Permite enviar notificaciones ad hoc como mensajes, alertas y estatus. Consulte Proveedor de datos de envo en la pgina 60 para obtener ms informacin. Permite la recopilacin de datos desde cualquier script o programa que enve resultados a la salida estndar. Consulte Proveedor de datos de script en la pgina 66 para obtener informacin adicional. Proporciona la funcionalidad de un gestor de SNMP, incluidos el descubrimiento de red, la supervisin de condiciones de excepcin y la recopilacin de datos MIB. Consulte Proveedor de datos de SNMP en la pgina 74 para obtener informacin adicional. Escucha en un socket de TCP/IP los datos enviados utilizando comunicacin de programa a programa. Permite recopilar datos desde varios dispositivos remotos o sistemas para los que no existe soporte de API de Tivoli Universal Agent. Consulte Proveedor de datos de socket en la pgina 100 para obtener informacin adicional.
Archivo
HTTP
ODBC
Envo
Script
SNMP
Socket
En la Figura 1, la Fuente de datos A es un archivo de registro, supervisado por el proveedor de datos de archivo. La Fuente de datos B es un programa en un host remoto que proporciona datos mediante un socket TCP/IP al proveedor de datos de socket. La Fuente de datos C utiliza las API de Tivoli Universal Agent para enviar datos al proveedor de datos de servidor de API, al igual que la Fuente de datos D en un host remoto. En la Figura 2 en la pgina 4, se muestra una vista pictrica del flujo de datos de Tivoli Universal Agent y cmo se interrelaciona con los otros componentes clave de la plataforma de IBM Tivoli Monitoring.
Figura 2. Flujo de datos de Tivoli Universal Agent e interrelaciones con otros componentes clave de IBM Tivoli Monitoring
Para crear una aplicacin de Tivoli Universal Agent, debe crear un metarchivo de definicin de datos que describa los datos de la aplicacin que desea recopilar. Inicie Tivoli Universal Agent y active uno o ms de los Proveedores de datos, que supervisan y recopilan datos de la fuente de datos definida en el metarchivo. El metarchivo tambin incluye sentencias de definicin de tabla y atributo. Tivoli Universal Agent toma estas sentencias y genera los archivos CAT, ATR y ODI, que describen la aplicacin ante el servidor de Tivoli Enterprise Monitoring y el servidor de Tivoli Enterprise Portal (servidor de portal). De este modo, mediante el uso de metarchivos, puede crear sus propias soluciones de supervisin de IBM Tivoli Monitoring. Tivoli Universal Agent tambin incluye una funcin de emisin de condiciones de excepcin de SNMP controlada por una poltica (vea el Captulo 6, Introduccin al emisor de SNMP, en la pgina 123).
No obstante, si decide utilizar un proveedor de datos de servidor de API o de socket para supervisar los datos, puede crear un programa que emita llamadas a la API de Tivoli Universal Agent para reenviar los datos directamente al proveedor de datos de servidor de API, o crear un programa que enve los datos mediante un socket al proveedor de datos de socket.
En el metarchivo, se nombra la aplicacin NTLOG y se especifica que la fuente de los datos de atributo es un archivo denominado IN{####}, situado en C:\WINNT\SYSTEM32\LOGFILES, donde los caracteres de patrn {####} representan los valores de mes y ao de dos dgitos de incremento. El usuario define un grupo de atributos, llamado FTPLOGFILE, y especifica el mtodo de supervisin, E, para sucesos. Proporciona entonces los nombres y caractersticas de los 14 atributos que desea supervisar. Consulte el Captulo 3, Creacin de una aplicacin, en la pgina 17 y el Apndice A, Sentencias de control de definicin de datos, en la pgina 129 para obtener ms informacin acerca de la creacin de metarchivos. El usuario coloca el metarchivo en el directorio de metarchivos de Tivoli Universal Agent en NTSRV1. Ahora ya es posible iniciar Tivoli Universal Agent. Nota: Como el proveedor de datos de archivo est incluido automticamente en el proveedor de datos de ASFS, el valor predeterminado de la instalacin, no es necesario volver a configurar los proveedores de datos que se activan durante el arranque de Tivoli Universal Agent. Cuando se est ejecutando Tivoli Universal Agent, puede importar el metarchivo NTLOG.MDL. La importacin de un metarchivo es el proceso de activar una aplicacin de metarchivo dentro de un Tivoli Universal Agent en ejecucin. Para realizar esta tarea, puede utilizar el mandato de consola Import de Tivoli Universal Agent proporcionado o la ventana de Actuacin de Tivoli Enterprise Portal, Control Import. Consulte Activacin de metarchivos en la pgina 21 para obtener ms informacin acerca de la
carga de metarchivos. Consulte la publicacin IBM Tivoli Monitoring - Gua de instalacin y configuracin para obtener instrucciones acerca de cmo iniciar y detener Tivoli Enterprise Monitoring Agent.
A partir de ahora, siempre que un usuario intente subir un archivo de 10 MB o ms, se activar esta situacin. A continuacin cree una poltica llamada FTPLimit, que espere a que se active la situacin y 1. Enve un mensaje al usuario que est subiendo el archivo (ClientName) comunicndole las restricciones del FTP y que el servicio se est finalizado. 2. Lleve a cabo la accin Net stop FTP Publishing Service para detener el servicio FTP. 3. Notifique al operador en Tivoli Enterprise Portal que el servicio FTP Publishing Service se ha detenido. 4. Reinicie el servicio si el operador no realiza ninguna accin transcurridos 5 minutos. Consulte la publicacin Tivoli Enterprise Portal Administrators Guide y la ayuda en lnea de Tivoli Enterprise Portal para obtener instrucciones acerca de la creacin de situaciones y polticas.
Introduccin
La implementacin de Tivoli Universal Agent implica los siguientes tres procedimientos: v Instalacin y configuracin de Tivoli Universal Agent v Definicin de aplicaciones de metarchivo de Tivoli Universal Agent v Supervisin de datos en Tivoli Enterprise Portal
datos estn en un archivo secuencial no es posible utilizar un proveedor de datos de archivo si se encuentran en un sistema operativo no soportado por Tivoli Universal Agent. Para utilizar las API de Tivoli Universal Agent necesita instalar la biblioteca de enlaces dinmicos de la API de Tivoli Universal Agent para el sistema operativo en que planee realizar el desarrollo. Esta biblioteca en tiempo de ejecucin, que forma parte de lo que se denomina el paquete cliente de API, no est disponible en todos los sistemas operativos. El sistema operativo debe contar con una pila TCP/IP con una interfaz de sockets si desea utilizar el proveedor de datos de socket.
10
distintos, necesitar instalar 20 instancias de Tivoli Universal Agent. Es necesario instalar un agente en cada host a no ser que los archivos remotos estn disponibles mediante software como NFS o Samba. El proveedor de datos de script debe ejecutarse en un sistema en el que el script se est ejecutando ya que los mensajes de salida estndar producidos por el script se conducen del sistema local al proveedor de datos de script. Los proveedores de datos de envo, servidor de API, HTTP, ODBC y SNMP son proveedores de datos distribuidos. Es decir, no tienen que iniciarse en la misma ubicacin que sus fuentes de datos. Por lo tanto, si piensa supervisar datos no accesibles desde un archivo, puede iniciar un nico Tivoli Universal Agent que pueda recibir datos enviados desde cualquier sistema en la empresa. Puede utilizar ms de un Tivoli Universal Agent para limitar el trfico de red o permitir que distintas instancias de Tivoli Universal Agent supervisen datos acerca de recursos gestionados por distintos departamentos.
Determinacin de cuntas instancias de Tivoli Universal Agent se pueden ejecutar en el mismo host
Es posible ejecutar ms de un Tivoli Universal Agent en un host determinado. No obstante, esto no suele ser necesario ya que un Tivoli Universal Agent puede ejecutar varias aplicaciones y supervisar datos de varias fuentes. Por ejemplo, con el proveedor de datos de ASFS un nico Tivoli Universal Agent puede supervisar varios archivos, varios clientes de API, varios scripts y varios clientes de socket. Para obtener ms informacin, consulte Ejecucin de varias instancias de un proveedor de datos en la pgina 38.
Determinacin de cuntos proveedores de datos se pueden iniciar con un Tivoli Universal Agent
En funcin de los requisitos de supervisin, puede iniciar todos los proveedores de datos o un subconjunto de ellos, en un Tivoli Universal Agent. La primera vez que se inicia el agente despus de la instalacin, el agente inicia de forma predeterminada el Proveedor consolidado de datos de ASFS. Si desea iniciar todos los proveedores de datos posibles en los sistemas Windows, actualice la variable de entorno KUMA_STARTUP_DP del modo siguiente:
KUMA_STARTUP_DP=ASFS,HTTP,ODBC,SNMP,POST
Si se activan varios proveedores de datos, deben estar en una lista separada por comas tal como se muestra en la variable de entorno anterior. Observe que el proveedor de datos de ODBC slo est disponible en los sistemas Windows. Existe una sobrecarga del sistema asociada a cada proveedor de datos activos, por lo que slo debe iniciar los que necesite. Siempre puede modificar la lista en el futuro, si los requisitos de supervisin cambian.
11
La Tabla 3 contiene el nombre y la ubicacin del archivo de variables de entorno de cada uno de los sistemas operativos soportados.
Tabla 3. Nombre y ubicacin del archivo de variables de entorno en funcin del sistema operativo Sistema operativo UNIX Windows Ubicacin <dir_instalacin>/config/ IBM\ITM\TMAITM6\ um.ini KUMENV Nombre
Edicin del archivo KUMENV en los sistemas operativos Windows mediante Manage Tivoli Enterprise Monitoring Services
Realice los pasos siguientes para editar el archivo KUMENV mediante Manage Tivoli Enterprise Monitoring Services: 1. Desde el men Inicio, seleccione Programas IBM Tivoli Monitoring Manage Tivoli Enterprise Monitoring Services. Aparecer la ventana Manage Tivoli Enterprise Monitoring Services. 2. Pulse con el botn derecho sobre Tivoli Universal Agent y, a continuacin, seleccione Avanzado Editar archivo ENV . . . El archivo KUMENV se abre en el Bloc de notas. 3. Edite o aada las variables que desea especificar. 4. Guarde los cambios y cierre el Bloc de notas.
Este tipo de variable de entorno slo debe actualizarse mediante el mandato itmcmd config -A um. Por lo tanto, si desea cambiar el conjunto de Proveedores de datos que Tivoli Universal Agent inicia, debe volver a ejecutar itmcmd config -A um en lugar de editar directamente la variable de entorno KUMA_STARTUP_DP en el archivo um.ini.
12
IBM\ITM\TMAITM6\work como el directorio de trabajo. En los sistemas operativos UNIX, se crea automticamente un directorio independiente denominado work, y la variable KUM_WORK_PATH se preestablece para especificar <dir_instalacin>/<arquitectura>/um/work, donde <arquitectura> es el sistema operativo y la versin. Por ejemplo:
/TivoliHome/aix533/um/work
Indica el sistema operativo IBM AIX 5.3 de 32 bits. Puede utilizar KUM_WORK_PATH para especificar el directorio que desee.
Utilizacin de las variables de entorno para determinar los nombres de host de las aplicaciones
El modo en que Tivoli Universal Agent determina el nombre de host local es importante porque el valor de nombre de host se utiliza de las dos formas siguientes: 1. En la nomenclatura de los sistemas gestionados que Tivoli Universal Agent registra con el servidor de supervisin y que se visualizan en el rbol de navegacin del portal. En el nombre de sistema gestionado XXX:YYY estndar que Tivoli Universal Agent registra, el valor de nombre de host local se utiliza en la parte XXX del nombre. 2. Cuando se enlazan sockets para crear puertos de escucha. Observe que Tivoli Universal Agent es diferente de otros agentes de Tivoli Monitoring a este respecto. Otros agentes de supervisin no suelen funcionar como servidores que permanecen a la escucha de conexiones de socket de cliente, mientras que esta funcin es una parte esencial de lo que Tivoli Universal Agent realiza. De forma predeterminada, Tivoli Universal Agent realiza una bsqueda DNS durante el arranque para obtener el nombre de host local donde se est ejecutando. A continuacin, este valor de nombre de host se utiliza para nombrar los sistemas gestionados y enlazar sockets de enlace. Si necesita que Tivoli Universal Agent utilice un nombre de host local no predeterminado, por ejemplo, porque el agente se ejecuta en un sistema multitarjeta (mltiples NIC), debe establecer un valor de alteracin temporal de variable de entorno en el archivo /config/um.ini (en las plataformas UNIX) o el archivo \TMAITM6\KUMENV (en las plataformas Windows). Hay cuatro variables de entorno distintas que responden todas a la misma finalidad bsica que consiste en permitir que se altere temporalmente el nombre de host local de Tivoli Universal Agent. La secuencia de bsqueda de la variable de entorno es la siguiente: 1. KUM_DCH_HOSTNAME 2. KUM_DP_HOSTNAME 3. KDCB0_HOSTNAME 4. KDEB_INTERFACELIST Si no se ha establecido ninguna de estas variables de entorno, Tivoli Universal Agent utiliza el valor de nombre de host local predeterminado. Si se ha establecido la variable de entorno KDEB_INTERFACELIST y el valor asignado es una direccin IP decimal separada por puntos, como por ejemplo, KDEB_INTERFACELIST=9.67.4.34, Tivoli Universal Agent intenta resolver la direccin IP con un nombre de host simblico para mejorar la presentacin en el portal. Nota: Para diagnosticar por qu se utiliza un valor de nombre de host local determinado, establezca el parmetro de rastreo KBB_RAS1 de Tivoli Universal Agent en ERROR (UNIT:kum0lhns ALL). El archivo de registro RAS1 de Tivoli Universal Agent contiene informacin de rastreo detallada que muestra la secuencia de bsqueda que ha generado el valor de nombre de host local actual.
13
Para comprender el rol del nombre de host local en las operaciones de Tivoli Universal Agent, es importante reconocer la diferencia entre los dos tipos de nodos que Tivoli Universal Agent registra con el servidor de supervisin: 1. Un nodo de gestor individual, conocido tambin como nodo de latido, que el servidor de supervisin comprueba peridicamente para ver su estatus en lnea y fuera de lnea. 2. Uno o ms subnodos de aplicacin. La cantidad depende de cuntos metarchivos estn activos. Los subnodos contienen los datos de aplicacin recopilados por Tivoli Universal Agent que se consultan en las situaciones y las polticas. El uso de un nodo de gestor individual por cada instancia de Tivoli Universal Agent reduce el trfico en la red porque el servidor de supervisin slo tiene que realizar el seguimiento del estatus de un nodo de latido en lugar de docenas potenciales de subnodos de aplicacin diferentes. A la variable de entorno CTIRA_HOSTNAME se le asigna automticamente un valor durante la configuracin de Tivoli Universal Agent. De forma predeterminada, es el nombre de host abreviado, sin el sufijo de nombre de dominio, del sistema local. El valor de CTIRA_HOSTNAME se utiliza para definir la parte de nombre de host del nodo del gestor de Tivoli Universal Agent. Por ejemplo, si tiene un host que se denomina BH-T60 donde Tivoli Universal Agent est en ejecucin y una aplicacin de Tivoli Universal Agent denominada MYAPP (//APPL MYAPP aparece en el metarchivo), en el rbol de navegacin del portal aparecen los nombres siguientes:
BH-T60 (mquina host) --> Universal Agent --> BH-T60:MYAPP00
En el espacio de trabajo gestionado Estatus de sistemas gestionados, se visualizan los dos sistemas siguientes en la lista de otros sistemas gestionados:
BH-T60:UA BH-T60:MYAPP00
donde BH-T60:UA es el nodo del gestor y BH-T60:MYAPP00 es un subnodo de aplicacin debajo de BH-T60:UA. Desde el punto de vista del servidor de supervisin y del servidor del portal, BH-T60 es el sistema gestionado y se visualiza en el rbol de navegacin del portal del modo siguiente:
BH-T60 (mquina host) --> Universal Agent
A modo de ejemplo, si establece CTIRA_HOSTNAME=MICKEY en el archivo KUMENV o um.ini, el escenario cambia. Los nombres de subnodos de aplicacin de Tivoli Universal Agent en el rbol de navegacin del portal y en el espacio de trabajo Estatus de sistemas gestionados para este ejemplo siguen siendo BH-T60:MYAPP00. Pero ahora, el sistema gestionado es MICKEY, y MICKEY:UA es el nuevo nombre del nodo del gestor de Tivoli Universal Agent, que tambin se visualiza en el espacio de trabajo Estatus de sistemas gestionados. Adems de las variables de entorno descritas arriba, tambin se pueden alterar temporalmente los valores de nombre de host local en los subnodos de Tivoli Universal Agent estableciendo parmetros de metarchivo, como por ejemplo ManagedSystemName=xxxx (consulte el parmetro ManagedSystemName en la pgina 148 para obtener ms informacin) o enviando un registro //SETSOURCENAME=xxxx cuando se utiliza el proveedor de datos de socket (consulte Funcin SETSOURCENAME en la pgina 102 para obtener ms informacin).
14
Por ejemplo, puede iniciar el agente en los sistemas UNIX entrando el siguiente mandato desde el directorio <dir_instalacin>/bin:
itmcmd agent start um
Nota: Aunque Tivoli Universal Agent se conoce habitualmente como UA, el cdigo de producto oficial de 2 caracteres es um. que es la razn por la que muchos mandatos, archivos de configuracin y binarios de Tivoli Universal Agent incluyen los caracteres um en sus nombres. Tambin puede iniciar Tivoli Universal Agent desde el rbol de Navigator de Tivoli Enterprise Portal. Resalte y pulse con el botn derecho en Universal Agent en Navigator y seleccione Iniciar. Esta misma interfaz de Tivoli Enterprise Portal tambin permite detener o reiniciar el agente. De forma predeterminada, al iniciar Tivoli Universal Agent, se activa el proveedor consolidado de datos (ASFS). Si desea especificar que se activen otros proveedores de datos o unos adicionales al iniciar Tivoli Universal Agent cambie la variable de entorno KUMA_STARTUP_DP. En los sistemas UNIX, actualice indirectamente KUMA_STARTUP_DP invocando el script de configuracin, itmcmd config A um, y especificando en el indicador del Proveedor de datos final los proveedores de datos que desea utilizar.
HTTP Inicia el proveedor de datos de HTTP ODBC Inicia el proveedor de datos de ODBC POST Inicia el proveedor de datos de envo SCRP Inicia el proveedor de datos de script SNMP Inicia el proveedor de datos de SNMP SOCK Inicia el proveedor de datos de socket Por ejemplo, si especifica el siguiente mandato, se activarn los proveedores consolidados de datos de API, de socket, de archivo y de script, as como el proveedor de datos de SNMP cuando inicie Tivoli Universal Agent.
KUMA_STARTUP_DP=ASFS,SNMP
15
Los parmetros de inicio que especifique mediante esta ventana son permanentes; siguen activos cuando se reinicia el agente. Es importante recordarlo, en caso de que detecte que se inicia un conjunto de proveedores de datos distinto de los que especific en KUMA_STARTUP_DP.
Si inicia manualmente el proveedor de datos de HTTP en una instancia alternativa de Tivoli Universal Agent denominada Test (prueba), especifique la siguiente cadena de mandatos utilizando el distintivo -p para especificar un nombre de instancia alternativo:
itmcmd agent -o HTTP -p Test start um
16
17
INTERNAL Proporciona la redireccin de datos entre grupos de atributos como mtodo para realizar procesos adicionales en los mismos datos de entrada. SOURCE Define la ubicacin de los datos que se estn recopilando. RECORDSET Slo para proveedores de datos de archivo y de script; define el conjunto de registros desde los que el proveedor de datos extrae los datos. CONFIRM Slo para proveedores de datos de socket, especifica los requisitos para el reconocimiento de datos. SQL Slo para proveedores de datos de ODBC; define la sentencia Select o procedimiento almacenado a utilizar en la recopilacin de los datos relacionales.
SUMMARY Define los requisitos para reunir la frecuencia de entrada de datos durante la supervisin. ATTRIBUTES Introduce las definiciones de atributos y especifica los delimitadores de atributos en la cadena de datos. Despus de la sentencia de control ATTRIBUTES, liste las sentencias de definicin de atributos individuales. Puede utilizar cualquier editor de texto para crear un metarchivo. El Apndice A, Sentencias de control de definicin de datos, en la pgina 129 contiene las definiciones y sintaxis de las sentencias de metarchivos. Si un metarchivo contiene texto que no est en ingls, deber guardar el metarchivo como UTF-8. Otras codificaciones de archivo, como UTF-16 o UTF-32, no estn soportadas. Se pueden especificar ejemplos de texto que no est en ingls en un metarchivo como los textos de ayuda, ttulos de atributos, caracteres delimitadores, constantes enumeradas y patrones de filtros de atributo. Puede crear un metarchivo de definicin de datos para definir los atributos que desea supervisar. En el metarchivo, nombre la aplicacin y grupos de datos de atributos a los que pertenecen los atributos. Identifique las fuentes de los datos, especifique qu tipo de datos desea supervisar y defina el texto de ayuda de la aplicacin, grupos de atributos y atributos, (vea la Figura 4 en la pgina 19).
18
El siguiente ejemplo ilustra un pequeo metarchivo llamado TCPIOQ.MDL, que define una aplicacin de socket llamada UXnet:
//APPL UXnet @aplicacin de socket de ejemplo de PD //NAME TCPioQ E @grupo de atributos para aplicacin de PD de ejemplo //SOURCE SOCK UNIX1 //SOURCE SOCK UNIX2 //ATTRIBUTES LocalApplAddress D 24 @direccin de la aplicacin local TargetApplAddress D 24 @direccin de la aplicacin de destino SendQueueSize C 999999 @tamao de la cola de envo TCP/IP RecvQueueSize C 999999 @tamao de la cola de recepcin TCP/IP
Denominacin de metarchivos
Por convenio, los metarchivos de Tivoli Universal Agent terminan con la extensin .mdl, pero no existen restricciones acerca de los nombres de los metarchivos. Puede utilizar cualquier nombre soportado por el sistema operativo en el que se encuentra el archivo. Es aconsejable darle al archivo el mismo nombre que tenga la aplicacin.
19
Almacenamiento de metarchivos
De forma predeterminada, Tivoli Universal Agent busca los metarchivos en el directorio indicado en la Tabla 4.
Tabla 4. Ubicacin predeterminada de los metarchivos Sistema operativo Windows UNIX IBM\ITM\TMAITM6\metafiles <dir_instalacin>/$ARCH/um/metafiles Ubicacin
Puede cambiar la ubicacin utilizando la variable KUMP_META_PATH. Por ejemplo, si desea almacenar todos los metarchivos en un directorio especial fuera de la estructura del directorio de instalacin de Tivoli Universal Agent, utilice la variable de entorno KUMP_META_PATH para redirigir el metarchivo desde el directorio predeterminado a una ubicacin alternativa. Nota: La especificacin KUMP_META_PATH local de un cliente de metarchivos no altera temporalmente la especificacin KUMP_META_PATH del servidor de metarchivos. Consulte Creacin de un servidor de metarchivos en la pgina 25 para obtener ms informacin acerca del recurso opcional del servidor de metarchivos. Si est utilizando un mandato de consola de Tivoli Universal Agent para un metarchivo y el metarchivo no est en el directorio de metarchivos predeterminado, puede especificar el nombre de metarchivo calificado al completo. Por ejemplo, si utiliza el mandato de consola VALIDATE para comprobar la sintaxis de un metarchivo en un sistema Windows y el metarchivo no est en el directorio predeterminado \IBM\ITM\TMAITM6\metafiles, sino que se encuentra en \ua\test, entre el siguiente mandato en la lnea de mandatos:
kumpcon validate C:\ua\test\my_metafile.mdl
Si dispone de muchos metarchivos, puede crear subdirectorios en el directorio designado por KUMP_META_PATH. Cuando utilice un mandato de consola que haga referencia a un metarchivo en uno de los subdirectorios, podr utilizar una va de acceso relativa cuando especifique el nombre del metarchivo. Por ejemplo:
kumpcon validate .\nombre_subdirectorio\mymetafile.mdl
20
Nota: En los sistemas operativos UNIX, no puede ejecutar el programa kumpcon directamente. En su lugar, utilice el script de shell um_console, que es un contenedor para kumpcon que permite ejecutar el programa de validacin de metarchivos. Consulte Invocacin de la interfaz de mandatos de consola en los sistemas operativos UNIX en la pgina 207 para obtener ms informacin acerca del script um_console.
Activacin de metarchivos
Para gestionar los datos de aplicacin, Tivoli Universal Agent debe activar los metarchivos correspondientes. Puede activar los metarchivos de cualquiera de las siguientes maneras: v Dinmicamente mediante un mandato de consola v Dinmicamente mediante un mandato de Actuacin en el Tivoli Enterprise Portal v Mediante una actualizacin del archivo de configuracin y un reinicio de Tivoli Universal Agent Cuando decida qu mtodo utilizar para activar un metarchivo, intente alcanzar un equilibrio entre flexibilidad, facilidad de uso, mantenimiento y la reduccin de errores causada por acciones implcitas y valores predeterminados.
21
22
3. En la ventana Actuacin, seleccione una accin de la lista desplegable Nombre:. Aparecer la ventana Editar valores de argumentos.
Como ejemplo, si va a importar el archivo TCPIOQ.MDL, seleccione Control Import en la lista desplegable Nombre:. En la ventana Editar valores de argumentos, entre TCPIOQ.MDL como Valor. 4. Escriba el nombre del metarchivo que desea activar en el campo Valor de la ventana Editar valores de argumentos. 5. Pulse en Aceptar. 6. En la seccin Sistemas de destino de la ventana Actuacin, seleccione un sistema de destino para la accin. Nota: Distribuya siempre el mandato de Actuacin a los sistemas de destino cuyo tipo de proveedor de datos coincida con el tipo de proveedor de datos que desea importar. En este ejemplo, el
23
metarchivo utiliza el proveedor de datos de socket, para distribuir la accin al sistema de destino &localhostASFSdp:UAGENT00 o &localhostSOCKdp:UAGENT00, en funcin de si ha configurado ASFS DP o SOCK DP. 7. Pulse en Aceptar. La ventana Estatus de accin aparece e indica si la accin ha sido correcta.
24
archivos del registro de supervisin. Del mismo modo, el proveedor de archivos de SNMP slo carga metarchivos MIB de SNMP y los proveedores de datos que no son SNMP slo cargan metarchivos que no son de SNMP. Por lo tanto, aparte del almacenamiento extra asignado para cada proveedor de datos para los bloques de control de definicin de datos internos, no existe el peligro de conflictos de gestin entre los distintos proveedores de datos. Si inicia los proveedores de datos tipo ASFS, es decir, API, Socket, Archivo y Script (ASFS), se iniciarn todas las supervisiones correspondientes para cada tipo de proveedores de datos al mismo tiempo.
La presencia de la variable de entorno le indica a Tivoli Universal Agent que debe utilizar un servidor de metarchivos centralizado. Si est variable de entorno no est establecida, Tivoli Universal Agent funciona en modalidad autnoma y slo buscar los metarchivos necesarios localmente. Si el nombre de host especificado por KUMP_META_SERVER no puede resolverse en una direccin TCP/IP, la caracterstica del servidor se inhabilitar y el proveedor de datos cargar los metarchivos desde la ubicacin de metarchivos local.
25
26
servidor de supervisin remoto y se activa una nueva aplicacin de metarchivo, el servidor del portal no conoce la nueva aplicacin y por lo tanto, no puede visualizarla en el cliente del portal. Para resolver este problema, dispone de las dos opciones posibles: Opcin 1 1. Volver a configurar temporalmente Tivoli Universal Agent para conectar con el servidor de supervisin concentrador. 2. Importar el metarchivo. 3. Volver a configurar Tivoli Universal Agent para conectar con el servidor de supervisin remoto. La opcin 1 presenta la ventaja de que no es necesario que se recicle el servidor de supervisin concentrador. Tenga presente que si dispone de centenares o miles de sistemas Tivoli Universal Agent y todos ellos utilizan el mismo conjunto de metarchivos, slo necesita volver a configurar un Tivoli Universal Agent en el servidor de supervisin concentrador para subir dinmicamente los archivos CAT y ATR. Opcin 2 Copie manualmente los archivos CAT y ATR para las aplicaciones de metarchivos en el servidor de supervisin concentrador y a continuacin, recicle el concentrador. Puede copiar los archivos de los directorios /RKDSCATL y /ATTRLIB del servidor de supervisin remoto en los mismos directorios en el servidor de supervisin concentrador. (Para los servidores de supervisin en los sistemas z/OS, los archivos CAT y ATR se almacenan como miembros de conjuntos de datos particionados en RKANDATV). Observe que Tivoli Universal Agent tambin conserva copias locales de estos archivos en el subdirectorio de trabajo, que es \TMAITM6\work en los sistemas Windows, y /um/work en los sistemas UNIX. Al igual que con la Opcin 1, el proceso de copiar archivos en el servidor de supervisin concentrador slo se tiene que realizar una vez aunque disponga de un entorno a gran escala con muchos Tivoli Universal Agents.
27
que se inserta una nueva entrada en el rbol Navigator de Tivoli Enterprise Portal para la nueva versin de la aplicacin, y que se colocan espacios de trabajo de informes debajo la entrada. Los cambios de nmero de versin se consideran cambios de gran importancia porque no es posible simplemente reiniciar las situaciones distribuidas a una versin anterior de un sistema gestionado. Es necesario crear nuevas situaciones o modificar las antiguas para utilizar los nuevos nombres de grupos de atributos y, a continuacin, distribuir las situaciones a las nuevas versiones de los sistemas gestionados o lista de sistemas gestionados. Tambin necesita actualizar cualquier poltica o consulta existente para que haga referencia al nuevo nmero de versin. Cuando se incrementa el nmero de modificacin, se considera que es un cambio de versin de menor importancia. Este tipo de cambio no precisa que se redefinan las situaciones, consultas personalizadas o polticas existentes. Por esto, es aconsejable, siempre que sea posible, realizar cambios de metarchivos que slo afecten al nmero de modificacin. Nota: Los cambios de menor importancia se implementan sin que se precise reciclar el servidor de supervisin o el servidor de portal. Sin embargo, si los cambios de metarchivos afectan a las definiciones de atributos, por ejemplo, cambios en el texto de ayuda del atributo, valores de escala o de precisin, o bien ttulos, el cliente del portal deber reciclarse porque mantiene una memoria cach de definiciones de atributos que no se renueva automticamente despus de realizar un cambio de versin de menor importancia en una aplicacin de Tivoli Universal Agent.
Tabla 5. Numeracin de versiones Nombre sistema gestionado ENG1:UL300 Versin 00 ENG1:UL301 *CUSTOM_UL301 SYSLOG01 Versin 01
28
v Adicin, eliminacin o modificacin de los parmetros Warehouse o Aggregation v Adicin, eliminacin o modificacin de las opciones HistoricalTimestamp o PrimaryKey v Adicin, eliminacin o modificacin de los parmetros de afinidad dinmica
29
5. Resalte todos los sistemas gestionados de Tivoli Universal Agent. 6. Pulse con el botn derecho del ratn y seleccione Borrar entrada fuera de lnea. El icono Aplicar actualizaciones pendientes aparece resaltado en el cliente de portal. 7. Seleccione el icono Aplicar actualizaciones pendientes para volver a crear el rbol de Navigator. Los sistemas gestionados de Tivoli Universal Agent ya no aparecen en el rbol.
donde: directorio_instalacin El directorio base donde estn instalados los componentes de IBM Tivoli Monitoring. Por ejemplo, IBM\ITM componente Uno de los tres valores: UA CMS CNPS Nota: Ponga en maysculas cada uno de estos valores. Por ejemplo, utilice UA y no utilice Ua o ua. directorio_trabajo Slo es necesario si el directorio de trabajo no es el directorio IBM\ITM\TMAITM6\work predeterminado. Para ejecutar el script de limpieza en Windows, realice los pasos siguientes. Observe que estos pasos presuponen que el servidor de supervisin y el servidor del portal estn instalados en el mismo sistema Windows que Tivoli Universal Agent, y que ha elegido el directorio de instalacin de \IBM\ITM. 1. Finalice la sesin en Tivoli Enterprise Portal Client. 2. Detenga el servidor de supervisin, el servidor del portal y Tivoli Universal Agent. 3. Abra un indicador de mandatos y vaya al directorio \TMAITM6. 4. Ejecute el mandato um_cleanup.bat IBM\ITM UA para suprimir todos los archivos CAT, ATR y ODI generados por Universal Agent en el directorio \work en el sistema de Tivoli Universal Agent. 5. Ejecute el mandato um_cleanup.bat IBM\ITM CMS para suprimir todos los archivos CAT y ATR de Universal Agent generados por los directorios \ATTRLIB y \RKDSCATL del servidor de supervisin. 6. Ejecute el mandato um_cleanup.bat IBM\ITM CNPS para suprimir todos los archivos ODI generados por Universal Agent en el directorio \CNPS del servidor del portal. 7. Reinicie el servidor de supervisin, el servidor del portal y Tivoli Universal Agent. 8. Inicie la sesin en el cliente del portal. 9. Las aplicaciones se visualizan en el rbol de Navigator con los sufijos de la versin 00.
30
En los sistemas UNIX, el script de shell um_cleanup prev los siguientes parmetros de la lnea de mandatos:
um_cleanup directorio_instalacin arquitectura nombre_TEMS componente
donde: directorio_instalacin arquitectura nombre_TEMS El directorio base donde estn instalados los componentes de IBM Tivoli Monitoring. Por ejemplo, /opt/IBM/ITM. El nombre de la arquitectura de la plataforma del SO, como por ejemplo li6243, sol286 o aix533. El nombre asignado durante la configuracin del servidor de supervisin, que forma parte del nombre de va de acceso a los directorios /ATTRLIB y /RKDSCATL. Aunque este parmetro slo se utiliza si el valor de componente es "CMS," el parmetro debe especificarse siempre cuando se ejecuta el script um_cleanup. Si no elimina los archivos del servidor de supervisin, puede proporcionar un nombre ficticio para este parmetro. Uno de los tres valores: UA CMS CNPS Nota: Ponga en maysculas cada uno de estos valores. Por ejemplo, emplee CMS y no emplee Cms o cms. A modo de ejemplo de ejecucin de um_cleanup en los sistemas UNIX, vaya al directorio /um/bin y escriba este mandato:
./um_cleanup /opt/IBM/ITM sol286 PRODTEMS UA
componente
Despus de ejecutar el script um_cleanup en los sistemas Windows o UNIX, debe reciclar los servidores de supervisin y del portal, y a continuacin, reiniciar Tivoli Universal Agent para activar los sufijos de la versin 00.
31
Para un servidor de portal basado en Windows, este mandato se entra desde el directorio \IBM\ITM\CNPS . El mandato presupone que la base del servidor del portal utiliza el nombre de fuente de datos predeterminado, TEPS2, pero puede cambiarlo si ha configurado otro nombre de fuente de datos distinto. Tenga en cuenta que este mandato suprime todas la consultas de Universal Agent generadas por el servidor del portal, que siempre empiezan por zkum. Para confirmar que se han suprimido las consultas de Tivoli Universal Agent generadas por el servidor del portal o para ver qu consultas hay actualmente definidas, ejecute el siguiente mandato select con respecto a la tabla KFWQUERY:
kfwsqlclient /d TEPS2 /e "select id, name from kfwquery where id like zkum.%%;"
6. Recicle el servidor de supervisin, el servidor de portal y Tivoli Universal Agent. 7. Cuando se active la aplicacin de metarchivo DISKMONITOR durante el arranque de Tivoli Universal Agent, la aplicacin se registra con el sufijo de la versin 00.
32
IBM ofrece metarchivos SNMP para centenares de MIB estndares de la industria. Si tiene aplicaciones especficas SNMP MIB que desea supervisar, primero consulte la pgina de IBM Tivoli Monitoring en el sitio web de OPAL que se encuentra en http://catalog.lotus.com/wps/portal/tm, y compruebe los metarchivos de Tivoli Universal Agent existentes que dan soporte a la aplicacin SNMP. Si en OPAL no encuentra lo que necesita y prefiere realizar usted mismo las conversiones de MIB a metarchivo, puede utilizar el programa MibUtility en la pgina de IBM Tivoli Monitoring que se encuentra en el sitio web de OPAL en la direccin: http://catalog.lotus.com/wps/portal/tm. Acceda al programa MibUtility pulsando en la opcin SNMP MIB to Universal Agent Conversion Utility que se encuentra en el ngulo inferior derecho de la pgina.
Nombres de metarchivos
Los nombres de metarchivos SNMP tienen el formato:
nombreproveedor__empresa.mdl
donde: nombreproveedor Especifica el nmero RFC para MIB estndares IETF o un nombre de proveedor para un MIB especfico de proveedor. empresa Especifica el nombre de la empresa MIB. Por ejemplo, el metarchivo para el estndar de la industrial MIB-2 es RFC1213_mib-2.mdl, y el de la interfaz de Cisco MIB es Cisco_linterfaces.mdl.
Los metarchivos SNMP y archivos trapcnfg se encuentran en los siguientes subdirectorios. No es necesario almacenar lo metarchivos SNMP proporcionados por Tivoli Universal Agent y los archivos trapcnfg o los propios metarchivos SNMP personalizados, en estos subdirectorios personalizados, pero puede utilizarlos para organizar mejor los archivos de definiciones SNMP. Metarchivos MIB de proveedor convertidos proporcionados por IBM Tivoli Monitoring
IBM\ITM\TMAITM6\metafiles\SNMP\vendor
Metarchivos MIB RFC estndares de la industria convertidos proporcionados por IBM Tivoli Monitoring
IBM\ITM\TMAITM6\metafiles\SNMP\standard
Metarchivos trapcnfg_*
IBM\ITM\TMAITM6\metafiles\TRAPCNFG
En los sistemas operativos UNIX, los metarchivos un proveedor de datos no SNMP se encuentra en el siguiente directorio:
<dir_instalacin>/$ARQBIN/um/metafiles
Los metarchivos SNMP y archivos trapcnfg se encuentran en los siguientes subdirectorios. No es necesario almacenar lo metarchivos SNMP proporcionados por Tivoli Universal Agent y los archivos trapcnfg o los propios metarchivos SNMP personalizados, en estos subdirectorios personalizados, pero puede utilizarlos para organizar mejor los archivos de definiciones SNMP.
33
Metarchivos MIB RFC estndares de la industria convertidos proporcionados por IBM Tivoli Monitoring
<dir_instalacin>/$ARQBIN/um/metafiles/SNMP/standard
Metarchivos trapcnfg_*
<dir_instalacin>/$ARQBIN/um/metafiles/TRAPCNFG
Este mandato produce un archivo llamado metarchivo_nombre.txt en el mismo directorio que el archivo .mdl. Tambin puede utilizar el mandato de consola VALIDATE para ver el contenido del metarchivo SNMP en un formato descifrado:
kumpcon validate nombre_metarchivo
34
Cuando ejecute el mandato de validacin (validate), produce un archivo de informe que termina con la extensin .rpt que contiene, entre otras cosas, informacin acerca de los atributos. Consulte el Captulo 3, Creacin de una aplicacin, en la pgina 17 para obtener informacin adicional sobre el mandato validate.
descifra el metarchivo estndar de la industria RFC1213_mib-2.mdl y produce un archivo .txt llamado RFC1213_mib-2.txt. Para impedir que entre los niveles de directorio adicionales, puede establecer la variable de entorno, KUMP_META_PATH, en el directorio donde se encuentra el metarchivo de MIB de SNMP. Utilizando el siguiente ejemplo, entre los dos mandatos siguientes en un indicador de mandatos DOS de Windows:
C:\IBM\ITM\TMAITM6>set KUMP_META_PATH=C:\IBM\ITM\TMAITM6 \metafiles\SNMP\standard C:\IBM\ITM\TMAITM6>kumpcon unpack RFC1213_mib-2.mdl
Paso 2: Identifique las variables MIB de SNMP escalares que sean inters
Explore los atributos que aparecen en el archivo de texto para identificar todas las variables escalares que sean de inters. Las variables MIB de SNMP escalares son definiciones con OID que acaban en cero. Por ejemplo:
SysName D 255 1.3.6.1.2.1.1.5.0 ipInReceives C 999999 1.3.6.1.2.1.4.3.0 udpInDatagrams C 999999 1.3.6.1.2.1.7.1.0
Tenga en cuenta el formato de los atributos o cpielos al metarchivo en el que vaya a definir la aplicacin SNMP personalizada. Puede colocar todos los atributos escalares en uno o ms grupos de atributos. Las variables MIB de SNMP tienen OID que no terminan en cero. Si est interesado en los datos tabulares, deber definir cada tabla de atributos MIB como su propio grupo de atributos. No necesita copiar todos los atributos en una tabla MIB dentro del grupo de atributos; puede elegir nicamente aquellos atributos en la tabla que sean de inters. No obstante, no puede mezclar atributos MIB escalares y tabulares en un grupo de atributos.
35
36
37
Nombres de instancias
Para cada proveedor de datos que pase a estar en lnea, una copia primaria o no de instancia de Tivoli Universal Agent genera un nombre de sistema gestionado con el formato: nombrehostDPTIPOdp:UAGENT00. Para ejecutar varias instancias del mismo proveedor de datos en el mismo sistema, el nombre de sistema gestionado por Tivoli Universal Agent generado utiliza un parmetro de nombre de instancia como prefijo para garantizar la exclusividad. Los convenios de nomenclatura de los nombres de instancia incluyen: Prueba de latido Proveedor de datos Aplicacin nombreinst:nombrehost:UA nombreinst_nombrehostDPTIPOdp:UAGENT00 nombreinst_nombrehost:aplicacinVV
El nombre de instancia se aade como sufijo a todos los archivos de configuracin y de tiempo de ejecucin en el directorio de trabajo de Tivoli Universal Agent. Por ejemplo, KUMPCNFG_TEST, KUMATBLS_INST1 o KUMPURLS_PROD. Los archivos de configuracin y de tiempo de ejecucin de Tivoli Universal Agent primario permanecen como antes, sin sufijo. El Tivoli Universal Agent primario no tiene un prefijo de nombre de instancia en sus nombres de sistema gestionado, ni tiene un sufijo de nombre de instancia en sus archivos de configuracin. Slo puede haber una copia primaria de Tivoli Universal Agent configurada y activa en el sistema al mismo tiempo. No obstante, es posible ejecutar varias copias adicionales, cada una con un nombre de instancia exclusivo, con o sin Tivoli Universal Agent primario activo.
38
Para obtener ms informacin sobre cmo configurar varias instancias de Tivoli Universal Agent en los sistemas UNIX, consulte la publicacin IBM Tivoli Monitoring - Gua de instalacin y configuracin.
Por lo tanto, seleccione nombres de instancia cortos para evitar el truncamiento del nombre del sistema gestionado.
39
Nota: Si utiliza una instancia alternativa de Tivoli Universal Agent como el receptor de condiciones de excepcin de SNMP, copie o renombre el archivo trapcnfg en el directorio de trabajo para que tenga el sufijo del nombre de la instancia. Por ejemplo, si la instancia alternativa se llama SNMP, copie trapcnfg a trapcnfg_SNMP.
40
41
Invocacin de programas
Los programas de llamada C/C++ creados con las API de Tivoli Universal Agent descansan sobre los servicios de API proporcionados por la biblioteca dinmica en tiempo de ejecucin. Los programas se pueden localizar localmente con el Proveedor de datos del servidor de API o no pueden iniciarse en una ubicacin remota. Estos programas de llamadas suelen ser denominados clientes API porque dependen del paquete cliente de API y siguen el paradigma cliente-servidor en las conexiones que establecen con el proveedor de datos de API. Tambin puede considerar los clientes de API como recopiladores de datos ya que su principal propsito es realizar cierto tiempo de recopilacin de datos y enviar dichos datos recopilados al proveedor de datos de servidor de API. La publicacin IBM Tivoli Universal Agent - Gua de consulta de programacin de API y de mandatos contiene los requisitos de programa y los procedimientos para implementar las funciones de la API, y proporciona descripciones, sintaxis y cdigos de retorno de las llamadas a la API, as como un programa cliente de ejemplo de API.
42
Especificacin del puerto de escucha del proveedor de datos del servidor de API
El puerto de escucha predeterminado para el proveedor de datos de servidor de API es 7600. Si este puerto ya se est utilizando o prefiere que se utilice un puerto distinto, puede establecer la variable de entorno KUMP_API_DPAPI_PORT en el puerto preferido. Si establece esta variable para el proveedor de datos de servidor de API o si esta variable se ha reasignado de forma automtica como resultado de una instancia alternativa de Tivoli Universal Agent, deber establecer la misma variable en el lado del cliente de API. Puede comprobar el espacio de trabajo UAGENT DPLOG del Proveedor de datos (o ASFS) para verificar el nmero de puerto de escucha correcto. El mensaje KUMPL020I en DPLOG muestra el puerto de escucha que el proveedor de datos de servidor de API est utilizando.
Puede personalizar la parte NombreHost del nombre de sistema gestionado con la API dp_SetSourceName. Consulte la publicacin IBM Tivoli Universal Agent - Gua de consulta de programacin de API y de mandatos para obtener informacin adicional. Nota: El sistema gestionado de una aplicacin de metarchivo API no pasa a estar en lnea en Tivoli Enterprise Portal Navigator hasta que el programa cliente de API se haya conectado al proveedor de datos de servidor de API.
43
donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de archivo. NombreAplic Valor del nombre especificado en la sentencia //APPL del metarchivo. Consulte Sentencia APPL en la pgina 131 para obtener informacin adicional. VV Sufijo de dos dgitos de la versin. Consulte Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent en la pgina 27 para obtener informacin adicional.
Puede personalizar la parte de NombreHostLocal del nombre de sistema gestionado con el parmetro en la sentencia //SOURCE del metarchivo. Consulte Sentencia SOURCE en la pgina 140 para obtener ms informacin.
44
v Para aquellos datos sondeados, muestreados y con clave, la frecuencia de muestreo deriva del valor de tiempo de vida (TTL) especificado en el metarchivo de definicin de datos, dividido por el factor de muestreo. El TTL predeterminado es de 300 segundos y el factor de muestreo es 5. Puede controlar la frecuencia de muestreo para los datos sondeados y muestreados utilizando la variable de entorno KUMP_DP_SAMPLE_FACTOR y el TTL. Si no define una alteracin temporal, el proveedor de datos de archivo muestrea los datos cada 60 segundos (300 dividido por 5). La frecuencia de muestreo predeterminada mxima es de 5 minutos (300 segundos). Puede alterar temporalmente este valor predeterminado utilizando la variable KUMP_DP_SAMPLE_FACTOR. Por ejemplo, si un metarchivo especifica un TTL de 3600 segundos, la frecuencia de muestreo es 3600 dividida por 5, o 720 segundos. La frecuencia de muestreo que se hace cumplir en realidad es 300, el mximo predeterminado. No obstante, si especifica KUMP_DP_SAMPLE_FACTOR como 10, la frecuencia de muestreo es 360. La alteracin temporal mxima tiene lugar slo si no se ha definido una especificacin de usuario. El proveedor de datos de archivo tambin cumple una frecuencia de muestreo mnima. La frecuencia de muestreo predeterminada de 30 segundos se sustituye si el TTL dividido por el factor de muestreo resulta en una frecuencia de menos de 1 segundo. Por ejemplo, en el caso de un TTL igual a 180 y un KUMP_DP_SAMPLE_FACTOR igual a 360, el archivo se muestrear realmente cada 30 segundos. Si se altera temporalmente la frecuencia especificada, se graba un mensaje en el registro RAS1 de Tivoli Universal Agent que identifica la frecuencia de muestreo mnima en vigor. La frecuencia de muestreo de cada archivo supervisado tambin se graba en UAGENT DPLOG en el mensaje KUMPL016I.
45
cuando se procesen los datos de archivo. Consulte Sentencia SOURCE en la pgina 140 para obtener informacin adicional acerca de la utilizacin de esta sentencia de metarchivo. v Si el archivo supervisado se encuentra en un sistema de directorio que no est en ingls, deber escribir el nombre de va de acceso y de archivo en el metarchivo en el idioma correspondiente. No obstante, deber guardar el metarchivo como un archivo UTF-8. Tivoli Universal Agent slo puede abrir y leer archivos en codificacin ASCII o UTF-8.
El proveedor de datos de archivo inspecciona todos estos archivos en la ubicacin de va de acceso designada, buscando archivos que coincidan con el patrn definido. El proveedor de datos de archivo siempre gestiona el archivo coincidente ms reciente, basndose en qu nombre de archivo coincidente tiene el nmero o valor de fecha/hora ms alto. El archivo correspondiente que se va a supervisar queda determinado por el nombre de archivo, en lugar de por la fecha de creacin u otros criterios. Se pueden especificar patrones para nombres de archivo que consten de una o varias partes. Por ejemplo, Log{###} coincide con nombres de archivo de una parte, como por ejemplo Log010 o bien Log456. En los nombres de archivo de varias partes, se pueden especificar caracteres de patrn en tan slo una de las partes. Por ejemplo, aaa.bbb{???}.ccc es un patrn vlido, pero no lo es aaa.bbb{???}.ccc{###}. Los siguientes ejemplos ilustran la especificacin de patrn de nombre de archivo: {########}.abc Coincide con los nombres de archivos numricos de longitud 8 y con la extensin de archivo .abc, como por ejemplo, 10252006.abc o 10262006.abc. Se supervisar el archivo 10262006.abc porque 10262006 es mayor que 10252006. Coincide con los nombres de archivos numricos de longitud 8 e ignora la extensin del archivo. Los ejemplos incluyen 20061025.log, 20061101.log y 10252006.abc. El archivo 20061101.log se supervisa porque 20061101 es el nmero ms grande. Coincide con los nombres de archivos numricos de longitud 8 e ignora las dos ltimas posiciones de la parte de nombre. Los ejemplos incluyen 02110199.abc, 02110200.abc y 021101AZ.abc. Se supervisar el archivo 02110200.abc porque 021102 es el nmero ms grande. Coincide con los nombres de archivos que contienen Console en la parte del nombre y un nmero de 6 dgitos en la parte de la extensin. Los ejemplos incluyen Console.000133, Console.000201 y Console.000134. Se supervisa el archivo Console.000201. Coincide con los nombres de archivo que comienzan con IN seguido de seis numerales y de la extensin de archivo .log. Los ejemplos incluyen IN021001.log, IN021002.log y IN021004.log. Se supervisar el archivo IN021004.log. Coincide con los nombres de archivo que comienzan por PS seguido por tres numerales seguido de FTP y la extensin .txt. Los ejemplos incluyen PS001FTP.txt, PS005FTP.txt y PS010FTP.txt. Se supervisar el archivo PS010FTP.txt.
{########}.*
{######??}.abc
Console.{######}
IN{######}.log
PS{###}FTP.txt
46
Siga estas directrices para establecer patrones de nombres de archivo: v Utilice llaves {} para delimitar los caracteres de patrn en un nombre de archivo. La presencia de caracteres de patrn dentro de las llaves en una sentencia //SOURCE FILE indica al proveedor de datos de archivo que se utiliza un patrn de nombre de archivo. v Utilice un asterisco (*) como comodn para omitir las extensiones de archivo o caracteres finales que haya en el nombre de archivo. Por ejemplo, Myapp{###}.log* especifica que cualquier nombre de archivo que empiece por Myapp, seguido de 3 dgitos y seguido de log, es una coincidencia, independientemente de lo que venga despus. El asterisco debe especificarse despus de las llaves ({ }) y no se puede utilizar al principio de un nombre de archivo. Cuando se utilice el asterisco en una extensin de nombre de archivo, el asterisco debe emplearse slo. Ejemplos de uso correcto del comodn (*): err{??}.* error{$}.* Ejemplos de uso incorrecto del comodn (*): error.20* No hay ninguna llave delante del asterisco {*). error*.{###} No se utiliza el asterisco al final del nombre de archivo. error.* No hay ninguna llave delante del asterisco (*). Si se define una extensin de archivo en particular, slo los archivos con la misma extensin se tendrn en cuenta. Utilice un smbolo de nmero para indicar cada elemento numrico del nombre de un archivo. Utilice un signo de interrogacin para excluir cada elemento del convenio de nomenclatura que no sirva como criterio de bsqueda determinado del nombre de archivo apropiado. Utilice un smbolo de ($) para representar cualquier carcter o ningn carcter. Por ejemplo, si desea hacer coincidir dos archivos que se denominan Log y LogA, especifique Log{$}. El nmero total de smbolos de nmero y de interrogacin delimitados por llaves es significativo. Debe coincidir exactamente con la parte del nombre de archivo. Por ejemplo, el patrn AA{####} da instrucciones al proveedor de datos para que busque archivos como por ejemplo, AA0001. Los nombres de archivo como AA001 o AA00001 no se tendrn en cuenta. El patrn de nombre de archivo exacto, las partes constantes y numricas, deben coincidir exactamente con el nombre de archivo. Por ejemplo, el patrn AA{###} da instrucciones al proveedor de datos de archivo para que compruebe el archivo AA101. Los nombres de archivo, como XAA101, AA222X y AA55555, no se tienen en cuenta. Utilice la cadena de caracteres patrn reservado {TIVOLILOGTIME} para sustituir por la indicacin de la hora hexadecimal y el nmero de secuencia de archivo en un archivo de registro de servidor o agente de Tivoli Monitoring. Esta cadena de caracteres patrn es til cuando se realiza la supervisin automtica de los componentes de Tivoli Monitoring. Por ejemplo, si desea supervisar el registro ms reciente del servidor de supervisin en el directorio /opt/IBM/ITM/logs, puede codificar la siguiente sentencia de metarchivo:
//SOURCE File /opt/IBM/ITM/logs/Host1_ms_{TIVOLILOGTIME}.log Tail
v v v v v
Si Host1_ms_452053c0-01.log, Host1_ms_451f11f4-01.log, Host1_ms_45205946-01.log y Host1_ms_451f11f4-02.log estn presentes en el directorio /logs, se selecciona el archivo Host1_ms_45205946-01.log para la supervisin. Para especificar de forma precisa un nombre de archivo que consta de componentes de fecha (ao, mes y da), utilice las letras Y, M y D en maysculas. Estas letras deben estar delimitadas por llaves, de lo contrario, se tratarn como caracteres literales en el nombre de archivo. Vea los ejemplos siguientes: {YYYYMMDD}.log Especifica nombres de archivo como por ejemplo 20060930.log o 20061015.log.
Captulo 4. Acerca de los proveedores de datos
47
Especifica nombres de archivo como por ejemplo 101106.log o 110106.log. Especifica nombres de archivo como por ejemplo 01092006.log. o 15082006.log. Especifica nombres de archivo como por ejemplo 24Jan07 o 13Sep06. Especifica nombres de archivo como por ejemplo, 11-02-06 o 04-29-07. Observe que el carcter separador - se omite en el campo de fecha y no es preciso un carcter patrn de interrogacin para omitirlo. Especifica nombres de archivo como por ejemplo, MY06202.log, MY06010.log o MY04350.log.
MY{YYDDD}.log
En los casos ms complejos en los que hay un campo de fecha intercalado en un nombre de archivo ms largo y los patrones de fecha listados en los ejemplos anteriores no son suficientes, puede crear patrones que combinen los signos de nmero y los interrogantes, y seguir realizando comparaciones numricas que seleccionen el archivo ms actual para la supervisin. Por ejemplo, el patrn ABC{?####?##?##?##?##?##?}XYZ.TXT se puede utilizar para nombres de archivo como por ejemplo, ABC 2006-04-20 11_22_33 XYZ.TXT, donde slo interesan los dgitos marcados como # y los signos de interrogacin sirven como marcadores que permiten omitir otros caracteres en el nombre de archivo. El proveedor de datos de archivo busca peridicamente nuevos archivos que coincidan con el patrn de archivos definido en la ubicacin de va de acceso de destino. Cuando se detecta un archivo ms reciente que coincide con el patrn, el proveedor de datos de archivo conmuta automticamente la supervisin de aplicacin al nuevo archivo. El proveedor de datos de archivo busca el archivo con la mejor coincidencia cuando: v Se inicia por primera vez el proveedor de datos de archivo. v El archivo supervisado actualmente ya no existe debido a que se ha cambiado su nombre o se ha suprimido. v El contenido del archivo existente ha cambiado debido a una posible sobregrabacin. v Ha caducado el intervalo de comprobacin. El intervalo predeterminado es de 10. Puede cambiar el intervalo por un intervalo ms corto o ms largo especificando una variable de entorno
KUMP_DP_FILE_SWITCH_CHECK_INTERVAL=nmero-de-segundos
El proveedor de datos de archivo emite un mensaje DPLOG notificndose que el archivo activo supervisado ha cambiado del archivo actual al nuevo archivo. Algunas aplicaciones utilizan un par de archivos de registro relacionados que cambian entre estar activos e inactivos. En muchos casos, el inactivo se borra y el activo va gradualmente aumentando su tamao hasta que se produce el siguiente cambio. Puede utilizar la caracterstica de comparacin de patrn para que el proveedor de datos de archivo supervise un par de archivos basndose en el tamao relativo de archivo.
//SOURCE FILE espec-patrn-nombre-archivo tail CompareBySize
El parmetro CompareBySize significa que de los dos archivos que cumplen los criterios del patrn, se supervisa el archivo de mayor tamao. CompareBySize slo funciona si hay dos o menos archivos en el directorio que cumple el criterio de patrn. Si hay ms de dos archivos coincidentes, entrar en efecto la coincidencia de patrn basada en nombre de archivo. Esta restriccin se ha implementado para impedir una caso en el que varios archivos coincidentes cambiasen de tamao a intervalos irregulares, lo cual puede conducir a cambios de archivo frecuentes. No utilice CompareBySize con dos archivos que se estn actualizando al mismo tiempo, debido a la posibilidad de frecuentes cambios de archivo. Cualquier caso provoca que la supervisin se reinicie al principio del archivo. Utilice CompareBySize cuando haya dos archivos coincidentes, donde slo se actualiza uno en un momento dado.
48
Asimismo, cuando se utiliza el parmetro CompareByLastUpdate, puede elegir entre dos archivos en funcin de la actividad de actualizacin reciente:
//SOURCE FILE espec-patrn-nombre-archivo tail CompareByLastUpdate
Si hay dos archivos en el directorio que cumplen los criterios del patrn, se supervisa el archivo actualizado ms recientemente. Al igual que sucede con CompareBySize, CompareByLastUpdate se limita a los casos en que no hay ms de dos archivos que coincidan. El caso tpico es utilizar CompareByLastUpdate si hay dos archivos de registro en los que uno est activo y se actualizan de uno en uno, y si los dos archivos cambian peridicamente de lugar.
El parmetro tailbyrecord ordena al proveedor de datos de archivo que utilice un mtodo alternativo cuando supervise el archivo. En cada intervalo de muestreo, el proveedor de datos de archivo cuenta los registros fsicos del archivo. Si el recuento actual es mayor que el recuento anterior, los registros aadidos se procesan como datos nuevos.
49
Nota: Tambin puede especificar el parmetro tailbyrecord para los archivos que no estn preasignados. No obstante, el mtodo de contar registros en cada intervalo de muestreo es menos eficaz que el mtodo estndar de supervisar cambios en la ubicacin del puntero de final de archivo. Consulte Sentencia SOURCE en la pgina 140 para obtener ms informacin.
50
En el siguiente ejemplo, el parmetro KUMA_STARTUP_DP inicia el proveedor de datos de HTTP en conjuncin con los proveedores de datos de ASFS y SNMP.
KUMA_STARTUP_DP=ASFS,SNMP,HTTP
donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de HTTP. INTERNET00 Aplicacin INTERNET suministrada por el proveedor de datos de HTTP, que siempre tiene la versin 00. INTERNET es una aplicacin que se genera internamente y que se coloca en lnea automticamente cuando se inicia el proveedor de datos de HTTP. Nota: No es posible crear metarchivos para el proveedor de datos de HTTP. Por lo tanto, no es posible utilizar otra aplicacin que no sea INTERNET con este proveedor de datos.
Supervisin de un URL
Inicie la supervisin de cualquier URL de una de las siguientes tres maneras: v Incluya los URL de destino en el archivo de inicializacin del URL de arranque del proveedor de datos KUMPURLS. v Cree situaciones de IBM Tivoli Monitoring basadas en la tabla INTERNET. v Utilice la opcin de actuacin URL Add.
51
Nota: Los prefijos http:// y https:// son opcionales. Si edita directamente el archivo KUMPURLS, los cambios no se implementarn hasta que recicle Tivoli Universal Agent.
Opcin de Actuacin
Tambin puede especificar la supervisin de varios URL mediante una opcin de Actuacin llamada URL Add. Al seleccionar esta opcin, se visualiza una ventana que le permite especificar los siguientes parmetros: URL Parmetro obligatorio que representa al mismo URL. Puede escribir este parmetro con o sin el prefijo http:// o https://. Si este parmetro no est cumplimentado, el valor predeterminado del nombre de alias pasar a estar vaco, el intervalo de estatus toma el valor predeterminado de 300 segundos, el ID de usuario pasar a TAKE_ACTION y el porcentaje de memoria cach toma el valor predeterminado de 0%.
URLaliasName Parmetro opcional que es posible especificar para asociar un nombre ms significativo a un URL. StatusInterval Parmetro opcional que representa el tiempo transcurrido en segundos entre muestras, es decir, el intervalo de muestreo. Si est supervisando varios URL, puede especificar un intervalo de estatus distinto para cada URL. ID Parmetro opcional que representa el usuario que ha iniciado la supervisin del URL. El ID de usuario predeterminado es el ID de inicio de sesin especificado cuando se establece conexin con el servidor de portal. No obstante, tambin es posible especificar un valor de ID de usuario distinto. El ID de usuario en este contexto tambin recibe el nombre de propietario del URL.
ObjCache% Parmetro opcional que puede utilizar para calcular las medidas de tiempo de respuesta. Si sabe aproximadamente qu porcentaje de las pginas web estn en la memoria cach, especifique dicho valor en ObjCache%. El proveedor de datos de HTTP incorpora el porcentaje de la memoria cach en sus clculos sobre el tiempo de respuesta del URL. Por ejemplo, si especifica el 50%
52
para ObjCache% y hay 20 objetos en la pgina web, entonces slo 10 de los objetos se descargarn, reduciendo el valor de tiempo de respuesta. Despus de cumplimentar la informacin y cerrar la ventana, asigne la accin URL Add al sistema gestionado de destino asociado con la aplicacin INTERNET de Tivoli Universal Agent. La supervisin del nuevo URL comienza inmediatamente. Los datos de disponibilidad y de tiempo de respuesta del URL estn disponibles en el cliente de Tivoli Enterprise Portal para su visualizacin tan pronto como el periodo de intervalo de estatus del nuevo URL haya transcurrido. Tambin se aade el URL al archivo KUMPURLS para que se contine supervisando en distintos reinicios de Tivoli Universal Agent. Una opcin de Actuacin correspondiente, llamada URL Remove, permite la inmediata detencin de la supervisin de un URL determinado. El URL eliminado tambin se suprime del archivo KUMPURLS. La ventana de URL Remove slo solicita los valores de URL y de ID de usuario. El valor de ID de usuario deben coincidir con el valor especificado para el URL cuando se comenz la supervisin o la accin de eliminacin fallar. Si no est seguro de cul es el valor de ID de usuario que debe especificar, puede comprobar el archivo KUMPURLS, que tiene un parmetro USER= para cada URL supervisado, a menos que se haya aadido el URL editando directamente el archivo KUMPURLS. Tambin puede comprobar el valor de columna User_Name en el espacio de trabajo MANAGED_URL debajo de la aplicacin INTERNET. Despus de cumplimentar la informacin y cerrar la ventana, asigne la accin URL Remove al sistema gestionado de destino asociado con la aplicacin INTERNET de Tivoli Universal Agent.
Atributos de URL
El proveedor de datos de HTTP de Tivoli Universal Agent registra automticamente la aplicacin INTERNET. Esta aplicacin contiene los URL gestionados y las definiciones de tabla de objetos URL que se visualizan en los informes de INTERNET.
53
Tabla 6. Atributos de URL (continuacin) Nombre de atributo Intervalo del estatus Entero Tipo Tamao Largo Descripcin Tiempo transcurrido, en segundos, entre las comprobaciones de estatus del URL de destino. Hora a la se ha tomado el ltimo estatus del URL gestionado. Nmero total de bytes descargados de los objetos de pgina asociados. Nmero total de muestras tomadas de este URL desde que comenz la supervisin. URL gestionado de destino. Debe utilizar el formato http:// o https://. Alias especificado por el usuario del URL. ID de usuario que ha iniciado la supervisin del URL de destino.
Indicacin de la hora del estatus Tamao total del objeto Total de muestras tomadas URL Alias de URL Nombre de usuario
Los clculos que se realizan para determinar los valores de atributos como el Tiempo medio de respuesta y el Tiempo mximo de respuesta se basan en el concepto de un conjunto de muestras. Si un URL se ha supervisado durante das, se habrn obtenido miles de estadsticas de muestreo del mismo. No obstante, slo las estadsticas ms recientes son necesarias para los informes como por ejemplo, Tiempo medio de respuesta. De hecho, incluir las medidas de tiempo de respuesta de das y horas antes puede acabar alterando el promedio. Por lo tanto, el proveedor de datos de HTTP mantiene una tabla interna, conocida como conjunto de muestras, de las muestras obtenidas ms recientemente y utiliza slo dichos valores para calcular las estadsticas de tiempo de respuesta. El tamao del conjunto de muestra est determinado por un valor del Intervalo de estatus del URL. Un intervalo de estatus pequeo conlleva un conjunto de muestras de gran tamao y un intervalo de estatus grande conlleva un conjunto de muestras pequeo. El valor de los conjuntos de muestras puede estar comprendido entre 3 y 15 (3 si el intervalo de estatus son 5 minutos y 15 si el intervalo de estatus es 1 minuto), pero siempre se basan en los ltimos 15 minutos de los datos muestreados. Si necesita captar informacin de URL durante ms tiempo que los ltimos 15 minutos, configure la recopilacin de datos histricos para la tabla URL gestionados. Puede especificar el nombre de ISP en un archivo de texto llamado ISP.ID que se encuentra en el directorio WORK de instalacin del producto Tivoli Universal Agent. Si el archivo no existe, se utilizar un valor predeterminado de ISP LAN.
Objetos de URL
La segunda tabla INTERNET, Objetos URL, incluye los siguientes atributos:
Tabla 7. Objetos URL Nombre de atributo Nombre de objeto Tamao del objeto URL UTF-8 Entero UTF-8 Tipo Tamao 512 Largo 512 Descripcin Nombre del objeto de pgina dentro del URL de destino. Tamao del objeto de pgina dentro del URL de destino. URL gestionado de destino. Debe utilizar el formato http:// o https://.
54
La tabla Objetos URL contiene una entrada URL para cada objeto incorporado, como los archivos .gif y .jpg que pueden utilizarse en el sitio web indicado en el informe URL gestionados. Cuando necesite supervisar el tiempo de respuesta y la disponibilidad de determinados objetos dentro de un sitio web, revise el contenido de la tabla Objetos URL.
Los valores que suministre para estas dos variables estn cifrados por el proveedor de datos de HTTP y se envan al servidor proxy si la llamada Get de HTTP inicial para un URL genera un error de autentificacin 401 o 407. Si hay un servidor proxy en particular que desee utilizar que no est el host local y no utilice un nmero de puerto HTTP predeterminado, tambin deber especificar la variable de entorno KDH_CLIENTPROXY, igual que sucede en el siguiente ejemplo:
KDH_CLIENTPROXY=http://HostA:1920
55
donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de ODBC. NombreAplic Valor del nombre especificado en la sentencia //APPL del metarchivo. Consulte Sentencia APPL en la pgina 131 para obtener ms informacin. VV Sufijo de dos dgitos de la versin. Consulte Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent en la pgina 27.
El proveedor de datos de ODBC da soporte al parmetro ManagedSystemName=xxxxxx en la sentencia //SOURCE, que permite que la parte del nombre de sistema gestionado NombreHostLocal se personalice. El parmetro ManagedSystemName permite agrupar varias frentes de datos ODBC relacionadas que tienen el mismo diseo de atributos bajo una misma sentencia //NAME. Para ms informacin, consulte ManagedSystemName= debajo de Sentencia //SOURCE en la pgina 59.
56
Ejemplo 1
//APPL NWIND //NAME EMPLOYEES K 300 Interval=60 //SOURCE ODBC nwind //SQL select * from empleados //ATTRIBUTES IDempleado N 8 KEY ATOMIC Apellido D 32 Nombre D 32 Ttulo D 32 Tratamiento D 16 FechaNacimiento D 24 FechaContratacin D 24 Direccin D 32 Ciudad D 32 Regin D 32 CdigoPostal D 32 Pas D 32 Telfono D 32 Extensin D 16 Notas D 128 Supervisor N 4
Parmetros y sentencias
Sentencia //NAME
La sentencia //NAME tambin especifica K 300, que indica que es una tabla con clave y que sus datos tienen un valor TimeToLive de 300 segundos. Debe utilizar una tabla con clave para los metarchivos ODBC por las siguientes razones: v Impide que las mismas filas recuperadas se aadan varias veces cuando se inicia la sentencia Select de SQL. v La mayora de las tablas ODBC tienen una o ms columnas indexadas que se corresponden de manera lgica con los atributos KEY en el metarchivo de Tivoli Universal Agent.
Sentencia //SOURCE
La sentencia //SOURCE soporta un parmetro ODBC para especificar que es un metarchivo ODBC. Este es un parmetro obligatorio para todos los metarchivos ODBC. La presencia de este parmetro significa que otros proveedores de datos omiten cargar el metarchivo y slo el proveedor de datos de ODBC lo carga y lo activa. A continuacin del parmetro ODBC deber incluir el nombre de la fuente de datos de ODBC, nwind en este ejemplo. Es el mismo nombre con el que ha configurado el applet Fuentes de datos ODBC. Debe configurar esta fuente de datos ya que el proveedor de datos de ODBC no lo configura automticamente. Si la fuente de datos no es accesible desde la red o el proveedor de datos de ODBC no puede conectarse a ella porque faltan las credenciales de ID de usuario/contrasea o estas son incorrectas, el sistema gestionado asociado no pasar a estar en lnea. Si el nombre de la fuente de datos contiene espacios en blanco incorporados, debe estar delimitado por comillas simples.
57
Sentencia //SQL
Cada metarchivo ODBC requiere una sentencia //SQL vlida para cada sentencia //NAME. Puede utilizar una sentencia Select de SQL o un nombre de procedimiento almacenado. En el ejemplo anterior todas las columnas y filas se seleccionan de la tabla Empleados de la base de datos Microsoft Access Northwind, configurada como nwind.SQL
Sentencia //ATTRIBUTES
En los metarchivos ODBC, los atributos listados en la sentencia //ATTRIBUTES deben coincidir con los nombres de columna definidos en la tabla ODBC a la que se est accediendo. No es necesario incluir un atributo para cada columna de la tabla. Tampoco es necesario enumerar los atributos en la misma secuencia que las columnas que se muestran en la tabla ODBC. No obstante, los atributos que se incluyan debern tener un nombre de columna coincidente. Los nombres no son sensibles a maysculas y minsculas. No es posible renombrar un atributo en el metarchivo para que ya no coincida con su columna correspondiente. Puede aadir atributos derivados y otros atributos especficos de Tivoli Universal Agent como un LocalTimeStamp.
Ejemplo 2
Este es otro ejemplo que ilustra las caractersticas adicionales de los metarchivos ODBC: //APPL TEPS //NAME spt_server_info K 300 AddTimeStamp //SOURCE ODBC teps2 user=sa pswd= maxrows=50 //SQL select * from spt_server_info where attribute_id > 2 //ATTRIBUTES attribute_id N 8 KEY ATOMIC attribute_name D 64 attribute_value D 64 * //NAME sp_helpdb K 300 //SOURCE ODBC teps2 user=sa pswd= //SQL proc=sp_helpdb "master" //ATTRIBUTES name D 32 KEY ATOMIC db_size D 32 owner D 32 dbid C 999999 created D 20 status D 64
Sentencia //NAME
La ausencia del parmetro Interval= indica que esas dos tablas utilizan la recopilacin de datos bajo demanda. La tabla spt_server_info incluye un parmetro AddTimeStamp, que inserta una columna LocalTimeStamp en el informe spt_server_info.
58
Sentencia //SOURCE
La fuente de datos teps2 de SQL Server requiere una combinacin de ID de usuario/contrasea para conectarse. Por lo tanto, ambas sentencias //SOURCE incluyen los parmetros user= y pswd=. El ID de usuario sa no tiene una contrasea asociada, por lo que el parmetro pswd= se deja en blanco. De forma predeterminada, se devuelven un mximo de 100 filas para cada tabla ODBC en un metarchivo. Para aumentar o disminuir este valor para una tabla en particular, puede incluir una alteracin temporal mediante maxrows=nn en la sentencia //SOURCE. Puede alterar globalmente el valor predeterminado con la variable de entorno KUMP_ODBC_MAX_ROWS. El valor maxrows=50 especificado para la tabla spt_server_info significa que si la sentencia Select devuelve ms de 50 filas, slo las primeras 50 filas se utilizarn para los informes y la evaluacin de la situacin.
Sentencia //SQL
La primera sentencia //SQL en el Ejemplo 2 muestra cmo incluir una clusula Where para filtrar qu filas devolver. Utilice el filtrado mediante clusula Where en los metarchivos ODBC siempre que sea posible. Esta clusula es ms eficaz porque se recuperan menos filas. Emita sentencias Select de SQL calificadas que slo recuperen las filas que desee evaluar en las situaciones. La tabla sp_helpdb en el Ejemplo 2 ilustra la utilizacin de los procedimientos almacenados. En lugar de una sentencia Select, la sentencia //SQL puede especificar el nombre de un procedimiento almacenado, el cual debe ir precedido de la palabra clave proc=. Si existe algn parmetro de entrada para el procedimiento almacenado, debern ser seales separadas por espacios en blanco despus del nombre de procedimiento almacenado. En este ejemplo, master es el nico parmetro proporcionado al procedimiento sp_helpdb. Dado que se trata de una cadena de caracteres, el parmetro master debe ir entre comillas dobles. Se presupone que los parmetros de procedimiento almacenado sin comillas dobles son parmetros enteros. Los dos metarchivos de ejemplo anteriores presuponen que existe una relacin de uno a uno entre los grupos de atributos de Tivoli Universal Agent y las tablas SQL, pero esto no es un requisito. Las uniones de SQL estn soportadas. Puede utilizar una sentencia //SQL para seleccionar columnas de 10 tablas diferentes y almacenar los valores recuperados en atributos que pertenecen a un nico grupo de atributos de Tivoli Universal Agent. El nico requisito es que las columnas recuperadas tengan nombres de atributos coincidentes; no obstante, las columnas no tienen que proceder de la misma tabla.
59
Configuracin predeterminada
Las caractersticas de supervisin predeterminadas del proveedor de datos de envo se especifican en el metarchivo predefinido KUMPOST que se muestra en la Figura 10 en la pgina 61. El proveedor de datos de envo utiliza automticamente esta definicin de metarchivo a menos que la altere temporalmente con su propia implementacin de KUMPOST. Consulte Personalizacin del proveedor de datos de envo con el metarchivo KUMPOST en la pgina 62 para obtener ms informacin. El nombre de la aplicacin definida por KUMPOST es MAS (Mensajes, Alertas, Estatus) y el nombre del grupo de atributos es dpPost. La aplicacin recopila datos con un tiempo de vida de una hora. Hay cinco atributos en el grupo, delimitados por signos de punto y coma (;). Los valores de los tres primeros atributos los proporciona el proveedor de datos de envo de forma automtica. Los valores de atributos de Post_Text y Post_Category se obtienen de una aplicacin o de un mandato de consola utilizando el programa KUMPSEND.
Tabla 8. Atributos MAS del proveedor de datos de envo Atributo Post_Time Post_Origin Post_Ack_Stamp Post_Text Post_Category Definicin Hora en que se recibi el mensaje. Nombre de host que ha enviado el mensaje. Identificador exclusivo generado para cada mensaje recibido. Texto del mensaje enviado al proveedor de datos de envo. Una de las diez categoras predefinidas de mensajes del proveedor de datos de envo.
60
//APPL MAS //NAME dpPost S 3600 //ATTRIBUTES ; Post_Time T Post_Origin D Post_Ack_Stamp D Post_Text U Post_Category D
16 32 26 512 16
donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de envo. NombreAplic El nombre de aplicacin suele ser MAS, que es la aplicacin suministrada por el proveedor de datos de envo generada internamente. No obstante, el nombre se puede cambiar con un metarchivo KUMPOST personalizado o con la variable de entorno KUMP_POST_APPL_NAME. VV Sufijo de dos dgitos de la versin. Consulte Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent en la pgina 27.
Categoras de mensajes
Existen diez categoras predefinidas de mensajes de envo, como se muestran en la Tabla 9. El significado de cada categora viene determinado por los datos y las directrices locales de utilizacin.
Tabla 9. Categoras de mensajes del proveedor de datos de envo Categora I O P S N A C W R D Informacin Operacin Aplicacin Sistema Red Alertas Crtico Aviso Restablecer Detalle Descripcin
Indicacin de reconocimiento
El proveedor de datos de envo genera una indicacin de reconocimiento para identificar de manera exclusiva cada mensaje recibido desde una aplicacin. La indicacin se devuelve a la aplicacin remitente slo si la aplicacin est conectada al proveedor de datos de envo mediante un socket TCP orientado a
Captulo 4. Acerca de los proveedores de datos
61
conexiones. En el caso de los sockets UDP, la indicacin se asocia internamente con el mensaje recibido, pero no se devuelve. Al utilizar la indicacin de reconocimiento, es posible rastrear e identificar todos los mensajes de proveedor de datos de envo mientras estn en el sistema. La indicacin
AAAAAAAATTTTTTTTTTTTCSSSSS
se compone de cuatro partes donde: AAAAAAAA TTTTTTTTTTTT C SSSSS es el origen del mensaje es la hora local de llegada del mensaje es la categora del mensaje es la suma de comprobacin complementaria del mensaje
62
Tabla 10. Variables de entorno del proveedor de datos de envo (continuacin) Variable de entorno KUMP_POST_APPL_TTL KUMP_POST_CATEGORY Descripcin Altera temporalmente el valor de tiempo de vida del grupo de atributos. Redefine las categoras predeterminadas de envo o aade nuevas.
Por ejemplo, es posible que el proveedor de datos de envo satisfaga la mayora de los requisitos del usuario. No obstante, si desea que el nombre de sistema gestionado de la aplicacin y el nombre de espacio de trabajo reflejen con ms precisin el rea especfica que sea de su inters, puede alterar temporalmente los nombres de aplicacin y grupo de atributos utilizando las variables de entorno KUMP_POST_APPL_NAME y KUMP_POST_GROUP_NAME, como en el ejemplo siguiente.
KUMP_POST_APPL_NAME=SYSTEM KUMP_POST_GROUP_NAME=HELPDESK
Cuando se inicia el proveedor de datos de envo con estas dos variables de entorno en vigor, el nombre del sistema gestionado es NombreHostLocalPostDP:SYSTEM00 y el nombre de espacio de trabajo en el rbol de Navigator de TEP (Tivoli Enterprise Portal o portal) es HELPDESK. Consulte el Captulo 5, Supervisin de aplicaciones, en la pgina 113 para obtener informacin sobre la nomenclatura de sistemas gestionados y espacios de trabajo. Otro ejemplo es que si inicia el proveedor de datos de envo con las siguientes especificaciones, los mensajes recopilados en el espacio de trabajo GENERAL, debajo del sistema gestionado NombreHostLocalPostDP:BOB00 se suprimen automticamente despus de 2 horas (7200 segundos):
KUMP_POST_APPL_TTL=7200 KUMP_POST_APPL_NAME=BOB KUMP_POST_GROUP_NAME=GENERAL
Tambin puede aadir, redefinir o eliminar las definiciones de categoras predeterminadas. Es posible un mximo de 16 categoras de mensajes. Por ejemplo, la siguiente definicin aade la categora X al proveedor de datos de envo:
KUMP_POST_CATEGORY=(X=Experimental)
63
Por favor, necesito ayuda. El sistema lleva sin funcionar una hora y no puedo trabajar;c
El programa KUMPSEND
El programa KUMPSEND proporciona una interfaz de lnea de mandatos para el proveedor de datos de envo. Este programa funciona junto con los cinco atributos predeterminados MAS. Si aade ms atributos a la aplicacin o altera la secuencia de atributos, deber desarrollar un nuevo programa de apoyo para interactuar con el proveedor de datos de envo. El programa KUMPSEND recibe peticiones examinando los parmetros de entrada orientados a palabras clave. La sintaxis del mandato KUMPSEND es: kumpsend msg=texto [cat=categora] [dp=nombrehost_pd] [port=puerto_escucha_pd] [ack=Y|N] donde: msg cat dp port ack Mensaje enviado al proveedor de datos, delimitado por comillas dobles (). Este parmetro acepta entradas globalizadas. Categora del mensaje. Las categoras predeterminadas pueden consultarse en la Tabla 9 en la pgina 61. Nombre de host del proveedor de datos. El valor predeterminado es el host local. Puerto en el que el proveedor de datos de destino est escuchando. El valor predeterminado es 7575. Indica que es necesario un reconocimiento por parte del proveedor de datos. El valor predeterminado es N.
Por ejemplo, para enviar el mensaje de estatus de informacin, Hello World! Ya estoy listo. al proveedor de datos de envo en ENG1 sin solicitar un reconocimiento, entre:
KUMPSEND msg="Hello World! Ya estoy listo." dp=ENG1
Para enviar un mensaje de alerta al proveedor de datos de envo y solicitar de este un reconocimiento en el host atlantis, entre: KUMPSEND msg="La tasa de descarte de paquetes del direcionador NY-TC1 excede el umbral" dp=atlantis cat=a ack=yes Entre un signo de interrogacin (?) con el mandato para obtener ayuda con las palabras clave. Por ejemplo,
KUMPSEND ?
Cdigos de retorno
Si llama al programa KUMPSEND desde el interior de un script y necesita comprobar los cdigos de retorno, a continuacin se suministran cuatro posibles cdigos de retorno:
0 1 2 3 = = = = Satisfactorio Entorno de socket local no vlido Error del parmetro de entrada Error al contactar con el proveedor de datos de destino
64
Si hay un cortafuegos que bloquea la comunicacin de socket entre uno y otro programa, deber permitir explcitamente que el programa de envo, bien sea KUMPSEND o su propia aplicacin escrita in situ, atraviese el cortafuegos y se comunique con el proveedor de datos de envo.
65
Metarchivos de script
Un metarchivo de script requiere una sentencia //SOURCE por cada sentencia //NAME. La sentencia //SOURCE debe apuntar a una ubicacin de va de acceso en el sistema local donde pueda encontrarse un archivo de script. Deber rodear el nombre de va de acceso o de script de comillas simples si contiene espacios en blanco incorporados. Cualquier tipo de script puede supervisarse siempre que el intrprete de script est disponible para el proveedor de datos de script. Algunos ejemplos de tipos de script son VBScript, script de shell, script Perl, archivo bat, JavaScript y script REXX. Si es necesario, el nombre de intrprete de scripts debe preceder al nombre de script en la sentencia //SOURCE. Por ejemplo, en los sistemas Windows, el programa intrprete perl.exe es necesario para procesar los scripts Perl; la sentencia //SOURCE podra ser parecida a la siguiente:
//SOURCE SCRIPT C:\Perl\bin\perl.exe myscript.pl "arg1 arg2"
Asimismo, si se ejecuta un script REXX, suministre el programa intrprete REXX, como en este ejemplo:
//SOURCE SCRIPT C:\ObjREXX\rexx.exe HelloWorld.rex Interval=60
E incluso puede ejecutar cdigo Java desde un archivo jar, como en este ejemplo:
//SOURCE SCRIPT C:\Archivos de programa\IBM\Java142\jre\bin\java.exe "-jar \ C:\Java\HelloWorld.jar"
Si no incluye el nombre de intrprete de script, el analizador de metarchivos de Tivoli Universal Agent presupone que la primera seal delimitada por espacios en blanco despus de //SOURCE SCRIPT es el nombre de script. Aunque se llama proveedor de datos de script, puede especificar en el metarchivo del script cualquier programa que escriba mensajes en salida estndar. En el segundo ejemplo anterior, el archivo myprog.exe es un archivo binario y no un script, y a pesar de ello el archivo se puede utilizar en un metarchivo de script si el archivo binario enva la salida a la salida estndar. Deber colocar cualquier argumento que se pase al script entre comillas dobles a continuacin del nombre del script en la sentencia //SOURCE. De forma predeterminada, cada seal separada por un
66
espacio en blanco dentro de las comillas dobles se trata como un argumento independiente. Si necesita agrupar una o ms seales separadas por espacios en blanco en un argumento, colquelas entre comillas simples. En el siguiente ejemplo:
//SOURCE SCRIPT monitor.sh "aaa bbb ccc ddd"
Debe ser posible ejecutar el script como un mandato independiente. El script no puede tener dependencias de una infraestructura o subsistema mayor que impide que el script pueda ser llamado desde una lnea de mandatos.
67
blanco incorporados. Si envfile se especifica como un nombre de archivo sin calificar, el proveedor de datos de script busca automticamente el envfile en el directorio de scripts. Siempre que se dispone a iniciar un script, el proveedor de datos de script establece cada variable de entorno especificada en el archivo envfile y pasa dicho entorno al proceso de script llamado. Si el tamao del archivo envfile o su fecha de ltima modificacin cambian, indicando que se ha actualizado el archivo envfile, volver a procesarse el contenido del archivo. En caso contrario, los mismos valores de la variable de entorno permanecen en vigor para cada invocacin de script. A continuacin, se muestra un ejemplo de envfile que se puede utilizar para dar soporte a un script Perl script que ejecuta ping en una serie de dispositivos de red:
SYSTEMROOT=C:\winnt SYSTEMDRIVE=C:
Las API de red Perl de Windows requieren que se establezcan las variables de entorno SYSTEMROOT y SYSTEMDRIVE, por lo que este envfile garantiza que el proceso hijo del script iniciado tiene acceso a estas variables. Cuando se investiga un problema en el que un script que se ha ejecutado satisfactoriamente desde una ventana de mandatos no se ejecuta correctamente cuando el proveedor de datos de script lo inicia, compruebe si el script iniciado tiene todos los mismos valores de entorno que el ID de usuario en una ventana de mandatos. Los scripts se bifurcan como procesos hijo en segundo plano, que es una modalidad diferente de funcionamiento que ejecutarlos en un shell de mandatos en primer plano. Por ejemplo, en el segundo plano, Windows, no es necesario que se aada como prefijo a un script de Perl el intrprete Perl.exe porque el registro de Windows sabe qu cualquier nombre de archivo que finalice por una extensin .pl est asociado a Perl.exe. Pero la informacin de registro de Windows no es accesible a un proceso hijo de script iniciado por el proveedor de datos de script, que es la razn por la que se necesita una especificacin explcita del intrprete Perl.exe en el metarchivo. Asimismo, un script que abre y lee un nombre de archivo sin calificar podra funcionar correctamente en el segundo plano porque la va de acceso relativa del archivo se puede determinar desde el contexto actual de la ventana de mandatos, pero este mismo script requiere que el nombre de archivo est calificado al completo cuando lo inicia el proveedor de datos de script. La diferencia entre la ejecucin de un script en segundo plano y uno en primer plano es la razn principal de que un parmetro envfile=xxxx sea a veces necesario en el proveedor de datos de script, para que el script tenga acceso a todos los valores de entorno adicionales que necesita. Para crear rpidamente un envfile que contiene todos los valores del entorno local, puede emitir un mandato que redirija los valores a un archivo, y a continuacin, hacer referencia a dicho archivo en el metarchivo del proveedor de datos de script. Por ejemplo, en UNIX puede emitir este mandato:
env >env.dat
Si a continuacin el archivo env.dat se especifica en un parmetro envfile=env.dat en la sentencia de metarchivo //SOURCE SCRIPT, y se renueva el metarchivo, puede determinar si el problema de ejecucin de un script de segundo plano se ha debido a un valor de variable de entorno que falta. Para mantener la compatibilidad con los scripts o programas utilizados por IBM Tivoli Distributed Monitoring, se generarn determinadas variables de entorno si no estn ya especificadas dentro de un archivo de entorno especificado. No todos los valores que IBM Tivoli Distributed Monitoring (DM) utiliza se generarn. La siguiente tabla proporciona el nombre del valor generado y su valor predeterminado:
68
Tabla 11. Variables de entorno generadas Nombre del valor MONITOR_ID Valor predeterminado El hash del script a ejecutar, los argumentos y los valores de entorno PROFILE_OID y ENDPOINT_OID si estn presentes en el entorno. El hash del script a ejecutar, los argumentos y los valores de entorno PROFILE_OID y ENDPOINT_OID si estn presentes en el entorno. Igual que MONITOR_ID. El nombre de host del sistema supervisado. Los valores soportados son: aix4-r1, solaris2, linux-ix86 y hpux10. El script o a ejecutar. La cadena de argumentos. El script o a ejecutar. Igual que MONITOR. La ltima salida del script o programa. La indicacin de la hora del momento en que se obtuvo la ltima salida. El nmero de veces que se ha ejecutado el script.
PROBE_ID
El siguiente metarchivo simple muestra cmo se podran utilizar algunas de estas variables de entorno generadas:
//APPL Sample //NAME TestScript K 300 AddTimeStamp //SOURCE Script /bin/sh test.sh Interval=60 //Attributes HostName (GetEnvValue = HOSTNAME) Script (GetEnvValue = PROBE) PreviousValue (GetEnvValue = PREV_VALUE) Stdout D 256 KEY
La funcin de atributo derivado GetEnvValue obtiene el ltimo valor para cada una de las tres variables de entorno y almacena el valor en el atributo correspondiente. Si no se ha establecido una variable de entorno, se almacena un nico espacio en blanco en el atributo correspondiente a menos que se haya especificado un valor de parmetro DEFAULT para el atributo (para obtener ms informacin sobre el parmetro DEFAULT, vea el Apndice B, Definiciones de atributos, en la pgina 169). Estos tres atributos forman parte de los datos de espacio de trabajo TestScript de la misma manera que la salida de script capturada en el atributo de salida estndar. Para obtener ms informacin sobre cmo utilizar las funciones de atributo derivadas, consulte Funciones de atributos derivados en la pgina 180.
69
ejemplo, porque consulta bases de datos remotas o sondea diversos dispositivos en la red, entonces es mejor implementar el script a intervalos con un parmetro INTERVAL=nn. Esto permite que el espacio de trabajo se abra y se renueve para responder con rapidez con los datos que se han obtenido de la ejecucin de script ms reciente. Por otro lado, si el script slo precisa de un segundo o dos en completarse, y el usuario siempre desea ver datos que se acerquen al mximo posible del tiempo real, entonces es preferible un script dirigido por mandatos sin el parmetro INTERVAL=nn.
Directorio de scripts
Al instalar Tivoli Universal Agent, se crear un directorio de scripts en el mismo nivel que los metarchivos y directorios de trabajo. Almacene todos los archivos de script en este directorio de scripts para no tener que proporcionar un nombre de va de acceso calificado al completo para los scripts en la sentencia //SOURCE SCRIPT. Cuando el proveedor de datos de script procesa un metarchivo que contiene un archivo de script sin calificar, buscar automticamente el archivo en el directorio de scripts.
donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de Script. NombreAplic Valor del nombre especificado en la sentencia //APPL del metarchivo. Consulte Sentencia APPL en la pgina 131 para obtener informacin adicional. VV Sufijo de dos dgitos de la versin. Consulte Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent en la pgina 27.
Si el archivo de script no es accesible durante el arranque, el sistema gestionado correspondiente no pasar a estar en lnea. Del mismo modo, si el archivo de script se renombra o suprime despus del arranque, su sistema gestionado pasar a estar fuera de lnea. En ambos casos, el proveedor de datos de script entrar en un bucle de espera/reintentos para comprobar de forma peridica si el script est disponible. Cuando el script vuelva a estar disponible, el sistema gestionado pasar a estar en lnea. Como el proveedor de datos de archivo, ODBC y de socket, el proveedor de datos de script soporta el parmetro ManagedSystemName=xxxxxx en la sentencia //SOURCE, que permite personalizar la parte NombreHostLocal del nombre de sistema gestionado. El parmetro ManagedSystemName tambin permite agrupar varios scripts relacionados que tienen el mismo diseo de atributos bajo una misma sentencia //NAME, por ejemplo:
//APPL MyAppl //NAME AttrData K 300 AddTimeStamp Interval=60 //SOURCE SCRIPT C:\wmi\resmodel1.vbs arg1 ManagedSystemName=ResModel1 //SOURCE SCRIPT C:\wmi\resmodel2.vbs arg1 ManagedSystemName=ResModel2 //SOURCE SCRIPT C:\wmi\resmodel3.vbs arg1 ManagedSystemName=ResModel3 //ATTRIBUTES ; Attr1 R 512 Key @Attr1 help text
Si este metarchivo se activase y el proveedor de datos de script pudiese acceder a los tres scripts, los siguientes tres sistemas gestionados se registraran en el servidor de Tivoli Enterprise Monitoring y se insertaran en el Navigator del Tivoli Enterprise Portal:
ResModel1:MyAppl00, ResModel2:MyAppl00, ResModel3:MyAppl00
70
El valor del nombre de host local ser sustituido por el valor de ManagedSystemName=xxxxxx. Para ms informacin, consulte ManagedSystemName= debajo de Sentencia //SOURCE en la pgina 59.
Autentificacin de script
Un requisito comn de un script es que un ID de usuario especialmente autorizado debe ejecutar el script para dar acceso de script a recursos protegidos. De forma predeterminada, cada script iniciado hereda el ID de usuario del proceso de Tivoli Universal Agent. En los sistemas operativos Windows, se utiliza el ID de usuario de la cuenta "LocalSystem" del Servicio de Windows, que tiene privilegios de Administrador en el sistema local. En los sistemas operativos UNIX, se utiliza el ID de usuario ha iniciado Tivoli Universal Agent. Si un script requiere una autentificacin especial, deber proporcionar un parmetro User= y Pswd= en la sentencia //SOURCE. Si estn presentes, dichos valores sern utilizados por el proveedor de datos de script como credenciales de autorizacin cuando se inicia el script. El usuario indicado debe estar definido en el sistema y tener autorizacin de ejecucin sobre el script que va a ejecutar. A continuacin se muestran sentencias de metarchivo de muestra para mostrar cmo codificar los parmetros User y Pswd:
//APPL DBQUERY //NAME OUTPUT K 300 AddTimeStamp //SOURCE SCRIPT dbquery.sh User=db2admin
Pswd=Xyz!345g
Interval=90
Nota: En los sistemas UNIX, no es necesario incluir el parmetro Pswd= si Tivoli Universal Agent se ha iniciado con un ID raz. En dicho caso, es suficiente incluir nicamente el parmetro User= porque raz puede conmutarse por un ID de usuario distinto sin tener que suministrar una contrasea. No obstante, en los sistemas Windows, el parmetro Pswd= debe especificarse siempre que exista un parmetro User=. Otra estrategia para autentificar scripts es configurar Tivoli Universal Agent para que su propio ID de usuario propietario tenga la autorizacin necesaria para ejecutar todos los scripts. En los sistemas operativos Windows, vuelva a configurar el servicio de Tivoli Universal Agent mediante el applet Panel de control Herramientas administrativas Servicios. Cambie "LocalSystem" por un ID de usuario en el dominio local. Del mismo modo, en los sistemas operativos UNIX, inicie Tivoli Universal Agent con un ID de usuario que tenga autorizacin en tiempo de ejecucin para el script requerido.
71
haya salido dentro de dicho periodo de tiempo. Esto se consigue para evitar una acumulacin gradual de procesos de script que se encuentran en un bucle sin fin o una espera indefinida. Hay varias razones posibles por las que se produce una espera excedida de script. El script puede tener un error de codificacin que haga que se cuelgue o entre en un bucle. O quizs, el script est atascado en una espera indefinida mientras intenta acceder a un recurso que no da respuesta. O simplemente, el script puede tardar un tiempo largo en finalizar porque sondea docenas o centenares de dispositivos remotos, algunos de los cuales tardan varios segundos en agotar el tiempo de espera, en cuyo caso, deber especificar una modificacin temporal del parmetro Runtime=nnn en la sentencia //SOURCE para otorgar al script ms de 60 segundos para completarse. (Consulte Sentencia SOURCE en la pgina 140 para obtener ms informacin sobre el parmetro Runtime). Tenga en cuenta que si establece un valor de Runtime en ms de 60 segundos porque tiene un script de larga ejecucin, deber ajustar tambin el parmetro Interval=nnn para que el Intervalo del script sea mayor o igual a Runtime. Si desea crear situaciones que busquen tiempos de espera excedidos de script, un mtodo es definir una situacin que busque la cadena KUMPL136W en el atributo DP_Log_MsgID de la tabla DPLOG. El mensaje KUMPL136W lista el nombre del script, el ID de proceso, y el nmero de segundos que estaba activo antes de exceder el tiempo de espera. Si desea impedir que determinados script propensos a errores excedan el tiempo de espera una y otra vez, puede establecer la variable de entorno KUMP_MAXSCRIPT_TIMEOUTS=nn. Por ejemplo,
KUMP_MAXSCRIPT_TIMEOUTS=5
significa que si un script ha excedido ms de 5 veces el tiempo de espera, el proveedor de datos de script ya no intentar iniciar el script y terminar el subproceso de supervisin del script. Si posteriormente, desea reactivar el script despus de corregir la causa de los tiempos excedidos de espera, puede renovar el metarchivo del script para borrar el contador de tiempos de espera de nuevo, ponerlo a 0 y reiniciar el subproceso de supervisin del script.
El nombre sin calificar, listdrives.vbs, quiere decir que el script listdrives.vbs se encuentra en el directorio de scripts de Tivoli Universal Agent. En el siguiente apartado se describen otros aspectos del metarchivo de script de ejemplo:
72
Este metarchivo de ejemplo de script invoca el programa de Windows Script Host, cscript.exe, que generalmente escribe dos sentencias de encabezado en la parte superior de su salida estndar:
Microsoft (R) Windows Script Host versin 5.6 Copyright (C) Microsoft Corporation 1996-2001. Reservados todos los derechos.
Para impedir que dichas dos filas de datos se visualicen en el espacio de trabajo de Tivoli Enterprise Portal, el primer atributo del metarchivo del script incluye un parmetro -FILTER que explora los primeros 4 caracteres de esas dos filas de datos. Nota: Slo se especifican los primeros 4 caracteres ya que el atributo DriveLetter tiene un tamao mximo de 4. Consulte Filtrado de atributos en la pgina 181 para obtener informacin adicional acerca del parmetro FILTER.
73
donde: NombreHostLocal Host donde se ejecuta el proveedor de datos de SNMP. NombreAplic Valor del nombre especificado en la sentencia //APPL del metarchivo. Consulte Sentencia APPL en la pgina 131 para obtener ms informacin. VV Sufijo de dos dgitos de la versin. Consulte Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent en la pgina 27.
IBM Tivoli Universal Agent: Gua del usuario
74
Por ejemplo, para la aplicacin de metarchivo MIB-2, el nombre de sistema gestionado correspondiente es NombreHostLocal>:MIB-200. Nota: Si se utiliza una aplicacin de metarchivo para recopilar los mismos datos de MIB de varios agentes SNMP que se ejecutan en diferentes hosts, sigue habiendo slo un sistema gestionado para representar dicha aplicacin. Los datos MIB recopilados de cada host se listan como una fila de datos separados en un espacio de trabajo comn, en el que el nombre de host del agente sirve de atributo KEY. Cuando se inicia el proveedor de datos de SNMP, tambin hay una aplicacin especial denominada SNMP-MANAGER que se coloca inmediatamente en lnea con el siguiente nombre de sistema gestionado:
NombreHostLocal:SNMP-MANAGER00
SNMP-MANAGER es una aplicacin generada internamente que siempre est en la versin 00. Varios espacios de trabajo del proveedor de datos de SNMP, como por ejemplo, TRAP y MIBSTATUTS son accesibles debajo del sistema gestionado NombreHostLocal:SNMP-MANAGER00 en Tivoli Enterprise Portal Navigator. Los espacios de trabajo de SNMP-MANAGER se describen en Espacios de trabajo de la aplicacin SNMP-MANAGER en la pgina 84. Hay dos excepciones en el formato de nomenclatura del sistema gestionado para las aplicaciones del proveedor de datos de SNMP, en especfico para los espacios de trabajo MANAGED-NODES (tambin conocido como listas de favoritos) y NETWORK, en los que la parte NombreHostLocal se sustituye por NombreListaFavoritos y NombreRed, respectivamente. La tabla 11 resume los formatos de todos los sistemas gestionados del proveedor de datos de SNMP. La Tabla 12 resume los formatos de los sistemas gestionados.
Tabla 12. Formatos de nombres de sistemas gestionados Nombre de sistema gestionado NombreHostLocal:SNMP-MANAGER00 NombreListaFavoritos:SNMP-MANAGER00 NombreRed:SNMP-MANAGER00 NombreHostLocal:NombreAplicMIBVV Utilizado para ver... Espacios de trabajo NETSUMMARY, ROUTER, TRAP, MIBSTATUS y MIBNODATA Espacios de trabajo MANAGED-NODES Espacios de trabajo NETWORK Una aplicacin MIB en particular
Se utilizan los mismos nombres de sistemas gestionados cuando se distribuye una situacin. Por ejemplo, si crea una situacin que incluye atributos del grupo MANAGED-NODES, debe distribuirlo a HotListName:SNMP-MANAGER00. Si crea una situacin que incluye atributos del grupo NETWORK, debe distribuirla a NombreRed:SNMP-MANAGER00.
75
76
v Si no se especifica ningn nombre en el campo & o el archivo KUMSCOMM, el proveedor de datos utiliza el valor predeterminado especificado por KUMP_SNMP_NET_COMMUNITY. v Si no se especifica un valor predeterminado, se utilizar el valor pblico predeterminado.
Especifique el nombre de comunidad exactamente como se ha asignado ya que es sensible a maysculas y minsculas.
Por ejemplo:
alpha tiger beta.tivoli.com osprey 10.10.32.1 yellowtail
El proveedor de datos de SNMP lee la tabla de nombres de comunidad durante el arranque. Pero puede aadir, cambiar o suprimir entradas en cualquier momento, y activar la tabla utilizando el mandato de consola LOADCOMM:
kumpcon loadcomm
Tenga en cuenta los siguientes convenios cuando cree la lista de nombres simblicos: v El cero final de la direccin de red es opcional v El nombre de red simblico debe ser exclusivo v Los nombres slo pueden contened caracteres alfanumricos, guiones y subrayados.
77
Aplicacin SNMP-MANAGER
La aplicacin SNMP-MANAGER se compone de los siguientes siete grupos de atributos: v MANAGED-NODES v MIBNODATA v MIBSTATUS v NETSUMMARY v NETWORK v ROUTER v TRAP Los atributos de dichos grupos se describen en el Apndice C, Atributos de SNMP, en la pgina 191. Los espacios de trabajo basado en estos grupos se describen en Espacios de trabajo de la aplicacin SNMP-MANAGER en la pgina 84.
78
3. Los agentes de SNMP deben estar configurados para enviar las condiciones de excepcin al host donde se ejecuta el proveedor de datos de SNMP. Las condiciones de excepcin recibidas se visualizan en el espacio de trabajo TRAP debajo del sistema gestionado NombreHostLocal:SNMP-MANAGER00 en Tivoli Enterprise Portal Navigator. Para poderse ver correctamente, las condiciones de excepcin recibidas deben estar definidas en el archivo trapcnfg. Como mejora aadida de legibilidad, si ha importado un metarchivo SNMP que define las variables de condicin de excepcin individuales, la columna Value_List en el espacio de trabajo TRAP muestra los nombres de variables de condicin de excepcin en lugar de los valores OIS asociados. Para obtener ms informacin sobre cmo definir variables de condicin de excepcin en metarchivos SNMP, consulte Metarchivos SNMP slo de condicin de excepcin en la pgina 34 debajo de Aplicaciones SNMP de Tivoli Universal Agent en la pgina 32.
79
//SNMP TEXT //APPL TRAPRCV @SNMP application for processing traps //NAME TRAPTABLE K 3600 //SOURCE TRAP //ATTRIBUTES ; Time_Stamp T 16 Object_ID D 64 Generic_Trap C 999999 Specific_Trap C 999999 Source_Name D 64 Source_Type D 32 Source_Status D 32 Enterprise_Name D 64 Alert_Name D 64 Category D 32 Severity D 32 Description D 256 Value_List Z 1024 @Varbind data
En el siguiente ejemplo de metarchivo, el primer grupo de atributos se utiliza para recopilar datos MIB. El segundo grupo de atributos recibe condiciones de excepcin redirigidas de la tabla SNMP-MANAGER TRAP. Las definiciones de atributo estn pensadas para procesar condiciones de excepcin de IBM Tivoli Monitoring, en el sentido de que determinados atributos estn ocultos y otros se analizan utilizando delimitadores especficos de los atributos:
//SNMP TEXT //APPL CUSTOM mib-2 1.3.6.1.2.1 //NAME SYSTEM K 3600 //ATTRIBUTES Agent_Info D 128 0.0 Agent_Name D 64 KEY 0.0 sysDescr D 255 1.3.6.1.2.1.1.1.0 sysObjectID D 1024 1.3.6.1.2.1.1.2.0 sysUpTime C 999999 1.3.6.1.2.1.1.3.0 sysContact N 255 1.3.6.1.2.1.1.4.0 sysName N 255 1.3.6.1.2.1.1.5.0 sysLocation D 255 1.3.6.1.2.1.1.6.0 sysServices C 127 1.3.6.1.2.1.1.7.0 * //NAME ITM_TRAPS K 3600 //SOURCE TRAP //ATTRIBUTES ; -Time_Stamp T 16 -Object_ID D 64 -Generic_Trap C 999999 -Specific_Trap C 999999 Source_Name D 64 -Source_Type D 32 -Source_Status D 32 Enterprise_Name D 64 Alert_Name D 64 -Cat D 32 -Sev D 32 -Description D 256 Situation_Name D 32 DLMSTRBGN={sitName= DLMSTREND=} Origin_Node D 32 DLMSTRBGN={sitCurrStat-OriginNode= DLMSTREND=} LocalTimeStamp T 16 DLMSTRBGN={sitCurrStat-LocalTimeStamp= DLMSTREND=} Severity C 999999 DLMSTRBGN={sitCurrStat-Severity= DLMSTREND=} Category C 999999 DLMSTRBGN={sitCategory= DLMSTREND=} Attributes D 256 DLMSTRBGN={sitAttributeList= DLMSTREND=}
80
de la aplicacin y cada una de las columnas en el espacio de trabajo se corresponde con un atributo en dicho grupo. Consulte Aplicaciones SNMP de Tivoli Universal Agent en la pgina 32 para obtener ms informacin acerca de las aplicaciones SNMP. Puede utilizar los atributos definidos en cada aplicacin MIB de SNMP para crear situaciones que alerten acerca de los problemas con los dispositivos supervisados. Consulte Creacin de situaciones con atributos de aplicaciones SNMP en la pgina 94 para obtener detalles especficos de la creacin de situacin que desea utilizar con el proveedor de datos de SNMP.
Como puede verse en este ejemplo, con una solicitud de Actuacin es posible especificar una serie de agentes SNMP para realizar consultas; puede utilizar combinaciones de nombres de host, direcciones IP y nombres de comunidad. Si desea sondear un agente utilizando un puerto distinto de 161, el puerto de recopilacin de datos MIB predeterminado, indique el puerto de destino delimitado entre llaves inmediatamente despus del nombre de host o de la direccin decimal separada por puntos. Si va a recopilar datos MIB desde un agente de SNMP que se ejecuta dentro de un entorno en clster, y la direccin del agente de respuesta tal vez no sea necesariamente la misma direccin que la que el mandato Get de SNMP tena prevista, suministre una serie de direcciones alternativas delimitadas por barras verticales despus de la direccin del agente primario. Por ejemplo, puede entrar el siguiente parmetro:
10.1.1.1(10.1.1.2 | 10.1.1.3)
Este parmetro significa que 10.1.1.1 es el agente de destino primario de la solicitud de recopilacin de datos MIB, pero el proveedor de datos de SNMP tambin acepta respuestas de 10.1.1.2 y 10.1.1.3. Si no hubiera configurado estas direcciones alternativas, se omiten los datos MIB recibidos de 10.1.1.2 o 10.1.1.3 como respuestas no vlidas de hosts desconocidos. Consejo: Para recopilar datos para todos los agentes SNMP dentro de una red determinada, especifique la parte de red de la direccin IP en lugar de la direccin de host. Por
Captulo 4. Acerca de los proveedores de datos
81
ejemplo, si la red es una red de clase C y especifica 198.210.57, el proveedor de datos inicia la recopilacin de datos de todos los agentes SNMP correspondientes en los host en la red 198.210.57. Si ha especificado un nombre simblico para la red, puede utilizar dicho nombre. Consulte Asignacin de nombres de red simblicos en la pgina 77 para obtener ms informacin. Para utilizar esta forma de especificacin, el proveedor de datos debe haber descubierto ya la red. La direccin de red se ignorar si no se ha descubierto o no ha desactivado el descubrimiento de red (KUMP_SNMP_NET_DISCOVERY=NO). v Para Intervalo, especifique el intervalo de muestreo, en segundos, en el que desea que el proveedor de datos de SNMP sondee el agente SNMP. v Para attrGroup (opcional), especifique el nombre del grupo de atributos en la aplicacin de metarchivo para la que desea recopilar datos. Si no especifica un grupo de atributos en particular, la recopilacin tiene lugar para todos los grupos de atributos en la aplicacin MIB seleccionada. 6. Pulse en Aceptar. 7. Para Sistemas de destino, seleccione el nombre de sistema gestionado que corresponde a la aplicacin de metarchivo SNMP cuyos datos desea recopilar, y a continuacin, pulse Aceptar. Por ejemplo, si ha importado el metarchivo MIB-2, RFC1213_mib-2.mdl, dispone de un sistema gestionado en lnea denominado NombreHostLocal:MIB-200. Si desea empezar a recopilar datos MIB-2 desde un agente SNMP y ha cumplimentado la informacin de Interval y attrGroup apropiada, seleccione NombreHostLocal:MIB-200 en el recuadro de dilogo Sistemas de destino. Cuando haya iniciado la recopilacin de datos MIB, no ser necesario iniciarla de nuevo cada vez que inicie el proveedor de datos de SNMP. El proveedor de datos mantiene la informacin acerca de los agentes SNMP supervisados en el archivo de configuracin KUMSMIBI para que la recopilacin de datos perdure durante los reinicios. El archivo KUMSMIBI se encuentra en el directorio de trabajo de Tivoli Universal Agent. Puede examinar el espacio de trabajo MIBSTATUS, accesible desde el sistema gestionado NombreHostLocal:SNMP-MANAGER00, en cualquier momento para ver una lista de aplicaciones y grupos de atributos SNMP cuyos datos se estn recopilando en un host determinado. Comprobacin del estado de un mandato Monitor Start: Tras emitir un mandato Actuacin > Monitor Start, si no empieza a ver los datos MIB visualizados en el espacio de trabajo de la aplicacin, hay varios lugares que se comprueban para determinar si el mandato se ha ejecutado o no correctamente: 1. El espacio de trabajo UAGENT ACTION contiene un mensaje de estado para cada mandato de Actuacin que se ha emitido en los ltimos 30 minutos. 2. El espacio de trabajo UAGENT DPLOG contiene un mensaje KUMPL110I para cada solicitud Monitor Start que el proveedor de datos de SNMP ha recibido. 3. El espacio de trabajo MIBSTATUS contiene una fila de datos para cada grupo de atributos en un metarchivo SNMP, incluidos los nombres de host del agente de SNMP que se sondean y la informacin de estatus del ltimo intervalo de muestreo. 4. Similar a MIBSTATUS, el archivo KUMSMIBI contiene un registro para cada grupo de atributos de metarchivo SNMP, incluidos los nombres de host del agente de SNMP en el intervalo de muestreo. 5. El registro RAS1 de Universal Agent contiene uno o ms mensajes de error si el mandato Monitor Start ha encontrado un error de algn tipo. Para detener la recopilacin de datos, debe emitir un mandato Actuacin > Monitor Stop. Detencin de la recopilacin de datos: 1. Seleccione el elemento de Navigator asociado con la aplicacin SNMP en la que desea iniciar el mandato. 2. Pulse con el botn derecho del ratn en el elemento de Navigator. 3. Seleccione Actuacin en el men desplegable. 4. Seleccione Monitor Stop en la lista Nombre.
82
Aparecer la ventana Editar valores de argumentos. 5. En la ventana Editar valores de argumentos: v Para el valor AgentData, escriba una lista separada por comas de los nombres de host o de direcciones IP de los agentes SNMP para los que desea detener la recopilacin de datos. Por ejemplo,
Mars, Venus, Jupiter, Pluto
v Si desea detener el sondeo de un agente utilizando un puerto distinto del 161, el puerto predeterminado, indique el puerto de destino entre llaves inmediatamente a continuacin del nombre de host o de la direccin decimal separada por puntos. Consejo: Para detener la recopilacin de datos de todos los agentes SNMP en una red determinada, puede especificar la parte de red de la direccin IP en lugar de la direccin del host. Por ejemplo, si la red es una red de clase C y se especifica 198.210.57, el proveedor de datos de SNMP detiene la recopilacin de datos de todos los agentes SNMP correspondientes en la red 198.210.57. Si ha especificado un nombre simblico para la red, puede utilizar dicho nombre. Consulte Asignacin de nombres de red simblicos en la pgina 77 para obtener ms informacin. v Para attrGroup (opcional), especifique el nombre del grupo de atributos para el que desea detener la recopilacin de datos. Si no especifica un grupo de atributos determinado, se detendr la recopilacin de todos los grupos de atributos en la aplicacin MIB seleccionada. 6. Pulse en Aceptar. 7. Para Sistemas de destino, seleccione el nombre de sistema gestionado que corresponde a la aplicacin de metarchivo SNMP para la que desea detener la supervisin, y a continuacin, pulse Aceptar. Comprobacin del estado de un mandato Monitor Stop: Para determinar el estado de un mandato Actuacin --> Monitor Stop, hay varios lugares que hay que comprobar: 1. El espacio de trabajo UAGENT ACTION contiene un mensaje de estado para cada mandato de Actuacin que se ha emitido en los ltimos 30 minutos. 2. El espacio de trabajo UAGENT DPLOG contiene un mensaje KUMPL111I para cada solicitud Monitor Stop que el proveedor de datos de SNMP ha recibido. 3. El espacio de trabajo MIBSTATUS contiene una fila de datos para cada grupo de atributos en un metarchivo SNMP, incluidos los nombres de host del agente de SNMP que se sondean y la informacin de estatus del ltimo intervalo de muestreo. El nombre de host de un agente de SNMP que era el destino de un mandato Monitor Stop se elimina del espacio de trabajo MIBSTATUS. 4. Similar a MIBSTATUS, el archivo KUMSMIBI contiene un registro para cada grupo de atributos de metarchivo SNMP, incluidos los nombres de host del agente de SNMP en el intervalo de muestreo. El nombre de host de los agentes de SNMP detenidos se elimina del archivo. 5. El registro RAS1 de Universal Agent contiene uno o ms mensajes de error si el mandato Monitor Stop ha encontrado un error. Recopilacin de datos MIB SNMP desde puertos no estndares: Determinados agentes de proveedores de SNMP de terceros pueden presentar requisitos especiales, como utilizar otros puertos distintos del puerto de supervisin predeterminado 161. Puede especificar asignaciones de puertos alternativas mediante los valores de puerto delimitados por corchetes para tener como destino un agente de SNMP en un puerto no estndar. Por ejemplo, para indicar que el proveedor de datos de SNMP deber sondear un agente en el puerto 333 de un host llamado, especifique:
goby[333]
en el campo de la ventana Monitor Start. La especificacin de puerto delimitada por corchetes tambin funciona en el campo de la ventana Actuacin de Monitor Stop, as como en el campo TargetAgentAddr de la ventana SNMP Set.
Captulo 4. Acerca de los proveedores de datos
83
Recopilacin automtica de datos MIB de recursos de red descubiertos: A medida que se descubren recursos de red y se aaden a una lista de nodos gestionados, el gestor SNMP de Tivoli Universal Agent Manager puede iniciar automticamente la recopilacin de datos de los MIB correspondientes. Deber satisfacer las siguientes condiciones para permitir la recopilacin automtica de MIB. La recopilacin automtica de MIB se aplica a los recursos en la lista de nodos gestionados. Puede aadir manualmente dichos recursos a la lista o que se aadan automticamente durante el proceso de descubrimiento de Tivoli Universal Agent. Deber precargar los MIB de proveedores correspondientes. Los metarchivos MIB, de proveedores o RFC estndares, se cargan para recopilar datos. Incluya nicamente los metarchivos MIB necesarios en el archivo de inicializacin de Tivoli Universal Agent KUMPCNFG para controlar la cantidad de recopilacin de datos. Variables de entorno de recopilacin de datos MIB: La variable de entorno KUMP_SNMP_AUTOSTART_MIB_COLLECTION controla la recopilacin automtica de datos MIB. El valor predeterminado es Yes. Cuando se aade un recurso de red o se activa desde la lista de nodos gestionados, el gestor SNMP recupera primero la identidad del recurso y determina el OID empresarial del fabricante. Tivoli Universal Agent comprueba entonces todos los metarchivos MIB cargados que pertenezcan al rbol OID empresarial del proveedor. Las recopilaciones de datos se inician automticamente en este nodo para todos los grupos de atributos de todos los metarchivos MIB correspondientes. Variables de entorno de recopilacin de datos MIB-2: Todos los agentes SNMP soportan los atributos RFC 1213 MIB-2. Por lo tanto, es posible recopilar dichos atributos para todos los agentes independientemente de su OID empresarial. Puede controlar la recopilacin automtica de datos MIB-2 estableciendo la variable de entorno KUMP_SNMP_AUTOSTART_COLLECTION_MIB2. El valor predeterminado es No, que quiere decir que no se recopilarn de forma automtica los datos de ningn agente MIB-2.
84
El elemento del espacio de trabajo de SNMP-MANAGER se visualiza a continuacin del elemento SNMP-MANAGER. 2. Seleccione el elemento representando el espacio de trabajo que desea visualizar. Aparecer el espacio de trabajo predeterminado. Espacio de trabajo MANAGED-NODES: Este espacio de trabajo contiene informacin acerca de los nodos identificados en la lista de favoritos, tal y como se especifica en el archivo de configuracin KUMSLIST. Permite supervisar informacin acerca de los nodos identificados en la lista de nodos gestionados. Los datos recopilados para un espacio de trabajo MANAGED-NODES slo se muestran en los sistemas gestionados con el siguiente formato: NombreListaFavoritos:SNMP-MANAGER00. Consulte la Tabla 12 en la pgina 75 para obtener ms informacin acerca de los formatos de nombres de sistemas gestionados.
Tabla 13. Columnas del espacio de trabajo MANAGED-NODES Columna Direccin Tiempo respuesta actual ms Nombre Descripcin La direccin IP del host del nodo gestionado. El tiempo de respuesta actual de la red para solicitudes SNMP o ICMP para el nodo gestionado tal como lo ve SNMP-MANAGER. El nombre de host del nodo gestionado. Si no es posible resolver la direccin del nodo mediante DNS, se mostrar la direccin IP decimal separada por puntos. La descripcin de las caractersticas del nodo como estn definidas por un administrador de red o por el fabricante del dispositivo. Observe que esta informacin slo se visualiza si el dispositivo est habilitado para SNMP y responde a un mandato SNMP Get para la variable RFC 1213 System Group sysDescr MIB. De lo contrario, la Descripcin de nodo se lista como No disponible. El estado operativo actual del nodo gestionado. El tipo de nodo gestionado. Por ejemplo, nodo IP general, host de aplicaciones o pasarela. Observe que esta informacin slo se visualiza si el dispositivo est habilitado para SNMP y responde a un mandato SNMP Get para la variable RFC 1213 System Group sysServices MIB. De lo contrario, el tipo de nodo aparece listado como Desconocido si el dispositivo est fuera de lnea e IP Node si el dispositivo est en lnea. La fecha y hora en que se comprob el estatus del nodo por ltima vez.
Descripcin de nodo
Espacio de trabajo MIBNODATA: Este espacio de trabajo identifica las tablas MIB para las que los agentes de supervisin no devuelven datos. Si un espacio de trabajo est consistentemente vaco para un grupo de atributos determinado en uno de los metarchivos MIB SNMP, puede comprobar el espacio de trabajo MIBNODATA para ver si es normal y esperado que el grupo de atributos en cuestin no devuelva datos.
Tabla 14. Columnas del espacio de trabajo MIBNODATA Columna Nombre de agente Mdulo empresarial Tablas sin datos Descripcin El nombre o direccin del agente de supervisin. El nombre de empresa de la MIB de recopilacin de datos. Una lista de tablas de empresa para las que el agente SNMP no devuelve datos.
85
Espacio de trabajo MIBSTATUS: Este espacio de trabajo permite averiguar en cualquier momento para qu MIB SMNP y grupos de atributos se estn recopilando datos y desde qu agentes SNMP. Tambin muestra el intervalo de supervisin activo en la actualidad y la ltima vez que se ha recopilado la muestra de datos. Cuando ejecute un mandato como Actuacin Monitor Start o Actuacin Monitor Stop, se actualizar la informacin de este espacio de trabajo.
Tabla 15. Columnas del espacio de trabajo MIBSTATUS Columna Grupo de atributos Empresa Info del agente de supervisin Intervalo de supervisin Indicacin de la hora de la ltima muestra Descripcin Nombre del grupo de atributos para el que se estn recopilando datos. El nombre de empresa de la base MIB en la que se basa la aplicacin supervisada. Una lista de nodos de agentes SNMP de destino y su correspondiente nombre de comunidad SNMP. El intervalo de recopilacin de datos actualmente activo. Es el intervalo ms corto de todas las solicitudes de recopilacin de datos pendientes. La indicacin de la hora del conjunto de datos de atributos de MIB actualmente disponibles.
Espacio de trabajo NETSUMMARY: El espacio de trabajo NETSUMMARY proporciona informacin de alto nivel acerca de las redes en la empresa, como el nmero de nodos activos e inactivos. La Tabla 16 lista las columnas en el espacio de trabajo y sus descripciones.
Tabla 16. Columnas del espacio de trabajo NETSUMMARY Columna Nodos activos Tiempo de respuesta actual en ms Descripcin El nmero total de nodos de red activos en la actualidad. El tiempo de respuesta actual de red para solicitudes SNMP o ICMP, tal como lo ve SNMP-MANAGER, en milisegundos. Si la variable de entorno est establecida en KUMP_SNMP_NET_DISCOVER_ENTERPRISE No, se visualiza un 0 en esta columna. El nmero total de nodos de esta red que estn actualmente inactivos. Si la variable de entorno est establecida en KUMP_SNMP_NET_DISCOVER_ENTERPRISE No, se visualiza un 0 en esta columna. Indica si los nodos en la red se estn gestionando o no de forma activa. Compruebe el espacio de trabajo NETWORK para ver los detalles acerca de la red gestionada. El tiempo de respuesta de red mximo para todas las solicitudes SNMP o ICMP, tal como lo ve SNMP-MANAGER, en milisegundos. Si la variable de entorno est establecida en KUMP_SNMP_NET_DISCOVER_ENTERPRISE No, se visualiza un 0 en esta columna. El tiempo de respuesta de red mnimo para todas las solicitudes SNMP o ICMP, tal como lo ve SNMP-MANAGER, en milisegundos. Si la variable de entorno est establecida en KUMP_SNMP_NET_DISCOVER_ENTERPRISE No, se visualiza un 0 en esta columna. La direccin de la red descubierta. La mscara de red de la red descubierta.
Nodos inactivos
Gestionado
Tiempo de respuesta mx en ms
Tiempo de respuesta mn en ms
86
Tabla 16. Columnas del espacio de trabajo NETSUMMARY (continuacin) Columna Direccionadores de red Descripcin Una lista de los direccionadores conectados a esta red.
Espacio de trabajo NETWORK: El espacio de trabajo NETWORK presenta informacin detallada acerca de las redes individuales en la empresa. De forma predeterminada, slo se descubre y gestiona de forma inicial la red local, donde se est ejecutando el proveedor de datos de SNMP. Puede inhabilitar el valor predeterminado estableciendo KUMP_SNMP_MANAGE_LOCAL_NETWORK=N en el archivo de variables de entorno de Tivoli Universal Agent. Para descubrir y gestionar otras redes en la empresa, debe iniciar el descubrimiento de red tal y como se explica en Descubrimiento de red en la pgina 89. Los nombres de sistemas gestionados tienen el siguiente formato si se define el nombre de red en el archivo de configuracin KUMSNAME:
direccin_ip:SNMP-MANAGER00
o bien
nombrered:SNMP-MANAGER00
Cuando se selecciona un sistema gestionado, el espacio de trabajo detallado que puede ver contiene la informacin especfica de dicha red. La Tabla 17 lista las columnas en el espacio de trabajo NETWORK y sus descripciones.
Tabla 17. Columnas del espacio de trabajo NETWORK Columna Direccin Descripcin Descripciones La direccin de red de Internet de un nodo dentro de una red gestionada. La descripcin de las caractersticas del nodo como estn definidas por un administrador de red o por el fabricante del dispositivo. El valor de este atributo corresponde a la especificacin de la variable MIB sysDescr de RFC 1213 System Group. La informacin de ubicacin del nodo como est definida por un administrador de red. El valor de este atributo corresponde a la especificacin de la variable MIB sysLocation de RFC 1213 System Group. El nombre de host del nodo de red. Si la direccin de un direccionador no se puede resolver mediante DNS, se muestra la direccin IP en formato decimal con puntos. Indica si hay o no un agente de SNMP activo en este nodo de red. El estatus operativo actual del nodo de red. Los estatus posibles se muestran en la tabla siguiente: On-line Inactive Tipo Se ha establecido contacto con el nodo y est operativo. El nodo no est operativo y no responde a las solicitudes de SNMP Get o ping.
Ubicacin
Nombre
El tipo de nodo de red, tal como est definido en la especificacin de la variable MIB sysServices de RFC 1213 System Group estndar de Internet.
87
Espacio de trabajo ROUTER: El espacio de trabajo ROUTER contiene informacin pertinente a los direccionadores en las redes descubiertas, como su estatus actual y el nmero de subredes definidas en el direccionador. La Tabla 18 lista las columnas en el espacio de trabajo ROUTER y sus descripciones.
Tabla 18. Columnas del espacio de trabajo ROUTER Columna Redes de destino Recuento de rutas Direccin de direccionador Descripcin del direccionador Descripcin Una lista de direcciones de red conocidas en este direccionador. El nmero total de subredes direccionadas definidas en este direccionador. La direccin IP del direccionador descubierto. Una descripcin de las caractersticas del direccionador, tal como las ha definido el fabricante del dispositivo. Este valor corresponde a la especificacin de variable MIB sysDescr de RFC 1213 System Group. El nombre de host del direccionador descubierto. Si la direccin de un direccionador no se puede resolver mediante DNS, se muestra la direccin IP en formato decimal con puntos. El estado actual del direccionador descubierto. Los estatus posibles son: Verify On-line Off-line Passive El proveedor de datos de SNMP est en proceso de verificar el estatus del direccionador. El direccionador est activo y operativo El direccionador no est operativo El direccionador es un daemon y no est participando activamente en el funcionamiento de la red
Nombre de direccionador
Estatus de direccionador
Espacio de trabajo TRAP: El espacio de trabajo TRAP contiene informacin acerca de las condiciones de excepcin de SNMP de las que se han informado al proveedor de datos de SNMP. Es necesario configurar los agentes SNMP para que enven las condiciones de excepcin al nombre de host donde se est ejecutando el proveedor de datos de SNMP para recibir datos en este espacio de trabajo. El proveedor de datos de SNMP utiliza un archivo de configuracin llamado trapcnfg para representar informacin de condiciones de excepcin en un formato de sencilla lectura y para asignar categoras, gravedades, estatus e ID de fuente a las condiciones de excepcin. Puede modificar este archivo o utilizar un archivo de configuracin distinto. Consulte el Apndice E, Configuracin de condiciones de excepcin de SNMP, en la pgina 229 para obtener ms informacin. La Tabla 19 lista las columnas en el espacio de trabajo TRAP. Si un Nombre de empresa, un nmero de Condicin de excepcin genrica y un nmero de Condicin de excepcin especfica de una condicin de excepcin recibida no se puede encontrar en el archivo trapcnfg, la mayor parte de los valores de columna en el espacio de trabajo TRAP aparecen listados como No disponible.
Tabla 19. Columnas del espacio de trabajo TRAP Columna Nombre de alerta Categora Descripcin El nombre de la condicin de excepcin, tal como est especificado en la definicin del archivo de configuracin de condiciones de excepcin. La categora de la condicin de excepcin, tal como est especificada en la definicin del archivo de configuracin de condiciones de excepcin.
88
Tabla 19. Columnas del espacio de trabajo TRAP (continuacin) Columna Descripcin Descripcin La descripcin de la condicin de excepcin especificada en el archivo de configuracin de condiciones de excepcin. La longitud mxima de la descripcin es de 256 caracteres. El nombre de empresa de la condicin de excepcin, tal como est especificado en el archivo de configuracin de condiciones de excepcin y tal como se busca mediante el identificador de objeto de la condicin de excepcin. El nmero de la condicin de excepcin genrica extrado de la condicin de excepcin recibida. Los valores posibles son: 0 1 2 3 4 5 ID de objeto ColdStart WarmStart LinkDown LinkUp Error de autentificacin EGPNeighborLoss
Nombre de empresa
El identificador de objeto SNMP que identifica de forma exclusiva la condicin de excepcin en la Base de informacin de gestin. El ID de objeto se extrae de la condicin de excepcin recibida. La gravedad de la condicin de excepcin, tal como est especificada en la definicin del archivo de configuracin de condiciones de excepcin. El nombre de host o direccin IP del agente de SNMP que ha enviado la condicin de excepcin. El estatus del agente que ha originado la condicin de excepcin despus de enviarla, tal como est especificado en la definicin de la condicin de excepcin en el archivo de configuracin de condiciones de excepcin. El tipo de agente que ha originado la condicin de excepcin, tal como est especificado en la definicin de la condicin de excepcin del archivo de configuracin de condiciones de excepcin.
Tipo fuente
Condicin de excepcin especfica El nmero de la condicin de excepcin especfica de la empresa extrado de la condicin de excepcin recibida. Slo se aplica cuando Generic_Trap = 6. Indicacin de la hora Lista de valores La fecha y la hora en que se ha producido una condicin de excepcin. El formato de la indicacin de la hora es, SAAMMDDHHMMSSmmm. Los datos de vinculacin de variable (VarBind) recibidos en la unidad de datos del protocolo de la condicin de excepcin (PDU). Los elementos VarBind se convierten a sus nombres de atributos de IBM Tivoli Monitoring si se ha cargado el metarchivo MIB correspondiente. En caso contrario, se mostrarn como ID de objeto.
Descubrimiento de red
Para iniciar el descubrimiento de redes distintas de la red local, utilice la opcin Actuacin, Manage Start. Despus de haber iniciado la supervisin de la red, no es necesario volver a iniciarla cada vez que inicie el proveedor de datos de SNMP. El proveedor de datos mantiene un estado persistente entre reinicios. Para detener la supervisin de la red, deber emitir un mandato Actuacin Manage Stop. Para excluir una red determinada del descubrimiento, utilice la opcin Actuacin Manage Exclude. Inicio del descubrimiento de red: 1. Seleccione el elemento de Navigator asociado con la aplicacin o sistema en el que desea iniciar el mandato. 2. Pulse con el botn derecho del ratn sobre el elemento de Navigator o una fila en la vista de tabla.
Captulo 4. Acerca de los proveedores de datos
89
3. Seleccione Actuacin en el men desplegable. 4. Seleccione Manage Start en la lista Nombre. Aparecer la ventana Editar valores de argumentos. 5. Escriba la direccin de red en el campo SNMP. 6. Escriba la frecuencia, en segundos, con la que desea que se actualicen los datos de la red. 7. Pulse en Aceptar. 8. Seleccione el nodo nombrehost:SNMP-MANAGER00, donde nombrehost es el nombre del host donde se est ejecutando el proveedor de datos de SNMP. 9. Pulse en Aceptar. Se recibir una notificacin de confirmacin del sistema gestionado con la direccin de red seleccionada. Despus de recibir la confirmacin, aparecer el indicador actualizacin de Navigator pendiente en Tivoli Enterprise Portal porque se ha insertado el nuevo sistema gestionado en la seccin Universal Agent de Navigator. Puede ver el nuevo nombre de sistema gestionado contrayendo y expandiendo el rbol de Navigator. El nombre de sistema gestionado incluye la direccin de red para la que se ha iniciado la recopilacin. Despus de abrir el espacio de trabajo NETWORK, ser posible ver los datos recopilados de los nodos en esa red. Si se ha especificado un nombre de red para la red, el nombre de sistema gestionado incluye dicho nombre en lugar de la direccin IP. Detencin del descubrimiento de red: Para finalizar la recopilacin de los datos de red, utilice la opcin Actuacin, Manage Stop. De forma predeterminada, la red local donde se est ejecutando Tivoli Universal Agent siempre se gestiona cuando el proveedor de datos de SNMP est activo. La gestin de la red puede detenerse de forma manual emitiendo el mandato Actuacin Manage Stop, pero deber emitirse despus de cada reinicios de Tivoli Universal Agent. Para inhabilitar de forma automtica la gestin de la red local, establezca la variable de entorno siguiente:
KUMP_SNMP_MANAGE_LOCAL_NETWORK=N
Nota: Si esta variable de entorno no est presente, la gestin de la red local ser el valor predeterminado. Para detener el descubrimiento: 1. Seleccione el elemento de Navigator asociado con la aplicacin o sistema en el que desea iniciar el mandato. 2. Pulse con el botn derecho del ratn sobre el elemento de Navigator o una fila en la vista de tabla. 3. Seleccione Actuacin en el men desplegable. 4. Seleccione Manage Stop en la lista Nombre. Aparecer la ventana Editar valores de argumentos. 5. Escriba la direccin de red en el campo SNMP. 6. Seleccione el nodo nombrehost:SNMP-MANAGER00, donde nombrehost es el nombre del host del proveedor o proveedores de datos que desea que recopilen los datos y, a continuacin, pulse Aceptar. Se recibir una notificacin de confirmacin del sistema gestionado con la direccin de red seleccionada. Exclusin de una red del descubrimiento: Puede excluir determinadas redes del descubrimiento, quizs porque son redes de respaldo o porque no desea cargarlas con consultas de descubrimiento de red. En este caso, utilice la opcin de Actuacin Manage Exclude para excluir una red determinada. Nota: Aquellas redes a las que se accede mediante interfaces de lneas serie de acceso telefnico como ppp o slip se excluyen de forma automtica. Si desea gestionar dichas redes, deber emitir de forma manual consultas Actuacin Monitor Start para las mismas. Cuando una red se est gestionando de manera activa, no se excluye.
90
Para excluir una red: 1. Seleccione el elemento de Navigator asociado con la aplicacin o sistema en el que desea iniciar el mandato. 2. Pulse con el botn derecho del ratn sobre el elemento de Navigator o una fila en la vista de tabla. 3. Seleccione Actuacin en el men desplegable. 4. Seleccione Manage Exclude de la lista Nombre. Aparecer la ventana Editar valores de argumentos. 5. Escriba la direccin de red en el campo SNMP. 6. En el campo S/No, escriba S para excluir la red seleccionada o No para restablecer una red una red anteriormente excluida. 7. En la lista Sistemas de destino, seleccione el sistema gestionado SNMP-MANAGER y, a continuacin, pulse Aceptar. Se recibir una notificacin de confirmacin del sistema gestionado con la direccin de red seleccionada. Si la red se est gestionando de manera activa en el momento de hacer esta solicitud, podr observar que este sistema gestionado pasa a estar fuera de lnea en el rbol de Navigator de Tivoli Enterprise Portal.
Definicin LISTNAME
91
El nombre de lista definido pasa a formar parte del nombre de sistema gestionado de la lista de nodos. Por ejemplo, el nombre de lista del ejemplo anterior es TivoliWeb:SNMP-MANAGER00. Si no se define ningn nombre de lista, se utilizar el nombre del archivo de lista de nodos gestionados. Un nombre de sistema gestionado no puede ser mayor de 32 caracteres por lo que si el nombre de la lista es mayor de 17 caracteres, se trunca por la derecha. Si aparece el nombre de lista, la definicin del nombre de lista deber tener el siguiente formato:
LISTNAME=nombrelista
La especificacin del nombre de lista no tiene que ser el primer registro de la definicin de la lista de nodos gestionados. No obstante, si se define el nombre de lista ms de una vez en la definicin, se utilizar la ltima especificacin como nombre de lista de nodos gestionados. Nombres de dispositivos y de host: No hay lmite en el nmero de dispositivos de red y de hosts que pueden incluirse en la lista de nodos gestionados. No obstante, si se incluyen demasiadas entradas, se contradice la idea de tener una lista de dispositivos crticos de destino y aumentar la carga de trabajo general. Pueden surgir dificultades a la hora de obtener un estatus en cada dispositivo en el intervalo de supervisin de 30 segundos. Es posible especificar uno o ms dispositivos de red en cada registro. Para supervisar slo una aplicacin en particular ejecutndose en un nodo de red, especifique el puerto de aplicacin rodeado de corchetes, como en el ejemplo anterior de mercury[4500]. Ubicacin del archivo de lista de nodos gestionados: Debe almacenar el archivo de lista de nodos gestionados en el directorio de trabajo de Tivoli Universal Agent. Activacin de una lista de nodos gestionados: Se activa una lista de nodos gestionados utilizando el mandato de consola LOADLIST:
kumpcon loadlist nombrearchivo_lista_nodos_gestionados
o con el mandato Actuacin Control LoadList. Tivoli Universal Agent realiza un seguimiento de las listas de nodos gestionados colocando sus nombres de archivos en un archivo llamado KUMSLIST. Durante el arranque, Tivoli Universal Agent lee KUMSLIST y activa todas las listas en el mismo, por lo que slo es necesario activar cada lista una vez. Modificacin de una lista de nodos gestionados: Para modificar una lista de nodos gestionados, edtela y, a continuacin, actvela utilizando el mandato LOADLIST. El mandato comprueba si ya est activa una lista con el mismo nombre. Si es as, se desactiva la lista en ejecucin y se activa la nueva lista. Desactivacin de una lista de nodos gestionados: Es posible desactivar una lista de nodos gestionados editando el archivo KUMSLIST, que se encuentra en el directorio de trabajo. El proveedor de datos de SNMP comprueba KUMSLIST slo durante el arranque. Para desactivar una lista de nodos gestionados dinmicamente, cree un archivo que tenga el mismo nombre de lista pero que no contenga nombres de dispositivos y cargue dicho archivo con el mandato LOADLIST. Agrupamiento automtico de recursos mediante criterios: Para facilitar la creacin y mantenimiento de las listas de recursos de red, la aplicacin de Tivoli Universal Agent SNMP-MANAGER permite gestionar los recursos de red mediante ciertos criterios, como una funcin comercial determinada y sus recursos correspondientes. Por ejemplo, una lista de nodo gestionado podra contener las identidades de todos los recursos de red que pertenecen a un departamento, un sistema de aplicacin financiera, una ubicacin geogrfica o un grupo de servidores de red que soporten las operaciones comerciales. Puede haber tantas listas de nodos gestionados definidas como sean necesarias para gestionar la red de forma eficiente.
92
En el archivo de lista de nodos gestionados, en lugar de entrar una lista con elementos de recursos de red, puede definir un filtro de recursos. Slo puede utilizar un filtro de recursos por nada archivo de lista de nodos gestionados. Cuando se utiliza el filtro, Tivoli Universal Agent automticamente incluye los recursos de red descubiertos en la lista de nodos gestionados. Los siguientes filtros son vlidos: NAME [*]cadena[*] Filtra los nombres de recursos de red que coincidan o incluyan la cadena de caracteres definida. *cadena Cadena* *cadena* Coincide con los nombres que terminen con la cadena de caracteres. Coincide con los nombres que comiencen con la cadena de caracteres. Explora aquellos nombres que contengan la cadena de caracteres.
DESC cadena- Explora sysDescr MIB-2 del agente SNMP. TYPE tipo Busca recursos de red del tipo definido. Los tipos vlidos son: A Aplicaciones B Puentes G Pasarelas H Hosts R Direccionadores EOID cadena-oid Seleccione el recurso de red del OID empresarial definido en la respuesta de atributo sysObjectID MIB-2 del agente SNMP. Los siguientes cuatro ejemplos ilustran la utilizacin del filtrado de lista de nodos gestionados. v La lista de nodos gestionados de NetWare incluye todos los dispositivos en los que la respuesta del atributo sysDescr contiene Novell. LISTNAME=NetWare FILTER=(DESC Novell) v La lista de nodos gestionados NewYorkOffice incluye todos los nodos de red con un nombre de host que comience por NY. LISTNAME=NewYorkOffice FILTER=(NAME NY*l) v La lista de nodos gestionados NetCorporate contiene todos los direccionadores, puentes y pasarelas de red descubiertas. LISTNAME=NetCorporate FILTER=(TYPE RBG) v La lista de nodos gestionados CISCO contiene todos los direccionadores y conmutadores CISCO. LISTNAME=CISCO FILTER=(EOID 1.3.6.1.4.1.9.2) Siempre que una aplicacin SNMP-MANAGER descubre un nuevo dispositivo de red, comprueba todos los filtros activos de la lista de nodos gestionados. Un dispositivo que satisfaga un filtro se aade automticamente a la lista de nodos gestionados correspondiente. Ya que SNMP-MANAGER examina todos los filtros, podra aadirse un dispositivo descubierto a varias listas de nodos gestionados.
Captulo 4. Acerca de los proveedores de datos
93
Los recursos de red descubiertos y el contenido de la lista de nodos gestionados perduran entre los reinicios del proveedor de datos de SNMP de Tivoli Universal Agent. Puede utilizar el filtro de lista de nodos gestionados durante un corto periodo de tiempo para crear la lista de nombres de dispositivos de red coincidentes y, a continuacin, eliminar o comentar la definicin de filtro y utilizar la lista de nodos gestionados como tal. Puede manipular de forma manual el contenido de la lista de nodos gestionados con solicitudes de Actuacin. La solicitud de Actuacin MNL Add Node aade un recurso de red a la lista de nodos gestionados. La solicitud de Actuacin MNL Remove Node elimina un recurso de red de la lista. El gestor de SNMP realiza un seguimiento de los dispositivos eliminados. Durante el proceso de descubrimiento no se aadir de nuevo a la lista un recurso de red eliminado. No obstante, puede volver a aadir un recurso de red eliminado utilizando una solicitud de Actuacin MNL Add Node.
Inhabilitacin de los informes de la UMC: Para desactivar los informes de la UMC completamente, establezca la variable KUM_UMC en No:
KUM_UMC=No
94
Adems de ser un atributo KEY, Agent_Name es tambin un atributo ATOMIC. Puede definir Agent_Name como un Elemento de visualizacin en el Editor de situaciones, que le permite ver qu host de agente en particular ha provocado que se active la situacin. Consulte el Apndice B, Definiciones de atributos, en la pgina 169 para obtener una descripcin del atributo KEY. Distribucin de situaciones: Es posible distribuir situaciones a un sistema gestionado por un proveedor de datos de SNMP o a una lista de sistemas gestionados de SNMP. Por ejemplo, para cada aplicacin que se importe en el proveedor de datos de SNMP, se obtiene una lista de sistemas gestionados llamada *CUSTOM_aaavv, donde aaa es el nombre de la aplicacin y vv es el nmero de versin de la aplicacin. Utilice una lista de sistemas gestionados slo si est ejecutando ms de un proveedor de datos de SNMP y desea distribuir una situacin a todos ellos. Por razones de rendimiento, utilice nombres de sistemas gestionados especficos siempre que sea posible. Especificacin de intervalos de supervisin para situaciones: El intervalo de supervisin de situaciones especifica con qu frecuencia el servidor de Tivoli Enterprise Monitoring evala los datos de la situacin. No tiene relacin directa con el intervalo de muestreo que se especifica cuando se utiliza Actuacin Monitor Start. El intervalo de muestreo especifica con qu frecuencia debe el proveedor de datos de SNMP sondear los agentes SNMP en busca de datos MIB. Los datos muestreados de los agentes se ponen en cola para su posterior evaluacin por parte de las situaciones y sern los datos que vea en los espacios de trabajo de las aplicaciones MIB. Todos los grupos de atributos de aplicaciones SNMP tienen un tiempo de vida (TTL) De 3600 segundos (1 hora). Esto quiere decir que los datos MIB permanecen disponibles para la evaluacin de espacios de trabajo y situaciones durante una hora a partir de la hora en que fueron recibidos de los agentes SNMP. El intervalo de situacin debe ser menor de 1 hora o nunca se cumplir. Situaciones SNMP predefinidas: El proveedor de datos de SNMP ofrece un conjunto de situaciones predefinidas que responden a la mayora de las condiciones de excepcin comunes de redes. Puede utilizar dichas situaciones para comenzar la supervisin de forma casi inmediata o como plantillas para crear sus propias situaciones. La Tabla 20 en la pgina 95 proporciona los nombres, descripciones, lgica y valores de comparacin de las situaciones proporcionadas por el producto.
Tabla 20. Situaciones proporcionadas por el producto Nombre de la situacin MB2_interfaceDown Descripcin de la situacin, lgica y valores Una interfaz de red est inactiva MIB-2IFTABLE00.ifOperStatus *EQ 2 MB2_interfaceInError El nmero de paquetes de entrada que contenan errores, lo cual les impide que sean entregables a un protocolo superior, ha sido de 20 o ms, o bien el nmero de paquetes de entrada que se han elegido para su eliminacin, incluso sin detectarse errores, es de 100 o ms. MIB-2IFTABLE00.ifInErrors *GE 20 OR MIB-2IFTABLE00.ifInDiscards *GE 100 MB2_interfaceOutError El nmero de paquetes de salida que no ha podido transmitirse debido a errores es de 20 o ms o bien el nmero de paquetes de salida seleccionados para ser descartados es de 100 o ms MIB-2IFTABLE00.ifOutErrors *GE 20 OR MIB-2IFTABLE00.ifOutDiscards *GE 100
95
Tabla 20. Situaciones proporcionadas por el producto (continuacin) Nombre de la situacin MB2_ipInError Descripcin de la situacin, lgica y valores Esta situacin supervisa tres tipos de errores de datagramas IP de entrada: v El nmero de datagramas de entrada descartados debido a errores en sus cabeceras de IP es de 5 o ms. v El nmero de datagramas dirigidos localmente que se han recibido satisfactoriamente pero que se han descartado debido a un protocolo desconocido o no soportado es de 20 o ms. v El nmero de datagramas IP de entrada para los que no se han encontrado problemas que impidieran que continuara el proceso, pero que se han descartado, es de 20 o ms. MIB-2IP00.ipInHdrErrors *GE 5 OR MIB-2IP00.ipInUnknownProtos *GE 20 OR MIB-2IP00.ipInDiscards *GE 20 MB2_ipOutError El nmero de datagramas IP de salida para los que no se ha encontrado ningn problema que impidiera transmitirlos a su destino, pero se han descartado es de 20 o ms, o el nmero de datagramas IP descartados porque no se ha podido encontrar ninguna ruta para transmitirlos a su destino es de 20 o ms. MIB-2IP00.ipOutDiscards *GE 20 OR MIB-2IP00.ipOutNoRoutes *GE 20 MB2_ipFragmentationError El nmero de datagramas IP que se han eliminado porque se tenan que fragmentar en esta entidad pero no se ha podido es de 10 o ms. MIB-2IP00.ipFragFails *GE 10 MB2_icmpError El nmero de mensajes ICMP que la entidad ha recibido pero ha determinado que tengan errores especficos de ICMP es de 20 o ms o bien el nmero de mensajes ICMP que dicha entidad no ha enviado debido a problemas descubiertos dentro de ICMP (como la falta de almacenamientos intermedios) es de 20 o ms MIB-2ICMP00.icmpInErrors *GE 20 OR MIB-2ICMP00.icmpOutErrors *GE 20 MB2_tcpError El nmero total de segmentos recibidos con errores es de 10 o ms MIB-2TCPCONNTABLE00.tcpInErrs *GE 10 MB2_udpError El nmero de datagramas UDP recibidos que no se han podido distribuir por motivos que no son la falta de una aplicacin en el puerto de destino es de 10 o ms. MIB-2UDP00.udpInErrors *GE 10 MB2_egpError El nmero de mensajes EGP recibidos que se ha comprobado que son errneos es de 10 o ms, o cuando el nmero de mensajes EGP generados localmente que no se han enviado debido a limitaciones de recursos en una entidad EGP es de 10 o ms. MIB-2EGP00.egpInErrors *GE 10 OR MIB-2EGP00.egpOutErrors *GE 10 MB2_egpNeighError El nmero de mensajes de EGP recibidos desde este similar EGP que se ha probado que es errneo es de 10 o ms o bien el nmero de mensajes de EGP generados localmente no enviados a este similar EGP debido a limitaciones de recursos dentro de una entidad EGP es de 10 o ms MIB-2EGP00.egpNeighInErrs *GE 10 OR MIB-2EGP00.egpNeighOutErrs *GE 10
96
Tabla 20. Situaciones proporcionadas por el producto (continuacin) Nombre de la situacin MB2_snmpOperationViolations Descripcin de la situacin, lgica y valores El nmero total de Mensajes SNMP entregados a la entidad del protocolo SNMP que han utilizado un nombre de comunidad SNMP desconocido para dicha entidad ha superado los 10 o el nmero total de mensajes de SNMP entregados a la entidad del protocolo SNMP que representaba una operacin SNMP que no estaba permitida por la comunidad SNMP nombrada en el mensaje ha superado los 10 MIB-2SNMP00.snmpInBadCommunityNames *GE 10 OR MIB-2SNMP00.snmpInBadCommunityUses *GE 10 NETWORK_not_responding Una red no ha respondido durante una cantidad razonable de tiempo *VALUE SNMP-MANAGERNETSUMMARY00.Max_Resptime_ms *GT 500 Un direccionador est fuera de lnea ROUTER_status_offline *SCAN SNMP-MANAGERROUTER00.Router_Status *EQ Off-line Se ha recibido una condicin de excepcin de SNMP con la categora error *SCAN SNMP-MANAGERTRAP00.Category *EQ Error Events TRAP_severity_errors Se ha recibido una condicin de excepcin de SNMP con la gravedad error: *SCAN SNMP-MANAGERTRAP00.Severity *EQ Critical OR *SCAN SNMP-MANAGERTRAP00.Category *EQ Major Error HOTLIST_offline Un elemento de lista de nodos gestionados muestra el estado fuera de lnea *SCAN SNMP-MANAGERMANAGED-NODES00.Node_Status *EQ Off-line
TRAP_category_errors
97
ipForwarding OBJECT-TYPE SYNTAX INTEGER { forwarding (1), -- actuando como pasarela not-forwarding (2) -- NO actuando como pasarela } ACCESS read-write STATUS mandatory DESCRIPTION "La indicacin de si esta entidad est actuando como una pasarela IP con respecto al reenvo de datagramas recibidos por, pero no dirigidos a, esta entidad. Las pasarelas IP reenvan datagramas. Los hosts IP no (excepto aquellos indicados como destino mediante el host). Tenga en cuenta que para algunos nodos gestionados, este objeto slo puede tomar un subconjunto de los posibles valores. Por lo tanto, es apropiado que un agente devuelva una respuesta 'badValue' si una estacin de gestin intenta cambiar este objeto a un valor inapropiado." ::= {ip 1} Figura 11. Especificacin de acceso de escritura en la definicin de variable MIB-2
Realizar una operacin SET: 1. Seleccione el elemento de Navigator asociado con la aplicacin o sistema en el que desea iniciar el mandato. 2. Pulse con el botn derecho del ratn sobre el elemento de Navigator o una fila en la vista de tabla. 3. Seleccione Actuacin en el men desplegable. 4. Seleccione SNMP SET de la lista Nombre. Aparecer la ventana Editar valores de argumentos. 5. Rellene los campos como se muestra a continuacin: TargetAgentAddr El nombre o direccin del host del agente de SNMP cuya variable desea modificar. Si desea utilizar como destino un agente con un puerto distinto del 161, el puerto predeterminado, indique el puerto de destino entre corchetes inmediatamente despus del nombre de host o de la direccin decimal separada por puntos. Comunidad El nombre de comunidad que el agente acepta para las operaciones de escritura. Este nombres es generalmente distinto del nombre de comunidad utilizado para las operaciones de lectura. AttributeName El nombre del atributo que desea modificar. El valor de AttributeName es sensible a maysculas y minsculas y debe especificarse tal y como aparece en el metarchivo. SetToValue El nuevo valor del atributo. Consejo: Para determinar la ortografa exacta y las maysculas o minsculas del atributo, ejecute el mandato de consola KUMPCON VALIDATE en el metarchivo cifrado para crear un archivo de informe de salida. En el archivo de informes puede ver el nombre exacto utilizando por Tivoli Universal Agent para el atributo. 6. Pulse Aceptar para regresar a la ventana Actuacin. 7. Seleccione el sistema gestionado correspondiente a la aplicacin MIB en la que aparece la variable. Nota: Recuerde que siempre puede comprobar el espacio de trabajo UAGENT ACTION para obtener informacin detallada acerca de cualquier mandato de Actuacin que emita.
98
8. Pulse en Aceptar.
99
100
101
Nota: La mayora de los lenguajes de script, como REXX y Perl, ofrecen API de sockets para la recopilacin y envo de datos para, de esta manera, poder implementar el programa de envo en una amplia variedad de maneras, no slo en un lenguaje de alto nivel como C++ o Java.
donde: NombreHost El host donde el programa cliente de socket se est ejecutando. Este host es diferente de host donde se est ejecutando Tivoli Universal Agent si el cliente de socket est conectndose desde un sistema remoto. NombreAplic El nombre de valor especificado en la aplicacin de metarchivo. VV El sufijo de dos dgitos de la versin.
Nota: El sistema gestionado de una aplicacin de metarchivo de socket no pasa a estar en lnea en el Navigator de Tivoli Enterprise Portal hasta que el programa cliente de socket se haya conectado al proveedor de datos de socket. Puede personalizar la parte NombreHost del nombre de sistema gestionado con el parmetro NombreSistemaGestionado en la sentencia //SOURCE del metarchivo. Consulte Sentencia SOURCE en la pgina 140 para obtener ms informacin.
Funcin SETSOURCENAME
Tambin puede personalizar la parte NombreHost del nombre de sistema gestionado enviando un registro //SETSOURCENAME. Puede utilizar esta funcin si una aplicacin de socket recopila datos de una serie
102
de servidores de aplicacin y tiene ms sentido si el nombre del servidor de aplicacin formase parte del nombre del sistema gestionado y no del nombre de host en el que se est ejecutando el programa cliente. Los siguientes dos pasos son necesarios para habilitar la caracterstica SETSOURCENAME: 1. Aada un parmetro SETSOURCENAME=y en la sentencia de metarchivo //SOURCE SOCK. Este parmetro indica al PD de socket que puede esperar un registro //SETSOURCENAME durante el inicio de la conexin. 2. Enve un registro //SETSOURCENAME=xxxxxx al proveedor de datos de socket despus de que se conecte el programa cliente. El valor xxxxxx se utiliza cuando se registra el sistema gestionado. Por ejemplo, si enva un registro //SETSOURCENAME=AppServer1 al proveedor de datos de socket para la aplicacin de metarchivo ThreadMonitor, el siguiente sistema gestionado pasa a estar en lnea:
APPSERVER1:THREADMONITOR00
Nota: No puede listar varios nombres de host en la misma sentencia //SOURCE SOCK. Consulte Sentencia SOURCE en la pgina 140 para obtener informacin adicional acerca de la sentencia //SOURCE. Cuando un programa cliente se conecta y el proveedor de datos de socket ha determinado la direccin IP y el nmero de puerto del programa que se conecta, el proveedor de datos explora los valores de nombre de host de todas las sentencias //SOURCE SOCK del metarchivo que estn activados. La primera sentencia de nombre de host //SOURCE SOCK que coincida se considerar como el metarchivo correcto para asociar con el programa cliente. El parmetro de nombre de host de la sentencia //SOURCE SOCK indica el origen del programa remitente en formato de una direccin decimal separada por puntos o de nombre de host para resolver,
Captulo 4. Acerca de los proveedores de datos
103
seguido opcionalmente por un nmero de puerto. Por ejemplo, FIN1[4500] identifica datos procedentes del host FIN1 en el puerto 4500. No puede haber ningn espacio en blanco entre los parmetros de nombre de host y [nmero de puerto]. Nota: El parmetro [nmero de puerto] en la sentencia //SOURCE SOCK no debe confundirse con el nmero del puerto de escucha que el proveedor de datos de socket utiliza. De forma predeterminada, el proveedor de datos de socket escucha las conexiones cliente en el puerto 7500. Si el programa cliente de socket utiliza algn puerto en el sistema local y se conecta al proveedor de datos de socket en el puerto 7500 de un sistema remoto, no especifique, por ejemplo, //SOURCE SOCK HostA[7500] porque esto significa que el programa cliente de socket se est vinculando en el puerto 7500 en su propio sistema local, HostA, lo cual no es lo que desea. Por consiguiente, este intento de conexin falla porque el proveedor de datos de socket slo acepta una conexin cliente de socket del puerto 7500 en HostA. En este ejemplo, especifique //SOURCE SOCK HostA en el metarchivo y conecte el programa cliente al proveedor de datos de socket en el puerto 7500. Si el nombre de host especificado no puede resolverse en una direccin IP, se ignorar la sentencia SOURCE. Si se omite el nmero de puerto, los datos procedentes de cualquier puerto en dicho host sern aceptados. Especificando slo la direccin 198.210.37.147 se permite que un programa vinculado a cualquier puerto en el host 198.210.37.147 se conecte y enve datos al proveedor de datos de socket. Tambin puede especificar //SOURCE SOCK localhost como una manera de indicar que el programa cliente de socket se est ejecutando en el mismo sistema host que el proveedor de datos de socket.
Un programa cliente de socket del host JOHN o BOB puede conectarse y enviar datos. En este caso, no hay necesidad de especificar nmeros de puertos ya que no existe ambigedad alguna. No obstante, cuando el proveedor de datos de socket conoce varias aplicaciones de metarchivo de socket y es posible la entrada de datos desde varios programas clientes desde el mismo host, los nmeros de puertos ayudan a asociar los datos de entrada con determinadas aplicaciones, como se ilustra en el ejemplo a continuacin:
//APPL NCASYS //NAME Process P 300 //SOURCE SOCK ENG1[4500] //SOURCE SOCK ENG2[4500] //SOURCE SOCK MIS2[4500] //ATTRIBUTES '@' . . . //APPL NCANET //NAME ALERT E 300 //SOURCE SOCK ENG1[3301] //SOURCE SOCK ENG2[3301] //SOURCE SOCK ENG3[3301] //SOURCE SOCK TEST1[3301]
104
Un programa cliente de socket vinculado a un puerto 4500 en su sistema host local (ENG1, ENG2 o MIS2) que se conecta al proveedor de datos de socket se asocia automticamente con la aplicacin NCASYS. Del mismo modo, un programa cliente vinculado al puerto 3301 se asocia con la aplicacin NCANET. Si este ejemplo no utilizase especificaciones de nmero de puerto y un programa cliente vinculado a cualquier puerto en ENG2, por ejemplo, se conectase al proveedor de datos de socket, se seleccionara la aplicacin de metarchivo equivocada para los datos de entrada.
En este ejemplo, los datos de entrada del grupo de atributos, Overview, son aceptados desde cualquier puerto en el host JOHN o BOB como se muestra en el ejemplo anterior. Los datos de entrada el grupo de atributos RedEvent, no obstante, slo pueden ser recibidos desde un programa cliente que se conecte vinculado al puerto 1001 desde el JOHN o al puerto 2001 desde el host BOB. Del mismo modo, los datos de entrada del grupo de atributos RunStat pueden ser recibidos desde programas vinculados al puerto 1002 y 2002 en los hosts JOHN y BOB, respectivamente. Prefijado de registros de datos La desventaja de asociar grupos de atributos con nmeros especficos de puertos es que no es muy flexible y generalmente requiere planificacin y atencin. La alternativa es utilizar un prefijo auto-identificativo en cada registro de datos enviado al proveedor de datos de socket. El formato del prefijo es el siguiente:
<NombreAplic=xxxx><GrupoAtrib=yyyy>el resto de los datos...
Captulo 4. Acerca de los proveedores de datos
105
donde: xxxx yyyy El valor del nombre especificado en la sentencia //APPL del metarchivo. El valor del nombre especificado en la sentencia //NAME del metarchivo.
Si el proveedor de datos de SNMP recibe una fila que comienza con este encabezado, busca una aplicacin correspondiente y un grupo de atributos en su lista almacenada de aplicaciones en lnea. Si encuentra una coincidencia, el proveedor de datos de socket busca una sentencia //SOURCE SOCK bajo dicho grupo de atributos con un nombre de host que coincida con el nombre de host del programa cliente de socket. Nota: Es muy importante cuando se utiliza la funcin de prefijado del registro de datos que haya una sentencia //SOURCE SOCK &nombre de host para el host del programa cliente de socket remitente. De lo contrario, todos los datos entrantes se asocian con el primer grupo de atributos en el metarchivo. Si el proveedor de datos de socket encuentra una coincidencia en el nombre de aplicacin, el nombre de grupo de atributos y el nombre de host de conexin, el proveedor de datos de socket asocia la fila de datos recibidos con dicho grupo de atributos. Por lo tanto, no es necesario especificar un parmetro [puerto#] en la sentencia //SOURCE SOCK. Si decide utilizar esta caracterstica de prefijacin de registro de datos, utilcela para todas las filas de datos que enve el programa cliente de socket. Como ejemplo de utilizacin de esta funcin, a continuacin se suministra un metarchivo de proveedor de datos de socket con tres grupos de atributos:
//APPL SockEvent @Socket Provider application //NAME Events1 E 300 AddSourceName //SOURCE SOCK HOSTB //ATTRIBUTES Date D 8 Time D 8 LogFile D 20 DLM=( Code D 20 DLM=) Severity D 30 DLM=: Message Z 512 //NAME Events2 E 300 AddSourceName //SOURCE SOCK HOSTB //ATTRIBUTES Date D 8 Time D 8 LogFile D 20 DLM=( Code D 20 DLM=) Severity D 30 DLM=: Message Z 512 //NAME Events3 E 300 AddSourceName //SOURCE SOCK HOSTB //ATTRIBUTES Date D 8 Time D 8 LogFile D 20 DLM=( Code D 20 DLM=) Severity D 30 DLM=: Message Z 512
Las sentencias //SOURCE SOCK no tienen especificaciones [port#], lo que significa que el programa cliente de socket debe asignar como prefijo a cada registro de datos el nombre de aplicacin y el nombre de grupo de atributos. A continuacin, se muestra un programa cliente de socket, implementado en un script Perl, que enva datos a cada uno de los tres grupos de atributos:
#!/usr/bin/perl -w # SockEvent.pl # a simple UA client using IO:Socket
106
#---------------use strict; use IO::Socket; # Initialize socket connection to UA #---------------my $host = myuahost; my $port = 7500; my $sock = new IO::Socket::INET( PeerAddr => $host, PeerPort => $port, Proto => tcp); $sock or die "no socket :$!"; syswrite $sock, "//SockEvent\n"; syswrite $sock, "<ApplName=SockEvent><AttrGroup=Events1>20061107 02:19:46 listener131(116)WARNING:Test Event 1\n"; syswrite $sock, "<ApplName=SockEvent><AttrGroup=Events1>20061107 02:21:34 listener131(117)INFO:Test Event 2\n"; syswrite $sock, "<ApplName=SockEvent><AttrGroup=Events1>20061107 02:22:02 listener131(101)WARNING:Test Event 3\n"; syswrite $sock, "<ApplName=SockEvent><AttrGroup=Events2>20061107 02:29:46 listener132(216)WARNING:Test Event 4\n"; syswrite $sock, "<ApplName=SockEvent><AttrGroup=Events2>20061107 02:31:34 listener132(217)INFO:Test Event 5\n"; syswrite $sock, "<ApplName=SockEvent><AttrGroup=Events2>20061107 02:32:02 listener132(201)WARNING:Test Event 6\n"; syswrite $sock, "<ApplName=SockEvent><AttrGroup=Events3>20061107 02:39:46 listener133(316)WARNING:Test Event 7\n"; syswrite $sock, "<ApplName=SockEvent><AttrGroup=Events3>20061107 02:41:34 listener133(317)INFO:Test Event 8\n"; # Finalization Processing #--------------syswrite $sock, "//END-DP-INPUT\n"; close $sock;
Este ejemplo indica que existe un archivo llamado miAplic.mdl en el directorio de metarchivos. No es necesario especificar la extensin .mdl porque se sobrentiende. Adems, no debe preocuparse de las posibles diferencias de representacin de cdigo de caracteres entre el host del programa cliente de socket y el host del proveedor de datos de socket. El proveedor de datos detecta automticamente la necesidad de conversin de cdigo incluso aunque no se conozca an el metarchivo o la sentencia SOURCE. v El metarchivo debe estar disponible para el proveedor de datos de socket localmente o debe poderse recuperar desde un servidor de metarchivos centralizado. v Si el metarchivo define una aplicacin que incluye slo un grupo de atributos, la sentencia SOURCE es opcional. v Si la aplicacin incluye ms de un grupo de atributos, sern necesarias sentencias SOURCE y su especificacin no debe resultar en ambigedad alguna. Si el mismo nombre de host est emitiendo datos de entrada para varios grupos de atributos, puede utilizar el mtodo de nmero de puerto o el mtodo del prefijado de registros de datos descritos anteriormente como sistema para resolver la ambigedad. Por ejemplo, un programa desde el host MVSA se pone en contacto con el proveedor de datos de socket en el sistema FIN1. El primer registro de datos recibido por el proveedor de datos, //JOBCNTL, indica que debera utilizarse el metarchivo JOBCNTL.mdl. Si el metarchivo no se ha cargado ya, el proveedor de datos de lo cargar y descubrir que no hay ninguna definicin de sentencia SOURCE. La aplicacin NCAJOB incluye slo un grupo de atributos, PartList. Por lo tanto, el proveedor de datos puede asociar rpidamente el programa con el grupo de atributos PartList de la aplicacin NCAJOB.
Captulo 4. Acerca de los proveedores de datos
107
Si la aplicacin NCAJOB contuviese ms de un grupo de atributos, sera necesaria una sentencia SOURCE, pero nicamente para evitar la ambigedad dentro del mbito de la aplicacin NCAJOB. El mtodo de asociacin explcita es menos rgido y ms sencillo de utilizar que el mtodo de sentencia SOURCE. Adems, no se ve afectado por otros programas activos conocidos por el proveedor de datos de socket al mismo tiempo porque, al especificar explcitamente un metarchivo, el mbito de la resolucin se restringe a una nica definicin de metarchivo.
108
El recibo de este registro hace que el proveedor de datos de socket dirija cualquier mandato de automatizacin al sistema de destino del programa cliente de socket. Nota: La habilitacin de esta caracterstica presupone que el programa cliente ha abierto un socket de lectura que est esperando recibir mandatos de accin desde el proveedor de datos de socket.
Registro CLEAR-PRIOR-DATA
De forma predeterminada, las filas de datos que el proveedor de datos de socket ha recibido para un grupo de atributos se mantienen en la memoria cach de Universal Agent hasta que se depuren filas de datos cuando caduque el intervalo TTL. Si desea eliminar las filas de datos de socket recopiladas anteriormente sin esperar la caducidad TTL, puede enviar un registro //CLEAR-PRIOR-DATA al proveedor de datos de socket. El registro //CLEAR-PRIOR-DATA slo se aplica al grupo de atributos asociados a la conexin actual. Por ejemplo, si el metarchivo de socket tiene grupos de atributos y cada uno tiene su propia conexin separada con un parmetro [port#] exclusivo, debe enviar un registro //CLEAR-PRIOR-DATA para cada conexin para depurar todas las filas de datos recopiladas anteriormente para dicha aplicacin.
v El programa cierra el socket TCP, lo cual resulta en la deteccin de la terminacin de la conexin por parte del proveedor de datos. Los programas que utilizan un socket UDP pero omiten enviar el mensaje de final de transaccin, exceden el tiempo de espera despus de cinco intervalos TTL, como ya se ha mencionado anteriormente en Tiempo de espera excedido en la pgina 108. Los programas que envan datos de tipo Suceso debern enviar el mensaje de final de transaccin o permanecer en lnea para IBM Tivoli Monitoring hasta que haya una conclusin del sistema o hasta que el programa vuelva a contactar con el proveedor de datos.
109
A modo de ejemplo, si un programa cliente de socket se est ejecutando en un sistema operativo z/OS y se est comunicando con el proveedor de datos de socket en un sistema operativo AIX, incluya el parmetro E en la sentencia SOURCE del metarchivo de socket para indicar que el sistema remitente est utilizando EBCDIC, por ejemplo.
//SOURCE SOCK MVSA E
Nota: Si la plataforma del programa cliente es EBCDIC pero el programa est enviando datos UTF-8 para una aplicacin globalizada, no incluya el parmetro E. Un programa cliente de socket basado en z/OS no siempre enva datos EBCDIC. Por ejemplo, algunos clientes de Java que se ejecutan en z/OS Java Virtual Machine envan datos UTF-16 Big Endian de forma predeterminada. En este caso, si se especifica el parmetro E en la sentencia //SOURCE SOCK se generarn datos incorrectos en la aplicacin. El problema se puede corregir si el cliente de Java convierte primero los datos a UTF-8 antes de enviarlos al proveedor de datos de socket y si se omite el parmetro E del metarchivo. Siempre es importante determinar la representacin de caracteres de los datos que el programa cliente de socket enva, especialmente, si el programa se ejecuta en un tipo de plataforma del SO diferente del proveedor de datos de socket.
Especificacin del entorno local y pgina de cdigos en la sentencia SOURCE del metarchivo
Si el idioma y la pgina de cdigos de los datos que el programa cliente de socket est emitiendo como entrada no es el idioma y pgina de cdigos predeterminado del sistema en el que se est ejecutando Tivoli Universal Agent, deber especificar los parmetros de palabra clave CODEPAGE y LOCALE en la sentencia //SOURCE SOCK del metarchivo. Estos dos parmetros le dicen al proveedor de datos de socket qu codificacin de caracteres utilizar al procesar los datos de entrada. Consulte Sentencia SOURCE en la pgina 140 para obtener informacin acerca de la utilizacin de los parmetros LOCALE y CODEPAGE.
110
La variable de entorno KUMP_TCP_OUTAGE_WINDOW permite que el proveedor de datos de socket detecte dichas interrupciones de sistema. Cuando se detecta una interrupcin, se presenta una notificacin de sistema gestionado fuera de lnea inmediatamente a Tivoli Enterprise Portal. El valor predeterminado de esta variable es de 180 segundos, lo que permite a Tivoli Universal Agent detectar cualquier interrupcin de la sesin de conexin en una ventana de 3 minutos. Puede aumentar el periodo de ventana de deteccin estableciendo KUMP_TCP_OUTAGE_WINDOW en un valor superior a 180, o bien reducir la ventana estableciendo un valor inferior de 180. Si no necesita la deteccin de interrupciones, puede inhabilitar esta caracterstica especificando un valor de 0. La Tabla 3 en la pgina 12 proporciona el nombre y ubicacin del archivo de variables del sistema operativo. Investigue las caractersticas de las aplicaciones supervisadas y de la configuracin de red antes de cambiar los valores predeterminados. Un valor ms largo retrasa la notificacin de las interrupciones de red. Un valor ms corto aumenta la carga de proceso de Tivoli Universal Agent.
Reconocimiento de datos
Puede seleccionar hacer que el proveedor de datos de socket reconozca la recepcin de los datos de un programa cliente de socket. Esto permite que el programa de socket y el proveedor de datos detecten problemas de comunicacin inmediatamente y que inicien procedimientos correctivos. Especifique el requisito de reconocimiento utilizando la sentencia CONFIRM. Consulte Sentencia CONFIRM en la pgina 157 para obtener ms informacin.
111
112
113
Existe un sistema gestionado UAGENT para cada proveedor de datos activo y existe un sistema gestionado para cada aplicacin de Tivoli Universal Agent que se ha activado al iniciarse Tivoli Universal Agent o mediante un mandato de importacin. El primer sistema gestionado en la Tabla 21 en la pgina 113 es el nodo de latido vital de Tivoli Universal Agent, de tipo Universal Agent. Todos los dems sistemas gestionados son subnodos de tipo Universal Data Provider. Los trminos sistemas gestionados, nodos y subnodos se suelen emplear indistintamente. Con Tivoli Universal Agent, slo los subnodos tienen datos de aplicacin que se pueden visualizar en un espacio de trabajo y a los que se hace referencia en una situacin. Desde el punto de vista de un usuario, los nicos sistemas gestionados por Tivoli Universal Agent que sean relevantes son los subnodos. El nodo de latido vital de Tivoli Universal Agent se utiliza estrictamente para gestionar la conexin con el servidor de Tivoli Enterprise Monitoring.
donde: nombre_host El nombre del host en el que se ha iniciado Tivoli Universal Agent. Cada aplicacin de Tivoli Universal Agent supervisada aparece en la vista de Navigator de Tivoli Enterprise Portal como:
nombreinst_nombrefuente:nombreaplicVV
donde: nombreinst nombrefuente Especifica el nombre de instancia de Tivoli Universal Agent. El prefijo nombreinst_ slo se incluye si se inicia una copia no primaria de Tivoli Universal Agent. Identifica la ubicacin de los datos. Para los proveedores de datos archivo, script, ODBC, HTTP, Envo y SNMP, nombrefuente es el host del proveedor de datos. Para otros proveedores de datos (Socket, Servidor de API), el nombre de la fuente es la ubicacin de red del cliente que enva los datos. Por ejemplo, si un proveedor de datos de socket se est ejecutando en un host llamado PRDSRV1 y un programa cliente de socket est enviando datos desde el host newyork, el componente del nombre de la fuente del nombre de sistema gestionado es newyork. Especifica el nombre de la aplicacin definida en el metarchivo. Especifica el nmero de versin del metarchivo.
nombreaplic VV
Por ejemplo, si un proveedor de datos de archivo se est ejecutando en el sistema FIN1 dando soporte a una aplicacin y grupo de atributos de Tivoli Universal Agent definidos como
//APPL LOGS //NAME SYSLOG E //SOURCE FILE /syslog tail
y se trata de la primera versin del metarchivo, el nombre del sistema gestionado del grupo de atributos es FIN1:LOGS00.
114
VV.RR.MM
donde: VV RR MM El nmero de versin de Tivoli Universal Agent. El release actual es la versin 06. El nmero de versin del metarchivo. El nmero de modificacin del metarchivo.
Tenga en cuenta que Universal Agent utiliza la parte RR del prefijo de versin de 2 dgitos cuando se construyen nombres de sistemas gestionados.
Fsica
La vista predeterminada de Navigator es Fsica, con los siguientes niveles: Empresa El nivel superior. Incluye todos los sistemas en la organizacin donde se han instalado agentes de supervisin.
115
Plataforma operativa La plataforma operativa en la que se est ejecutando el agente de supervisin, como los sistemas operativos z/OS, Windows, UNIX o Linux. Sistema El nombre del sistema o imagen de z/OS donde se encuentran instalados los agentes de supervisin. Agente El agente de supervisin est instalado en el sistema. Si el nombre del agente est atenuado, quiere decir que el agente est fuera de lnea. Algunos productos de IBM Tivoli Monitoring tienen agentes y subagentes, por ejemplo, MQSeries y SAP R/3. En tales casos, se aade otro nivel para incluir los subagentes en la carpeta del agente de gestin. Algunos agentes de Tivoli Enterprise Monitoring se agrupan en una carpeta, en particular aquellos que tienen varios agentes del mismo tipo en el mismo sistema. Por ejemplo, CICSplex, MQSeries y Tivoli Universal Agent. Grupo de atributos La categora de atributos que supervisa el agente. Un grupo de atributos se compone de varios o muchos atributos individuales, cada uno de los cuales se utiliza como una columna en una tabla, como una serie de datos en un diagrama o como una condicin en una situacin. Es posible ver algunos grupos de atributos agrupados bajo un ttulo, con varios espacios de trabajo disponibles.
Lgica
La vista Lgica agrupa agentes en objetos gestionados. Los objetos gestionados y los sistemas gestionados que representan se definen en Tivoli Enterprise Portal. Pulse sobre la pestaa Lgica para ver la vista lgica. Esta vista refleja la jerarqua de los objetos gestionado. El objeto de visin general asignado aparece en el nivel superior de la vista lgica. Cualquier objeto gestionado en el objeto de visin general aparece en el siguiente nivel.
116
Consulte Creacin de ayuda para aplicaciones, grupos de atributos y atributos en la pgina 19 para obtener informacin adicional.
donde: NombreHostLocal Host donde se ejecuta el proveedor de datos. TIPODP TipoPD VV Nombre de host en el que se encuentra el proveedor de datos. Tipo de proveedor de datos. Por ejemplo FILEdp, SOCKdp, ODBCdp, HTTPdp o ASFSdp. Nmero de versin de la aplicacin UAGENT, que siempre es 00.
Por ejemplo, el nombre de sistema gestionado de un proveedor de datos de archivo ejecutndose en un sistema llamado ENG1 es ENG1FILEdp:UAGENT00.
117
Tabla 22. Columnas del espacio de trabajo DPLOG (continuacin) Nombre de la columna ID mens. registro DP Descripcin El ID de mensaje asociado con el texto del mensaje de DPLOG.
Tabla 23. Categoras del espacio de trabajo DPLOG Categora SYSTEM Descripcin Entradas pertinentes a operaciones generales del proveedor de datos como inicio, conclusin, actividades de subprocesos, estatus operativo con Tivoli Universal Agent, y estadsticas peridicas del sistema. Entradas relacionadas con condiciones de error significativas, como E/S irrecuperable de archivo, errores en el entorno de ejecucin, errores de definicin de configuracin y errores internos de proceso. Mensajes correspondientes a situaciones no crticas, como definiciones de datos de aplicacin no definidas o una aplicacin ya registrada con Tivoli Universal Agent, o circunstancias en las que se han emprendido acciones predeterminadas o se han suministrado valores predeterminados durante el proceso normal. Seguimientos detallados de auditora de actividades de proceso. Representan el estatus general del proveedor de datos y solicitudes de trabajo, como mandatos de consola recibidos y resultados de proceso, actividades de definicin de aplicaciones y motivos para un retraso en la supervisin de un archivo. Entradas de registro informativas pertinentes a actividades del proveedor de datos de servidor de API. Ejemplos: llamadas a API de dp_Define, dp_Redefine, dp_BeginInput, dp_EndInput. Actividades de comunicacin entre el proveedor de datos de servidor de API y los programas cliente, como por ejemplo, llamadas a API dp_OpenSession y dp_CloseSession. Mensajes informativos relacionados con el proveedor de datos de SNMP. Ejemplos: se han cargado las definiciones de configuracin de condiciones de excepcin, solicitud de inicio de recopilacin de datos MIB para el agente, o se ha iniciado la gestin de red SNMP Mensajes informativos relacionados con interacciones con el servidor centralizado de metarchivos del proveedor de datos. Ejemplos: proceso de una solicitud de metarchivo por parte del servidor, informacin de salida de una recuperacin de metarchivo. Actividades de comunicacin entre el cliente de metarchivos del proveedor de datos y el servidor de metarchivos del proveedor de datos. Ejemplos: el cliente de metarchivos del proveedor de datos conectado correctamente al servidor, error de conexin y estatus de reintento automtico o desconexin detectada por alguna de las partes. Actividades de comunicacin relacionadas con proveedores de datos de socket. Ejemplos: nueva conexin TCP aceptada, nuevo socio UDP reconocido, conexin abandonada debido a una discrepancia en la configuracin o tiempo de espera excedido del socio UDP debido a la inactividad.
ERROR
WARNING
INFO
APIINFO
APICOMM
SNMPINFO
METAINFO
METACOMM
SOCKCOMM
118
Tabla 24. Columnas del espacio de trabajo ACTION Columna ID de accin Descripcin El nmero de secuencia de la accin generada internamente por Tivoli Universal Agent utilizado para realizar un seguimiento de las actividades y el progreso de la accin. Nota: La columna/atributo ID de accin forma parte del grupo de atributos ACTION pero est oculta y no se visualiza en el espacio de trabajo ACTION. El tipo de accin. Por ejemplo, automatizacin de Reflejo o Poltica. El nombre del objeto (situacin o poltica) que ha iniciado la accin. Los elementos de actuacin se ven de la misma manera que las polticas. El nombre del sistema gestionado que procesa la accin. El nombre de la accin o mandato a ejecutar. Los parmetros exactos de entrada que desea pasar al programa de accin o mandato. El estatus de la solicitud de accin. Una accin puede incluir un nmero de etapas y el estatus refleja el progreso de la accin a medida que varios componentes de operacin la manejan. Los primeros 256 caracteres de la salida del procesado de la accin. La indicacin de la hora en que se desencaden la accin.
Tipo de accin Propietario de la accin Nodo de accin Nombre de accin Parmetros de la accin Estatus de la accin
Utilizacin de situaciones
Modifique situaciones desde Tivoli Enterprise Portal utilizando el Editor de situaciones. Puede realizar las siguientes tareas cuando utilice el Editor de situaciones:
Captulo 5. Supervisin de aplicaciones
119
v v v v v v
Crear una situacin Guardar una situacin Visualizar una situacin Editar una situacin Iniciar, detener o suprimir una situacin Investigar el espacio de trabajo de sucesos de una situacin
Cuando se abre el Editor de situaciones, el marco izquierdo lista inicialmente las situaciones asociadas con el elemento de Navigator seleccionado. Al pulsar sobre un nombre de situacin o crear una nueva situacin, el marco derecho del Editor de situaciones se abrir para proporcionar informacin acerca de la situacin o para dejarle definir ms en detalles dicha situacin: Condicin Distribucin Consejo experto Accin Ver, aadir a y editar la condicin que se est probando Ver los sistemas a los que se ha asignado la situacin y asignar la situacin a los sistemas Escriba comentarios o instrucciones para leerlas en el espacio de trabajo de sucesos Especificar un mandato a enviar al sistema. Tambin puede escribir mandatos de actuacin aadiendo una vista de actuacin a un espacio de trabajo, seleccionando Actuacin en el men emergente para un elemento de la vista fsica de Navigator, o bien crear mandatos de actuacin y guardarlos para su posterior uso. Hasta Restablece una situacin verdadera cuando otra situacin pasa a ser verdadera o transcurre un intervalo de tiempo especificado
120
121
122
123
124
El proceso de configurar informacin para un gestor de SNMP es diferente para cada producto de gestor. Por ejemplo, algunos productos del gestor de SNMP requieren una importacin de MIB o un paso de compilacin. Para obtener instrucciones sobre cmo llevar a cabo esta tarea, consulte la documentacin del producto del gestor de SNMP.
Estos datos siempre se encuentran en la lista de enlaces de variable de la condicin de excepcin. Lo que aparece en sitAttributeList depende de qu atributos seleccione al editar los parmetros del emisor de SNMP en el editor de flujo de trabajo. Es posible encontrar una descripcin completa de dichas variables en el archivo CANSYSSG.MIB. Este archivo MIB depende de las definiciones del archivo CANBASE.MIB; por lo tanto, ambos son necesarios. El formato de sitAttributeList es una cadena de pares de AttributeName=AttributeValue separados por comas. En el siguiente ejemplo se muestra la salida de rastreo capturada cuando se utiliza el Emisor de SNMP para una situacin de agente del SO Windows, NT_Log_Space_Low. En este ejemplo, el Registro de sucesos de aplicaciones en el sistema HOSTABC estaba en una ocupacin del 100%, lo que caus que surgiera la situacin y que la poltica asociada enviara una condicin de excepcin de SNMP al destino 192.1.18.55. Durante la definicin de poltica, se seleccionaron los atributos Log_Name_U, Current_Size, %_Usage, Timestam y Max_Size para incluirse en la condicin de excepcin:
Destinations-----------{192.1.18.55} SituationName--------{NT_Log_Space_Low} SituationTime---------{1070227071953999} ManagedSystem------{Primary:HOSTABC:NT} Severity----------------{Minor} Category---------------{Log_Only_Events} SituationPredicates---{NT_Monitored_Logs_Report.%_Usage >= 95} AttributeList-----------{NT_Monitored_Logs_Report,Log_Name_U=Application, Current_Size=524288,%_Usage=100,Timestamp=1070227071953000,Max_Size=524288}
125
situaciones, puede crear una o ms polticas donde la actividad inicial sea la evaluacin de la situacin y una actividad siguiente sea la actividad SNMP_Event. Lleve a cabo los siguientes pasos para establecer los parmetros del emisor de SNMP: 1. Seleccione el icono SNMP_Event de entre los componentes de flujo de trabajo de la pestaa Actividades del emisor. 2. Proporcione los siguientes parmetros en la ventana Valores del emisor: Destino del emisor Seleccione cualquier sistema gestionado del proveedor de datos de Tivoli Universal Agent en el men desplegable. Sin embargo, tenga en cuenta que para obtener mejores resultados, debe elegir uno de los sistemas gestionados UAGENT, el cual tenga llamados todo sistemas gestionados:
NombreHostTIPODPsp:UAGENT00
donde: NombreHost Host donde se ejecuta el proveedor de datos. TIPODP Tipo de proveedor de datos de 4 caracteres, seguido del literal dp. Algunos ejemplos de proveedores de datos incluyen: ASFS o HTTP. Gravedad Seleccione uno de los siguientes grados de gravedad predefinidos: v Eliminado v Indeterminado v Aviso (valor predeterminado) v Error_menor v Crtico v Grave De forma predeterminada, este valor de gravedad definido por esta poltica se visualiza como el valor de Gravedad de la condicin de excepcin en el sistema receptor. Si desea que la gravedad definida por la poltica slo aparezca en la informacin de vinculacin de la variable de condicin de excepcin en el sistema receptor, establezca la siguiente variable de entorno:
KUMP_TRAP_USE_POLICY_SEVERITY=N
Categora Seleccione una de las siguientes categoras predefinidas: v v v v v v v v v v Threshold_Events (valor predeterminado) Network_Topology_Events Error_Events Status_Events Node_Configuration_Events Application_Alert_Events All_Category_Events Log_Only_Events Map_Events Ignore_Events
TrapDestination Escriba una o ms direcciones IP/nombres de hosts para que reciban las condiciones de
126
excepcin. Si utiliza un nombre de host, debe ser un nombre capaz de resolverse mediante DNS. Si se especifica ms de una entrada, deber separarlas con comas. Por ejemplo, Granito, 10.60.152.53, Atenas. Como un mtodo alternativo, puede especificar la variable de entorno KUMP_TRAP_DESTINATION en el archivo de variables de entorno de Tivoli Universal Agent. Esta variable sigue el mismo formato y normas que TrapDestination. Si el parmetro TrapDestination se deja con el valor _DEFAULT, las alertas se envan a los nombres de host identificados mediante KUMP_TRAP_DESTINATION. Nota: No es necesario especificar a la vez el parmetro TrapDestination en la ventana Valores del emisor y la variable de entorno KUMP_TRAP_DESTINATION. Si se especifican ambos, el parmetro TrapDestination tendr prioridad. Si se especifica el parmetro TrapDestination en la definicin de Poltica, se obtendr ms granularidad si existe la necesidad de enviar distintas condiciones de excepcin a distintos gestores de SNMP. Pero si el destino siempre es el mismo grupo de una o varias direcciones IP y tiene que crear muchas polticas, entonces es ms conveniente establecer la variable de entorno KUMP_TRAP_DESTINATION en Tivoli Universal Agent y dejar los valores de poltica de TrapDestination como _DEFAULT. Atributos Seleccione los atributos asociados con la situacin que se est supervisando en la segunda ventana emergente. Los valores de los atributos que seleccione se reenvan como parte de la condicin de excepcin de SNMP en la lista de vinculacin de variable. El emisor de condiciones de excepcin de SNMP puede enviar datos de atributos que no estn en ingls. Invocar emisor una vez para cada fila de datos No es necesario realizar ninguna accin con la seleccin predeterminada del botn de seleccin. 3. Pulse Aceptar para guardar las selecciones. 4. Distribuya la poltica a un sistema gestionado que sea del mismo tipo que el sistema gestionado al que se ha distribuido la situacin de la poltica. Por ejemplo, si la situacin fuera para el agente del SO Linux y se distribuyera a uno de los sistemas gestionados relacionados, entonces la poltica tambin necesitara ser distribuida a un sistema gestionado asociado al agente del SO Linux.
127
128
Introduccin
Las sentencias de control que se describen en este apndice se utilizan para crear el metarchivo de definicin de datos que define una aplicacin de Tivoli Universal Agent. Algunas de las sentencias slo son utilizadas por algunos proveedores de datos especficos. Las siguientes reglas se aplican a la sintaxis de un metarchivo: v Las sentencias de control deben comenzar con un // en la columna 1 seguido de uno o ms parmetros separados por espacios en blanco. v Se permiten las lneas en blanco en un metarchivo. v Un asterisco (*) en la columna 1 indica una lnea de comentarios. Si estn presentes, deber entrar las sentencias en el metarchivo en el siguiente orden: //SNMP //APPL //NAME //SOURCE //INTERNAL //RECORDSET //CONFIRM //SQL //SUMMARY //ATTRIBUTES
129
Sintaxis
//SNMP TEXT
Parmetro
La sentencia SNMP debe contener el parmetro TEXT.
130
Sintaxis
//APPL <nombreaplic> [WHEN{<valor>}] [ProductCode=] [<afinidades-dinmicas>] [@<texto de ayuda>]
Parmetros
<nombreaplic> Nombre de la aplicacin de Tivoli Universal Agent que desea supervisar. Notas: 1. Un nombre de aplicacin debe contener al menos 3 pero no ms de 20 caracteres. No puede haber espacios en blanco incorporados en el nombre. Slo se permiten caracteres ASCII, incluidos letras, nmeros, guiones (-), subrayados (_) y asteriscos (*). Un carcter no vlido se sustituye automticamente por un subrayado. 2. Hay restricciones especiales con respecto a los tres primeros caracteres de un nombre de aplicacin. El primer carcter no debe ser un dgito y ninguno de los tres primeros caracteres puede ser un guin o un asterisco. 3. Los primeros tres caracteres deben ser exclusivos para toda la empresa. Si se activan dos metarchivos de Tivoli Universal Agent con los tres primeros caracteres iguales en su sentencia //APPL se pueden ocasionar resultados imprevisibles, como informes vacos y cambios de versin de aplicacin frecuentes. 4. El nombre de aplicacin no puede comenzar con el carcter K, ya que est reservado para los productos IBM Tivoli Monitoring. 5. Los primeros tres caracteres no pueden coincidir con uno de los prefijos de la aplicacin de Tivoli Universal Agent reservados: UAG indica UAGENT, SNM indica SNMP-MANAGER e INT indica INTERNET. 6. El nombre de aplicacin lo utiliza Tivoli Universal Agent cuando construye el nombre de sistema gestionado que est registrado con el servidor de supervisin. El estndar de nomenclatura predeterminado para los sistemas gestionados es Nombrehost:NombreaplicVV. Si el nombre de host es relativamente largo, considere la posibilidad de elegir un nombre de aplicacin corto para evitar el truncamiento del nombre de sistema gestionado. Los nombres de sistema gestionado pueden tener un mximo de 32 caracteres. WHEN{<valor>} (opcional) Indica cul es la opcin de habilitacin de almacn que el agente de resumen y poda utiliza para todos los grupos de atributos en la aplicacin de metarchivo, suponiendo que el agente de resumen y poda se haya configurado para la aplicacin. Si se omite el parmetro WHEN, se activa la habilitacin del almacn con la opcin predeterminada de R. Nota: El parmetro <valor> entre llaves es un cdigo de un carcter que indica la opcin de habilitacin de depsito, especficamente, el nivel mnimo de resumen de datos hallado en los datos de fuente de aplicacin. A continuacin se indican los valores vlidos: R En bruto o inferior a una hora
Apndice A. Sentencias de control de definicin de datos
131
H D W M Q Y
ProductCode (opcional) Especifica un cdigo de producto de 2 caracteres que se asigna cuando la aplicacin se registra con el servidor de supervisin. De forma predeterminada, cuando una aplicacin de Universal Agent se registra con el servidor de supervisin, los 2 primeros caracteres del nombre de aplicacin se almacenan en la columna Product de la tabla de estatus de nodo del servidor de supervisin. Este valor de 2 caracteres se visible en la columna Product del espacio de trabajo Estatus de sistemas gestionados en Tivoli Enterprise Portal. Utilice el parmetro ProductCode nicamente si desea asignar un valor ProductCode que no sea un valor predeterminado, por ejemplo:
//APPL MONITOR ProductCode=AB
En lugar de registrar MO como el cdigo de producto de 2 caracteres, Tivoli Universal Agent registra AB, y AB se visualiza en la columna Product del espacio de trabajo Estatus de sistemas gestionados. <afinidades-dinmicas> (opcional) Permite habilitar la aplicacin para el soporte de afinidades dinmicas en lugar de utilizar la afinidad de Universal Agent estndar predeterminada. Puede especificar los tres parmetros de palabra clave siguientes en una sentencia //APPL para definir la informacin de afinidad dinmica. AFFDEF Declara la afinidad. Puede tener hasta 24 caracteres. Si el primer carcter es % o &, entonces se trata como una afinidad dinmica. Los otros 23 caracteres representan el ID de proveedor y el ID de aplicacin, delimitados por un punto. Debe haber como mnimo 1 carcter para el ID de proveedor y el ID de aplicacin, lo que indica una longitud mnima de 4 caracteres. AFFSYMBOL Declara un smbolo asociado a la afinidad. Se trata de una palabra clave opcional para las afinidades dinmicas. El valor AFFSYMBOL tiene un lmite de 31 caracteres y el conjunto vlido es A-Za-z0-9 ms el carcter de subrayado. AFFTEXT Proporciona una cadena de texto ms descriptiva para la afinidad. Se permiten blancos intercalados. Esta palabra clave es obligatoria para las afinidades dinmicas. La cadena AFFTEXT tiene un lmite de 256 caracteres y debe estar delimitada por comillas simples. El siguiente ejemplo de una sentencia //APPL utiliza los tres parmetros de afinidad dinmica:
//APPL NOTES AFFDEF=%IBM.LOTUSNOTES AFFSYMBOL=NOTES_SERVER AFFTEXT=IBM Lotus Notes
<texto de ayuda> (opcional) Define el texto de ayuda para esta aplicacin. Notas: 1. El texto debe estar precedido por el signo arroba (@). 2. El texto no debe exceder los 245 caracteres. 3. Las comas (,) se convierten a espacios en el texto de ayuda.
132
4. Si se especifica un texto de ayuda que no est en ingls, deber guardar el metarchivo en codificacin UTF-8.
133
Sintaxis
//NAME <nombre-grupo-atributos> mtodo [tiempo de vida] [<AddSourceName>] +[<AddTimeStamp>] [Interval=] [SkipNonNumeric=Y/N] [ClearValues=Y/N] [@<texto de ayuda>]
Parmetros
Los parmetros nombre-grupo-atributos, mtodo y tiempo-de-vida son posicionales. Si se especifica, deber entrarlos en la secuencia mostrada anteriormente. Los parmetros estn separados por un espacio. <nombre-grupo-atributos> Especifica el nombre de un grupo de atributos. El nombre identifica un conjunto de definiciones de datos. Notas: 1. Un nombre de grupo de atributos puede contener hasta 32 caracteres. No puede utilizar espacios en blanco incorporados en el nombre. Slo se permiten caracteres ASCII, incluidos letras, nmeros, guiones (-), subrayados (_) y asteriscos (*). Un carcter no vlido se sustituye automticamente por un subrayado. 2. Este parmetro es obligatorio. 3. El mismo nombre de grupo de atributos no puede aparecer ms de una vez en un nico metarchivo. Sin embargo, puede utilizar el mismo nombre de grupo de atributos en metarchivos distintos. 4. El nombre de grupo de atributos lo utiliza Tivoli Enterprise Portal para nombrar el espacio de trabajo en el rbol de Navigator. <mtodo> Especifica la naturaleza de los datos. Se soportan los siguientes cuatro mtodos: P Sondeado (predeterminado). Los datos sondeados estn disponibles peridicamente y slo la ltima fila de datos recopilada est disponible para la supervisin e informe de situaciones. Muestreado. Los datos muestreados se comportan de la misma manera que los datos sondeados excepto en que los datos muestreados son acumulativos, lo que significa que ms de un conjunto de valores de datos de atributos puede estar disponible para su uso. Suceso. Los datos de suceso se producen de forma imprevisible y se informa de los mismos de forma asncrona en cuanto los datos estn disponibles. Con clave. Los datos con clave se comportan de la misma manera que los datos muestreados, pero le permiten correlacionar sucesos. Puede designar hasta cinco atributos en cada grupo como atributos clave. Si no se designa ningn atributo como KEY, se presupone que el primer atributo del grupo es KEY.
E K
134
Por ejemplo, una aplicacin comprueba el estado del sistema como la utilizacin de la CPU y la velocidad del trfico de red cada 30 segundos. Estos son datos sondeados o muestreados, o posiblemente incluso datos con clave si alguno de los atributos funciona como clave exclusiva o como ndice. Por el contrario, las alertas de red o los mensajes de consola, que se producen a intervalos imprevisibles, deben definirse en el metarchivo como datos de suceso. <tiempo de vida (TTL)> (opcional) Define el intervalo de tiempo durante el que estarn disponibles los datos, para la visualizacin de espacios de trabajo y para la evaluacin de situaciones, por parte de Tivoli Universal Agent. Los datos muestreados estn disponibles antes de que caduque su intervalo TTL publicado. Despus del intervalo TTL, los datos se descartan o llega una nueva muestra. Notas: 1. TTL se especifica en segundos. 2. El valor predeterminado de TTL es de 300 segundos. 3. En general, el valor de TTL en el metarchivo es mayor que el intervalo mayor de cualquier situacin definida con respecto al grupo de atributos. El valor de TTL tambin es mayor que la frecuencia con la que se recopilan los nuevos datos para el grupo de atributos. Por ejemplo, si hay nuevas muestras de datos cada minuto, puede especificar un valor de TTL de 90 segundos. Este valor permite que Tivoli Universal Agent mantenga siempre una muestra actual de los datos. Si el valor de TTL es inferior al intervalo de disponibilidad de los datos, Tivoli Universal Agent descarta los datos antes de que llegue la nueva muestra de datos y por lo tanto no tiene datos que evaluar. No obstante, si establece un valor de TTL demasiado alto, un gran nmero de filas de datos recopilados permanecern en la memoria cach de Tivoli Universal Agent, lo que provocara un aumento en la utilizacin de memoria de los procesos. Asegrese de que existe un equilibrio entre un valor de TTL lo suficientemente grande como para capturar los intervalos de situacin o muestras de datos, pero no tan grande tan grande como para que la utilizacin de memoria crezca porque las filas de datos antiguas no se estn eliminando. 4. Para aplicaciones del proveedor de datos de socket, TTL determina el retraso antes de que el estatus de una fuente de datos pase de estar en lnea a estar fuera de lnea en Tivoli Enterprise Portal. Por ejemplo, una aplicacin de Tivoli Universal Agent suministra datos a IBM Tivoli Monitoring utilizando un socket de TCP y especifica un TTL de 30 minutos. Si el programa cliente cierra el socket y se desconecta del proveedor de datos a las 3:30 p.m., el estatus fuera de lnea no se notifica a IBM Tivoli Monitoring hasta las 4:00 p.m. El mismo retraso basado en TTL se aplica a las aplicaciones que suministran datos a un proveedor de datos de servidor de API utilizando la llamada a la API, dp_EndInput. 5. Para los datos con clave, el valor de TTL sirve un propsito adicional. Los atributos clave se identifican como candidatos para la correlacin si la diferencia entre la llegada de los ltimos valores de datos y sus nuevos valores de datos es inferior al valor de TTL. 6. Normalmente, se omite el valor de TTL para los datos de suceso. Las filas de datos de suceso no son datadas y eliminadas como las filas de datos sondeados, muestreados y con clave. De forma predeterminada, las 100 filas ms recientes de datos de suceso tambin permanecern en la memoria cach de Tivoli Universal Agent. Puede modificar este valor con la variable de entorno KUMA_MAX_EVENT_ENTRIES. Consulte el Apndice G, Referencia de variables de entorno, en la pgina 241 para obtener ms informacin. No obstante, el valor de TTL es importante para los datos de suceso en un metarchivo del proveedor de datos de socket. En este caso, el valor de TTL especificado en el metarchivo determina la cantidad de tiempo que la aplicacin permanece en lnea en Tivoli Enterprise Portal, despus de una desconexin entre el programa cliente de socket y el proveedor de datos de socket. El mismo retraso basado en el valor de TTL se aplica a los datos de suceso en un metarchivo del proveedor de datos de servidor de API. <AddSourceName> (opcional) Ordena a Tivoli Universal Agent que aada automticamente el atributo DataSourceName al grupo de atributos definido. Este atributo contiene el nombre de host del
Apndice A. Sentencias de control de definicin de datos
135
nodo desde el que se originan los datos. Por ejemplo, si un programa cliente de socket se est ejecutando en un servidor PROD1 y conectndose a Tivoli Universal Agent en HQ1 y //APPL Sock se ha especificado en el metarchivo de socket, el atributo DataSourceName tiene un valor de PROD1:SOCK00. Nota: El atributo DataSourceName siempre se aade al final de un grupo de atributos. Este es un punto importante a tener presente si actualiza un metarchivo para aadir uno o ms atributos al final de un grupo de atributos existente que utiliza AddSourceName. Normalmente, este tipo de actualizacin de metarchivo constituye un cambio de versin de aplicacin de menor importancia. Pero como DataSourceName siempre est registrado como el ltimo atributo, los nuevos atributos que ha aadido se insertan antes que el ltimo atributo, lo que hace que Tivoli Universal Agent marque la actualizacin como un cambio de versin de aplicacin de mayor importancia. <AddTimeStamp> (opcional) Permite insertar un atributo de indicacin de la hora. Los datos de aplicacin deben con frecuencia correlacionarse con otros datos basados en indicaciones de la hora. Por ejemplo, los sucesos de aplicacin estn relacionados frecuentemente con actividades de red especficas o con estatus de sistemas operativos. En aquellos casos en los que los datos de entrada de la aplicacin no incluyan un campo de atributo temporal, Tivoli Universal Agent soporta la insercin automtica de una atributo LocalTimeStamp cuando el parmetro AddTimeStamp se incluye en a sentencia NAME. Por ejemplo: //NAME CUSTOMERDATA E AddTimeStamp Cuando se especifica este parmetro, Tivoli Universal Agent genera dinmicamente durante el tiempo de ejecucin un valor de atributo LocalTimeStamp para cada nueva fila de datos recopilada. El formato siguiente es el formato de la indicacin de la hora, SAAMMDDhhmmssuuu, donde: S uuu Especifica el siglo. Utilice 1 para el siglo XXI. Especifica los milisegundos despus del valor ss.
De forma predeterminada, Tivoli Enterprise Portal muestra esta indicacin de la hora de 16 bytes en un formato MM/DD/AA HH:MM:SS. Si prefiere el formato AAAA/MM/DD HH:MM:SS uuu, especifique AddTimeStamp=YearMonth en la sentencia NAME y Tivoli Universal Agent generar un atributo de 24 bytes LocalTimeStamp. El ejemplo siguiente muestra cmo especificar AddTimeStamp=YearMonth en la sentencia NAME:
//NAME CUSTOMERDATA E AddTimeStamp=YearMonth
Nota: El atributo LocalTimeStamp siempre se aade al final de un grupo de atributos. Este es un punto importante a tener presente si actualiza un metarchivo para aadir uno o ms atributos al final de un grupo de atributos existente que utiliza AddTimeStamp. Normalmente, este tipo de actualizacin de metarchivo constituye un cambio de versin de aplicacin de menor importancia. Pero como LocalTimeStamp siempre est registrado como el ltimo atributo, los nuevos atributos que aada se insertan antes que el ltimo atributo, lo que hace que Tivoli Universal Agent marque la actualizacin como un cambio de versin de aplicacin de mayor importancia. Interval (opcional) Especifica un intervalo de muestreo en segundos que se utiliza para la recopilacin de datos de grupo de atributos. Este parmetro slo se aplica a los metarchivos del proveedor de datos de script y de ODBC, y se omite en otros metarchivos del proveedor de datos. La presencia de un parmetro Interval=nn en un metarchivo de ODBC o de script significa que se utiliza la recopilacin a intervalos. Por ejemplo, tenga en cuenta que la siguiente sentencia est especificada en un metarchivo ODBC:
//NAME EMPLOYEES K 300 Interval=60
136
Si la sentencia de la lnea anterior se ha especificado en un metarchivo ODBC, el subproceso de supervisin para el grupo de atributos EMPLOYEES se activa cada 60 segundos y emite el mandato Select de SQL para recopilar datos. El valor de intervalo mnimo permitido es de 30 segundos. Si se establece en un valor entre 1 y 29, se reasigna automticamente a 30. Si se mote el parmetro Interval en la sentencia NAME para un grupo de atributos de ODBC o de Script o si se especifica Interval=0, se habilita la recopilacin de datos bajo demanda. Bajo demanda quiere decir que los datos slo se recopilan cuando se produce un intervalo de situacin para el grupo de atributos o cuando se emite un mandato de apertura o renovacin de un espacio de trabajo de Tivoli Enterprise Portal para el grupo de atributos. A la hora de decidir si un grupo de atributos de ODBC o de Script utiliza la recopilacin de bajo a intervalos o bajo demanda, tenga en cuenta lo siguiente: (1) cunto tiempo suele tardar en completarse un mandato de recopilacin de datos y (2) el nmero y la frecuencia de situaciones y accesos al espacio de trabajo para el grupo de atributos. Si el script, sentencia Select de SQL o procedimiento almacenado pueden finalizar con rapidez, la recopilacin bajo demanda es una buena opcin porque significa que el usuario no tiene que esperar mucho tiempo a que se visualicen filas de datos del espacio de trabajo de Tivoli Enterprise Portal. Las solicitudes de informes bajo demanda tienen un valor de tiempo de espera excedido de 15 segundos (nota: este valor se puede modificar con la variable de entorno KUMA_REPORT_REQUEST_EXPIRATION). Por consiguiente, un mandato de recopilacin de datos que tarda ms de 15 segundos en completarse muestra un espacio de trabajo vaco o un conjunto parcial de filas de datos. La recopilacin bajo demanda es una buena opcin para el grupo de atributos que se utiliza poco. Si hay muy pocas, o ninguna situacin definida contra dicha opcin, y se accede a los datos del espacio de trabajo con poca frecuencia, un grupo de atributos bajo demanda ahorra la sobrecarga del sistema al no ejecutar el mismo script, sentencia Select de SQL o procedimiento almacenado a un intervalo fijo incluso cuando no exista la necesidad de recopilar los datos. Pero si el nmero de situaciones y accesos a espacios de trabajo es bastante alto, entonces la recopilacin bajo demanda es ms eficaz porque significa que un ciclo de recopilacin de datos puede satisfacer varias evaluaciones de situaciones y se pueden producir accesos a espacios de trabajo durante el intervalo de tiempo especificado. Nota: La combinacin de recopilacin de datos bajo demanda y grupos de atributos invisibles no est soportada (consulte Grupos de atributos invisibles en la pgina 138 para obtener ms informacin). En un metarchivo del proveedor de datos de ODBC o de Script con un primer grupo de atributos invisible, especifique siempre un parmetro Interval=nn. SkipNonNumeric (opcional) Especifique SkipNonNumeric=Y en la sentencia NAME si el grupo de atributos contiene tipos de atributo, como por ejemplo C o G, y desea que se omitan las filas de datos recopiladas si contienen un valor no numrico en cualquier atributo numrico. Por ejemplo,
//NAME Process K 300 Interval=60 SkipNonNumeric=Y //SOURCE SCRIPT /home/myscripts/monitor.sh //ATTRIBUTES Attr1 D 32 Attr2 C 999999 Attr3 D 16
A medida que el proveedor de datos de script procesa las filas de salida del script monitor.sh , y si existe alguna fila de datos que contenga un carcter no numrico en el atributo Attr2, se omitir toda la fila. El comportamiento predeterminado de IBM Tivoli Universal Agent es grabar un cero en un atributo numrico cuando se detectan datos no numricos, pero no omitir toda la fila. Consulte el Apndice B, Definiciones de atributos, en la pgina 169 para obtener ms informacin acerca de los tipos de atributos soportados. ClearValues (opcional) Si falta algn valor de atributo en una fila de datos para un grupo de atributos Sondeado o Muestreado, los valores de los mismo atributos procedentes de la fila de datos
Apndice A. Sentencias de control de definicin de datos
137
anterior se traspasan a la fila de datos actual, que es la razn por la que ocasionalmente se ve un valor de atributos anterior sustituido por un valor que falta en un espacio de trabajo. Observe que los grupos de atributos de suceso (E) y con clave (K) no presentan este comportamiento. Siempre borran todos los valores de atributo anteriores antes de llenar una fila de datos nueva. Si falta algn valor de atributo en la fila de datos actual, se asigna un valor predeterminado de acuerdo con el tipo de atributos que se describe en la Tabla 25 en la pgina 171. Si desea que un grupo de atributos sondeado o muestreado se comporte como los grupos de atributos de suceso y por clave, especifique ClearValues=Y en la sentencia NAME; por ejemplo:
//NAME RUNNINGQUEUE S 300 ClearValues=Y //INTERNAL INPUT QUEUEDATA //ATTRIBUTES QUEUE D 8 STATUS D 16 +FILTER={SCAN(0,running)} JOB D 12 USER D 12 PERCENT C 999999
El parmetro ClearValues=Y no es necesario para los grupos de atributos de suceso y por clave porque borran de forma predeterminada los valores anteriores. Y viceversa; si desea sustituir los valores de atributo anteriores por valores que faltan en la fila de datos actual, especifique ClearValues=N, que es vlido para los cuatro tipos de grupos de atributos. <texto de ayuda> (opcional) Define el texto de ayuda de este grupo de atributos. Notas: 1. El texto debe estar precedido por el signo arroba (@). 2. El texto no debe superar los 230 caracteres. 3. Las comas (,) se convierten a espacios en el texto de ayuda. 4. Si se especifica un texto de ayuda que no est en ingls, deber guardar el metarchivo en codificacin UTF-8.
138
//INTERNAL OUTPUT RAWDATA //ATTRIBUTES RawData D 1024 * //NAME ERRORS E 300 //INTERNAL INPUT RAWDATA //ATTRIBUTES Date D 8 Time D 8 LogFile D 20 DLM=( Code D 20 DLM=) Severity D 30 DLM=: +FILTER={MATCH(0,Error)} Message Z 512 * //NAME WARNINGS E 300 //INTERNAL INPUT RAWDATA //ATTRIBUTES Date D 8 Time D 8 LogFile D 20 DLM=( Code D 20 DLM=) Severity D 30 DLM=: +FILTER={MATCH(0,Warning)} Message Z 512
En este ejemplo, desea crear dos grupos de atributos separados para la visualizacin de espacios de trabajos: ERRORS y WARNINGS. Determinados registros enviados por el programa cliente de socket contienen Error en el atributo Gravedad, mientras que otros contienen Aviso. Al designar el grupo de atributos RawSocketData como invisible, su nica finalidad es leer en todos los datos de entrada de socket. A continuacin, los dos grupos de atributos redirigidos pueden aplicar filtros diferentes para organizar y presentar los datos de un modo ms significativo.
139
Sintaxis
//SOURCE <tipo> [<intrprete-script>] <ubicacin> [<argumentos-script>] [<tipo-cdigo>] [<modalidad-archivo>] [<nmero-de-registros-archivo>][<mtodo-comparacin-archivos>] [User=] [Pswd=] [Database=] [Server=] [Maxrows=] [Locale=] [Codepage=] [Envfile=] [Runtime=] [Interval=] [SetSourceName=Y/N] [RunOnce=Y/N] [Hostaddr=] [Hostinfo=] [ManagedSystemName=]
Parmetros
Los parmetros <tipo>, <intrprete-script>, <ubicacin>, <argumentos-script>, <tipo-cdigo>, <modalidad-archivo>, <nmero-de-registros-archivo> y <mtodo-comparacin-archivos> son de posicin. Si se especifican, deben colocarse en la secuencia que se muestra arriba en la seccin Sintaxis. Los parmetros de la sentencia SOURCE restantes utilizan un formato palabra_clave=<valor> y se pueden colocar en cualquier orden despus de los parmetros de posicin. <tipo> Especifica el formato de la fuente de datos. FILE ODBC Indica que la fuente de datos es una tabla relacional. SOCK Indica que la fuente de datos es un script o programa cliente de socket. SCRIPT Indica que la fuente de datos es un script o programa local. SNMP Indica que la fuente de datos es un agente SNMP. TRAP Indica que la fuente de datos es la tabla SNMP-MANAGER TRAP. <intrprete-script> (opcional) Para fuentes del tipo SCRIPT, especifica el programa intrprete de script necesarios para ejecutar el script. Algunos ejemplos de intrpretes de script son Perl, REXX y VBScript. Si el proveedor de datos de script no puede encontrar el programa intrprete durante el tiempo de ejecucin, deber proporcionar un parmetro de intrprete de script antes de entrar el nombre de Indica que la fuente de datos en un archivo de local.
140
archivo de script en el campo <ubicacin>. Si la va de acceso completa del intrprete de script contiene cualquier espacio en blanco incorporado, rodelo lo de comillas simples. Por ejemplo,
//SOURCE SCRIPT C:\Archivos de programa\ObjREXX\rexx.exe myscript.rex
<ubicacin> v Para los tipos de archivos FILE, <ubicacin> es el nombre de archivo. El nombre de archivo puede ser sensible a maysculas y minsculas en algunos sistemas operativos. Especifique el nombre de acuerdo con los requisitos del sistema local donde se est ejecutando el proveedor de datos de archivo. Si el archivo supervisado existe en un directorio distinto de aquel donde se encuentra el archivo binario del proveedor de datos de archivo, deber calificar al completo el nombre de archivo. El nombre de archivo supervisado calificado al completo se puede especificar utilizando la letra de unidad o un nombre de va de acceso absoluto, o bien puede especificar el nombre de archivo Convenio universal de nomenclatura (UNC). Como regla, no es posible hacer una sustitucin de los parmetros simblicos o variables en el nombre de archivo. Debe escribir el nombre completo de archivo. Las siguientes excepciones se aplican a esta regla: 1. La funcin de nombre de archivo dinmico, que permite especificar un patrn de nombre de archivo. Consulte Soporte de nombres de archivo dinmicos en la pgina 46 para obtener informacin adicional. 2. La inclusin de una o ms variables de entorno, utilizando la sintaxis |$var_ent|, por ejemplo:
//SOURCE FILE |$SYSTEMROOT|\WindowsUpdate.log tail
3. El parmetro {LOCALHOST} que sustituye el nombre de host local en el nombre de archivo; por ejemplo:
//SOURCE FILE /opt/IBM/ITM/logs/{LOCALHOST}_um.inv tail
Si un nombre de archivo calificado al completo contiene cualquier espacio en blanco incorporado, rodee el nombre de archivo de comillas simples. v Para aquellas fuentes del tipo SOCK, la <ubicacin> es la direccin decimal separada por puntos de Internet o un nombre de host que pueda resolverse, seguido opcionalmente por un nmero de puerto, del script o programa cliente de socket que est funcionando como fuente de datos. Por ejemplo, sp2n03[4500] identifica una fuente de datos del host sp2n03, puerto 4500. No puede haber ningn espacio en blanco entre el valor de host y el nmero de puerto. Si se omite el nmero de puerto, se asumir que el primer programa cliente de socket que se conecte desde la ubicacin del host especificado. En general, el nmero de puerto slo es necesario si hay varios programas clientes de socket conectndose desde el mismo host a la misma aplicacin de metarchivo. Si se especifica un nombre de host pero no se puede resolver en una direccin, se omite la sentencia SOURCE. Es ms conveniente especificar localhost para designar que el cliente de socket se ejecuta en el mismo sistema que el proveedor de datos de socket; por ejemplo:
//SOURCE SOCK localhost
El uso de localhost permite implementar el mismo metarchivo de socket exacto en varios sistemas Universal Agent, sin tener que actualizar el parmetro de ubicacin //SOURCE SOCK en cada uno. v Para las fuentes de tipo ODBC, <ubicacin> es el nombre de la fuente de datos. Ya debe estar configurada en el applet de fuentes de datos ODBC en el sistema operativo Windows donde se ejecuta el proveedor de datos de ODBC. Si el nombre de fuente de datos contiene cualquier espacio en blanco, rodelo de comillas simples.
Apndice A. Sentencias de control de definicin de datos
141
v Para las fuentes de tipo SCRIPT, <ubicacin> es el nombre de archivo de script El nombre de archivo de script es sensible a maysculas y minsculas en algunos sistemas operativos. Especifique el nombre de acuerdo con los requisitos del sistema local donde se est ejecutando el proveedor de datos de script. Deber calificar al completo el archivo de script si no existen en el directorio de scripts de Tivoli Universal Agent. El nombre de archivo supervisado calificado al completo se puede especificar utilizando la letra de unidad o un nombre de va de acceso absoluta, o bien puede especificar el nombre de archivo de script utilizando el Convenio universal de nomenclatura (UNC). El nombre de archivo de script puede incluir una o ms variables de entorno, utilizando la sintaxis |$env_var|, para la sustitucin en tiempo de ejecucin, como en el siguiente ejemplo:
//SOURCE SCRIPT |$SYSTEMROOT|\scan.bat "arg1 arg2" Interval=60
Si el nombre de archivo calificado al completo contiene algn espacio en blanco, rodee el nombre de archivo de comillas simples. v Para fuentes de tipo SNMP, <ubicacin> es la direccin IP decimal con puntos o un nombre de host que puede resolverse, donde se ejecuta el agente SNMP. La sentencia //SOURCE SNMP nombreshost es opcional en los metarchivos SNMP. La nica razn por la que se utiliza es personalizar cmo se registran las aplicaciones SNMP con el servidor de supervisin y cmo se visualizan en el cliente del portal. Si incluye esta sentencia, el proveedor de datos de SNMP registra un sistema gestionado separado que empieza por el valor nombrehost, utilizando el formato nombrehost:NombreAplicVV. Registrar un sistema gestionado separado puede resultar til si, por ejemplo, recopila los mismos datos de aplicacin MIB de 10 servidores diferentes en la red y desea registrar 10 sistemas gestionados distintos (que incluyen el nombre de host del servidor especfico) y visualizarlos en el rbol de Navigator. Si se incluye la sentencia //SOURCE SNMP nombrehost y actualmente no recopila datos MIB de dicho host de agente SNMP, el sistema gestionado seguir registrndose y visualizndose en el rbol de Navigator, pero el espacio de trabajo de aplicacin asociado est vaco. Si se omite la sentencia //SOURCE SNMP nombrehost, se utiliza el convenio de nomenclatura del sistema gestionado predeterminado para las aplicaciones de metarchivo SNMP, que registra un sistema gestionado del formato NombreHostLocal:NombreAplicVV, independientemente de cuntos agentes SNMP se estn sondeando para dicha aplicacin determinada. Si se especifica nombrehost, pero no se puede resolver en una direccin, se omite la sentencia SOURCE. <argumentos-script> (opcional) Para aquellas fuentes del tipo SCRIPT, especifica uno o ms argumentos que pasar al script. Deber rodear todo el conjunto de argumentos del script en comillas dobles inmediatamente despus del nombre de archivo del script. Por ejemplo,
//SOURCE SCRIPT cscript.exe listfreespace.vbs "/S mihost /U miIDusuario"
De forma predeterminada, cada seal separada por un espacio en blanco dentro de las comillas dobles se trata como un argumento independiente. Si necesita agrupar una o ms seales separadas por espacios en blanco en un argumento, colquelas entre comillas simples, como en el ejemplo siguiente:
//SOURCE SCRIPT monitor.sh "aaa bbb ccc ddd"
<tipo-cdigo> (opcional) Especifica una de las siguientes representaciones de caracteres de los datos fuente. El valor predeterminado es ASCII.
142
A E
ASCII EBCDIC
Notas: 1. El parmetro <tipo-cdigo> slo es vlido para el tipo de fuente SOCK. Se ignora para el resto de tipos de fuente. 2. Si el <tipo-cdigo> de la fuente difiere de la representacin de datos donde se ejecuta el proveedor de datos de socket, el proveedor de datos convierte los datos de aplicacin que recibe en la representacin del sistema local. 3. Como alternativa al suministro de un valor de <tipo-cdigo>, tambin puede especificar un parmetro CODEPAGE en la sentencia SOURCE SOCKu Por ejemplo, si el programa cliente de socket se est ejecutando en una plataforma EBCDIC OS/390, puede especificar E para EBCDIC o la pgina de cdigos predeterminada del sistema principal. Por ejemplo,
//SOURCE SOCK MVSA CODEPAGE=ibm-37_P100-1995
<modalidad-archivo> (opcional) Especifica la modalidad de copia COPY, TAILBYRECORD, TAIL, TAILRESTART, TAILRESTARTFROMTOP o TAILBYCOUNT. Si no se especifica este parmetro, la modalidad TAIL es el valor predeterminado. COPY Indica que debe procesarse el archivo en modalidad de bloque. Cada vez que se sondea o muestrea el archivo, se lee el contenido completo del archivo como varias filas de datos. Si el contenido del archivo no se aprueba, se volvern a entrar los mismos registros de archivo. La modalidad de copia no es vlida para el tipo de datos de suceso. Esta modalidad no es tampoco apropiada para el tipo de datos con clave ya que anula el comportamiento de correlacionar filas de datos de los datos con clave. La modalidad de copia requiere que el archivo supervisado tenga un mnimo de dos filas de datos porque funciona en modalidad de bloque y necesita un registro inicial y otro final. En caso contrario, los datos no aparecern en Tivoli Enterprise Portal. TAILBYRECORD Indica que el archivo es acumulativo pero que la marca de final de archivo no cambia. En su lugar, se comprueba el nmero total de registros en cada intervalo de muestreo para determinar cuando se aaden nuevos registros. Consulte Espacio de archivo preasignado en la pgina 49 para obtener informacin adicional sobre los tipos de archivos que conviene utilizar con TailByRecord. TAIL Indica que el archivo es acumulativo. En cada intervalo de muestreo, slo los registros nuevos aadidos al final del archivo se procesan como entrada.
TAILRESTART Indica que debe supervisarse el archivo en modalidad TAIL, pero que se mantiene un archivo de reinicios en el directorio de trabajo de Tivoli Universal Agent. Para garantizar la exclusividad, el nombre de archivo de reinicio utiliza el siguiente convenio de nomenclatura:
<NombreAplic>_<NombreTabla>_<NombreFuente>.rst
donde: <NombreAplic> Especifica el valor de la sentencia del metarchivo //APPL. <NombreTabla> Especifica el valor en la sentencia //NAME del metarchivo. <NombreFuente> Especifica el nombre del sistema gestionado asociado con la fuente de datos de archivo.
143
Cada vez que se aaden nuevos registros al archivo supervisado y su tamao de archivo aumenta, el proveedor de datos de archivo almacena el valor del tamao actualizado en el archivo de reinicio junto con el nombre del archivo, fecha de creacin del archivo y la hora de la ltima modificacin. Si se detiene y vuelve a iniciar la supervisin del archivo por cualquier motivo, el proveedor de datos de archivo compara el tamao de archivo actual con el valor del tamao almacenado en el archivo de reinicio. Si el tamao ha aumentado, el proveedor de datos de archivo procesa el delta entre los dos tamaos como si los registros se hubiesen aadido mediante un proceso de TAIL corriente. Utilice TailRestart si est supervisando un archivo crtico, como un registro de transacciones o de auditora, y es vital que no pierda ningn registro de archivo, incluso si se recicla Tivoli Universal Agent. Nota: Para TailRestart, cada nuevo registro aadido al archivo supervisado requiere que la entrada y la salida reinicien el archivo, lo que implica una sobrecarga adicional del sistema, por lo que TailRestart probablemente no sea una buena eleccin en todos los casos de supervisin de archivos. TAILRESTARTFROMTOP Idntico TailRestart excepto en que maneja las discrepancias cuando comienza la supervisin de archivo. Una discrepancia se define como una divergencia entre la informacin actual acerca del archivo supervisado y la informacin almacenada en el archivo de reinicio. Los siguientes son dos ejemplos de discrepancias: v El nombre del archivo o la fecha de creacin del archivo han cambiado v El tamao de archivo actual es menor que el tamao almacenado en el archivo de reinicio v La hora de la ltima modificacin es anterior a la hora de la ltima modificacin almacenada en el archivo de reinicio Si se identifica alguno de estos tipos de discrepancias en la modalidad TailRestart, no se utilizar el archivo de reinicio ya que las discrepancias indican que el archivo supervisado se ha alterado y, por lo tanto, el proveedor de datos de archivo no puede tener certeza de la exactitud de la informacin del archivo de reinicio. En este caso, se crea un nuevo archivo de reinicio y se activa la modalidad TailRestart normal. Si se especifica TailRestartFromTop, se est indicando que desea que el proveedor de datos de archivo maneje una discrepancia detectada durante el arranque, como una conmutacin de archivo, lo que hace que la supervisin se reinicie desde el principio del archivo. TAILBYCOUNT Indica que debe supervisarse el archivo en modalidad TAIL, pero que deben procesarse un nmero fijo de registros anteriores cuando se inicie la supervisin del archivo. Este parmetro debe ir seguido del parmetro <nmero-de-registros-archivo>. <nmero-de-registros-archivo> (opcional) Slo vlidos para aquellas fuentes de tipo FILE que estn utilizando la modalidad TailByCount. Deber utilizar un entero entre 1 y 5000 para este parmetro. Indica el nmero de registros de archivo anteriores a procesar cuando comience la supervisin del archivo. El proveedor de datos del archivo utiliza este parmetro para contar hacia atrs el <nmero-de-registros-archivo> desde el final del archivo. Dichos registros se procesan como si se hubiesen acabado de aadir al final del archivo. <mtodo-comparacin-archivos> (opcional) Slo es vlido para fuentes de tipo FILE que utilizan la funcin de nombre de archivo dinmico. Si hay un par de archivos en un directorio que cumple un criterio de patrn determinado, y si siempre desea supervisar el mayor de los dos archivos, especifique el parmetro CompareBySize como el <mtodo-comparacin-archivos>. Y viceversa, si siempre
144
desea supervisar el archivo actualizado ms recientemente de los dos archivos, especifique el parmetro CompareByLastUpdate. Consulte Soporte de nombres de archivo dinmicos en la pgina 46 para obtener informacin adicional. User= (opcional) Especifica un ID de usuario que conecta la fuente de datos de ODBC o ejecuta el script. Este parmetro slo es vlido para los tipos de fuente ODBC y SCRIPT. Se ignora para el resto de tipos de fuente. Si se han definido varios ID de usuarios en la fuente de datos de ODBC, seleccione un ID de usuario con suficiente autoridad como para realizar las selecciones de tabla especificadas en la sentencia //SQL. Pswd= (opcional) Especifica la contrasea a utilizar con el parmetro user= asociado cuando se est conectando con la fuente de datos de ODBC o ejecutando el script. Este parmetro slo es vlido para los tipos de fuente ODBC y SCRIPT. Se ignora para el resto de tipos de fuente. Debe anteponer al parmetro pswd= un parmetro user=. Por ejemplo,
//SOURCE ODBC SAMPLE user=db2admin pswd=tivoli
Database= (opcional) Indica un contexto de base de datos especfico para que los parmetros user= y pswd= se conecten. Este parmetro slo es necesario para aquellos productos de base datos que soporten con varias asociaciones de bases de datos para una nica fuente de datos. Proporcione este parmetro si desea conectarse a un contexto de base de datos distinto del predeterminado. Este parmetro slo es vlido para el tipo de fuente ODBC y se ignora para el resto de tipos de fuente. El siguiente es un ejemplo que utiliza el parmetro database=:
//SOURCE ODBC teps2 user=db2admin pswd=tivoli database=pubs
Server= (opcional) Especifica el nombre del servidor utilizado con el parmetro database= asociado. Este parmetro slo es necesario si la base de datos/servidor de conexin predeterminada no es apropiada para las tablas de usuario a las que desea acceder. Este parmetro slo es vlido para el tipo de fuente ODBC y se ignora para el resto de tipos de fuente. Maxrows= (opcional) Especifica el nmero mximo de filas procesadas por el proveedor de datos de ODBC despus de ejecutar la sentencia Select o procedimiento almacenado listado en la sentencia //SQL. El siguiente ejemplo le dice al proveedor de datos de ODBC que procese hasta 1000 filas para este grupo de atributos. El valor predeterminado de maxrows= es 100. Puede hacer un cambio global con la variable de entorno KUMP_ODBC_MAX_ROWS. El parmetro maxrows= slo es vlido para el tipo de fuente ODBC. Se ignora para el resto de tipos de fuente.
//SOURCE ODBC teps2 user=Admin pswd=xyz maxrows=1000
Si se devuelven ms filas del lmite de maxrows de la sentencia Select de SQL del metarchivo, slo se utilizarn las primeras filas <nnn> hasta alcanzar dicho lmite para la visualizacin de espacios de trabajo y la evaluacin de situaciones. Es un punto importante a recordar. Si tiene una situacin con respecto a una tabla de ODBC que no se est activando cuando debera, puede que signifique la fila o filas que hacen que la situacin se active vienen despus del lmite de maxrows. Las siguientes son soluciones posibles a este problema: v Aumente el valor de maxrows para dicha tabla en particular utilizando maxrows=<nnn>. v Utilice KUMP_ODBC_MAX_ROWS para cambiar el valor de maxrows globalmente para que maxrows se lo suficientemente grande para manejar el nmero de filas devueltas. Este cambio requiere que se reinicie un sistema Universal Agent. v Utilice una clusula Where ms calificada en la sentencia Select de SQL para que el nmero de filas devueltas se ajuste al lmite de maxrows actual. La desventaja de aumentar maxrows a un nmero muy superior para manejar grandes volmenes de datos de tablas SQL devueltos es la mayor sobrecarga del sistema causada por almacenar todas esas filas en la memoria de Universal Agent hasta que el valor de tiempo de vida haya
Apndice A. Sentencias de control de definicin de datos
145
caducado. Por lo tanto, es necesario encontrar un equilibro entre establecer maxrows lo suficientemente alto como para procesar todas las filas que sean de inters y tambin lo suficientemente bajo como para no colocar una carga innecesaria sobre la memoria y la CPU en Universal Agent. Locale= (opcional) Permite especificar que la fuente de datos en la sentencia SOURCE est proporcionando datos en un idioma distinto del idioma predeterminado del sistema en el que se est ejecutando Tivoli Universal Agent. De acuerdo con el estndar Unicode>, los valores de entorno local se especifican de la siguiente manera:
<Idioma>_<Territorio>.Codeset@Modifiers
donde: <Idioma> Especifica el cdigo de idioma de dos o tres caracteres. Por ejemplo, en o ja. <Territorio> Especifica el cdigo de regin o pas. Por ejemplo, US o JP. En general, slo es necesario especificar el <Territorio_Idioma> en el parmetro Locale. Opcionalmente puede proporcionar el valor de Codeset@Modifiers para indicar el conjunto de caracteres codificados a utilizar junto con una o mas de los modificadores de palabras_clave=<valor. Por ejemplo,
ISO-8859-15.im=INPUT-METHOD-NAME
El valor de <Codepage> en el parmetro Locale= es similar al parmetro Codepage= en la sentencia SOURCE. No es necesario especificar el valor en ambos lugares Codepage= (opcional) Permite especificar que la fuente de datos en la sentencia SOURCE est proporcionando datos en una pgina de cdigos distinta de la pgina de cdigo predeterminada del sistema donde se est ejecutando Tivoli Universal Agent. Algunos valores tpicos de Codepage son UTF-16BE, ISO-8859-15, GB-2312, windows-1252 y ibm037. Por ejemplo, si el proveedor de datos de socket se est ejecutando en un sistema que no es japons, pero recibe datos de un programa cliente de socket ejecutndose en un sistema japons, puede especificar lo siguiente:
//SOURCE SOCK Host1 locale=ja_JP codepage=ibm-943_P15A-2003
Envfile= (opcional) Permite especificar una o ms variables de entorno a establecer cuando se ejecuta un script. El parmetro envfile= slo es vlido para el tipo de fuente SCRIPT. Se ignora para el resto de tipos de fuente. El siguiente es un ejemplo de la codificacin de envfile:
//SOURCE SCRIPT 79001.bat "/temp 10" envfile=C:\endpoint\79001.env
La primera vez que se va a ejecutar un script, el proveedor de datos de script lee el contenido de envfile en la memoria y pasa los valores de configuracin de la variable de entorno al proceso del script Antes de cada ejecucin del script, el proveedor de datos de script comprueba la indicacin de la hora de la ltima modificacin de envfile. Si se ha modificado, el proveedor de datos de script vuelve a leer el contenido de envfile en la memoria, y utiliza los valores de la nueva variable de entorno para la ejecucin del script siguiente. En caso contrario se utilizarn los valores ledos anteriormente. Como envfile se comprueba antes de cada ejecucin del script, puede modificar el contenido de envfile mientras el script est activo y los cambios se incluirn en la siguiente ejecucin del script sin que sea necesario renovar el metarchivo o reciclar Tivoli Universal Agent.
146
Notas: 1. El nombre de envfile es sensible a maysculas y minsculas en algunos sistemas operativos. Especifique el nombre de archivo de acuerdo con los requisitos del sistema local en el que se est ejecutando el proveedor de datos de script. 2. Puede utilizar cualquier nombre o extensin de archivo para el nombre de envfile. El proveedor de datos de script no espera ningn convenio de nomenclatura. 3. Si el nombre de envfile calificado al completo contiene cualquier espacio en blanco, rodee el nombre de archivo de comillas simples. 4. Si el nombre envfile se especifica sin informacin completa de nombre de va de acceso, se supone que la ubicacin predeterminada es el directorio de script en Tivoli Universal Agent. 5. Las variables de entorno establecidos en envfile slo se aplican al proceso de script iniciado. Por ejemplo, si existe una configuracin especial de PATH que el script necesite, podr aadirla al archivo envfile para dicho script y no alterar as el valor de PATH de otros scripts que se estn ejecutando. Adems, no afecta al valor de PATH del proceso de Tivoli Universal Agent. 6. Las variables de entorno se codifican en el archivo envfile en una serie de sentencias VARIABLE=<valor>, una por lnea. Por ejemplo,
ENDPOINT_CLASS=ENDPOINT LCF_DATDIR=C:\endpoint\dat\1 LCF_BINDIR=C:\endpoint\bin\w32-ix86\mrt
Runtime= (opcional) Permite asignar tiempo adicional de ejecucin a un script de larga ejecucin. De forma predeterminada, el proveedor de datos de script otorga a un script un mximo de 60 segundos solamente en completarse. Cualquier script que exceda el lmite de tiempo de 60 segundos termina para impedir una acumulacin gradual de procesos de script que se encuentran en un bucle sin fin o una espera indefinida. Si a veces un script tarda ms de 60 segundos en finalizar una ejecucin tpica, puede otorgar al script tiempo adicional especificando un parmetro Runtime=nnn, donde nnn es el nmero de segundos. El parmetro Runtime= slo es vlido para el tipo de fuente SCRIPT. Este parmetro se ignora para los otros tipos de fuente. En el siguiente ejemplo se muestra cmo codificar el parmetro Runtime:
//SOURCE SCRIPT avail_media.sh Runtime=200 Interval=300
Tenga presente que si establece un valor de Runtime en ms de 60 segundos, tambin deber ajustar el parmetro Interval=nnn de forma acorde, para que el valor de Interval del script sea mayor o igual al valor de Runtime. Interval= (opcional) Permite especificar el intervalo de muestreo en segundos que se utiliza para la recopilacin de datos del grupo de atributos. El valor de intervalo mnimo permitido es de 30 segundos. Este parmetro slo es vlido para los metarchivos del proveedor de datos de script y de ODBC. Por ejemplo,
//SOURCE ODBC testSource Interval=120
El propsito del parmetro Interval en la sentencia SOURCE es alterar temporalmente el parmetro Interval en la sentencia NAME. Si se especifica el parmetro Interval en las sentencias NAME y SOURCE, el valor de SOURCE tiene preferencia. Slo debe especificar habitualmente este parmetro si tiene varias sentencias //SOURCE SCRIPT o //SOURCE ODBC codificadas para un slo grupo de atributos, utilizando un valor exclusivo ManagedSystemName para cada una y desea implementar un intervalo de muestreo diferente para cada fuente de datos. De lo contrario, utilice la especificacin Interval en la sentencia NAME. SetSourceName=Y/N (opcional) Si se establece en Y (S), indica que el programa cliente de socket altera temporalmente la parte del nombre de host del sistema gestionado cuando el programa cliente de
147
socket se conecta. Este parmetro slo es vlido para el tipo de fuente SOCK. Se ignora para el resto de tipos de fuente. De forma predeterminada, el siguiente es el nombre de sistema gestionado de una aplicacin socket:
<NombreHost:NombreAplicVV>
NombreHost en este contexto es sinnimo del nombre de fuente. Si desea alterar temporalmente este fragmento del nombre de sistema gestionado a un valor ms significativo para la aplicacin de socket, debe aadir un parmetro SetSourceName=Y en la sentencia //SOURCE SOCK, y a continuacin enviar un registro //SETSOURCENAME=xxxxxx al proveedor de datos de socket despus del que el programa cliente se conecte. xxxxxx se utiliza cuando se construye y se registra el sistema gestionado. Consulte Nombres de sistemas gestionados de aplicaciones del proveedor de datos de socket en la pgina 102 para obtener ms informacin. RunOnce=Y/N (opcional) Si se establece en Y, indica que el proveedor de datos de script especificado slo ejecuta una vez el script especificado. Cuando el script se completa, el sistema gestionado asociado permanece en lnea en TEMS (Tivoli Enterprise Monitoring Server o servidor de supervisin) y TEPS (Tivoli Enterprise Portal Server o servidor del portal) durante un tiempo limitado, basndose en el valor de TTL especificado en la sentencia //NAME. Si ms adelante necesita ejecutar de nuevo este script, debe renovar el metarchivo de script o reiniciar Tivoli Universal Agent. El parmetro RunOnce slo es vlido para el tipo de fuente SCRIPT. Se ignora para el resto de tipos de fuente. Normalmente, debe aadir un parmetro RunOnce=Y para un script especial que realiza algn tipo de actividad de configuracin que tiene que realizarse solamente una vez, inicializando un entorno en tiempo de ejecucin para otros scripts, creando un directorio temporal o habilitando la supervisin adicional. HostAddr= (opcional) Cada sistema gestionado registrado incluye informacin HOSTADDR, que se inserta en la tabla Estatus del nodo TEMS. La columna HOSTADDR suele contener el protocolo de comunicaciones y la direccin de red del agente que ha registrado el sistema gestionado. El servidor del portal utiliza HOSTADDR y Tivoli Enterprise Console para ayudar a identificar el agente que est asociado a un sistema gestionado especfico. De forma predeterminada, Universal Agent llena el valor HOSTADDR con la direccin IP y nombre de sistema del sistema local donde se ejecuta Universal Agent. Si desea personalizar este valor para una aplicacin de Universal Agent; por ejemplo, para utilizar el nombre de host de un programa cliente de socket remoto como el valor HOSTADDR registrado, puede especificar un parmetro HostAddr= como en la siguiente sentencia SOURCE:
//SOURCE SOCK 192.118.25.3 HostAddr=Linux01
HostInfo= (opcional) Al igual que con HOSTADDR, tambin hay una columna HOSTINFO en la tabla Estatus de nodo TEMS. Sin embargo, la columna HOSTINFO no es necesaria para cada sistema gestionado. Cuando existe HOSTINFO, se utiliza para identificar la plataforma del SO del agente que ha registrado el sistema gestionado; por ejemplo, HP-UX o WinXP. (Nota: la lista de nombres de plataformas soportados se puede encontrar en el archivo osnames que est instalado con Tivoli Enterprise Portal Server). Si desea especificar un valor HOSTINFO para una aplicacin de Universal Agent; por ejemplo, para designar una plataforma del SO de un programa cliente de socket remoto, puede especificar un parmetro HostInfo= como en la siguiente sentencia SOURCE:
//SOURCE SOCK elsun01 HostInfo=SunOS
ManagedSystemName= (opcional) Permite especificar varias fuentes para datos de tipo FILE, SOCK, ODBC, SCRIPT, SNMP o TRAP, identificando de forma exclusiva cada fuente de datos. Por ejemplo, en la siguiente definicin de metarchivo:
148
//APPL MVS //NAME SYSTEM //SOURCE FILE //SOURCE FILE //SOURCE FILE
procesa tres archivos distintos que todos tienen el mismo formato de atributo bajo el grupo de atributos SYSTEM. El metarchivo resulta en la creacin de tres sistemas gestionados: Boston:MVS00 Chicago:MVS00 LosAngeles:MVS00 El parmetro ManagedSystemName ofrece los siguientes beneficios: v Reduce el nmero de situaciones que debe definir. Si cada uno de los tres archivos supervisados en los ejemplos anteriores tiene su propia sentencia //NAME. deben definirse tres situaciones separadas. Pero con este formato, se puede definir una sola situacin y distribuirse a los tres sistemas gestionados. v No es necesario crear varias sentencias de definicin //NAME y //ATTRIBUTES para diferentes instancias de los mismos datos de entrada, permitiendo as que un metarchivo sea ms conciso. No es posible tener dos valores de ManagedSystemName idnticos en el mismo grupo de atributos. Mediante valores exclusivos de ManagedSystemName, se permite que el proveedor de datos identifique de forma correcta a qu fuente pertenecen los datos de entrada. Por ejemplo, el siguiente metarchivo es incorrecto:
//APPL MVS //NAME SYSTEM //SOURCE FILE //SOURCE FILE
/home/logs/abc.log /home/logs/xyz.log
tail tail
ManagedSystemName=Boston ManagedSystemName=Boston
Para mantener exclusivas las fuentes de varios archivos, los valores de ManagedSystemName deben ser exclusivos.
149
Sintaxis
//INTERNAL [INPUT | OUTPUT] nombre-simblico
Parmetros
Sentencia OUTPUT
La sentencia INTERNAL OUTPUT define la fuente de la redireccin de datos. Slo puede identificar un grupo de atributos de fuente por cada redireccin mediante el nombre simblico. Todas las fuentes de datos de aplicacin son soportadas como programa de archivo, de socket o de API. Los datos del grupo de atributos son aptos para la redireccin despus de pasar todos los filtros de atributos definidos. ste es un punto importante que hay que recordar y por qu generalmente el usuario desea que el primer grupo de atributos de metarchivo, tanto si son invisibles como no, lea todos los datos sin ningn filtro aplicado.
Sentencia INPUT
La sentencia INTERNAL INPUT define el destino de la redireccin de datos. Est soportado tener varios grupos de atributos de destino partiendo una salida de fuente redireccionada. No obstante, un grupo de atributos de destino no puede l mismo ser la fuente de otra redireccin. Tivoli Universal Agent redirecciona los datos de un grupo de atributos exactamente como si hubieran llegado de una fuente de datos estndar como un archivo, socket, programa API o agente SNMP. Todas las caractersticas y servicios de Tivoli Universal Agent se encuentran disponibles, incluidos los filtros. En el siguiente ejemplo, se lee una vez el archivo de registro de detalles de la reclamacin. Los registros de archivo se redireccionan a dos definiciones de grupos de atributos siguientes, ClaimInquiry y ClaimRequest, para su posterior procesamiento.
//NAME TransactionLog e //SOURCE FILE /users/Claim/DETAILS.log //INTERNAL OUTPUT ClaimDetailRec //ATTRIBUTES , RecData R 4096 * //NAME ClaimInquiry e AddTimeStamp //INTERNAL INPUT ClaimDetailRec //ATTRIBUTES , RecType D 1 -FILTER={MATCH(0,3)} ClaimID C 9999 ClaimType C 99 CustomerSSN D 9 . . . . . . . . . . . . . . . *
150
//NAME ClaimRequest e //INTERNAL INPUT ClaimDetailRec //ATTRIBUTES , RecType D 1 -FILTER={MATCH(0,2)} CustomerName D 64 CustomerSSN D 9 CustomerAddr D 100 . . . . . . . . . . . . . . .
En el siguiente ejemplo, el registro del servidor de Internet es el primero en ser procesado por el grupo de atributos WEB_W3C_Log. Selecciona los datos excluyendo los registros de archivo sin ubicacin de cliente o contenido de solicitud, o sin datos que transferir. Los registros de archivo seleccionados se pasan entonces a los grupos de atributos Error_STAT y DataTransfer_STAT. Error_STAT slo est interesado en cdigos de error mayores que 200 y algunos atributos seleccionados. Todos los dems atributos se definen como de tipo SKIP (tipo de atributo K) de modo que no son visibles para el usuario final. El grupo de atributos DataTransfer_STAT muestra los bytes intercambiados entre el cliente y el servidor. Slo est interesado en la identidad del cliente, solicitudes y el nmero de bytes. Se definen dos atributos derivados adicionales para mostrar el nmero total de bytes y el porcentaje de datos de entrada del nmero total de datos. Dichos atributos derivados son TotalBytes y PercentReceived.
//NAME WEB_W3C_Log e //SOURCE FILE d:\web\server.log tail //INTERNAL OUTPUT InternetLog //ATTRIBUTES , ClientLocation D 32 -FILTER={MATCH(0,-)} ClientUserName D 32 Date D 12 Time D 12 Service D 32 ComputerName K 64 ServerAddress D 32 RequestElapsedTime C 99999999 BytesReceived C 99999999 FILTER={NUMBER<=(0,0)} BytesSend C 99999999 ServiceStatus C 99999999 WindowsStatus C 99999999 OperationName D 32 OperationObject D 256 -FILTER={MATCH(0,-)} RequestParameters D 256 * //NAME Error_STAT e //INTERNAL INPUT InternetLog //ATTRIBUTES , ClientLocation D 32 SkipField1 K Date D 12 Time D 12 Service D 32 SkipField2 K SkipField3 K SkipField4 K SkipField5 K SkipField6 K ServiceStatus C 99999999 FILTER={NUMBER=(0,200)} WindowsStatus C 99999999 OperationName D 32 OperationObject D 256 RequestParameters D 256 *
Apndice A. Sentencias de control de definicin de datos
151
//NAME DataTransfer_STAT e //INTERNAL OUTPUT InternetLog //ATTRIBUTES , ClientLocation D 32 SkipField1 K Date D 12 Time D 12 Service D 32 SkipField1 K SkipField2 K SkipField3 K BytesReceived C 99999999 BytesSend C 99999999 TotalBytes (BytesReceived + BytesSend) PercentReceived (BytesReceived % TotalBytes) SkipField4 K SkipField5 K SkipField6 K OperationObject D 256 *
152
Sintaxis
Formato A: patrn delimitador de final de registro
//RECORDSET patrn_delimitador
Parmetros
<parmetro_delimitador> Especifica el patrn para el final de un conjunto de registros. El delimitador debe estar rodeado por comillas simples ( ). Los datos que excedan el tamao de atributo definido se truncarn hasta alcanzar el tamao definido. El delimitador de final de registro se utiliza nicamente para delimitar un conjunto de registros y se descartar. No debe contener datos vlidos de atributos. El ejemplo 1 muestra la definicin de un grupo de atributos llamado ERRORLOG, utilizando el delimitador de conjunto de registros. En este caso, el proveedor de datos lee y concatena todos los registros de archivo hasta que encuentre 1) un registro que contenga el patrn delimitador especificado (diez guiones), o 2) la condicin de final de archivo.
//NAME ERRORLOG E //SOURCE FILE C:\error.log tail //RECORDSET ---------- //ATTRIBUTES NONE Error_Message R 2048
El ejemplo 2 muestra la definicin de un grupo de atributos llamado CONSOLELOG, en el que un punto y coma (;) delimita los atributos. En este ejemplo, el proveedor de datos lee varios registros para extraer los valores de cinco atributos definidos hasta que realiza una de las siguientes acciones: v Encuentra un patrn de final de registro v Rellena los cinco atributos v Alcanza la condicin de final de archivo.
153
//NAME CONSOLELOG E //SOURCE FILE C:\console.log tail //RECORDSET ---------- //ATTRIBUTES ; Message_Date D 12 Message_Time D 8 Message_ID D 8 Message_Text D 512 Message_Action D 512
<nmero_mximo_registros> Indica el nmero mximo de registros que el proveedor de datos lee en un conjunto de registros. El valor ms amplio que se puede especificar para un nmero mximo de registros es 32767. En el ejemplo 3, el grupo de atributos APPLALERT slo contiene un atributo de tipo R para Registro. El proveedor de datos lee y concatena todos los registros de archivo hasta un mximo de 4 o hasta que alcance el final del archivo, lo que suceda primero.
//NAME APPLALERT E //SOURCE FILE C:\alert.log tail //RECORDSET 4 //ATTRIBUTES NONE Alert_Description R 2048
En el ejemplo 4, el proveedor de datos utiliza el delimitador de archivo (un espacio en blanco) para extraer los valores de los siete atributos leyendo los registros de archivo hasta haber realizado una de las siguientes acciones: v Ha ledo cuatro registros v Ha rellenado los siete atributos v Alcanzar el final del archivo
//NAME NETALERT E //SOURCE FILE C:\net.log tail //RECORDSET 4 //ATTRIBUTES Alert_Date D 12 Alert_Time D 8 Alert_ID D 16 Alert_Type C 99 Alert_Severity C 99 Alert_Origin D 64 Alert_Text D 256
<mximo de registros y regla de identificacin> Especifica el nmero mximo de registros en el conjunto de registros y una regla para identificar el inicio o el final del conjunto. La regla de identificacin define el desplazamiento en una fila de salida estndar de registro de archivo o script, el operador de comparacin (igual [==] o no igual [!=]) y la cadena de comparacin. El registro delimitador se considera como parte del conjunto de registros y no se descarta. La palabra clave NEW indica una regla para iniciar u conjunto de registros. En este caso, el proveedor de datos procesa los registros desde la posicin actual del archivo hasta, pero sin incluir, el registro que satisfaga el criterio de comparacin, o hasta que se produzca una de las siguientes situaciones: v Se ha procesado el nmero mximo especificado de registros v Se han rellenado todos los atributos v Se ha alcanzado el final de archivo o el almacenamiento intermedio de salidas estndar
154
La palabra clave END indica una regla para el final del conjunto de registros. En este caso, el proveedor de datos procesa registros desde la posicin de archivo actual hasta e incluido el registro que satisfaga el criterio de comparacin, o hasta que suceda una de las siguientes opciones: v Se ha procesado el nmero mximo especificado de registros v Se han rellenado todos los atributos v Se ha alcanzado el final de archivo o el almacenamiento intermedio de salidas estndar En la definicin de datos del ejemplo 5, un conjunto de registros consiste en un mximo de 100 filas de salida de script y cada conjunto de registros nuevo se identifica con una serie de guiones. Las cadenas de valores de mximo de fila, regla de comparacin y delimitador de atributos en este metarchivo se obtienen examinando la salida de un mandato errpt -a en un sistema AIX.
//APPL ERRPT //NAME AIX_ERRPT K 600 Interval=180 //SOURCE SCRIPT /usr/bin/errpt "-a" //RECORDSET 100 NEW(0,==,----------------) //ATTRIBUTES Label D 24 DLMSTRBGN=LABEL: DLMSTREND=IDENTIFIER: Identifier D 16 DLMSTR=Fecha/hora: Date D 32 DLMSTR=Nmero de secuencia: SeqNumber N 8 KEY DLMSTR=ID de mquina: MachineID D 16 DLMSTR=ID de nodo: NodeID D 16 DLMSTR=Clase: Class D 16 DLMSTR=Tipo: Type D 24 DLMSTR=Nombre de recurso: ResourceName D 24 DLMSTR=Descripcin Description D 64 DLMSTR=Causas probables ProbableCauses D 64 DLMSTR=Acciones recomendadas RecommendedActions D 256 DLMSTR=Datos detallados DetailData Z 512
En la definicin de datos del ejemplo 6, un conjunto de registros consiste entre uno y veinte registros de archivo, y cada conjunto de registros nuevo se identifica por un carcter que no est en blanco en el desplazamiento 0. Tal como se puede ver en los siguientes registros de archivo de muestra, cada nuevo conjunto de registros empieza por la fecha. Como no hay delimitador de atributos, se leen todos los registros hasta la siguiente fecha en el atributo Status_Record.
//NAME STATUS_LOG E //SOURCE FILE C:\status.log tail //RECORDSET 20 NEW(0,!=, ) //ATTRIBUTES NONE Status_Record R 2048 Sat Jun 29 18:47:41 2002 Msg #UM12751 Entering UPDATE Mode Sat June 29 18:47:41 2002 Msg #UM1202E Error in parameter file FIX: See additional messages. (0,2) STATUS.DAT No such file or directory Sat Jun 29 18:47:42 2002 Msg #KA3129E Error occurred while testing for remote initiation Msg #KA1709E Error occurred during a GET ALLOCATE verb There was an error checking for a remote request of UPDATE functions. FIX: (OS/2 or Windows) Verify that you have configured for remotely attachable programs correctly. Primary return code = f0040000
155
KEY KEY
Si una definicin de atributo especifica los delimitadores iniciales y finales como se muestra en la siguiente definicin:
//APPL NewClass //NAME CHILD_PSYCHOLOGY221 K //SOURCE FILE C:\psy221.log //RECORDSET 4 //ATTRIBUTES @; First_Name D 24 KEY Last_Name D 24 KEY Grade D 1 Telephone D 14
156
Sintaxis
tipo_confirmacin //CONFIRM
Parmetros
<tipo_confirmacin> Especifica uno de los siguientes tipos de confirmacin requerida: SIZE SEQ El proveedor de datos reconoce la recepcin de los datos devolviendo la longitud de datos como un entero sin signo de 32 bits, en orden de bytes de red. El proveedor de datos reconoce la recepcin de los datos devolviendo el nmero de secuencia de registro de datos como un entero sin signo de 32 bits, en orden de bytes de red. Para cada nueva conexin TCP o nuevo intercambio UDP, el nmero de secuencia comienza desde uno y se reinicia.
X<nn> El proveedor de datos reconoce la recepcin de los datos enviando el carcter hexadecimal <nn>. Por ejemplo, X70. <mensaje> El proveedor de datos reconoce la recepcin de los datos enviando la cadena de caracteres del mensaje. Debe delimitar el mensaje por comillas simples. Por ejemplo, Datos recibidos. Si el programa cliente y el proveedor de datos estn en sistemas distintos, el proveedor de datos convierte el mensaje al formato del sistema del cliente antes de la transmisin.
157
Sintaxis
//SQL [sentencia Select] [proc=procedimiento almacenado]
Parmetros
<Sentencia Select> Especifica una sentencia Select de SQL de cualquier tipo o formato que est soportada por la fuente de datos a la que se accede; por ejemplo,
//SQL Select * from sysxlogins
Aunque este ejemplo utiliza una sentencia Select simple, no hay nada que impida explotar caractersticas adicionales de SQL, como ORDER BY, GROUP BY, Selects anidados, funciones incorporadas, etc. Puede seleccionar columnas individuales as como columnas de varias tablas. Puede utilizar cualquier sintaxis de Select en un metarchivo de ODBC siempre y cuando el controlador de ODBC d soporte a la funcin. En la mayora de los casos, los controladores de ODBC dan soporte a toda la sintaxis de consulta SQL estndar. El analizador del metarchivo de Tivoli Universal Agent no examina en contenido de la sentencia //SQL Select en busca de posibles errores de sintaxis. La cadena incluida en la sentencia se pasa al controlador ODBC y es el controlador de software el que hace el trabajo de analizar la sentencia y prepararla para el tiempo de ejecucin. Una consecuencia de este mtodo es que si existen errores de sintaxis en la sentencia //SQL Select, no se detectarn hasta que el metarchivo de ODBC se haya importado y el proveedor de datos de ODBC haya realizado el primer intento de ejecutar la sentencia. En ese momento, los errores de sintaxis se graban en el registro RAS1 de Tivoli Universal Agent. Adems, compruebe la sentencia Select mediante una herramienta de consulta ad hoc SQL o el programa de utilidad de la lnea de mandatos antes de insertarla en el metarchivo. <proc=procedimiento almacenado> En lugar de una sentencia Select, puede especificar un procedimiento almacenado que ejecuta una SQL Select con respecto a la fuente de datos a la que se est accediendo. Notas: 1. Si el nombre de procedimiento almacenado contiene cualquier espacio en blanco, deber ir entre comillas simples. 2. Si existen parmetros de entrada para el procedimiento almacenado, debern ser seales separadas por espacios en blanco despus del nombre de procedimiento almacenado. 3. Para ayudar a distinguir entre parmetros de cadena y de entero, debe utilizar comillas dobles para delimitar los parmetros de cadena y no utilizar ninguna comilla para los parmetros de tipo entero; por ejemplo:
//SQL Select proc=SP0001 "ABC" "ITM" 4 557
158
Sintaxis
//SUMMARY [<intervalo>] [Force] nombre-atributo tipo-atributo tamao mximo SKEY=n
Parmetros
<intervalo> Especifica el periodo de resumen en segundos. El valor de El intervalo mnimo es de 60 (1 minuto) y el valor de intervalo mximo es de 86400 (1 da). Se utilizar el valor predeterminado de 300 si no se especifica ningn intervalo. Force (opcional) Permite ver siempre una fila de resumen en cada intervalo, independientemente de si se han recopilado nuevos datos durante dicho intervalo. El valor de intervalo especificado en la sentencia //SUMMARY se utiliza para determinar cundo grabar como salida una nueva fila de datos al grupo de atributos de resumen. No obstante, si no se recopilan nuevos datos durante un intervalo de resumen, no se aadir una fila al grupo de atributos de resumen para dicho
Apndice A. Sentencias de control de definicin de datos
159
intervalo. El comportamiento predeterminado de la caracterstica de resumen es orientado a datos en lugar de orientado a intervalos. A continuacin se muestra un ejemplo de la utilizacin del parmetro Force:
//SUMMARY 900 Force
Esta sintaxis de metarchivo quiere decir que se graba como salida una nueva fila en el grupo de atributos de resumen cada 15 minutos, incluso si la fila contiene ceros como ocurrencias y otros atributos de resumen. SKEY=<n> Identifica un atributo como una clave de clasificacin de resumen. El nmero de secuencia <n> especifica el orden de clasificacin (como 1, 2, 3 para el primero, segundo y tercero). Puede convertir cualquier atributo de visualizacin o numrico en una clave de clasificacin de resumen. Un grupo de atributos puede no incluir ninguna clave de clasificacin o claves de clasificacin que representen todos los atributos del grupo de atributos. Un grupo de atributos sin una definicin de clave de clasificacin slo es resumido por el intervalo LocalTimeStamp. La salida consiste en una fila de datos por intervalo de resumen. Un grupo de atributos con claves de clasificacin es resumido por el intervalo LocalTimeStamp y se divide en cada clave de clasificacin. Su salida incluye tantas filas como combinaciones de claves de clasificacin haya por intervalo de resumen.
Ejemplo 1
El siguiente metarchivo de ejemplo especifica un resumen de solicitud horaria:
//APPL eLog //NAME ServerLog e //SOURCE FILE /var/log/apache/access.log tail //INTERNAL OUTPUT InternetLog //ATTRIBUTES *-------------------------------------------* * Apache Server Log Record Format Layout * *-------------------------------------------* ClientLocation D 256 ClientUserName D 32 Authorized_User K 32 Date_Time DL 20 Time_Zone K 5 Request D 256 DLM= FILTER={MATCH(0,-)} ServiceStatus C 99999999 BytesReceived C 99999999 Referral D 256 DLM=/" Browser D 256 DLM="" Service D 32 ServerName D 256 RequestParameters D 256 BytesSent C 99999999 RequestElapsedTime C 99999999 * //NAME RequestSummary e //INTERNAL INPUT InternetLog //SUMMARY 3600 Force //ATTRIBUTES LogRecord R 2048
Los registros de detalle se procesan en el grupo de atributos ServerLog y a continuacin, se redirigen al grupo de atributos RequestSummary, que cuenta el nmero de registros por hora. Los registros sin informacin de solicitud (indicados por un guin, - en la primera posicin del atributo Request) son inmediatamente rechazados. Como LogRecord no es una clave de clasificacin, los nicos atributos que estn presentes para el grupo de atributos RequestSummary incluyen los seis atributos de resumen reservados siguientes:
160
_LocalTimeStamp Indicacin de la hora de 16 bytes que indica el principio de un intervalo de resumen _DateTime El valor de atributo _LocalTimeStamp mostrado en un formato de visualizacin _Interval_Unit El valor de intervalo definido en la sentencia //SUMMARY (3600) _Interval El intervalo de resumen anterior expresado en horas desde el principio del da; por ejemplo, 10 _Interval_Unit_Name El valor de _Interval mostrado en un formato de visualizacin; por ejemplo 10 AM Occurrences El total de resumen calculado en el intervalo anterior Al haber especificado el parmetro Force, se obtiene como salida una fila de datos con 0 en la columna Ocurrencias si no se reciben registros coincidentes en el grupo de atributos durante la hora anterior.
Ejemplo 2
La siguiente definicin de grupo de atributos muestra el resumen de registro de un servidor de Internet de todas las solicitudes que han resultado en un estatus de error mayor que 400. Observe que las solicitudes de error de inters (+FILTER={NUMBER>=(0,400)}) ya se han filtrado en la entrada.
//NAME RequestErrorStatus e //INTERNAL INPUT InternetLog //SUMMARY 86400 //ATTRIBUTES ClientLocation D 256 ClientUserName D 32 Authorized_User K 32 Date_Time DL 20 Time_Zone K 5 Request D 256 SKEY=2 DLM= ServiceStatus C 99999999 SKEY=1 +FILTER={NUMBER>=(0,400)} BytesReceived C 99999999 Referral D 256 DLM=/" Browser D 256 DLM="" Service D 32 ServerName D 256 RequestParameters D 256 BytesSent C 99999999 RequestElapsedTime C 99999999 *
Tivoli Universal Agent acumula los datos de registro de entrada durante el intervalo de resumen. Al final de un intervalo, los datos acumulados se clasifican en base a las claves de clasificacin definidas y, a continuacin, se resumen. A continuacin, se muestran los siguientes atributos de salida: 1. Las dos claves de clasificacin de resumen: ServiceStatus y Request 2. Los seis atributos de resumen reservados: _LocalTimeStamp, _Date_Time, _Interval_Unit, _Interval, _Interval_Unit_Name y _Occurrences. Los atributos de salida de un grupo de atributos que se hayan resumido siempre constan de atributos clave, LocalTimeStamp, Interval y Occurrences. Los atributos que no estn definidos como atributos clave no estn incluidos en la salida.
Ejemplo 3
Slo necesita definir los metarchivos con tanto detalle como sea necesario para extraer correctamente y analizar los atributos clave de clasificacin para el resumen. Otros atributos de los datos de entrada, que
Apndice A. Sentencias de control de definicin de datos
161
no estn incluidos en el grupo de atributos de resumen de salida, se pueden marcar como marcadores y se designan con el tipo de atributo SKIP. La definicin del grupo de atributos abreviado que viene a continuacin genera la misma salida que el ejemplo anterior:
//NAME RequestErrorStatus e //INTERNAL INPUT InternetLog //SUMMARY 86400 //ATTRIBUTES PlaceHolder1 K 4 PlaceHolder2 K 4 PlaceHolder3 K 4 PlaceHolder4 K 4 PlaceHolder5 K 4 Request D 256 ServiceStatus * C
99999999
Si se han definido ms datos de entrada que atributos, Tivoli Universal Agent deja de interpretar los datos de entrada en el ltimo atributo definido.
Ejemplo 4
En el siguiente ejemplo, ClientLocation suma los totales de bytes enviados y recibidos son sumados cada hora.
//NAME DataTransferByLocation e //INTERNAL INPUT InternetLog //SUMMARY 3600 Force //ATTRIBUTES ClientLocation D 256 SKEY=1 PlaceHolder1 K 4 PlaceHolder2 K 4 Date_Time DL 20 PlaceHolder3 K 4 PlaceHolder4 K 4 DLM=: PlaceHolder5 K 4 BytesReceived C 99999999 SKEY=SUM PlaceHolder6 K 4 DLM=/" PlaceHolder7 K 4 DLM="" PlaceHolder8 K 4 PlaceHolder9 K 4 PlaceHolder10 K 4 BytesSent C 99999999 SKEY=SUM PlaceHolder11 K 4 *
Observe cmo los delimitadores de atributos especiales (mediante el parmetro DLM=-) son necesarios para la correcta interpretacin de los datos de entrada, aunque el contenido de dichos atributos SKIP no tengan consecuencia alguna, por lo que respecta al grupo de atributos de resumen de salida. Pero sin el anlisis correcto de los atributos SKIP, los valores de atributos de la clave de ordenacin no son correctos. Este grupo de atributos genera la salida que contiene los atributos siguientes: 1. Las tres claves de clasificacin de resumen: ClientLocation, BytesReceived y BytesSent. BytesReceived y BytesSent capturan la suma de los valores de atributo respectivos durante el intervalo anterior.
162
2. Los seis atributos de resumen reservados: _LocalTimeStamp, _Date_Time, _Interval_Unit, _Interval, _Interval_Unit_Name y _Occurrences.
Aunque Average_Errors no sea una clave de ordenacin de resumen, seguir incluida en el grupo de atributos de resumen de salida porque procede como mnimo de uno de los atributos de resumen reservados.
Ejemplo 5
El siguiente ejemplo ampla la definicin de metarchivo anterior especificando los atributos de RequestsPerSecond, TotalBytesTransfer, BytesTransferPerSecond y BytesTransferPerRequest para cada ubicacin de cliente:
//NAME DataTransferByLocation e //INTERNAL INPUT InternetLog //SUMMARY 3600 //ATTRIBUTES ClientLocation D 256 SKEY=1 PlaceHolder1 K 4 PlaceHolder2 K 4 Date_Time DL 20 PlaceHolder3 K 4 PlaceHolder4 K 4 DLM= PlaceHolder5 K 4 BytesReceived C 99999999 SKEY=SUM PlaceHolder6 K 4 DLM=/" PlaceHolder7 K 4 DLM="" PlaceHolder8 K 4 PlaceHolder9 K 4 PlaceHolder10 K 4 BytesSent C 99999999 SKEY=SUM PlaceHolder11 K 4 * RequestsPerSecond (_Occurrences / _Interval_Unit) * TotalBytesTransfer (BytesReceived + BytesSent) * BytesTransferPerSec (TotalBytesTransfer / _Interval_Unit) * BytesTransferPerReq (TotalBytesTransfer / _Occurrences)
163
Sentencia ATTRIBUTES
La sentencia ATTRIBUTES incluye las siguientes definiciones de atributo. Tambin permite la especificacin de los delimitadores de atributos en la cadena de datos. Cada registro que sigue a la sentencia ATTRIBUTES contiene una definicin de atributo.
Sintaxis
//ATTRIBUTES [<cadena-delimitadora>] [DLM=] [DLMSTR=] [DLMSTRBGN=] [DLMSTREND=]
Parmetros
<cadena-delimitadora> Identifica los caracteres opcionales delimitadores que separan los datos de atributos en la entrada. v Debe rodear los caracteres delimitadores de comillas simples. Por ejemplo,
//ATTRIBUTES ;
indica que los campos de atributos en una fila de datos estn separados por un punto y coma, como en el siguiente ejemplo de fila de datos,
John;Doe;Analista sistemas;Ingeniera
Nota: Los caracteres delimitadores no aparecen en los valores de atributos que se muestran en el espacio de trabajo de Tivoli Enterprise Portal. Tivoli Universal Agent utiliza el delimitador especificado en la sentencia ATTRIBUTES para analizar los datos de entrada. Despus de analizar los datos de entrada, se descarta el delimitador antes de utilizar los datos para la evaluacin de informes o de situaciones. En el siguiente ejemplo, tres comillas simples indican que los campos del atributo en una fila de datos estn separados por una comilla simple. Siempre que el carcter delimitador especificado no sea un espacio, querr decir que los espacios iniciales, finales o intermedios no se eliminarn de la fila de datos.
//ATTRIBUTES
v Al utilizar caracteres delimitadores simples, no es necesario tener un carcter delimitador despus de ltimo valor del atributo en la fila de datos porque el carcter de final de registro o de nueva lnea sirve para el mismo propsito que el delimitador. En el ejemplo de fila de datos anterior, no existe punto y coma despus de "Ingeniera" pero se entiende que se ha alcanzado el final del registro por lo que el delimitador de punto y coma no es necesario. v Si no se especifica ninguna cadena, se asume que los atributos estn separados por un espacio en blanco. En el ejemplo de fila de datos anterior, un delimitador de espacio no es una buena eleccin porque divide "Sistema" y "Analista" en dos valores de atributo diferentes en el espacio de trabajo de Tivoli Enterprise Portal. v Si la fuente de datos est proporcionando datos de entrada que no estn en ingls, es a veces necesario especificar caracteres delimitadores que no estn en ingls. Todas las formas de la especificacin de delimitadores en la sentencia ATTRIBUTES aceptan caracteres que no estn en ingls. No obstante, deber guardar el metarchivo en la codificacin UTF-8. Tivoli Universal Agent slo puede leer los formatos de metarchivos ASCII y UTF-8. v Una especificacin de delimitador de doble, como , indica que los campos del atributo estn rodeados por delimitadores de inicio y de fin.
John Doe Analista sistemas Ingeniera
Los delimitadores iniciales y finales no tienen que ser el mismo carcter. Por ejemplo, puede especificar los delimitadores de atributo como $? para el archivo:
$John? $Doe? $Analista sistemas? $Ingeniera?
164
Con delimitadores dobles, son necesarios delimitadores iniciales y finales para cada atributo, incluido el ltimo atributo del registro de datos. v La palabra clave TAB especifica el carcter de tabulacin horizontal como el delimitador de atributos:
//ATTRIBUTES //ATTRIBUTES TAB NEWLINE
v La palabra clave NEWLINE especifica el carcter de lnea nueva como delimitador del atributo: v El parmetro 0xnn indica que un carcter hexadecimal es el delimitador de atributo. Esta opcin suele utilizarse si los datos de entrada contienen un carcter delimitador no visualizable que no se puede especificar de otra manera en un metarchivo; por ejemplo:
//ATTRIBUTES 0xFB NONE
Si se utiliza NONE, los valores de datos de atributos se recuperan mediante el desplazamiento del campo y la longitud de datos del atributo definida. No se hace ninguna interpretacin o conversin de datos de los valores de datos. Debe asegurarse de que los tipos de valores de datos y tamaos coinciden exactamente con la especificacin de atributos en el metarchivo de aplicacin, tal como se muestra en el siguiente ejemplo de metarchivo:
//ATTRIBUTES NONE First-Name D 12 Last-Name D 12 Job D 20 Department D 16
Este es un registro de datos tpico que muestra cmo los desplazamientos de campo deben coincidir exactamente con los tamaos de atributos:
John[8 espacios]Doe[9 espacios]Analista sistemas[6 espacios] Ingeniera[5 espacios]
La entrada de datos no delimitados tambin soporta los tipos de datos de enteros cortos y largos binarios. Los datos se copian directamente desde los registros de entrada a la memoria. Por lo tanto, es importante asegurarse de que la aplicacin remitente y el proveedor de datos se inician en sistemas con arquitecturas similares, ya que el tamao del entero y su representacin de datos de memoria interna no se interpretan. Nota: No utilice NONE como delimitador de atributo cuando procese datos de entrada que contienen atributos numricos definidos como Contador o Indicador. El nmero de dgitos necesarios para representar el valor numrico en los datos de entrada no coincide necesariamente con la representacin de 2 o 4 bytes del nmero que el proveedor de datos debe almacenar, por lo que los valores de atributos pueden finalizar visualizndose incorrectamente en el espacio de trabajo de Tivoli Enterprise Portal. DLM (opcional) Como alternativa al formato <cadena-delimitadora>, tambin puede utilizar esta forma basada en palabras claves de especificacin del delimitador. Al igual que el formato de <cadena-delimitadora>, la especificacin de delimitador basado en la palabra clave da soporte a caracteres delimitadores simples as como especificaciones de delimitadores dobles en las que los dos caracteres indican delimitadores iniciales y finales. Por ejemplo, utilice el siguiente formato si va a supervisar un archivo que no est en ingls y desea especifica el carcter delimitador utilizando el formato DLM= :
//ATTRIBUTES DLM=
Nota: Si hay algn carcter que no est en ingls en un metarchivo de Tivoli Universal Agent, ya sea un delimitador, ttulo o texto de ayuda, debe guardar el metarchivo en codificacin UTF-8. DLMSTR (opcional) Si la fila de datos que se est analizando contiene un patrn de delimitacin que
Apndice A. Sentencias de control de definicin de datos
165
consiste de uno o ms caracteres, utilice el parmetro de palabra clave DLMSTR en lugar del formato de cadena delimitadora. Por ejemplo, mientras se analiza un registro de muestra del archivo Orders.log, se da cuenta de que siempre hay tres espacios en blanco entre cada uno de los campos de un registro de archivo:
May 24 2005 Acme Corp AE47938 John Doe Denver 9583759374 998123
Utilice una especificacin DLMSTR en la sentencia //ATTRIBUTES tal como se indica a continuacin;
//APPL OrderInfo //NAME CustomerData S 300 //SOURCE FILE C:\CustomerData\Orders.log //ATTRIBUTES DLMSTR= Date D 24 CustomerName D 32 CustomerPO D 32 CustomerContact D 24 CustomerLocation D 24 OrderNumber D 12 OrderTotal C 9999999
Tail
DLMSTRBGN y DLMSTREND (opcional) Como extensin al soporte de especificaciones de delimitacin dobles en las que los dos caracteres indican los delimitadores iniciales y finales, puede tambin especificar que hay varios caracteres que marcan el inicio y el final de cada valor de atributo. El siguiente ejemplo indica que cada valor de atributo en la fila de datos que se est procesando comienza con tres asteriscos y termina con tres signos de exclamacin.
//ATTRIBUTES DLMSTRBGN=*** DLMSTREND=!!!
Al igual que con todas las especificaciones de delimitacin, los caracteres de delimitacin no se incluyen en los datos del atributo. Se descartan antes de que se genere la fila de datos para la visualizacin de espacios de trabajo y la evaluacin de situaciones. Cualquier carcter de delimitacin, o cadena inicial o final que se especifique a nivel de //ATTRIBUTES tiene efecto sobre cada atributo individual definido bajo dicha sentencia //ATTRIBUTES. No obstante, si los datos de entrada no son completamente consistentes en su utilizacin de los delimitadores, no tendr la certeza de que la sintaxis de metarchivo de Tivoli Universal Agent pueda alterar temporalmente el valor del delimitador en el mbito del atributo individual. Esta caracterstica recibe el nombre de delimitadores-especficos-de-atributo. Consulte el Apndice B, Definiciones de atributos, en la pgina 169 para obtener informacin adicional.
166
Ejemplos de metarchivos
Este apartado proporciona ejemplos que ilustran varios metarchivos creados de acuerdo con las directrices presentadas en apartados anteriores. Para obtener ms informacin acerca de la creacin de definiciones de atributos, consulte el Apndice B, Definiciones de atributos, en la pgina 169.
Ejemplo 1 de metarchivo
En este ejemplo se muestra una aplicacin del proveedor de datos de servidor de API, denominada UXstat, compuesta por un grupo de atributos, UXsysSta. UXsysSta contiene 22 atributos, que utilizan datos sondeados con un TTL de 150 segundos. No se necesita una sentencia SOURCE en esta definicin de datos ya que los datos se envan a travs de las API.
//APPL UXstat @help text //NAME UXsysSta p 150 @help text //ATTRIBUTES SystemName D 16 @help text OSversion D 16 @help text PendingIOwaitRate C 100000 @help text IOstartRate C 100000 @help text IOcompleteRate C 100000 @help text AvgWaitThreadQueueSize C 4096 @help text AvgRunThreadQueueSize C 4096 @help text AvgNumbActivePageFrames C 100000 @help text AvgNumbFreePageFrames C 100000 @help text PageInRate C 65000 @help text PageOutRate C 65000 @help text DevInterruptRate C 65000 @help text SystemCallRate C 65000 @help text ThreadContentSwitchRate C 65000 @help text AvgUserCPUPercent C 100 @help text AvgSystemCPUPercent C 100 @help text AvgIdleCPUPercent C 100 @help text AvgWaitCPUPercent C 100 @help text UDPpktInRate C 100000000 @help text UDPpktOutRate C 100000000 @help text TCPpktInRate C 100000000 @help text TCPpktOutRate C 100000000 @help text
Ejemplo 2 de metarchivo
Este segundo metarchivo de ejemplo ilustra la definicin de datos extrados a partir de un archivo de registro para una aplicacin llamada SysEvent. El ejemplo consta de un slo grupo de atributos denominado ConLog, que utiliza los datos de sucesos recopilados en modalidad TAIL.
//APPL SysEvent @help text //NAME ConLog E @help text //SOURCE FILE e:\system\event.log TAIL //ATTRIBUTES MessageID D 12 MessageNumb C 999999 MessageType D 1 ProcessNumb C 9999 TimeMonth D 3 TimeDay C 31 T TimeYear C 9999 TimeHour C 24 TimeMinute C 60 TimeSecond C 60 MessageText D 100
167
168
Sintaxis
<nombre-atributo> <tipo-atributo> <tamao-mximo> [KEY] [ATOMIC] [ENUM{<texto>}] [CAPTION{<texto>}] [SCALE{<nn>}] [PRECISION{<mm>}] [<comportamiento-agregado>] [<delimitador-especfico-atributo>] [SEQ=<nn>] [SKEY=<nn>/SUM] [DEFAULT=] [+/-FILTER={<texto>}] [@<texto de ayuda>]
Parmetros
Los parmetros <nombre-atributo>, <tipo-atributo>, <tamao-mximo>, KEY y ATOMIC son posicionales. Si se especifican, deben colocarse en la secuencia mostrada arriba. Los parmetros restantes utilizan un formato palabra_clave=< valor> o palabra_clave{<valor>} y se pueden colocar en cualquier orden despus de los parmetros de posicin, con las dos excepciones siguientes: 1. El parmetro <texto de ayuda> siempre debe ser el ltimo parmetro en una definicin de atributo. 2. El parmetro FILTER= debe ir detrs de todos los otros parmetros opcionales, como por ejemplo, CAPTION, SCALE, ENUM, etctera, y se anteponen de forma inmediata a cualquier texto de ayuda opcional. <nombre-atributo> Especifica el nombre de un atributo. Notas: 1. Los nombres de atributos pueden contener hasta 200 caracteres. 2. No puede haber espacios en blanco incorporados en el nombre. Slo se permiten caracteres ASCII, incluidos letras, nmeros, guiones (-), subrayados (_) y asteriscos (*). Un carcter incorrecto se sustituye automticamente por un subrayado. <tipo-atributo> Especifica uno de los siguientes tipos de atributos vlidos: # Valor delta. Presenta el valor del atributo como la diferencia entre muestras. Por ejemplo,
169
si el valor de la muestra 1 es 100 y el de la muestra 2 es 120, el delta es 20. Un valor delta puede ser un nmero negativo si el valor muestreado actual es menor que el valor muestreado anterior. % Porcentaje de cambio. Presenta el valor del atributo como la diferencia entre las muestras expresada como porcentaje. Por ejemplo, si ReceiveCount se define como tipo de datos % y el valor de la muestra 1 es 100 y el valor de la muestra 2 es 120, el porcentaje de cambio es 20. Tasa de cambios. Presenta el valor del atributo como delta por segundo entre muestras. Por ejemplo, si ReceiveCount se define como el tipo de datos ?, el valor de la primera muestra es 100, el valor de la segunda muestra es 120, y el tiempo transcurrido entre las muestras 1 y 2 es de 5 segundos, la tasa de cambio es de 4 por segundo. Promedio. Media de datos en todas las recopilaciones. Contador. Entero positivo. DisplayString. Serie de caracteres. Medidor. Entero positivo o negativo. Omitir. Entra un campo posicional. No tiene inters y se omite. Por ejemplo, si un registro de archivo tiene diez campos, pero slo desea externalizar seis de dichos campos para la visualizacin de espacios de trabajo y la evaluacin de situaciones, puede definir los otros cuatro atributos como de tipo Skip. Los cuatro atributos estn fsicamente en el archivo, y el proveedor de datos de archivo los detecta cuando analiza cada registro utilizando el delimitador y el tamao mximo designados del atributo, pero el proveedor de datos omite los atributos de Skip sin realizar ningn otro proceso en ellos. NumericString. Serie de caracteres, que pueden incluir dgitos as como separadores decimales, comas, signos de porcentaje y menos, y otros caracteres que no son dgitos. Este tipo de atributo es una representacin de serie de caracteres de un nmero y no un entero. Por lo tanto, un atributo de NumericString no es idneo para visualizar en diagramas y grficos en Tivoli Enterprise Portal. Registro. Lee el todo el registro hasta encontrar un carcter de control de carro/salto de lnea. Conmutar. Booleano 0 o 1. Hora. El formato es SAAMMDDHHMMSSmmm (donde S=1 para el siglo XXI). Unicode. Una serie de caracteres globalizados. ltimo. Ignora el delimitador especificado y trata todos los datos de entrada de la posicin actual hasta el final de los datos de entrada como un nico campo.
A C D G K
R S T U Z
Nota: Cuando se utiliza uno de los tres atributos de tipo de tasa (#, %, y ?) en un grupo de atributos con clave, recuerde que los clculos de delta, cambio de porcentaje y tasa de cambio se realizan entre el valor de atributo actual y el valor de atributo de la fila de datos anterior con claves coincidentes. Si no hay ninguna fila de datos anterior con claves coincidentes, el valor de atributo de tipo de tasa ser cero. Como ejemplo, si recopila datos MIB de agentes SNMP que se ejecutan en Host1 y Host2, el nombre de host es el atributo KEY en el grupo de atributos, y se ha definido un atributo delta denominado IPpacketErrors, el clculo delta para una fila de datos Host2 slo se realizar con respecto al nmero total IPpacketErrors en la fila de datos Host2 anterior, aunque las ltimas filas de datos recopiladas procedan de Host1. Si no se proporciona valor alguno para un atributo cuando los datos se muestrean, se presupone un valor predeterminado. El valor predeterminado depende del tipo de atributo, tal como se muestra en la Tabla 25.
170
Tabla 25. Valores predeterminados para diferentes tipos de atributos Tipo de atributos A (Promedio) C (Contador) D (DisplayString) G (Medidor) K (Omitir) N (NumericString) R (Registro) S (Conmutar) T (Hora) U (Unicode) Z (ltimo) Valor predeterminado Sin cambios del promedio actual 0 ^ 0 No aplicable ^ No aplicable 0 Hora actual ^ ^
Puede cambiar estos valores de atributos predeterminados especificando un parmetro DEFAULT= en la definicin de atributo. Vea la descripcin de parmetro DEFAULT ms adelante en este apartado. <tamao-mximo> Especifica el tamao mximo esperado de los datos. Notas: 1. Para los tipos de atributos D, K, N, R, U y Z, este parmetro especifica el nmero mximo de bytes del atributo. El tamao mximo permitido es de 4000 bytes. 2. Para aquellos atributos numricos como Contador o Medidor, este parmetro especifica el nmero mximo esperado. Por ejemplo, un atributo para la utilizacin de CPU expresado como porcentaje podra tener un valor mximo de 100. Un atributo Contador para el nmero total de paquetes recibidos puede esperar un valor mximo de 1.000.000 paquetes por implementacin de sistema. Tivoli Universal Agent slo soporta valores de atributos numricos de hasta 2 gigabytes; por lo tanto no especifique un tamao mximo para ningn atributo numrico que sea mayor de 2.147.483.647. 3. El nmero mximo previsto elegido para un atributo numrico como el Contador o Indicador determina si el atributo est definido ante el servidor de supervisin y servidor del portal como entero de 4 bytes o corto de 2 bytes. Si el valor especificado en la definicin de atributo es mayor que 32767 (el nmero mximo de 16 bits con signo), el atributo se define como entero de 4 bytes. De lo contrario, se define como corto de 2 bytes. 4. Para el tipo de atributo Unicode, los datos globalizados se representan internamente en Tivoli Universal Agent como UTF-8, y tambin se envan al servidor de supervisin como datos UTF-8. Generalmente, dado que UTF-8 requiere entre 2 y 4 bytes para representar un carcter Unicode que no est en ingls, la especificacin de tamao mximo de todos los atributos U se multiplica automticamente por 3 cuando Tivoli Universal Agent importa un metarchivo. KEY (opcional) Indica que un atributo es un atributo clave. Esto slo se aplica si el mtodo de muestreo en la sentencia NAME est especificado como K. Tivoli Universal Agent utiliza atributos clave para determinar si varios sucesos tienen la misma causa. Los atributos clave ayudan a correlacionar las filas de datos con valores de atributos con clave idnticos. A medida que Tivoli Universal Agent recibe las filas de datos de los datos de atributos con clave, comprueba si ya tiene una fila de datos con valores coincidentes para el atributo con clave. Si es as, los nuevos datos sustituyen a los existentes. Es ms, la sustitucin slo se produce si la diferencia de hora entre la nueva fila de datos y la fila de datos existente es menor que el TTL especificado.
Apndice B. Definiciones de atributos
171
Notas: 1. Puede designar hasta cinco atributos como atributos clave. 2. Si no se designa ningn atributo como clave en el grupo de atributos clave, Tivoli Universal Agent utiliza el primer atributo como el atributo clave. ATOMIC (opcional) Tivoli Universal Agent permite atomizar los atributos en los metarchivos. La atomizacin de un atributo permite la utilizacin de la opcin de elemento de visualizacin durante la definicin de situacin. La opcin de elemento de visualizacin permite realizar lo siguiente: v Generar sucesos independientes para una nica condicin verdadera. v Visualizar de forma sencilla el valor que ha provocado que la situacin sea cierta. Por ejemplo, si process_cpu > 10 por ciento representa una situacin, una situacin puede activarse para uno o ms procesos en un sistema. Si slo se activa un suceso de situacin, el proceso responsable es ambiguo. En distintos intervalos, diferentes procesos pueden estar causando el problema. Si atomiza la situacin utilizando la opcin de elemento de visualizacin para el atributo process_cpu, se activan sucesos de situacin independientes y se restablecen para cada proceso que provoca que la situacin sea cierta. Esta caracterstica puede reducir enormemente el nmero de definiciones de situaciones y tambin ayudar en la determinacin de problemas. La atomizacin se suele utilizar en casos de integracin de Tivoli Enterprise Console en los que se desea que cada ocurrencia individual de una situacin cierta se notifique a Tivoli Enterprise Console. Para activar esta caracterstica, aada la palabra clave Atomic en la parte derecha del atributo que desea atomizar en el metarchivo de Tivoli Universal Agent. Nota: Puede especificar Atomic en maysculas o en minsculas.
EmployeeName D 20 Atomic EmployeeExt N 4 EmployeeID D 8
El atributo EmployeeName est atomizado. Atomic es similar a la palabra clave Key en lo referente a seguir la especificacin de tamao. Puede incluir tanto key como atomic en el mismo atributo. Debe haber al menos un espacio en blanco separando ambas palabras. Nota: La adicin de la palabra atomic a un atributo existente slo provoca un cambio de versin de menor importancia en la aplicacin de Tivoli Universal Agent asociada. Varios atributos proporcionados por Tivoli Universal Agent en la aplicacin SNMP-MANAGER del proveedor de datos de SNMP y en la aplicacin INTERNET del proveedor de datos de HTTP estn ya atomizados de forma predeterminada. Esto permite que las situaciones que hacen referencia a dichos atributos utilicen la capacidad de elemento de visualizacin. Nota: Aunque no existe lmite para el nmero de atributos que puede atomizar en un metarchivo, slo es posible especificar un atributo de elemento de visualizacin por situacin. Los tipos de atributos numricos como Contador y Medidor no pueden utilizarse con el parmetro Atomic. ENUM (opcional) Para los atributos de tipo numrico, puede especificar una o ms cadenas de caracteres de enumeracin para facilitar la lectura de los valores de datos numricos. El formato de cada cadena de caracteres de enumeracin es el siguiente:
enumString(valor_numrico)
172
Puede incluir tantas cadenas de caracteres de enumeracin como desee dentro de un bloque ENUM{ }. Es necesario poner un espacio en blanco despus del { inicial y otro antes del final }. Por ejemplo, si define el atributo ifOperStatus del modo siguiente:
ifOperStatus C 999999 ENUM{ up(1) down(2) } @El estatus de la interfaz
En lugar de visualizar 1 o 2 en el espacio de trabajo de Tivoli Enterprise Portal, se visualizan up o down. Tambin puede definir situaciones que comparan la cadena de caracteres de enumeracin en vez del valor de entero puro. Nota: Para garantizar la correcta definicin y evaluacin de situaciones, debe establecer el tamao mximo en ms de 32.767 (32K) para cualquier atributo numrico con cadenas de caracteres de enumeracin. Por ejemplo, si especifica un atributo tal como se muestra en el siguiente ejemplo, el editor de situaciones no acepta valores de cadenas de caracteres como por ejemplo, Submitted o JobNotExecuted, y no se puede guardar la situacin: JobStatus C 299 ENUM{ Submitted(201) WaitingForRes(202) ResourceAllocation(203) JobNotExecuted(204) } Tal como se ha mencionado anteriormente, el tamao mximo de un atributo numrico determina si el atributo se ha definido ante el servidor de supervisin y el servidor del portal como entero de 4 bytes o corto de 2 bytes. Si el valor especificado en la definicin de atributo es menor o igual a 32K, el atributo se define como corto de 2 bytes, lo que no es compatible con definiciones de situaciones que utilizan cadenas de caracteres de enumeracin. El aumento del tamao mximo del atributo JobStatus a un valor de ms de 32K permite definir y guardar la frmula de la situacin. No se permiten comas dentro de parmetros ENUM porque Tivoli Universal Agent utiliza internamente la coma como carcter separador. El analizador de metarchivos omite las comas encontradas en un parmetro ENUM, pero el resto de la definicin ENUM se procesa. Si se han definido cadenas de enumeracin que no estn en ingls, deber guardar el metarchivo en codificacin UTF-8. CAPTION (opcional) Tivoli Enterprise Portal permite especificar un nombre alternativo para un atributo. A este nombre alternativo se le conoce como Caption. El nombre debe constar de uno o ms caracteres de texto delimitados por llaves. Generalmente se especifica un parmetro CAPTION en la definicin del atributo para proporcionar una versin ms legible de un atributo en los encabezados de las columnas del espacio de trabajo. El siguiente es un ejemplo de cmo especificar un ttulo (caption),
AvgDiscarded C 999999 descartados por segundo Caption{Promedio\nDescartados} @Promedio paq
La presencia del carcter de lnea nueva, \n, en el parmetro Caption especifica que el encabezado de la columna AvgDiscarded aparece en Tivoli Enterprise Portal como:
Promedio Descartados
SCALE y PRECISION (opcional) Para dar soporte a nmeros de separador flotante en Tivoli Enterprise Portal, Tivoli Universal Agent permite especificar un factor de escala (Scale) y precisin (Precision) cuando se define un atributo numrico. Tivoli Enterprise Portal utiliza el valor de Scale para saber cuntas posiciones desplazar la coma decimal hacia la izquierda y el valor de Precision para determinar el ancho total del nmero de separador flotante. Estos nmeros de separador flotante son entonces aptos para grficos y diagramas y otras caractersticas de representacin de Tivoli Enterprise Portal basadas en nmeros. Para habilitar esta funcin, especifique SCALE{<nn>} PRECISION{<mm>} a la derecha de una definicin de atributo. Por ejemplo, los valores de parmetro
Apndice B. Definiciones de atributos
173
FloatAttr1
999999
SCALE{2}
PRECISION{5}
SCALE y PRECISION deben ir delimitados por llaves. NOTA IMPORTANTE: Para garantizar unos resultados de escalado correctos, debe establecer el tamao mximo en los metarchivos para tipos numricos en un mximo de 32.767 (32K). Por ejemplo,
FloatAttr2 C 99999 SCALE{1} PRECISION{5}
De lo contrario, los valores de datos se visualizan de forma incorrecta en el portal. Como alternativa, puede elegir especificar SCALE{<nn>} PRECISION{<mm>} en un atributo derivado. Por ejemplo,
PktReceivedPerSec C 1000000 PktDiscardedPerSec C 1000000 DiscardedRatio (PktDiscardedPerSec / PktReceivedPerSec) SCALE{3} PRECISION{6}
El valor de SCALE mximo permitido es 10 y el valor de PRECISION mximo permitido es 12. <comportamiento-agregado> (opcional) Permite especificar detalles para agregar datos que el Agente de resumen y podado utilizar ms adelante. Tenga presente que Tivoli Universal Agent slo hace referencia a estos parmetros de agregacin con el fin de generar las sentencias ODI de aplicacin que el Agente de resumen y poda requiere: AGPRF Indica la columna o atributo que se est visualizando cuando el Editor de consultas realiza el post-filtrado de los datos resumidos. Cuando se define un post-filtrado en el Editor de consultas, la columna que se suministra en el filtro es una columna de tiempo real. Este nombre de columna exacto es probable que no exista en la tabla de datos resumidos sino que aparece como xxx_min, xxx_max o xxx_avg. Esta palabra clave se utiliza a nivel de columna. AGTIM Indica una columna alternativa en la tabla que se utilizar como indicacin de la hora durante la agregacin en lugar de la columna Writetime predeterminada. Slo puede especificar la palabra clave AGTIM para un atributo de tipo Time. Cada tabla puede tener slo una palabra clave AGTIM. La columna o atributo que contiene AGTIM contiene una indicacin de la hora de recopilacin los datos de la medida o punto en el tiempo. Esta palabra clave se utiliza a nivel de columna. BEHAV{<valor>} Describe el contenido de los datos. Slo puede especificar la palabra clave BEHAV para un tipo de atributo numrico, como Contador o Medidor. Esta palabra clave se utiliza a nivel de columna. La siguiente lista muestra los valores vlidos: Gauge Nmero basado en rangos (como un percentil). State Lista enumerada de opciones que se refiere a la condicin del recurso, como activo o inactivo.
Count Nmero de iteraciones que se han producido. El contador puede restablecerse. Property Caracterstica del recurso que raramente cambia, como la cantidad de memoria o velocidad del procesador. Low Peak Valor ms bajo informado durante un periodo determinado de tiempo. Valor ms grande informado durante un periodo determinado de tiempo.
174
PDel
SampleCount Nmero de lecturas promediadas por el Agente de resumen y poda. De forma predeterminada, SampleCount se almacena en la columna SAMPLECOUNT. DEPRECATED Indica las columnas o atributos en una tabla que ya no se soportan. Evite nuevos usos de dichas columnas. Esta palabra clave se utiliza a nivel de columna. OPTION{HISTORICALTIMESTAMP} Identifica los atributos de indicacin de la hora que desea que se visualicen en la ventana Intervalo de tiempo de Tivoli Enterprise Portal. Slo es posible especificar la palabra clave OPTION{HISTORICALTIMESTAMP} para un atributo de tipo Time. OPTION{PRIMARYKEY=<n>} Utilizado para designar un atributo clave. Necesario para cada tabla. La variable n comienza en 0 para cada atributo y aumenta en incrementos de 1 segn sea necesario. Utilice PRIMARYKEY=0 para la clave del identificador exclusivo en una tabla de varias filas. Por ejemplo, si una tabla describe unidades de disco, debera especificar PRIMARYKEY=0 con cada atributo que contenga el ID exclusivo para cada unidad de disco. Esta palabra clave se utiliza a nivel de columna. WHSC{<atributo>} Indica la columna que contiene el contador de muestras del registro para que puedan calcularse los promedios. Esta palabra clave puede ser una lista separada por espacios en blanco de columnas que especifica la columna y la medida a la que se aplica el contador de muestras. Si una tabla tiene varias palabras clave WHSC, cada contador de muestras se aplica slo a las columnas especificadas en la lista atributos. Si el valor de atributo es ALL, la columna en que la que se proporciona el cdigo WHSC es el campo de contador de muestras de todas las medidas en la tabla. El siguiente es un ejemplo de cmo puede utilizar los parmetros de agregacin en un metarchivo:
//APPL Disk_Monitor WHEN{H} //NAME Physical_Disk S 300 Interval=60 //SOURCE ODBC mydatasource //SQL Select * from Physical_Disk //ATTRIBUTES TMZDIFF N 12 @attimezone difference from GMT WRITETIME D 16 AGTIM Disk_Name D 64 OPTON{PRIMARYKEY=0} Timestamp T 16 OPTION{HistoricalTimestamp} @hora lt compr disco User_Name D 64 BEHAV{PROPERTY} OS_Type D 16 BEHAV{PROPERTY} Avg_Disk_Bytes_Read C 999999 BEHAV{GAUGE} Disk_Bytes_Sec C 999999 BEHAV{GAUGE} System_Up_Time C 999999 BEHAV{COUNT}
<delimitador-especfico-atributos> (opcional) Permite alterar temporalmente el delimitador de grupo de atributos que est definido en la sentencia //ATTRIBUTES. El delimitador definido en la sentencia //ATTRIBUTES se aplica a todos los atributos en el grupo de atributos. No obstante, los datos de aplicacin no siempre se delimitan de manera uniforme. Si este fuera el caso, es necesario alterar temporalmente el delimitador normal con un delimitador especial que se utilice a nivel de atributos individuales. Por ejemplo, las siguientes sentencias de metarchivo,
//APPL XYZ //NAME TransactionLog E //SOURCE FILE /home/logs/transaction.log tail //ATTRIBUTES ClientName D 32
Apndice B. Definiciones de atributos
175
El delimitador en efecto a nivel del grupo de atributos es un nico espacio. Esto generalmente funciona para separar cada valor de atributo en este registro, excepto el valor del atributo Transaction que est delimitado por comillas dobles. Puede analizar correctamente el valor de Transaction en el registro de ejemplo (como GET/ITM05.html) redefiniendo el atributo Transaction con el delimitador inicial y final especfico del atributo:
Transaction D 256 DLM=
Los tipos y sintaxis de los parmetros del delimitador especfico del atributo que defina a nivel de atributos individuales son los mismos parmetros que puede especificar en la sentencia //ATTRIBUTES: DLM, DLMSTR y DLMSTRBGN combinados con DLMSTREND. Consulte Sentencia ATTRIBUTES en la pgina 164 para obtener ms informacin sobre los parmetros DLM, DLMSTR, DLMSTRBGN y DLMSTREND. Al igual que con las especificaciones de delimitadores en la sentencia //ATTRIBUTES, deber rodear el delimitador especfico del atributo de comillas simples. Si incluyen algn carcter que no est en ingls, deber guardar el archivo en la codificacin UTF-8. No existe ninguna restriccin acerca del nmero de delimitadores especficos de atributos dentro de un grupo de atributos. SEQ (opcional) Permite alterar temporalmente la secuencia de atributos normal, que de forma predeterminada es simplemente el orden en el que los atributos aparecen listados debajo de la sentencia //ATTRIBUTES. La razn principal para utilizar el parmetro SEQ=<nn> es evitar cambios principales de versin de la aplicacin cuando se modifica un metarchivo. Consulte Secuenciado de definiciones de atributos en la pgina 186 para obtener ms informacin.
SKEY (opcional) Identifica un atributo como una clave de clasificacin de resumen. Este parmetro slo es vlido en un grupo de atributos de resumen. Consulte Sentencia SUMMARY en la pgina 159 para obtener ms informacin. DEFAULT (opcional) Permite asignar un valor predeterminado a un atributo cuando a la fila de datos recopilados le falta un valor de atributo determinado. Por ejemplo, en determinados casos de supervisin de registros, hay algunos registros en los que no se han rellenado todos los campos. Si no se ha especificado el parmetro DEFAULT y falta un valor de atributos, Tivoli Universal Agent asigna un valor predeterminado de acuerdo con el tipo de atributo, segn se describe en la Tabla 25 en la pgina 171. El valor especificado en el parmetro DEFAULT= debe ir delimitado por comillas simples. Las siguientes sentencias de metarchivo muestran cmo utilizar el parmetro DEFAULT:
//SOURCE FILE /opt/logs/employee_list.txt TailByCount 500 //ATTRIBUTES ; EmployeeName D 32 EmployeeExt C 999999 DEFAULT=0000 EmployeeDept D 16 DEFAULT=N/A
FILTER (opcional) Permite establecer criterios que incluyen o excluyen una fila de datos basada en una subcadena de caracteres o nmero encontrado en un valor de atributo determinado. Consulte Filtrado de atributos en la pgina 181 para obtener ms informacin. <texto de ayuda> (opcional) Define la ayuda que se visualiza cuando el cursor se mueve encima de un encabezado de columna dentro de una vista de espacio de trabajo. Este texto de ayuda del atributo tambin
176
se visualiza en el Editor de situaciones del cliente de Tivoli Enterprise Portal cuando se seleccionan condiciones para incluir en una situacin. Notas: 1. El texto debe ir precedido del signo de arroba (@). 2. El texto no puede superar los 245 caracteres. 3. Las comas (,) se convierten en espacios. 4. Si se especifica un texto de ayuda que no est en ingls, el metarchivo deber tener la codificacin UTF-8.
Duplicacin de atributos
Dentro de un grupo de atributos, tal y como se define en una sentencia NAME, no estn permitidos los atributos duplicados. Los siguientes procedimientos manejan atributos duplicados. Atributos con el mismo nombre y tipo. Los atributos subsiguientes se suprimen y el mensaje de validacin KUMPV15W identifica el atributo suprimido. El tamao del atributo ayuda a determinar si los atributos son duplicados. Si dos atributos tienen el mismo nombre y tipo pero difieren en tamao, Tivoli Universal Agent guardar el atributo de mayor tamao. Por ejemplo, en las siguientes definiciones de atributos:
InventorySum . . . InventorySum C10000
C 9999
se suprime la definicin InventorySum C 9999. Atributos con el mismo nombre pero de distinto tipo. Un nmero de secuencia se aade a los atributos duplicados y el mensaje de aviso KUMPV16W indica que el nombre de atributo ha cambiado. Por ejemplo, las siguientes definiciones de atributos:
InventorySum . . . InventorySum D 12
C 10000
se modifican como:
InventorySum D 12 . . . InventorySum2 C 10000
Nota: Las definiciones de atributos exclusivas pueden acabar duplicadas si se trunca el nombre. Para garantizar que se resuman los datos personalizados, especifique la opcin PRIMARYKEY en los campos de atributos clave para indicar al Agente de resumen y poda cmo distinguir entre varias instancias. Utilice la siguiente opcin para designar un atributo clave:
OPTION{PRIMARYKEY=n}
177
Esta opcin es necesaria para cada uno de los grupos de atributos. La variable n empieza por 0 para cada atributo y aumenta de 1, segn convenga. Utilice PRIMARYKEY=0 para la clave del identificador exclusivo en un grupo de atributos de varias filas. Por ejemplo, si un grupo de atributos describe unidades de disco, debe especificar PRIMARYKEY=0 con cada atributo que contenga el ID exclusivo para cada unidad de disco. Esta palabra clave se utiliza a nivel de columna.
Atributos invisibles
-nombre-atributo tipo-atributo tamao-mximo
Puede utilizar un atributo como intermediario para derivar otros atributos. Debe definir el atributo en un metarchivo ya que forma parte de los datos de aplicacin de entrada o quizs porque sirve como marcador de posicin. La eliminacin de este atributo de la salida, no obstante, reduce la complejidad del grupo de atributos y simplifica su utilizacin. Los atributos ClientAddress, Date, Time y Date_Time listados en el siguiente ejemplo son invisibles en la salida. No es posible tener ningn espacio en blanco entre el guin y el nombre de atributo.
//NAME RequestErrorStatus e //INTERNAL INPUT InternetLog //SUMMARY 86400 //ATTRIBUTES -ClientAddress D 256 ClientLocation (ipAddressToName = ClientAddress) ClientUserName D 32 Authorized_User K 32 -Date D 10 -Time D 10 -Date_Time (Date + Time) LocalTimeStamp (TivoliTimeStamp = Date_Time) Time_Zone K 5 Request D 256 SKEY=2 ServiceStatus C 999 SKEY=1 +FILTER={NUMBER>=(0,400)} BytesReceived C 99999999 Referral D 256 DLM=/" Browser D 256 DLM="" Service D 32 ServerName D 256 RequestParameters D 256 BytesSend C 99999999 RequestElapsedTime C 99999999 *
Los atributos ClientLocation y LocalTimeStamp proporcionan informacin de una manera adecuada para la salida sin prdida de informacin alguna. Consulte Funciones de atributos derivados en la pgina 180 para obtener ms informacin acerca de este ejemplo.
resultar en un valor de datos de ABCDEFGH. El mismo atributo definido utilizando la especificacin de truncamiento por la izquierda DL
nombre-atributo DL tamao-mximo
178
Derivacin de atributos
Puede definir atributos que deriven de otros atributos utilizando la siguiente especificacin:
nombre_atributo (atributo_1 operador atributo_2)
Los operadores soportados son: Operador + * / % Significado atributo_1 menos atributo_2 atributo_1 ms atributo_2 atributo_1 multiplicado por el atributo_2 atributo_1 dividido por el atributo_2 atributo_1 dividido por el atributo_2 y multiplicado por cien
Ambos atributos en la frmula deben ser numricos y de entrada o derivados. Por ejemplo,
//APPL NewType //NAME NewTable K 3600 //SOURCE FILE C:\test.log //ATTRIBUTES ; Item_Name D 24 KEY Width C 1000000 Depth C 1000000 Difference (Width - Depth) Sum (Width + Depth) Area (Width * Depth) Factors (Width / Depth) Percent (Width % Depth) Height C 1000000 Volume (Area * Height)
Los atributos numricos derivados pueden utilizar valores numricos codificados de forma fija. Por ejemplo,
BytesSent C 999999 KilobytesSent (BytesSent/ 1024)
Tambin puede crear un atributo numrico derivado partiendo de dos valores numricos codificados de forma fija.
La palabra clave REAL especifica que el valor de salida del atributo aparezca como un nmero de separador flotante con una precisin de hasta tres decimales. Nota: Un atributo que utiliza la palabra REAL est definido en Tivoli Enterprise Portal como una cadena de caracteres y no un entero. Por lo tanto, el atributo no es apto para diagramas o grficos o para comparaciones numricas en situaciones. Si tiene un atributo de separador flotante que debe manejarse como datos numricos, utilice los parmetros SCALE y PRECISION en la definicin de atributo, segn se describe en SCALE y PRECISION en la pgina 173 en Parmetros en la pgina 169.
Apndice B. Definiciones de atributos
179
Por ejemplo, si un grupo de atributos contiene el atributo Date y el atributo Time, podr combinarlos en un nico atributo Date_Time para su utilizacin. Si el atributo Date tiene el valor Sep 15, 2006 y el atributo Time contiene 10:31:21 el atributo Date_Time resultante es Sep 15, 2006 10:31:21. Las cadenas de caracteres de atributos concatenados pueden utilizar valores de cadenas de caracteres literales. Por ejemplo,
SystemName D 32 FullSystemName (SystemName + "_Prod")
Tambin es posible crear un atributo de cadena derivado partiendo de dos cadenas de caracteres literales.
TivoliTimeStamp
Convierte la cadena de caracteres de entrada de fecha y hora Visualizacin en formato libre en una indicacin de la hora ITM estndar de 16 dgitos. Convierte el valor de hora hexadecimal especial de Netware en un formato de hora de visualizacin estndar. Convierte la hora universal coordinada a una hora local en una indicacin de la hora estndar de 16 dgitos. Convierte la hora universal coordinada a la hora GMT en una indicacin de la hora estndar de 16 dgitos. Obtiene el valor actual para una variable de entorno especificada. Convierte una representacin hexadecimal de la hora actual, almacenada en un registro de IBM Tivoli Monitoring, a una indicacin de la hora estndar de 16 dgitos. Visualizacin Entero Entero Visualizacin Visualizacin
180
//NAME RequestErrorStatus e //INTERNAL INPUT InternetLog //SUMMARY 86400 //ATTRIBUTES ClientAddress D 256 ClientLocation (ipAddressToName = ClientAddress) ClientUserName D 32 Authorized_User K 32 Date D 10 Time D 10 Date_Time (Date + Time) LocalTimeStamp (TivoliTimeStamp = Date_Time) Time_Zone K 5 Request D 256 SKEY=2 ServiceStatus C 999 SKEY=1 +FILTER={NUMBER>=(0,400)} BytesReceived C 99999999 Referral D 256 DLM=/" Browser D 256 DLM="" Service D 32 ServerName D 256 RequestParameters D 256 BytesSend C 99999999 RequestElapsedTime C 99999999 *
Si supervisa un registro de IBM Tivoli con un metarchivo del proveedor de datos de archivo, debe especificar la funcin de atributo derivado TivoliLogTime del modo siguiente:
-LogTime D 16 DLM=- +FILTER={MATCH(0,()} Timestamp (TivoliLogTime = LogTime) otras definiciones de atributos ...
Esta sintaxis de metarchivo lee un registro de archivo, como por ejemplo, (44B61A87.00001:RAS1,400,CTBLD) y captura (44B61A87.0000 en el atributo LogTime invisible. A continuacin, la funcin de atributo derivado TivoliLogTime convierte (44B61A87.0000 en una indicacin de la hora de 16 bytes y la almacena en el atributo Timestamp, que tiene las propiedades de cualquier atributo Time en Tivoli Enterprise Portal. Aunque est disponible para todos los tipos de proveedores de datos, la funcin de atributo derivado GetEnvValue se suele utilizar en los metarchivos del proveedor de datos de script para suministrar ms informacin de contexto; por ejemplo:
//APPL NETUSE //NAME DriveMappings K 300 AddTimeStamp Interval=60 //SOURCE Script C:\windows\system32\net.exe "use" Envfile=netuse.env //ATTRIBUTES ComputerName (GetEnvValue = COMPUTERNAME) Path (GetEnvValue = PATH) Status D 16 -FILTER={SCAN(0,Status) OR SCAN(0,------) OR SCAN(0,The) \ OR SCAN(0,New)} DriveLetter D 4 KEY DLM=: Mapping D 32 Network Z 64
Filtrado de atributos
Para controlar la cantidad de datos que pueden verse en los espacios de trabajo, puede especificar la cantidad de datos que desea incluir o excluir. Esta caracterstica se conoce como filtrado de atributos. El filtrado de atributos puede mejorar el rendimiento de la solucin reduciendo la cantidad de datos que Tivoli Universal Agent procesa.
181
Sintaxis
nombre-atributo {filter1 OR|AND nombre-atributo {filter1 OR|AND tipo-atributo tamao-mximo +FILTER= filter2 OR|AND filter3...} tipo-atributo tamao-mximo -FILTER= filter2 OR|AND filter3...}
Los parmetros REPLACEFIRST y REPLACEALL opcionales, que slo son vlidos cuando se utilizan con SCANREGEX o MATCHREGEX, y slo con +FILTER, contienen la siguiente sintaxis:
nombre-atributo tipo-atributo tamao mximo +FILTER={MATCHREGEX|SCANREGEX(offset, patrn-regex),REPLACEFIRST|REPLACEALL(cadena-sustitucin) OR|AND MATCHREGEX|SCANREGEX(desplazamiento, patrn-regex),REPLACEFIRST|REPLACEALL (cadena-sustitucin)...}
Descripcin
Puede definir un mximo de 50 filtros para un atributo. Los filtros de los atributos pueden estar conectados lgicamente mediante operadores OR u operadores AND, pero no mediante una combinacin de operadores OR y AND. Los primeros dos ejemplos
nombre-atributo tipo-atributo tamao-mximo +FILTER={filter1 OR filter2 OR filter3} nombre-atributo tipo-atributo tamao-mximo +FILTER={filter1 AND filter2 AND filter3}
Cada atributo en un grupo de atributo puede tener su propia definicin de filtros. El filtro Accept (+FILTER) especifica que se aceptan los datos de aplicacin como entrada. El filtro Reject (-FILTER) especifica que los datos de aplicacin se excluirn. La especificaciones de los filtros Accept y Reject deben ir delimitadas por llaves { }. Un filtro Accept y un filtro Reject no estn soportados en el mismo atributo. Debe poner en maysculas -FILTER, +FILTER, SCAN, MATCH, SCANREGEX, MATCHREGEX, NUMBER, REPLACEFIRST, REPLACEALL, y los operadores lgicos OR y AND. Debe haber al menos un espacio en blanco antes y despus de los operadores OR y AND. Debe definir cada especificacin de filtro con el siguiente formato:
funcin-filtro(desplazamiento-datos, valor-filtro)
La funcin-filtro consiste en funciones de cadenas de caracteres y funciones numricas. Las funciones de cadenas de caracteres se utilizan para la definicin de filtros para tipos datos de atributos de caracteres, como DisplayType o RecordType. Las funciones numricas operan con datos de atributos numricos, como CounterType. Si se especifica un texto que no est en ingls para cualquier funcin de filtro de cadena de caracteres, deber guardar el metarchivo en codificacin de UTF-8. La funcin-filtro incluye dos operandos posicionales, desplazamiento de datos y valor-filtro, rodeados de parntesis. Desplazamiento-datos define el desplazamiento desde el principio de los datos de atributo donde se hace la comparacin para los datos-filtro. Para aquellas funciones de filtro numricas, el parmetro posicional desplazamiento-datos no puede omitirse, pero debe ser cero. Para las funciones de filtro de caracteres, desplazamiento-datos se basa en cero. Por consiguiente, el valor de desplazamiento no puede ser equivalente al tamao mximo del atributo o el filtro no es vlido. Si busca un carcter de inicio determinado en un atributo, especifique 0 como el desplazamiento-datos. Si busca un carcter de finalizacin especfico en un atributo, especifique un desplazamiento-datos que sea menor que el tamao mximo del atributo.
182
Comprueba la ocurrencia de la cadena de D,R,T,Z,N,U caracteres de filtro en la cadena de caracteres atributos desde la posicin de desplazamiento hasta el final de la cadena de datos de atributos o hasta un tamao de atributo mximo definido. Comprueba la coincidencia exacta de la ocurrencia de la cadena de caracteres de filtro en la cadena de atributos desde la posicin de desplazamiento. D,R,T,Z,N,U
MATCH
0<tamao mx.
Caracteres
SCANREGEX
Comprueba la ocurrencia de la cadena de D,R,T,Z,N,U caracteres patrn de expresiones regulares empezando desde la posicin de desplazamiento hasta el final de la cadena de datos de atributo, o hasta el tamao mximo de atributo definido. D,R,T,Z,N,U
0<tamao mx.
Caracteres
MATCHREGEX Comprueba la coincidencia exacta de la ocurrencia de la cadena de caracteres patrn de expresiones regulares en la cadena de caracteres de atributos empezando desde la posicin de desplazamiento. NUMBER= NUMBER> NUMBER< NUMBER>= NUMBER<= Valor del atributo de comparacin igual que el valor del filtro. Valor de atributo de comparacin mayor que el valor del filtro. Valor de atributo de comparacin menor que el valor del filtro.
0<tamao mx.
Caracteres
0 0 0 0 0
Valor de atributo de comparacin mayor o A,C,G,?, igual que el valor del filtro. #,% Valor de atributo de comparacin menor o A,C,G,?, igual que el valor del filtro. #,%
Nota: Si el proveedor de datos de archivo est supervisando un archivo en modalidad COPY, el primer registro del archivo empieza un bloque de registros. Por lo tanto, el registro siempre se selecciona y se visualiza en el espacio de trabajo, independientemente de si se debe haber excluido debido a un filtro. Para obtener una descripcin completa de la opcin COPY, consulte <modalidad-archivo> Sentencia SOURCE en la pgina 140. Ejemplo 1 El proveedor de datos de archivo de Tivoli Universal Agent supervisa un archivo para actividades de inicio de sesin de un cliente. El filtro del atributo realiza un filtrado inicial aceptando nicamente aquellos registros de archivos que contengan la cadena de caracteres Procesando inicio de sesin o PRIMER INICIO DE SESIN.
//APPL ABC //NAME SignOn S 900 //SOURCE FILE f:\IB.log tail //ATTRIBUTES
183
Ejemplo 2 Tivoli Universal Agent supervisa transacciones de aplicaciones. El programa de aplicacin graba como salida un carcter de guin siempre que un cliente proporcione una solicitud de transaccin que no sea vlida. El filtro del atributo rechaza todos los datos de entrada con el atributo de transaccin - para eliminar los registros de aplicacin que no son vlidos.
//NAME Transaction_Stat e //ATTRIBUTES , CustomerName D CustomerAddress D Date D Time D TransactionName D TransactionParameters D
Ejemplo 3 Tivoli Universal Agent supervisa un registro de servidor de Internet para cdigos de estado del servidor de Internet mayores que 400.
//NAME Status_Stat e //SOURCE FILE C:\Archivos de programa\WebServer\server.log //ATTRIBUTES ClientLocation D 256 ClientUserName D 32 Authorized_User K 32 Date_Time DL 20 Time_Zone K 5 Request D 256 ServiceStatus C 99999999 +FILTER={NUMBER>=(0,400)} BytesReceived C 99999999 Referral D 256 Browser D 256
184
Debe prestar especial atencin a cualquier error de metarchivo o mensaje de aviso de los filtros de expresiones regulares. El analizador de metarchivos de Tivoli Universal Agent notifica los errores sealados durante la compilacin de ICU de una expresin regular. Estos errores de sintaxis de ICU suelen indicar que no se puede utilizar una definicin de filtro en el formato actual y se omite. Si se omite una definicin de filtro debido a un problema de sintaxis, afectar a la salida del espacio de trabajo porque las filas de datos no se han incluido ni excluido de acuerdo con lo previsto. Hay otros avisos de validacin que indican un posible problema en un filtro de expresiones regulares; por ejemplo, un metacarcter ^ de inicio de lnea con un desplazamiento FILTER que no es igual a cero. De nuevo, estos tipos de avisos de validacin de metarchivo suelen significar que necesita revistar y modificar el parmetro FILTER para garantizar que el funcionamiento es correcto. Para utilizar de forma eficaz el soporte de expresiones regulares en Tivoli Universal Agent, debe estar familiarizado con las especificaciones de cmo ICU implementa expresiones regulares, que no es idntico a cmo se implementa el soporte de expresiones regulares en regex4j de Perl, grep, sed Java y otras implementaciones que tal vez hayan funcionado en su caso en el pasado. Las tablas del Apndice F, Expresiones regulares ICU, en la pgina 235 se han extrado de la publicacin ICU User Guide en la direccin: http://icu.sourceforge.net/userguide/regexp.html. Consltelas cuando codifique filtros de expresiones regulares en los metarchivos. Nota: Un atributo FILTER que utiliza una expresin regular consume ms CPU que un atributo FILTER que no lo hace. Por lo tanto, si tiene una opcin entre realizar el filtrado de atributos con o sin una expresin regular, no utilice la expresin regular porque requiere ms sobrecarga del sistema. Para ilustrar cmo se implementar el soporte de expresiones regulares para filtros de atributos, a continuacin se suministra un ejemplo de metarchivo simple:
//APPL REGEX //NAME LOGMONITOR E 300 //SOURCE FILE /var/log/messages Tail //ATTRIBUTES ; Timestamp T 16 Message Z 512 +FILTER={SCANREGEX(0,^.*Error al asignar recurso.*$) OR SCANREGEX(0,^.* nmero de canal fuera de rango.*$)}
En este ejemplo, el archivo /var/log/messages se supervisa en modalidad Tail. El atributo Message tiene un parmetro +FILTER que acepta cualquier valor de Message que consiste en cualquiera de las dos cadenas de caracteres patrones de expresiones regulares (porque el conector entre las dos condiciones de filtro es OR en lugar de AND). El tipo de filtro SCANREGEX se ha especificado, pero como el patrn de expresin regular indica que se est buscando una coincidencia exacta de todo el valor de atributo, en vez de una subcadena de caracteres dentro del valor, tambin se puede utilizar el tipo de filtro MATCHREGEX. Los metacaracteres de la expresin regular ^, . *, y $ indican que se tiene que realizar coincidencias al principio de una lnea, coincidencias cualquier carcter, coincidencias 0 o ms veces y coincidencias al final de una lnea, respectivamente. Cuando el proveedor de datos de archivo lee y procesa cada registro nuevo en el archivo /var/log/messages, llama a una API de ICU para determinar si el valor de atributo de Message coincide con el patrn nmero 1 o el patrn nmero 2 del filtro de expresiones regulares. Si se devuelve un resultado TRUE para cualquiera de los dos patrones, se acepta toda la fila de datos, lo que significa que es idneo para la evaluacin de situaciones y la visualizacin de espacios de trabajo del portal. En el siguiente ejemplo, se muestra cmo se puede utilizar uno de los parmetros REPLACE de expresiones regulares, junto con una combinacin de nmeros de grupo de captura y texto literal, para transformar los datos de entrada. Supongamos que un campo de texto de mensaje tpico en un archivo de registro contiene el siguiente valor:
MSG1991E SYSTEMX encountered failure in Process ABC
185
A cada cadena de caracteres patrn especificada entre parntesis se le asigna un nmero de grupo de captura en secuencia ascendente. Al asignar la subcadena de caracteres Process &processName al grupo de captura 3 y la subcadena de caracteres SYSTEMx al grupo de captura #2, el parmetro REPLACEFIRST puede transformar los datos del atributo de entrada en un formato que sea ms adecuado para sus finalidades. Hay consideraciones especiales cuando se utilizan filtros de expresiones regulares con fuentes de datos de varias lneas que especifican la sentencia RECORDET. Normalmente, los caracteres de retorno de carro/salto de lnea (CR/LF) se eliminan cuando se llenan valores de atributos para una fuente de datos de varias lneas. Pero si, por ejemplo, se supervisa un archivo de registro utilizando RECORDSET con el filtrado de expresiones regulares, los caracteres CR/LF se conservan de tal modo que la lgica de filtrado de expresiones regulares pueda explorar todo el almacenamiento intermedio de atributos de varias lneas y buscar los caracteres CF/LF intercalados para cada especificacin FILTER. Como ejemplo, se suministran dos registros de archivo de varias lneas:
<replication-status when="2006-01-18 16:15:11" lastStatus="SUCCESS03" src="C:\TivoliCDP\2006-01-18_16.14.03_BackupErr.xml" action="Copy"
dst="\\matrix26\temp\RealTimeBackup\Matrix33\BackupAdmin\Reports\2006-01-18_16.14.03_BackupLog.xml" size="23043" priority="3" time="1137622511" ID="568809902500042503"/> <replication-status when="2006-01-18 16:15:11" lastStatus="SUCCESS04" src="C:\TivoliCDP\2006-01-18_16.14.03_BackupErr.xml" action="Copy"
Y a continuacin, se muestran las sentencias de definicin de metarchivo que buscan una subcadena de caracteres especfica en el segundo registro:
//RECORDSET 10 NEW(0,==,replication-status) //ATTRIBUTES Date D 32 DLM="" Message Z 512 DLMSTR=/> +FILTER={ScanRegex(0,.*\n.*03_BackupErr.*$)}
Un nico carcter \n de lnea nueva forma parte del patrn +FILTER. Por lo tanto, slo el segundo registro de varias lneas, que contiene la subcadena de caracteres 03_BackupErr.xml despus del carcter \n coincide con +FILTER. En el primer registro con varias lnea, tambin se puede encontrar la subcadena de caracteres 03_BackupErr.xml; sin embargo, va delante del carcter \n y por lo tanto, no es una coincidencia. Cuando la bsqueda de patrones de expresiones regulares se completa para un grupo de atributos RECORDSET, la lgica de filtrado de Universal Agent elimina los caracteres CR/LF para poder visualizar mejor los valores de atributo en Tivoli Enterprise Portal.
186
La principal ventaja del secuenciado de definiciones de atributos con el uso del parmetro SEQ=nn es evitar cambios de versiones importantes para determinados tipos de actualizaciones de metarchivos. Supongamos, como ejemplo sencillo, que est supervisando un registro con el siguiente formato:
Attr1;Attr2;Attr3;Attr4
Si en algn punto en el futuro, el formato del registro de archivo cambia y se inserta un nuevo campo entre Attr3 y Attr4, puede modificar el metarchivo del modo siguiente:
Attr1 Attr2 Attr3 Attr5 Attr4 D D D D Z 8 16 4 12 128
Pero esta actualizacin de metarchivo desencadena una versin de aplicacin importante porque Attr4 ya no va inmediatamente despus de Attr3, y eso afecta a las situaciones, polticas y polticas personalizadas existentes. Para implementar esta actualizacin nicamente como un cambio de versin secundaria, puede modificar el metarchivo del modo siguiente:
Attr1 Attr2 Attr3 Attr5 Attr4 D D D D Z 8 16 4 12 128 SEQ=1 SEQ=2 SEQ=3 SEQ=5 SEQ=4
El uso de los parmetros SEQ permite alterar temporalmente la secuencia del atributo predeterminado, lo que hace que Tivoli Universal Agent aada el nuevo campo Attr5 al final del grupo de atributos. Desde el punto de vista del servidor de supervisin y del servidor del portal, slo se ha producido un cambio de versin de menor importancia. Pero tenga presente que cuando el proveedor de datos de archivo lee y analiza los registros del archivo de entrada, seguir procesando correctamente el nuevo campo Attr5 que se ha insertado entre Attr3 y Attr4. Otra ventaja del secuenciado de atributos es que permite consolidar aplicaciones cuando se trabaja con varios conjuntos de entrada de datos que son muy similares, por no decir, prcticamente idnticos. Por ejemplo, los registros del servidor WEB de un servidor Apache, un servidor Netscape o Microsoft IIS contienen informacin similar. No obstante, los formatos de registros son distintos. Sin la definicin de secuencia de atributos, son necesarios tres metarchivos de tres nombres de aplicaciones exclusivos. Cada metarchivo contiene atributos similares, secuenciados en el orden correspondiente de formato del archivo de registro del servidor WEB. Las tres aplicaciones necesitan una cantidad considerable de trabajo para crear situaciones y polticas de Tivoli Monitoring y, como resultado, aumentan la complejidad de la gestin de aplicaciones. El siguiente ejemplo representa una definicin de metarchivo para un registro de servidor Apache y un registro Microsoft IIS. Los archivos de registro se visualizan como la misma aplicacin eLog cuando se utilizan definiciones de secuencia de atributos para limar las diferencias:
//APPL eLog //NAME ServerLog e //SOURCE FILE d:\Apache\logs\Apache.log tail //ATTRIBUTES *-------------------------------------------* * Apache Server Log Record Format Layout * *-------------------------------------------* ClientLocation D 256 SEQ=1
Apndice B. Definiciones de atributos
187
ClientUserName Authorized_User Date_Time Time_Zone Request ServiceStatus BytesReceived Referral Browser Service ServerName RequestParameters BytesSend RequestElapsedTime *
D K DL K D C C D D D D D C C
32 SEQ=2 32 20 SEQ=3 5 256 SEQ=9 99999999 SEQ=8 99999999 SEQ=6 256 SEQ=12 DLM=/" 256 SEQ=13 DLM="" 32 SEQ=4 256 SEQ=5 256 SEQ=10 99999999 SEQ=7 99999999 SEQ=11
A continuacin, se muestra un metarchivo IIS implementado de una manera tal que conserva los nmeros de secuencia de atributos comunes del metarchivo Apache.
//APPL eLog //NAME ServerLog e //SOURCE FILE C:\Inetpub\logs\IIS.log tailbyrecord //ATTRIBUTES , *-------------------------------------------* * Microsoft IIS W3C Log Record Format Layout* *-------------------------------------------* ClientLocation D 256 SEQ=1 ClientUserName D 32 SEQ=2 Date_Time D 20 SEQ=3 Service D 32 SEQ=4 ComputerName K 64 ServerName D 256 SEQ=5 RequestElapsedTime C 99999999 SEQ=11 BytesReceived C 99999999 SEQ=6 BytesSend C 99999999 SEQ=7 ServiceStatus C 99999999 SEQ=8 WindowsStatus K 99999999 OperationName K 8 Request D 256 SEQ=9 RequestParameters D 256 SEQ=10 PadParm2 K 8 PadParm3 K 8 PadParm4 K 8 PadParm5 K 8 Referral D 256 SEQ=12 Browser D 256 SEQ=13
En el siguiente ejemplo, un programa cliente de la API empieza a enviar tres nuevos atributos a la aplicacin de metarchivo. Al utilizar definiciones de secuencias de atributos, se evita un cambio de versin importante. Definicin de datos de aplicacin antigua:
//APPL DTY //NAME ConsoleMessage //ATTRIBUTEs ; MessageID D MessageSeverity C MessageCategory C MessageDescription Z e 12 99 99 255
SEQ=5
188
D C C D D Z
Un atributo que no incluye una especificacin de secuencia se visualiza despus de los atributos con especificaciones de secuencias en el orden en que se define en el metarchivo. En el ejemplo anterior, el atributo MessageAction se visualiza despus del atributo MessageOrigin y va seguido por el atributo MessageStatus.
189
190
donde: AAA NNN VV es el nombre de la aplicacin es el nombre del grupo de atributos es el nmero de versin de la aplicacin
Por ejemplo, el nombre del grupo de atributos que se corresponde con el espacio de trabajo SNMP-MANAGER TRAP:
SNMP-MANAGERTRAP00
191
Tabla 28. Tabla de conversin de ASN.1 a tipos de IBM Tivoli Monitoring (continuacin) Tipo ASN.1 OCTETS (SIZE(0..n)) Definicin Una secuencia de cero o ms octetos (bytes). Si el tamao no est definido, se utilizar un valor predeterminado de 256 y puede producirse truncamiento. Una secuencia de enteros no negativos en notacin separada por puntos. Se trata como una cadena de caracteres con una longitud mxima de 1024. Una lista de enumeracin INTEGER (0..4294967295) INTEGER (0..4294967295) INTEGER (0..4294967295) Cadena de octetos SIZE((4)). Esta es la direccin de entero de 4 bytes convertida a una cadena con un nombre de host o una direccin decimal separada por puntos. Igual que la anterior Cadena de octetos Tipo de IBM Tivoli Monitoring Matriz de caracteres de tamao N
OID
Matriz de caracteres de un tamao mximo de 1024 Entero con signo de 32 positivo INTEGER (0..2147483647) INTEGER (0..2147483647) INTEGER (0..2147483647) Matriz de caracteres de tamao 32
NetworkAddress Opaque
Nota: Hay una discrepancia entre los tipos de IBM Tivoli Monitoring soportados y la especificacin SMIv1. De acuerdo con SMIv1, los contadores de 32 bits tienen un valor mximo de 4294967295, que es el lmite superior del entero sin signo de 32 bits. Sin embargo, IBM Tivoli Monitoring slo da soporte a enteros con signo de 32 bits, y sta es la razn por la que hay un mximo de 2147483647 para los tipos de atributos numricos de Universal Agent como por ejemplo, Gauge y Counter.
v UDPTABLE
192
193
Address
La direccin IP del nodo gestionado.
Entradas vlidas
Una direccin IP decimal separada por puntos.
Ejemplo
*SCAN SNMP-MANAGERMANAGED-NODES00.Address *EQ 127.0.0.0
Current_Response_Time_ms
El tiempo de respuesta de viajes de ida y vuelta para solicitudes de ping enviadas desde el proveedor de datos de SNMP al nodo.
Entradas vlidas
Milisegundos
Ejemplo
*SCAN SNMP-MANAGERMANAGED-NODES00.Current_Response_Time_ms *GE 500
Name
El nombre de nodo resoluble
Entradas vlidas
v Cadena de texto v De hasta 128 caracteres
Ejemplo
*SCAN SNMP-MANAGERMANAGED-NODES00.Name *EQ Everest
Node_Description
La descripcin de las caractersticas del nodo como estn definidas por un administrador de red o por el fabricante del dispositivo.
Entradas vlidas
v Cadena de texto v Hasta 256 caracteres
Ejemplo
*SCAN SNMP-MANAGERMANAGED-NODES00.Node_Description *EQ hub
Node_Status
El estatus operativo actual del nodo.
Entradas vlidas
v On-line v Off-line
194
Ejemplo
*SCAN SNMP-MANAGERMANAGED-NODES00.Node_Status *EQ Off-line
Node_Type
El tipo de nodo de red, tal como est definido en la especificacin de la variable MIB sysServices de RFC 1213 System Group estndar de Internet.
Entradas vlidas
Los tipos vlidos son: Repeaters Bridges Gateways Hosts Applications IP Node El nodo soporta los protocolos de capa 1 (capa fsica). El nodo soporta los protocolos de capa 2 (enlace de datos y subred). El nodo da soporte a protocolos de capa 3 (entre redes) como los direccionadores IP. El nodo soporta el funcionamiento de red de extremo a extremo. El nodo es capaz de ejecutar aplicaciones de red como servidores de correo. Un host IP vlido sin agentes SNMP activos.
Utilizacin
Utilice una cadena delimitada por comas para especificar varios tipos.
Ejemplo
*VALUE MANAGED-NODES00.Node_Type *EQ Gateways,Hosts,IP Node
Status_TimeStamp
La fecha y la hora en que se comprob por ltima vez el estatus del nodo
Entradas vlidas
El formato es aaaa/mm/dd hh:mm:ss mmm
Ejemplo
2005/04/30 14:23:55 010
195
Enterprise_Module
El nombre de empresa de la MIB de recopilacin de datos.
Entradas vlidas
v Cadena de texto v Hasta 64 caracteres.
No_Data_Tables
Una lista de tablas de empresa para las que el agente no devuelve datos.
Entradas vlidas
v Cadena de texto v Hasta 216 caracteres.
Node_Name
Nombre de nodo del sistema gestionado.
Entradas vlidas
v Cadena de texto v Hasta 32 caracteres.
196
Attribute_Group
El nombre del grupo de atributos para el cual se estn recopilando datos
Entradas vlidas
v Cadena de texto v Hasta 32 caracteres
Ejemplo
*SCAN SNMP-MANAGERMIBSTATUS00.Attribute_Group *EQ MIB-2EGP00
Enterprise
El nombre de la empresa en la MIB en la que se basa la aplicacin supervisada
Entradas vlidas
v cadena de texto v hasta 64 caracteres
Monitor_Agent_Info
Una cadena de pares de nombre de hostnombre de comunidad para los hosts que se estn supervisando actualmente
Entradas vlidas
v delimitados por llaves v separados por comas
Ejemplo
{athens public},{sparta public}
Monitor_Interval
El intervalo de supervisin activo actualmente
Entradas vlidas
v segundos
Last_Sample_TimeStamp
La fecha y la hora en que los datos se muestrearon por ltima vez
Entradas vlidas
El formato es aaaa/mm/dd hh:mm:ss mmm
Ejemplo
2005/04/30 14:23:55 010
197
Active_Nodes
El nmero total de nodos de red que estn activos en la actualidad
Entradas vlidas
v entero
Curr_RespTime_ms
El tiempo de respuesta actual, en milisegundos, de los paquetes de datos del proveedor de datos de SNMP que se encuentran en esta red
Entradas vlidas
v entero
Inactive_Nodes
El nmero total de nodos de red que estn inactivos, incluidas las direcciones de red sin ocupar disponibles en esta red
Entradas vlidas
v entero
Managed
Indica si una red en particular se est gestionando
Entradas vlidas
v S v No
Max_RespTime_ms
El tiempo de respuesta mximo observado, en milisegundos, de los paquetes de datos del gestor SNMP a los nodos que se encuentran en esta red
Entradas vlidas
v entero
Min_RespTime_ms
El tiempo de respuesta mnimo observado, en milisegundos, de los paquetes de datos del proveedor de datos de SNMP a los nodos que se encuentran en esta red
Entradas vlidas
v entero
Network_Address
Direccin de Internet de 32 bits de la subred de la red TCP/I
Entradas vlidas
v formato decimal separado por puntos
198
Ejemplo
127.0.0.0
Network_Mask
La mscara de red de una direccin de red descubierta
Entradas vlidas
v formato decimal separado por puntos
Ejemplo
127.0.0.0
Network_Routers
Una lista de direccionadores que sirven a esta red
Entradas vlidas
v hasta 256 caracteres v separados por comas
Ejemplo
smbb7k-s23,wlbbags-s3,198.210.36.1
199
Address
La direccin de red de Internet de un nodo dentro de una red gestionada
Entradas vlidas
v direccin decimal separada por puntos
Description
La descripcin de las caractersticas del nodo como estn definidas por un administrador de red o por el fabricante del dispositivo. El valor de este atributo corresponde a la especificacin de la variable MIB sysDescr de RFC 1213 System Group.
Entradas vlidas
v hasta 256 caracteres
Location
La informacin de ubicacin del nodo como est definida por un administrador de red. El valor de este atributo corresponde a la especificacin de la variable MIB sysLocation de RFC 1213 System Group.
Entradas vlidas
v hasta 128 caracteres
Name
El nombre asignado a este nodo
Entradas vlidas
v hasta 128 caracteres
SNMP_Enabled
Indica si un agente de SNMP MIB-2 est activo en el nodo de red
Entradas vlidas
v S v No
Status
El estatus operativo actual del nodo de red
Entradas vlidas
Los estatus posibles se muestran en la tabla siguiente: On-line Inactive Se ha establecido contacto con el nodo y est operativo El nodo no est operativo y no responde a las solicitudes SNMP Get o solicitudes ping
Type
El tipo de nodo de red, tal como est definido en la especificacin de la variable MIB sysServices de RFC 1213 System Group estndar de Internet.
200
Entradas vlidas
Los tipos vlidos son: Repeaters Bridges Gateways Hosts Applications IP Node El nodo soporta los protocolos de capa 1 (capa fsica). El nodo soporta los protocolos de capa 2 (enlace de datos y subred). El nodo da soporte a protocolos de capa 3 (entre redes) como los direccionadores IP. El nodo soporta el funcionamiento de red de extremo a extremo. El nodo es capaz de ejecutar aplicaciones de red como servidores de correo. Un host IP vlido sin agentes SNMP activos.
Utilizacin
Puede entrar una cadena delimitada por comas para especificar varios tipos.
Ejemplo
Applications,Hosts,Gateways,Bridges
201
Destination_Networks
Una lista de las direcciones de red servidas por un direccionadores
Entradas vlidas
v direcciones decimales separadas por puntos v delimitas por comas
Ejemplo
127.0.0.0, 127.0.0.1
Route_Count
El nmero total de subredes direccionables definidas para este direccionador
Entradas vlidas
v enteros
Router_Address
La direccin de red de Internet del direccionador
Entradas vlidas
v formato decimal separado por puntos
Ejemplo
127.0.0.0
Router_Description
Una descripcin de las caractersticas del direccionador, tal como la ha definido el fabricante del dispositivo. El valor de este atributo corresponde a la especificacin de la variable MIB sysDescr de RFC 1213 System Group.
Entradas vlidas
v hasta 256 caracteres
Router_Name
El nombre asignado a este direccionador
Entradas vlidas
v hasta 64 caracteres
Router_Status
El estatus actual del direccionador
Entradas vlidas
Los estatus posibles son: Verify On-line Off-line El proveedor de datos de SNMP est en proceso de verificar el estatus del direccionador. El direccionador est activo y operativo. El direccionador no est operativo
202
Passive
203
Alert_Name
El nombre de alerta asociado con una condicin de excepcin como se define en el archivo de configuracin de condiciones de excepcin
Entradas vlidas
v hasta 32 caracteres
Category
La categora del suceso que ha generado la condicin de excepcin como se define en el archivo de configuracin de condiciones de excepcin
Entradas vlidas
Las categoras predeterminadas son: v Sucesos de umbral v Sucesos de topologa de red v Sucesos de error v Sucesos de estatus v Sucesos de configuracin de nodo v v v v v Sucesos de alerta de aplicacin (valor predeterminado) Sucesos de todas las categoras Registrar slo sucesos Correlacionar sucesos Pasar por alto sucesos
Utilizacin
En la definicin de situacin, rodee los valores de comillas dobles ().
Description
La descripcin de la condicin de excepcin como se define en el archivo de configuracin de condiciones de excepcin.
Entradas vlidas
v hasta 256 caracteres
Enterprise_Name
La forma textual abreviada del ID de objeto empresarial como se define en el archivo de configuracin de condiciones de excepcin
Entradas vlidas
v hasta 64 caracteres
Utilizacin
Debe especificar el nombre exactamente como aparece en el archivo de configuracin de condiciones de excepcin. El nombre es sensible a maysculas y minsculas. En la definicin de situacin, rodee los valores de comillas dobles ().
204
Generic_Trap
En nmero de condicin de excepcin genrica
Entradas vlidas
Uno de: 0 1 2 3 4 5 6 ColdStart WarmStart LinkDown LinkUp Error de autentificacin EGPNeighborLoss Condicin de excepcin especfica de la empresa
Ejemplo
*SCAN SNMP-MANAGERTRAP00.Generic_Trap *EQ 2
Object ID
El identificador que identifica exclusivamente la condicin de excepcin en el MIB
Entradas vlidas
v cadena de texto v hasta 512 caracteres
Severity
La gravedad de la condicin de excepcin como se define en el archivo de configuracin de condiciones de excepcin
Entradas vlidas
v cadena de texto v hasta 32 caracteres
Source_Name
El nombre de host o direccin IP del agente de SNMP que ha enviado la condicin de excepcin
Entradas vlidas
v cadena de texto v hasta 64 caracteres
Source_Status
Identifica un estatus con una fuente como se define en el archivo de configuracin de condiciones
Entradas vlidas
v cadena de texto v hasta 32 caracteres
Source_Type
Especifica con ms detalles una categora fuente de condiciones de excepcin de SNMP como se define en el archivo de configuracin de condiciones de excepcin
Apndice C. Atributos de SNMP
205
Entradas vlidas
v cadena de texto v hasta 32 caracteres
Specific_Trap
El nmero de condicin de excepcin especfico de la empresa. Slo se aplica cuando Generic_Trap = 6.
Entradas vlidas
v entero
Time_Stamp
La fecha y la hora en que se ha producido la condicin de excepcin
Entradas vlidas
El formato es SAAMMDDHHMMSSmmm, donde
S AA MM DD HH MM SS mmm = = = = = = = = Siglo (1 para el XXI) Ao Mes Da Hora Minuto Segundo Milisegundo
Value_List
Una cadena con todos los datos de una lista de vinculacin variable de condicin de excepcin
Entradas vlidas
La cadena se construye de la siguiente manera:
{OID[tipo]=valor}{OID[tipo]=valor}{oid[tipo]=valor}...
donde: oid tipo valor define el identificador de objeto variable MIB es el tipo ASN.1 es el valor de la variable
Cada triplete est delimitado por llaves ({ }). Si se importa un metarchivo que contenga los nombres de las variables en la condicin de excepcin recibida, utilice nombres de variables en lugar de OID puros:
{nombreVariable=valor}
Ejemplo
*SCAN SNMP-MANAGERTRAP00.Value_List *EQ datagram=error
206
Tambin puede llamar al programa kumpcon desde dentro de un script, lo cual es til para automatizar aquellas tareas que se realizan frecuentemente. Para que se ejecute el programa KUMPCON, deber ser capaz de encontrar sus bibliotecas compartidas. En los sistemas operativos Windows, las bibliotecas compartidas se encuentran en el mismo directorio que el programa KUMPCON por lo que no tendr problema alguno en encontrarlas. Puede obtener una lista de los mandatos de consola vlidos entrando:
KUMPCON ?
Puede entrar un mandato de forma abreviada. Por ejemplo, puede entrar el mandato DELETE como DELETE o D y el mandato SHOW como SHOW o SHO. Se permiten caracteres tanto en maysculas como en minsculas. El programa convierte todos los caracteres de mandato de entrada a maysculas para su validacin.
207
Llame a um_console sin especificar ningn mandato de consola. Despus de que el script invoque el programa KUMPCON, se le solicitar un mandato:
Entre el mandato de la consola <Nombre de aplicacin o Nombre de metarchivo o nombre de archivo>
Si el nombre de metarchivo contiene blancos intercalados, debe delimitarlos con comillas simples y dobles; por ejemplo:
kumpcon refresh "C:\Archivos de programa\test\myappl.mdl"
Cdigos de retorno
Si emita mandatos de consola dentro de scripts y necesita comprobar los cdigos de retorno, KUMPCON slo tiene dos posibles cdigos de retorno:
0 -1 - Mandato satisfactorio - Mandato errneo
208
La interfaz de actuacin no tiene este problema de ambigedad. Cuando distribuya una accin como Importar o Renovar, la lista de nombres de sistemas gestionados disponibles incluye el prefijo Nombre de instancia para que siempre pueda seleccionar el proveedor de datos adecuado.
Tabla 29. Resumen de los mandatos de consola Mandato de consola DELETE* GENERATE Descripcin Elimina una especificacin definida de datos de aplicacin Crea un metarchivo de ODBC completo y sintcticamente correcto cuando se le proporciona un nombre de fuente de datos como entrada. Carga e inicializa una definicin de datos de aplicacin. Lista las aplicaciones definidas actualmente. Carga e inicializa la tabla de nombres de comunidad del agente, KUMSCOMM. Carga las listas de nodos gestionados (listas de favoritos). Carga e inicializa la tabla de nombres simblicos de red, KUMSNAME. Aade una entrada en una lista de nodos gestionados. Elimina una entrada de una lista de nodos gestionados. Reinicia una definicin de datos de aplicacin. Permite redirigir los mandatos de consola a un Tivoli Universal Agent apropiado que est ejecutndose en un host distinto del host desde el que se emiten los mandatos. Muestra los detalles de definicin de datos de la aplicacin. Inicia el procedimiento normal de conclusin. Ordena al proveedor de datos de SNMP que renueve el archivo de configuracin de excepcin de SNMP. Desempaqueta el metarchivo de SNMP de entrada y produce de salida la versin idntica descomprimida del metarchivo en la misma ubicacin del metarchivo de entrada. Ordena a Tivoli Universal Agent que valide el metarchivo especificado.
IMPORT* LIST LOADCOMM* LOADLIST* LOADNAME* MNL ADD NODE* MNL REMOVE NODE* REFRESH* SET
VALIDATE
209
DELETE
El mandato DELETE elimina una aplicacin definida del repositorio de Tivoli Universal Agent. Si la aplicacin est activa, Tivoli Universal Agent desconecta la conexin de la aplicacin y anula su registro. Cualquier sistema gestionado por IBM Tivoli Monitoring asociado con la aplicacin que se encuentre en lnea pasar a estar fuera de lnea. El nombre del metarchivo se elimina automticamente del archivo de inicializacin de configuracin KUMPCNFG para que la aplicacin no se active la prxima vez que se reinicie Tivoli Universal Agent.
Sintaxis
KUMPCON DELETE [nombre-aplicacin | nombre-metarchivo]
Parmetros
Puede especificar el nombre de la aplicacin de Tivoli Universal Agent o el nombre del metarchivo. <nombre-aplicacin> Especifica la aplicacin de Tivoli Universal Agent. El nombre de la aplicacin de Tivoli Universal Agent se especifica en la sentencia APPL en el metarchivo de definicin de datos. <nombre-metarchivo> Especifica el nombre de metarchivo
Utilizacin
Establezca la variable de entorno siguiente antes de invocar el mandato kumpcon delete para evitar un indicador de confirmacin de supresin:
KUMP_DPCONSOLE_NOCONFIRM=Y
La emisin del mandato delete desde un script automatizado es un ejemplo de cundo debe utilizarse esta variable de entorno.
210
GENERATE
El mandato GENERATE crea automticamente un metarchivo de ODBC completo y sintcticamente correcto cuando se le proporciona un nombre de fuente de datos como entrada. Este mandato da soporte a la generacin completa de tablas definidas por la fuente de datos especificada. Tambin puede limitar qu tablas se general seleccionando tablas de usuario, tablas de sistema, vistas o una combinacin de las tres, y especificando una cadena inicial de caracteres para realizar una comparacin de patrones con alguna de los tres tipos de tablas. El mandato GENERATE no da soporte a la creacin de metarchivos para procedimientos almacenados. Puede iniciar este mandato incluso si Tivoli Universal Agent no se est ejecutando. GENERATE slo es accesible en los sistemas operativos Windows y nicamente mediante la interfaz de consola kumpcon. No est disponible mediante actuacin.
Sintaxis
KUMPCON GENERATE NombreFuenteDatos user=IDusuario pswd=contrasea
Parmetros
<NombreFuenteDatos> Indica el nombre especfico de la fuente de datos configurada utilizado para crear el metarchivo de ODBC. Este parmetro es obligatorio. Si la fuente de datos contiene espacios en blanco incorporados, deber rodearse de comillas simples. <IDusuario> ID de usuario necesario para conectar a la fuente de datos ODBC. Si no se necesita ninguna combinacin de ID de usuario/contrasea para esta fuente de datos especfica, puede omitir el parmetro user= del mandato GENERATE <contrasea> Contrasea asociada con el ID de usuario que se conectar con la fuente de datos ODBC. Si se especifican, los valores de usuario y contrasea se insertan en cada sentencia //SOURCE en el metarchivo de ODBC generado.
Ejemplos
Los siguientes ejemplos ilustran maneras de invocar el mandato GENERATE:
KUMPCON GENERATE nwind
Este mandato genera un metarchivo en el directorio de metarchivos llamado nwind.mdl que contiene todas las tablas y columnas en la fuente de datos nwind.
KUMPCON GENERATE teps2 user=TEPS pswd=abcdef
Este mandato genera un metarchivo en el directorio de metarchivos denominado teps2.mdl que contiene cada tabla y columna en la fuente de datos teps2. Los parmetros user= y pswd= son obligatorios para conectarse a dicha fuente de datos. Despus de aceptar la entrada de la consola, puede indicar si desea incluir tablas de usuario, tablas del sistema o vista mediante las opciones de men e indicadores de mandatos, tal como se muestra en la Figura 13 en la pgina 212.
211
Si entra una opcin de men distinta de 4) Todas las anteriores, podr crear un metarchivo ms centrado y personalizado. Tambin es posible realizar una comparacin de patrones en una cadena inicial en el nombre de tabla, por ejemplo, todos las tablas de sistema que empiezan por sys. Una ventaja importante de generar tablas especficas, en lugar de todas las tablas, para una fuente de datos ODBC es que a veces puede reducir significativamente el tiempo que tarda en finalizar la generacin de metarchivo. Ciertos productos de bases de datos, como SQL Server y Sybase, permiten conectarse a una de varias bases de datos asociadas con una fuente de datos determinada. Si est generando un metarchivo para cualquiera de estos productos de bases de datos, se le solicitar que entre una base de datos especfica a utilizar. Cada contexto de base de datos a puede tener un conjunto de tablas de usuario distinto asociado al mismo. Si desea generar un metarchivo para un contexto de base de datos no predeterminado, conteste Y (S) en el indicador, entre el nombre de la base de datos y, de forma opcional, el nombre de un servidor especfico asociado con dicha base de datos. Si el contexto de base de datos predeterminado puede pasar por alto este indicador. El mandato GENERATE utiliza el nombre de la fuente de datos para determinar el nombre de metarchivo de salida. Si ya existe un metarchivo con ese nombre en el directorio \TMAITM6\metafiles, se le preguntar si desea sustituirlo.
Utilizacin
El metarchivo resultante proporciona un primer paso adecuado hacia la creacin de un metarchivo de ODBC til, aunque con toda probabilidad necesita de ciertos cambios. Despus de que haya finalizado KUMPCON GENERATE, revise las siguientes reas en el metarchivo para su posible modificacin: v Es necesario cambiar los primeros tres caracteres del nombre //APPL para que sean exclusivos. Ninguna otra aplicacin Tivoli Universal Agent con los mismos tres primeros caracteres deber conectarse al mismo servidor de Tivoli Enterprise Monitoring. v Se permite hasta un mximo de 64 tablas en un metarchivo. Una generacin completa de una fuente de datos ODBC puede resultar en cientos o incluso miles de sentencias //NAME. Si es as, y suponiendo que necesita supervisar ms de 64 tablas de la fuente de datos, considere la posibilidad de (1) establecer la variable de entorno KUMA_MAX_ATTRGROUPS_PER_APPL en un nmero mayor (se puede especificar un mximo de 256), (2) dividir las tablas en varios metarchivos y/o (3) crear sentencias SQL personalizadas en el metarchivo que seleccionen columnas de varias tablas para que no haya ms de una relacin de uno a uno entre las sentencias SQL Select y las tablas de fuentes de datos. v Se permite hasta un mximo predeterminado de 127 atributos en un nico grupo de atributos. Es posible que 127 no sea suficiente si existen ms columnas en una nica tabla SQL. Si este es el caso,
212
v v v
v v
v v
v v
considere dividir el grupo de atributos en grupos de atributos ms pequeos que seleccionen respectivamente un subconjunto de todas las posibles columnas SQL. Los dos problemas anteriores podran necesitar que se eliminen tablas y atributos no deseados. Revise la correccin los tipos de datos de atributos y tamaos mximos en caso de que no sean exactamente lo que desea. El mandato GENERATE construye una sentencia //SQL Select * from &tableName para cada grupo de atributos. Si desea utilizar un procedimiento almacenado en lugar de una sentencia Select, cambie la sentencia //SQL Select por //SQL proc=&procedureName segn convenga. Si la sentencia predeterminada Select * from &tableName captura demasiados datos, utilice una sentencia Select ms calificada con columnas especficas listadas o mediante filtro con la clusula Where. Algunos productos de base de datos, como por ejemplo DB2 y Oracle, requieren comillas dobles alrededor de los nombres de tablas que contengan caracteres en minsculas o especiales. Revise las sentencias SELECT en el metarchivo generado para nombres de tablas que necesiten comillas dobles. Por ejemplo, en el metarchivo de una tabla Oracle, cambie //SQL SELECT * from Tivoli.System por //SQL SELECT * from "Tivoli"."System". Revise cualquier atributo definido como KEY, que se corresponda con una columna indexada en la tabla SQL. Cada atributo KEY en cada fila de datos debe tener un valor no en blando y no NULO o bien no se enviar la fila al servidor de datos. Si a la tabla que est supervisando suelen faltarle valores de un atributo KEY, elimine la designacin KEY. De forma predeterminada, cada sentencia //NAME utiliza el nombre de tabla SQL como su nombre de grupo de atributos. Es posible cambiar algunos o todos estos atributos a nombres ms significativos. Compruebe cualquier atributo numrico que desee utilizar para propsitos de comparacin en situaciones o para crear atributos derivados. Estos deben definirse con uno de los tipos de atributos alfanumricos verdaderos, como C para Counter (contador). Si se genera un atributo genrico, por ejemplo, como tipo de atributo N, se tratar como una representacin de cadena de caracteres de un entero en lugar como un entero y las comparaciones de situaciones mayor/menor que no funcionarn tal como se ha previsto ni podr utilizar el atributo en un diagrama o grfico. Puede insertar caractersticas de metarchivo de Tivoli Universal Agent opcionales, como filtros, atributos derivados, AddTimeStamp y texto de ayuda sobre el atributo. Ser necesaria una alteracin temporal del parmetro maxrows=<nnn> en la sentencia //SOURCE si el valor predeterminado no es adecuado. De forma predeterminada, maxrows se establece con el valor 100 a no ser que sea alterado temporalmente mediante la variable de entorno KUMP_ODBC_MAX_ROWS. Asegrese de que el valor predeterminado de tiempo de vida de 300 segundos es apropiado. Si cualquier carcter de atributo en la tabla relacional contiene datos que no estn en ingls, cambie el tipo de atributo 'D' o 'N' a 'U' para Unicode.
Despus de hacer cambios en el metarchivo generado, ejecute VALIDATE contra el mismo para asegurarse de que no haya errores o mensajes de aviso que corregir.
213
IMPORT
El mandato IMPORT aade una aplicacin al repositorio de Tivoli Universal Agent. Si se importa satisfactoriamente el metarchivo, el nombre del metarchivo se aade al archivo de inicializacin de configuracin KUMPCNFG. A partir de entonces, se cargar el metarchivo de forma automtica cuando se reinicie el agente. Por lo tanto, slo necesita importar un metarchivo una vez.
Sintaxis
KUMPCON IMPORT nombre-metarchivo
Parmetros
<nombre-metarchivo> Especifica un nombre de metarchivo existente accesible para el proveedor de datos.
214
LIST
El mandato LIST muestra una lista de aplicaciones de metarchivo conocidas por Tivoli Universal Agent.
Sintaxis
KUMPCON LIST
Parmetros
Este mandato no necesita parmetros de entrada. Se ignorar cualquier parmetro especificado.
Salida
La salida del mandato LIST puede parecerse a la siguiente:
No se ha definido ninguna aplicacin
o bien
Definiciones de la aplicacin activa: vmstat.mdl TCPioQ.mdl CustInq.mdl
215
LOADCOMM
El mandato LOADCOMM ordena al proveedor de datos de SNMP que vuelva a cargar el archivo KUMSCOMM. El archivo KUMSCOMM relaciona los nombres de host con los nombres de comunidad SNMP.
Sintaxis
KUMPCON LOADCOMM
Parmetros
Este mandato no necesita parmetros de entrada. Se ignorar cualquier parmetro especificado.
216
LOADLIST
Carga la lista de nodos gestionados de SNMP (tambin conocida como lista de favoritos).
Sintaxis
KUMPCON LOADLIST nombre_lista_nodos_gestionados
Parmetros
<nombre_lista_nodos_gestionados> Nombre del archivo en el que est definida la lista de favoritos.
217
LOADNAME
El mandato LOADNAME ordena al proveedor de datos de SNMP que vuelva a cargar el archivo KUMSNAME. El archivo KUMSNAME define los nombres simblicos de las redes.
Sintaxis
KUMPCON LOADNAME
Parmetros
Este mandato no necesita parmetros de entrada. Se ignorar cualquier parmetro especificado.
218
Sintaxis
KUMPCON MNL Add Node LIST=nombre_lista_nodos_gestionados NODE=nombre_nodo
Parmetros
<nombre_lista_nodos_gestionados> Nombre de un archivo existente de la lista de nodos gestionados SNMP. <nombre_nodo> Nombre de recurso a aadir a la lista.
219
Sintaxis
KUMPCON MNL Remove Node LIST=nombre_lista_nodos_gestionados NODE=nombre_nodo
Parmetros
<nombre_lista_nodos_gestionados> Nombre de un archivo existente de la lista de nodos gestionados SNMP. <nombre_nodo> Nombre de nodo a eliminar de la lista.
220
REFRESH
El mandato REFRESH realiza las funciones combinadas de los mandatos DELETE e IMPORT.
Sintaxis
KUMPCON REFRESH nombre-metarchivo
Parmetros
<nombre-metarchivo> Especifica un nombre de metarchivo existente accesible para el proveedor de datos.
Utilizacin
Establezca la variable de entorno siguiente antes de invocar el mandato kumpcon refresh para evitar un indicador de confirmacin de renovacin:
KUMP_DPCONSOLE_NOCONFIRM=Y
La emisin del mandato refresh desde un script automatizado es un ejemplo de cundo debe utilizarse esta variable de entorno.
221
SET
Puede ejecutar el programa KUMPCON en un host diferente de aquel en el que est Tivoli Universal Agent. De forma predeterminada, KUMPCON presupone que debe comunicarse con Tivoli Universal Agent en el mismo host. Para dirigir los mandatos al Tivoli Universal Agent correspondiente en un host diferente, emita el mandato SET. Se le preguntar qu mandato desea emitir en el host remoto. Necesita emitir SET cada vez que desee emitir un mandato KUMPCON en un host remoto.
Sintaxis
KUMPCON SET nombrehost
Parmetros
<nombrehost> Especifica el nombre de host del sistema al que desea dirigir el mandato.
222
SHOW
El mandato SHOW muestra los detalles de una definicin de datos de aplicacin de Tivoli Universal Agent.
Sintaxis
KUMPCON SHOW [nombre-aplicacin | nombre-metarchivo]
Parmetros
Puede especificar el nombre de la aplicacin de Tivoli Universal Agent o el nombre del metarchivo. <nombre-aplicacin> Especifica la aplicacin de Tivoli Universal Agent. El nombre de la aplicacin de Tivoli Universal Agent se especifica en la sentencia APPL en el metarchivo de definicin de datos. <nombre-metarchivo> Especifica el nombre de metarchivo.
Mensajes
La salida del mandato SHOW puede parecerse a la siguiente:
El nombre de metarchivo entrado no est definido
o bien
Se ha aceptado la entrada de la consola. Metarchivo: vmstat.mdl Aplicacin: UXstatus Grupo: UXsysSta Poll Data TTL=15 SOURCE: API SystemName Display Type Max Size 16 OSversion Display Type Max Size 16 PendingIOwaitRate Counter Type IOstartRate Counter Type OcompleteRate Counter Type AvgWaitThreadQueueSi Counter Type AvgRunThreadQueueSiz Counter Type AvgNumbActivePageFra Counter Type AvgNumbFreePageFrame Counter Type PageInRate Counter Type PageOutRate Counter Type DevInterruptRate Counter Type SystemCallRate Counter Type ThreadContentSwitchR Counter Type AvgUserCPU% Counter Type AvgSystemCPU% Counter Type AvgIdleCPU% Counter Type AvgWaitCPU% Counter Type UDPpktInRate Counter Type UDPpktOutRate Counter Type TCPpktInRate Counter Type TCPpktOutRate Counter Type
223
SHUTDOWN
El mandato SHUTDOWN ordena a Tivoli Universal Agent que inicie el procedimiento de finalizacin. Tivoli Universal Agent desconecta todas las conexiones de aplicacin y realiza una anulacin de registro para cada aplicacin activa. Si no especifica IMMED, se le preguntar qu proveedor de datos desea detener.
Sintaxis
KUMPCON SHUTDOWN [IMMED]
Parmetros
IMMED o I (opcional) Inicia la conclusin inmediata de uno o todos los proveedores de datos sin ms mensajes ni confirmaciones.
224
TRAPCNFG
El mandato TRAPCNFG ordena al proveedor de datos de SNMP que renueve el archivo de configuracin de condiciones de excepcin de SNMP. Consulte el Apndice E, Configuracin de condiciones de excepcin de SNMP, en la pgina 229 para obtener informacin adicional TRAPCNFG.
Sintaxis
KUMPCON TRAPCNFG
Parmetros
Este mandato no necesita parmetros de entrada. Se ignorar cualquier parmetro especificado.
225
UNPACK
Algunos de los metarchivos SNMP ms antiguos de Tivoli Universal Agent se han distribuido en un formato comprimido y cifrado. Un ejemplo es el metarchivo de MIB-2, RFC1213_mib-2.mdl. Si necesita crear su propia versin personalizada de un metarchivo SNMP comprimido, primero ejecute el mandato UNPACK. El mandato UNPACK lee el metarchivo SNMP de entrada y genera como salida la versin descomprimida idntica del metarchivo, con una extensin .txt, en la misma ubicacin de directorio que el metarchivo SNMP de entrada. Puede ejecutar UNPACK incluso cuando Tivoli Universal Agent no est activo. Por ejemplo, para desempaquetar el metarchivo Novell_nwServer.mdl situado en el directorio \IBM\ITM\TMAITM6\metafiles\SNMP\vendor, puede emitir el siguiente mandato de consola que dar como resultado la creacin del archivo de texto Novell_nwServer.txt en el mismo directorio que el metarchivo original.
C:\IBM\ITM\TMAITM6>kumpcon unpack .\SNMP\vendor\Novel_nwServer.mdl
En este mandato, se presupone automticamente que el directorio de metarchivos local en un sistema operativo Windows es C:\IBM\ITM\TMAITM6\metafiles. Por lo tanto, no es necesario incluir dicha parte del nombre de va de acceso.
Sintaxis
KUMPCON UNPACK nombre-metarchivo
Parmetros
<nombre-metarchivo> Nombre del metarchivo que desea desempaquetar.
226
VALIDATE
El mandato VALIDATE ordena a las rutinas del analizador y comprobador de sintaxis de Tivoli Universal Agent que validen el metarchivo especificado. Estas mismas rutinas se invocan durante el tiempo de ejecucin por lo que es til ejecutar VALIDATE antes de activar un metarchivo nuevo o modificado. Puede iniciar el mandato VALIDATE incluso si Tivoli Universal Agent no est activo. Se guardar un informe de validacin del metarchivo de la aplicacin, con una extensin .rpt, en el mismo directorio donde se encuentra el metarchivo. Nota: Para validar un metarchivo, deber utilizar el programa KUMPCON o el script um_console en los sistemas operativos UNIX. Esto se debe a que debe realizarse la validacin en el host donde se encuentran los metarchivos.
Sintaxis
KUMPCON VALIDATE nombre-metarchivo
Parmetros
<nombre-metarchivo> Nombre del metarchivo que desea validar.
227
228
Tipos de registros
trapcnfg contiene tres tipos de registros o bloques de registros: comentarios Los registros de comentarios comienzan con un signo de nmero (#).
229
definiciones de empresa Las definiciones de empresa estn formadas por dos seales delimitadas por espacios en blanco, donde la primera seal es un nombre y la segunda es un identificador de objeto (OID) delimitado por llaves ({ }). definiciones de condiciones de excepcin Las definiciones de condiciones de excepcin estn formadas por 8 seales delimitadas por espacios en blanco. Las definiciones de condiciones de excepcin son registros de bloques, ya que cada definicin puede componerse de varios registros. El primer tipo se explica por s mismo. La Figura 14 en la pgina 231 muestra ejemplos del segundo y tercer tipo. El primer ejemplo en la Figura 14 muestra un registro de definicin de empresa que define el OID de empresa 1.3.6.1.4.1.311.1.1.3.1.1 como MS Windows NT. El segundo ejemplo muestra un registro de definicin de condicin de excepcin que define trapName MSNTCOLD como asociado con el OID de empresa 1.3.6.1.4.1.311.1.1.3.1.1, nmero de condicin de excepcin genrica 0 y nmero de la condicin de excepcin especfica 0. Tenga en cuenta que la gravedad se expresa en formato decimal mientras que la categora se expresa en formato textual. Los niveles de gravedad se convierten en formato textual antes de visualizarse en los informes MIB. El siguiente registro del bloque de registros de tipo 3 es la descripcin corta, que Tivoli Universal Agent no utiliza. Tivoli Universal Agent utiliza la descripcin larga delimitada por SDESC y EDESC.
230
231
Categoras soportadas
La Tabla 30 muestra las categoras soportadas por Tivoli Universal Agent.
Tabla 30. Categoras soportadas por el Proveedor de datos de SNMP Categora 0 1 2 3 4 5 6 7 8 9 Sucesos de umbral Sucesos de topologa de red Sucesos de error Sucesos de estatus Sucesos de configuracin de nodo Sucesos de alerta de aplicacin Sucesos de todas las categoras Registrar slo sucesos Correlacionar sucesos Pasar por alto sucesos Representacin textual
La Tabla 31 lista los niveles de gravedad soportados por Tivoli Universal Agent.
Tabla 31. Niveles de gravedad soportados por el Proveedor de datos de SNMP Gravedad 0 1 2 3 4 5 Eliminado Indeterminado Aviso Error leve Crtico Error grave Representacin textual
Estatus soportados
La Tabla 32 muestra los estatus definidos en el archivo de configuracin de Tivoli Universal Agent.
Tabla 32. Estatus soportados por el Proveedor de datos de SNMP Estatus 0 1 2 3 4 5 6 7 Sin cambios Desconocido Activo Marginal Inactivo Sin gestionar Reconocer Usuario1 Representacin textual
232
Tabla 32. Estatus soportados por el Proveedor de datos de SNMP (continuacin) Estatus 8 Usuario2 Representacin textual
ID de fuente soportados
La Tabla 33 lista los ID de fuente soportados por trapcnfg.
Tabla 33. IDs de fuente que soporta el Proveedor de datos de SNMP ID de fuente a A C d D E I L m M n N O P r s S t T V ? Aplicacin Agente Xnmcollect Demo Recopilador de datos Nvevents Ipmap LoadMIB Shpmon Topologa de IP Relacionado con netmon Condiciones de excepcin generadas por netmon OSI SA Condiciones de excepcin no de IP Tralertd Spappld Agente de seguridad Xnmtrap Trapd Relacionado con proveedores Desconocido Descripcin
233
La primera lnea es una sentencia de definicin de empresa y debe copiarse en cualquier lugar debajo del siguiente bloque de comentario en trapcnfg:
# # enterprises: #
Las cuatro lneas siguientes son sentencias de definicin de condiciones de excepcin que se pueden copiar debajo del siguiente bloque de comentarios en trapcnfg:
# # Formatos de condiciones de excepcin aadidos por el usuario: #
Cualquier cambio que realice en trapcnfg no surtir efecto hasta que complete las acciones siguientes: v Reinicie el Proveedor de datos de SNMP. v O bien, emita el mandato de consola KUMPCON TRAPCNFG para volver a cargar el archivo
234
\b, dentro de un [Set] \B \cX \d \D \e \E \f \G \n \N{UNICODE CHARACTER NAME} \p{UNICODE PROPERTY NAME} \P{UNICODE PROPERTY NAME} \Q \r \s \S
235
Tabla 34. Metacaracteres de expresiones regulares (continuacin) Carcter \t \uhhhh \Uhhhhhhhh Descripcin Coincidencia con un carcter de tabulacin horizontal, HORIZONTAL TABULATION, \u0009. Coincidencia con el carcter con el valor hexadecimal hhhh. Coincidencia con el carcter con el valor hexadecimal hhhhhhhh. Deben facilitarse exactamente ocho dgitos hexadecimales, aunque el punto de cdigo Unicode ms largo es \U0010ffff. Coincidencia con un carcter de palabra. Los caracteres de palabra son [\p{Ll}\p{Lu}\p{Lt}\p{Lo}\p{Nd}]. Coincidencia con un carcter que no es de palabra. Coincidencia con el carcter con el valor hexadecimal hhhh. Pueden suministrarse desde uno hasta seis dgitos hexadecimales. Coincidencia del carcter con el valor hexadecimal de dos dgitos hh. Coincidencia con un Grapheme Cluster. Coincidencia si la posicin actual est al final de la entrada, pero antes del terminador de la lnea final, si existe alguno. Coincidencia si la posicin actual est al final de la entrada. Referencia inversa. Coincide con aquello que coincida el grupo de captura nmero n. n debe ser un nmero > 1 y < nmero total de grupos de captura del patrn. Nota: Los valores de escape octal, tales como \012 no estn soportados en las expresiones regulares ICU. Coincidencia con cualquier carcter individual del grupo. Consulte UnicodeSet para obtener una descripcin completa de lo que puede aparecer en el patrn Coincidencia con cualquier carcter. Coincidencia al principio de una lnea. Coincidencia al final de una lnea. Colocar comillas entre los caracteres siguientes. Los caracteres que deben tener comillas delimitadoras que se tratarn como literales son * ? + [ ( ) { } ^ $ | \ . /
\w \W \x{hhhh}
\xhh \X \Z \
\z \n
[patrn]
. ^ $ \
Tabla 35. Operadores de expresiones regulares Operador | * + ? {n} Descripcin Alternancia. A|B coincide con A o con B. Coincidencia de 0 o ms veces. Hacer coincidir las veces que sea posible. Coincidencia de 1 o ms veces. Hacer coincidir las veces que sea posible. Coincidencia de cero o una vez. Es preferible una vez. Coincidencia de exactamente n veces.
236
Tabla 35. Operadores de expresiones regulares (continuacin) Operador {n,} {n,m} *? +? ?? {n}? {n,}? {n,m}? *+ Descripcin Coincidencia de al menos n veces. Hacer coincidir las veces que sea posible. Coincidencia de entre n y m veces. Hacer coincidir todas las veces que sea posible, pero no ms de m. Coincidencia de 0 o ms veces. Hacer coincidir las menos veces que sea posible. Coincidencia de 1 o ms veces. Hacer coincidir las menos veces que sea posible. Coincidencia de cero o una vez. Es preferible cero. Coincidencia de exactamente n veces. Coincidencia de al menos n veces, pero no ms de las necesarias para la coincidencia global de patrones. Coincidencia de entre n y m veces. Hacer coincidir las menos veces que sea posible, pero no menos de n. Coincidencia de 0 o ms veces. Hacer coincidir cuantas veces sea posible cuando se encuentra por primera vez, no intentar con menos veces aunque la coincidencia global falle (coincidencia posesiva) Coincidencia de 1 o ms veces. Coincidencia posesiva. Coincidencia de cero o una vez. Coincidencia posesiva. Coincidencia de exactamente n veces. Coincidencia de al menos n veces. Coincidencia posesiva. Coincidencia de entre n y m veces. Coincidencia posesiva. Captura de parntesis. El rango de entradas que coincida con la subexpresin entre parntesis est disponible despus de la coincidencia. No captura de parntesis. Agrupa el patrn incluido, pero no proporciona la captura del texto coincidente. Es un poco ms eficaz que la captura de parntesis. Parntesis de coincidencias atmicas. La primera coincidencia de la subexpresin entre parntesis es la nica vez que se intenta; si no conduce a una coincidencia global de patrones, realice una copia de seguridad de la bsqueda de una coincidencia en una posicin antes de (?> Comentario en formato libre (?# comentario ). Afirmacin de lectura anticipada. El valor es verdadero si el patrn entre parntesis coincide en la posicin de entrada actual, pero no avanza la posicin de entrada. Afirmacin de lectura anticipada negativa. El valor es verdadero si el patrn entre parntesis no coincide en la posicin de entrada actual. No avanza la posicin de entrada.
(?: ... )
(?> ... )
(?! ... )
237
Tabla 35. Operadores de expresiones regulares (continuacin) Operador (?<= ... ) Descripcin Afirmacin de lectura postergada. El valor es verdadero si el patrn entre parntesis coincide con el texto que precede a la posicin de entrada actual, siendo el ltimo carcter de la coincidencia el carcter de entrada justo delante de la posicin actual. No altera la posicin de entrada. La longitud de las posibles cadenas de caracteres que coinciden con el patrn de lectura postergada no deben estar desenlazadas (ningn operador * o +). Afirmacin de lectura postergada negativa. El valor es verdadero si el patrn entre parntesis no coincide con el texto que precede a la posicin de entrada actual, siendo el ltimo carcter de la coincidencia el carcter de entrada justo antes de la posicin actual. No altera la posicin de entrada. La longitud de las posibles cadenas de caracteres que coinciden con el patrn de lectura postergada no deben estar desenlazadas (ningn operador * o +). Valores de distintivo. Evale la expresin entre parntesis con los distintivos especificados habilitados o inhabilitados. Valores de distintivo. Cambie los valores de distintivo. Los cambios se aplican en la parte del patrn que viene a continuacin del valor. Por ejemplo, (?i) cambia a una coincidencia que no distingue las maysculas de las minsculas.
(?<!...)
(?ismx-ismx: ... )
(?ismx-ismx)
Texto de sustitucin
El texto de sustitucin de las operaciones de bsqueda y sustitucin puede contener referencias al texto del grupo de capturas de la bsqueda. Las referencias son de tipo $n, donde n es el nmero del grupo de captura.
Tabla 36. Caracteres del texto de sustitucin Carcter $n Descripcin El texto del grupo de captura n se sustituye por $n. n debe ser >= 0 y no mayor que el nmero de grupos de captura. Un smbolo $ que no va seguido de un dgito no tiene ningn significado especial, y se visualiza en el texto de sustitucin como s mismo, un smbolo $. Tratar este carcter como un literal, suprimiendo cualquier significado especial. Las barras inclinadas invertidas de escape en el texto de sustitucin slo son necesarias para $ y \, pero se pueden utilizar en cualquier otro carcter sin que tenga ningn efecto adverso.
238
Opciones de distintivos
Los siguientes distintivos controlan los diversos aspectos de la coincidencia de expresiones regulares. Los valores de distintivo se pueden especificar en el momento en que se compila una expresin en un objeto RegexPattern o se pueden especificar dentro del propio patrn utilizando las opciones de patrn (?ismx-ismx).
Tabla 37. Opciones de distintivo Distintivo (patrn) i Distintivo (constante API) UREGEX_CASE_INSENSITIVE Descripcin Si est distintivo establecido, la coincidencia tiene lugar sin tener en cuenta las maysculas y minsculas. Si este distintivo est establecido, permite utilizar espacios en blanco y #comentarios dentro de patrones. Si este distintivo est establecido, un signo . en un patrn coincide con un terminador de lnea en el texto de entrada. De forma predeterminada, no coincide. Observe que un par de retorno de carro / salto de lnea en el texto se comporta como un terminador de lnea individual y coincide con un slo signo . en un patrn RE. Controla el comportamiento de ^ y $ en un patrn. De forma predeterminada, estos signos slo coinciden al principio y al final, respectivamente, del texto de entrada. Si este distintivo est establecido, ^ y $ tambin coinciden al principio y al final de cada lnea dentro del texto de entrada.
UREGEX_COMMENTS
UREGEX_DOTALL
UREGEX_MULTILINE
239
240
El directorio donde home/MyWork Tivoli Universal Agent almacena los archivo de configuracin y archivos de trabajo. Y N
KUM_UMC
Controla el envo de informacin de condiciones de excepcin de SNMP y de red a la Consola de mensajes universales.
Tivoli Universal Agent KUMA_DCH_PORT Altera temporalmente el puerto predeterminado de datos del agente. 1919 6134
KUM_DP_HOSTNAME
Establece el nombre de host Nombre de la preferido (interfaz de red) en un primera interfaz de sistema con varios hosts. red instalada. Utilice esta variable de entorno si Tivoli Universal Agent enlaza los puertos de escucha con una direccin de interfaz de red no predeterminada. Misma finalidad que KUM_DP_HOSTNAME Controla el nmero mximo de aplicaciones que pueden estar activas en un nico Universal Agent. No puede establecer esta variable de entorno en un valor superior a 128. Nombre de la primera interfaz de red instalada. 64
10.49.1.63
KUM_DCH_HOSTNAME
172.16.18.7
KUMA_MAX_APPLICATIONS
128
KUMA_MAX_ATTRGROUPS_ PER_APPL
Controla el nmero mximo de 64 grupos de atributos que puede haber en un nico metarchivo. No es posible establecerlo ms de 256.
128
241
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMA_MAX_EVENT_ENTRIES Descripcin Controla el nmero mximo de filas de datos de suceso en un espacio de trabajo de Tivoli Enterprise Portal. Controla la grabacin de los datos de accin en el registro de operaciones de Tivoli Enterprise Portal. Especifica qu proveedores de datos iniciar. Se utiliza para establecer la cantidad de tiempo, en segundos, que esperar una respuesta de una solicitud de informe de bajo demanda. Cuando la peticin supera el tiempo de espera, se muestran las ltimas filas disponibles para dicha tabla. Valor predeterminado 100 500 Ejemplo
KUMA_WRITE_OPTLOG
ASFS 15
SNMP, ODBC 30
KUMA_ENUMINT_FORMAT
Define atributos enumerados N como enteros en lugar de como cadenas de caracteres en Tivoli Enterprise Portal. Esta variable de entorno slo afecta al modo en que Tivoli Universal Agent genera la sentencia *TYPE: en el archivo ODI de aplicacin de metarchivo que el portal utiliza. Al definir un atributo enumerado en el portal como un entero, el atributo se puede utilizar en diagramas y grficos, as como en comparaciones numricas en situaciones.
Todos los proveedores de datos AGENT_LOCALE Especifica una configuracin El entorno local del ja_JP local en el formato sistema local Idioma_Territorio. Todos los proveedores de datos de Tivoli Universal Agent utilizan este entorno local. Slo necesita esta variable de entorno local si desea utilizar un entorno local distinto del predeterminado. Especifica un valor de pgina de cdigos utilizado para todos los proveedores de datos de Tivoli Universal Agent. Slo es necesario especificar esta variable de entorno si desea utilizar una pgina de cdigos no predeterminada. La pgina de GB-18030 cdigos predeterminada del sistema
KUMP_DEFAULT_CODEPAGE
242
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMP_DCH_HOST Descripcin Valor predeterminado fin1 Ejemplo
Dirige el proveedor de datos a El mismo host que un Tivoli Universal Agent que el proveedor de reside en un lugar diferente que datos el host del proveedor de datos. Esta variable se suele utilizar para un proveedor de datos autnomo que se conecta a un Tivoli Universal Agent que se ejecuta en un sistema diferente. Especifica la ubicacin del archivo de configuracin del proveedor de datos si se encuentra en otro sitio distinto del directorio de trabajo.
KUMP_INIT_CONFIG_PATH
KUMP_OUTPUT_DEBUG
Se utiliza para depurar la N recopilacin de datos y la lgica relacionada con la salida. Establezca esta variable de entorno cuando resuelva un problema que afecta a datos ausentes o incorrectos en un espacio de trabajo. Especifica si Tivoli Universal Agent registra la aplicacin UAGENT durante el arranque. Establezca esta variable de entorno en N si no desea utilizar las tablas DPLOG y ACTION asociadas a la aplicacin UAGENT. Especifica la ubicacin de los metarchivos del proveedor de datos si se encuentran en otro sitio distinto del directorio de metarchivos. Dirige el proveedor de datos para que utilice un servidor de metarchivos centralizado. Y
KUMP_ENABLE_DPLOG
KUMP_META_PATH
directorio de metarchivos
KUMP_META_SERVER
fin1
KUMP_META_SERVER_PORT
Altera temporalmente el puerto 7800 de escucha predeterminado para el servidor de metarchivos de Tivoli Universal Agent.
25000
243
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMA_ATOMIC_SITUATIONS Descripcin Identifica atributos atomizados especficos dentro de situaciones para su uso en la supresin de acciones duplicadas en intervalos de muestreo sucesivos. Utilice el siguiente formato: KUMA_ATOMIC_ SITUATIONS=nombresit1:#, nombresit2:#,... donde cada entrada consiste de un par de NombreSit:Atributo NmeroColumna. Si especifica ms de una situacin, deber ir separadas por comas. Cada nombre de situacin atomizada debe ir seguido de un delimitador de punto y coma, que, a su vez va seguido del nmero de columna del atributo atmico utilizado por la situacin. El nmero de columna equivale a la secuencia numrica del atributo en el metarchivo. Proveedor de datos de archivo KUMP_DP_SAMPLE_FACTOR Para los datos sondeados, 5 muestreados y con clave, establece el factor de muestreo en segundos, que junto con el valor de tiempo de vida determina la frecuencia de muestreo. Establece la frecuencia de muestreo para los datos de suceso, en segundos. Especifica que el subproceso de supervisin del archivo contine ejecutndose si detecta que el archivo supervisado est ausente o vaco. El subproceso espera hasta que est el archivo, vuelve a realizar una comprobacin al cabo de unos segundos, e inicia o reinicia la supervisin cuando el archivo pasa a estar disponible. 2 10 Valor predeterminado Ninguno Ejemplo CICS_ Abend:2
KUMP_DP_EVENT
KUMP_DP_FILE_EXIST_WAIT
244
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMP_DP_FILE_SWITCH_ CHECK_INTERVAL Descripcin Especifica la frecuencia en segundos que el proveedor de datos de archivo busca un archivo de supervisin distinto para conmutar al mismo cuando se utilice el soporte de nombres de archivos dinmico. Especifica cuntos registros de archivo se deben leer antes de que el subproceso de supervisin de archivo se ponga en pausa brevemente para permitir que se procesen las actualizaciones anteriores. Utilice esta variable de entorno nicamente si el archivo supervisado recibe rfagas de gran volumen de registros nuevos y existe la preocupacin de que algunas actualizaciones de registro se puedan perder. Valor predeterminado 600 120 Ejemplo
KUMP_FILE_ROW_PAUSE_ INCREMENT
Ninguno
100
Proveedor de datos de servidor de API KUMP_API_BYPASS_VAL Pasa por alto la validacin de parmetros para llamadas a API. N Y
KUMP_API_DPAPI_HOST
Identifica el host del servidor de Mismo host que el API si no es el mismo que el cliente de API cliente. Altera temporalmente el puerto 7600 de escucha predeterminado del servidor de API. Elige uno de los tres modos de comunicacin entre el cliente y el servidor de API. TCP/IP
atlantis
KUMP_API_DPAPI_PORT
5028
KUMP_API_TRANSPORT
IPC
KUMP_API_REQUEST_WAIT
Decide cunto tiempo esperar 30 el cliente de API una respuesta de una solicitud del proveedor de datos de servidor de API (en segundos). Conmuta el rastreo detallado de cliente de API. N
60
Altera temporalmente el puerto 7500 de escucha predeterminado del proveedor de datos de socket.
5028
245
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMP_TCP_DISCONNECT_BY_TTL Descripcin Decide si Tivoli Universal Agent Y retrasar la notificacin a IBM Tivoli Monitoring acerca de una desconexin TCP hasta que haya caducado el TTL. Si este valor est establecido en N, el sistema gestionado de la aplicacin de metarchivo de socket permanecer en lnea incluso despus de que el programa cliente de socket se haya desconectado. Controla el tiempo que Tivoli Universal Agent tiene para detectar una interrupcin de alimentacin de red o del sistema causando una conexin perdida de un programa de cliente de socket. 180 Valor predeterminado N Ejemplo
KUMP_TCP_OUTAGE_WINDOW
90
Proveedor de datos de envo KUMP_POST_DP_PORT Altera temporalmente el puerto 7575 de escucha predeterminado del proveedor de datos de envo. Altera temporalmente el nombre de aplicacin definido en el metarchivo KUMPOST. Altera temporalmente el nombre del grupo de atributos definido en el metarchivo KUMPOST. Altera temporalmente el valor de tiempo de vida del grupo de atributos. Redefine las categoras predeterminadas de envo o aade nuevas. MAS 5028
KUMP_POST_APPL_NAME
MSG
KUMP_POST_GROUP_NAME
dpPost
mensajes
KUMP_POST_APPL_TTL
3600
1800
KUMP_POST_CATEGORY
Proveedor de datos de SNMP - Informes de red KUMP_SNMP_NETDATA_TTL Controla la frecuencia a la que 14400 segundos se actualizan el descubrimiento de red y los informes de gestin. Un intervalo ms corto aumenta la velocidad de los mensajes de descubrimiento y la cara general de la red, pero se asegura de que los informes reflejan el estatus actual de recursos de la red de forma ms exacta. 12200
246
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMP_SNMP_NET_DISCOVERY Descripcin Sirve de conmutador indicando Y si se debe o no realizar un descubrimiento de los recursos de red. Si se establece en N, el proveedor de datos de SNMP slo tendr conocimiento de las pasarelas, direccionadores predeterminados y del segmento de red local del cual forma parte del proveedor de datos; el espacio de trabajo ROUTER slo muestra datos para las pasarelas y direccionadores predeterminados, y el espacio de trabajo NETSUMMARY slo muestra datos para la red local. Sirve de conmutador indicando Y si se debe o no gestionar la red local. Establezca el valor en N para inhabilitar automticamente la gestin de la red local. Sirve de conmutador indicando N si el descubrimiento de red determina el estatus de toda la red de la empresa. Esta variable slo tiene sentido si KUMP_SNMP_NET_ DISCOVERY se establece en Y. Si esta variable se establece en N, varios de los atributos del espacio de trabajo NETSUMMARY muestran un valor de cero para redes distintas de la red local del proveedor de datos de SNMP. Especifica el nombre de comunidad predeterminado de toda la empresa para los agentes SNMP. public Valor predeterminado N Ejemplo
KUMP_SNMP_MANAGE_ LOCAL_NETWORK
KUMP_SNMP_NET_ DISCOVER_ENTERPRISE
KUMP_SNMP_NET_COMMUNITY
Tivoli
Especifica la ventana de 1800 descubrimiento base (BDW), en segundos. Especifica si el proveedor de N datos de SNMP intenta utilizar un daemon ICMP en el sistema UNIX local para realizar solicitudes ping. Se utiliza para depurar el proceso de descubrimiento del direccionador. N
3600
KUMP_SNMP_DEBUG_ DISCOVERY_ROUTE
247
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMP_SNMP_DEBUG_ DISCOVERY_ENTERPRISE KUMP_SNMP_DEBUG_ DISCOVERY_NETWORK Descripcin Se utiliza para depurar el proceso general de descubrimiento de red. Se utiliza para depurar el descubrimiento de recursos dentro de una red. Valor predeterminado N Y Ejemplo
Proveedor de datos de SNMP - Recopilacin de datos MIB KUMP_SNMP_DEBUG_MIB_ MANAGER KUMP_SNMP_DEBUG_MIB_IO Se utiliza para depurar el flujo de solicitudes de recopilacin de datos MIB. Se utiliza para depurar el flujo de solicitudes de recopilacin de datos MIB. Esta variable de entorno funciona junto con KUMP_SNMP_ DEBUG_MIB_MANAGER. Especifica si el espacio de trabajo MIBNODATA en la aplicacin SNMP-MANAGER se llena con las tablas MIB para las cuales los agentes SNMP no devuelven datos. Establezca esta variable de entorno en N si no est interesado en ver esta informacin, lo que ahorrar alguna sobrecarga del sistema. Especifica si el espacio de trabajo MIBSTATUS en la aplicacin SNMP-MANAGER lista el nombre de comunidad de cada agente SNMP supervisado. N Y
KUMP_SNMP_MIBNODATA
KUMP_SNMP_HIDE_COMMUNITY
KUMP_SNMP_ADD_ OBJECTINSTANCE
Las variables MIB tabulares N incluyen una instancia de objeto suministrada por un agente SNMP que sirve de ndice en la tabla MIB para identificar de forma exclusiva una fila en la tabla. Si desea ver el valor de ndice de cada fila de datos tabular recopilada, establezca esta variable de entorno en Y. Se aade un nuevo atributo denominado _ObjectInstance al final de cada grupo de atributos tabular en la aplicacin de metarchivo SNMP.
248
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMP_SNMP_DEBUG_TRAP Descripcin Valor predeterminado Y Ejemplo
Se utiliza para depurar la lgica N de recepcin y proceso de condiciones de excepcin de SNMP. Sirve de conmutador indicando si la supervisin de las condiciones de excepcin de red SNMP es necesaria. Controla qu condiciones de excepcin se reenvan a la Consola de mensajes universales, en base a su gravedad. Y
KUMP_SNMP_MONITOR_TRAP
KUMP_SNMP_TRAP_CONSOLE_SEV
KUMP_SNMP_TRAP_PORT
Especifica un puerto de destino Ninguno de condiciones de excepcin especfico de la instalacin que el proveedor de datos de SNMP debe supervisar en lugar del puerto de escucha estndar de condiciones de excepcin 162. Acta como un conmutador N para habilitar o inhabilitar los mensajes de depuracin detallados que pueden ayudar en la determinacin de problemas relacionados con las condiciones de excepcin. Si establece esta variable de entorno en Y, suministre tambin el nombre del archivo de registro detallado donde se redirigen los mensajes de depuracin. Especifica el nombre del archivo de configuracin donde se definen las condiciones de excepcin especficas de la instalacin. trapcnfg
1952
KUMP_SNMP_TRAP_VERBOSE
Y>/opt/IBM/ITM/logs/ kumstrap.log
KUMP_SNMP_TRAPCNFG_FILE
trapd.cfg
KUMP_SNMP_TRAPCNFG_ CATEGORY
Especifica la palabra clave en CATEGORY el archivo de configuracin de condiciones de excepcin que seala las definiciones de categora de las condiciones de excepcin de SNMP. SEVERITY
cat
KUMP_SNMP_TRAPCNFG_SEVERITY Especifica la palabra clave en el archivo de configuracin de condiciones de excepcin que contiene las definiciones de las gravedades de condiciones de excepcin de SNMP.
Importancia
249
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMP_SNMP_TRAPCNFG_ SOURCEID Descripcin Especifica la palabra clave en el archivo de configuracin de condiciones de excepcin que contiene las definiciones de los tipos de fuentes de SNMP. Valor predeterminado SOURCEID Ejemplo Fuente
KUMP_SNMP_TRAPCNFG_STATUS
Especifica una palabra clave en STATUS el archivo de configuracin que contiene las definiciones del estatus de las condiciones de excepcin de SNMP.
CurrStat
Emisor de SNMP KUMP_TRAP_DESTINATION Define los nombres de host del gestor de SNMP que recibe las condiciones de excepcin enviadas por el emisor de SNMP de Tivoli Universal Agent. Si se especifican varios nombres de host, deber separarlos mediante comas. Ninguno HostA, HostB
KUMP_TRAP_EMIT_COMMUNITY
Define el nombre de comunidad public que el producto del gestor de SNMP esta configurado para utilizar. Determina si el valor de Y gravedad especificado en la definicin de poltica del emisor de SNMP se enva como el valor de gravedad principal en la condicin de excepcin emitida. Determina si la cadena de N caracteres de predicado de la situacin no est incluida en la condicin de excepcin emitida. Especifica si cada condicin de N excepcin de SNMP emitida se registra en el espacio de trabajo UAGENT ACTION.
secret
KUMP_TRAP_USE_POLICY_ SEVERITY
KUMP_TRAP_ADD_PREDICATES
KUMA_DCH_TRAPEMIT
Proveedor de datos de HTTP KUMP_URL_OUTPUT_STAT Se utiliza para grabar de salida N las estadsticas de URL en un archivo CSV para el anlisis en la hoja de clculo EXCEL. El nombre de archivo CSV es URLSTATS.csv y se encuentra en el directorio WORK de la instalacin del producto Tivoli Universal Agent. Y
250
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMP_URL_MAX_REPLY_WAIT Descripcin Valor predeterminado 60 Ejemplo
Se utiliza para establecer el 45 tiempo de espera de una respuesta URL. Si el valor predeterminado de 45 segundos resulta en frecuentes mensajes de estatus Tiempo de espera superado, establezca un valor ms elevado. Se utiliza para descargar el archivo HTML asociado con el URL que se est supervisando en un subdirectorio dentro del directorio WORK de Tivoli Universal Agent. El nombre del subdirectorio coincide con el nombre del URL. N
KUMP_URL_OUTPUT_HTML
KUMP_HTTP_PROXY_USERID KUMP_HTTP_PROXY_PASSWORD
Se utiliza para que los <ninguno> servidores proxy establezcan la validacin de IDusuario/contrasea antes de poder acceder a sitios web externos. Especifique las dos variables que permiten que el proveedor de datos de HTTP realice la autentificacin de proxy. Se utiliza para diagnosticar un problema de supervisin de URL. IBM Software Support puede solicitarle que proporcione un rastreo detallado del componente del proveedor de datos de HTTP y que enve el registro RAS1 de Tivoli Universal Agent generado. Se utiliza para especificar un nombre de host de proxy y nmero de puerto que el proveedor de datos de HTTP utilice cuando acceda a los URL. N
KUMP_HTTP_DEBUG
KDH_CLIENTPROXY
Ninguno
http://myhost:1920
Proveedor de datos de ODBC KUMP_ODBC_MAX_ROWS Se utiliza para especificar de 100 forma global el nmero mximo de filas a devolver para cada tabla ODBC en un metarchivo. 50
251
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMP_ODBC_DEBUG Descripcin Se utiliza para ayudar a diagnosticar un problema de supervisin de ODBC. IBM Software Support puede solicitarle que proporcione un rastreo detallado del componente del proveedor de datos de ODBC y que enve el registro RAS1 de Tivoli Universal Agent generado. Valor predeterminado N Y Ejemplo
Proveedor de datos de script KUMP_SCRIPT_DEBUG Se utiliza para ayudar a N diagnosticar un problema de supervisin del proveedor de datos de script. IBM Software Support puede solicitarle que captura un rastreo detallado del componente del proveedor de datos de script y que enve el archivo de registro RAS1 de Tivoli Universal Agent generado. Especifica si los scripts cuya salida es un cdigo de retorno que no es cero se registran en UAGENT DPLOG. Y Y
KUMP_SCRIPT_LOG_ EXITCODES
KUMP_MAXSCRIPT_TIMEOUTS
Especifica si hay un lmite en 0 cuanto al nmero de veces que un script puede agotar el tiempo de espera antes de que el proveedor de datos de script deje de intentar ejecutar el script. El valor predeterminado 0 significa que no hay ningn lmite. Si hay scripts propensos a errores que desee evitar que se inicien y a continuacin, que excedan reiteradamente el tiempo de espera, establezca este valor en un entero mayor que 0.
Interfaz de consola KUMP_DPCONSOLE_PORT Especifica un puerto de escucha no predeterminado que el servidor de consola de Tivoli Universal Agent utilizar para servir solicitudes de mandatos de consola. Debe establecer esta variable de entorno cuando enve mandatos a una instancia alternativa de Tivoli Universal Agent. 7700 8700
252
Tabla 38. Variables de entorno de Tivoli Universal Agent (continuacin) Variable de entorno KUMP_DPCONSOLE_NOCONFIRM Descripcin Determina si pasar por alto el indicador de confirmacin para un mandato Delete o Refresh. Especifica un nombre de proveedor de datos de 4 caracteres que se utiliza para saltarse el indicador de tipo de proveedor de datos cuando se procesa un mandato List o Show. Valor predeterminado N Y Ejemplo
KUMP_CONSOLE_TARGETDP
<ninguno
snmp
KUMP_CONSOLE_COMMAND_WAIT
Especifica cuntos segundos 30 un mandato espera una respuesta por parte del mandato de consola de Tivoli Universal Agent antes de que se exceda el tiempo de espera.
60
253
254
Apndice H. Actualizacin
Este apndice explica la actualizacin de versiones anteriores de Tivoli Universal Agent a la versin 6.2.0 de Tivoli Universal Agent.
Proceso de actualizacin
Siga los pasos siguientes para actualizar desde una versin anterior: 1. Realice una copia de seguridad de todos los archivos importantes de Universal Agent. Por ejemplo, los metarchivos y archivos de configuracin que haya personalizado. Dichos archivos incluyen KUMPCNFG, KUMPURLS, TRAPCNFG y KUMSMIBI. Realice una copia de seguridad de los archivos en los que haya establecido variables de entorno especiales. Por ejemplo, los archivos KUMENV o um.ini y um.config. 2. Desinstale la versin anterior de Universal Agent. Esto eliminar todos los archivos binarios de la versin anterior y entradas de registro. 3. Instale Tivoli Universal Agent, V6.2. Nota: Si est actualizando desde Universal Agent, Versin 4.1.0, debe ejecutar el siguiente mandato despus de instalar Tivoli Universal Agent, V6.2:
<dir_instalacin>/bin/itmcmd config -A um
4. Restaure cualquier metarchivo que desee utilizar. 5. Restaure cualquier archivo de configuracin personalizado que desee reutilizar. 6. Revise los archivos KUMENV, um.ini y um.config para determinar si desea actualizar la lista KUMA_STARTUP_DP o si tiene algn valor de variable de entorno especial para restaurar desde la copia de seguridad. Nota: En los sistemas operativos UNIX, configure Tivoli Universal Agent, V6.2, y especifique los proveedores de datos que desea iniciar. 7. Inicie Tivoli Universal Agent. 8. Verifique que todas las aplicaciones de supervisin de Tivoli Universal Agent estn en lnea. Nota: Las situaciones proporcionadas por el producto de Tivoli Universal Agent no han cambiado desde Universal Agent, versin 4.1.0. Por lo tanto, es normal ver mensajes como los datos de semilla ya existen o rc = 80 cuando se aade soporte de aplicacin de servidor de Tivoli Enterprise
Copyright IBM Corp. 2003, 2007
255
Monitoring para Tivoli Universal Agent, V6.2. Estos mensajes simplemente indican que el servidor de Tivoli Enterprise Monitoring ya contiene definiciones para situaciones proporcionadas por el producto Tivoli Universal Agent.
256
Programas de inicio
Puede iniciar los proveedores de datos como procesos independientes invocando los programas que aparecen en la Tabla 39. Estos programas de proveedores de datos autnomos se distribuyen con el producto Tivoli Universal Agent. Los nombres de los programas pueden variar ligeramente entre sistemas operativos. Por ejemplo, los programas en los sistemas operativos Windows tienen la extensin .exe.
Tabla 39. Inicio de proveedores de datos Para iniciar Proveedor de datos de servidor de API API, Socket, Archivo y Script Proveedor de datos de archivo Proveedor de datos de HTTP Proveedor de datos de ODBC Proveedor de datos de envo Proveedor de datos de script Proveedor de datos de socket Proveedor de datos de SNMP KUMPAPIS KUMPASFS KUMPFILE KUMPHTTP KUMPODBC KUMPPOST KUMPSCRP KUMPSOCK KUMPSNMP Invoque
Entorno de ejecucin
Debe tener el siguiente entorno de ejecucin cuando inicie los proveedores de datos como procesos independientes: v Las tres siguientes DLL de Tivoli Universal Agent para los sistemas operativos Windows y las bibliotecas compartidas en los sistemas operativos UNIX deben estar en el mismo directorio que el programa del proveedor de datos o bien ser accesibles mediante la va de acceso de bsqueda de bibliotecas: KUM0610
Copyright IBM Corp. 2003, 2007
257
KUMP610 KUMS1API v En los sistemas operativos Windows y UNIX, los proveedores de datos tambin necesitan las siguientes bibliotecas compartidas de IBM Tivoli Monitoring: KBB KDC KDE KDH KNS KDSFILT KGLBASE
KHDXCL1 KLX KRA Estas bibliotecas, junto con las bibliotecas de Tivoli Universal Agent, deben encontrarse en el mismo directorio que el programa de proveedor de datos o ser accesible mediante la va de acceso de bsqueda de bibliotecas. v Los archivos de configuracin de Tivoli Universal Agent, KUMPSF y KUMPCNFG, deben estar en un subdirectorio \work debajo del directorio donde se encuentra el programa del proveedor de datos. Si est ejecutando el proveedor de datos de HTTP como un proceso autnomo, incluya el archivo de configuracin KUMPURLS en el subdirectorio \work. v Los archivos KUMENV, um.ini y um.config no son necesarios para ejecutar un proveedor de datos autnomo porque slo son necesarios para ejecutar Tivoli Universal Agent. v Cualquier metarchivo que desee que el proveedor de datos cargue debe estar situado en el subdirectorio \metafiles debajo del directorio donde se encuentra el programa de proveedor de datos. Si los metarchivos se encuentran en un directorio distinto, deber establecer la va de acceso de bsqueda utilizando la variable de entorno KUMP_META_PATH. Nota: Si est ejecutando el proveedor de datos de HTTP en modalidad autnoma, no necesitar el subdirectorio \metafiles porque no hay ningn metarchivo con el proveedor de datos de HTTP.
La lista siguiente es una lista de variables de entorno adicionales que puede utilizar para establecer un proveedor de datos autnomo: v En el siguiente ejemplo se presupone que existe una conexin IP con Tivoli Universal Agent:
KDC_FAMILIES=use:n ip use:y
258
v El ejemplo siguiente se utiliza cuando sea necesario para registrar la actividad del proveedor de datos autnomo:
KBB_RAS1=ERROR ^>logfile
Deber establecer variables de entorno adicionales si el proveedor de datos est conectndose a una instancia alternativa de Tivoli Universal Agent o a una instancia primaria que haya alterado el valor de puerto de DCH. Si no est utilizando el puerto de escucha predeterminado del proveedor de datos (puerto 1919) de Tivoli Universal Agent, el proveedor de datos no podr conectarse y los sistemas gestionados del proveedor de datos no pasarn a estar en lnea. Nota: La primera instancia alternativa de Tivoli Universal Agent utiliza un nmero de puerto de DCH de 49219, aunque puede utilizarse la variable de entorno KUMA_DCH_PORT para alterar temporalmente el valor 1919 predeterminado de una instancia primaria. Si necesita conectar el proveedor de datos a un nmero de puerto de DCH distinto de 1919, deber establecer tambin KUMA_DCH_PORT en el nmero de puerto correspondiente de la lista de variables de entorno. Como es necesario establecer las variables de entorno antes de iniciar el archivo ejecutable del proveedor de datos, por su propia comodidad, cree un script o archivo .bat que establezca las variables de entorno y que llame despus al programa del proveedor de datos. Puede utilizar el siguiente ejemplo de un archivo .bat de Windows para iniciar el ejecutable del proveedor de datos de archivo, kumpfile:
set set set set set KDC_FAMILIES=use:n ip use:y KBB_SIG1=dumpoff -asyncoff KUMP_DCH_HOST=UAHOST1 KUMP_META_PATH=C:\standalone\metafiles KBB_RAS1=ERROR ^>filedp.log
Puede crear un script de shell equivalente para los sistemas operativos UNIX. Nota: El sistema Tivoli Universal Agent al que se est conectando no necesita estar ejecutando el mismo tipo de proveedor de datos que aquel que est iniciando. Por ejemplo, si ejecuta un proveedor de datos de archivo autnomo para supervisar un archivo en un sistema remoto, no es necesario que inicie tambin el proveedor de datos de ASFS o de archivo en el sistema Tivoli Universal Agent de destino.
Secuencia de inicio
Puede iniciar proveedores de datos autnomos antes o despus de iniciar el sistema Tivoli Universal Agent. Si el proveedor de datos intenta conectarse a un Tivoli Universal Agent que no se haya iniciado an, el proveedor de datos esperar y volver a intentarlo hasta que establezca una conexin satisfactoria. Si se recicla Tivoli Universal Agent, el proveedor de datos detecta la condicin y sincroniza su operacin con Tivoli Universal Agent. No obstante, se perdern los datos recopilados por el proveedor de datos durante la interrupcin de conectividad.
259
El mandato SHUTDOWN
El mandato SHUTDOWN de consola de Tivoli Universal Agent detiene un proveedor de datos de manera normal. Si se est ejecutando ms de un proveedor de datos, el programa solicitar que se especifique qu tipo desea detener.
Retrasos en la terminacin
El proveedor de datos sincroniza sus operaciones internas e inicia la terminacin ordenada de todos los subprocesos de ejecucin. Por lo tanto, es normal observar un pequeo retraso en la terminacin del proceso final despus de emitir el mandato SHUTDOWN.
260
Tivoli Universal Agent soporta adems varias variables de entorno de depuracin especiales para rastrear un proveedor de datos o componente particular.
261
argumentos de scripts, la lectura de un envfile opcional, la ejecucin de scripts y la captura de los almacenamientos intermedios de salida estndar de script, se vuelcan en el registro RAS1 de Tivoli Universal Agent para el anlisis posterior. Existen variables de entorno especializadas equivalentes, tales como KUMP_HTTP_DEBUG=Y y KUMP_ODBC_DEBUG=Y, para los proveedores de datos HTTP y ODBC, respectivamente. El proveedor de datos SNMP tambin soporta varias variables de entorno para rastreo de depuracin. Por ejemplo, para diagnosticar un problema de recepcin de condicin de excepcin, establezca
KUMP_SNMP_DEBUG_TRAP=Y
KUMP_OUTPUT_DEBUG=Y rastrea toda la lgica relacionada con la salida y la recopilacin de datos para todos los proveedores de datos. Esta variable de entorno puede resultar til cuando resuelve un problema que afecta a datos ausentes o incorrectos en un espacio de trabajo de portal.
Aplicacin UAGENT
Cada proveedor de datos activa automticamente una aplicacin interna suministrada por Tivoli Universal Agent denominada UAGENT, que consta de las tablas DPLOG y ACTION. El nombre del sistema gestionado para esta aplicacin tiene el formato &localhost&DPTYPEdp:UAGENT00, por ejemplo:
hostxSNMPdp:UAGENT00
262
Dos de los sntomas de problemas de Tivoli Universal Agent ms comunes son: 1. Uno o ms sistemas gestionados no aparecen en lnea. 2. Los sistemas gestionados estn en lnea pero los espacios de trabajo estn vacos. En ambos casos, examine una posible explicacin en el DPLOG adecuado. Como ejemplo, si ha activado una aplicacin nueva de metarchivo de proveedor de datos de archivos, es posible que no vea la nueva aplicacin visualizada en el rbol del portal de Navigator. Este problema se puede producir debido a que la informacin en Navigator se recopila en la tabla de estatus de nodos del servidor de supervisin. Si el subnodo asociado con esta aplicacin nunca se ha registrado con el servidor de supervisin, nunca se aade al rbol. Si la aplicacin no se ha registrado con el servidor de supervisin, compruebe el espacio de trabajo DPLOG, que puede indicarle que el archivo que este metarchivo est supervisando no existe. Quizs hay un error tipogrfico en la sentencia //SOURCE FILE del metarchivo. Si el proveedor de datos (DP) de archivo no puede encontrar el archivo supervisado, no registrar el sistema gestionado, lo que significa que el portal Navigator no puede saber nada de la aplicacin.
Tambin puede reunir la siguiente informacin: v El metarchivo de la aplicacin (si el problema puede estar enlazado a una aplicacin).
263
Capturas de pantalla UAGENT DPLOG o ACTION. Registro de archivo de aplicacin de ejemplo (si se supervisa un archivo). Cdigo fuente de la aplicacin (si hay un problema de DP de socket, DP de API o DP de script). El archivo de registro RAS1 de Tivoli Universal Agent siempre es necesario, incluso con el rastreo a nivel de ERROR predeterminado. Observe que el archivo KUMENV tiene muchos valores KBB_RAS1 sugeridos para diagnosticar diferentes categoras de problemas con un rastreo detallado. La captura de rastreos de depuracin especiales, como por ejemplo, KUMP_SNMP_DEBUG_TRAP=Y, depende de la naturaleza del problema. v Para problemas de DP de API, recopile un rastreo KUMP_API_VERBOSE=Y. Tenga en cuenta que esta variable de entorno no se establece en /config/um.ini o \TMAITM6\KUMENV, pero en cambio, debe establecerse en el entorno del programa cliente de API. v Para problemas de la interfaz de consola, recopile los rastreos kumpcon o um_console si el problema parece radicar en el cdigo cliente de la consola. Para kumpcon desde un indicador de mandatos del sistema Windows, establezca el rastreo siguiente: - set KBB_RAS1=ERROR (UNIT:kumpcon ALL) - set KBB_RAS1_LOG=%CANDLEHOME%\logs\kumpcon.log Para um_console desde un indicador de mandatos del sistema UNIX, establezca el rastreo siguiente: - export KBB_RAS1=ERROR (UNIT:kumpcon ALL) - export KBB_RAS1_LOG=$CANDLEHOME/logs/kumpcon.log v v v v Nota: Utilice los ejemplos de rastreo KBB_RAS1 de Tivoli Universal Agent en KUMENV con comentarios adicionales. En la GUI de Manage Tivoli Enterprise Monitoring Services, los ejemplos de rastreo de Tivoli Universal Agent comentados se pueden seleccionar desde un men desplegable en el recuadro de dilogo de valores de rastreo. Los mismos parmetros de rastreo se pueden utilizar para versiones de Tivoli Universal Agent basadas en UNIX. Estos parmetros de rastreo de ejemplo no abarcan cada uno de los posibles casos de problemas de Tivoli Universal Agent, pero son un buen comienzo para capturar la clase adecuada de rastreo de Tivoli Universal Agent detallado para diferentes categoras de problemas. La mayora de los problemas de interfaz de consola estn relacionados con el servidor de consola de Tivoli Universal Agent. Por esta razn, el ltimo punto menciona en general, el rastreo del programa cliente, kumpcon, no es necesario. Sin embargo, puede resultar til a veces si todo el panorama completo es necesario para determinar por qu un mandato de consola se cuelga o detecta un error. Cuando Tivoli Universal Agent se cuelga en los sistemas Windows, recopile los archivos drwtsn32.log y user.dmp. Si Dr. Watson an no est habilitado en el sistema, escriba el siguiente mandato:
drwtsn32.exe i
Cuando Tivoli Universal Agent se cuelga en los sistemas UNIX y Linux, recopile el archivo de imagen de memoria o escriba los mandatos del depurador necesarios para obtener el rastreo de la pila y redirija la salida del depurador a un archivo que se pueda enviar a ECUREP o realice una captura de pantalla de la salida del depurador. Como a menudo es difcil leer correctamente un archivo de imagen de memoria en un sistema UNIX diferente debido a incompatibilidades en la biblioteca del sistema, puede resultar til escribir unos cuantos mandatos de depuracin en el sistema donde se ha colgado Tivoli Universal Agent. De este modo, se asegura de que no tiene una incompatibilidad de bibliotecas del sistema o cualquier otro problema que impida que la imagen de memoria se lea correctamente. Y como mnimo, puede obtener un rastreo de pila, lo que a menudo es la nica informacin valiosa que se puede obtener de un archivo de imagen de memoria porque los archivos binarios UNIX de Tivoli Universal Agent no se crean con smbolos de depuracin.
264
Tivoli Universal Agent es ms configurable y personalizable que cualquier otro agente, por lo que otra documentacin de utilidad que se puede recopilar puede variar: v Archivos de configuracin (KUMENV, um.ini/um.config, KUMPCNFG, KUMSMIBI, etctera). Si no puede iniciar Tivoli Universal Agent, una funcin del producto no funciona, uno o ms DP no se inician, la supervisin no se realiza o se trata de un problema que puede estar condicionado por un valor de archivo de configuracin o una variable de entorno, necesitar ver qu aspecto tienen los archivos de configuracin. v Capturas de pantalla de salida incorrecta, mensajes DPLOG o ACTION, etctera. v Los listados de directorios en los archivos CAT, ATR o ODI de casos faltan o no son correctos. v Metarchivos. Muchos de los problemas de Tivoli Universal Agent, en especial, las cadas del sistema, una salida errnea, metarchivos que no se cargan, etctera, slo se pueden depurar con una copia del metarchivo. Por ejemplo, si faltan datos o son incorrectos en un espacio de trabajo para una aplicacin de Tivoli Universal Agent, es importante obtener el metarchivo, los datos de la aplicacin de ejemplo y las instrucciones especiales que sean necesarias para reproducir el problema. Compruebe si existe una codificacin del metarchivo incorrecta; por ejemplo: El tipo de datos incorrecto para un atributo. El delimitador de atributo incorrecto. Los campos de atributos que faltan. Los mensajes de aviso de validacin no resueltos. El valor de TTL es demasiado pequeo, lo que genera un tiempo de caducidad antes de que lleguen los datos.
Si revisa el registro, sabr que el archivo binario kuma610 de Tivoli Universal Agent se ejecuta en un sistema de 64 bits con Solaris 9 denominado abcd1234. Este archivo binario es una instancia principal de Tivoli Universal Agent y no una instancia alternativa porque el nombre de programa es kuma610 sin ningn sufijo de nombre de instancia. Tivoli Universal Agent no suministra un conjunto de archivos
265
binarios para Solaris 9 o Solaris 10, por lo que se utilizan los archivos binarios Solaris 8 de 64 bits de Tivoli Universal Agent del directorio /sol286. El rastreo RAS1 de nivel ERROR est en vigor.
-1:kumamain.cpp,465,"main") Default codepage <US-ASCII> locale <en_US_POSIX> -1:kbbssge.c,52,"BSS1_GetEnv") KBB_SIG1="-dumpoff" -1:kbbssge.c,52,"BSS1_GetEnv") KUMA_STARTUP_DP="ASFS" -1:kbbssge.c,52,"BSS1_GetEnv") KIB_MAXCOLS="127" -1:kbbssge.c,52,"BSS1_GetEnv") KUMA_GLOBALIZATION_ENABLED="Y" -1:RAS1,400,"CTBLD") Component: kum Driver: d5254b/3569281.18 Timestamp: Sep 12 2005 00:55:30 Target: sos58x6
La indicacin de la hora de compilacin del componente Tivoli Universal Agent debe coincidir con otras indicaciones de hora de componente Tivoli Monitoring en el registro. Si ve indicaciones de hora de compilacin diferentes con fechas diferentes, puede que el entorno instalado no sea correcto. Asimismo, si ve dos indicaciones de hora de compilacin de Component: kum en el mismo registro, pero con fechas distintas, es que hay un conjunto combinado de archivos binarios de Tivoli Universal Agent, posiblemente debido a un problema de actualizacin del fixpack. Todos los archivos binarios de Tivoli Universal Agent deben tener el mismo nivel de fixpack.
-1:kbbssge.c,52,"BSS1_GetEnv") KUM_WORK_PATH="/opt/IBM/ITM/sol286/um/work
Este ejemplo muestra un sistema en ingls, y se inicia el DP de ASFS. Los archivos binarios de Tivoli Universal Agent se crearon el 9/12/2005. Tivoli Universal Agent se instala en /opt/IBM/ITM/sol286/um.
266
-1:kum0ipds.c,235,"KUM0_InitializeProductSpec") -----El archivo de especificaciones del producto que se utiliza es /opt/IBM/ITM/sol286/um/work/KUMPSF-----1:kum0ipds.c,272,"KUM0_InitializeProductSpec") Rec 01 PRODUCT_CODE=UM -1:kum0ipds.c,741,"KUM0_InitializeProductSpec") Estn en efecto los siguientes parmetros de especificacin de producto: -1:kum0ipds.c,813,"KUM0_InitializeProductSpec") PRODUCT_CODE=UM -1:kum0ipds.c,813,"KUM0_InitializeProductSpec") NODE_TYPE=UA -1:kum0ipds.c,813,"KUM0_InitializeProductSpec") PRODUCT_NAME=Universal Agent
El archivo de especificaciones del producto de Tivoli Universal Agent, KUMPSF, se ha situado correctamente en el directorio /work. Si este archivo no existe, Tivoli Universal Agent no se iniciar. Todos los valores PSF se envan automticamente en eco al registro RAS1.
-1:kumamain.cpp,695,"UA_Main") Arranque de Universal Agent en proceso -1:kumamain.cpp,728,"UA_Main") La globalizacin est habilitada -1:kbbssge.c,52,"BSS1_GetEnv") KDCB0_HOSTNAME="abcd1234" -2:kumdsock.cpp,1209,"ipcSock::allocateDCHport") Puerto 1919 de DCH de Universal Agent abierto satisfactoriamente -1:kbbssge.c,52,"BSS1_GetEnv") CTIRA_HOSTNAME="abcd1234
El puerto 1919 de DCH se ha asignado correctamente. Si este puerto no se puede asignar, Tivoli Universal Agent se cierra. La variable de entorno CTIRA_HOSTNAME se ha establecido correctamente porque coincide con el nombre del sistema abcd1234 en la parte superior del registro.
-4:kumpstrt.c,116,"KUMP_StartDataProvider") Input DP Type is ASFS -1:kumamain.cpp,1709,"UA_Main") Arranque de Universal Agent completado. Ahora se est iniciando 1 Proveedor(es) de datos... -4:kbbssge.c,52,"BSS1_GetEnv") KUMP_INIT_CONFIG_PATH="/opt/IBM/ITM/sol286/um/work" -4:kbbssge.c,52,"BSS1_GetEnv") KUMP_META_PATH="/opt/IBM/ITM/sol286/um/metafiles" -4:kbbssge.c,52,"BSS1_GetEnv") KIB_MAXCOLS="127" -4:kumpsdpe.c,78,"KUMP_StartDataProviderEnvironment") -----> KUM610 9/11/05 Tipo DP de ASFS producto Universal Agent <-----8:kbbssge.c,52,"BSS1_GetEnv") CTIRA_LOG_PATH="/opt/IBM/ITM/logs" -7:kumdchsv.cpp,1310,"DCHserver::dp_register") Aplicacin <UAGENT> registrada correctamente
La primera etapa de la inicializacin de Tivoli Universal Agent se ha completado. El DP de ASFS se inicia ahora. Cada DP que se activa contiene su propio mensaje de rastreo de KUMP_StartDataProviderEnvironment porque cada DP se ejecuta en su propio subproceso. El mensaje de rastreo incluye el tipo de DP y la fecha en que se ha compilado el mdulo fuente de Tivoli Universal Agent asociado. La aplicacin UAGENT que pertenece al DP de ASFS se ha registrado con la infraestructura del agente. Como una aplicacin interna proporcionada por Tivoli Universal Agent, UAGENT siempre se registra antes de que se procesen los metarchivos. Ahora hay varios subprocesos de Tivoli Universal Agent en ejecucin. Observe los nmeros de subprocesos cuyo prefijo es un guin en un registro de Tivoli Universal Agent, que preceden a los nombres de archivo fuente. Tivoli Universal Agent contiene muchos subprocesos y a veces para diagnosticar problemas puede ser muy til supervisar qu ocurre en diferentes subprocesos.
-4:kumppcfg.c,134,"KUMP_ProcessStartUpConfig") Cargando metarchivo </opt/IBM/ITM/sol2i86/um/metafiles/ApacheLogFileProvider.mdl> de archivo de configuracin de arranque /opt/IBM/ITM/sol286/um/work/KUMPCNFG -4:kbbssge.c,52,"BSS1_GetEnv") KUMP_RB_PATH="/opt/IBM/ITM/sol286/um/rb" -7:kumdchsv.cpp,1310,"DCHserver::dp_register") Aplicacin <APACHE> registrada correctamente -4:kumppcfg.c,134,"KUMP_ProcessStartUpConfig") Cargando metarchivo <TomcatApplication.mdl> de archivo de configuracin \ de arranque /opt/IBM/ITM/sol286/um/work/KUMPCNFG -7:kumdchsv.cpp,1310,"DCHserver::dp_register") Aplicacin <TOMCATAPPLICATION> registrada correctamente -4:kumppcfg.c,170,"KUMP_ProcessStartUpConfig") 2 metarchivo(s) de aplicacin procesado(s) de archivo de configuracin de arranque /opt/IBM/ITM/sol286/um/work/KUMPCNFG
Cada metarchivo que Tivoli Universal Agent activa genera su propio mensaje de rastreo de nivel ERROR. En este registro, se ven que los dos metarchivos, ApacheLogFileProvider.mdl y TomcatApplication.mdl, se estn activando. Como se utiliza el DP de ASFS, no queda claro todava si los metarchivos son para los DP de API, Socket, Archivo o Script.
Apndice J. Determinacin de problemas
267
-F:kumpapis.c,70,"KUMP_SOCKpgmAPIServer") DP de APIS usando puerto de escucha 7600 -4:kbbssge.c,52,"BSS1_GetEnv") KUMP_SCRIPT_DEBUG="N" -10:kumpsock.c,68,"KUMP_SocketServer") DP de socket utilizando puerto 7500 -13:kumpcmdk.c,99,"KUMP_SockConsoleSupport") Puerto 7701 de consola DP de ASFS abierto -13:kumpcmdk.c,137,"KUMP_SockConsoleSupport") Puerto 7700 de consola DP de APIS abierto
Los mensajes de arranque de Tivoli Universal Agent incluyen puertos de escucha de consola y, si procede, los puertos utilizados por los DP de API y Socket a la escucha de conexiones cliente. Estos mensajes pueden ser tiles si hay un problema, por ejemplo, con el programa kumpcon al establecer una conexin de socket con Tivoli Universal Agent.
-12:kumpscrp.c,200,"KUMP_ScriptServer") Archivo de script </opt/IBM/ITM/sol286/um/scripts/ ubicado correctamente check_tomcat_appl.pl> tabla <TomcatApplication> -14:kumaudi.cpp,2685,"userDataList::calculateChecksum") Conservando versin 06.01.00 existente para aplicacin <TOMCATAPPLICATION> -12:kumpscrp.c,224,"KUMP_ScriptServer") Origen de script </opt/IBM/ITM/sol286/um/scripts/ check_tomcat_appl.pl> tabla <TOMCATAPPLICATION> est ahora en lnea en el proveedor de datos -15:kumaudi.cpp,2685,"userDataList::calculateChecksum") Conservando versin 06.00.00 existente para aplicacin <APACHE>
Ahora ya sabe que TomcatApplication.mdl es un metarchivo del DP de script. Este metarchivo se ha modificado porque se utiliza la versin -01. El otro metarchivo para la aplicacin Apache est en la versin -00.
-5:kum0c2up.c,49,"KUM0_ConvertStringToUpper") ***** La cadena de entrada es NULL
ste es el ltimo mensaje del registro de Tivoli Universal Agent antes de colgarse. Los mensajes de error de Tivoli Universal Agent suelen llevar como prefijo una cadena de asteriscos. Estos mensajes pretenden captar su atencin para ayudarle a detectar un problema o un problema potencial. En este problema en concreto, el cliente ha enviado varios registros RAS1 de Tivoli Universal Agent y en cada caso, el mismo mensaje de error ***** La cadena de caracteres de entrada es NULL siempre era la ltima entrada del registro, por lo tanto sabe que de alguna manera estaba anticipando la cada del sistema y que la cada del sistema se produjo en el subproceso 5. La cada del sistema ha empezado a suceder despus de que el cliente modificara el archivo TomcatApplication.mdl. Ha sido preciso obtener documentacin adicional para diagnosticar este problema, en concreto, una copia del metarchivo y un registro RAS1 de Tivoli Universal Agent detallado con (UNIT:kump ALL) rastreo. Este problema requera un arreglo de cdigo porque una funcin de atributo derivado no estaba comprobando si haba una cadena de caracteres de entrada vaca.
268
establecida en 5348 - ibm-5348_P100-1997, Idioma 55050241 (454A05A0.0000-15B0:kumamain.cpp,1784,"UA_Main") Arranque iniciando 1 proveedor(es) de datos... (454FA2C3.0000-6D8:kumamain.cpp,618,"main") Conclusin de (454FA2C3.0001-6D8:kumamain.cpp,659,"main") Conclusin de
- en de Universal Agent completado. Ahora se est Universal Agent en proceso Universal Agent completada
Se intenta realizar un rastreo detallado con los parmetros (UNIT:kumamain ALL) (UNIT:kump ALL) y an as, es un registro de rastreo de Tivoli Universal Agent mnimo, que podra levantar sospechas. Tras examinar el registro de nivel ERROR anterior, observe que en este archivo faltan muchas sentencias de rastreo de arranque de Tivoli Universal Agent, como por ejemplo, los valores de la variable de entorno actual, las asignaciones del puerto de consola, los registros de aplicaciones, etctera. Un registro mnimo como ste significa que falta la variable de entorno KBB_RAS1 o bien est codificada incorrectamente. En este ejemplo, hay dos puntos adicionales despus de ERROR, que invalidaban toda la variable de entorno KBB_RAS1. Una buena idea es comprobar la Fecha de inicio (Start Date) al principio del archivo para verificar si se est examinando el registro correcto y no uno de un arranque de Tivoli Universal Agent anterior.
Tivoli Universal Agent debe poder asignar un puerto de escucha de condicin de excepcin durante el arranque. De forma predeterminada, el puerto de escucha de condicin de excepcin es 162, pero este valor se puede alterar temporalmente con la variable de entorno KUMP_SNMP_TRAP_PORT. Las condiciones de excepcin de entrada se visualizan en el espacio de trabajo TRAP debajo del nodo &hostname:SNMP-MANAGER en Navigator. La aplicacin SNMP-MANAGER se activa automticamente cuando se inicia el DP de SNMP y no requiere un metarchivo separado. Cualquier condicin de excepcin recibida por el DP de SNMP debe estar definida en el archivo trapcnfg situado en el directorio \work de Tivoli Universal Agent. Cada producto del proveedor que emite una condicin de excepcin al DP de SNMP debe tener un registro de tipo 2 (Type 2) y tipo 3 (Type 3) con un OID de empresa definido en trapcnfg; por ejemplo:
intelliWatch-Monitor {1.3.6.1.4.1.1983.1.1} (Type 2 criticalAlarm {1.3.6.1.4.1.1983.1.1} 6 1 A 1 0 "Sucesos de estatus (Type 3)
En esta definicin de condicin de excepcin intelliWatch, 1983 es el OID de empresa, 6 es el nmero de condicin de excepcin genrico y 1 es el nmero de condicin de excepcin especfico. Cuando se recibe una condicin de excepcin, el DP de SNMP busca el valor OID de empresa de la condicin de
Apndice J. Determinacin de problemas
269
excepcin, el nmero de condicin de excepcin genrico y un nmero de condicin de excepcin especfico en la copia de memoria cach de trapcnfg. Si no se encuentra ninguna coincidencia, se establece No disponible en los atributos de espacio de trabajo TRAP de SNMP-MANAGER. No hay ningn mensaje de rastreo de nivel ERROR predeterminado cuando se recibe una condicin de excepcin. Si necesita determinar si se reciben condiciones de excepcin, debe establecer
KUMP_SNMP_DEBUG_TRAP=Y
La recepcin de condiciones de excepcin de Tivoli Universal Agent funciona de forma ligeramente diferente en los sistemas UNIX y en los sistemas Windows. En los sistemas Windows, el receptor de condiciones de excepcin es un subproceso dentro del proceso kuma620 de Tivoli Universal Agent principal, mientras que en los sistemas UNIX, hay un proceso receptor de condiciones de excepcin distinto denominado kumstrap, que es un pequeo programa autnomo que recibe condiciones de excepcin, y a continuacin, las reenva al DP de SNMP de Tivoli Universal Agent para el examen de trapcnfg, el anlisis, y la actualizacin del espacio de trabajo TRAP. Si el proceso kumstrap no se ha iniciado correctamente y ve el siguiente mensaje despus de emitir itmcmd agent start um, entonces Tivoli Universal Agent no puede recibir condiciones de excepcin:
"Nota: El proceso de Universal Agent kumstrap no se ha iniciado."
El proceso kumstrap y el proceso de descubrimiento de red kumsnetd se separan de Tivoli Universal Agent en las plataformas UNIX porque estas dos funciones SNMP requieren autorizacin de nivel root para asignar los puertos 162 y 520 respectivamente. Si los procesos no estn separados y ha habilitado las funciones de recepcin de condiciones de excepcin o descubrimiento de red del DP de SNMP, Tivoli Universal Agent siempre debe iniciarse con autorizacin root. Si slo utiliza el DP de SNMP para la recopilacin de datos MIB, especifique las siguientes sentencias para que la autorizacin root no sea nunca necesaria:
KUMP_SNMP_MONITOR_TRAP=N KUMP_SNMP_NET_DISCOVERY=N
Ocasionalmente, puede detectar problemas de autorizacin UNIX con los archivos binarios kumstrap o kumsnetd. Puede resolver estos problemas (1) iniciando Tivoli Universal Agent con un ID raz o (2) utilizando el script SetPerm en el directorio /bin para establecer el bit set-user-id en los archivos binarios kumstrap y kumsnetd, si por alguna razn no se han instalado de ese modo. Con la segunda opcin, no es necesario iniciar Tivoli Universal Agent con un ID raz para que los dos procesos se inicien correctamente. En los sistemas UNIX cuando el receptor de condiciones de excepcin kumstrap se ejecuta como un proceso autnomo, Tivoli Universal Agent debe ser capaz de registrarse l mismo en el proceso kumstrap como parte interesada. Este registro es un convenio de SNMP que permite que otros procesos en el mismo sistema indiquen que desean que se les reenven todas las condiciones de excepcin recibidas. Este tipo de mecanismo es necesario porque slo un proceso en un sistema puede adquirir el puerto 162, pero puede haber varios procesos que estn interesados en las notificaciones de condiciones de excepcin. Observe que se utiliza el mismo mecanismo cuando Tivoli Universal Agent y el DP de SNMP se ejecutan en los sistemas Windows y el servicio de condiciones de excepcin de SNMP proporcionado por Windows se ha iniciado primero y ya ha adquirido el puerto 162. En dicho caso, Tivoli Universal Agent se registra l mismo como parte interesada en el servicio de condiciones de excepcin de SNMP Windows. Si las condiciones de excepcin no se muestran en el espacio de trabajo TRAP o no se visualizan correctamente, significa que hay un problema de condicin de excepcin entrante. En este caso, formlese las siguientes preguntas: v El DP de SNMP est ejecutndose? v El agente de SNMP est configurado para enviar condiciones de excepcin al host de Tivoli Universal Agent?
270
v El puerto de escucha de la condicin de excepcin del DP de SNMP estaba asignado? Si no es as, se generarn mensajes de error en el registro RAS1 de Tivoli Universal Agent o en el registro detallado kumstrap. v En las plataformas UNIX, el DP de SNMP se ha registrado l mismo satisfactoriamente como parte interesada del proceso kumstrap? Si no es as, se generarn mensajes de error en el registro RAS1 de Tivoli Universal Agent y en el espacio de trabajo UAGENT DPLOG. v Las condiciones de excepcin se visualizan en el espacio de trabajo TRAP pero no lo hacen correctamente? Si ve No disponible en muchos de los problemas de espacio de trabajo TRAP, significa que en el archivo trapcfng faltan definiciones para uno o ms tipos de condiciones de excepcin. v Ha fusionado las sentencias de definicin de condicin de excepcin adecuadas (suponiendo que se proporcionaran tras una conversin de MIB a MDL) en el archivo trapcnfg maestro? v Ha importado el metarchivo de SNMP que se haba generado tras la conversin de MIB? Para problemas de condiciones de excepcin entrantes, se puede capturar el mejor rastreo detallado con:
KUMP_SNMP_DEBUG_TRAP=Y
En los sistemas UNIX, el proceso kumstrap tiene su propio mecanismo de rastreo no RAS1 autnomo que se puede activar estableciendo la variable de entorno KUMP_SNMP_TRAP_VERBOSE en Y y redirigiendo la salida de rastreo detallada a un archivo; por ejemplo:
KUMP_SNMP_TRAP_VERBOSE=Y>/opt/IBM/ITM/logs/kumstrap.log
Nmero de error 125 en la mayora de plataformas UNIX significa Direccin en uso. En las plataformas Windows; el nmero de error equivalente es 10048.
271
Tivoli Universal Agent debe asignar correctamente el puerto 1919 de DCH durante el arranque o no podr funcionar y se cerrar. El puerto de DCH es necesario para todas las comunicaciones entre los proveedores de datos (DP). Algunas posibles explicaciones de este error son: v Se ha iniciado otro Tivoli Universal Agent en el mismo sistema y el otro Tivoli Universal Agent an no se ha cerrado o no se ha cerrado correctamente; por lo tanto, no ha liberado el puerto de DCH. v Hay un proceso que no es de Tivoli Universal Agent en ejecucin en el mismo sistema que tambin ha asignado el puerto 1919. Si este fuera el caso y el otro proceso fuera necesario, puede realizar una de las tareas siguientes Configurar una instancia de Tivoli Universal Agent alternativa, O BIEN Establecer KUMA_DCH_PORT=nnnnn en el archivo kumenv o um.ini. Esta variable de entorno hace que Tivoli Universal Agent asigne un puerto de DCH diferente durante el arranque. A continuacin se muestra un ejemplo de un error de arranque de Tivoli Universal Agent en AIX 5.3:
(455AE41C.002D-1:kumamain.cpp,749,"UA_Main") Arranque de Universal Agent en proceso (455AE41D.0000-1:kbbssge.c,52,"BSS1_GetEnv") KDCB0_HOSTNAME="sgs1prod" (455AE41D.0001-1:kum0sock.c,144,"KUM0_OpenLocalSocket") vinculacin errnea para socket 4 de UDP de direccin local, puerto=0, nm.error=68 (455AE41D.0002-1:kumdsock.cpp,1702,"ipcSock::IPCClient") Error: _sockUDP[-1] nm.error=68 (455AE41D.0003-1:kumdipc.cpp,147,"DCHipC::startup") Error: IPCClient errneo. (455AE41D.0004-1:kumdsock.cpp,210,"ipcSock::ipcSock") Error: arranque errneo. _sockError=1 (455AE41F.0000-2:kum0sock.c,144,"KUM0_OpenLocalSocket") vinculacin errnea para socket 4 de UDP de direccin local, puerto=1919, nm.error=68 (455AE41F.0001-2:kum0sock.c,144,"KUM0_OpenLocalSocket") vinculacin errnea para socket 4 de TCP de direccin local, puerto=1919, nm.error=68 (455AE41F.0002-2:kumdsock.cpp,1035,"ipcSock::allocateDCHport") Error: No se han podido abrir los sockets TCP/UDP vinculados a Universal Agent DCH puerto 1919, Nm. error de UDP: 68, Nm error de TCP: 68. Saliendo... (455AE41F.0003-2:kumamain.cpp,388,"StopAgentProcess") Se est deteniendo el proceso de Universal Agent
Determine si el arranque de Tivoli Universal Agent que ha terminado anormalmente tambin se debe a que el puerto de DCH est ocupado. Tenga en cuenta que un valor nmero de error en un registro de Tivoli Universal Agent siempre es un cdigo de error de SO y no un cdigo de error de Tivoli Universal Agent. En cualquier sistema AIX, puede comprobar el archivo errno.h en el archivo /usr/include. A continuacin, se muestran dos definiciones relevantes:
#define EADDRINUSE 67 /* La direccin ya est en uso */ #define EADDRNOTAVAIL 68 /* No se puede asignar la direccin solicitada */
272
Si examina el valor System Name: en la parte superior del archivo de registro de Tivoli Universal Agent, puede comprobar si el nombre es el mismo que el que contiene KDCB0_HOSTNAME. En este registro, el valor de System Name: era sys1sist, que no coincida con sgs1prod. La resolucin correcta es volver a ejecutar el mandato ./itmcmd config A um y escribir ninguno (none) como respuesta a la solicitud Especifique el Nombre de red principal opcional. Dicha resolucin permite que Tivoli Universal Agent vincule sockets con el nombre de host sys1sist local predeterminado, lo que genera un arranque satisfactorio. Otra variante de este problema aparece si Tivoli Universal Agent se ejecuta en un sistema de mltiples NIC y la variable de entorno KDCB0_HOSTNAME o KDEB_INTERFACELIST no se ha establecido en la direccin IP que Tivoli Universal Agent precisa utilizar.
Tivoli Universal Agent se cuelga poco despus de arrancar en un sistema AIX 5.3 de 32 bits
Tras instalarse en un sistema AIX 5.3 de 32 bits, Tivoli Universal Agent no consigue iniciarse la primera vez, y en vez de ello, se cuelga poco despus del arranque. Esto se debe a un problema de carga de GSKit, lo que aparentemente slo se produce en sistemas AIX 5.3 de 32 bits. Este error se resuelve instalando un nivel de parche de AIX superior: AIX 5300-05-02. Hasta que se pueda instalar el nivel de parche de AIX, una solucin alternativa es tener un archivo KUMATBLS no vaco en el directorio /um/work. La presencia de definiciones de tabla en KUMATBLS altera el tiempo de arranque del agente, lo que a su vez permite que el proceso de carga GSKit se complete satisfactoriamente. A continuacin se muestra un ejemplo de lo que se puede aadir a KUMATBLS para evitar el error:
UAGENT00 UAG524400 0 UAGENT00 UAG6034300 0
Observe que despus de que Tivoli Universal Agent se haya iniciado satisfactoriamente al menos una vez, el archivo KUMATBLS nunca est vaco, lo que significa que este error slo es posible la primera vez que se inicia Tivoli Universal Agent despus de la instalacin.
273
-17:kdspmcat.c,873,"CompilerCatalog") Columna UA9 en la tabla UAG6034300 de la aplicacin UAG00 no encontrada. -17:kdspmcv.c,367,"CreateViewPlan") Error de informacin del catlogo; estatus = 202 -17:kdsvws1.c,1380,"CreateServerView") Estatus incorrecto de VPM1_CreateViewPlan, 202
Si un espacio de trabajo de Tivoli Universal Agent est completamente vaco sin ningn encabezado de columna, el archivo de registro del servidor de supervisin a menudo corrobora que un problema de catlogo es la razn de que el espacio de trabajo est en blanco. Suponga que las entradas xxxxx:DM37X00 tienen espacios de trabajo vlidos con encabezados de columna, pero no hay ningn valor de atributo en las columnas. Con toda probabilidad este problema es un problema de recopilacin de datos de Tivoli Universal Agent. O bien (1) los scripts no se estn ejecutando, (2) no envan datos a la salida estndar, (3) el tiempo TTL es demasiado corto y los datos se eliminan antes con demasiada rapidez o bien (4) Tivoli Universal Agent no procesa la salida del script y la reenva al servidor de supervisin. Si hay un problema de recopilacin de datos de Tivoli Universal Agent, obtenga un rastreo de RAS1 de Tivoli Universal Agent detallado, especificando KUMP_OUTPUT_DEBUG=Y. Como este problema afecta a una aplicacin DP de script, tambin es til establecer KUMP_SCRIPT_DEBUG=Y. Otro caso de tipo no hay salida se produce cuando algunos espacios de trabajo tienen datos y otros no. Examine el registro RAS1 de Tivoli Universal Agent. Si ve mensajes similares a los que se muestran a continuacin, significa que se ejecutan varios scripts desde el mismo metarchivo:
-B1C:kumpcadm.c,2906,"KUMP_ConstructApplDataModel") Aviso: Varias sentencias SOURCE requieren el parmetro ManagedSystemName
Estos errores se producen si Tivoli Universal Agent no puede identificar de forma exclusiva a qu fuente pertenecen los datos entrantes. El parmetro ManagedSystemName en la sentencia //SOURCE SCRIPT del metarchivo proporciona la identificacin necesaria. Este es un ejemplo real de un problema de tipo no hay salida: Descripcin del problema: No puedo supervisar ningn URL utilizando mi implementacin del proveedor de datos de HTTP de Universal Agent. He instalado y configurado un Universal Agent en mi servidor del portal y he aadido varios URL editando el archivo KUMPURLS y aadiendo los URL supervisados mediante el dilogo Actuacin. Cuando examino el espacio de trabajo en el rbol fsico debajo del URL gestionado, est completamente en blanco. Completamente en blanco es la mejor pista en esta descripcin del problema. Este problema significa que el cliente no ve encabezados de columna, lo que significa que el portal no puede obtener informacin sobre la aplicacin INTERNET del DP de HTTP. Esto parece similar a una coincidencia en la nota tcnica 1236104 de IBM Software Support. Tivoli Universal Agent slo carga archivos CAT y ATR en el servidor de supervisin en el que est configurado, que tal vez sea un servidor de supervisin remoto. En dicho caso, el portal no conocer la aplicacin INTERNET porque el portal obtiene la informacin de la aplicacin nicamente del servidor de supervisin concentrador. Para confirmar que ste es el problema correcto, compruebe si Tivoli Universal Agent est configurado en un servidor de supervisin remoto. Asimismo, el cliente debera ver un mensaje de error KFWxxxx en el cliente del portal al abrir el espacio de trabajo de Tivoli Universal Agent. Otra prueba irrefutable es que el registro del servidor de supervisin contendr mensajes de error relacionados con el catlogo.
274
El cliente ha reconfigurado Tivoli Universal Agent en el concentrador, y esto ha resuelto el problema. Otra resolucin es copiar los archivos INT CAT y ATR en el concentrador. (Nota: los 3 primeros caracteres del nombre de aplicacin INTERNET se utilizan cuando se mencionan los archivos CAT, ATR y ODI para la aplicacin). Este problema podra haberse evitado si en algn momento anterior, se haba configurado Tivoli Universal Agent en el servidor de supervisin concentrador y si resulta que Tivoli Universal Agent activ el proveedor de datos de HTTP. En dicho caso, los archivos CAT y ATR para la aplicacin INTERNET tendran que haberse subido al servidor de supervisin concentrador.
275
La interfaz de consola de Tivoli Universal Agent depende de la comunicacin de socket de programa a programa entre el programa kumpcon y el programa kuma620. Como kumpcon se ejecuta como un proceso autnomo, requiere su propio archivo de registro RAS1 separado para realizar un diagnstico. Para capturar un rastreo de kumpcon detallado en los sistemas Windows, escriba estos mandatos; por ejemplo:
\tmaitm6> \tmaitm6> \tmaitm6> set KBB_RAS1_LOG=c:\ibm\itm\tmaitm6\logs\kumpcon.log set KBB_RAS1=ERROR (UNIT:kump ALL) kumpcon refresh test.mdl
En las plataformas UNIX, el rastreo detallado de la consola requiere que se actualice el script de shell $ITMinstall_dir/bin/um_console, por ejemplo:
export KBB_RAS1_LOG=$ITMinstall_dir/logs/console.log export KBB_RAS1=ERROR (UNIT:kump ALL)
Si no est seguro si el problema se produce en el programa kumpcon o en el componente del servidor de Tivoli Universal Agent, capture tambin un rastreo de servidor de consola detallado del proceso de Tivoli Universal Agent principal:
KBB_RAS1=ERROR (UNIT:kumamain Error State) (UNIT:kumaprbl Error Detail Metrics) (UNIT:kumpccmd ALL) (UNIT:kumpcmdk ALL) (UNIT:kumpsrcc ALL) (UNIT:kumpca ALL) (UNIT:kumppcfg ALL) (UNIT:kumpdlta ALL) (UNIT:kumprthr ALL) (UNIT:kumprapr ALL)
ste es un ejemplo real de un problema en la interfaz de consola. Descripcin del problema: No consigo conectarme al servidor de mandatos de consola cuando ejecuto el mandato kumpcon, el error es kumps005e: En primer lugar, determine qu plataforma utiliza. Si es una plataforma distinta de Windows, el cliente no debe ejecutar directamente kumpcon. Compruebe si Tivoli Universal Agent est o no activo. Compruebe si hay un cortafuegos que bloquea la comunicacin de socket entre kumpcon y Tivoli Universal Agent. Compruebe si el cliente ejecuta una instancia de Tivoli Universal Agent principal o una alternativa. Si es la primera instancia alternativa, estar a la escucha en un puerto en el rango entre 8700 y 8710, y no entre 7700 y 7710. Si hay ms de una instancia alternativa, el puerto de escucha de la consola puede estar a la escucha en los rangos entre 9700 y 9710, 10700 y 10710, y as sucesivamente. Otras conversaciones con el cliente han mostrado la siguiente informacin: v El cliente estaba llamando directamente a kumpcon en un sistema UNIX en lugar de utilizar el script um_console. v El cliente haba creado una instancia alternativa de Tivoli Universal Agent, lo que significa que la variable de entorno KUMP_DPCONSOLE_PORT predeterminada seala incorrectamente la conexin de consola al puerto 7700 en lugar del puerto 8700. La exportacin de KUMP_DPCONSOLE_PORT=8700 antes de invocar kumpcon mediante el script um_console ha resuelto el problema.
Esta opcin es necesaria para cada uno de los grupos de atributos. La variable n empieza por 0 para cada atributo y aumenta de 1, segn convenga. Utilice PRIMARYKEY=0 como clave del identificador exclusivo en un grupo de atributos de varias filas. Por ejemplo, si un grupo de atributos describe unidades de disco, especifique PRIMARYKEY=0 con cada atributo que contenga el ID para cada unidad de disco. Esta palabra clave se utiliza a nivel de columna.
276
277
278
Apndice K. Accesibilidad
Las caractersticas de accesibilidad ayudan a los usuarios con alguna discapacidad fsica, ya sea movilidad restringida o visin limitada, a utilizar satisfactoriamente los productos de software. Las principales funciones de accesibilidad de este producto ayudan a los usuarios a realizar las siguientes acciones: v Utilizar tecnologas de asistencia como, por ejemplo, software lector de pantalla, para poder or lo que aparece en pantalla. Consulte la documentacin del producto de tecnologa de asistencia para obtener informacin detallada sobre cmo utilizar dichas tecnologas con este producto. v Utilizar funciones especficas o equivalentes utilizando slo el teclado. v Ampliar lo que aparece en la pantalla. Adems, la documentacin del producto se ha modificado a fin de incluir las siguientes caractersticas para aumentar la accesibilidad. v Toda la documentacin est disponible tanto en formato HTML como en el formato PDF convertible, para ofrecer a los usuarios el mayor nmero de posibilidades para poder utilizar software lector de pantalla. v Todas las imgenes que contiene la documentacin disponen de texto alternativo para que los usuarios que tengan problemas de visin puedan comprender el contenido de las imgenes.
279
280
Apndice L. Avisos
Esta informacin se ha desarrollado para los productos y servicios ofertados en los Estados Unidos. Es posible que IBM oferte los productos, servicios o funciones tratados en este documento en otros pases. Pngase en contacto con el representante IBM de su localidad para obtener informacin sobre los productos y servicios disponibles actualmente en su rea. Las referencias a productos, programas o servicios de IBM no implican ni sugieren que slo se pueda utilizar dicho producto, programa o servicios de IBM. En su lugar se puede utilizar cualquier producto, programa o servicio equivalente que no vulnere los derechos de propiedad intelectual de IBM. No obstante, es responsabilidad del usuario evaluar y verificar el funcionamiento de cualquier producto, programa o servicio que no sea de IBM. Sin embargo, el usuario es responsable de evaluar y verificar que este producto, programa o servicio que no es de IBM funcione correctamente. La posesin de este documento no le otorga ninguna licencia sobre dichas patentes. Puede enviar consultas sobre licencias, por escrito, a: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 EE.UU. Para las consultas sobre licencias referentes a informacin de doble byte (DBCS), pngase en contacto con el Departamento de propiedad intelectual de IBM en su pas o enve las consultas, por escrito, a: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japn El siguiente prrafo no se aplica en el Reino Unido ni en ningn otro pas en el que dichas disposiciones entren en conflicto con la legislacin local: INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIN TAL CUAL SIN GARANTAS DE NINGN TIPO, NI EXPLCITAS NI IMPLCITAS, INCLUIDAS, AUNQUE SIN LIMITARSE A, LAS GARANTAS DE NO CONTRAVENCIN, COMERCIALIZACIN O ADECUACIN A UN PROPSITO DETERMINADO. Algunos estados no permiten la declaracin de limitacin de responsabilidad de garantas explcitas o implcitas en determinadas transacciones, por lo que es posible que este prrafo no se aplique en su caso. Esta informacin puede incluir imprecisiones tcnicas o errores tipogrficos. Peridicamente se realizan cambios en la informacin aqu contenida; estos cambios se incorporarn en nuevas ediciones de la publicacin. IBM puede realizar mejoras y/o cambios en los productos y/o en los programas descritos en esta publicacin en cualquier momento y sin previo aviso. Cualquier referencia de esta informacin a sitios web que no sean de IBM se proporciona nicamente para su comodidad y no constituye un aval de dichos sitios web. El material de dichos sitios web no forma parte del material correspondiente a este producto IBM y el uso de estos sitios web se realiza a cuenta y riesgo del usuario. IBM puede utilizar o distribuir cualquier informacin que el usuario le suministre del modo que considere adecuado, sin incurrir por ello en ninguna obligacin con el usuario.
281
Los propietarios de licencias de este programa que deseen obtener informacin sobre el mismo con el fin de permitir: (i) el intercambio de informacin entre programas creados de forma independiente y otros programas (incluido este) y (ii) el uso mutuo de la informacin que se ha intercambiado, deben ponerse en contacto con: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 EE.UU. Puede que esta informacin est disponible, sujeta a los trminos y condiciones adecuados, y puede incluir, en algunos casos, el pago de una tarifa. IBM suministra el programa bajo licencia que se describe en este documento y todo el material bajo licencia disponible para el mismo, bajo los trminos del Acuerdo de cliente de IBM, el Acuerdo internacional de licencias de programas de IBM o cualquier acuerdo equivalente entre las partes. Esta informacin contiene ejemplos de datos e informes utilizados en operaciones empresariales diarias. Para ilustrarlos lo mejor posible, se han incluido nombres de individuos, compaas, marcas y productos. Todos estos nombres son ficticios y cualquier parecido con nombres y direcciones utilizados por empresas comerciales reales son mera coincidencia. LICENCIA DE COPYRIGHT: Esta informacin contiene programas de aplicacin de ejemplo en lenguaje fuente que ilustran tcnicas de programacin en diversas plataformas operativas. Puede copiar, modificar y distribuir estos programas de ejemplo del modo que desee, sin tener que pagar a IBM, con la finalidad de desarrollar, utilizar, comercializar o distribuir programas de aplicacin compatibles con la interfaz de programas de aplicacin para la plataforma operativa para la que se hayan escrito los programas de ejemplo. Estos ejemplos no se han probado exhaustivamente bajo todas las condiciones. Por lo tanto, IBM no puede garantizar ni dar a entender la fiabilidad, utilidad o funcionamiento de estos programas. Puede copiar, modificar y distribuir estos programas de ejemplo en la forma que desee, sin tener que pagar a IBM, con la finalidad de desarrollar, utilizar, comercializar o distribuir programas de aplicacin compatibles con las interfaces de programas de aplicacin de IBM. Cada copia o fragmento de estos programas de ejemplo o cualquier trabajo que de ellos se derive, deber incluir un aviso de copyright como el que figura a continuacin: (nombre de la empresa) (aos). Partes de este cdigo provienen de Programas de ejemplo de IBM Corp. Copyright IBM Corp. _entrar el ao o aos_. Reservados todos los derechos. Si visualiza esta informacin en copia software, es posible que las fotografas y las ilustraciones en color no se vean.
Marcas registradas
IBM, el logotipo de IBM, AIX, developerWorks, DB2, Lotus, MQSeries, NetView, OMEGAMON, OS/390, Tivoli, Tivoli Enterprise Console y z/OS son marcas registradas de International Business Machines Corporation en los Estados Unidos y/o en otros pases. Adobe y todas las marcas comerciales basadas en Adobe son marcas registradas de Adobe Systems Incorporated en los Estados Unidos y/o en otros pases.
282
Java y todas las marcas comerciales y logotipos basados en Java son marcas registradas de Sun Microsystems, Inc. en los Estados Unidos y/o en otros pases.
Linux es una marca registrada de Linus Torvalds en los Estados Unidos y/o en otros pases. Microsoft, Windows, Windows NT y el logotipo de Windows son marcas registradas de Microsoft Corporation en los Estados Unidos y/o en otros pases. UNIX es una marca registrada de The Open Group en los Estados Unidos y/o en otros pases. Los nombres de otras empresas, productos o servicios pueden ser marcas registradas o de servicio de otras empresas.
Apndice L. Avisos
283
284
ndice A
accesibilidad xix, 279 acceso a la ayuda 116 activacin de metarchivos utilizacin de los mandatos de Actuacin 22 activacin de metarchivos con mandatos de consola 21 Actuacin > Monitor Start, campo & 76 actualizacin 255 itmcmd 255 AgentData, 81 agentes SNMP recopilacin de datos para todo 81 almacenamiento de metarchivos 20 alteracin de los proveedores de datos 15 API dp_SetSourceName 43 invocacin de Tivoli Universal Agent 41 Aplicacin, nombre de instancia 38 aplicacin MAS 62 aplicacin SNMP-MANAGER 78 descripcin 75 aplicacin UAGENT 262 aplicaciones 36 creacin 17 definicin 17 importacin de definiciones de 34 restablecimiento de nmeros de versin 29 SNMP-MANAGER 78 UAGENT 262 versiones de 34 versiones de Tivoli Universal Agent 27 visin general 32 visualizacin de definiciones de 34 aplicaciones de Tivoli Universal Agent supervisin 113, 121 aplicaciones del proveedor de datos de SNMP nombres de sistemas gestionados 74 aplicaciones duplicadas 40 aplicaciones SNMP inicio de la recopilacin de datos de 81 nmeros de versin 34 SNMP-MANAGER 78 supervisin 81, 94 ventajas de la personalizacin 76 archivo ATR 26, 30 archivo ATR en sistemas Windows 27 archivo ATR en sistemas z/OS 27 archivo CAT 26, 30 archivo CAT en sistemas Windows 27 archivo CAT en sistemas z/OS 27 archivo de catlogo kum.cat 124 archivo de configuracin compartir 24 creacin 24 directrices de actualizacin 24 archivo de configuracin de condicin de excepcin 78 archivo de configuracin trapcnfg 229, 234 modificacin 233 tipos de registros en 229, 230 ubicacin de 229 valores predeterminados en 232, 233 visin general 229 archivo de nombres simblicos activacin 78 edicin de KUMSNAME 77 archivo de variables de entorno nombre y ubicacin 11 archivo ejecutable del proveedor de archivos de archivo ejemplo, kmpfile 259 archivo errno.h 272 archivo KUMENV 12 edicin en sistemas operativos Windows 12 archivo KUMSCOMM 76, 77 archivo KUMSNAME activacin 78 utilizacin para especificar nombres simblicos 77 archivo ODI 26, 30 archivo ODI dockum 124 archivo um_cleanup.bat parmetro de componente en sistema Windows 30 archivo um_cleanup.bat en sistema Windows parmetro directorio_trabajo 30 archivo um.config 12 archivo um.ini 12, 14 archivos ATR 26, 29, 30 ATR en sistemas Windows 27 ATR en sistemas z/OS 27 CANBASE.MIB 124, 125 CANSYSSG.MIB 124, 125 CAT 26, 29, 30 CAT en sistemas Windows 27 CAT en sistemas z/OS 27 configuracin 24 configuracin de condicin de excepcin 78 ejecutable del proveedor de datos de archivo kumpfile, ejemplo 259 emisor de SNMP, atributo kum.attr 124 emisor de SNMP, catlogo kum.cat 124 errno.h 272 KUMEN, entorno 14 KUMSCOMM 76, 77 KUMSNAME 77, 78 ODI 26, 29, 30 ODI dockum del emisor de SNMP 124 ubicacin de la configuracin 24 um_cleanup.bat 30 um_cleanup.bat en sistema Windows 30 um.config 12 um.ini 12, 14 variables de entorno 11 archivos ATR 29
285
archivos CAT 29 archivos de catlogos emisor de SNMP, catlogo kum.cat 124 archivos de configuracin KUMENV 258 KUMPCNFG 258 KUMPSF 258 KUMPURLS 258 ubicacin 24 um.config 258 um.ini 258 archivos ejecutables, ejemplo kmpfile del proveedor de datos de archivo 259 archivos ODI 29 asociacin de fuentes de datos con metarchivos asociacin explcita 107 sentencias SOURCE 103 atributo Agent_Info 36 atributo Agent_Name 36, 94 atributo de resultado de resumen del atributo numrico 163 atributo de resumen _Date_Time 161 atributo de resumen _DateTime 161 atributo de resumen _Interval 161 atributo de resumen _Interval_Unit 161, 163 atributo de resumen _Interval_Unit_Name 161 atributo de resumen _LocalTimeStamp 160, 161 atributo de resumen _Occurrences 161, 163 atributo de resumen Occurrences 161 atributo de salida Interval 161 atributo de salida LocalTimeStamp 161 atributo de salida Occurrences 161 atributos 191, 197 _Interval_Unit 163 _Occurrences 163 Agent_Name 94 clave 73 correlacin de variables MIB 191 creacin de nuevos 163 definicin 169 derivados 179 derivados, concatenacin de cadenas 180 derivados, funciones 180 GetEnvValue 180 ipAddressToName 180 NetWareTimeToText 180 TivoliLogTime 180 TivoliTimeStamp 180 UTCtoGMT 180 UTCtoLocalTime 180 derivados como nmeros reales 179 descripciones de 193 determinacin de caractersticas de 191 duplicado 177 filtrado 181, 184 filtrado, espacios de trabajo 181 invisibles 178 parmetro, definiciones 169 parmetro ATOMIC 172 parmetro CAPTION 173 parmetro comportamiento-agregado 174
atributos (continuacin) parmetro de cadena de caracteres ENUM 172 parmetro de tamao-mximo 171 parmetro de texto de ayuda 169 parmetro KEY 171 parmetro nombre-atributo 169 parmetro SCALE y PRECISION 173 parmetro tipo-atributo 169 resultado de resumen de atributo numrico result 163 resumen 160 resumen _Date_Time 161 resumen _Interval 161 resumen _Interval_Unit 161 resumen _Interval_Unit_Name 161 resumen _LocalTimeStam 161 resumen _Occurrences 161 RFC 1213 MIB-2 84 salida 161 secuenciado de definiciones 186 seleccin 120 sintaxis, definiciones 169 truncamiento por la izquierda 178 visin general 191 Atributos, parmetro 127 atributos clave 73, 161 atributos de resumen _DateTime 161 _Interval 161 _Interval_Unit 161 _Interval_Unit_Name 161 _LocalTimeStamp 160 grupo de atributos RequestSummary 160 Occurrences 161 atributos de salida atributos clave 161 intervalo 161 LocalTimeStamp 161 Occurrences 161 atributos derivados 179 creacin de atributos nuevos a partir de existentes 163 atributos derivados como nmeros reales 179 atributos invisibles 178 atributos RFC 1213 MIB-2 84 attrGroup 82 autentificacin de servidor proxy 55 avisos legales 281 ayuda acceso 116 creacin 19 espacio de trabajo 116 situaciones 116
B
bibliotecas ICU 184 bibliotecas compartidas KBB 258 KDC 258
286
bibliotecas compartidas (continuacin) KDE 258 KDH 258 KDSFILT 258 KGLBASE 258 KHDXCL1 258 KLX 258 KNS 258 KRA 258 KUM0620 257 KUMP620 257 KUMS1AP1 257 sistemas UNIX 257 bibliotecas de enlace dinmico Vase DLL bibliotecas de International Components for Unicode (ICU) 184
Consola de mensajes universales (UMC) 94 consultas espacio de trabajo, supresin 31 convenios, tipo de letra xx convenios de tipo de letra xx conversin de direcciones 102 correlacin de unidad lgica, utilizacin del proveedor de datos de archivo 44 CTIRA_HOSTNAME, ejemplo de variable de entorno 14 CTIRA_HOSTNAME, variable de entorno 14
D
datos de tablas ODBC 57 definicin de atributos 169 definicin LISTNAME 92 definiciones LISTNAME 92 definiciones de atributos 169 palabra clave AGPRF, parmetro comportamiento-agregado 174 palabra clave AGTIM, parmetro comportamiento-agregado 174 palabra clave BEHAV{<valor>}, parmetro comportamiento-agregado 174 palabra clave DEPRECATED, parmetro comportamiento-agregado 175 palabra clave OPTION{HISTORICALTIMESTAMP}, parmetro comportamiento-agregado 175 palabra clave OPTION{PRIMARYKEY=<n>}, parmetro comportamiento-agregado 175 palabra clave WHSC{<atributo>}, parmetro comportamiento-agregado 175 parmetro de texto de ayuda 176 parmetro DEFAULT 176 parmetro delimitador-especfico-atributo 175 parmetro FILTER 176 parmetro SEQ 176 parmetro SKEY 176 definiciones de datos 20 delimitadores, atributo ausente 156 delimitadores de atributos, ausentes 156 descubrimiento de red 89, 91 detencin 90 exclusin de una red 90 inicio 89, 90 Destino del emisor, parmetro 126 deteccin de interrupciones TCP 110 deteccin y recuperacin de errores UDP 111 detencin de la recopilacin de datos 82 detencin de los proveedores de datos 259 determinacin de problemas 261 direccin no disponible mensaje de error 272 directorio /ATTRLIB 27 directorio /RKDSCATL 27 directorio de scripts 70 directorio de trabajo establecimiento 12 directorios \TMAITM6\work en sistemas Windows 27
ndice
C
campo & en Actuacin > Monitor Start 76 campo, campo & en Actuacin > Monitor Start 76 caracteres delimitadores sentencia ATTRIBUTES 164 caracteres delimitadores del parmetro cadena-delimitadora, sentencia ATTRIBUTES 164 caracterstica de Actuacin Manage Start 89 Manage Stop 89, 90 mandato Monitor Stop 82 Monitor Start 81 caso 5 caso de configuracin Proveedor de datos de archivo, correlacin de unidad lgica 44 Categora, parmetro 126 Centro de informacin de software de Tivoli xviii clave de clasificacin de resumen Request 161 clave de clasificacin de resumen ServiceStatus 161 claves claves de clasificacin de resumen 161 claves de clasificacin de resumen 161 ClearValues parmetro, sentencia NAME 137 clientes de socket envo de mandatos de accin 108 CODEPAGE 45 comunicacin UDP, proveedor de datos de socket 108 concatenacin de cadenas de caracteres de atributos derivados 180 condiciones de excepcin integracin del Emisor de SNMP en un gestor de SNMP 124 configuracin de condicin de excepcin 229, 234 conjuntos de muestras ejemplo de proveedor de datos de archivo de varias filas 121 consideraciones sobre cortafuegos y puerto UDP 1919 272 Consola de favoritos Vase Consola de mensajes universales
287
directorios (continuacin) /RKDSCATL y /ATTRLIB 27 /um/work en sistemas UNIX 27 archivo de configuracin predeterminado en sistemas UNIX 24 archivo de configuracin predeterminado en sistemas Windows 24 scripts 70 trabajo predeterminado 25 distintivo -o creacin de instancias alternativas de Tivoli Universal Agent 38 distintivo de alteracin de mandato itmcmd agent 16 ejemplo de mandato itmcmd agent 16 distintivo -p distintivo de alteracin de mandato itmcmd agent 16 ejemplo de mandato itmcmd agent 16 distintivo de alteracin mandato itmcmd agent 16 distintivos -o, alteracin de mandato itmcmdagent 16 coincidencia de expresiones regulares 239 distintivos coincidentes de expresin, regulares 239 distintivos coincidentes de expresiones regulares 239 distribucin de situaciones 95 DLL KUM0620 257 KUMP620 257 KUMS1AP1 257 sistemas Windows 257 dp_SetSourceName API 43 duplicacin de atributos 177
E
Editor de situaciones 119 acceso a la ayuda para atributos y grupos de atributos 116 descripcin 120 Ejemplo 1 metarchivos ODBC 57 Ejemplo 2 161 metarchivos ODBC 58 Ejemplo 3 161 Ejemplo 4 162 Ejemplo 5 163 ejemplo de archivo ejecutable kumpfile 259 ejemplo de definiciones de grupo de atributos de resumen 163 ejemplo de funcin de atributo derivado, TivoliLogTime 181 ejemplo de grupo de atributos de resumen de definiciones de atributos 163 ejemplo de metarchivo de script 72 ejemplo de parmetro DEFAULT= 176 ejemplos -o, distintivos de alteracin de mandato itmcmd agent 16
ejemplos (continuacin) -p, distintivos de alteracin de mandato itmcmd agent 16 archivo de configuracin del proveedor de datos 24 archivo Windows .bat para iniciar el archivo ejecutable del proveedor de datos de archivo 259 caractersticas de metarchivos ODBC 58 conjunto de muestras de varias filas del proveedor de datos de archivo 121 creacin de instancias alternativas de Tivoli Universal Agent 38 CTIRA_HOSTNAME, variable de entorno 14 definiciones de atributos en un grupo de atributos de resumen 163 distintivo -o 38 Ejemplo 1 de metarchivo 160 Ejemplo 2 de definicin de metarchivo de grupo de atributos 161 ejemplo 2 de metarchivo 167 Ejemplo 3 161 Ejemplo 4 162 Ejemplo 5 163 funciones de atributos derivados 180 KBB_RAS1=ERROR ^>logfile 258 KBB_SIG1=dumpoff -asyncoff 258 KDC_FAMILIES=use:n ip use:y 258 KUMP_DCH_HOST=FIN1 258 kumpcon validate 21 metarchivo 167 metarchivo de script 72 metarchivos ODBC 57 nmero total, intervalo de resumen 162 parmetro DEFAULT= 176 Proveedor de datos de archivo, caso de configuracin de correlacin de unidad lgica 44 TivoliLogTime, funcin de atributo derivado 181 utilizacin de parmetros de agregacin en un metarchivo 175 ejemplos de funciones de atributos derivados 180 ejemplos de metarchivo utilizacin de parmetros de agregacin 175 emisor de SNMP archivo de atributos kum.attr 124 archivo de catlogo kum.cat 124 archivo ODI dockum 124 Atributos, parmetro 127 Categora, parmetro 126 Destino del emisor, parmetro 126 establecimiento de parmetros 125 Gravedad, parmetro 126 instalacin e integracin 124 integracin en soluciones de terceros 124 Invocar emisor una vez para cada parmetro de fila de datos 127 TrapDestination, parmetro 126 visin general 123 visualizacin de datos 125 Emisor de SNMP integracin de condiciones de excepcin en un gestor de SNMP 124
288
entorno de ejecucin inicio de proveedores de datos 257 entrada de espacio de trabajo FTPLOGFILE 7 entrada de varios registros 45 Error de arranque Nmero de error 10048 en los sistemas Windows 271 Error de arranque Nmero de error 125 Direccin en uso en sistemas UNIX 271 errores inicio 271 errores de inicio 271 errores de puerto de DCH 272 errores de vinculacin con EADDRNOTAVAIL 272 errores de vinculacin de EADDRNOTAVAIL 272 espacio de trabajo acceso a la ayuda 116 ACTION 118, 263 aplicacin MIB 95 aplicacin MIB de SNMP 80 aplicacin SNMP-MANAGER 75, 84 columnas de MANAGED-NODES 85 DPLOG 26, 117, 262 entrada FTPLOGFILE 7 Estatus de sistemas gestionados 29, 132 filtrado de atributos 181 FTPLOGFILE 7 GENERAL 63 HELPDESK 63 MANAGED-NODES 84, 85 MANAGED-NODES (o listas de favoritos) 75 MANAGED_URL 53 MIB 81 MIBNODATA 84, 85 MIBSTATUS 75, 82, 83, 84, 86 NETSUMMARY 84, 86, 247 NETWORK 75, 84, 87 otras versiones 27 personalizacin 116 personalizado 7 Proveedor de datos de SNMP 75 ROUTER 84, 88, 247 SNMP-MANAGER 84 SNMP-MANAGER TRAP 34, 78 supresin de consultas 31 TestScript 69 Tivoli Enterprise Portal 72, 73 TRAP 75, 79, 84, 88 UAGENT 113, 117 UAGENT ACTION 82, 83, 98 UAGENT DPLOG 39, 82, 83, 102, 208 vistas Fsica y Lgica de Navigator 115 visualizacin de datos bajo demanda actuales e histricos 5 visualizacin de datos histricos y en tiempo real 1 espacio de trabajo ACTION 118, 263 espacio de trabajo de aplicacin MIB 95 espacio de trabajo de portal 273, 276 espacio de trabajo de SNMP-MANAGER TRAP 78 espacio de trabajo de Tivoli Enterprise Portal 72, 73 espacio de trabajo DPLOG 26, 117, 262
espacio de trabajo Estatus de sistemas gestionados 132 Espacio de trabajo Estatus de sistemas gestionados 29 espacio de trabajo FTPLOGFILE 7 espacio de trabajo HELPDESK 63 espacio de trabajo MANAGED_URL 53 espacio de trabajo MIBNODATA 84, 85 espacio de trabajo MIBSTATUS 75, 82, 83, 84, 86 espacio de trabajo NETSUMMARY 84, 86 Espacio de trabajo NETSUMMARY 247 espacio de trabajo NETWORK 84, 87, 88 espacio de trabajo ROUTER 84, 88 Espacio de trabajo ROUTER 247 espacio de trabajo SNMP-MANAGER TRAP 34 espacio de trabajo TestScript 69 espacio de trabajo TRAP 75, 79, 84, 88 espacio de trabajo UAGENT 113 espacio de trabajo UAGENT ACTION 82, 83, 98 espacio de trabajo UAGENT DPLOG 39, 82, 83, 102, 208 espacios de trabajo de aplicaciones 115 espacios de trabajo de aplicaciones MIB de SNMP 80 espacios de trabajo de la aplicacin SNMP-MANAGER 84 espacios de trabajo de SNMP-MANAGER acceso 84 MANAGED-NODES 85 MIBSTATUS 86 NETSUMMARY 86 NETWORK 87, 88 ROUTER 88 TRAP 88 espacios de trabajo MANAGED-NODES 84, 85 espacios de trabajo MANAGED-NODES (o listas de favoritos) 75 espacios de trabajo MIB 81 espacios de trabajo NETWORK 75 espacios de trabajo UAGENT 117 Especificacin de intervalos de supervisin para situaciones 95 especificacin del cdigo de caracteres en sentencias SOURCE 109 registro de asociacin 110 exceso de tiempo de espera Proveedor de datos de socket 108 expresiones metacaracteres regulares 235 regulares ICU 235 expresiones regulares en filtros 184
F
FILTER, parmetro 28 definiciones de atributos 176 filtrado de atributos espacio de trabajo 181 filtrado de salidas de script no deseadas filtros expresin regular 184 fin de sesin de entrada de datos 109
72
ndice
289
formacin vase formacin tcnica de Tivoli xix formacin tcnica de Tivoli xix fuentes de datos asociacin con metarchivos 103 funcin de atributo derivado, ipAddressToName 180 funcin SETSOURCENAME 102 habilitacin 102 utilizacin para personalizar el nombre de host de un sistema gestionado 102 funciones de atributos derivados 180 GetEnvValue 180 ipAddressToName 180 NetWareTimeToText 180 TivoliLogTime 180 TivoliTimeStamp 180 UTCtoGMT 180 UTCtoLocalTime 180
I
IBM Tivoli Monitoring interaccin de componente y aplicacin con Tivoli Universal Agent 26 ICU International Components for Unicode 184 ICU User Guide 184 importacin de metarchivos 36 informacin de predicado, KUMP_TRAP_ADD_PREDICATES=Y 124 informes 89 SNMP-MANAGER 89 informes de SNMP-MANAGER 89 informes de validacin 35 inicio Proveedor de datos de HTTP 51 Proveedor de datos de SNMP 74 secuencia para proveedores de datos de Tivoli Universal Agent 259 inicio de la recopilacin de datos 81 visin general 81 inicio de proveedores de datos 257, 260 inicio del descubrimiento de red 89, 91 instancias alternativas definicin 38 utilizacin del distintivo -o para crear 38 interaccin con otros componentes de IBM Tivoli Monitoring 26 interfaz de mandatos de consola invocacin en sistemas operativos UNIX 207 invocacin en sistemas operativos Windows 207 interrupciones, TCP 110 INTERVAL=nn, parmetro 69 Interval=nnn, parmetro 72 intervalo 82 intervalo de muestreo 95 intervalo de resumen, nmero total 162 intervalo de situacin 121 intervalo de tiempo de vida (TTL) 44 Invocar emisor una vez para cada parmetro de fila de datos 127
G
generacin de metarchivos 59 GetEnvValue, funcin de atributo derivado 180 Gravedad, parmetro 126 grupo de atributos MANAGED-NODES 194, 195 grupo de atributos MIBNODATA 196 grupo de atributos MIBSTATUS 197 grupo de atributos NETSUMMARY 198, 199 grupo de atributos NETWORK 200, 201 grupo de atributos RequestSummary 160 grupo de atributos ROUTER 202, 203 grupo de atributos ServerLog 160 grupo de atributos TRAP 204, 206 grupos de atributos aplicacin SNMP-MANAGER MANAGED-NODES 78 MIBNODATA 78 MIBSTATUS 78 NETSUMMARY 78 NETWORK 78 ROUTER 78 TRAP 78 grupos SNMP-MANAGER 193 invisibles 138 MANAGED NODES 194, 195 MIB-2 192 MIBNODATA 196 MIBSTATUS 197 NETSUMMARY 198, 199 NETWORK 200, 201 otras versiones 27 RequestSummary 160 ROUTER 202, 203 TRAP 79, 204, 206 grupos de atributos, denominacin de 191 grupos de atributos invisibles 138 Grupos de atributos MIB-2 192 grupos de atributos SNMP-MANAGER 193
K
KBB_RAS1, parmetro utilizacin para diagnosticar nombres de host local 13 kum.attr, archivo de atributos del emisor de SNMP 124 KUM_DCH_HOST_NAME 208 KUM_UMC 94 KUM_WORK_PATH 229 KUM_WORK_PATH, variable de entorno 24 KUMA_DCH_PORT, variable de entorno 259 KUMA_STARTUP_DP, variable de entorno 11, 12, 15, 56, 74 KUMENV, archivo de entorno 14 KUMP_API_DPAPI_HOST 208 KUMP_API_DPAPI_HOST, variable de entorno 43 KUMP_API_DPAPI_PORT, variable de entorno 43 KUMP_DCH_HOST, variable de entorno 258
290
KUMP_DCH_HOST=FIN1, ejemplo 258 KUMP_DP_EVENT, variable de entorno 44 KUMP_DP_HOSTNAME 102 KUMP_DP_PORT 102 KUMP_DP_SAMPLE_FACTOR, variable de entorno 45 KUMP_DPCONSOLE_PORT, variable de entorno 39 KUMP_META_PATH, variable de entorno 20, 25, 35, 258 KUMP_META_SERVER, variable de entorno 25, 26 KUMP_POST_DP_PORT 60 KUMP_SNMP_AUTOSTART_COLLECTION_MIB2, variable de entorno 84 KUMP_SNMP_AUTOSTART_MIB_ variable de entorno COLLECTION 84 KUMP_SNMP_CONFIG_FILE 229 KUMP_SNMP_MANAGE_LOCAL_NETWORK=N, variable de entorno 90 KUMP_SNMP_MONITOR_TRAP=Y, variable de entorno 78 KUMP_SNMP_NET_COMMUNITY, variable de entorno 76, 77 KUMP_SNMP_TRAP_CONSOLE_SEV, variable de entorno 94 KUMP_SNMP_TRAP_PORT=nnn, variable de entorno 78 KUMP_TCP_DISCONNECT_BY_TTL, variable de entorno 111 KUMP_TCP_OUTAGE_WINDOW, variable de entorno 110 KUMP_TRAP_ADD_PREDICATES=Y, variable de entorno 124 KUMP_TRAP_DESTINATION, variable de entorno emisor de SNMP 124 KUMP_TRAP_EMIT_COMMUNITY, variable de entorno emisor de SNMP 124 KUMPCNFG 24 KUMPCNFG, archivo de configuracin compartir 24 kumpcon, ejemplo 21
listas de sistemas gestionados 95 *CUSTOM_AAARR 120 *UNIVERSAL_DATA_aaavv 95 LOADCOMM 216 LOADLIST 217 LOADNAME 218 LOCALE 45 LocalTimeStamp adicin de un columna 73
M
Manage Start 89 Manage Stop 89, 90 Manage Tivoli Enterprise Monitoring Services 15 ManagedSystemName=xxxxxx, parmetro 70 mandato ./itmcmd config A um 273 mandato, itmcmd utilizacin para iniciar Universal Agent 14 mandato de consola DELETE 210 mandato de consola GENERATE 211 mandato de consola IMPORT 214 mandato de consola LIST 215 mandato de consola MNL ADD NODE 219 mandato de consola MNL REMOVE NODE 220 mandato de consola REFRESH 221 mandato de consola SET 222 mandato de consola SHOW 223 mandato de consola SHUTDOWN 224 mandato de consola TRAPCNFG 234 mandato de consola UNPACK 226 mandato Dr. Watson 264 mandato GENERATE 59 mandato itmcmd agent distintivo -o 16 mandato itmcmd agent start um 79 mandato itmcmd config -A um 12 mandato kumpcon 259 mandato Monitor Stop 82 mandato netstat a 271 mandato ps 271 mandato SET 97, 98 mandato SHUTDOWN 259 mandato UNPACK 34 mandato VALIDATE 21, 34, 35, 36 mandatos ./itmcmd config A um 273 caracteres especiales xx Dr. Watson 264 envo de accin, clientes de socket 108 itmcmd, utilizacin para iniciar Universal Agent 14 itmcmd agent, distintivo -o 16 itmcmd agent start um 79 itmcmd config -A um 12 kumpcon 259 Monitor Stop 82 netstat a 271 ps 271 SET 98 SHUTDOWN 259 sintaxis xx
ndice
L
lectura de registros 265 libros Vase tambin publicaciones comentarios sobre xvii en lnea xvii pedir xvii lista de sistemas gestionados, *CUSTOM_AAARR lista de sistemas gestionados *UNIVERSAL_DATA_aaavv 95 listas de favoritos Vase listas de nodos gestionados listas de nodos gestionados 91, 94 activacin 92 creacin 91, 92 desactivacin 92 listas de favoritos 76 modificacin 92 ubicacin de 92
120
291
mandatos (continuacin) utilizacin de itmcmd para actualizar 255 VALIDATE 21 mandatos de consola 207, 227 DELETE 210 envo 39 especificacin de nombres en 208 GENERATE 211 IMPORT 214 kumpcon 259 LIST 215 LOADCOMM 216 LOADLIST 217 LOADNAME 218 MNL ADD NODE 219 MNL REMOVE NODE 220 REFRESH 221 resumen 207 SET 222 SHOW 223 SHUTDOWN 224 TRAPCNFG 225 UNPACK 226 utilizacin 207, 209 VALIDATE 227 manuales Vase tambin publicaciones comentarios sobre xvii en lnea xvii solicitud xvii marcas registradas 282 mensaje de error de arranque Nmero de error 10048 271 Nmero de error 125 Direccin en uso 271 mensaje de fin de transaccin, END-DP-INPUT 109 mensaje END-DP-INPUT 109 mensajes END-DP-INPUT 109 final de transaccin 109 mensajes de error arranque 271 direccin no disponible 272 metacaracteres expresin regular 235 metacaracteres de expresiones regulares 235 metarchivo, ejemplo 1 160 metarchivo de socket parmetro de prefijo de los registros de datos 105 metarchivo KUMPOST 62 metarchivos activacin 21 activacin mediante un archivo de configuracin 24 almacenamiento 20, 25 alteracin de la definicin central 26 asociacin con fuentes de datos 103 creacin 17 creacin de servidores 25 definicin de aplicaciones con 32 definicin de grupo de atributos; Ejemplo 2 161 descripcin 1 designacin de servidores 25
metarchivos (continuacin) Ejemplo 1 167 ejemplo 2 167 ejemplo ODBC 57 ejemplos 167 importacin 34 nomenclatura 19 nomenclatura de 33 ODBC 57, 58 script 66 sincronizacin del servidor y el cliente 26 sintaxis de sentencia de definicin de datos 129 socket 104, 105 ubicacin de 33 ubicacin del proveedor de datos 258 validacin 20, 21 versiones de 34 visualizacin 34 metarchivos de script 66 metarchivos de socket 104, 105 metarchivos ODBC 57, 58 ejemplo 57 ejemplo de caractersticas adicionales 58 metarchivos SNMP, slo de condicin de excepcin 34 metarchivos SNMP slo de condicin de excepcin 34 modalidad COPY 121, 183 modalidad COPY en el proveedor de datos de socket 112 modalidad de bloque en el proveedor de datos de socket 112 modalidades de ejecucin, scripts 69 modificacin de aplicaciones de Tivoli Universal Agent 27 Monitor Start 81
N
NetWareTimeToText, funcin de atributo derivado 180 nodo de latido 14 nodos latido 14 nombres 14 registro con el servidor de supervisin 14 subnodos de aplicacin 14 nombrehostDPTIPOdp:UAGENT00, nombre de sistema gestionado 38 NombreHostLocal, parmetro 44 nombres de comunidad Actuacin > Monitor Start, campo & 76 almacenados en KUMSCOMM 77 descubrimiento de red 76 especificacin 76 especificacin de valor predeterminado 77 Recopilacin de datos de MIB 76 resolucin 76 nombres de comunidad, especificacin 81 nombres de directorio, notacin xx nombres de host CTIRA_HOSTNAME, ejemplo de variable de entorno 14 subnodos 14
292
nombres de host (continuacin) utilizacin de variables de entorno a determinar para aplicaciones 13 utilizacin del parmetro KBB_RAS1 para diagnosticar nombres de host local 13 nombres de instancias Aplicacin 38 creacin, alternativas 38 Proveedor de datos 38 Prueba de latido 38 nombres de sistemas gestionados aplicaciones del proveedor de datos de socket 102 nombrehostDPTIPOdp:UAGENT00 38 nombres de sistemas gestionados de aplicaciones del proveedor de datos de SNMP 74 nombres de subnodos de aplicacin 14 nombres de va de acceso, notacin xx NombreSistemaGestionado, parmetro 44, 102 notacin nombres de va de acceso xx tipo de letra xx variables de entorno xx notificacin de desconexin TCP 111 nmero de modificacin 28 nmero de versin incremento 27, 29 nmeros de puerto 1919 necesario como puerto de escucha predeterminado 272 nmeros de puerto de escucha puerto UDP 1919 predeterminado 272 nmeros de versin restablecimiento de aplicacin 29 nmeros reales, atributos derivados 179
opciones COPY, sentencia SOURCE, parmetro modalidad-archivo 143 FILE, parmetro tipo, sentencia SOURCE 140 ODBC, parmetro tipo, sentencia SOURCE 140 opcin TRAP, parmetro tipo, sentencia SOURCE 140 SCRIPT, parmetro tipo, sentencia SOURCE 140 SNMP, parmetro tipo, sentencia SOURCE 140 SOCK, parmetro tipo, sentencia SOURCE 140 TAIL, sentencia SOURCE, parmetro modalidad -archivo 143 TAILBYCOUNT, sentencia SOURCE, parmetro modalidad-archivo 144 TAILBYRECORD, sentencia SOURCE, parmetro modalidad-archivo 143 TAILRESTART, sentencia SOURCE parmetro modalidad-archivo 143 TAILRESTARTFROMTOP, sentencia SOURCE, parmetro modalidad-archivo 144 operaciones SET 97, 98 procedimiento 98 requisitos 97
P
palabra clave 0xnn parmetro cadena-delimitadora, sentencia ATTRIBUTES 165 palabra clave AGPRF parmetro comportamiento-agregado, definiciones de atributos 174 palabra clave AGTIM parmetro comportamiento-agregado, definiciones de atributos 174 palabra clave BEHAV{<valor>} parmetro comportamiento-agregado, definiciones de atributos 174 palabra clave DEPRECATED parmetro comportamiento-agregado, definiciones de atributos 175 palabra clave END, parmetro mximo de registros y regla de identificacin, sentencia RECORDSET 155 palabra clave message, parmetro tipo_confirmacin, sentencia CONFIRM 157 palabra clave NEW, parmetro mximo de registros y regla de identificacin, sentencia RECORDSET 154 palabra clave NEWLINE parmetro cadena-delimitadora, sentencia ATTRIBUTES 165 palabra clave NONE parmetro cadena-delimitadora, sentencia ATTRIBUTES 165 palabra clave OPTION{HISTORICALTIMESTAMP} parmetro comportamiento-agregado, definiciones de atributos 175 palabra clave OPTION{PRIMARYKEY=<n>} parmetro comportamiento-agregado, definiciones de atributos 175 palabra clave SEQ, parmetro tipo_confirmacin, sentencia CONFIRM 157
ndice
O
opcin COPY, parmetro modalidad-archivo, sentencia SOURCE 143 opcin de Actuacin URL Add 52 Opcin de Actuacin URL Add 52 opcin FILE, parmetro tipo, sentencia SOURCE 140 opcin ODBC, parmetro tipo, sentencia SOURCE 140 opcin SCRIPT, parmetro tipo, sentencia SOURCE 140 opcin SNMP, parmetro tipo, sentencia SOURCE 140 opcin SOCK, parmetro tipo, sentencia SOURCE 140 opcin TAIL, sentencia SOURCE, parmetro modalidad-archivo 143 opcin TAILBYCOUNT, sentencia SOURCE, parmetro modalidad-archivo 144 opcin TAILBYRECORD, sentencia SOURCE, parmetro modalidad-archivo 143 opcin TAILRESTART, sentencia SOURCE, parmetro modalidad-archivo 143 opcin TAILRESTARTFROMTOP, sentencia SOURCE, parmetro modalidad-archivo 144 opcin TRAP, parmetro tipo, sentencia SOURCE 140
293
palabra clave SIZE, parmetro tipo_confirmacin, sentencia CONFIRM 157 palabra clave TAB parmetro cadena-delimitadora, sentencia ATTRIBUTES 165 palabra clave WHSC{<atributo>} parmetro comportamiento-agregado, definiciones de atributos 175 palabra clave Xnn, parmetro tipo_confirmacin, sentencia CONFIRM 157 palabras clave AGPRF, parmetro comportamiento-agregado, definiciones de atributos 174 AGTIM, parmetro comportamiento-agregado, definiciones de atributos 174 BEHAV{<valor>}, parmetro comportamientoagregado, definiciones de atributos 174 DEPRECATED, parmetro comportamientoagregado, definiciones de atributos 175 END, parmetro mximo de registros y regla de identificacin, sentencia RECORDSET 155 message, parmetro tipo_confirmacin, sentencia CONFIRM 157 NEW, parmetro mximo de registros y regla de identificacin, sentencia RECORDSET 154 NEWLINE, parmetro cadena-delimitadora, sentencia ATTRIBUTES 165 OPTION{HISTORICALTIMESTAMP}, parmetro comportamiento-agregado, definiciones de atributos 175 OPTION{PRIMARYKEY=<n>}, parmetro comportamiento-agregado, definiciones de atributos 175 palabra clave NONE, cadena-delimitadora 165 parmetro 0xnn, parmetro cadena-delimitadora, sentencia ATTRIBUTES 165 SEQ, parmetro tipo_confirmacin, sentencia CONFIRM 157 SIZE, parmetro tipo_confirmacin, sentencia CONFIRM 157 TAB, parmetro cadena-delimitadora, sentencia ATTRIBUTES 165 WHSC{<atributo>}, parmetro comportamientoagregado 175 Xnn, parmetro tipo_confirmacin, sentencia CONFIRM 157 paquete de cliente de API 41 parmetro SNMP TEXT 36 parmetro @helptext 19 parmetro -FILTER 72, 73 parmetro AddSourceName, sentencia, NAME 135 parmetro AddTimeStamp 73 sentencia NAME 136 parmetro argumentos-script, sentencia SOURCE 142 parmetro ATOMIC, definiciones de atributos 172 parmetro cadena-delimitadora, sentencia ATTRIBUTES 164 parmetro CAPTION, definiciones de atributos 173 parmetro Codepage=, sentencia SOURCE 146 parmetro CompareByLastUpdate 48, 144
parmetro CompareBySize 48, 144 parmetro comportamiento-agregado, definiciones de atributos 174 parmetro Database=, sentencia SOURCE 145 parmetro de arquitectura script um_cleanup.bat en los sistemas UNIX 31 parmetro de cadena de caracteres ENU, definiciones de atributos 172 parmetro de componente script um_cleanup.bat en los sistemas UNIX 31 script um_cleanup.bat en sistema Windows 30 parmetro de la sentencia INPUT, sentencia INTERNAL 150 parmetro de nombre-grupo-atributos, sentencia NAME 134 parmetro de nmero de puerto 105, 106 parmetro de nmero de puerto de la sentencia SOURCE SOCK 103, 104 parmetro de nmero de puerto metarchivo de socket 105 parmetro de sentencia OUTPUT, sentencia INTERNAL 150 parmetro de sentencia Select, sentencia SQL 158 parmetro de tamao mximo, definiciones de atributos 171 parmetro de tiempo de vida (TTL), sentencia NAME 135 parmetro DEFAULT 69 definiciones de atributos 176 parmetro delimitador-especfico-atributo definiciones de atributos 175 parmetro directorio_instalacin script um_cleanup.bat en los sistemas UNIX 31 script um_cleanup.bat en sistema Windows 30 parmetro directorio_trabajo archivo um_cleanup.bat en sistema Windows 30 parmetro DLM, sentencia ATTRIBUTES 165 parmetro DLMSTR, sentencia ATTRIBUTES 165 parmetro DLMSTRBGN, sentencia ATTRIBUTES 166 parmetro DLMSTREND, sentencia ATTRIBUTES 166 parmetro Envfile=, sentencia SOURCE 146 parmetro envfile=xxxx 67, 68 parmetro Force, sentencia SUMMARY 159 parmetro HostAddr=, sentencia SOURCE 148 parmetro HostInfo=, sentencia SOURCE 148 parmetro ID 52 parmetro intrprete-script, sentencia SOURCE 140 parmetro Interval=, sentencia SOURCE 147 parmetro Interval, sentencia NAME 136 parmetro Interval=nn 57 parmetro Intervalo 162 parmetro intervalo, sentencia SUMMARY 159 parmetro KEY, definiciones de atributos 171 parmetro KUMA_STARTUP_DP inicio del proveedor de datos de HTTP 51 parmetro Locale=, sentencia SOURCE 146 parmetro ManagedSystemName=, sentencia SOURCE 148 parmetro ManagedSystemName=xxxxxx 56 parmetro master 59 parmetro MATCHREGEX 182, 184
294
parmetro mximo de registros y regla de identificacin, sentencia RECORDSET 154 parmetro Maxrows=, sentencia SOURCE 145 parmetro mtodo, sentencia NAME 134 parmetro mtodo-comparacin-archivos, sentencia SOURCE 144 parmetro modalidad-archivo, sentencia SOURCE 143 parmetro nombre-atributo, definiciones de atributos 169 parmetro nombre de host de la sentencia SOURCE SOCK 103 parmetro nombre_TEMS script um_cleanup.bat en los sistemas UNIX 31 parmetro nombreaplic, sentencia APPL 131 parmetro nmero-de-registros-archivo, sentencia SOURCE 144 parmetro nmero_mximo_de_registros, sentencia RECORDSET 154 parmetro ObjCache% 52 parmetro ODBC 57 parmetro patrn delimitador, sentencia RECORDSET 153 parmetro ProductCode, sentencia APPL 132 parmetro proveedor de datos de ODBC sentencia NAME 57 parmetro pswd= 59 parmetro Pswd=, sentencia SOURCE 145 parmetro REPLACEALL 182, 184 parmetro REPLACEFIRST 182, 184 parmetro RunOnce=Y/N, sentencia SOURCE 148 parmetro Runtime 72 parmetro Runtime=, sentencia SOURCE 147 parmetro SCALE y PRECISION, definiciones de atributos 173 parmetro SCANREGEX 182, 184 parmetro SEQ definiciones de atributos 176 parmetro Server=, sentencia SOURCE 145 parmetro SETSOURCENAME 107 parmetro SETSOURCENAME =y 103 parmetro SetSourceName=Y/N, sentencia SOURCE 147 parmetro SKEY definiciones de atributos 176 parmetro SKEY=n, sentencia SUMMARY 160 parmetro SkipNonNumeric, sentencia NAME 137 parmetro SkipNonNumeric, sentencia SOURCE 140 parmetro SOCKET-COMMAND-ENABLED 107 parmetro StatusInterval 52 parmetro tailbyrecord 49 parmetro TEXT, sentencia SNMP 130 parmetro TEXT, SNMP 36 parmetro tipo, sentencia SOURCE 140 parmetro tipo-atributo, definiciones de atributos 169 parmetro tipo-cdigo, sentencia SOURCE 142 parmetro tipo_confirmacin, sentencia CONFIRM 157 parmetro ubicacin, sentencia SOURCE 141 parmetro URL 52 parmetro URLaliasName 52 parmetro user= 59 parmetro USER= 53
parmetro User=, sentencia SOURCE 145 parmetro WHEN{<valor>}, sentencia APPL 131 parmetros @helptext 19 -FILTER 72, 73 AddTimeStamp 58, 73 archivo um_cleanup.bat directorio_trabajo 30 archivo um_cleanup.bat en sistema Windows componente 30 argumentos-script, sentencia SOURCE 142 ATOMIC, definiciones de atributos 172 Atributos, emisor de SNMP 127 cadena de caracteres ENUM, definiciones de atributos 172 cadena-delimitadora, sentencia ATTRIBUTES 164 CAPTION, definiciones de atributos 173 Categora, emisor de SNMP 126 ClearValues, sentencia NAME 137 CODEPAGE 110 Codepage=, sentencia SOURCE 146 CompareByLastUpdate 48, 144 CompareBySize 48, 144 comportamiento-agregado, definiciones de atributos 174 Database=, sentencia SOURCE 145 DEFAULT 69 DEFAULT, definiciones de atributos 176 definiciones de atributos 169 delimitador-especfico-atributo, definiciones de atributos 175 Destino del emisor, emisor de SNMP 126 DLM, sentencia ATTRIBUTES 165 DLMSTR, sentencia ATTRIBUTES 165 DLMSTRBGN, sentencia ATTRIBUTES 166 DLMSTREND, sentencia ATTRIBUTES 166 Envfile=, sentencia SOURCE 146 envfile=xxxx 67, 68 FILTER 28 FILTER, definiciones de atributos 176 Force, sentencia SUMMARY 159 Gravedad, emisor de SNMP 126 HostAddr=, sentencia SOURCE 148 HostInfo=, sentencia SOURCE 148 ID 52 inicio, sistemas operativos Windows 15 inicio en los sistemas operativos UNIX 16 intrprete-script, sentencia SOURCE 140 Interval=, sentencia SOURCE 147 INTERVAL=nn 69 Interval=nn 57 Interval=nnn 72 intervalo, sentencia SUMMARY 159 intervalo de resumen 162 Invocar emisor una vez para cada fila de datos, emisor de SNMP 127 KBB_RAS1, utilizacin para diagnosticar nombres de host local 13 KEY, definiciones de atributos 171 KUMA_STARTUP_DP 51 lnea de mandatos CMS y CNPS 30
ndice
295
parmetros (continuacin) LOCALE 110 Locale=, sentencia SOURCE 146 ManagedSystemName=, sentencia SOURCE 148 ManagedSystemName=xxxxxx 56, 70 master 59 MATCHREGEX 182, 184 mximo de registros y regla de identificacin, sentencia RECORDSET 154 Maxrows=, sentencia SOURCE 145 mtodo-comparacin-archivos, sentencia SOURCE 144 modalidad-archivo, sentencia SOURCE 143 nombre-atributo, definiciones de atributos 169 nombre de host de la sentencia SOURCE SOCK 103 nombre de instancia 38 NombreHostLocal 44 NombreSistemaGestionado 44, 102 nmero de puerto 106 nmero de puerto, metarchivo de socket 105 nmero de puerto de la sentencia SOURCE SOCK 103, 104 nmero-de-registros-archivo, sentencia SOURCE 144 nmero_mximo_de_registros, sentencia RECORDSET 154 ObjCache% 52 ODBC 57 palabra clave 0xnn, sentencia ATTRIBUTES 165 palabra clave AGPRF, comportamiento-agregado, definiciones de atributos 174 palabra clave AGTIM, comportamiento-agregado, definiciones de atributos 174 palabra clave BEHAV{<valor>}, comportamientoagregado, definiciones de atributos 174 palabra clave CODEPAGE 45 palabra clave DEPRECATED, comportamientoagregado, definiciones de atributos 175 palabra clave LOCALE 45 palabra clave NEWLINE, cadena-delimitadora, sentencia ATTRIBUTES 165 palabra clave NONE, sentencia ATTRIBUTES 165 palabra clave OPTION{HISTORICALTIMESTAMP}, comportamiento-agregado, definiciones de atributos 175 palabra clave OPTION{PRIMARYKEY=<n>}, comportamiento-agregado, definiciones de atributos 175 palabra clave TAB, cadena-delimitadora, sentencia ATTRIBUTES 165 palabra clave WHSC{<atributo>}, comportamiento-agregado, definiciones de atributos 175 parmetro Interval= 58 patrn delimitador, sentencia RECORDSET 153 prefijo de los registros de datos, metarchivo de socket 105 proc=procedimiento almacenado, sentencia SQL 158 pswd= 59
parmetros (continuacin) Pswd= 71 Pswd=, sentencia SOURCE 145 REPLACEALL 182, 184 REPLACEFIRST 182, 184 Runtime 72 Runtime=, sentencia SOURCE 147 SCALE y PRECISION, definiciones de atributos 173 SCANREGEX 182, 184 script um_cleanup.bat en los sistemas UNIX arquitectura 31 componente 31 directorio_instalacin 31 nombre_TEMS 31 script um_cleanup.bat en sistema Windows directorio_instalacin 30 sentencia APPL nombreaplic 131 ProductCode 132 WHEN{<valor>} 131 sentencia ATTRIBUTES 164 sentencia CONFIRM tipo_confirmacin 157 sentencia INTERNAL 150 sentencia INPUT 150 sentencia OUTPUT 150 sentencia NAME AddSourceName 135 AddTimeStamp 136 intervalo 136 mtodo 134 nombre-grupo-atributos 134 SkipNonNumeric 137 tiempo de vida (TTL) 135 sentencia NAME, proveedor de datos de ODBC 57 sentencia RunOnce=Y/N SOURCE 148 sentencia Select, sentencia SQL 158 sentencia Server= SOURCE 145 sentencia SNMP TEXT 130 sentencia SOURCE 140 sentencia SOURCE, ubicacin 141 sentencia SUMMARY SKEY=n 160 SEQ, definiciones de atributos 176 SETSOURCENAME 107 SETSOURCENAME =y 103 SetSourceName=Y/N, sentencia SOURCE 147 SKEY, definiciones de atributos 176 SOCKET-COMMAND-ENABLED 107 StatusInterval 52 tailbyrecord 49 tamao-mximo, definiciones de atributos 171 texto de ayuda, definiciones de atributos 169, 176 texto de ayuda, sentencia APPL 132 texto de ayuda, sentencia NAME 138 tipo, sentencia SOURCE 140 tipo-atributo, definiciones de atributos 169 tipo-cdigo, sentencia SOURCE 142 TrapDestination, emisor de SNMP 126
296
parmetros (continuacin) URL 52 URLaliasName 52 user= 59 User= 71 USER= 53 User=, sentencia SOURCE 145 parmetros CODEPAGE 110 parmetros de inicio especificacin en los sistemas operativos UNIX 16 sistemas operativos Windows 15 parmetros de la sentencia ATTRIBUTES 164 parmetros de lnea de mandatos CMS y CNPS 30 parmetros de lnea de mandatos CMS y CNPS 30 parmetros de nombre de instancia 38 parmetros LOCALE 110 personalizacin de aplicaciones 35, 36 personalizacin de contenidos de espacios de trabajo 116 poltica, automatizacin 7 poltica de automatizacin 7 polticas descripcin 1 prefijo del parmetro de registros de datos, metarchivo de socket 105 problemas condicin de excepcin de SNMP 269 espacio de trabajo de portal 273, 276 interfaz de consola 275 problemas de condiciones de excepcin de SNMP 269 problemas de interfaz de consola 275 procedimiento de script de limpieza en sistemas UNIX 31 procedimiento de script de limpieza en sistemas Windows 30 proceso de descubrimiento de red, kumsnetd 270 proceso de descubrimiento de red kumsnetd 270 proceso kumstrap 270 procesos descubrimiento de red kumsnetd 270 kumstrap 270 programa de inicio KUMPAPIS para 257 Programa KUMPCON 207 programa KUMPSEND 62, 64 programa VALIDATE 227 descripcin 20 programas cliente Proveedor de datos de socket 101 programas de inicio KUMPAPIS 257 KUMPASFS 257 KUMPFILE 257 KUMPHTTP 257 KUMPODBC 257 KUMPPOST 257 KUMPSCRP 257 KUMPSNMP 257 KUMPSOCK 257 proveedor de datos 257
Proveedor consolidado de datos Vase Proveedor de datos de ASFS Proveedor de datos, nombre de instancia 38 Proveedor de datos de archivo 44 caso de configuracin de correlacin de unidad lgica 44 entrada de varios registros 45 frecuencia de muestreo 44 rutinas de extraccin de archivos especiales 45 ubicacin necesaria 44 Proveedor de datos de ASFS 11 Proveedor de datos de envo 60, 65 categoras de mensajes 61 configuracin de las especificaciones en tiempo de ejecucin 62, 63 configuracin predeterminada 60, 61 datos de envo 64 datos proporcionados por el producto 63 indicacin reconocimiento 61 personalizacin 62 variables de entorno 62 proveedor de datos de HTTP utilizacin de metarchivos 258 Proveedor de datos de HTTP 51, 55 Atributos de URL 53 inicio 51 supervisin de un URL 51 Proveedor de datos de ODBC 56, 59 aplicaciones 56 generacin de metarchivos automticamente 59 inicio 56 nombres de sistemas gestionados 56 Proveedor de datos de script 66 nombres de sistemas gestionados 70 Proveedor de datos de servidor de API descripcin 41 especificacin del host 43 especificacin del puerto de escucha 43 mandatos de consola 42 programas de llamada 42 puerto de escucha 43 Proveedor de datos de SNMP 74 caractersticas 75 ejecucin de varias instancias 39 espacio de trabajo MIBSTATUS 75 espacio de trabajo TRAP 75 inicio 74 proveedor de datos de socket modalidad COPY 112 modalidad de bloque 112 Proveedor de datos de socket 100, 104 comunicacin UDP 108 contactar 101 conversin de cdigo de caracteres 109, 110 conversin de direcciones 102 conversin de nombre y direccin 102 descripcin 100 envo del registro CLEAR-PRIOR-DATA 109 exceso de tiempo de espera 108
ndice
297
Proveedor de datos de socket (continuacin) formato de almacenamientos intermedios de socket 108 limitaciones 111 modificacin del puerto predeterminado 102 nombres de sistemas gestionados 102 reconocimiento de datos 111 varias mquinas host 102 proveedores de datos 37, 59 alteracin manual 15 Archivo 44 ASFS 11 descripcin 1 detencin 259 ejecucin de varias instancias 38 ejemplo de archivo de configuracin 24 entorno de ejecucin 257 envo 60, 65 HTTP 51, 55 inicio 257 inicio como procesos independientes 257, 260 ODBC 56, 59 programas de inicio 257 script 66 secuencia de inicio 259 servidor de API 41, 43 SNMP 74 socket 104 Socket 100 tipos 37 tipos en Tivoli Universal Agent 2 utilizacin de variables de entorno para conectar con Tivoli Universal Agent 258 Prueba de latido, nombre de instancia 38 Pswd=, parmetro 71 publicaciones acceso en lnea xviii comentarios sobre xvii en lnea xvii solicitud xvii, xviii publicaciones en lnea acceso xviii puerto UDP 1919 272 puertos no estndares recopilacin de datos 83
registro SETSOURCENAME 102 registros CLEAR-PRIOR-DATA, envo al proveedor de datos de socket 109 lectura 265 reconocimiento, incorrecto 268 SETSOURCENAME 102 registros de detalle, grupo de atributos ServerLog 160 resolucin de problemas 261 restablecimiento nmeros de versin de aplicacin 29 RKANDATV archivos CAT y almacenados como miembros de conjuntos de datos particionados 27 rutinas de extraccin de archivos Proveedor de datos de archivo 45
S
salida de script filtrado no deseado 72 script itmcmd agent start um 79 script um_cleanup 29 script um_cleanup.bat 29, 30 ejecucin en sistemas UNIX 31 ejecucin en sistemas Windows 30 parmetro directorio_instalacin en sistema Windows 30 script um_cleanup.bat en los sistemas UNIX parmetro de arquitectura 31 parmetro de componente 31 parmetro directorio_instalacin 31 parmetro nombre_TEMS 31 script um_cleanup.bat en sistema Windows 30 scripts ejecucin de um_cleanup.bat en sistemas UNIX ejecucin de um_cleanup.bat en sistemas Windows 30 itmcmd agent start um 79 limpieza 29 modalidades de ejecucin 69 tiempos de espera excedidos 71 um_cleanup 29 um_cleanup.bat 29, 30 um_cleanup.bat en sistema Windows 30 UNIX 29 Windows 29 scripts de limpieza ejecucin 29 secuenciado de definiciones de atributos 186 sentencia APPL 7, 26, 131 parmetro de texto de ayuda 132 parmetro ProductCode 132 parmetro WHEN{<valor>} 131 parmetros 131 secuencia de metarchivo 129 sintaxis 131 sentencia ATTRIBUTES 58, 164 caracteres delimitadores, parmetro cadena-delimitadora 164 notas sobre utilizacin 58
31
R
rastreo 261 recopilacin de datos detencin 82 inicio 81 MIB automtica para recursos de red descubiertos 84 recursos de red adicin y eliminacin 94 agrupamiento automtico 92 recursos de red, recopilacin automtica de datos MIB 84 registro CLEAR-PRIOR-DATA envo al proveedor de datos de socket 109
298
sentencia ATTRIBUTES (continuacin) palabra clave NEWLINE, parmetro cadena-delimitadora 165 palabra clave TAB, parmetro-cadena delimitadora 165 parmetro 0xnn, parmetro cadenadelimitadora 165 parmetro cadena-delimitadora, parmetro cadena-delimitadora 165 secuencia de metarchivo 129 sentencia CONFIRM 157 parmetro tipo_confirmacin, palabra clave message 157 parmetro tipo_confirmacin, palabra clave SEQ 157 parmetro tipo_confirmacin, palabra clave SIZE 157 parmetro tipo_confirmacin, palabra clave Xnn 157 parmetros 157 secuencia de metarchivo 129 sintaxis 157 utilizacin para especificar el reconocimiento de datos del proveedor de datos de socket 111 sentencia de control SOURCE NombreHostLocal, parmetro 44 NombreSistemaGestionado, parmetro 44 sentencia INTERNAL 150 parmetro de la sentencia INPUT 150 parmetro de sentencia OUTPUT 150 parmetros 150 secuencia de metarchivo 129 sintaxis 150 sentencia NAME 58, 134, 138 parmetro AddSourceName 135 parmetro AddTimeStamp 136 parmetro ClearValues 137 parmetro de texto de ayuda 138 parmetro de tiempo de vida (TTL) 135 parmetro Interval 136 parmetro mtodo 134 parmetro nombre-grupo-atributos 134 parmetro SkipNonNumeric 137 Proveedor de datos de ODBC 57 secuencia de metarchivo 129 sintaxis 134 sentencia proc=procedimiento almacenado, sentencia SQL 158 sentencia RECORDSET 153 mximo de registros y regla de identificacin parmetro 154 nmero_mximo_de_registros, parmetros 154 parmetro mximo de registros y regla de identificacin, palabra clave END 155 parmetro mximo de registros y regla de identificacin, palabra clave NEW 154 parmetro patrn delimitador 153 secuencia de metarchivo 129 sintaxis 153 sentencia SNMP 130 parmetros 130
sentencia SNMP (continuacin) secuencia de metarchivo 129 sintaxis 130 sentencia SOURCE 57, 59 opcin FILE, parmetro tipo 140 opcin ODBC, parmetro tipo 140 opcin SCRIPT, parmetro tipo 140 opcin SNMP, parmetro tipo 140 opcin SOCK, parmetro tipo 140 opcin TRAP, parmetro tipo 140 parmetro argumentos-script 142 parmetro Codepage= 146 parmetro Database= 145 parmetro Envfile= 146 parmetro HostAddr= 148 parmetro HostInfo= 148 parmetro intrprete-script 140 parmetro Interval= 147 parmetro Locale= 146 parmetro ManagedSystemName= 148 parmetro Maxrows= 145 parmetro mtodo-comparacin-archivos 144 parmetro modalidad-archivo 144 parmetro modalidad-archivo, opcin COPY 143 parmetro modalidad-archivo, opcin TAIL 143 parmetro modalidad-archivo, opcin TAILBYCOUNT 144 parmetro modalidad-archivo, opcin TAILBYRECORD 143 parmetro modalidad-archivo, opcin TAILRESTART 143 parmetro nmero-de-registros-archivo 144 parmetro Pswd= 145 parmetro RunOnce=Y/N 148 parmetro Runtime= 147 parmetro Server= 145 parmetro SetSourceName=Y/N 147 parmetro tipo 140 parmetro tipo-cdigo 142, 143 parmetro ubicacin 141 parmetro User= 145 parmetros 140 secuencia de metarchivo 129 sintaxis 140 SOCK, parmetro de nombre de host 103 SOCK, parmetro de nmero de puerto 104 sentencia SOURCE TRAP 79 sentencia SQL 58, 59, 158 parmetros 158 secuencia de metarchivo 129 sintaxis 158 sentencia SUMMARY 159 Ejemplo 4 162 parmetros 159 secuencia de metarchivo 129 sintaxis 159 sentencias APPL 7, 26, 129, 131 ATTRIBUTES 129, 164 CONFIRM 129, 157 control de SQL 158
ndice
299
sentencias (continuacin) control RECORDSET 153 definicin de datos 129 definiciones de atributos 169 INTERNAL 129, 150 NAME 129, 134 RECORDSET 129, 153 sintaxis de metarchivo de definicin de datos 129 SNMP 129, 130 SOURCE 129, 140 SQL 129, 158 SUMMARY 129, 159 sentencias de definicin de datos 129 sintaxis de metarchivo 129 sentencias SOURCE SOCK, parmetro de nmero de puerto 103 servidor supervisin, registro de nodos 14 servidor de supervisin registro de nodos 14 sesin de entrada, fin 109 sesin de entrada de datos, fin 109 sintaxis de filtrado de atributos 182 Sintaxis de la sentencia ATTRIBUTES 164 Sistemas de destino 82 sistemas de varias interfaces 208 sistemas gestionados cambios de versin 115 descripcin 113 distribucin de situaciones a 95 nombre 51 nombres 114 nmeros de versin 114 otras versiones 27 registro al arrancar 114 supresin 29 sistemas gestionados por Tivoli Universal Agent 113 sistemas UNIX Error de arranque Nmero de error 125 Direccin en uso 271 especificacin de parmetros de inicio 16 sistemas Windows Nmero de error 10048 271 sistemas z/OS archivos CAT y ATR almacenados como miembros de conjuntos de datos particionados en RKANDATV 27 situacin HOTLIST_offline 97 situacin MB2_egpError 96 situacin MB2_egpNeighError 97 situacin MB2_icmpError 96 situacin MB2_interfaceDown 95 situacin MB2_interfaceInError 95 situacin MB2_interfaceOutError 96 situacin MB2_ipFragmentationError 96 situacin MB2_ipInError 96 situacin MB2_ipOutError 96 situacin MB2_snmpOperationViolations 97 situacin MB2_tcpError 96 situacin MB2_udpError 96 situacin NETWORK_not_respondingsituation 97
situacin ROUTER_status_offline 97 situacin TRAP_category_errors 97 situacin TRAP_severity_errors 97 situaciones 94 acceso a la ayuda 116 creacin 94 descripcin 1, 119 descripcin, predefinida 119 distribucin 95, 120 especificacin de intervalos de supervisin para 95 establecimiento de intervalos de supervisin 121 HOTLIST_offline 97 MB2_egpError 96 MB2_egpNeighError 97 MB2_icmpError 96 MB2_interfaceDown 95 MB2_interfaceInError 95 MB2_interfaceOutError 96 MB2_ipFragmentationError 96 MB2_ipInError 96 MB2_ipOutError 96 MB2_snmpOperationViolations 97 MB2_tcpError 96 MB2_udpError 96 NETWORK_not_responding 97 ROUTER_status_offline 97 seleccin de atributos 120 SNMP predefinida 95 TRAP_category_errors 97 TRAP_severity_errors 97 utilizacin 119 situaciones proporcionadas por el producto 95 descripciones de 95 SNMP-MANAGER aplicacin 75 espacios de trabajo de aplicaciones 75 solicitud de publicaciones xvii, xviii soporte de nombres de archivo dinmicos 46, 48 SOURCE asociacin de sentencias mediante metarchivos 103 subnodos nombres 14 nombres de host 14 registro con el servidor de supervisin 14 supervisin URL https:// 55 supervisin de aplicaciones de Tivoli Universal Agent 113, 121 supervisin de las aplicaciones SNMP 80
T
TCP 101 texto de ayuda parmetro 169 parmetro, definiciones de atributos 176 parmetro, sentencia APPL 132 parmetro, sentencia NAME 138 tiempos de espera excedidos, scripts 71 tipos ASN.1 191
300
tipos de datos 191 tipos de datos de IBM Tivoli Monitoring 191 tipos de datos SMIv1 191 Tivoli, formacin tcnica xix Tivoli Enterprise Portal acceso a la ayuda para atributos y grupos de atributos 116 aplicaciones visualizada en la vista de Navigator 114 creacin de polticas 113 creacin de situaciones 113 notificacin fuera de lnea del sistema gestionado de interrupciones TCP 110 supervisin de datos de Tivoli Universal Agent 113 utilizacin para supervisar aplicaciones 113 vista Lgica de Navigator 116 vistas Fsica y Lgica de Navigator 115 visualizacin de espacios de trabajo 113 visualizacin de espacios de trabajo de aplicaciones 115 visualizacin de grupos de atributos en espacios de trabajo 115 TivoliLogTime, ejemplo de funcin de atributo derivado 181 TivoliLogTime, funcin de atributo derivado 180 TivoliTimeStamp, funcin de atributo derivado 180 TRAP espacio de trabajo 79 grupo de atributos 79 redireccin de datos 79 TRAPCNFG 225 trapd.conf, utilizacin 229 TrapDestination, parmetro 126 truncamiento 39 TTL Vase tiempo de vida
U
ubicacin del proveedor de datos de script 67 UDP 101, 109 UMC Vase Consola de mensajes universales UNIX edicin de variables de entorno 12 UTCtoGMT, funcin de atributo derivado 180 UTCtoLocalTime, funcin de atributo derivado 180
V
validacin de metarchivos 20 valor predeterminado pblico 76 valor TTL (tiempo de vida) 121 valores de depuracin 261 valores de tiempo de vida 95 valores predeterminados pblico en KUMP_SNMP_NET_COMMUNITY 77 especificacin de nombre de comunidad en KUMP_SNMP_NET_COMMUNITY 77 KUMP_SNMP_NET_COMMUNITY, variable de entorno 76
valores predeterminados (continuacin) public 76 valores predeterminados de trapcnfg categoras soportadas 232 estatus soportados 232 ID de fuente soportados 233 niveles de gravedad soportados 232 variable de entorno generada 68 variable de entorno KUMP_INIT_CONFIG_PATH, ubicacin 24 variable de entorno KUMPCNFG, ubicacin 24 variables i CTIRA_HOSTNAME, entorno 14 edicin del entorno 12 edicin del entorno en sistemas UNIX 12 entorno, determinacin de nombres de host de aplicaciones 13 entorno, secuencia de bsqueda en una bsqueda DNS 13 entorno de script 67 entorno generado 68 entorno KUMA_STARTUP_DP 12 establecimiento de la ubicacin del entorno 11 establecimiento del entorno 11 KDCB0_HOSTNAME, entorno 13 KDEB_INTERFACELIST 13 KUM_DCH_HOSTNAME, entorno 13 KUM_DP_HOSTNAME, entorno 13 KUMA_STARTUP_DP, entorno 74 KUMP_SNMP_NET_COMMUNITY, entorno 76, 77 MIB SNMP escalar 35 notacin para el entorno xx utilizacin para alterar temporalmente el nombre de host local 13 variables de entorno 94, 241 CTIRA_HOSTNAME 14 determinacin de nombres de host de aplicaciones 13 edicin 12 edicin en sistemas UNIX 12 emisor de SNMP 124 establecimiento 11 generada 68 KDCB0_HOSTNAME 13 KDEB_INTERFACELIST 13 KUM_DCH_HOSTNAME 13 KUM_DP_HOSTNAME 13 KUM_WORK_PATH 24 KUMA_DCH_PORT 259 KUMA_STARTUP_DP 11, 12, 15, 56, 74 KUMP_API_DPAPI_HOST 43 KUMP_API_DPAPI_PORT 43 KUMP_DCH_HOST 258 KUMP_DP_EVENT 44 KUMP_DP_SAMPLE_FACTOR 45 KUMP_DPCONSOLE_PORT 39 KUMP_INIT_CONFIG_PATH 24 KUMP_META_PATH 20, 25, 258 KUMP_META_SERVER 25, 26 KUMP_SNMP_AUTOSTART_MIB_ COLLECTION 84
ndice
301
variables de entorno (continuacin) KUMP_SNMP_MANAGE_LOCAL_ NETWORK=N 90 KUMP_SNMP_MONITOR_TRAP=Y 78 KUMP_SNMP_NET_COMMUNITY 76, 77 KUMP_SNMP_TRAP_PORT=nnn 78 KUMP_TCP_DISCONNECT_BY_TTL 111 KUMP_TCP_OUTAGE_WINDOW 110 KUMP_TRAP_DESTINATION 124 KUMP_TRAP_EMIT_COMMUNITY 124 KUMP_WORK_PATH 25 KUMPCNFG 24 notacin UNIX xx notacin Windows xx script 67 secuencia de bsqueda en una bsqueda DNS 13 ubicacin 11 utilizacin para alterar temporalmente el nombre de host local 13 utilizacin para conectar proveedores de datos con Tivoli Universal Agent 258 variable de entorno 35 variables de entorno de script 67 Variables de entorno del emisor de SNMP 124 variables MIB, escalares SNMP 35 variables MIB de SNMP escalares 35 variables MIB SNMP, escalares 35 varias mquinas host 102 versiones aplicaciones de Tivoli Universal Agent 27 de sistemas gestionados 114 vista Fsica de Navigator 115 Agente 116 Grupo de atributos 116 Plataforma operativa 115 Sistema 116 vista Fsica de Navigator, Agente 116 vista Fsica de Navigator, Plataforma operativa 115 vista Fsica del Navigator, Grupo de atributos 116 vista Fsica del Navigator, Sistema 116 vista Lgica de Navigator 115, 116 vistas de Navigator Fsica 115 Agente 116 Empresa 115 Grupo de atributos 116 Plataforma operativa 115 Sistema 116 Lgica 115, 116 nivel de grupo de atributos 115 visualizacin de metarchivos 34
302
Impreso en Espaa
SC11-3144-01