620 Uausers

Tivoli Universal Agent
Versin 6.2.0
Gua del usuario
SC11-3144-01
Tivoli Universal Agent
Versin 6.2.0
Gua del usuario
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
Copyright IBM Corp. 2003, 2007
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
IBM Tivoli Universal Agent: Gua del usuario
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 . . . . . . . . . . . . . . . . . . . . . . . . . .
46 49 49 50 51 51 51 51 53 56 56 56 57 57 59 60 60 61 61 61 62 62 . 63 . 64 . 64 . 64 . 66 . 66 . 67 . 67 . 67 . 69 . 70 . 70 . 71 . 71 . 71 . 72 . 74 . 74 . 74 . 75 . 76 . 77 . 78 . 78 . 80 . 100 . 101 . 102 . 102 . 102 . 102 . 103 . 108 . 108
. . . . . . . . . . . . . . . . . . . . .
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
Acerca de esta publicacin

La publicacin IBM Tivoli Universal Agent - Gua del usuario es una introduccin a Tivoli Universal Agent, un agente de IBM Tivoli Monitoring. Tivoli Universal Agent permite utilizar las caractersticas de supervisin y automatizacin de IBM Tivoli Monitoring para supervisar cualquier tipo de datos que se recopile.
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.
Biblioteca de IBM Tivoli Monitoring

Los siguientes documentos proporcionan informacin sobre el producto IBM Tivoli Monitoring: v IBM Tivoli Monitoring - Gua de instalacin y configuracin, GC11-3605-01 Proporciona informacin sobre la instalacin y configuracin de IBM Tivoli Monitoring, y sobre la actualizacin de OMEGAMON V350 o V360. v IBM Tivoli Monitoring - Gua del usuario, SC11-3111-01 Complementa la ayuda en lnea de Tivoli Enterprise Portal. La gua proporciona lecciones prcticas e instrucciones detalladas para todas las funciones de Tivoli Enterprise Portal. v IBM Tivoli Monitoring - Gua del administrador, SC11-3606-01 Describe las tareas y las funciones de soporte necesarias para el servidor de Tivoli Enterprise Portal y los clientes, incluida la administracin de usuarios de Tivoli Enterprise Portal. v Configuring IBM Tivoli Enterprise Monitoring Server on z/OS, SC32-9463 Describe cmo configurar y personalizar el servidor de Tivoli Enterprise Monitoring que se ejecuta en z/OS. v IBM Tivoli Monitoring Problem Determination Guide, GC32-9458 Proporciona informacin y mensajes para ayudar a los usuarios en la resolucin de problemas del software. v Exploracin de IBM Tivoli Monitoring, SC11-3155 Proporciona una serie de ejercicios que ayudan a los usuarios a explorar IBM Tivoli Monitoring. Despus de completar las actividades descritas en este libro de trabajo, el usuario habr instalado y configurado su entorno, habr explorado las interfaces grficas y de lnea de mandatos del producto, habr utilizado muchas de las nuevas caractersticas de este release de IBM Tivoli Monitoring (como crear un supervisor basndose en un script personalizado) y habr trabajado con varios agentes de supervisin. v IBM Tivoli Universal Agent - Gua del usuario, SC11-3144
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.
IBM Tivoli Open Process Automation Library (OPAL)

Puede encontrar informacin adicional sobre Tivoli Universal Agent y otros productos de Tivoli en el sitio web de IBM Tivoli Open Process Automation Library (OPAL), que contiene muchas soluciones de supervisin de Tivoli Universal Agent, documentos tcnicos y otras informaciones tiles para los clientes de Tivoli. La direccin web es: http://catalog.lotus.com/wps/portal/tm.
Acceso a la terminologa en lnea

El Glosario de software de Tivoli incluye definiciones de muchos de los trminos tcnicos relacionados con el software de Tivoli. El Glosario de software de Tivoli est disponible en el siguiente sitio web de la biblioteca de software de Tivoli: http://publib.boulder.ibm.com/tividd/glossary/tivoliglossarymst.htm El sitio web de terminologa de IBM consolida la terminologa de las bibliotecas de productos de IBM en una sola ubicacin conveniente. Puede acceder al sitio web de terminologa en la siguiente direccin web: http://www.ibm.com/software/globalization/terminology
Acceso a las publicaciones en lnea

El CD de documentacin contiene las publicaciones que estn en la biblioteca del producto. El formato de las publicaciones es PDF, HTML o bien ambos. Consulte el archivo readme en el CD para obtener instrucciones sobre cmo acceder a la documentacin. El CD del producto contiene las publicaciones que estn en la biblioteca del producto. El formato de las publicaciones es PDF, HTML o bien ambos. Para acceder a las publicaciones mediante un navegador web, abra el archivo infocenter.html. El archivo se encuentra en el directorio de publicaciones correspondiente en el CD del producto. IBM pone a disposicin de los usuarios los manuales correspondientes a ste y todos los dems productos de Tivoli, en cuanto estn disponibles y siempre que se actualizan, en el siguiente sitio web del centro de informacin de Tivoli: http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/index.jsp. Nota: Si imprime documentos en formato PDF en un papel que no sea de tipo carta (letter), establezca la opcin de la ventana Archivo Imprimir que permite que Adobe Reader imprima pginas de tamao carta en el tamao de papel disponible.
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.
Formacin tcnica de Tivoli

Para obtener informacin sobre la formacin tcnica de Tivoli, consulte el siguiente sitio web de formacin de IBM Tivoli: http://www.ibm.com/software/tivoli/education/
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.
Convenios empleados en esta gua

Esta gua utiliza varios convenios para trminos y acciones especiales, as como mandatos y vas de acceso que dependen del sistema operativo.
xix
Convenios de tipo de letra

En esta gua se utilizan los siguientes convenios sobre los tipos de letra: Negrita v Mandatos en minsculas y mandatos en maysculas y minsculas que de otro modo resultan difciles de distinguir del resto del texto v Controles de interfaz (recuadros de seleccin, pulsadores, botones de seleccin, selectores cclicos, campos, carpetas, iconos, recuadros de lista, elementos de recuadros de lista, listas de varias columnas, contenedores, opciones de mens, nombres de mens, separadores, hojas de propiedades), etiquetas (por ejemplo, Consejo: y Consideraciones sobre el sistema operativo:) v Palabras clave y parmetros del texto Cursiva v Palabras definidas en el texto v nfasis en palabras (por ejemplo Utilice la palabra that para introducir una clusula restrictiva). v Trminos nuevos en el texto (excepto en una lista de definiciones) v Variables y valores que el usuario deba proporcionar Monoespaciado v Cdigos y otros ejemplos v Nombres de archivos, palabras clave de programacin y otros elementos que resulten difciles de distinguir del resto del texto v Texto de mensajes y solicitudes dirigidas al usuario v Texto que el usuario deba escribir v Valores para argumentos u opciones de mandatos
Variables y vas de acceso que dependen del sistema operativo

Las publicaciones de esta biblioteca utilizan el convenio UNIX para especificar variables de entorno y para la notacin de directorios. Cuando utilice la lnea de mandatos de Windows, sustituya $variable por %variable% para las variables de entorno, y sustituya cada barra inclinada (/) por una barra inclinada invertida (\) en las vas de acceso del directorio. Los nombres de variables de entornos no son siempre los mismos en los entornos Windows y UNIX. Por ejemplo, %TEMP% en los entornos Windows es equivalente a $TMPDIR en los entornos UNIX. Nota: Si va a utilizar el shell bash en un sistema Windows, puede utilizar los convenios de UNIX.
Sintaxis de mandatos de Tivoli

Los siguientes caracteres especiales definen la sintaxis de mandatos de Tivoli: [] ... Identifica elementos opcionales. Los elementos obligatorios no se encuentran entre corchetes. Indica que se pueden especificar varios valores para el elemento anterior. Separe los distintos valores mediante un espacio, a menos que se indique lo contrario en la informacin del mandato. Si los puntos suspensivos correspondientes a un elemento van a continuacin de un corchete de cierre, utilice la sintaxis del interior de los corchetes para especificar varios valores. Por ejemplo, para especificar dos administradores para la opcin [a admin]..., utilice a admin1 a admin2. Si los puntos suspensivos correspondientes a un elemento estn dentro de los corchetes, utilice la sintaxis del ltimo elemento para especificar varios valores. Por ejemplo, para especificar dos hosts para la opcin [ h host...], utilice h host1 host2.
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
Captulo 1. Visin general de Tivoli Universal Agent

Este captulo proporciona una introduccin de alto nivel a Tivoli Universal Agent. Tambin presenta un caso simple que ilustra los pasos necesarios para implementar la supervisin con Tivoli Universal Agent utilizando el proveedor de datos de archivo. Tivoli Universal Agent es el agente genrico de IBM Tivoli Monitoring. Puede configurar Tivoli Universal Agent para supervisar cualquier dato que recopile. Puede ver los datos en espacios de trabajo actuales e histricos en Tivoli Enterprise Portal y gestionar mediante la supervisin de Tivoli Enterprise Portal situaciones y polticas de automatizacin, al igual que los datos de otros agentes de Tivoli Enterprise Monitoring. Tivoli Universal Agent ampla el rendimiento y capacidad de gestin de disponibilidad de IBM Tivoli Monitoring a aquellas aplicaciones y sistemas operativos que otros agentes de IBM Tivoli Monitoring no cubren. Proporciona un punto nico de gestin para todos los recursos de la empresa y protege la inversin en aplicaciones y recursos. Tivoli Universal Agent proporciona las siguientes caractersticas: v Integra datos de virtualmente cualquier sistema operativo y de cualquier fuente. Por ejemplo, aplicaciones personalizadas, bases de datos, sistemas, subsistemas y redes. v Supervisa slo aquellos atributos de datos que sean del inters del usuario. v Responde rpidamente a situaciones cambiantes de gestin y supervisin. v Proporciona control sobre los atributos y la exteriorizacin de los datos. Tivoli Universal Agent se puede instalar en la mayora de plataformas Windows, UNIX y Linux. Para obtener una lista completa de los sistemas operativos soportados, consulte la publicacin IBM Tivoli Monitoring - Gua de instalacin y configuracin, que puede encontrar aqu en el centro de informacin de Tivoli: http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/index.jsp?topic=/com.ibm.itm.doc/welcome.htm
Funcionamiento de Tivoli Universal Agent

Tivoli Universal Agent obtiene los datos a partir de interfaces denominadas proveedores de datos. Aunque los proveedores de datos se ejecutan como subprocesos en el interior del proceso de Tivoli Universal Agent, es til considerarlos como entidades independientes. Los proveedores de datos permiten proporcionar datos a Tivoli Universal Agent de cualquier manera que resulte conveniente o prctica para un caso de supervisin particular. Por ejemplo, puede proporcionar datos mediante un archivo secuencial, programa de sockets de TCP/IP, llamadas a la API, scripts de shell, condiciones de excepcin de SNMP o mandatos de consola. Puede crear las definiciones de datos que describan la fuente y estructura de los datos proporcionados por los proveedores de datos. Dichas definiciones de datos se almacenan en metarchivos. Los proveedores de datos transmiten los datos de supervisin y las sentencias de metarchivos a Tivoli Universal Agent, que a su vez enva los datos de supervisin al servidor de Tivoli Enterprise Monitoring (servidor de supervisin). Tivoli Universal Agent utiliza las sentencias de metarchivos para generar dinmicamente y subir archivos de definiciones de aplicaciones, que representan las definiciones que se han suministrado en el metarchivo, al servidor de supervisin y a Tivoli Enterprise Portal. Al generar dinmicamente los archivos de definicin de aplicacin, Tivoli Universal Agent permite crear soluciones personalizadas de supervisin que funcionan como si fueran agentes de IBM Tivoli Monitoring normales. Tivoli Universal Agent proporciona las siguientes caractersticas adicionales: v Supervisa e informa acerca del estado de los proveedores de datos. v Acepta y procesa las solicitudes de los proveedores de datos.
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.
API, Socket, Archivo, Script (ASFS)
Archivo
HTTP
ODBC
Envo
Script
SNMP
Socket
Figura 1. Funcionamiento de Tivoli Universal Agent
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).
Definicin de datos para Tivoli Universal Agent

Indquele a Tivoli Universal Agent qu datos desea supervisar creando una aplicacin de Tivoli Universal Agent. Una aplicacin de Tivoli Universal Agent consta de uno o ms grupos de atributos, que constan cada uno de ellos de uno o ms atributos. Defina la aplicacin en un archivo de definicin de datos llamado metarchivo, que Tivoli Universal Agent importa.
Suministro de datos a Tivoli Universal Agent

Puede proporcionar datos a Tivoli Universal Agent de cualquier manera que sea conveniente y adecuada para sus necesidades y entorno. Por ejemplo, si los datos que desea supervisar ya estn en un archivo secuencial y decide utilizar un proveedor de datos de archivo, slo necesitar crear un metarchivo que describa el diseo del archivo secuencial. Si slo desea utilizar un proveedor de datos de archivo, pero los datos no estn ya en un archivo secuencial, puede escribir un script o programa que preprocese los datos en estado puro y que los grabe como una serie de registros en un archivo secuencial que el proveedor de datos de archivo pueda supervisar utilizando un metarchivo.
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.
Trabajo con los datos

Despus de que Tivoli Universal Agent importe el metarchivo y comience a recopilar datos, puede realizar lo siguiente: Ver datos actuales e histricos bajo demanda Cuando el servidor de Tivoli Enterprise Monitoring importa los datos y las definiciones de datos, puede ver los espacios de trabajo actuales o histricos para cada grupo de atributos que defina. Puede personalizar los espacios de trabajo y exportar los datos del espacio de trabajo a otras aplicaciones para su manipulacin y presentacin. Consulte Espacios de trabajo de aplicaciones en la pgina 115 para obtener informacin adicional. Establecer alertas de sucesos Puede utilizar los atributos que defina para crear situaciones de Tivoli Enterprise Portal que alerten de problemas reales o potenciales que amenacen la disponibilidad o rendimiento de las aplicaciones y recursos. Puede incluso crear situaciones complejas que combinen situaciones de Tivoli Universal Agent con situaciones de otros agentes de Tivoli Enterprise Monitoring. Consulte Situaciones de Tivoli Universal Agent en la pgina 119 para obtener informacin adicional. Programar respuestas automticas a sucesos Puede crear polticas que respondan automticamente a sucesos crticos, ejecutando mandatos del sistema o programas de actividades complejas. Supervisar el estado de los proveedores de datos de Tivoli Enterprise Portal Tivoli Universal Agent proporciona espacios de trabajo que permiten supervisar el estado y funcionamiento de sus proveedores de datos y de las acciones automatizadas que soportan. Consulte Espacios de trabajo UAGENT en la pgina 117 para obtener informacin adicional. Puede supervisar aplicaciones en entornos no soportados, como OpenVMS o Tandem, siempre que la ejecucin de Tivoli Universal Agent no sea un requisito en dichos sistemas operativos. Por ejemplo, las soluciones SNMP no necesitan que Tivoli Universal Agent se est ejecutando en el sistema operativo donde se encuentra el agente de SNMP. Si MIB de SNMP no est disponible, entonces el script del cliente de socket de TCP/IP o el programa pueden desarrollarse en el sistema operativo para recopilar y enviar datos a travs de la red al proveedor de datos de socket.
Un caso de supervisin sencillo

Este sencillo caso ilustra los pasos necesarios para implementar la supervisin con Tivoli Universal Agent: 1. Seleccin del proveedor de datos apropiado. 2. Preparacin de la fuente de datos. 3. Definicin de la aplicacin de Tivoli Universal Agent. 4. Creacin de situaciones de supervisin y polticas utilizando los atributos de aplicacin de Tivoli Universal Agent.
Seleccin del proveedor de datos

Un usuario desea supervisar la actividad del FTP en el servidor Windows, NTSRV1. Desea adems impedir que los usuarios suban datos al servidor que consuman grandes cantidades de espacio de disco. Para poder configurar el servicio FTP de Windows para crear un archivo de registro, debe decidir que la solucin ms sencilla es utilizar el proveedor de datos de archivo.
Preparacin de la fuente de datos

El usuario configura el servicio FTP de Windows para que cree un archivo de registro, especificando su nombre y caractersticas. El usuario decide que el sistema abra cada mes, de forma automtica, un nuevo registro. Por ejemplo, el nombre de archivo de marzo de 2007 es IN0703.LOG. Como el nombre del archivo de registro se incrementa cada mes, debe decidir la caracterstica de coincidencia de patrones de nombre de archivo que se describe en Soporte de nombres de archivo dinmicos en la pgina 46. Esta caracterstica permite que la aplicacin de supervisin del registro vaya automticamente al nuevo archivo de registro que se crea cada mes, lo que ahorra el esfuerzo de actualizar la sentencia //SOURCE en el metarchivo de definicin de datos cuando el nombre del archivo de registro cambia.
Definicin de la aplicacin de Tivoli Universal Agent

El usuario define una aplicacin de supervisin del registro del FTP creando el metarchivo NTLOG.MDL como se muestra en el siguiente ejemplo:
//Appl NTLOG //NAME FTPLOGFILE E //SOURCE FILE C:\WINNT\SYSTEM32\LOGFILES\IN{####}.LOG Tail //ATTRIBUTES , ClientAddr D 32 ClientName D 32 Date D 16 Time D 16 Service D 32 ServerName D 32 ServerAddr D 32 ElapsedTime C 100000 BytesReceived C 100000 BytesSent C 100000 SrvStatusCode C 100000 NTStatusCode C 100000 OperationName D 64 ObjectName D 256 Figura 3. Ejemplo de metarchivo NTLOG.MDL
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.
Visualizacin de datos de atributos desde FTPLOGFILE

Cuando el metarchivo se haya importado y se haya comenzado a recopilar registros de archivos que se aadan a la parte inferior del archivo del mes, podr comenzar a visualizar los datos en el Navigator de Tivoli Enterprise Portal. Navigator proporciona una vista fsica de la red supervisada, organizada por sistema operativo, tipo de sistema, agentes de supervisin y de los grupos de atributos desde los que los agentes pueden recopilar informacin. Uno de los sistemas gestionados que aparece en Navigator se denomina NTSRV1:NTLOG00, que indica que la aplicacin que se ha definido en la sentencia APPL en el metarchivo. Tambin podr ver una correlacin fsica del sistema dentro del Navigator de Tivoli Enterprise Portal con el nombre NTLOG00. Consulte Sistemas gestionados por Tivoli Universal Agent en la pgina 113 y el Captulo 5, Supervisin de aplicaciones, en la pgina 113 para obtener informacin sobre la denominacin de los sistemas gestionados, espacios de trabajo personalizados y atributos. Cuando abra este elemento que representa la aplicacin, podr ver una entrada de espacio de trabajo llamada FTPLOGFILE, que representa el grupo de atributos. Pulse sobre el elemento para acceder al espacio de trabajo. Las columnas del espacio de trabajo se corresponden con los atributos que haya definido en el metarchivo. Consulte Espacios de trabajo de aplicaciones en la pgina 115 para obtener informacin acerca de los espacios de trabajo.
Creacin de una poltica de automatizacin

Ahora que ha definido los atributos del registro NT en la aplicacin de metarchivo de Tivoli Universal Agent, puede utilizar dichos atributos para crear una situacin de supervisin que se active cuando se suba un archivo de 10 MB o ms. Con el editor de situaciones de Tivoli Enterprise Portal, puede utilizar el atributo BytesReceived para crear la siguiente situacin, que distribuir a NTSRV1:
NTLFTPLOGFILE00.BytesReceived *GE 10,000,000
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.
Captulo 2. Cmo comenzar

En este captulo se describe cmo configurar Tivoli Universal Agent. Trata del tipo de proveedor de datos que se debe utilizar y cuntas instancias de Tivoli Universal Agent se deben instalar. Tambin trata de la configuracin de las variables de entorno para ajustarse a los casos de ejemplo de supervisin y proporciona instrucciones para el inicio y detencin del agente y sus proveedores de datos. Los siguientes captulos hacen referencia a la definicin de los datos en Tivoli Universal Agent creando aplicaciones y supervisando los datos en Tivoli Enterprise Portal.
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
Configuracin de Tivoli Universal Agent

La configuracin de Tivoli Universal Agent implica los siguientes pasos: v Seleccin de los tipos de proveedores de datos que desea utilizar v Decisin de cuntos Tivoli Universal Agent desea instalar v Configuracin de las variables de entorno
Seleccin de un proveedor de datos

La decisin acerca de qu tipo de proveedor de datos que se va a utilizar para supervisar los datos debe tener en cuenta las siguientes consideraciones: v el tipo de datos que desea supervisar v la ubicacin de los datos que desea supervisar
Seleccin de los datos que se desean supervisar

Si los datos estn disponibles en un archivo secuencial, en un sistema operativo soportado por Tivoli Universal Agent, el proveedor de datos de archivo ofrece la manera ms sencilla y directa de supervisar los datos. Aunque los datos no se encuentren en un archivo secuencial, puede crear un programa de extraccin para exportar los datos desde la fuente nativa a un archivo secuencial o bien modificar la aplicacin de modo que redirija los datos a un archivo secuencial y utilizar as una solucin de proveedor de datos de archivo. Si los datos no se pueden exportar fcilmente a un archivo secuencial o la fuente de datos est en un sistema operativo no soportado por Tivoli Universal Agent, puede utilizar el proveedor de datos de socket o el proveedor de datos de servidor de API. Si esta supervisando condiciones de excepcin de SNMP o el estado de recursos habilitados para SNMP, puede utilizar el proveedor de datos de SNMP.
Determinacin de la ubicacin de los datos

La posibilidad de utilizar el proveedor de datos de archivo o la eleccin entre el Servidor de la API o el proveedor de datos de socket puede depender del sistema operativo donde se encuentra la fuente de datos. El proveedor de datos de archivo debe estar en el mismo sistema operativo que el archivo que supervisa o ser capaz de correlacionar de forma lgica el archivo en una red como si ste fuera local. Aunque los
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.
Determinacin del proveedor de datos

Como las API de Tivoli Universal Agent encapsulan muchos de los detalles para tratar con los sockets TCP/IP, es ms sencillo utilizar el proveedor de datos de servidor de API que el proveedor de datos de socket. Si puede elegir entre el proveedor de datos de socket y el proveedor de datos de servidor de API, elija el proveedor de datos de servidor de API. Si los datos estn en un sistema operativo no soportado por el paquete de cliente de API como z/OS, entonces el proveedor de datos de socket es la eleccin adecuada. La siguiente tabla proporciona informacin para seleccionar el proveedor de datos:
Tabla 2. Proveedores de datos preferidos Fuente de datos Archivos de registro Notificaciones ad hoc tales como mensajes, alertas e informacin de estatus Programas internos de la aplicacin (sistema operativo del cliente de la API soportado) Programas internos de la aplicacin (sistema operativo del cliente de la API no soportado) que utilizan TCP/IP Cualquier combinacin de los siguientes: v Archivos de registro v Programas internos de la aplicacin (sistema operativo del cliente de la API soportado) v Programas internos de la aplicacin (sistema operativo del cliente de la API no soportado) v Mensajes de salida estndar producidos por un script o programa URL de Internet o intranet Bases de datos relacionales Datos MIB de SNMP Mensajes de salida estndar producidos por un script o programa HTTP ODBC SNMP Script Archivo Envo Servidor de API Socket API, Socket, Archivo, Script (ASFS) Proveedor de datos preferido
Determinacin del nmero necesario de agentes de Tivoli Universal Agent

Puede ejecutar ms de un Tivoli Universal Agent. La fuente de los datos, el tipo de proveedor de datos que va a utilizar para supervisarlos y consideraciones especficas del sitio como trfico de red y control de departamentos ayudan a determinar el nmero apropiado de instancias de Tivoli Universal Agent que se va a ejecutar. Un proveedor de datos de archivo debe iniciarse en un sistema en el que los archivos estn disponibles localmente. Por lo tanto, si desea supervisar los archivos de registro de aplicaciones en 20 sistemas
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.
Establecimiento de las variables de entorno

Tivoli Universal Agent y sus proveedores de datos soportan un nmero de variables de entorno que especifican valores para ubicaciones, puertos, directorios de trabajo y otros elementos similares. A no ser que se especifique lo contrario, los valores predeterminados de dichas variables estn ya activos. Cuando haya instalado Tivoli Universal Agent, puede alterar temporalmente los valores predeterminados de cualquiera de estas variables. Consulte el Apndice G, Referencia de variables de entorno, en la pgina 241 para obtener descripciones, valores predeterminados y ejemplos de cada variable.
Nombre y ubicacin del archivo de variables de entorno

Para cambiar los valores predeterminados de las variables de entorno, debe entrar la variable adecuada y el valor deseado en el archivo de variables de entorno. El nombre y la ubicacin del archivo de variables son diferentes en funcin del sistema operativo.
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 de variables de entorno en los sistemas operativos Windows

En los sistemas operativos Windows, puede editar las variables de entorno en el archivo KUMENV directamente utilizando un editor de texto o utilizando Manage Tivoli Enterprise Monitoring Services. Si decide utilizar un editor de texto, el archivo KUMENV est situado de forma predeterminada en el directorio IBM\ITM\TMAITM6\.
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.
Edicin de variables de entorno en los sistemas operativos UNIX

Utilice un editor de texto para establecer las variables de entorno en el archivo um.ini, que se encuentra en <dir_instalacin>/config, donde <dir_instalacin> es el directorio donde se ha instalado Tivoli Universal Agent. Nota: Deber editar el archivo um.ini, no el archivo um.config o se perdern las actualizaciones la siguiente vez que se inicie Tivoli Universal Agent. Los scripts de inicio del agente realizan sustituciones de variables y copian el contenido del archivo um.ini en el archivo um.config. Cada vez que inicie Tivoli Universal Agent en los sistemas operativos UNIX, el archivo um.config est completamente reconstruido a partir del archivo um.ini. Hay una categora especial de variables de entorno en um.ini que no debe editarse directamente. Estas variables de entorno contienen un valor de palabra clave entre dos caracteres $, por ejemplo:
KUMA_STARTUP_DP=$DATAPROVIDER$
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.
Establecimiento del directorio de trabajo

El directorio de trabajo es donde Tivoli Universal Agent busca los archivos de configuracin y donde coloca sus archivos de trabajo. En los sistemas operativos Windows se crea un directorio independiente, denominado work, y la variable KUM_WORK_PATH se preestablece para especificar
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).
Inicio de Tivoli Universal Agent y de sus proveedores de datos

En los sistemas operativos Windows, inicie Tivoli Universal Agent con Manage Tivoli Enterprise Monitoring Services. Los sistemas operativos UNIX tambin ofrecen una interfaz de lnea de mandatos mediante el script itmcmd para configurar, iniciar y detener Tivoli Universal Agent.
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.
Especificacin de proveedores de datos

Especifique cul de los siguientes proveedores de datos desea iniciar estableciendo KUMA_STARTUP_DP en uno o ms de los siguientes argumentos. ASFS Inicia el proveedor consolidado de datos APIS FILE Inicia el proveedor de datos de servidor de API Inicia el proveedor de datos de archivo
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
Especificacin de parmetros de inicio en los sistemas operativos Windows

Para cambiar manualmente los proveedores de datos listados en KUMA_STARTUP_DP, realice los siguientes pasos para especificar los parmetros de inicio en los sistemas operativos Windows: 1. Desde el botn Inicio, seleccione Programas IBM Tivoli Monitoring Manage Tivoli Monitoring Services. 2. En la ventana Manage Tivoli Enterprise Monitoring Services, pulse con el botn derecho del ratn sobre Universal Agent, y a continuacin seleccione Cambiar parmetros de inicio en el men emergente. 3. Escriba los parmetros en el campo de entrada, separados por comas, y a continuacin, pulse Aceptar.
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.
Especificacin de parmetros de inicio en los sistemas operativos UNIX

Si desea iniciar un conjunto de proveedores de datos diferente de los que estn configurados actualmente en la variable de entorno KUMA_STARTUP_DP, debe suministrar el distintivo -o como alteracin temporal manual en la lnea de mandatos. Por ejemplo, si los proveedores de datos configurados son ASFS y HTTP, pero para realizar pruebas desea iniciar nicamente los proveedores de datos de SNMP y de ARCHIVO, debe especificar el siguiente mandato:
itmcmd agent -o SNMP,FILE start um
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
Captulo 3. Creacin de una aplicacin

En este captulo se describe cmo crear una aplicacin de Tivoli Universal Agent que define los datos que desea gestionar. Trata de cmo realizar las tareas siguientes: v Construccin de un metarchivo de definicin de datos v Validacin del metarchivo v Importacin del metarchivo a Tivoli Universal Agent v Creacin de un servidor de metarchivos Este captulo tambin explica cmo se asignan nmeros de versin a los metarchivos y cmo los nmeros de versin de los metarchivos afectan a la denominacin de los sistemas gestionados, espacios de trabajo y atributos en Tivoli Enterprise Portal.
Introduccin a la aplicacin de Tivoli Universal Agent

Una aplicacin de Tivoli Universal Agent define los datos que se desean gestionar en Tivoli Universal Agent. Cada aplicacin de Tivoli Universal Agent consiste en una especificacin de definicin de datos o metarchivo, para uno o ms grupos de atributos de datos. Desde el punto de vista de Tivoli Universal Agent, una aplicacin es cualquier cosa que defina en el metarchivo. Por ejemplo, puede crear un metarchivo con un nombre de aplicacin de HOSTRESOURCES. Este metarchivo puede tener tres grupos de atributos, representando recursos de red, sistema y aplicaciones. Nota: No es necesario crear metarchivos si se est utilizando el proveedor de datos de SNMP. Tivoli Universal Agent las crea a partir de MIB estndares o de cualquier MIB que se le proporcione.
Creacin de una aplicacin de Tivoli Universal Agent

Se crea una aplicacin construyendo un metarchivo que especifique la siguiente informacin: v Nombre de la aplicacin v Nombre de cada uno de los grupos de atributos que componen la aplicacin v Fuente o fuentes de los datos en cada grupo de atributos v Nombres y caractersticas de los atributos individuales La clave para crear aplicaciones de Tivoli Universal Agent tiles es colocar los atributos relacionados en grupos y colocar los grupos de atributos relacionados en aplicaciones de Tivoli Universal Agent individuales.
Construccin de un metarchivo de definicin de datos

Un metarchivo es un archivo de texto sin formato que contiene las siguientes sentencias de control en el orden en que aparecen (si estn presentes): SNMP Slo para proveedores de datos de SNMP; introduce la definicin de datos de aplicaciones MIB de SNMP proporcionadas por Tivoli Universal Agent. SNMP TEXT introduce la definicin de datos para aplicaciones SNMP definidas por el usuario. APPL Especifica el nombre que Tivoli Universal Agent utiliza para la aplicacin. NAME Define el nombre de un grupo de atributos, el tipo de datos recopilados y el periodo durante el cual son vlidos los datos.
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
Figura 4. Creacin de un metarchivo de definicin de datos: ejemplo TCPIOQ.MDL
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.
Creacin de ayuda para aplicaciones, grupos de atributos y atributos

En el metarchivo es posible definir la ayuda para la aplicacin, cada uno de sus grupos de atributos y cada atributo en su grupo. La ayuda que se defina para cada grupo de atributos aparece en el editor de situaciones cuando seleccione un grupo de atributos. La ayuda que defina para cada atributo aparece cuando pase el ratn por encima de los encabezados de la columna de la tabla que representa cada atributo. Para el proveedor de datos de SNMP, se crear la ayuda de forma automtica a partir de las descripciones de atributos en el MIB. Consulte el ejemplo anterior para observar las descripciones de ayuda en un metarchivo y el Apndice A, Sentencias de control de definicin de datos, en la pgina 129 para obtener informacin acerca del parmetro @helptext.
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
Copia de seguridad de los metarchivos

Realice siempre copias de seguridad de sus metarchivos ya que representan una parte importante del sistema de gestin empresarial. Aunque muchos de los metarchivos son simples, algunos son tan complejos como pequeos programas si emplea las distintas caractersticas del lenguaje del metarchivo. En dichos casos, no es sencillo volver a crear un metarchivo si se ha suprimido por error. Trate los metarchivos como tratara un activo empresarial importante, realice copias de seguridad de los mismos y protjalos de cualquier alteracin o prdida, como hace con cualquier cdigo fuente de su empresa.
Validacin de las definiciones de datos

IBM Tivoli Monitoring soporta un mandato de consola llamado VALIDATE, que invoca la misma subrutina de validacin de datos que Tivoli Universal Agent utiliza durante el tiempo de ejecucin. Ejecute el mandato VALIDATE para un metarchivo recin desarrollado o modificado para poder identificar y corregir rpidamente errores sintcticos y de especificacin antes de activar el metarchivo nuevo. VALIDATE lee el metarchivo y produce mensajes de validacin detallados. Tambin crea un informe de especificacin de datos que muestra la definicin de aplicacin activa con exactitud. El informe tiene el mismo nombre de archivo que el metarchivo, con la extensin rpt. Por ejemplo, si ejecuta el programa en el metarchivo tcpioq.mdl, se crear un archivo llamado tcpioq.rpt.
20
Ejecucin del programa de validacin

Para ejecutar el programa de validacin de metarchivos, entre desde cualquier consola lo siguiente:
kumpcon validate nombre_metarchivo
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.
Ejemplo de salida de informe de validacin

El siguiente ejemplo muestra el contenido del archivo de informe que es una salida de una aplicacin llamada UXnet, definida en el metarchivo denominado TCPIOQ.MDL:
Application Name: UXnet; Definition Metafile Name: C:\IBM\ITM\TMAITM6\METAFILES\TCPIOQ.MDL Attribute Group: TCPioQ Type: Event data Total number of SOURCEs: 2 SOURCE is SOCKET UNIX1 Total Attributes: 4 Attribute delimiter is Space Character LocalApplAddress Display Type Size 24 Delimiter is Space Character TargetApplAddress Display Type Size 24 Delimiter is Space Character SendQueueSize Counter Type Size 4 Delimiter is Space Character RecvQueueSize Counter Type Size 2 Delimiter is Space Character SOURCE is SOCKET UNIX2 Total Attributes: 4 Attribute delimiter is Space Character LocalApplAddress Display Type Size 24 Delimiter is Space Character TargetApplAddress Display Type Size 24 Delimiter is Space Character SendQueueSize Counter Type Size 4 Delimiter is Space Character RecvQueueSize Counter Type Size 4 Delimiter is Space Character Total Attribute Groups: 1
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.
Activacin de metarchivos mediante mandatos de consola

Puede activar los metarchivos dinmicamente utilizando los mandatos IMPORT y REFRESH. Consulte el Apndice D, Mandatos de consola, en la pgina 207 para obtener informacin acerca de la interfaz de lnea de mandatos de Tivoli Universal Agent. Utilice este mtodo si ha creado un nuevo metarchivo y desea importarlo, o si ha modificado un metarchivo activo y desea renovarlo sin tener que reiniciar Tivoli Universal Agent. Durante el inicio Tivoli Universal Agent comprueba si existe algn metarchivo especificado en el archivo de configuracin KUMPCNFG. De ser as, Tivoli Universal Agent carga los metarchivos correspondientes a partir de los nombres de va de acceso especificados en KUMPCNFG o si no se especifican nombres calificados al completo, desde el directorio de metarchivos. Tambin puede utilizar los mandatos de
21
consola REFRESH para importar metarchivos nuevos y revisados en cualquier momento.
Figura 5. Activacin de metarchivos
Activacin de metarchivos mediante los mandatos de Actuacin

Puede activar los metarchivos dinmicamente utilizando los mandatos de Actuacin Control Import y Control Refresh. Utilice el mtodo de Actuacin si no desea reiniciar Tivoli Universal Agent despus de haber creado un nuevo metarchivo y desea importarlo, o si, despus de haber modificado un metarchivo activo, desea renovar el metarchivo. Deber tener la sesin cliente de Tivoli Enterprise Portal activa si tiene la intencin de utilizar este mtodo. El mtodo de Actuacin puede ser til si tiene problemas con la interfaz de lnea de mandatos, por ejemplo, debido a que un cortafuegos bloquea la conexin de socket entre el programa kumpcon y el servidor de consola de Tivoli Universal Agent. El mtodo de Actuacin no precisa que haya una conexin de socket con el servidor de consola. Realice los siguientes pasos para seleccionar los mandatos de Actuacin de Tivoli Universal Agent desde Tivoli Enterprise Portal: 1. Desde cualquier ubicacin en el rbol de Navigator de Tivoli Enterprise Portal debajo de Universal Agent, seleccione una hoja en el rbol de Navigator. 2. Pulse con el botn derecho del ratn sobre la hoja y seleccione Actuacin... Seleccionar.... Aparecer la ventana Actuacin.
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.
Activacin de metarchivos con un archivo de configuracin

KUMPCNFG es un archivo de texto sin formato que contiene los nombres de los metarchivos que Tivoli Universal Agent carga durante el inicio. Utilice este mtodo cuando desee que Tivoli Universal Agent cargue de forma automtica determinados metarchivos durante el arranque.
Directrices para actualizar los archivos de configuracin

Observe las siguientes directrices cuando actualice un archivo de configuracin para incluir un nuevo metarchivo: v El nombre del archivo de configuracin debe ser KUMPCNFG. En aquellos sistemas en los que los archivos son sensibles a maysculas y minsculas, el nombre estar completamente en maysculas. v Si est ejecutando una instancia alternativa de Tivoli Universal Agent, el nombre del archivo de configuracin es KUMPCNFG_&nombre de instancia. Por ejemplo, KUMPCNFG_TEST. v Puede entrar uno o ms nombres de metarchivos en un nico registro de archivo de configuracin, separados por un espacio o bien puede especificar un metarchivo por registro de archivo. Especificar un metarchivo por registro de archivo simplifica la actualizacin del archivo de configuracin. v Excepto cuando sea estrictamente necesario, utilice nicamente nombres de metarchivos sin calificar en el archivo de configuracin. v Cualquier registro de archivo de configuracin con un asterisco (*) se tratar como si fuera un comentario y ser ignorado. En la Figura 6, por ejemplo, slo los metarchivos mymeta, appl1.mdl, appl2 y CustInq.txt son cargados por Tivoli Universal Agent. v Si edita directamente KUMPCNFG, los cambios no surtirn efecto hasta el siguiente reinicio de Tivoli Universal Agent.
Ubicacin del archivo de configuracin

Tivoli Universal Agent utiliza el valor especificado por la variable de entorno KUMP_INIT_CONFIG_PATH como la ubicacin del archivo de configuracin. Si no se especifica ningn valor para KUMP_INIT_CONFIG_PATH, Tivoli Universal Agent utiliza el directorio de trabajo predeterminado, normalmente, /um/work en sistemas UNIX y \TMAITM6\work en sistemas Windows, o el directorio especificado por KUM_WORK_PATH. Consulte Establecimiento del directorio de trabajo en la pgina 12 para obtener ms detalles acerca del directorio de trabajo predeterminado y la variable KUM_WORK_PATH. Nota: La especificacin de va de acceso es sensible a maysculas y minsculas en algunos sistemas operativos.
mymeta appl1.mdl appl2 CustInq.txt *Payroll Figura 6. Ejemplo de un archivo de proveedor de datos
Compartir los archivos de configuracin

Varios Tivoli Universal Agent y subprocesos de proveedor de datos pueden compartir un archivo KUMPCNFG. El mismo archivo KUMPCNFG puede contener metarchivos del proveedor de datos de socket, metarchivos del proveedor de datos de archivo, metarchivos del proveedor de datos de SNMP, metarchivos del proveedor de datos de ODBC y metarchivos del proveedor de datos de script. Cada proveedor de datos carga los metarchivos especificados en KUMPCNFG, pero cada proveedor de datos slo comienza a supervisar los metarchivos que pertenecen a su tipo de datos definido e ignora el resto. Por ejemplo, un proveedor de datos de archivo no puede comenzar a supervisar las conexiones de socket entrantes y un proveedor de datos de servidor de API no puede generar subprocesos para los
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.
Creacin de un servidor de metarchivos

En una empresa, las mismas aplicaciones pueden ser soportadas por varios Tivoli Universal Agent en distintas ubicaciones. Para asegurar definiciones consistentes en toda la empresa y para reducir la complejidad de la gestin y mantenimiento de varios Tivoli Universal Agent, almacene los metarchivos en una nica ubicacin. Es tambin una buena prctica realizar copias de seguridad a intervalos regulares ya que representan una parte importante del sistema de gestin empresarial. El recurso de servidor de metarchivos centralizados permite designar uno o ms Tivoli Universal Agent como servidores de metarchivos. Los Tivoli Universal Agent cliente pueden recuperar los metarchivos que necesiten del servidor designado durante el tiempo de ejecucin en lugar de mantener copias locales. Por ejemplo, el departamento de ingeniera podra designar un Tivoli Universal Agent que se ejecuta en el sistema ENG1 como servidor de metarchivos. El departamento financiero selecciona el sistema FIN4 como servidor de metarchivos. Todos los Tivoli Universal Agent en el departamento de ingeniera descargan los metarchivos necesarios del Tivoli Universal Agent de ENG1, mientras que todos los Tivoli Universal Agent del departamento financiero recuperar los metarchivos necesarios del Tivoli Universal Agent en FIN4.
Designacin de un servidor de metarchivos

Utilice la variable de entorno KUMP_META_SERVER para especificar el nombre de host de Tivoli Universal Agent que desea utilizar como servidor:
KUMP_META_SERVER=nombrehost
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.
Almacenamiento de metarchivos de servidor

Debe almacenar los metarchivos del servidor en el directorio de trabajo predeterminado de Tivoli Universal Agent o en la ubicacin identificada por las variables de entorno KUMP_META_PATH o KUM_WORK_PATH. Consulte Activacin de metarchivos en la pgina 21 para obtener ms informacin acerca de KUMP_META_PATH y Establecimiento del directorio de trabajo en la pgina 12 para obtener ms informacin acerca de KUM_WORK_PATH.
Determinacin de los roles de cliente y servidor en el mismo host

Cuando Tivoli Universal Agent se inicia y descubre que KUMP_META_SERVER est configurado con el nombre de su propio host, toma la siguiente determinacin: v Si es el primer Tivoli Universal Agent inicializado en este sistema, inmediatamente asume el rol de servidor de metarchivos. v Si no es el primer Tivoli Universal Agent inicializado en este sistema, presupone que el servidor de metarchivos ya se ha iniciado y asume el rol de cliente de metarchivos, como hara cualquier Tivoli Universal Agent iniciado en cualquier parte de la empresa.
25
Sincronizacin del servidor y el cliente de metarchivos

Si Tivoli Universal Agent determina durante el arranque que la variable de entorno KUMP_META_SERVER no est establecida con el nombre de su propio host, asume el rol de cliente e inmediatamente intenta establecer una conexin de socket con el servidor de metarchivos designado. De forma predeterminada, el servidor de metarchivos permanece a la escucha de conexiones en el puerto 7800, que es un valor que se puede cambiar con la variable de entorno KUMP_META_SERVER_PORT. Si la conexin es satisfactoria, Tivoli Universal Agent configura la estructura de gestin interna necesaria y contina con el proceso de arranque. Si la conexin no es satisfactoria, ya sea por problemas de red o porque el servidor de metarchivos de Tivoli Universal Agent no se ha iniciado, el cliente de metarchivos planifica reintentos peridicos de la conexin y finaliza la inicializacin. La comunicacin entre el cliente y el servidor de metarchivos puede interrumpirse duran un funcionamiento normal por un diversas razones relacionadas con el sistema o la red. Si se interrumpen las comunicaciones, el cliente vuelva automticamente a la modalidad autnoma y planifica reintentos peridicos hasta que se restablezca la conexin con el servidor. Se emiten mensajes de registro que identifican claramente el estatus del servicio de metarchivo. Puede supervisar estos mensajes en los espacios de trabajo DPLOG. Consulte Espacios de trabajo UAGENT en la pgina 117 para obtener informacin adicional.
Alteracin temporal de la definicin central de metarchivo

Si necesita alterar temporalmente un metarchivo de definicin de datos mientras est probando la actualizacin de una aplicacin o est editando las especificaciones, haga que el nuevo metarchivo de aplicacin est disponible localmente para el cliente de Tivoli Universal Agent. Un cliente de metarchivos siempre comprueba la existencia de una copia local del metarchivo necesario antes de intentar descargarlo del servidor de metarchivos.
Interaccin con otros componentes de IBM Tivoli Monitoring

Todas las aplicaciones de IBM Tivoli Monitoring estn representadas por un archivo de catlogo, de atributo y ODI (Object Definition Interchange-Intercambio de definicin de objeto), trminos que a menudo se conocen simplemente con el nombre de archivos CAT, ATR y ODI. Otros agentes de IBM Tivoli Monitoring distribuyen estos tres archivos de definiciones como parte del paquete de instalacin. Tivoli Universal Agent es exclusivo en el sentido de que genera dinmicamente un archivo CAT, ATR y ODI para cada aplicacin de metarchivos que se active. Los archivos CAT y ATR se suben automticamente a Tivoli Enterprise Monitoring Server (servidor de supervisin) con el que Tivoli Universal Agent est configurado y el archivo ODI se sube a Tivoli Enterprise Portal Server (servidor del portal) asociado al servidor de supervisin concentrador. La subida dinmica de estos tres archivos de definiciones permite que nuevas aplicaciones de Tivoli Universal Agent inicien la supervisin, muestren los datos en Tivoli Enterprise Portal Client (cliente de portal) y creen nuevas situaciones y polticas, sin precisar que se recicle ninguno de los componentes de Tivoli Monitoring. Los nombres de archivos CAT, ATR y ODI tienen el siguiente formato, donde app representan los tres primeros caracteres del nombre de aplicacin, segn lo especificado en la sentencia //APPL del metarchivo: v appCAT00 v appATR00 v appODI00 Por ejemplo, si el metarchivo contiene la sentencia //APPL MYTEST, Tivoli Universal Agent genera y sube los archivos de definicin denominados MYTCAT00, MYTATR00 y MYTODI00. Tenga en cuenta que el servidor del portal slo recupera informacin de definicin de aplicaciones del servidor de supervisin concentrador. Por lo tanto, si Tivoli Universal Agent est configurado en un
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.
Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent

El mantenimiento de versiones de aplicaciones es una parte necesaria de Tivoli Universal Agent. No es una caracterstica opcional que se puede desactivar. El mantenimiento de versiones es necesario porque los otros componentes de Tivoli Monitoring, como el servidor de supervisin, el servidor del portal, y Data Warehouse requieren un conjunto conocido de definiciones de tabla y atributo para cada una de las aplicaciones de Tivoli Monitoring, tal como se representan con los archivos CAT, ATR y ODI. Aadiendo un sufijo de versin a cada aplicacin e incrementando el nmero de versin si se produce un cambio de metarchivo importante, Tivoli Universal Agent notifica a los dems componentes de Tivoli Monitoring de que debe utilizarse un nuevo conjunto de definiciones de tabla y atributo.
Incremento del nmero de versin y de los nmeros de modificacin

A las aplicaciones de Tivoli Universal Agent se les asignan nmeros de versin y de modificacin. Cuando se importa por primera vez un metarchivo a Tivoli Universal Agent, a la aplicacin se le asigna un nmero de versin de 0 y un nmero de modificacin de 0. Despus, a medida que cambie el metarchivo y lo renueve en Tivoli Universal Agent, se incrementar por 1 el nmero de versin de la aplicacin (cambios de mayor importancia) o el nmero de modificacin (cambios de menor importancia) dependiendo del tipo de cambios que haya realizado.
Otras versiones de los sistemas gestionados, espacios de trabajo y grupos de atributos

Tivoli Universal Agent aade el nmero de versin de la aplicacin al nombre de sistemas gestionados, las listas de sistemas gestionados y los grupos de atributos. Cuando cambia el nmero de versin de un metarchivo, los sistemas gestionados, listas de sistemas gestionados y grupos de atributos basados en el nmero de versin anterior pasan a estar fuera de lnea y los nuevos con el nuevo nmero de versin pasan a estar en lnea. Consulte la Tabla 5 en la pgina 28 y el Captulo 5, Supervisin de aplicaciones, en la pgina 113 para obtener ms informacin. El cambio del nombre del sistema gestionado significa
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
lista de sistemas gestionados *CUSTOM_UL300 grupo de atributos SYSLOG00
Cambios que no afectan al nmero de modificacin o de versin

Puede realizar los siguientes cambios sin alterar el nmero de versin de modificacin o de versin del metarchivo: v Valor de TTL v Un cambio en la sentencia SOURCE v Tipo de datos de P, S o K a cualquiera de P, S o K v Delimitador especificado en la sentencia ATTRIBUTE v Un cambio en la sentencia RECORDSET v Un cambio en la sentencia CONFIRM v Un cambio en los parmetros FILTER de atributo v Un cambio en la sentencia SQL
Cambios que afectan al nmero de modificacin (cambios de menor importancia)

Los siguientes cambios provocan que se aumente el nmero de modificacin: v Adicin de un nuevo atributo al final de la lista de atributos de un grupo de atributos v Adicin de un grupo de atributos nuevo al final del metarchivo v v v v Adicin, eliminacin o modificacin del texto de ayuda Atomizacin de un atributo existente Adicin, eliminacin o modificacin de los valores de Scale o Precision Adicin, eliminacin o modificacin del valor de Caption
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
Cambios que afectan al nmero de versin (cambios de gran importancia)

Los siguientes cambios provocan que se aumente el nmero de modificacin: v Cambio de nombre o supresin de un atributo existente v Cambio de nombre o supresin de un grupo de atributos existente v Modificacin del tipo de un atributo, por ejemplo, de una cadena a un entero v Modificacin del tamao mximo de un atributo v Adicin de un atributo nuevo en cualquier otra parte que no sea el final de un grupo de atributos existente v Modificacin de la secuencia de atributos v v v v Modificacin de un grupo de atributos de E a P, S o K Modificacin de un tipo de grupo de atributos de P, S o K a E Adicin de un nuevo grupo de atributos en cualquier parte que no sea el final del metarchivo Modificacin de un atributo de visible a oculto o viceversa; por ejemplo, de MyAttr a -MyAttr
Restablecimiento de los nmeros de versin

El restablecimiento de los nmeros de versin de las aplicaciones de Tivoli Universal Agent consta de los dos pasos bsicos siguientes: 1. Suprimir manualmente todos los sistemas gestionados de Tivoli Universal Agent 2. Ejecutar scripts de limpieza para suprimir archivos CAT, ATR y ODI generados por Tivoli Universal Agent Se proporcionan los siguientes scripts de limpieza para que se pueda restablecer el nmero de versin de las aplicaciones de nuevo a las versiones 00 originales: v Para los sistemas operativos Windows, um_cleanup.bat v Para los sistemas operativos UNIX, um_cleanup Nota: Estos scripts de limpieza eliminan todas las aplicaciones de Tivoli Universal Agent. Estos scripts no afectan a los metarchivos. La siguiente vez que se importen o se activen los metarchivos, las aplicaciones de Tivoli Universal Agent volvern a estar en lnea, pero todos los sufijos de las versiones estarn a 00. Antes de ejecutar cualquiera de estos scripts, debe concluir Tivoli Universal Agent y suprimir manualmente los sistemas gestionados de Tivoli Universal Agent del espacio de trabajo Tivoli Enterprise Portal Estatus de sistemas gestionados.
Supresin manual de los sistemas gestionados

Lleve a cabo los siguientes pasos para suprimir sistemas gestionados existentes: 1. Asegrese de que el servidor de supervisin y el servidor del portal estn en ejecucin 2. Detenga Tivoli Universal Agent de modo que todos los sistemas gestionados estn fuera de lnea. 3. Inicie la sesin en el cliente del portal. 4. Desde la vista Navigator fsico del cliente de portal, pulse con el botn derecho del ratn sobre Empresa y seleccione Espacio de trabajo Estatus de sistemas gestionados. Aparecer el espacio de trabajo Estatus de sistemas gestionados.
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.
Ejecucin del script de limpieza

Debe ejecutar el script de limpieza tres veces para suprimir todos los archivos de definicin de Tivoli Universal Agent existentes de los directorios de Universal Agent, del servidor de supervisin y del servidor de portal. Si el servidor de supervisin y el servidor del portal estn instalados en el mismo sistema que Tivoli Universal Agent, ejecute el script tres veces sucesivas en el sistema de Tivoli Universal Agent. Si el servidor de supervisin y el servidor de portal estn instalados en otros sistemas, debe (1) ejecutar por separado el script de limpieza en estos otros sistemas utilizando los parmetros de lnea de mandatos CMS y CNPS para el servidor de supervisin y el servidor del portal respectivamente, o bien (2) ejecutar los mandatos de supresin de archivo equivalentes incluidos en el script de limpieza para que se eliminen los archivos CAT, ATR y ODI apropiados. En los sistemas Windows, el archivo um_cleanup bat tiene previstos los siguientes parmetros de lnea de mandatos:
um_cleanup.bat directorio_instalacin componente [directorio_trabajo]
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.
Supresin de las consultas del espacio de trabajo

Como paso de limpieza adicional opcional, revise si debe suprimirse algunas de las consultas del espacio de trabajo generadas por el servidor del portal para las aplicaciones de Tivoli Universal Agent. Un caso donde tal vez este paso sea necesario es si inicialmente crea una aplicacin de metarchivo denominada DISKMONITOR que contiene cinco grupos de atributos. Supongamos que luego elimina dos de los grupos de atributos, que dan como resultado que se cree un nuevo sufijo de versin de aplicacin. A continuacin, decide ejecutar um_cleanup para restablecer la versin de DISKMONITOR a 00. Tras completar el proceso de limpieza, el rbol de Navigator sigue mostrando espacios de trabajos para cada uno de los cincos grupos de atributos originales, aunque el metarchivo slo contenga tres. Esta discrepancia se debe a que el servidor del portal guarda consultas del espacio de trabajo en la tabla KFWQUERY de la base de datos del servidor del portal que no se actualiza con el script um_cleanup. Por consiguiente, se sigue utilizando la versin 00 original de las consultas, que est al tanto de los cinco grupos de atributos originales, cuando se visualiza la aplicacin DISKMONITOR00. Si se da cuenta de que es necesario suprimir una o ms consultas generadas por el servidor del portal para las aplicaciones de Tivoli Universal Agent, hay un script proporcionado por Tivoli Universal Agent, denominado um_cnpsCleanup.bat, que est instalado en los sistemas Windows, que muestra cmo realizar la supresin. El script es muy corto y slo utiliza el siguiente mandato:
kfwsqlclient /d TEPS2 /e "delete from kfwquery where id like zkum.%%;"
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.%%;"
Limpieza de una nica aplicacin

Para restablecer el nmero de versin de una sola aplicacin de Universal Agent, puede realizar una serie de pasos manuales que esencialmente duplican las acciones realizadas en los scripts de limpieza. Si utiliza el ejemplo de aplicacin DISKMONITOR mencionado en el apartado anterior, Supresin de las consultas del espacio de trabajo en la pgina 31, debe realizar las acciones siguientes: 1. Suprima los archivos DISATR00, DISCAT00, DISODI00 y kumawDIS del directorio de trabajo de Universal Agent. 2. Suprima los archivos DISATR00 y DISCAT00 de los directorios ATTRLIB y RKDSCATL, respectivamente, en el servidor de supervisin. 3. Suprima el archivo DISODI00 del directorio \CNPS o /cq/data en el servidor del portal. 4. Elimine todos los sistemas gestionados Hostname:DISKMONITORnn, utilizando la opcin Borrar entrada fuera de lnea del cliente del portal. 5. Si desea suprimir todas las consultas de espacio de trabajo existentes para la aplicacin DISKMONITOR, ejecute una versin modificada del mandato kfwsqlclient, como en el siguiente ejemplo:
kfwsqlclient /d TEPS2 /e "delete from kfwquery where id like zkum.DISKMONITOR%%;"
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.
Aplicaciones SNMP de Tivoli Universal Agent

En este apartado se describen algunas de las propiedades especiales de los metarchivos SNMP de Tivoli Universal Agent. Estos metarchivos los proporciona IBM, pero se pueden modificar para crear sus propias aplicaciones SNMP personalizadas. Los siguientes detalles son exclusivos de los metarchivos SNMP: v Como norma, no debe crear metarchivos para aplicaciones MIB de SNMP de la misma manera que lo hace para aplicaciones que se utilizan con otros proveedores de datos. Debe compilar una MIB SNMP en un metarchivo de Tivoli Universal Agent mediante el programa MibUtility, que se encuentra en la pgina de IBM Tivoli Monitoring en el sitio web de Open Process Automation Library (OPAL) que se encuentra en http://catalog.lotus.com/wps/portal/tm. v Normalmente, los metarchivos de SNMP se almacenan en subdirectorios distintos debajo de \metafiles. v Determinados metarchivos SNMP ms antiguos estn cifrados; como por ejemplo, RFC1213_mib-2.mdl. Puede descifrarlos con el mandato UNPACK proporcionado por Tivoli Universal Agent. v Algunos archivos SNMP creados durante el proceso de conversin de MIB a metarchivo sirven exclusivamente para definir variables de condicin de excepcin y no se utilizan para recopilar datos de MIB. v De forma predeterminada, los metarchivos SNMP representan el contenido completo de una MIB, incluidas las sentencias de definicin de atributos para todas las variables de MIB y los OID. Pero puede crear una versin modificada de un metarchivo SNMP; por ejemplo, utilizando nicamente un subconjunto de variables MIB que, a se denominaremos aplicacin SNMP personalizada.
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.
Ubicacin de los metarchivos SNMP

En los sistemas operativos Windows, los metarchivos de un proveedor de datos no SNMP se encuentran en el siguiente directorio:
IBM\ITM\TMAITM6\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. 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 SNMP personalizados

IBM\ITM\TMAITM6\metafiles\CUSTOMIZED
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 de proveedor convertidos proporcionados por IBM Tivoli Monitoring

<dir_instalacin>/$ARQBIN/um/metafiles/SNMP/vendor
Metarchivos MIB RFC estndares de la industria convertidos proporcionados por IBM Tivoli Monitoring
<dir_instalacin>/$ARQBIN/um/metafiles/SNMP/standard
Metarchivos SNMP personalizados

<dir_instalacin>/$ARQBIN/um/metafiles/CUSTOMIZED
Metarchivos trapcnfg_*
<dir_instalacin>/$ARQBIN/um/metafiles/TRAPCNFG
Importacin de metarchivos SNMP

Utilice el mandato de consola IMPORT, el recuadro de dilogo de Actuacin Control Import o dirija la actualizacin del archivo de inicializacin KUMPCNFG para importar los metarchivos que definen las aplicaciones SNMP a Tivoli Universal Agent.
Metarchivos SNMP slo de condicin de excepcin

Determinados metarchivos SNMP se utilizan exclusivamente con el fin de que los datos de condicin de excepcin recibidos sean ms inteligibles en la columna Value_List del espacio de trabajo SNMP-MANAGER TRAP. Estos metarchivos slo de condicin de excepcin no recopilan datos de condicin de excepcin o datos MIB, y por consiguiente los espacios de trabajo siempre estn vacos. Cuando el proveedor de datos de SNMP recibe una condicin de excepcin y extrae un valor OID del paquete de condiciones de excepcin, se invoca una rutina de bsqueda para determinar si hay un metarchivo SNMP activo que defina el mismo OID. Por ejemplo, si se ha importado autosys.mdl y el OID 1.3.6.1.4.1.858.3.2.1.2.1.3 est descodificado de un paquete de condiciones de excepcin, la rutina de bsqueda determina que "alarmText en autosys.mdl tiene el OID coincidente. Por consiguiente, la columna Value_List en el espacio de trabajo SNMP-MANAGER TRAP muestra {alarmText=xxxx} en lugar de {1.3.6.1.4.1.858.3.2.1.2.1.3=xxxx}. La sustitucin del nombre de atributo del OID hace que la informacin sea ms inteligible en el espacio de trabajo TRAP, pero sta es la nica finalidad del metarchivo slo de condicin de excepcin. Los espacios de trabajo para metarchivos que son slo de condicin de excepcin no se llenan con los datos de condicin de excepcin recibidos. Los datos de condicin de excepcin slo estn en el espacio de trabajo SNMP-MANAGER TRAP (a menos que se utilice la caracterstica de redireccin de condicin de excepcin; consulte Redireccin de los datos de condicin de excepcin en la pgina 79 para obtener ms informacin al respecto.
Mantenimiento de versiones de aplicaciones

El nmero de versin de todas las aplicaciones SNMP es 00. El nmero de versin de una aplicacin y, por lo tanto, los nmeros de versin de todos los sistemas gestionados, espacios de trabajo y grupos de atributos basados en el mismo, se incrementa cada vez que se carga una definicin actualizada (metarchivo) de la aplicacin.
Visualizacin de metarchivos de aplicaciones

Los metarchivos SNMP cifrados no son legibles a menos que se procesen mediante el mandato de consola UNPACK:
kumpcon unpack nombre_metarchivo
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.
Creacin de aplicaciones SNMP personalizadas

En los metarchivos creados por IBM Tivoli Monitoring a partir de las MIB, se crea un nuevo grupo de atributos para cada nuevo grupo de variables escalares encontradas y para cada nueva tabla conceptual. No obstante, slo algunos pocos atributos en un grupo pueden resultar interesantes en una situacin de gestin de red en particular. O bien puede comprobar y correlacionar valores de atributos de distintos grupos de atributos o incluso de MIB distintos, lo cual significa que tiene que abrir varios espacios de trabajo para ver y analizar una situacin de problema. Ya que slo es posible crear situaciones que utilicen atributos del mismo grupo de atributos, si desea utilizar atributos de distintos grupos en la situacin, tendr que crear otras situaciones e incorporarlos. Puede evitar estas limitaciones construyendo sus propias aplicaciones SNMP basadas en MIB, procedentes de las que proporciona IBM Tivoli Monitoring. En estas aplicaciones personalizadas puede utilizar atributos de distintos grupos e incluso de distintas MIB. Los siguientes apartados describen los pasos necesarios para creas sus propias aplicaciones.
Paso 1: Desempaquete los metarchivos SNMP

Ejecute el mandato de consola UNPACK en cada metarchivo cifrado que contenga atributos que desee incluir en la aplicacin y examine el archivo de texto de salida. Por ejemplo, el mandato
kumpcon unpack metafiles\SNMP\standard\RFC1213_mib-2.mdl
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
Paso 3: Construya un metarchivo de aplicacin SNMP personalizado

Revise los requisitos de metarchivo, sintaxis y restricciones. Procure seleccionar un nombre exclusivo para la aplicacin. Debe hacer que los primeros tres caracteres del nombre de aplicacin sea exclusivo entre todos los Tivoli Universal Agent conectados a un servidor de Tivoli Enterprise Monitoring determinado. Agrupe los atributos seleccionados en uno o ms grupos de atributos segn sea conveniente para las situaciones de gestin propias. Recuerde que no puede utilizar atributos de distintos grupos en una nica situacin, pero puede asignar atributos a ms de un grupo de atributos. Existen dos normas para los metarchivos SNMP: v El metarchivo debe incluir //SNMP TEXT como primera sentencia. v En cada grupo de atributos, los primeros dos atributos debe ser:
Agent_Info Agent_Name D D 128 64 0.0 KEY 0.0
Consulte la Figura 7 para ver un ejemplo de un metarchivo de SNMP personalizado de ejemplo.
Paso 4: Valide el metarchivo

Ejecute el mandato de consola VALIDATE. Revise el informe de salida en busca de cualquier mensaje de aviso o error y modifique el metarchivo segn sea necesario.
Paso 5: Importe el metarchivo en Tivoli Universal Agent

Haga que metarchivo est disponible para Tivoli Universal Agent ejecutando el mandato de consola IMPORT, utilizando el recuadro de dilogo de Actuacin Control Import o incluido el nombre de metarchivo en el archivo de configuracin, KUMPCNFG, y a continuacin, reciclando Tivoli Universal Agent. En la Figura 7 se muestra un ejemplo de metarchivo de aplicacin SNMP personalizado.
//SNMP TEXT //APPL SNMPEXAMPLE //NAME TcpipNodeMonitor k 3600 //ATTRIBUTES; Agent_Info D 128 0.0 Agent_Name D 64 KEY 0.0 sysName D 255 1.3.6.1.2.1.1.5.0 sysDescr D 255 1.3.6.1.2.1.1.1.0 sysServices C 127 1.3.6.1.2.1.1.7.0 ipInReceives C 999999 1.3.6.1.2.1.4.8.0 ipInDiscards C 999999 1.3.6.1.2.1.4.9.0 ipInDelivers C 999999 1.3.6.1.2.1.4.10.0 ipInDeliverPercent (ipInDelivers %ipInReceives) ipInDiscardPercent (ipInDiscards %ipInReceives) ipInAddrErrors # 999999 1.3.6.1.2.1.7.1.0 ipOutRequests C 999999 1.3.6.1.2.1.4.10.0 ipOutDiscards C 999999 1.3.6.1.2.1.4.11.0 ipOutDiscardPercent (ipOutDiscards %ipOutRequests) udpInDatagrams ? 999999 1.3.6.1.2.1.7.1.0 udpOutDatagrams ? 999999 1.3.6.1.2.1.7.4.0 tcpActiveOpens # 999999 1.3.6.1.2.1.6.5.0 tcpPassiveOpens # 999999 1.3.6.1.2.1.6.6.0 tcpAttemptFails C 999999 1.3.6.1.2.1.6.7.0 tcpCurrEstab C 999999 1.3.6.1.2.1.6.9.0 tcpInSeqs % 999999 1.3.6.1.2.1.6.10.0 tcpOutSeqs % 999999 1.3.6.1.2.1.6.11.0 tcpRetransSeqs C 999999 1.3.6.1.2.1.6.12.0 Figura 7. Metarchivo de aplicacin SNMP personalizado
36
Captulo 4. Acerca de los proveedores de datos

Este captulo trata acerca de las caractersticas de los proveedores de datos necesarios para crear metarchivos para definir aplicaciones de Tivoli Universal Agent o para desarrollar programas para enviar datos a Tivoli Universal Agent.
Visin general de los proveedores de datos

Los proveedores de datos son las interfaces de Tivoli Universal Agent. Permiten proporcionar datos de la manera que sea ms conveniente o prctica para el caso de supervisin en cuestin. Los proveedores de datos permiten hacer lo siguiente: v Cargar y validar metarchivos de definicin de datos. v Recopilar datos desde las fuentes de datos, como archivos de registro, programas cliente, URL, scripts, tablas relacionales o agentes de SNMP. v Pasar los datos recopilados y la informacin acerca de los metarchivos de definicin de datos a Tivoli Universal Agent. Un proveedor de datos determinado puede soportar varias aplicaciones de Tivoli Universal Agent simultneamente. Aunque es til desde un punto de vista conceptual para ver los proveedores de datos como entidades independientes, se ejecutan como subprocesos dentro del proceso Tivoli Universal Agent de general. La Figura 8 ilustra la relacin entre los proveedores de datos y las fuentes de datos, metarchivos y Tivoli Universal Agent.
Tipos de proveedores de datos

Tivoli Universal Agent da soporte a los proveedores de datos de archivo, servidor de API, socket, envo, HTTP, SNMP, Script y ODBC. Este captulo describe dicho proveedores de datos y sus caractersticas.
Figura 8. Relacin entre las fuentes de datos, metarchivos y proveedores de datos
37
Ejecucin de varias instancias de un proveedor de datos

Puede ejecutar varias instancias de un tipo de proveedor de datos determinado en un nico sistema configurando o ejecutando varias instancias de Tivoli Universal Agent en dicho sistema. Para distinguir entre las diferentes instancias a medida que se registran con el servidor de supervisin, Tivoli Universal Agent aade como prefijo de un parmetro de nombre de instancia el nombre del sistema gestionado. Ejecutar varias copias de IBM Tivoli Universal Agent en un nico sistema ofrece las siguientes ventajas: v Puede ejecutar una versin de Tivoli Universal Agent de prueba y produccin en el mismo sistema. La versin de Tivoli Universal Agent de prueba se puede utilizar para verificar un nuevo mantenimiento, como verificar los cambios en las variables de entorno y los metarchivos antes de actualizarlos en la versin de Tivoli Universal Agent de prueba. v Puede crear versiones de Tivoli Universal Agent especializadas con fines de agrupamiento lgico. Por ejemplo, puede utilizar los agentes especializados para supervisar partes de la red, de una en una. v Puede equilibrar cargas de trabajo, si el volumen de los datos recopilados est sobrecargando un nico Tivoli Universal Agent. v Puede conectar varios Tivoli Universal Agent a diferentes servidores de supervisin.
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.
Creacin de instancias de Tivoli Universal Agent alternativas

En los sistemas operativos Windows, realice los pasos siguientes para crear una instancia no primaria nueva (tambin conocida con el nombre de instancia alternativa) de Tivoli Universal Agent: 1. Pulse con el botn derecho del ratn en el Universal Agent primario del recuadro de dilogo Manage Tivoli Enterprise Monitoring Services. 2. Seleccione Crear instancia. Se visualiza el recuadro de dilogo Crear instancia. 3. Escriba un nombre de instancia corto, preferentemente entre 3 y 6 caracteres, y pulse Aceptar. En los sistemas operativos UNIX, se crean instancias alternativas de Tivoli Universal Agent con el distintivo -o en el mandato itmcmd config. Por ejemplo:
itmcmd config -A -o Test um
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.
Nota sobre el truncamiento

Manage Tivoli Enterprise Monitoring Services ofrece una ventana con mens contextuales donde puede utilizar un nombre de instancia de entre 1 y 20 caracteres. No obstante, Tivoli Universal Agent limita el nombre completo de sistema gestionado (prefijo de instancia + nombre de host + nombre de aplicacin + sufijo de versin) a 32 caracteres. Para preservar la integridad del nombre de sistema gestionado, el prefijo del nombre de instancia se trunca por la izquierda. Por ejemplo, si se utiliza el nombre de instancia ABCDEFGHIJKLMNOP y el nombre de sistema gestionado resultante es de 35 caracteres, el sistema gestionado registrado aparece como:
DEFGHIJKLMNOP_nombrehost:nombreapliVV
Por lo tanto, seleccione nombres de instancia cortos para evitar el truncamiento del nombre del sistema gestionado.
Envo de mandatos de consola a una instancia alternativa

Para que una conexin de programa o consola utilice una instancia de Tivoli Universal Agent alternativa, debe especificar la variable de entorno KUMP_DPCONSOLE_PORT en el entorno del script de shell kumpcon.exe o um_console, y no en el entorno de proceso de Tivoli Universal Agent principal. Es decir, no especifique esta variable en los archivos \TMAITM6\KUMENV o /config/um.ini. Para acceder al Tivoli Universal Agent de destino correcto, utilice el espacio de trabajo UAGENT DPLOG, que proporciona los nmeros de puerto de las escuchas de socket y API, y el puerto de consola para los mandatos kumpcon. Si el nmero de puerto de la Consola del proveedor de datos ya no es visible porque se ha desplazado fuera del informe DPLOG, puede encontrar el nmero de puerto buscando "DP console port en el registro RAS1 de Tivoli Universal Agent de dicha instancia. De forma predeterminada, el Tivoli Universal Agent de destino es la copia primaria y utiliza un puerto de consola en el rango entre 7700 y 7710, en funcin de qu tipo de proveedor de datos est activo. Por ejemplo, el proveedor de datos ASFS utiliza el puerto de escucha de consola 7701 y el proveedor de datos de ODBC utiliza el 7704. Para impedir que se emitan mandatos para el Tivoli Universal Agent equivocado, cuando se accede a un Tivoli Universal Agent no primario mediante la interfaz de la consola, el indicador del proveedor de datos de destino muestra el Nombre de instancia junto a cada proveedor de datos. La interfaz de actuacin no tiene este problema de ambigedad. Cuando se distribuye una accin como URL Add o Manage Start, la lista de nombres de sistemas gestionados disponibles incluye el prefijo del nombre de la instancia.
Ejecucin de varias instancias de los proveedores de datos de SNMP

Incluso con soporte para varias instancias, no es posible ejecutar dos proveedores de datos de SNMP a pleno rendimiento en el mismo sistema. Slo un proceso puede adquirir el puerto de escucha 162 reservado para la condicin de excepcin de SNMP. Esta es una restriccin de SNMP, no una restriccin de Tivoli Universal Agent. Asumiendo que no hay otro gestor de SNMP distinto de Tivoli Universal Agent o escucha de condicin de excepcin ya activo, el primer Tivoli Universal Agent que active el proveedor de datos de SNMP adquiere el puerto 162. Cualquier Tivoli Universal Agent siguiente que active el proveedor de datos de SNMP no podr abrir el puerto de escucha de condiciones de excepcin pero podr realizar otras funciones de proveedor de datos de SNMP, como recopilar datos MIB. El no poder adquirir el puerto de escucha de condiciones de excepcin queda registrado en el registro RAS1 de Tivoli Universal Agent y en el espacio de trabajo UAGENT DPLOG del proveedor de datos de SNMP. Se produce el mismo conflicto de puertos con el puerto del direccionador predeterminado, 520, que la caracterstica de descubrimiento de red que el proveedor de datos de SNMP utiliza. En las plataformas UNIX, el error al iniciar los componentes de escucha de condiciones de excepcin y descubrimiento de la red genera los siguientes mensajes de error despus de emitir el mandato itmcmd agent start um:
Nota: El proceso de Universal Agent, kumstrap no se ha iniciado.
39
Nota: El proceso de Universal Agent, kumsnetd no se ha iniciado.
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.
Conflictos entre aplicaciones duplicadas

No ejecute la misma aplicacin en dos instancias de Tivoli Universal Agent diferentes. Mediante el uso de los archivos de configuracin con sufijos es relativamente fcil mantener un conjunto diferente de aplicaciones de Tivoli Universal Agent para las distintas versiones de Tivoli Universal Agent que ejecute. No obstante, nada le impide activa la misma aplicacin en dos Tivoli Universal Agent distintos. Por ejemplo, puede supervisar el mismo archivo de registro y los mismos URL. En algunos casos, es una prdida de tiempo y una accin poco eficaz. En otros casos, una supervisin duplicada puede causar problemas, en especial si ejecuta varias versiones de una aplicacin con el mismo nombre.
40
Proveedor de datos de servidor de API

El proveedor de datos de servidor de API (interfaz de programacin de aplicaciones) soporta las funciones de cliente de API. El proveedor de datos y las API de Tivoli Universal Agent permiten un sencillo de desarrollo de scripts y programas en C/C++ para enviar datos a Tivoli Universal Agent. Tambin soportan una interfaz de lnea de mandatos que implementa un subconjunto de las funciones de API. Consulte la publicacin IBM Tivoli Universal Agent - Gua de consulta de programacin de API y de mandatos para obtener informacin completa acerca de las API y los mandatos soportados de Tivoli Universal Agent.
Invocacin de las API

Puede invocar las API de Tivoli Universal Agent de las siguientes maneras: v Llamadas de funcin de programa Puede desarrollar o modificar los programas C/C++ que invocan las funciones de API directamente como subrutinas. v Llamadas de archivo de script Puede desarrollar o modificar archivos de script o por lotes que llamen a los programas de interfaz de lnea de mandatos de API. v Mandatos manuales Puede entrar mandatos de API directamente desde una consola del sistema. Este mtodo es particularmente til porque permite enviar datos o crear sucesos siempre que surja la necesidad. Por ejemplo, el soporte cliente puede recibir una llamada urgente de una localizacin crtica de un cliente. El representante de servicio al cliente podra entrar un mandato de API con texto adicional. El mandato provoca que una situacin fuese cierta y que se notifique al equipo de accin de guardia.
Paquete de cliente de API

El paquete de cliente de API del proveedor de datos consiste de lo siguiente: v Una biblioteca que contiene los archivos ejecutables de las funciones API v Un archivo de cabecera de C v Un conjunto de programas de interfaz de la lnea de mandatos El paquete de cliente se ha desarrollado en C y slo requiere un entorno en tiempo de ejecucin de C comn y TCP/IP con una interfaz de sockets. No crea complejidad o dependencias de programacin aadidas para el programa que realiza la llamada.
41
Figura 9. Implementacin del Proveedor de datos del servidor de API
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.
Mandatos de consola API

Los mandatos de consola API son programas de la interfaz de lnea de mandatos que llaman a las funciones API. Los mandatos utilizan la misma biblioteca en tiempo de ejecucin como funciones API C/C++ y se pueden invocar desde una ventana de mandatos en el sistema local o desde una ventana de mandatos en un sistema remoto. Los mandatos de consola API tambin se pueden integrar en un script. La publicacin IBM Tivoli Universal Agent - Gua de consulta de programacin de API y de mandatos contiene descripciones de los mandatos de consola.
42
Especificacin del host del proveedor de datos de servidor de API

La modalidad predeterminada del cliente API presupone que el proveedor de datos de servidor de API se encuentra en el mismo sistema. Si el proveedor de datos de servidor de API se ejecuta en un sistema remoto, debe establecer la variable de entorno KUMP_API_DPAPI_HOST en el nombre de host del proveedor de datos de servidor de API.
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.
Nombres de sistemas gestionados de aplicaciones del proveedor de datos de servidor de API

El nombre del sistema gestionado de una aplicacin de metarchivo de API tiene el siguiente formato: NombreHost:NombreAplicVV donde: NombreHost Host donde se est ejecutando el programa cliente de API. Nota: Si el cliente de API se est conectando desde un sistema remoto, el valor NombreHost es diferente del host donde se ejecuta el proveedor de datos de las API. NombreAplic Nombre de valor especificado en la aplicacin de metarchivo API. VV Sufijo de dos dgitos de la versin.
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
Proveedor de datos de archivo

El proveedor de datos de archivo supervisa los datos que se encuentran en un archivo de texto secuencial. El archivo supervisado no puede tener un tamao de ms de 4 GB. El proveedor de datos de archivo ofrece la manera ms simple y ms directa de utilizar Tivoli Universal Agent para supervisar los datos con IBM Tivoli Monitoring.
Ubicacin del proveedor de datos de archivo

El proveedor de datos de archivo debe estar en el mismo sistema que los archivos que el proveedor de datos de archivo supervisa o los archivos deben aparecer en el proveedor de datos como si estuvieran en el sistema local. El sistema operativo puede eliminar la naturaleza remota de un archivo del proveedor de datos en ejecucin implementando un sistema de archivos de red o correlacionando un recurso del sistema remoto con un dispositivo local. Nota: Si el proveedor de datos de archivo est supervisando un archivo en un sistema remoto mediante el uso de la correlacin de unidades lgicas, el ID de usuario y la cuenta asociadas con Tivoli Universal Agent deben tener suficiente autorizacin para abrir y leer el archivo en el sistema remoto. En algunos casos esto requiere, por ejemplo, volver a configurar el servicio Tivoli Universal Agent de Windows con una cuenta distinta de la cuenta "LocalSystem" predeterminada. El applet Servicios del Panel de control de Windows permite configurar una cuenta diferente para un servicio en particular. En este caso, puede cambiar la cuenta de Tivoli Universal Agent de "LocalSystem" a un ID de administrador autorizado en la LAN para acceder a los archivos en el sistema remoto. Tambin debe hacer referencia al nombre de archivo en el metarchivo utilizando el formato UNC (Convenio Universal de Nomenclatura) en lugar de utilizar una correlacin de letra de unidad. Y debe asegurarse de que el mismo id de usuario/cuenta configurados en el applet Servicios estn definidos en el sistema remoto donde se encuentra el archivo.
Nombres de sistemas gestionados en las aplicaciones del proveedor de datos de archivo

Si el archivo especificado en la sentencia //SOURCE FILE del metarchivo es accesible cuando se activa el metarchivo, un nombre de sistema gestionado con el siguiente formato pasa a estar en lnea:
NombreHostLocal:NombreAplicVV
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.
Frecuencia de muestreo de archivos

El proveedor de datos de archivo muestrea un archivo supervisado peridicamente en busca de nuevos registros. La frecuencia de muestreo queda determinada como se muestra a continuacin: v Para los datos de tipo de suceso, el proveedor de datos de archivo muestrea los datos cada 15 segundos o los segundos especificados por la variable de entorno KUMP_DP_EVENT.
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.
Rutinas de extraccin especiales

Muchos sistemas operativos, redes y aplicaciones mantienen informacin til en archivos adecuados para su supervisin mediante un proveedor de datos de archivo. No obstante, si los datos no estn ya en un archivo secuencial, podr crear un programa de extraccin para exportar los datos de la fuente nativa a un archivo secuencial para que el proveedor de datos de archivo tenga acceso al mismo. Por ejemplo, el registro de sucesos de Windows no puede leerse fcilmente como un archivo secuencial. No obstante, puede desarrollar un programa extractor utilizando las API de registro de sucesos de Win32 para acceder a los registros de sucesos. El programa obtiene los registros mediante las API correspondientes y, a continuacin graba los registros en un archivo secuencial supervisado por el proveedor de datos de archivo.
Entrada de varios registros

El proveedor de datos de archivo soporta la entrada de varios registros en aquellos casos en los que los registros de archivos fsicos comprendan ms de un registro fsico. Por ejemplo, los datos de los dos primeros atributos en un grupo de atributos pueden encontrarse en un registro de archivo, y los datos del tercer y cuarto atributo en un segundo registro, y los datos del quinto atributo en un tercer registro. O bien puede concatenar los datos de cinco registros y tratarlos como si fuesen un nico atributo para propsitos de supervisin. Puede definir conjuntos de registros que consistan en un nmero fijo de registros, o de un nmero variable de registros identificados por un patrn delimitador. Consulte Sentencia RECORDSET en la pgina 153 para obtener ms detalles.
Supervisin de archivos globalizados

Puede utilizar el proveedor de datos de archivo para supervisar los archivos en cualquier idioma o codificacin de caracteres. Cuando lo haga, tenga en cuenta lo siguiente: v Si el idioma y pgina de cdigos de los datos de archivo que est supervisando no estn en el idioma y pgina de cdigos predeterminado del sistema en el que Tivoli Universal Agent se est ejecutando, debe especificar los parmetros CODEPAGE y LOCALE en la sentencia del //SOURCE del metarchivo. Dichos dos parmetros le dicen al proveedor de datos de archivo qu codificacin de caracteres utilizar
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.
Soporte de nombres de archivo dinmicos

Como norma, la sentencia //SOURCE define un nombre de archivo de aplicacin fijo. No obstante, algunos programas de aplicacin crean un nombre de archivo de salida que est sujeto a cambios en funcin de criterios especficos como el da actual, el mes, el ao o un nombre de archivo que incluye un nmero de secuencia de incremento. En estos casos, especifique el siguiente patrn de nombre de archivo de supervisin en la sentencia //SOURCE en lugar del nombre de archivo real:
//SOURCE ARCHIVO espec-patrn-nombre-archivo
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.
47
{MMDDYY}.log {DDMMYYYY}.log {DDMMMYY}.log {MM-DD-YY}.log
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.
Proceso de un archivo desde el principio

En las diferentes modalidades del proceso de tail, como por ejemplo, Tail, TailByCount y TailRestart, se prev que el tamao de archivo total siga aumentando a medida que el archivo crece. No obstante, si se suprimen los registros de archivo del archivo supervisado y se reduce el tamao total de archivo, el proveedor de datos de archivo presupone que se ha vuelto a crear el archivo supervisado o se ha copiado encima de l, y por lo tanto procesa todo el archivo desde el principio. Las reglas siguientes describen cmo el proveedor de datos de archivo determina si se ha sustituido o reescrito un archivo supervisado, y debe procesarse desde el principio. v Si el contenido del primer registro de archivo ha cambiado de alguna manera, el proveedor de datos de archivo presupone que se ha vuelto a crear el archivo supervisado o se ha copiado encima de l y empieza a procesar desde el principio del archivo. v Si el archivo supervisado no existe en el momento del arranque de Tivoli Universal Agent y se crea posteriormente, el proveedor de datos de archivo procesa el archivo supervisado desde el principio. v Si se utiliza la caracterstica de nombre de archivo dinmico y se produce un cambio de nombre de archivo, el nuevo archivo supervisado se procesa desde el principio. El proveedor de datos de archivo experimenta un leve retraso al reconocer que un archivo supervisado se ha vuelto a crear o copiar. Para los datos de sucesos, el retraso es el intervalo establecido por la variable de entorno KUMP_DP_EVENT o el valor predeterminado de 15 segundos. Para aquellos datos muestreados, el retraso es el TTL dividido por el factor de muestreo definido por la variable de entorno KUMP_DP_SAMPLE_FACTOR o el factor de muestreo predeterminado de 5. Por ejemplo, puede esperar un retraso de hasta 3 minutos (180 segundos) para un archivo supervisado con un TTL de 900 segundos.
Espacio de archivo preasignado

Un programa de aplicacin puede pre-asignar un archivo con un tamao especfico y gestionar los registros de archivo en este espacio de archivo pre-asignado basndose en un algoritmo especial. El registro de Microsoft Internet Information Server es un ejemplo de este tipo de archivo. La tcnica comn de realizar tail en un archivo comprobando peridicamente la ubicacin del puntero de final de archivo en busca de registros recin aadidos resulta poco efectiva para un archivo preasignado porque el puntero de final de archivo no cambia cuando se actualiza el archivo. El tamao del archivo sigue siendo el mismo hasta que el programa de aplicacin asigna el siguiente incremento de espacio de archivo. Si va a supervisar un archivo de este tipo, especifique el parmetro tailbyrecord como en la siguiente sentencia //SOURCE:
//SOURCE FILE nombre-archivo tailbyrecord
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.
Opciones adicionales de supervisin de archivos

Para la mayora de las situaciones, es suficiente con realizar la supervisin mediante tail de los nuevos registros aadidos al final de un archivo. No obstante, si existe la necesidad de emplear otras formas de supervisin mediante tail, el proveedor de datos de archivo soporta las opciones TailRestart, TailRestartFromTop y TailByCount. Consulte Sentencia SOURCE en la pgina 140 para obtener informacin adicional acerca de estas opciones.
50
Proveedor de datos de HTTP

El Proveedor de datos de HTTP de Tivoli Universal Agent permite supervisar la disponibilidad y el tiempo de respuesta de los URL seleccionados. Puede especificar la supervisin de varios URL en el archivo de configuracin de arranque, dentro de situaciones, o mediante una opcin de Actuacin.
Inicio del proveedor de datos de HTTP

Inicie el proveedor de datos de HTTP utilizando el mismo mtodo que utiliza para iniciar otros proveedores de datos. En el siguiente ejemplo, el parmetro KUMA_STARTUP_DP inicia el proveedor de datos de HTTP.
KUMA_STARTUP_DP=HTTP
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
Nombre de sistema gestionado de la aplicacin de proveedor de datos de HTTP

Cuando la supervisin de HTTP pasa a estar activa, est representada por el siguiente nombre de sistema gestionado:
NombreHostLocal:INTERNET00
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.
Archivo de inicializacin de URL

KUMPURLS lista los URL iniciales de supervisin y debe encontrarse en el directorio WORK de instalacin del producto. Si este archivo no existe o est vaco, slo podr comenzar a supervisar URL utilizando situaciones de IBM Tivoli Monitoring o mediante Actuacin. El intervalo predeterminado de muestreo del URL es de 300 segundos para los URL definidos en este archivo. El ID de usuario predeterminado es INITCNFG. Vea el siguiente ejemplo KUMPURLS:
***************************************************** ** Lista de URL iniciales a supervisar. ** ***************************************************** www.tivoli.com https://us.etrade.com/e/t/home http://moneycentral.msn.com/investor/home.asp
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.
Situaciones de IBM Tivoli Monitoring

Es posible construir situaciones utilizando el atributo URL en la tabla INTERNET para la supervisin de cualquier URL de destino. Si el URL todava no se ha supervisado como consecuencia de su presencia en el archivo KUMPURLS, entonces se iniciar su supervisin. Si ya existe en KUMPURLS, la situacin todava es vlida pero no se crea una segunda instancia de supervisin para el URL. El nico atributo obligatorio cuando se crea una situacin para supervisar un URL es el propio nombre del URL, que debe empezar por el prefijo http:// o https://. El intervalo de situacin Test_Yahoo define la frecuencia de muestreo de supervisin del URL. Si el intervalo de situacin Test_Yahoo es menor de 60 segundos, se restablece en la tabla de URL gestionados a 60 porque ese es el intervalo de muestreo mnimo permitido para los URL. Al detener la situacin se detiene la supervisin del URL de destino en particular. De forma predeterminad, el ID de usuario asignado para el URL de destino es el nombre de situacin. No obstante, si se supervisan varios URL como resultado de situaciones de Tivoli Monitoring que se activan todas al mismo tiempo, es posible que vea los valores de ID de usuario de _Z_INT36863000 sustituidos por uno o ms de los URL iniciados por la situacin. La sustitucin de _Z_INT36863000 viene dada como resultado de la caracterstica DUPER del servidor de supervisin que optimiza la activacin de varias situaciones que tienen el mismo intervalo de muestreo. Si esta sustitucin de ID de usuario se ha producido para un URL y est intentando eliminar el URL mediante la ventana URL Remove, especifique _Z_INT36863000 en la ventana. Si no desea que se sustituya el nombre de situacin, deber inhabilitar la caracterstica DUPER del servidor de supervisin especificando la variable de entorno CMS_DUPER=N en el archivo KBBENV del servidor de supervisin.
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.
Tabla URL gestionados

La tabla URL gestionados incluye los atributos listados en la Tabla 6, que estn disponibles en situaciones de IBM Tivoli Monitoring que utilizan la supervisin de URL:
Tabla 6. Atributos de URL Nombre de atributo Tiempo promedio de respuesta Tiempo de respuesta actual Versin de HTTP Nombre_ISP Tiempo mximo de respuesta Objetos de pgina Tamao de pgina Titulo de la pgina Tipo de servidor Estatus Entero Entero Carcter Carcter Entero Entero Entero UTF-8 Carcter Carcter Tipo Tamao Largo Largo 8 64 Largo Largo Largo 256 64 64 Descripcin Tiempo medio de respuesta del URL gestionado observado en milisegundos. Tiempo actual de respuesta de un URL gestionado observado en milisegundos. Versin de HTTP (HTTP 1.0 o 1.1) del servidor web del sitio web del URL de destino. Nombre del ISP (proveedor de servicios de Internet). Tiempo mximo de respuesta del URL gestionado observado en milisegundos. Nmero total de objetos adicionales asociados con la pgina supervisada. Tamao, en bytes, de la pgina del URL recibido. Ttulo de la pgina del URL recibido. Tipo de servidor web utilizado en el sitio web del URL de destino. Estatus actual del URL gestionado (OK o descripcin del estatus).
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
Carcter Entero Entero UTF-8 UTF-8 UTF-8
32 Largo Largo 512 32 32
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.
Supervisin de los URL https://

El proveedor de datos de HTTP slo puede supervisar URL https:// seguros que no requieren el acceso con script o una solicitud interactiva. Si el URL https:// se puede recuperar con una llamada Get de HTTP estndar, entonces se podr supervisar.
Autentificacin de servidor proxy

Si el proveedor de datos de HTTP se ejecuta en un sistema que requiere la autentificacin de servidor proxy para poder acceder a los URL, debe especificar las dos siguientes variables de entorno en el archivo \tmaitm6\KUMENV o /config/um.ini:
KUMP_HTTP_PROXY_USERID=xxxxxx KUMP_HTTP_PROXY_PASSWORD=yyyyyy
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
Proveedor de datos de ODBC

ODBC (Open Database Connectivity) es una interfaz de programacin de aplicaciones estndar para acceder a los datos en fuentes de datos relacionales. El proveedor de datos de ODBC de Tivoli Universal Agent permite recopilar datos de bases de datos que se ajuste a ODBC utilizando sentencias Select de SQL y procedimientos almacenados soportados por la fuente ODBC particular que se est supervisando. El proveedor de datos de ODBC se ejecuta como un proveedor de datos independiente. Slo est disponible en los sistemas operativos Windows. La fuente de datos ODBC, tablas e informacin Select de SQL se especifica mediante parmetros y sentencias en metarchivos de Tivoli Universal Agent. Las tablas y columnas de la fuente de datos de ODBC se convierten en grupos de atributos y atributos en el metarchivo asociado. Cualquier sentencia Select de SQL o procedimiento almacenado vlido que recupere datos de columna de una o ms tablas o vistas puede especificarse en un metarchivo de ODBC. ODBC permite recopilar datos desde una fuente de datos remota sin tener que instalar ningn tipo de software adicional en el sistema remoto. El software del controlador de ODBC maneja todos los problemas de conectividad de red. Como resultado, el proveedor de datos de ODBC puede ejecutarse en un sistema al tiempo que recopila datos de forma simultnea de varios sistemas de bases de datos remotos en la red. Cualquier fuente de datos de ODBC que pueda configurarse en los sistemas operativos Windows donde se est ejecutando el proveedor de datos de ODBC puede ser supervisada.
Inicio del proveedor de datos de ODBC

El proveedor de datos de ODBC se inicia de la misma manera que otros proveedores de datos de Tivoli Universal Agent. En el siguiente ejemplo, la variable de entorno KUMA_STARTUP_DP especifica que se inicie el proveedor de datos de ODBC junto con el proveedor de datos de ASFS:KUMA_STARTUP_DP=ASFS,ODBC
Nombres de sistemas gestionados de aplicaciones del proveedor de datos de ODBC

Si la fuente de datos especificada en la sentencia //SOURCE ODBC del metarchivo es accesible cuando se activa el metarchivo, un nombre de sistema gestionado con el siguiente formato pasar a estar en lnea:
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
Metarchivos ODBC de muestra

En el ejemplo siguiente se muestran los parmetros y sentencias especficos de los metarchivos ODBC:
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
Modalidades de recopilacin de datos de tablas

Puede recopilar los datos de tablas ODBC en modalidad de intervalo o bajo demanda. El valor predeterminado es bajo demanda, lo cual significa que los datos slo se recopilan si se emite una solicitud de situacin o de informe para la tabla. Este ejemplo utiliza la recopilacin mediante intervalo, indicada por el parmetro Interval=60 en la sentencia //NAME, lo cual quiere decir que se recopilan datos para esta tabla cada 60 segundos. Si se omite el parmetro Interval=nn, la recopilacin bajo demanda se activar.
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.
Notas sobre la utilizacin

v En los metarchivos ODBC, no se utiliza el delimitador de atributo porque cada valor de columna se recupera por separado. Por lo tanto, no importa lo que se especifique como valor del delimitador en la sentencia //ATTRIBUTES. v Utilice el mandato de renovacin de Tivoli Universal Agent sin cambiar el nmero de versin de la aplicacin de metarchivo ODBC para implementar los cambios de forma dinmica en las sentencias //SOURCE y //SQL. v Aunque este ejemplo utiliza el nombre de fuente de datos de ODBC, nwind, como nombre de aplicacin en la sentencia //APPL, no es un requisito que ambos nombres coincidan.
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.
Generacin automtica de metarchivos ODBC

Para ahorrarse el esfuerzo de crear manualmente los metarchivos ODBC, es posible generar automticamente un metarchivo ODBC completo y sintcticamente correcto partiendo de un nombre de fuente de datos determinado. Consulte la descripcin del mandato GENERATE en GENERATE en la pgina 211.
59
Proveedor de datos de envo

El proveedor de datos de envo ofrece una manera conveniente de enviar notificaciones ad hoc como mensajes, alertas e informacin de estatus a IBM Tivoli Monitoring. Puede personalizar el proveedor de datos de envo para responder a una utilizacin en particular. Por ejemplo, con un mnimo de programacin adicional, una aplicacin puede utilizar un socket TCP/IP para enviar el estatus de procesado a IBM Tivoli Monitoring. Un representante de servicio al cliente puede iniciar un archivo de script de mandatos bsico y enviar mensajes de consulta a Help Desk. Los operadores del sistema pueden invocar rpidamente un mandato de consola cuando observen sucesos fuera de lo normal, de los que informarn al centro de control de la red. El proveedor de datos de envo est implementado como una aplicacin de socket TCP/IP con un metarchivo predefinido. Escucha en los puertos 7575 para los protocolos TCP y UDP o en cualquier puerto especificado por la variable de entorno KUMP_POST_DP_PORT. Cualquier problema puede abrir rpidamente un socket y enviar mensajes, alertas o estatus a un proveedor de datos de envo bajo demanda. El mtodo ms comn para entrar datos en el proveedor de datos de envo es utilizar el programa de interfaz de lnea de mandatos KUMPSEND, que se instala con Tivoli Universal Agent. KUMPSEND acepta la entrada de texto de mensajes que no estn en ingls. Tambin puede desarrollar aplicaciones Java sencillas que enven mensajes al proveedor de datos de envo.
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
Figura 10. Metarchivo de definicin de datos KUMPOST
Nombre de sistema gestionado de la aplicacin de proveedor de datos de envo

Cuando la supervisin del proveedor de datos de envo pasa a estar activa, est representada por el siguiente nombre de sistema gestionado:
NombreHostLocalPOSTdp:NombreAplicVV
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
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
Personalizacin del proveedor de datos de envo con el metarchivo KUMPOST

Como otras aplicaciones de Tivoli Universal Agent, es posible modificar la aplicacin MAS a travs de un metarchivo. No obstante, existen las siguientes restricciones para la aplicacin MAS. v El nombre del metarchivo debe ser KUMPOST. v El metarchivo debe encontrarse en el directorio KUMP_META_PATH, que suele ser el subdirectorio \metafiles estndar. v No es necesario importar el metarchivo KUMPOST personalizado ni aadirlo al archivo KUMPCNFG. La pura presencia de un archivo denominado KUMPOST en el directorio KUMP_META_PATH es suficiente para activar dicho archivo en lugar del archivo KUMPOST generado internamente por el proveedor de datos de envo. v El delimitador del atributo, si se especifica alguno, debe ser un delimitador nico. v Los tres primeros atributos deben especificarse exactamente como aparecen en la Figura 10 en la pgina 61. Sus nombres, tipos de datos, especificaciones y orden no pueden alterarse. Puede especificar un nombre de aplicacin, nombre de grupo de atributos, tipos de datos y tiempo de vida que se correspondan adecuadamente con el sitio y tambin puede definir atributos adicionales despus de los tres primeros obligatorios. No obstante, el programa KUMPSEND funciona slo con los cinco atributos predeterminados. Si define atributos adicionales deber desarrollar un programa propio para formatear y enviar los valores aadidos al proveedor de datos. Consulte El programa KUMPSEND en la pgina 64 para obtener informacin adicional.
Personalizacin de las especificaciones en tiempo de ejecucin del proveedor de datos de envo

Puede configurar un nmero de especificaciones en tiempo de ejecucin para el proveedor de datos de envo utilizando variables de entorno. La Tabla 10 lista dichas variables y proporciona descripciones de su funcin.
Tabla 10. Variables de entorno del proveedor de datos de envo Variable de entorno KUMP_POST_DP_PORT KUMP_POST_APPL_NAME KUMP_POST_GROUP_NAME Descripcin Altera temporalmente el puerto de escucha 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
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)
Esta definicin vuelve a definir la categora P desde Aplicacin hasta Programacin:

KUMP_POST_CATEGORY=(P=Programacin)
Esta definicin elimina la categora D:

KUMP_POST_CATEGORY=(D=)
Esta definicin especifica las tres definiciones anteriores en una sentencia:

KUMP_POST_CATEGORY=(X=Experimental,P=Programacin,D=)
Cualquier categora predefinida que no se redefina o elimine explcitamente permanece inalterada.
Datos suministrados por el proveedor de datos de envo

Los datos transferidos entre el programa remitente y el proveedor de datos de envo son los valores de los atributos definidos por el metarchivo KUMPOST. Los valores de los tres primeros atributos Post_Time, Post_Origin y Post_Ack_Stamp son proporcionados por el proveedor de datos de envo. Un programa necesita enviar valores slo a los atributos restantes. En el caso del metarchivo predeterminado, los nicos valores de atributo para enviar son Post_Text y Post_Category. Por ejemplo, la secuencia de datos recibida por un proveedor de datos de envo enviada por un usuario descontento al help desk podra ser el siguiente mensaje, que aparece listado como crtico:
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
Envo de datos al proveedor de datos de envo

La comunicacin entre el programa de envo y el proveedor de datos de envo es directa.
64
Utilizacin de un socket UDP

El programa de envo abre un socket UDP y enva los valores de atributo al proveedor de datos de envo. No espera una respuesta.
Utilizacin de un socket TCP

El 1. 2. 3. 4. 5. programa remitente hace lo siguiente: Abre un socket TCP y lo enlaza a cualquier puerto local. Establece una sesin TCP conectando el socket TCP al proveedor de datos de envo. Enva los valores de atributo al proveedor de datos. Espera a recibir una indicacin de reconocimiento del proveedor de datos. Cierra el socket TCP.
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
Proveedor de datos de script

El proveedor de datos de script facilita la recopilacin de datos de supervisin ejecutando un script o programa a intervalos regulares y analizando la salida del script de modo que se busquen errores, anomalas y condiciones de umbral. El proveedor de datos de script facilita la especificacin de la siguiente informacin en un metarchivo: v el nombre del script que se va a ejecutar; v el intervalo entre cada ejecucin de script; v la lista de parmetros que se va a pasar al script; v un conjunto opcional de variables de entorno que se colocar en el entorno del script antes de la ejecucin. El proveedor de datos de script es la S final en el proveedor consolidado de datos de ASFS. Si activa el proveedor de datos de ASFS, que es el valor predeterminado de la instalacin de Tivoli Universal Agent, podr importar y utilizar los metarchivos de script.
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"
Un intrprete de script no siempre es necesario, como se muestra en los siguientes ejemplos,

//SOURCE SCRIPT sh.exe "-c miscript.sh arg1 arg2" //SOURCE SCRIPT miprog.exe "arg1 arg2" //SOURCE SCRIPT miscript.sh "arg1 arg2"
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"
el script monitor.sh recibe los tres argumentos siguientes:

Arg1: aaa Arg2: bbb Arg3: 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.
Ubicacin del proveedor de datos de script

El proveedor de datos de script debe estar en el mismo sistema que los archivos que los scripts que ejecute o los scripts deben aparecer en el proveedor de datos como si residieran en el sistema local. Los scripts deben ejecutarse localmente porque el proveedor de datos de script obtiene los datos del conducto de salida estndar, que se redirige antes de que se inicie el proceso del script. No obstante, no hay nada que impide ejecutar un script en el sistema local que recopila datos de uno o ms sistemas remotos, por ejemplo, incorporando conexiones Windows Management Instrumentation (WMI) en un script para emitir consultas WMI remotas. Nota: El sistema operativo puede eliminar la caracterstica remota de un archivo implementando un sistema de archivos de red o correlacionando un recurso de sistema remoto con un dispositivo local. Si el proveedor de datos de script ejecuta un archivo de script que se encuentra en un sistema remoto mediante el uso de la correlacin de unidades lgicas, el ID de usuario y la cuenta asociadas a Tivoli Universal Agent deben tener suficiente autorizacin para abrir y leer el archivo de script en el sistema remoto. En algunos casos, eso requiere, por ejemplo, volver a configurar el servicio de Tivoli Universal Agent Windows con una cuenta distinta de la cuenta LocalSystem predeterminada. El applet Servicios del Panel de control de Windows permite configurar una cuenta diferente para un servicio en particular. En este caso, debe cambiar la cuenta de Tivoli Universal Agent de LocalSystem a un ID de administrador que est autorizado en la LAN para acceder los archivos del sistema remoto. Tambin debe hacer referencia al nombre de script en el metarchivo utilizando el formato UNC (Convenio Universal de Nomenclatura) en lugar de utilizar una correlacin de letra de unidad. Y debe asegurarse de que el mismo id de usuario/cuenta configurados en el applet Servicios estn definidos en el sistema remoto donde se encuentra el script.
Utilizacin del proveedor de datos de script

El proveedor de datos de script recibe los datos de atributo de la utilizacin que los script llamados hacen de la salida estndar. Los scripts iniciados por el proveedor de datos de script no requieren conciencia de agente universal. Ejecutan un mandato que enva datos a la salida estndar y el subproceso del proveedor de datos de script que origina la llamada lee la salida estndar gracias a haberla redirigido antes de iniciar el proceso del script. Cuando el proveedor de datos de script ha recibido un almacenamiento intermedio de salida estndar, analiza los datos en los valores de atributos como si los datos procediesen de un socket, archivo, agente de SNMP o cualquier otro mecanismo de entrada de Tivoli Universal Agent.
Variables de entorno de script

Debido que muchos scripts necesitan tener variables de entorno configuradas para ejecutarse correctamente, el proveedor de datos de script da soporta a un parmetro envfile=xxxx> en la sentencia //SOURCE SCRIPT. Este archivo envfile debe contener una serie de sentencias variable=valor, una por lnea. Deber rodear la va de acceso del archivo envfile en comillas simples si contiene espacios en
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
Y en Windows, emita este mandato:

set >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
HOSTNAME INTERP MONITOR PROBE_ARG PROBE PREV_VALUE LASTSTAMP RUNCOUNT
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.
Modalidades de ejecucin de script

El proveedor de datos de script soporta la recopilacin de datos por intervalos y bajo demanda. Si el parmetro INTERVAL=nn est presente en la sentencia //NAME del metarchivo, el script se iniciar siempre que hayan transcurrido nn nmero de segundos. Si se omite el parmetro INTERVAL, se activar la recopilacin de datos bajo demanda, lo cual quiere decir que el script no se ejecutar a no ser que se produzca un intervalo de situacin para la tabla de situacin asociada con la sentencia //SOURCE del metarchivo o que se produzca una renovacin o apertura de un espacio de trabajo de Tivoli Enterprise Portal de la tabla de aplicacin. A la hora de decidir qu modalidad de ejecucin de script es mejor para la aplicacin, un aspecto a considerar es la longitud de tiempo que el script tarda en completarse. De forma predeterminada, en una solicitud de recopilacin de datos dirigida por mandatos se permite un mximo de 15 segundos antes de que se cancele la solicitud, lo que desbloquea el espacio de trabajo de Tivoli Enterprise Portal. (Este lmite de 15 segundos se puede modificar con la variable de entorno KUMA_REPORT_REQUEST_EXPIRATION=nn). Si un script a veces requiere ms de 15 segundos por
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.
Nombres de sistemas gestionados de aplicaciones del proveedor de datos de script

Si el script especificado en la sentencia //SOURCE SCRIPT del metarchivo es accesible cuando se activa el metarchivo, un nombre de sistema gestionado con el siguiente formato pasar a estar en lnea:
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.
Manejo de errores de script

Al igual que sucede con la salida estndar, el proveedor de datos de script tambin redirige el error estndar (stderr) antes de iniciar un proceso de script. Sin embargo, el almacenamiento intermedio de errores estndar no se analiza en valores de atributo porque normalmente tiene un formato muy distinto del almacenamiento intermedio de salidas estndar. En cambio, si se captura algn error estndar durante la ejecucin del script, el proveedor de datos de script graba un mensaje KUMPL139E en UAGENT DPLOG, que contiene el nombre del script y el texto del error estndar. Si desea crear situaciones que busquen errores de script, un mtodo es definir una situacin que busque la cadena KUMPL139E en el atributo DP_Log_MsgID de la tabla DPLOG. Otra categora de error de script es cuando un script no graba ningn dato en el error estndar, pero el script sale con un cdigo de retorno no satisfactorio, que se supone que es cualquier valor que no sea 0. En este caso, el proveedor de datos de script enva un mensaje KUMPL135W UAGENT DPLOG, que contiene el nombre del script y el valor de cdigo de retorno. De nuevo, puede creare situaciones que generen alertas siempre que la tabla DPLOG tenga un mensaje KUMPL135W nuevo indicando que se ha completado un script con un cdigo de retorno distinto de cero.
Tiempos de espera excedidos de los scripts

Un tipo especial de condicin anmala es cuando un script excede el tiempo de espera antes de que finalice su ejecucin. De forma predeterminada, el proveedor de datos de script otorga a cada script un mximo de 60 segundos para finalizar. El proveedor de datos de script termina cualquier script que no
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.
Metarchivo de ejemplo de script

El siguiente es un metarchivo de ejemplo que ilustra la sintaxis del metarchivo del proveedor de datos de script:
//APPL MyAppl //NAME AttrData K 300 AddTimeStamp Interval=60 //SOURCE SCRIPT listdrives.vbs arg1 arg2 envfile=env.dat //ATTRIBUTES ; Attr1 D 128 KEY @Attr1 help text -FILTER={MATCH(0,#)} Attr2 C 2147483647 @Attr2 help text Attr3 C 2147483647 @Attr3 help text DerivedAttr (Attr2 / Attr3) @DerivedAttr help text
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:
Filtrado de salidas de scripts no deseadas

Muchos scripts envan filas de datos especiales a la salida estndar, como encabezados de columnas y frases de copyright que generalmente no desea ver en el espacio de trabajo de Tivoli Enterprise Portal. Para filtrar estas filas de datos, podr utilizar el parmetro -FILTER en el metarchivo del script, por ejemplo:
//APPL Disk //Name FreeSpace K 300 AddTimeStamp Interval=120 //Source Script cscript.exe listfreespace.vbs "/S myHost" Interval=60 //Attributes DriveLetter D 4 KEY DLM=: -FILTER={SCAN(0,Micr) OR SCAN(0,Copy)} FreeSpace D 32
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.
Atributos clave (key)

Si un script se ejecuta a intervalos regulares y genera las mismas filas de datos bsicos, el espacio de trabajo de Tivoli Enterprise Portal muestra dichas columnas acumulndose en cada intervalo de recopilacin de datos a no ser que designe uno o ms atributos como KEY (clave) en el metarchivo de script. Adicionalmente, deber marcar el grupo de atributos con una K para indicar que es una tabla KEY. Para los metarchivos de script, utilice tablas KEY para impedir que las mismas filas recuperadas se aadan varias veces siempre que se ejecute el script. Cuando el proveedor de datos de script recopila una nueva fila de datos para n grupo de atributos, comprueba si existe algn atributo KEY (clave) y si tienen los mismos valores que una fila de datos recopilados anteriormente. Si este fuese el caso, la nueva fila de datos recopilados sustituye a la fila anterior con los valores KEY correspondientes. El uso de los atributos KEY proporciona la capacidad de correlacin de datos. Para implementar un metarchivo de script con atributos KEY, primero analice la salida de un script de ejemplo para determinar si existe algn valor que pueda lgicamente tratarse como ndice o clave.
Adicin de una columna LocalTimeStamp

Incluya el parmetro AddTimeStamp en la sentencia del metarchivo del script //NAME si el script no incluye la hora en que fue ejecutado como parte de su salida estndar. Este parmetro hace que se inserte una columna LocalTimeStamp automticamente en el espacio de trabajo. El valor LocalTimeStamp lo rellena el proveedor de datos de script con la hora local cuando el script ha terminado de ejecutarse.
73
Proveedor de datos de SNMP

El proveedor de datos de SNMP proporciona la funcionalidad de la capacidad de gestin de SNMP (Protocolo simple de gestin de red) en IBM Tivoli Monitoring, permitindole integrar la gestin de red con la gestin de sistemas y de aplicaciones. Estas funciones incluyen la recepcin de condiciones de excepcin, consultas MIB, operaciones SET y supervisin de red. Mediante el proveedor de datos de SNMP, Tivoli Universal Agent puede supervisar una MIB estndar o cualquier MIB que se le proporcione. IBM Tivoli Monitoring crea aplicaciones para que convierta las MIB en metarchivos de definicin de datos. Puede entonces supervisar cualquier variable MIB como un atributo. Tambin puede crear sus propias aplicaciones SNMP personalizadas para supervisar varias tablas de atributos y varios MIB. Mediante el proveedor de datos de SNMP, Tivoli Universal Agent puede supervisar cualquier variable de la Base de informacin de gestin (MIB) de SNMP como un atributo de IBM Tivoli Monitoring. Esto permite: v Ver espacios de trabajo actuales e histricos mostrando valores para todas las variables de MIB en Tivoli Enterprise Portal. v Crear situaciones para supervisar y alertarle de condiciones de excepcin. v Crear polticas para automatizar respuestas a clientes de red. Adems, el proveedor de datos de SNMP puede: v Recopilar datos MIB de la empresa. v Supervisar cualquier condicin de excepcin de SNMP enviada al proveedor de datos. v Realizar operaciones SET de SNMP. v Gestionar y configurar dispositivos habilitados para SNMP en la empresa. v Recopilar estadsticas histricas de los dispositivos habilitados para SNMP Nota: El proveedor de datos de SNMP est limitado a la seguridad basada en el nombre de comunidad y no da soporte a SNMP Versin 3 con el modelo de seguridad ms reciente. Adems, el proveedor de datos de SNMP no da soporte a contadores de 64 bits.
Inicio del proveedor de datos de SNMP

El proveedor de datos de SNMP se inicia de la misma manera que otros proveedores de datos de Tivoli Universal Agent. En el ejemplo siguiente, la variable de entorno KUMA_STARTUP_DP especifica que se inicie el proveedor de datos de SNMP junto con los Proveedores de datos de Archivo y de HTTP:
KUMA_STARTUP_DP=FILE,HTTP,SNMP
Nombres de sistemas gestionados de las aplicaciones del proveedor de datos de SNMP

Como norma, las aplicaciones del proveedor de datos de SNMP siguen el mismo estndar de nomenclatura de sistema gestionado que otras aplicaciones de proveedores de datos.
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.
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.
Caractersticas del proveedor de datos de SNMP

El proveedor de datos de SNMP es un gestor de SNMP completo, capaz de descubrir la red, consultar a los agentes de SNMP, supervisar condiciones de excepcin de SNMP y de controlar los agentes mediante operaciones SET. Las aplicaciones de metarchivo SNMP, con una correlacin de uno a uno de variables MIB con atributos ITM, permiten gestionar y controlar los datos MIB de SNMP, como otros datos cualesquiera utilizando la capacidad de ITM estndares.
Descubrimiento y gestin de red

Una aplicacin definida por Tivoli Universal Agent, SNMP-MANAGER, permite descubrir la topologa de red TCP/IP, supervisar las condiciones de excepcin de SNMP enviadas al proveedor de datos, y gestionar y configurar los dispositivos habilitados para SNMP en la empresa.
75
Aplicaciones personalizables por el usuario

No deben crearse metarchivos para aplicaciones MIB de SNMP de la misma manera que se hace con otros proveedores de datos. IBM Software Support crea automticamente metarchivos SNMP convirtiendo las MIB en metarchivos. (Para obtener ms informacin, consulte Aplicaciones SNMP de Tivoli Universal Agent en la pgina 32). Puede importar estos metarchivos tal cual, o puede utilizarlos como base para aplicaciones SNMP personalizadas, en las que slo debe incluir los atributos MIB en los que est interesado y definir sus propias agrupaciones de atributos. Las aplicaciones SNMP personalizadas incluyen las siguientes ventajas: 1. La consolidacin de grupos de atributos para que pueda realizar un seguimiento y anlisis de los problemas desde una nica ventana de espacio de trabajo. 2. Ancho de banda de red reducido recopilando nicamente un subconjunto de variables MIB. Consulte Creacin de aplicaciones SNMP personalizadas en la pgina 35 para obtener ms informacin.
Listas de nodos gestionados personalizados (listas de favoritos)

Las listas de nodos gestionados permiten dividir la red empresarial en segmentos ms pequeos y ms sencillos de gestionar, para los cuales puede ver espacios de trabajo, crear situaciones de supervisin y establecer polticas de automatizacin.
Especificacin de un nombre de comunidad flexible

El proveedor de datos de SNMP acomoda las variantes en los nombres de comunidad con una tabla de nombre de comunidad que se puede modificar dinmicamente.
Soporte de nombres simblicos

Con su tabla de nombres simblicos, el proveedor de datos de SNMP permite utilizar nombres ms familiares en lugar de direcciones de red.
Especificacin de nombres de comunidad

El proveedor de datos de SNMP realiza dos operaciones que requieren nombres de comunidad: v Descubrimiento de red v Recopilacin de datos de MIB El proveedor de datos permite una flexibilidad considerable sobre cmo especificar los nombres de comunidad para dichas operaciones. El mtodo ms sencillo de especificar nombres de comunidad son: v Si desea utilizar el valor predeterminado, pero el valor predeterminado no es pblico, utilice la variable de entorno KUMP_SNMP_NET_COMMUNITY para especificar el nombre que desea utilizar como valor predeterminado. v Si debe utilizarse un nombre de comunidad especfico para una direccin de red en particular, especifique dicho nombre en el archivo KUMSCOMM.
Resolucin de nombres de comunidades

Durante el descubrimiento de red, el proveedor de datos de SNMP intenta recopilar datos MIB-2 (RFC1213) de los dispositivos. Si no se indica nombre de comunidad alguno en el archivo KUMSCOMM de un host o dispositivo determinado, el proveedor de datos utilizar el valor predeterminado especificado por KUMP_SNMP_NET_COMMUNITY. Si no se especifica un valor predeterminado, se utilizar el valor pblico predeterminado. Durante la recopilacin de datos de MIB, el proveedor de datos resuelve el nombre de comunidad en el siguiente orden: v Si se especifica un nombre de comunidad en el campo & para la operacin Actuacin Monitor Start, se utiliza el nombre especificado. Consulte Nombres de sistemas gestionados de las aplicaciones del proveedor de datos de SNMP en la pgina 74 para obtener ms informacin. v Si no se especifica ningn nombre de comunidad para &, pero se especifica un nombre en el archivo KUMSCOMM para el host en particular, se utilizar dicho nombre.
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.
Especificacin de un nombre de comunidad predeterminado

Para especificar un nombre de comunidad predeterminado distinto para el proveedor de datos de SNMP, establezca la variable de entorno KUMP_SNMP_NET_COMMUNITY con el nombre preferido:
KUMP_SNMP_NET_COMMUNITY=nombre_predeterminado
Especifique el nombre de comunidad exactamente como se ha asignado ya que es sensible a maysculas y minsculas.
Especificacin de nombres de comunidad no predeterminados

La tabla de nombres de comunidad se almacena en un archivo de texto denominado KUMSCOMM, que se encuentra en el directorio de trabajo de Tivoli Universal Agent. En este archivo, liste todos los recursos de red que desea gestionar que no acepten el nombre de comunidad junto con el nombre que s aceptan. El formato de las entradas es:
nombre_agente/direccin nombre_comunidad
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
Este mandato tambin est disponible desde la interfaz de Actuacin.
Asignacin de nombres de red simblicos

El proveedor de datos de SNMP permite referirse a las redes utilizando sus nombres simblicos. El proveedor de datos soporta nombres simblicos mediante la informacin que se guarda en un archivo llamado KUMSNAME. Despus de haber definido los nombres simblicos, se utilizarn para referirse a las redes en todos los espacios de trabajos, y podr utilizarlos siempre que sea necesario especificar el nombre o direccin de red.
Edicin del archivo de nombres simblicos

El archivo KUMSNAME se encuentra en el directorio de trabajo de Tivoli Universal Agent. Para especificar nombres simblicos para la red, creando una lista de direcciones de red IP decimales separadas por puntos, seguidas de sus nombres simblicos:
10.10.18.0 LA-TEST 198.210.36.0 Chicago-DEV 10.10.32.0 Chicago-FIN
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
Activacin del archivo

El proveedor de datos de SNMP lee el archivo de nombres simblicos durante el arranque. No obstante, puede aadir, suprimir o modificar entradas en cualquier momento y activar el archivo editado utilizando el mandato de consola LOADNAME:
KUMPCON LOADNAME
Este mandato tambin est disponible desde la interfaz de Actuacin.
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.
Envo de condiciones de excepcin de SNMP al proveedor de datos

El espacio de trabajo de SNMP-MANAGER TRAP contiene informacin acerca de las condiciones de excepcin recibidas por el proveedor de datos. Deber configurar los agentes SNMP para que enven las condiciones de excepcin al nombre de host en el que se est ejecutando el proveedor de datos de SNMP de Tivoli Universal Agent para recibir datos en este espacio de trabajo. Cuando se estn recopilando los datos de condiciones de excepcin, puede definir situaciones contra la tabla SNMP-MANAGER TRAP y especificar acciones reflejas y otras formas de automatizacin en respuesta a dichas alertas recibidas. El proveedor de datos de SNMP puede recibir tanto condiciones de excepcin de SNMPv1 como SNMPv2. Sin embargo, convierte las condiciones de excepcin de SNMPv2 al formato SNMPv1 antes de enviarlas para realizar otros procesos.
Archivo de configuracin de condiciones de excepcin

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. De forma predeterminad, el archivo trapcnfg se encuentra en el directorio de trabajo de Tivoli Universal Agent. 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.
Recepcin de condiciones de excepcin

Hay tres requisitos esenciales para que el proveedor de datos de SNMP pueda recibir condiciones de excepcin: 1. La variable de entorno KUMP_SNMP_MONITOR_TRAP=Y debe estar especificada. Observe que ste es el valor predeterminado. 2. El puerto de escucha de condiciones de excepcin debe asignarse correctamente durante el arranque. De forma predeterminada, el nmero de puerto de escucha es 162, pero el valor se puede alterar temporalmente con la variable de entorno KUMP_SNMP_TRAP_PORT=nnn.
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.
Diferencias en la recepcin de condiciones de excepcin entre los sistemas UNIX y Windows

La recepcin de condiciones de excepcin funciona de un modo un poco distinto en los sistemas UNIX y en Windows. En los sistemas Windows, el receptor de condiciones de excepcin se ejecuta como un subproceso dentro del proceso principal de Universal Agent, mientras que en los sistemas UNIX hay un proceso receptor de condiciones de excepcin distinto que se denomina kumstrap, y consta de un pequeo programa autnomo que asigna el puerto de escucha de condiciones de excepcin y, a continuacin, espera a recibir condiciones de excepcin. La lgica del proveedor de datos de SNMP que se ejecuta dentro de Universal Agent se registra ella misma como una parte interesada en kumstrap, por lo que siempre que kumstrap recibe una nueva condicin de excepcin, la reenva al proveedor de datos de SNMP para la descodificacin de condiciones de excepcin, bsqueda de archivos trapcfng y actualizacin de espacios de trabajo TRAP. La funcin de recepcin de condiciones de excepcin se ha desplazado a un proceso separado en los sistemas UNIX para evitar la necesidad de iniciar siempre el proveedor de datos de SNMP con autorizacin de usuario root. Como el puerto 162 es un puerto cuyo nmero es bajo, slo un proceso de nivel root puede asignarlo. Durante la instalacin de Tivoli Universal Agent en los sistemas UNIX, el script SetPerm concede al archivo binario kumstrap permiso Set-User-ID. Este permiso permite que un ID de usuario no root inicie Tivoli Universal Agent en los sistemas UNIX, con el proveedor de datos de SNMP activado y el proceso kumstrap todava puede tener autorizacin a nivel root para asignar el puerto 162 y la escucha de condiciones de excepcin entrantes. No es necesario emitir un mandato de inicio por separado para el proceso kumstrap. Cuando se ejecuta el mandato ./itmcmd agent start um y el proveedor de datos de SNMP es uno de los proveedores de datos configurados, el script itmcmd inicia automticamente el proceso kumstrap junto con el proceso kuma620 principal. Si el proceso kumstrap no se inicia correctamente, el proveedor de datos de SNMP no puede recibir condiciones de excepcin y se visualiza el siguiente mensaje despus de emitir el mandato ./itmcmd agent start um:
"Nota: El proceso de Universal Agent, kumstrap no se ha iniciado."
Redireccin de los datos de condicin de excepcin

De forma predeterminada, las condiciones de excepcin recibidas slo se incluyen en la tabla TRAP y el espacio de trabajo que forma parte de la aplicacin SNMP-MANAGER de Universal Agent. Si necesita realizar ms procesos en las condiciones de excepcin recibidas, por ejemplo, para analizar campos individuales fuera de la columna Value_List, puede definir un grupo de atributos de condicin de excepcin especial en cualquier metarchivo SNMP. Cada vez que se recibe una condicin de excepcin, el proveedor de datos de SNMP explora a ver si existen aplicaciones de metarchivo que tengan un grupo de atributos y, si es as, redirige una copia de la condicin de excepcin al grupo de atributos. El grupo de atributos de condicin de excepcin requiere una sentencia //SOURCE TRAP para habilitar la caracterstica de redireccin de condicin de excepcin, tal como se muestra en el siguiente metarchivo SNMP simple:
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=}
Supervisin de las aplicaciones SNMP

Este apartado describe cmo supervisar los datos de SNMP utilizando Tivoli Enterprise Portal. Tivoli Enterprise Portal presenta un conjunto de espacios de trabajo para cada aplicacin MIB de SNMP que supervise. Cada espacio de trabajo se corresponde con un grupo de atributos definidos en el metarchivo
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.
Inicio de la recopilacin de datos MIB

Para que los espacios de trabajo MIB muestren datos y para que las situaciones evalen los datos, primero debe importar el metarchivo de SNMP. A continuacin, puede iniciar la recopilacin de datos MIB indicando al proveedor de datos de SNMP del que los agentes SNMP recopilan datos, qu nombres de comunidad deben utilizar y con qu frecuencia se deben muestrear datos. Para ello, utilice la opcin Monitor Start de la caracterstica Actuacin en el cliente de Tivoli Enterprise Portal. Inicio de la recopilacin de datos: Utilice los siguientes pasos para utilizar la caracterstica de Actuacin para iniciar la recopilacin de datos MIB: 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 Start en la lista Nombre. Aparecer la ventana Editar valores de argumentos. 5. En la ventana Editar valores de argumentos: v Para AgentData, especifique los nombres de host o direcciones decimales separadas por puntos de los agentes SNMP que desea supervisar y, opcionalmente, el nombre de comunidad. Si no especifica un nombre de comunidad, se utilizar el valor predeterminado. Consulte Especificacin de nombres de comunidad en la pgina 76 para obtener informacin acerca de la especificacin de nombres de comunidad. Si especifica un nombre de comunidad, rodee el par de nombre de host o la direccin IP y el nombre de comunidad de llaves. Por ejemplo:
Mars, Venus, {Jupiter viewx}, Pluto, {198.210.57.37 co98x}
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
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.
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.
Espacios de trabajo de la aplicacin SNMP-MANAGER

La aplicacin SNMP-MANAGER proporciona siete espacios de trabajo que presentan informacin acerca de las redes, condiciones de excepcin de SNMP recibidas y atributos para los cuales se estn recopilando datos en la actualidad, cualquier dispositivo identificado en una lista de favoritos, y todos los agentes de Tivoli Enterprise Monitoring en la empresa: v MANAGED-NODES v MIBNODATA v MIBSTATUS v NETSUMMARY v NETWORK v ROUTER v TRAP Los siguientes apartados proporcionan descripciones acerca de dichos espacios de trabajo. Consulte Utilizacin de listas de nodos gestionados (listas de favoritos) en la pgina 91 para obtener ms informacin acerca de las listas de favoritos. Consulte el Apndice C, Atributos de SNMP, en la pgina 191 para obtener descripciones completas de los atributos de SNMP-MANAGER. Acceso a los espacios de trabajo de SNMP-MANAGER: Para acceder a los espacios de trabajo de SNMP-MANAGER: 1. Efecte una doble pulsacin sobre el elemento SNMP-MANAGER en la vista Fsica de rbol de navegacin.
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
Estatus del nodo Tipo de nodo
Indicacin de la hora del estatus
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
Direccin de red Mscara de red
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
Habilitado para SNMP Estatus
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
Condicin de excepcin genrica
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.
Gravedad Nombre de fuente Estatus fuente
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.
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.
Utilizacin de listas de nodos gestionados (listas de favoritos)

Una red de tamao medio puede contener cientos o miles de dispositivos. Esto puede fcilmente provocar problemas de gestin y utilizacin. Una manera de afrontar dichos problemas es compartimentalizar la gestin piezas mas pequeas y bien entendidas, gestionando por separado aquellos dispositivos crticos para determinada aplicacin, para una utilizacin en particular, una ubicacin geogrfica o una parte de la red principal. La aplicacin SNMP-MANAGER permite definir y gestionar conjuntos de dispositivos crticos mediante listas de nodos gestionados o listas de favoritos. Por ejemplo, puede definir una lista que contenga todo aquello que sea crtico para los servicios web: cortafuegos, dispositivos, servidor de cortafuegos, servidor web y servidor alternativo. Puede definir otra lista que contenga todos los direccionadores esenciales para mantener una determinada oficina operativa, y una tercera que contenga los servidores que mantienen una aplicacin distribuida en lnea. Desde la lista de nodos gestionados puede ver espacios de trabajo, definir situaciones, realizar acciones reflejas y ejecutar polticas de automatizacin, del mismo modo que para cualquier otro sistema gestionado. Un ejemplo sera definir una situacin que busque un valor de atributo Off-line en cualquier dispositivo de la lista. La ventaja de una lista de nodos gestionados es que se puede supervisar el estatus on-line o bien off-line bsicos de un conjunto de servidores o de otros dispositivos crticos en el entorno de una forma sencilla y con poca sobrecarga para el sistema. Hay un subproceso de supervisin separado para cada lista de nodos gestionados activa. En intervalos de 30 segundos, este subproceso recorre en bucle cada dispositivo en la lista, enviando primero un mandato SNMP Get para las variables RFC 1213 System Group MIB. Si el dispositivo responde a SNMP Get, el atributo Node_Status se establece en lnea, los dems valores de la columna se rellenan, y se consulta el siguiente dispositivo de la lista. Si el dispositivo no responde a SNMP Get, el subproceso de supervisin enva una solicitud de ping al dispositivo. Si la solicitud ping supera el tiempo de espera, el atributo Node_Status se establece en fuera de lnea. De lo contrario se establece en On-line (en lnea). Creacin de una lista de nodos gestionados: Una lista de nodos gestionados es un archivo de texto que contiene una definicin LISTNAME (opcional) y una lista de dispositivos y nombres de host:
LISTNAME=TivoliWeb www.tivoli.com mercury[4500] us07 ishtar
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.
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.
Utilizacin de la Consola de mensajes universales (consola de favoritos)

De forma predeterminada, Tivoli Universal Agent enva la siguiente informacin a la consola de mensajes universales (UMC): v Condiciones de excepcin de SNMP con una gravedad de 2 o superior. Una gravedad 2 es un aviso. v Cambio en el estatus de los nodos de red. El estatus pasa de on-line a off-line, y de off-line a on-line. Nota: Esto slo es vlido para aquellas redes que se estn gestionando, es decir, la red conectada localmente y cualquier red para la que se haya emitido una solicitud de Actuacin Manage Start. v Cambios en el estatus de cualquier host o dispositivo en una lista de nodos gestionados. Puede cambiar qu condiciones de excepcin se reenvan, o desactivar los informes. Especificacin de qu condiciones de excepcin enviar: Utilice la variable KUMP_SNMP_TRAP_CONSOLE_SEV para especificar qu condiciones de excepcin se reenvan a la UMC. Se reenviarn todas las condiciones con la gravedad especificada o superior. La gravedad predeterminada es 2:
KUMP_SNMP_TRAP_CONSOLE_SEV=2
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
Creacin de situaciones con atributos de aplicaciones SNMP

Puede crear situaciones utilizando cualquier atributo que vea en un espacio de trabajo. En la situacin puede incluir acciones que desee iniciar en el host donde se encuentre el proveedor de datos de SNMP y puede incorporar tambin polticas. Atributo de propsito especial, Agent_Name: Cada grupo de atributos MIB tiene un atributo KEY de propsito especial, llamado Agent_Name. Como es posible especificar ms de un host desde el que recopilar los datos MIB, es posible que reciba varias filas de los mismos datos de atributos, pero cada fila procedente de un host de agente de SNMP distinto. El atributo Agent_Name se utiliza para identificar el nombre de host que origina una fila de datos determinada. Agent_Name es til en aquellos casos en los que se haya iniciado una recopilacin de datos en particular para varios hosts, pero desee que la situacin sea evaluada en un host determinado. Por ejemplo, si inicia la recopilacin de datos MIB y especifica una direccin de red para recopilar todos los hosts en una red, pero desea que la situacin slo evale los datos del host athens, incluya el siguiente texto en el predicado de situacin:
*SCAN MIB-2IFTABLE.Agent_Name *EQ athens
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
Operaciones SNMP SET

Una operacin SET de SNMP es una manera de cambiar el valor de una variable MIB. Tivoli Universal Agent permite realizar operaciones SET utilizando la opcin Actuacin. Requisitos: Una operacin SET requiere de la siguiente informacin: v El nombre de host del agente de SNMP de destino v El nombre de comunidad de lectura-escritura que acepta el agente de SNMP v El nombre de la variable MIB que desea cambiar v El nuevo valor Para que la operacin SET sea satisfactoria, el metarchivo de SNMP que define la variable MIB debe estar activado, la definicin MIB de la variable debe tener permiso de escritura y el agente de SNMP debe estar programado para gestionar operaciones SET en dicha variable. La sentencia de lectura-escritura ACCESS de la variable MIB ipForwarding en la siguiente figura es un ejemplo de una definicin MIB de una variable que permite acceso de escritura.
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
Proveedor de datos de socket

En los sistemas operativos en los que Tivoli Universal Agent no se puede instalar, el proveedor de datos de socket permite que los datos se sigan recopilando y procesando en Tivoli Universal Agent implementando la comunicacin programa a programa utilizando el paradigma de transporte de sockets. Como la mayora de los sistemas operativos dan soporte a una pila TCP, el proveedor de datos de socket ampla la gama de plataformas soportadas en las que Tivoli Universal Agent puede utilizarse. Y a diferencia del proveedor de datos de servidor de API, no hay necesidad de instalar un paquete del cliente u otro software de Tivoli en el sistema de destino. La Figura 12 muestra el rol del proveedor de datos de socket.
100
Figura 12. Rol del proveedor de datos de socket
Establecimiento de contacto con el proveedor de datos de socket

Un programa remitente, tambin denominado como un programa cliente de socket, se pone en contacto con el proveedor de datos de socket de dos maneras: v Abre un socket TCP y lo conecta al host del proveedor de datos de socket. v Abre un socket UDP y enva datos a la direccin del host del proveedor de datos de socket.
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.
Modificacin del puerto de escucha predeterminado

De forma predeterminada, el proveedor de datos de socket escucha en el puerto 7500. Si el puerto de socket 7500 no est disponible o si desea que el proveedor de datos utilice otro puerto, establezca la variable de entorno KUMP_DP_PORT en el puerto de escucha correcto. Puede comprobar el espacio de trabajo UAGENT DPLOG del proveedor de datos de socket despus de que el proveedor haya comenzado a verificar que el estatus del mensaje identifica claramente el nmero de puerto de escucha correspondiente para TCP, UDP o ambos.
Conversin de nombres de host y de direcciones TCP/IP

La conversin de nombres de host y de direcciones TCP/IP es vital para el funcionamiento del proveedor de datos de socket. El sistema en el que se encuentra el proveedor de datos de socket debe estar correctamente configurado para utilizar el servicio de nombres de red para resolver nombres de hosts y para convertir direcciones de red TCP/IP. Si el nombre de host especificado en la sentencia SOURCE de un metarchivo de definicin de datos no puede resolverse, se ignorar la sentencia SOURCE. Consulte Sentencia SOURCE en la pgina 140 para obtener ms informacin.
Varias mquinas host

La ejecucin de un proveedor de datos de socket en un sistema con ms de una interfaz de red, requiere una consideracin especial. Generalmente, un sistema resuelve su propio nombre de host en la primera interfaz de red instalada. Si prefiere que el trfico del proveedor de datos utilice otra interfaz, puede establecer la variable de entorno KUM_DP_HOSTNAME o KUM_DCH_HOSTNAME al nombre de host preferido.
Nombres de sistemas gestionados de aplicaciones del proveedor de datos de socket

El nombre del sistema gestionado de una aplicacin de metarchivo de socket tiene el siguiente formato:
NombreHost:NombreAplicVV
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
Asociacin de fuentes de datos con metarchivos

Es importante entender cmo se asocia un programa cliente de socket con un metarchivo en particular. Los programas cliente de socket son las fuentes de datos de las aplicaciones de socket y debe asociar el programa cliente correcto con el metarchivo correcto o los datos de entrada no se procesarn correctamente. Adems, el sistema gestionado de una aplicacin de socket no pasa a estar en lnea en el Navigator de Tivoli Enterprise Portal hasta que el programa cliente de socket se hayan conectado al proveedor de datos de socket y se haya producido la asociacin con el metarchivo. Cuando un cliente de socket se conecta por primera vez al proveedor de datos de socket, existe una ambigedad potencial para determinar a qu metarchivo asociar los datos de entrada. En el momento de la conexin, el proveedor de datos de socket slo conoce la direccin IP y el nmero de puerto del programa cliente. Si slo se ha activado un metarchivo de socket, el proveedor de datos de socket sabr claramente qu metarchivo utilizar. Pero si hay varios metarchivos de socket, el proveedor de datos de socket confa en uno de los siguientes mtodos para asociar el programa cliente con su metarchivo: v Sentencia SOURCE del metarchivo v Especificacin explcita del metarchivo
Asociacin mediante la sentencia SOURCE del metarchivo

La manera ms simple y directa de asociar un programa de cliente socket con su metarchivo es mediante la sentencia //SOURCE SOCK nombrehost. Puede especificar una o ms sentencias SOURCE para cada grupo de atributos (sentencia //NAME) en un metarchivo de socket. Generalmente se proporcionan varias sentencias SOURCE si hay varios sistemas host que pudiesen potencialmente conectarse y enviar datos para una aplicacin de metarchivo determinada. En dicho caso, haga una sentencia //SOURCE SOCK independiente para cada host. Por ejemplo:
//SOURCE SOCK HostA //SOURCE SOCK HostB //SOURCE SOCK HostC
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,
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.
Metarchivos de socket con un grupo de atributos

El parmetro de nmero de puerto slo es necesario para resolver la ambigedad si el proveedor de datos de socket est gestionando varios programas cliente de socket y varias aplicaciones del mismo host. El NCARPT de aplicacin slo tiene un grupo de atributos y es la nica aplicacin activa que proporciona datos al proveedor de datos de socket en el siguiente ejemplo:
//APPL NCARPT //NAME Overview P 900 //SOURCE SOCK JOHN //SOURCE SOCK BOB //ATTRIBUTES ';' . . .
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
//SOURCE SOCK TEST2[3301] //SOURCE SOCK TEST3[3301] //ATTRIBUTES ' ' . . .
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.
Metarchivos de socket con varios grupos de atributos

Si un metarchivo de socket tiene varios grupos de atributos y uno o ms programas clientes de socket del mismo host proporcionan datos para dichos grupos de atributos, es posible que surja otro tipo de ambigedad. El proveedor de datos de socket necesita una manera de saber a qu grupo de atributos pertenece cada registro de datos. Hay dos maneras de resolver la ambigedad: Parmetro de nmero de puerto Ampliando el ejemplo anterior, si la aplicacin NCARPT incluye ms de un grupo de atributo, las especificaciones de nmero de puerto pueden aclarar a qu grupo de atributos pertenece cada registro:
//APPL NCARPT //NAME Overview S 900 //SOURCE SOCK JOHN //SOURCE SOCK BOB //ATTRIBUTES ' ' . . . //NAME RedEvent E 3600 //SOURCE SOCK JOHN[1001] //SOURCE SOCK BOB[2001] //ATTRIBUTES ' ' . . . //NAME RunStat S 120 //SOURCE SOCK JOHN[1002] //SOURCE SOCK BOB[2002] //ATTRIBUTES ' ' . . .
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...
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;
Asociacin mediante una especificacin explcita

Tambin puede asociar los programas clientes de socket y los metarchivos mediante el uso de los registros de asociacin explcitos de metarchivo. Este mtodo presenta las siguientes reglas: v El primer registro de datos recibido por el proveedor de datos de socket de un programa cliente debe contener una asociacin de aplicacin explcita empezando por el desplazamiento cero. Proporcione este registro en un mandato de envo de socket separado porque los datos restantes en el almacenamiento intermedio de registros no se examinarn y se omitirn. Enve el registro de asociacin explcita antes que //SETSOURCENAME, //SOCKET-COMMAND-ENABLED y que cualquier otra directriz de socket especial. v El registro de asociacin debe comenzar con dos barras inclinada, seguidas por el nombre del metarchivo. Por ejemplo:
//miAplic
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.
107
Metafile: JOBCNTL.mdl //APPL NCAJOB //NAME PartList P 900 //ATTRIBUTES, . . .
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.
Formato de un almacenamiento intermedio de sockets para la transmisin

El programa que enva datos a un proveedor de datos de socket debe formatear el almacenamiento intermedio de datos de acuerdo con las definiciones del metarchivo. El orden de los valores en el almacenamiento intermedio de envo debe coincidir con el orden de los atributos definidos en el metarchivo y el delimitador de registro utilizado debe ser el especificado en el metarchivo. Por ejemplo, si el metarchivo tiene tres atributos, el almacenamiento intermedio de envo deber tener el valor del primer atributo como primera seal en el almacenamiento intermedio, el valor del segundo atributo como segunda seal y el valor del tercer atributo como tercera seal. Si la sentencia ATTRIBUTE especifica un delimitador de ;, el almacenamiento intermedio de envo debe colocar un punto y coma (;) entre cada seal de valor. Aada un carcter de lnea nueva, o un retorno de carro si es una plataforma EBCDIC, al final de cada fila de datos que enve al proveedor de datos de socket. El carcter de nueva lnea sirve de delimitador de fila de datos en caso de que el almacenamiento intermedio recibido por el proveedor de datos de socket contenga varias filas de datos. Los nicos caracteres de lnea nueva que el proveedor de datos de socket acepta son \n (o el equivalente hexadecimal, x0A) y \r (o el equivalente hexadecimal, x0D). Otros caracteres de retorno de carro y salto de lnea, o combinaciones de caracteres no se reconocen y se tratan como datos de entrada regulares.
Tiempo de espera excedido

La comunicacin UDP no proporciona informacin de estado ni al remitente ni al destinatario. Cuando se utiliza la comunicacin UDP, el proveedor de datos de socket emplea las siguientes reglas para determinar el estado del programa remitente: v Para aquellos datos sondeados, muestreados y con clave, el proveedor de datos de socket excede el tiempo de espera del programa remitente despus de cinco intervalos de TTL sin recibir datos y notifica a IBM Tivoli Monitoring de que el sistema gestionado est fuera de lnea. v Para los datos de sucesos, el proveedor de datos de socket espera indefinidamente la entrada del programa.
Envo de mandatos de accin a clientes de socket

De forma predeterminada, cualquier accin refleja u otro mandato de automatizacin que se haya distribuido a un sistema gestionado de aplicacin de socket ser ejecutado en el sistema local en el que se est ejecutando el proveedor de datos de socket, no en el sistema remoto donde se est ejecutando el programa cliente de socket. Puede solicitar que las acciones se enven al programa cliente de socket enviando el siguiente registro despus de que se conecte el programa cliente:
//SOCKET-COMMAND-ENABLED=Y
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.
Fin de sesin de la entrada de datos

Al final de una sesin de datos de entrada, el programa remitente puede elegir entre dos maneras de finalizar la sesin y permitir que el proveedor de datos indique el estatus fuera de lnea a IBM Tivoli Monitoring: v El programa enva al proveedor de datos el mensaje de final de transaccin mostrado a continuacin como un nico registro, indicando la normal finalizacin de una sesin:
//END-DP-INPUT
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.
Conversin de cdigo de caracteres

La utilizacin del transporte de sockets presupone que el programa remitente se encuentra en un host distinto del host donde se est ejecutando el proveedor de datos de socket. Por lo tanto, es posible que la representacin de datos del programa remitente difiera de aquella del proveedor de datos de socket. El proveedor de datos debe poder detectar la diferencia y manejar la conversin entre las dos representaciones. La necesidad de la conversin de cdigo de caracteres se indica de una de tres maneras: v Especificacin del tipo de cdigo en la sentencia SOURCE v Especificacin del entorno local y la pgina de cdigos en la sentencia SOURCE del metarchivo v Asociacin explcita de metarchivos
Especificacin del tipo de cdigo en sentencias SOURCE de metarchivos

El parmetro opcional code-type en la sentencia SOURCE es slo vlido para aquellas fuentes del tipo SOCK. Este parmetro define el tipo de cdigo de caracteres del host del programa remitente como ASCII o EBCDIC. El valor predeterminado es ASCII. Si el tipo de cdigo del host del programa remitente difiere del tipo de cdigo del host del proveedor de datos de socket, el proveedor de datos convierte los datos que recibe en el tipo de datos de caracteres de su propio host local.
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.
Utilizacin de un registro de asociacin explcita

El proveedor de datos de socket proporciona el primer registro de datos que recibe de un nuevo programa remitente para un registro de asociacin explcita de aplicacin. Si se encuentra un registro y el metarchivo est satisfactoriamente cargado, el tipo de cdigo del programa que se conecta se ha determinado y verificado. Si la especificacin del tipo de cdigo en la sentencia SOURCE del metarchivo SOURCE no coincide con el tipo de cdigo determinado durante el tiempo de ejecucin, el valor determinado durante el tiempo de ejecucin altera temporalmente la definicin de la sentencia SOURCE. Si no utiliza la asociacin explcita de metarchivos, deber asegurarse de que se haya especificado el tipo de cdigo correcto para el host del programa remitente en la sentencia SOURCE o asegurarse de que el programa y el proveedor de datos de socket se ejecutan en sistemas con arquitecturas similares.
Utilizacin del formato de caracteres para los datos numricos

El proveedor de datos de socket y el programa cliente remitente pueden estar situados en sistemas con arquitecturas diferentes con distintas representaciones internas de los datos numricos. Por lo tanto, el programa cliente deber enviar datos numricos en formato de caracteres en lugar de en la representacin binaria del sistema. Cuando el proveedor de datos de socket analiza los datos recibidos como atributos individuales, la representacin de caracteres de valores numricos se convierte al formato numrico local.
Deteccin de interrupciones TCP

TCP es un protocolo de transporte orientado a conexiones. Los socios de sesin conectados detectan inmediatamente las desconexiones de sesin causadas por un socio desconectndose o por una interrupcin de red. No obstante, si un sistema socio conectado experimenta una interrupcin de alimentacin, su socio de sesin no puede detectar la interrupcin ya que no ha habido notificacin de desconexin de sesin ni por parte del socio de conexin ni por parte del servicio de red.
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.
Retraso de la notificacin de desconexin TCP

El proveedor de datos de socket detecta inmediatamente la desconexin de la sesin del programa cliente de la sesin TCP. No obstante, es posible retrasar la notificacin de IBM Tivoli Monitoring para proporcionar una oportunidad adecuada para el proceso de los datos recibidos. De forma predeterminada, la notificacin de desconexin TCP se retiene hasta que haya caducado el intervalo de tiempo de vida (TTL). Consulte Sentencia NAME en la pgina 134 para obtener ms informacin acerca de TTL. Por ejemplo, un grupo de atributos has especificado un TTL de 180 segundos (3 minutos). El proveedor de datos de socket no notifica a IBM Tivoli Monitoring que el programa cliente de socket se ha desconectado hasta tres minutos despus de haber detectado la desconexin de la sesin TCP. Para inhabilitar el retraso de la notificacin TCP, establezca la variable de entorno KUMP_TCP_DISCONNECT_BY_TTL en No.
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.
Limitaciones del proveedor de datos de socket

Debido a que el proveedor de datos de socket est pensado para extender la gestin de sistemas y aplicaciones a sistemas operativos desconocidos utilizando herramientas comunes con un mnimo de inversin en esfuerzo de programacin, est sujeto a un nmero de limitaciones.
Deteccin de errores limitada con UDP

Con la programacin UDP, hay definido un protocolo mnimo entre el proveedor de datos de socket y el programa remitente. La utilizacin de un protocolo produce una complejidad de programacin reducida, lo que facilita el desarrollo de aplicaciones de Tivoli Universal Agent. No obstante, la deteccin y la recuperacin de errores son limitados porque no se realiza ninguna comprobacin del estatus o del latido entre un programa UPD remitente y el proveedor de datos de socket, a menos que utilice la funcin CONFIRM. Consulte Sentencia CONFIRM en la pgina 157 para obtener ms informacin. La utilizacin de TCP permite a la aplicacin y al proveedor de datos detectar problemas de conectividad inmediatamente e iniciar un procedimiento de recuperacin de problemas. Con UDP, las partes slo pueden confiar en tiempos de espera excedidos y enviar errores para determinar el estatus.
111
Modalidad de bloque no soportada

El proveedor de datos de socket no da soporte a bloques de datos de ejemplo como la modalidad COPY de los archivos o la llamadas a API dp_BeginSample y dp_EndSample, ya que no hay un protocolo definido entre el proveedor de datos de socket y un programa remitente para implementar esta construccin lgica.
112
Captulo 5. Supervisin de aplicaciones

Este captulo trata sobre cmo utilizar Tivoli Enterprise Portal para supervisar las aplicaciones de Tivoli Universal Agent. Cubre los siguientes aspectos: v Nombres de los sistemas gestionados, espacios de trabajo y grupos de atributos de Tivoli Universal Agent. v Espacios de trabajo personalizados para la supervisin de aplicaciones de Tivoli Universal Agent v Espacios de trabajo de UAGENT para la supervisin del estado operativo de los proveedores de datos y las acciones a las que dan soporte v Creacin de situaciones y polticas de automatizacin para aplicaciones de Tivoli Universal Agent. v Recopilacin de datos histricos
Supervisin de los datos de Tivoli Universal Agent

Con Tivoli Enterprise Portal, puede supervisar datos de Tivoli Universal Agent del mismo modo en que es posible supervisar varios agentes de Tivoli Enterprise Monitoring. Tivoli Enterprise Portal permite realizar las siguientes tareas: v Ver espacios de trabajo actuales e histricos para cada grupo de atributos que se est supervisando v Supervisar el estado operativo de los proveedores de datos v Crear situaciones que utilicen los atributos definidos v Crear polticas para automatizar respuestas a los sucesos en los sistemas supervisados
Sistemas gestionados por Tivoli Universal Agent

Cada Tivoli Universal Agent y cada aplicacin supervisada por Tivoli Universal Agent est representada en Tivoli Enterprise Portal como un sistema gestionado. El nombre asignado a un sistema gestionado permite identificar la ubicacin de los datos, la aplicacin de Tivoli Universal Agent correspondiente y la versin del metarchivo. Cuando cambia el nmero de versin del metarchivo, un nuevo sistema gestionado pasa a estar en lnea y el antiguo pasa a estar fuera de lnea. Tivoli Universal Agent tiene un mtodo especfico para nombrar los sistemas gestionados que registra con el servidor de Tivoli Enterprise Monitoring. En la Tabla 21 se muestra este convenio de nomenclatura.
Tabla 21. Sistemas gestionados por Tivoli Universal Agent Sistema gestionado hostname:UA hostnameASFSdp:UAGENT00 hostnameSNMPdp:UAGENT00 hostname:SNMP-MANAGER00 localSubnet:SNMP-MANAGER00 hostnameHTTPdp:UAGENT00 hostname:INTERNET00 hostnameODBCdp:UAGENT00 hostname:APPLICATIONvv Tipo _Universal Agent Universal Data Provider Universal Data Provider Universal Data Provider Universal Data Provider Universal Data Provider Universal Data Provider Universal Data Provider Universal Data Provider Nmero de sistemas gestionados 1 por cada Tivoli Universal Agent 1 por cada proveedor de datos ASFS 1 por cada proveedor de datos de SNMP 1 por cada proveedor de datos de SNMP 1 por cada proveedor de datos de SNMP 1 por cada proveedor de datos HTTP 1 por cada proveedor de datos HTTP 1 por cada proveedor de datos de ODBC 1 por cada aplicacin
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.
Nombres de sistemas gestionados

Cuando se inicia Tivoli Universal Agent, registra el siguiente sistema gestionado:
nombre_host:UA
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.
Truncamiento de los nombres de sistemas gestionados

Si la longitud del nombre completo del sistema gestionado supera los 32 caracteres, el nombre de fuente se truncar por la derecha. Si se est utilizando un nombre de instancia, se truncar por la izquierda hasta que el nombre completo del sistema gestionado sea igual a 32 caracteres.
Nmeros de versin de sistemas gestionados

A cada sistema gestionado se le asigna un nmero de versin. El nmero de versin completa registrado con el servidor de supervisin adopta el formato siguiente:
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.
Cambios de versin de sistemas gestionados

Cuando el nmero de versin (RR) de un metarchivo cambia, se produce lo siguiente. Consulte Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent en la pgina 27 para obtener informacin adicional acerca de los cambios que hacen que cambie una versin de un metarchivo. 1. Los sistemas gestionados con el nmero de versin anterior pasan a estar fuera de lnea. 2. Los sistemas gestionados con el nuevo nmero de versin pasan a estar en lnea. 3. Las entradas en la lista de sistemas gestionados aparecen con el nuevo nmero de versin. 4. Cualquier situacin en ejecucin que se haya distribuido a versiones anteriores de los sistemas gestionados se detendr de forma automtica. Los nombres de los espacios de trabajo y de los grupos de atributos tambin cambiarn. Consulte Nombres de atributos y grupos de atributos en la pgina 120 para obtener ms informacin. Nota: No es posible simplemente reiniciar las situaciones distribuidas a una versin anterior de un sistema gestionado. Deber crear nuevas situaciones o editar las ya existentes para utilizar los nuevos nombres de grupos de atributos y distribuirlos a las nuevas versiones de los sistemas gestionados. Lo mismo se aplica a las polticas. Por este motivo, intente realizar cambios en los metarchivos que slo modifiquen el nmero de modificacin y no el nmero de versin. Consulte Mantenimiento de versiones de aplicaciones de Tivoli Universal Agent en la pgina 27 para obtener una lista de aquellos cambios que no afectan al nmero de versin. Cuando el nmero de modificacin (MM) de un metarchivo cambia, no es necesario volver a crear y redistribuir las situaciones o polticas existentes. Cambie una situacin existente slo si desea utilizar un atributo recin aadido como uno de sus predicados.
Espacios de trabajo de aplicaciones

Tivoli Enterprise Portal incorpora un espacio de trabajo para cada grupo de atributos definido en una aplicacin de metarchivo. Es posible acceder a los espacios de trabajo de Tivoli Universal Agent desde el nivel Grupo de atributos de la vista Navigator. Navigator ofrece una vista de alto nivel de la empresa que se est supervisando. Puede mostrar la empresa como una correlacin fsica de sistemas y aplicaciones o como una vista lgica de entidades, como los departamentos de ventas y nminas. Los separadores Fsica y Lgica en la parte inferior de Navigator permiten alternar entre ambas vistas.
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.
Personalizacin del contenido de espacios de trabajo

Puede personalizar el contenido de espacios de trabajo de Tivoli Universal Agent, de la misma manera que puede personalizar el contenido de otros espacios de trabajo, con las acciones siguientes: v Crear espacios de trabajo que contengan datos de slo un subconjunto de sistemas o atributos gestionados v Clasificar columnas basndose en el valor de las entradas v Incluir o excluir datos de acuerdo con los criterios especificados v Cambiar el orden de las columnas en el espacio de trabajo Consulte la publicacin Tivoli Enterprise Portal Administrators Guide y la ayuda en lnea de Tivoli Enterprise Portal para obtener instrucciones acerca de cmo personalizar los espacios de trabajo.
Acceso a la ayuda para grupos de atributos y atributos

Si se ha definido la ayuda en un metarchivo de Tivoli Universal Agent, puede acceder a ella en Tivoli Enterprise Portal de las siguientes maneras: v Para obtener informacin acerca de un grupo de atributos especfico, seleccione el nombre del grupo de atributos en el Editor de situaciones. Al definir condiciones para incluir en la situacin, el texto de ayuda del grupo de atributos aparece listado en el recuadro Descripcin en la parte inferior de la ventana. En esta ventana seleccione un Elemento de atributo para ver el texto de ayuda en el recuadro Descripcin correspondiente a dicho atributo. v Para obtener informacin acerca de las columnas que representan atributos en los espacios de trabajo, desplace el ratn sobre los encabezados de columnas que representan cada atributo.
116
Consulte Creacin de ayuda para aplicaciones, grupos de atributos y atributos en la pgina 19 para obtener informacin adicional.
Espacios de trabajo UAGENT

Cada proveedor de datos registra la aplicacin de propsito especial UAGENT, durante el inicio. UAGENT contiene los grupos de atributos DPLOG y ACTION. El propsito del grupo de atributos DPLOG es traer a la superficie informacin de estatus de un proveedor de datos en particular. El propsito del grupo de atributos ACTION es proporcionar informacin acerca del proceso de mandatos de Actuacin, y acciones automticas de situaciones y polticas. Puesto que cada aplicacin UAGENT se registra como un sistema gestionado, se pueden desarrollar situaciones y polticas para ella, del mismo modo que para cualquier otro sistema gestionado, que permite gestionar todos los proveedores de datos de una empresa desde Tivoli Enterprise Portal y conseguir la supervisin automtica y dinmica de operaciones en tiempo de ejecucin de Tivoli Universal Agent.
Nombres de sistemas gestionados de UAGENT

Los nombres de sistemas gestionados para las aplicaciones de UAGENT se construyen de la misma manera que los nombres de sistemas gestionados de las aplicaciones de Tivoli Universal Agent. Tienen el siguiente formato:
NombreHostLocalTIPODPdp:UAGENTVV
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.
Espacio de trabajo DPLOG

El espacio de trabajo DPLOG es similar a un registro de consola de sistema. Este espacio de trabajo ofrece un seguimiento de auditora detallado para el proveedor de datos, incluidos los sucesos principales, errores y mensajes de aviso. El espacio de trabajo DPLOG contiene siete columnas, que se describen en la Tabla 22 en la pgina 117.
Tabla 22. Columnas del espacio de trabajo DPLOG Nombre de la columna Categora de registro de DP Texto de registro de DP Nombre de DP Hora del DP Tipo de DP Versin de DP Descripcin La categora de la entrada de registro. Las categoras de registro actualmente implementadas se describen en la Tabla 23. El texto de mensaje detallado del registro del proveedor de datos. El nombre del sistema gestionado del proveedor de datos que emite el mensaje de registro. La hora local del mensaje de suceso del proveedor de datos. El formato es SAAMMDDHHMMSSmmm. El tipo de proveedor de datos. Los tipos incluyen: ASFS, servidor de API, socket, Archivo, Envo, script, SNMP, HTTP y ODBC. El nmero de versin actual del proveedor de datos.
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
Espacio de trabajo ACTION

El espacio de trabajo ACTION contiene 8 columnas. Estas columnas se describen en la Tabla 24. Puede crear situaciones y polticas basadas en atributos de ACTION de la misma manera que puede hacerlo con cualquier otro atributo de espacio de trabajo. No obstante, no es posible utilizar reiteradamente la automatizacin o los mandatos de Actuacin en el grupo de atributos ACTION.
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
Resultados de la accin Hora de la accin
Situaciones de Tivoli Universal Agent

Este apartado trata informacin especfica acerca de la creacin de situaciones de Tivoli Universal Agent. Consulte la publicacin Tivoli Enterprise Portal Administrators Guide o la ayuda en lnea proporcionada con Tivoli Enterprise Portal para obtener instrucciones detalladas sobre la creacin de situaciones. Una situacin es una expresin lgica con una o ms condiciones del sistema. Las situaciones se utilizan para supervisar la condicin de los sistemas en la red. Es posible gestionar situaciones desde Tivoli Enterprise Portal utilizando el Editor de situaciones.
Acerca de las situaciones predefinidas

Los agentes de Tivoli Enterprise Monitoring a utilizar para supervisar el entorno del sistema incluyen un conjunto de situaciones predefinidas, tambin denominadas situaciones proporcionadas con el producto, que pueden utilizar tal y como se incluyen o modificarlas para cumplir sus requisitos. Todas las situaciones predefinidas estn configuradas para activarse durante el inicio, pero debe asignarlas a los sistemas gestionados en lo que desea que se ejecuten. Las situaciones predefinidas contienen atributos que comprueban condiciones del sistema comunes a muchas empresas. La utilizacin de situaciones predefinidas puede mejorar la velocidad con la que comenzar a utilizar los productos de IBM Tivoli Monitoring. Puede examinar y, si fuese necesario, cambiar las condiciones o valores que se estn supervisando mediante una situacin predefinida para que se adecue ms correctamente a su empresa. Hay otras 20 situaciones predefinidas que se instalan junto con Tivoli Universal Agent. Todas estas situaciones se utilizan con el proveedor de datos de SNMP. Consulte la Tabla 20 en la pgina 95 para obtener una lista completa de situaciones de SNMP. Nota: Antes de modificar una situacin predefinida, realice una copia como reserva en caso de que fuese necesario.
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:
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
Nombres de atributos y grupos de atributos

Los atributos que haya definido aparecen en la ventana Seleccionar atributo que se visualiza cuando se coloca un objeto de predicado en el espacio de trabajo del Editor de situaciones. El nombre del grupo de atributos es el mismo que el espacio de trabajo que contiene los datos de dicho grupo. Los nombres de los atributos en el grupo son los mismos que los encabezados de las columnas en el espacio de trabajo.
Creacin de situaciones con atributos de distintos grupos

Slo es posible crear situaciones que utilicen atributos del mismo grupo de atributos. Si desea utilizar atributos de distintos grupos en la situacin, deber crear otra situacin e incluirla en la primera. Como alternativa, puede considerar crear un nuevo grupo que contenga todos los atributos que desee incluir en la situacin.
Distribucin de situaciones a sistemas gestionados

Despus de crear una situacin, se distribuye a los sistemas gestionados en los que desea que se ejecute. Es posible distribuir la situacin a cualquier sistema gestionado cuyo nombre contenga el nombre de aplicacin. Por ejemplo, si el nombre del grupo de atributos es UL3SYSLOG00, puede distribuir la situacin a cualquier sistema gestionado cuyo nombre tenga el formato nombrehost:UL300. Siempre es posible distribuir la situacin a la lista de sistemas gestionados *CUSTOM_AAARR, donde: AAA RR El nombre de la aplicacin El nmero de versin del metarchivo
Utilice nombres de sistemas gestionados especficos para obtener un mejor rendimiento.
120
Intervalo de situacin y valor de tiempo de vida (TTL)

Si un grupo de atributo de aplicacin est definido como tipo de datos de suceso (E) en la sentencia NAME del metarchivo, no se puede especificar un intervalo para las situaciones utilizando atributos de dicho grupo. Si el grupo de atributos es de los tipos muestreado (S), sondeado (P) o con clave (K), necesitar tener en cuenta el valor de tiempo de vida (TTL) al establecer el intervalo de situacin. Especifique un TTL para indicar cunto tiempo deben los datos proporcionados por los proveedores de datos considerarse vlidos para su evaluacin. El valor de TTL que elija afecta a cmo se evalan las situaciones y a qu puede filas de datos se ven en los espacios de trabajo de aplicacin de Tivoli Universal Agent. Cuando se crea una situacin y se distribuye a un sistema gestionado, es evaluada por Tivoli Universal Agent. Tivoli Universal Agent ignora cualquier fila de datos que tenga una TTL caducada, es decir, donde la edad de los datos sea mayor que el TTL. Esto significa que si se especifica un TTL pequeo en comparacin con el intervalo de muestreo de la situacin, la situacin no activarse cuando debera. Para evitar esto, elija un intervalo de muestre de situacin mas pequeo que el TTL o aumente el TTL.
Reglas especiales para conjuntos de muestras de varias filas

Un conjunto de muestras es una muestra de datos que consta de varias filas de datos. Cada vez que el proveedor de datos de archivo muestrea un archivo de registro, genera un conjunto de muestras que consta de todos los registros en el archivo de registro. Por ejemplo, si est utilizando el proveedor de datos de archivo y especifica la modalidad Copy (Copia) en la sentencia SOURCE, est indicando que las muestras contienen varias filas de datos, a saber, el contenido entero del archivo. Tivoli Universal Agent trata el conjunto de muestras como una muestra, lo que significa que el TTL que especifique se aplica a todo el conjunto de muestras. Despus de que caduque el TTL, ninguna de las filas individuales que componen el conjunto de muestras disponibles para los espacios de trabajo o para la evaluacin de situaciones.
Recopilacin de datos histricos

Puede utilizar los recursos de la funcin de recopilacin de datos histricos de Tivoli Enterprise Portal para almacenar y guardar los datos recopilados por Tivoli Universal Agent o los agentes. La funcin de recopilacin de datos histricos permite especificar lo siguiente: v El grupo o grupos de atributos para los que se recopilan datos. v El intervalo durante el que se recopilan datos. v Si selecciona utilizar el almacn, y el intervalo con que se deben guardar los datos en el depsito. v La ubicacin, en el agente o en el servidor de Tivoli Enterprise Monitoring, donde se almacenan los datos recopilados. Es posible encontrar ms informacin acerca de la utilizacin de la funcin de recopilacin de datos histricos en la ayuda en lnea de Tivoli Enterprise Portal y en la publicacin Tivoli Enterprise Portal Administrators Guide.
121
122
Captulo 6. Introduccin al emisor de SNMP

Este captulo proporciona la siguiente informacin acerca del emisor de SNMP de Tivoli Universal Agent: v Una introduccin al emisor de SNMP de Tivoli Universal Agent. v Instrucciones para la instalacin e integracin del emisor de SNMP. v Establecimiento de parmetros. v Utilizacin de los datos del emisor de SNMP.
Visin general del emisor de SNMP

Cada vez con mayor frecuencia, los administradores de sistemas afrontan el reto de gestionar informacin en entornos distribuidos y heterogneos con varios puntos focales y distintas herramientas de gestin. El emisor de SNMP es una interfaz entre IBM Tivoli Monitoring y gestores de SNMP de terceros como HP OpenView y CA-Unicenter. El emisor de SNMP integra la informacin de los productos de IBM Tivoli Monitoring y los datos de productos de terceros en un nico sistema. Enva datos de sucesos de situacin supervisados por los productos de IBM Tivoli Monitoring, en forma de condiciones de excepcin de SNMP, a un gestor de terceros. El emisor de SNMP proporciona lo siguiente: Simplifica la gestin del sistema y de las aplicaciones Permite la visualizacin de alertas de aplicaciones, sistemas operativos y recursos en todo el entorno informtico desde un nico punto focal seleccionado por el usuario. Mejora el rendimiento del sistema y la disponibilidad Correlaciona informacin de distintas herramientas de gestin para gestionar de manera ms eficaz los sistemas de red. Aumenta la eficacia Permite el acceso a la informacin para poder resolver problemas del sistema de manera ms eficaz. Utilice las situaciones para asegurarse de que recibe nicamente las alertas que considere importantes. Proporciona flexibilidad Permite a los administradores y a los operadores utilizar las herramientas de gestin con las que estn familiarizados para supervisar informacin, independientemente de dnde se ha recopilado. El emisor de SNMP est soportado en todos los sistemas operativos soportados por Tivoli Universal Agent. El emisor de SNMP enva condiciones de excepcin en el formato de SNMP versin 1. El emisor de SNMP utiliza los servicios nativos del sistema operativo para comunicar sucesos a una aplicacin de gestin de SNMP designada que se ejecute en cualquier host. No tiene ninguna dependencia con ningn servicio de SNMP del sistema operativo y puede coexistir con otros servicios de SNMP del sistema operativo. Por ejemplo, si Universal Agent se ejecuta en un sistema Windows, no es necesario ejecutar tambin el servicio SNMP proporcionado por Microsoft o el servicio de condiciones de excepcin de SNMP en dicho sistema para poder utilizar el Emisor de SNMP. Cuando se produce un suceso, es decir, cuando el estatus de una situacin supervisada por un producto de IBM Tivoli Monitoring cambia de Falso a Verdadero, el servidor de Tivoli Enterprise Monitoring recopila y almacena la informacin acerca del suceso. Si existe una poltica de Tivoli Universal Agent con el emisor de SNMP, se reenva una condicin de excepcin de SNMP a un gestor de SNMP designado. Puede utilizar el Emisor de SNMP para emitir condiciones de excepcin para otros productos de agente adems de Tivoli Universal Agent.
123
Variables de entorno del emisor de SNMP

Una condicin de excepcin de SNMP contiene un nombre de comunidad de SNMP; un gestor de SNMP puede elegir utilizarlo. De forma predeterminada, ste es el nombre de comunidad pblico. Puede cambiar el nombre predeterminado por otro nombre mediante la variable de entorno KUMP_TRAP_EMIT_COMMUNITY. Para designar los hosts que desea que reciban las condiciones de excepcin de SNMP, puede utilizar la variable de entorno KUMP_TRAP_DESTINATION, que presenta las reglas siguientes: v No tiene valor predeterminado v Define los nombres de host en los que se estn ejecutando los gestores de SNMP. Deber separar varios nombres de host mediante comas. v Como alternativa a KUMP_TRAP_DESTINATION, puede utilizar el parmetro TrapDestination en la definicin de poltica del Emisor de SNMP. Para incluir informacin de predicado de la situacin que ha hecho que se emitiera la condicin de excepcin, especifique la variable de entorno, KUMP_TRAP_ADD_PREDICATES=Y. De forma predeterminada, las cadenas de predicado de la situacin no estn incluidas en las condiciones de excepcin que el Emisor de SNMP enva.
Instalacin e integracin del emisor de SNMP

Utilice los siguientes procedimientos para instalar e integrar el emisor de SNMP.
Instalacin del emisor de SNMP

Para instalar el Emisor de SNMP, complete los pasos siguientes: 1. Instale Tivoli Universal Agent. La caracterstica del emisor de SNMP est completamente integrada en la instalacin de Tivoli Universal Agent y el emisor de SNMP arranca automticamente cuando se inicia Tivoli Universal Agent. 2. El archivo de catlogo del Emisor de SNMP, kum.cat, debe encontrarse en el directorio RKDSCATL del servidor de Tivoli Enterprise Monitoring concentrador. 3. El archivo de atributos del emisor de SNMP, kum.atr, debe estar situado en el directorio central ATTRLIB del servidor de Tivoli Enterprise Monitoring. Si tiene un servidor de Tivoli Enterprise Monitoring basado en z/OS, necesitar instalar los archivos KUMATR y KUMCAT en PDS de RKANDATV. 4. El archivo ODI del Emisor de SNMP dockum tiene que estar situado en el directorio \cnps o /cq/data de servidor de Tivoli Enterprise Portal. Nota: No hay conexin o dependencia necesaria entre el proveedor de datos de SNMP y el emisor de SNMP. Puede utilizar el emisor de SNMP sin activar el proveedor de datos de SNMP. De hecho, no inicie el proveedor de datos de SNMP si no va a utilizar ninguna de sus funciones porque requiere ms sobrecarga que otros proveedores de datos de Tivoli Universal Agent.
Integracin del emisor de SNMP en soluciones de terceros

Las condiciones de excepcin enviadas por el Emisor de SNMP necesitan estar integradas en un gestor de SNMP, como por ejemplo, HP OpenView y la consola. Para que el gestor de SNMP pueda interpretar correctamente y visualizar la informacin de condicin de excepcin, debe anunciar la estructura de la condicin de excepcin. La informacin estructural se almacena en los archivos CANBASE.MIB y CANSYSSG.MIB, que se distribuyen con Tivoli Universal Agent. Estos dos archivos MIB se encuentran en el directorio \TMAITM6 en los sistemas Windows y en el directorio /um/mib en los sistemas UNIX.
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.
Visualizacin de los datos del emisor de SNMP

La visualizacin de datos de condicin de excepcin del emisor de SNMP vara entre un producto de gestor de SNMP y otro. Para ayudarle a comprender mejor qu datos de condicin de excepcin estn previstos, consulte la siguiente descripcin de condicin de excepcin en el archivo CANSYSSG.MIB implementado en la macro TRAP-TYPE:
candleEvent TRAP-TYPE ENTERPRISE candle-Alert-MIB VARIABLES { sitName, sitCurrStat-OriginNode, sitCurrStat-LocalTimeStamp, sitCurrStat-Severity, sitCategory, sitCurrStat-Predicates, sitAttributeList } DESCRIPTION Se ha excedido el umbral de una situacin de IBM Tivoli Monitoring. Esta condicin de excepcin la ha generado el emisor de SNMP de Tivoli Universal Agent en respuesta a haber excedido un umbral de una situacin.::= 8
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}
Utilizacin del emisor de SNMP y sus datos

Utilice la siguiente informacin para establecer los parmetros del emisor de SNMP y para utilizar los datos del emisor de SNMP.
Establecimiento de los parmetros del emisor de SNMP

Es posible acceder al emisor de SNMP desde el interior del Editor de flujos de trabajo de Tivoli Enterprise Portal. Cree primero las situaciones de IBM Tivoli Monitoring que desee supervisar. Una vez creadas las
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
Apndice A. Sentencias de control de definicin de datos

Este apndice contiene las descripciones y sintaxis de las sentencias de control utilizadas para crear un metarchivo de definicin de datos.
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
Sentencia SNMP Descripcin

Esta sentencia contiene la definicin de datos para una aplicacin SNMP personalizada y slo se utiliza para el proveedor de datos de SNMP. Debe preceder a la sentencia APPL que da nombre a la aplicacin.
Sintaxis
//SNMP TEXT
Parmetro
La sentencia SNMP debe contener el parmetro TEXT.
130
Sentencia APPL Descripcin

La sentencia APPL especifica el nombre utilizado por IBM Tivoli Monitoring para la aplicacin Tivoli Universal Agent. Una definicin de datos de metarchivo siempre define una aplicacin completa. Deben cumplirse los siguientes requisitos: v Escriba slo una sentencia //APPL por cada metarchivo. v Debe tener un nombre //APPL exclusivo. Si dos metarchivos distintos incluyen definiciones de aplicaciones con el mismo nombre //APPL, aunque el contenido sea diferente, el segundo metarchivo no se carga.
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
131
H D W M Q Y
Por hora Diario Semanal Mensual Por trimestre Anual
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
Sentencia NAME Descripcin

Una sentencia NAME define el nombre de un grupo de atributos, el mtodo de recopilacin de datos y el periodo durante el cual son vlidos los datos. v Deber haber al menos una sentencia NAME, y un mximo de 64, en un metarchivo. v Cada sentencia NAME debe ir seguida de la sentencia SOURCE asociada (si se precisa de alguna), la sentencia //ATTRIBUTES y sentencias de definicin de atributos individuales.
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
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
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.
Grupos de atributos invisibles

La sentencia NAME proporciona soporte para grupos de atributos invisibles. Un grupo de atributos invisible no forma parte de la aplicacin del cliente desde la perspectiva del servidor de Tivoli Enterprise Monitoring, Tivoli Enterprise Portal y del usuario final. Al definir un grupo de atributos como invisible, puede ocultar las definiciones de atributos y espacios de trabajo innecesarios. La finalidad de un grupo de atributos invisible es recopilar datos puros, como por ejemplo, datos de un programa cliente de archivo o de socket y, a continuacin, redirigir los datos a otros grupos de atributos visibles en el mismo metarchivo donde se pueden filtrar, resumir y manipular los datos de diferentes maneras para proporcionar informacin ms significativa. El grupo de atributos invisible se oculta desde un punto de vista exterior. No hay ningn espacio de trabajo de Tivoli Enterprise Portal para el grupo de atributos invisible, y no se pueden definir situaciones para l. Utilice la funcin de grupo de atributos invisibles junto con una sentencia //INTERNAL OUTPUT. Consulte Sentencia INTERNAL en la pgina 150 para obtener ms informacin. Anteponga al nombre del grupo de atributos un smbolo de tilde (~) para hacerlo invisible. Por ejemplo: //NAME ~INPUTDATA S 600 A continuacin, se muestra un metarchivo de proveedor de datos de socket que ilustra cmo se podra utilizar un grupo de atributos invisible:
//APPL EXAMPLE //NAME ~RawSocketData E 300 //SOURCE SOCK HostX
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
Sentencia SOURCE Descripcin

La sentencia SOURCE define la ubicacin y las caractersticas de los datos que se estn recopilando. v Cuando se especifica la sentencia SOURCE, debe ir inmediatamente a continuacin de la sentencia NAME. v Cada sentencia SOURCE especifica una fuente. v La sentencia SOURCE no es necesaria para los metarchivos de API y SNMP. v La sentencia SOURCE no es necesaria para los metarchivos de socket que slo tienen un grupo de atributos. No obstante, si se omite la sentencia SOURCE, el programa cliente de socket debe enviar un registro de asociacin de aplicacin explcito que identifica el metarchivo correspondiente. v Como norma, slo puede tener una sentencia SOURCE por cada sentencia NAME a no ser que utilice el parmetro ManagedSystemName para identificar exclusivamente a cada una de las diversas sentencias SOURCE que se asocian con un grupo de atributos. La excepcin es cuando hay varias sentencias //SOURCE SOCK y cada una especifica un nombre de host diferente. v No se pueden combinar tipos diferentes de sentencias SOURCE en el mismo metarchivo. Por ejemplo, si tiene una fuente de archivo de registro y una fuente de script, deben definirse en dos metarchivos distintos.
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.
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
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
/home/logs/abc.log /home/logs/xyz.log /home/logs/mno.log
tail tail tail
ManagedSystemName=Boston ManagedSystemName=Chicago ManagedSystemName=LosAngeles
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
Sentencia INTERNAL Descripcin

La redireccin de datos es muy til para aquellos datos de aplicacin que contengan tipos de datos variables, como un archivo de registro de transacciones que incluya varios tipos de registros de datos, o para aquellos datos de aplicacin que son demasiado complejos para construir una nica definicin de grupo de atributos que pueda manejarlos de forma fiable. Adems, puede utilizar la redireccin de datos en situaciones en las que se reciban los datos una vez, pero que se redireccionan a varios destinos para ser manipulados de distintas maneras, como filtros de atributos, intervalos de resumen u claves de resumen. La sentencia //INTERNAL define la redireccin de la fuente de datos o de los grupos de atributos de destino. Los datos de aplicacin redireccionados se identifican por el nombre-simblico, el cual debe ser exclusivo para todas las aplicaciones activas en la actualidad. Es posible redireccionar los datos de aplicacin desde el grupo de atributos de aplicacin otros grupos de atributos de aplicacin.
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 *
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
Sentencia RECORDSET Descripcin

La sentencia RECORDSET, que slo es para metarchivos del proveedor de datos de script y de archivo, permite que el proveedor de datos extraiga datos de atributo de varios registros. La sentencia RECORDSET especifica la siguiente informacin sobre conjuntos de registros: v Un patrn delimitador que indica el final de un conjunto de registros v El nmero mximo de registros que componen el conjunto de registros v El nmero mximo de registros que componen el conjunto de registros y una regla para identificar el conjunto de registros inicial o final Slo puede haber una sentencia RECORDSET para cada grupo de atributos.
Sintaxis
Formato A: patrn delimitador de final de registro
//RECORDSET patrn_delimitador
Formato B: nmero mximo de registros en el conjunto

//RECORDSET nmero_mximo_registros
Formato C: nmero mximo de registros y regla de identificacin

//RECORDSET nmero_mximo_registros NEW(offset,== | !=,cadena_comparacin) o bien //RECORDSET nmero_mximo_registros END(offset,== | !=,cadena_comparacin)
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
Delimitadores de atributos ausentes

Para entradas de varios registros, el proveedor de datos de archivo est programado para acomodar delimitadores de atributos ausentes u omitidos en la parte inicial o final de un registro. Para la siguiente aplicacin:
//APPL NewClass //NAME PHYSICS101 K //RECORDSET 4 //ATTRIBUTES ; First_Name D 24 Last_Name D 24 Grade D 1 Telephone D 14
KEY KEY
Los siguientes registros son aceptables:

Bob;Smith;B;(555) 323-1919 Susan;Barber B (555) 323-2346; Jack Thomas A (555) 323-5656
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
Los siguientes registros son aceptables:

Bob;@Smith;@B;@(555) 323-1919 Susan;@Barber @B (555) 323-2346; Jack Thomas A (555) 323-5656
156
Sentencia CONFIRM Descripcin

La sentencia CONFIRM proporciona un vehculo para especificar los requisitos de reconocimiento de datos y es slo para metarchivos del proveedor de datos de socket. Debe entrar esta sentencia despus de las sentencias //NAME y //SOURCE y antes de la sentencia //ATTRIBUTES.
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
Sentencia SQL Descripcin

La sentencia SQL le dice al proveedor de datos de ODBC qu tabla seleccionar desde el fuente de datos especificado en la sentencia //SOURCE. Es necesaria una sentencia //SQL para cada sentencia //SOURCE ODBC. Determinadas sentencias SQL pueden ser bastante largas. Observe que una sentencia de metarchivo //SQL puede tener un mximo de 2048 bytes.
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
Sentencia SUMMARY Descripcin

La sentencia //SUMMARY define los requisitos para reunir la frecuencia de entrada de datos durante la supervisin. Como mnimo, los requisitos incluyen un intervalo definido y, si corresponde, claves de clasificacin definidas. La salida resultante para un grupo de atributos de resumen consiste en cualquier atributo de clave de clasificacin que se haya definido junto con seis atributos de resumen reservados: _LocalTimeStamp, _Date_Time, _Interval_Unit, _Interval, _Interval_Unit_Name, y _Occurrences. Otros atributos definidos en el grupo de atributos de resumen sin la designacin de la clave de clasificacin no forman parte del espacio de trabajo de salida. El resumen de ocurrencias de datos es especialmente til en los casos en que la frecuencia de la entrada es ms importante que los detalles de los datos de entrada. Por ejemplo, cuando Tivoli Universal Agent est supervisando las alertas recibidas desde un dispositivo, todas las alertas tendrn su importancia. No obstante, es el nmero total de alertas recibidas en un periodo de tiempo es que puede indicar tendencias o problemas. Es til utilizar las opciones de filtrado, Aceptar filtros o Rechazar filtros, para limitar el mbito de la resumen. El resumen tiene lugar despus de filtrar los datos de entrada. El grupo de atributos de resumen debe incluir el atributo LocalTimeStamp. Si los datos de aplicacin no incluyen este atributo, podr aadirlo especificando el parmetro AddTimeStamp en la sentencia //NAME. En caso contrario, Tivoli Universal Agent inserta automticamente un atributo LocalTimeStamp durante el tiempo de ejecucin. El valor del atributo LocalTimeStamp y el intervalo definido en la sentencia //SUMMARY activan el proceso de resumen. Los atributos que no estn definidos como claves de clasificacin de resumen no se incluyen en la salida. Esto no quiere decir, sin embargo, que los atributos de aplicacin de detalles no estn disponibles en un metarchivo que incluye un grupo de atributos de resumen. En un metarchivo individual, puede definir una combinacin de grupos de atributos de resumen y no resumen. Por ejemplo, podra definir un grupo de atributos, con o sin filtros, para la supervisin detallada de los datos de aplicacin. Y a continuacin, puede redirigir dichos datos de aplicacin a uno o ms grupos de atributos en el metarchivo para el resumen. Slo se permite una sentencia //SUMMARY por cada sentencia //NAME. Esta sentencia se entra despus de la sentencia //NAME y antes de la sentencia //ATTRIBUTES.
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
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
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
SKEY=2 DLM=- SKEY=1 +FILTER={NUMBER>=(0,400)}
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.
Nmero total de un intervalo de resumen

Los datos de aplicacin incluyen frecuentemente campos de nmeros totales como el nmero de sucesos, nmero de procesos y bytes enviados o recibidos. Es muy til mostrar el resultado del nmero total de un intervalo de resumen. Puede sumar cualquier campo de atributo numrico especificando el parmetro clave SKEY=SUM.
//SUMMARY [intervalo] [Force] nombre-atributo tipo-atributo tamao-mximo SKEY=SUM
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.
Creacin de nuevos atributos

Los atributos derivados permiten crear atributos nuevos basados en los atributos definidos existentes, incluidos los atributos de resumen reservados. Puede utilizar los siguientes atributos para crear atributos derivados: _Occurrences El nmero rotal de resumen _Interval_Unit El intervalo de resumen definido Resultado del resumen del atributo numrico Un atributo numrico definido con SKEY=SUM Por ejemplo, a continuacin se muestran dos definiciones de atributos en un grupo de atributos de resumen:
ErrorCount C 999999 Average_Errors (_Occurrences / ErrorCount)
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
La palabra clave especial NONE indica que no se utilizar ningn delimitador:

//ATTRIBUTES
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
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
Apndice B. Definiciones de atributos

Este apndice contiene la descripcin, la sintaxis y los parmetros de las definiciones de atributos que se utilizan para crear un metarchivo de definicin de datos. Explora las caractersticas de definiciones de atributos que pueden mejorar el rendimiento, mejorar la utilizacin y crear informacin ms significativa a partir de los datos de entrada suministrados a la aplicacin de metarchivo. Adems, en este apndice se describen las caractersticas de definicin de atributos especiales que se utilizan para derivar y filtrar atributos.
Definicin de atributos Descripcin

Todas las definiciones de atributos deben especificar un mnimo de tres parmetros: el nombre de atributo, el tipo de atributo y el tamao mximo del atributo. (Los atributos derivados son una excepcin y utilizan un formato diferente. Consulte Derivacin de atributos en la pgina 179 para obtener ms informacin). Adems de los tres parmetros necesarios, tambin hay muchos parmetros opcionales que pueden ofrecer funcionalidad y valor aadidos a las definiciones de atributos. En un grupo de atributos individual, puede haber un mximo de 127 definiciones de atributos. Tenga en cuenta que tambin hay un atributo reservado, denominado Node_Name, que Universal Agent genera automticamente como el primer atributo en cada grupo de atributos.
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.
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
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
Deltas precalculados por la aplicacin medidos durante un determinado periodo de tiempo.
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
175
Date_Time DL 20 Time_Zone D 5 Transaction D 256 TransactionSize C 999999
no pueden analizar correctamente el siguiente registro de muestra:

JohnDoe [01/Sep/2005:02:06:31 -0700] GET /ITM05.html 5914
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.
Exploracin de las caractersticas de los atributos

A continuacin, se indican algunas otras caractersticas de atributos que hay que tener en cuenta: v Duplicacin de atributos v Atributos invisibles v Truncamiento por la izquierda/derecha
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.
Truncamiento por la izquierda de atributos de visualizacin

De forma predeterminada, un atributo de carcter de tipo de visualizacin cuyo tamao de datos supera el tamao de los datos definido se trunca por la derecha. Por ejemplo, un valor de datos de atributo de ABCDEFGHIJK para la definicin de atributo
TestName D 8
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
resulta en un valor de datos de DEFGHIJK.
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.
Atributos derivados incorporados como nmeros reales

Los atributos derivados a menudo son ms tiles si se visualizan como nmero reales que como enteros. Por ejemplo, los atributos derivados como RequestsPerSecond o BytesTransferPerSecond pueden dar lugar a nmeros demasiado pequeos para que se puedan mostrar como enteros. Si slo se reciben 100 solicitudes en un intervalo de 3600 segundos, el resultado es 0.03. El nmero se redondea a cero para un atributo de entero. Para visualizar los valores de salida como nmeros reales, utilice el siguiente formato:
nombre-atributo REAL(derivar frmula de atributo)
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.
179
Concatenacin de cadenas de caracteres de atributos derivados

La caracterstica de atributos derivados dicta que los atributos de entrada deben ser atributos numricos. La excepcin a esta regla es la concatenacin de cadenas de caracteres. Ambos atributos de entrada son atributos de tipo carcter unidos por el operador ms (+).
nombre-atributo (atributo_carcter_1 + atributo_carcter_2)
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.
Funciones de atributos derivados

Las funciones de atributos derivados son funciones definidas de Tivoli Universal Agent que funcionan en valores de atributos de entrada y producen valores de atributos derivados. Las funciones de atributos derivados modifican o reformatean un atributo determinado para que su valor sea ms intuitivo para la visualizacin. Tambin hay una funcin que recupera el valor de una variable de entorno y almacena el valor en el atributo especificado.
nombre-atributo (funcin = de nombre_atributo_derivado)
La siguiente tabla contiene descripciones de las funciones de atributos derivados.

Tabla 26. Descripciones de funciones de atributos derivados Nombre de funcin ipAddressToName Descripcin Convierte la direccin IP en formato decimal al nombre de host. Si no es posible resolver la direccin, el nombre de host mostrado es la direccin IP decimal de entrada. Tipo de entrada Visualizacin
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
NetWareTimeToText UTCtoLocalTime UTCtoGMT GetEnvValue TivoliLogTime
El siguiente ejemplo incluye funciones de atributos derivados:
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}
estn soportados. El siguiente ejemplo no est soportado:

nombre-atributo tipo tamao +FILTER={filter1 OR 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
En la siguiente tabla se resumen las caractersticas de las diversas funciones de filtro.

Tabla 27. Caractersticas de funciones de filtro Funcin SCAN Descripcin Tipo de atributos Desplazamiento de datos 0<tamao mx. Valor de filtro Caracteres
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
A,C,G,?, #,% A,C,G,?, #,% A,C,G,?, #,%
0 0 0 0 0
Numrico Numrico Numrico Numrico Numrico
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
Date D 4 Time D 8 Message Z
256 +FILTER={SCAN(0,Procesando inicio de sesin) OR SCAN(0,PRIMER INICIO DE SESIN)}
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
256 32 12 12 256 -FILTER={MATCH(0,-)} 256
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
Utilizacin de expresiones regulares en filtros

El lenguaje de metarchivo de Tivoli Universal Agent incluye su propio mtodo patentado de coincidencia de patrones cuando se filtran valores de atributos, que pueden manejar la mayora de requisitos de filtrado. Pero en los casos en los que necesita realizar exploraciones de subcadenas de caracteres ms sofisticadas, y operaciones de bsqueda y sustitucin que no sean posibles de otra manera, tambin puede especificar patrones de expresiones regulares en los filtros de atributos mediante el uso de las funciones de filtro MATCHREGEX y SCANREGEX. Estas dos funciones de filtro tambin dan soporte a parmetros opcionales REPLACEFIRST y REPLACEALL, en las que se puede especificar una cadena caracteres de sustitucin para todo o parte del valor de atributo de patrn coincidente. Tivoli Universal Agent ofrece soporte para filtro de expresiones regulares utilizando las bibliotecas de International Components for Unicode (ICU). Ms especficamente, las bibliotecas de ICU realizan las siguientes funciones: 1. Compilar y comprobar la sintaxis del patrn de expresiones regulares suministrado en el metarchivo. 2. Determinar en tiempo de ejecucin si el valor de atributo que se est examinando coincide con el patrn especificado. Puede combinar filtros de expresiones regulares y no regulares en la misma definicin de atributo. El filtrado basado en expresiones regulares est disponible para todos los proveedores de datos porque el filtrado de atributos es comn a todos los tipos de metarchivos.
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
Y que desea que este valor se visualiza en el espacio de trabajo como:

185
Process ABC abended on SYSTEMX
Puede codificar la definicin de atributo del modo siguiente:

Message Z 256 +FILTER={SCANREGEX(0,(MSG199.*?) (SYSTEM.).*?(Process.*$)),REPLACEFIRST($3 abended on $2)}
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"
dst="\\matrix26\temp\RealTimeBackup\Matrix34\BackupAdmin\Reports\2006-01-18_16.14.03_BackupErr.xml" size="274" priority="3" time="1137622511" ID="568809902500042513"/>
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.
Secuenciado de definiciones de atributos

De forma predeterminada, la secuencia en la que los atributos se listan debajo de la sentencia //ATTRIBUTES del metarchivo es la misma secuencia que la que Tivoli Universal Agent utiliza cuando define la aplicacin ante otros componentes de IBM Tivoli Monitoring, en especial ante el servidor de supervisin y el servidor del portal. Si la secuencia del atributo cambia en un grupo de atributos existente; por ejemplo, se insertan uno o ms atributos en medio, Tivoli Universal Agent debe asignar un nuevo nmero de versin principal a la aplicacin para que se les notifique al servidor de supervisin y al servidor del portal que la aplicacin ha cambiado significativamente.
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
Podra codificar las definiciones de atributos del modo siguiente:

//ATTRIBUTES ; Attr1 D 8 Attr2 D 16 Attr3 D 4 Attr4 Z 128
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
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
Nueva definicin de datos de aplicacin:

//APPL DTY //NAME ConsoleMessage e //ATTRIBUTEs ; MessageOrigin D 80
SEQ=5
188
MessageID MessageSeverity MessageCategory MessageAction MessageStatus MessageDescription
D C C D D Z
12 SEQ=1 99 SEQ=2 99 SEQ=3 80 16 255 SEQ=4
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
Apndice C. Atributos de SNMP

Este apndice presenta informacin sobre los atributos definidos en las aplicaciones de Tivoli Universal Agent soportadas por el proveedor de datos de SNMP. Trata sobre cmo las variables MIB se correlacionan con atributos de IBM Tivoli Monitoring, cmo se denominan los grupos de atributos y cmo se determinan las caractersticas de los atributos. Tambin proporciona descripciones de los atributos en los siete grupos de atributos asociados con la aplicacin SNMP-MANAGER.
Acerca de los atributos y los grupos de atributos

Los atributos se utilizan para crear situaciones que definan reglas para la supervisin de alertas y excepciones. Por ejemplo, puede crear situaciones que supervisen alertas de una gravedad especfica o desde un dispositivo determinado. Cuando los valores de los atributos de alertas enviados al servidor de Tivoli Enterprise Monitoring coinciden con los valores especificados en situaciones, los objetos gestionados asociados con las situaciones cambian su aspecto, alertando sobre problemas o cualquier accin iniciadas en asociacin con aplicaciones.
Correlacin de variables MIB con atributos

El proceso de convertir variables MIB en grupos de atributos de Tivoli Universal Agent consiste en descender por el rbol OID en busca de una MIB, comenzando por un nombre de objeto MIB especificado. Se crea un nuevo grupo de atributos para cada nuevo grupo de variables escalares encontradas y uno para cada nueva tabla conceptual. Cada vez que se crea un nuevo grupo de atributos, todas las variables MIB dentro del mismo mbito del grupo se definen como atributos dentro del grupo.
Denominacin de grupos de atributos

Los nombres de los grupos de atributos tienen el formato
AAANNNVV
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
Determinacin de las caractersticas de los atributos

IBM Tivoli Monitoring reconoce slo dos tipos de datos: entero y carcter. El proceso de conversin de MIB a metarchivo de Tivoli convierte tipos ASN.1 a enteros o caracteres y tambin define los tamaos de atributo mximos en el metarchivo generado. En la Tabla 28 se muestran los tipos ASN.1, definidos en la especificacin SMIV1 y los tipos de IBM Tivoli Monitoring correspondientes.
Tabla 28. Tabla de conversin de ASN.1 a tipos de IBM Tivoli Monitoring Tipo ASN.1 INTEGER Definicin INTEGER (-2147483648..2147483647) INTEGER (0..4294967295) Tipo de IBM Tivoli Monitoring INTEGER (-2147483648..2147483647) INTEGER (0..2147483647)
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
ENUM TimeTicks Gauge Counter IpAddress
NetworkAddress Opaque
Matriz de caracteres de tamao 32 Matriz de caracteres de tamao 256
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.
Grupos de atributos MIB-2

La aplicacin MIB-2 consiste de 17 grupos de atributos: v ATTABLE v EGP v v v v v v v v v v v v v v EGPNEIGHTABLE GLOBALVARIABLES ICMP IFTABLE INTERFACE IP IPADDRTABLE IPNETTOMEDIATABLE IPROUTETABLE SNMP SYSTEM TCP TCPCONNTABLE UDP
v UDPTABLE
192
Dnde encontrar ms informacin acerca de los atributos MIB-2

Para obtener informacin sobre los atributos MIB-2, consulte la MIB RFC1213 correspondiente o vea las descripciones de atributos disponibles en el sistema de ayuda en lnea de Tivoli Universal Agent.
Grupos de atributos SNMP-MANAGER

La aplicacin SNMP-MANAGER consiste en siete grupos de atributos: v MANAGED-NODES v MIBNODATA v MIBSTATUS v NETSUMMARY v NETWORK v ROUTER v TRAP Los atributos en estos grupos se tratan en detalla en los siguientes apartados. Tenga en cuenta que esta informacin sirve de complemento de las descripciones de espacio de trabajo de SNMP-MANAGER que figuran en Espacios de trabajo de la aplicacin SNMP-MANAGER en la pgina 84.
193
Grupo de atributos MANAGED-NODES

Este grupo de atributos permite supervisar la informacin acerca de los nodos identificados en la lista de favoritos. Por ejemplo, quiz desee crear una situacin que le notifique siempre que uno de los dispositivos o hosts listados pase a estar fuera de lnea.
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
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
Grupo de atributos MIBNODATA

Los atributos MIBNODATA identifican las tablas MIB de las cuales los agentes de supervisin no devuelven datos.
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
Node_Name
Nombre de nodo del sistema gestionado.
Entradas vlidas
196
Grupo de atributos MIBSTATUS

Los atributos MIBSTATUS permiten supervisar el estatus de las MIB, grupos de atributos y agentes para los que est recopilando datos.
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
Grupo de atributos NETSUMMARY

Los atributos del grupo de atributos NETSUMMARY proporcionan informacin de alto nivel para todas las redes de la empresa.
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
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
Grupo de atributos NETWORK

El grupo de atributos NETWORK contiene atributos relativos a la topologa de red.
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
Name
El nombre asignado a este nodo
Entradas vlidas
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
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
Grupo de atributos ROUTER

El grupo de atributos ROUTER contiene informacin relativa a los direccionadores en la empresa.
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
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
Router_Name
El nombre asignado a este direccionador
Entradas vlidas
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
El direccionador es un daemon y no est participando de forma activa en la operacin de la red.
203
Grupo de atributos TRAP

El grupo de atributos TRAP describe toda la informacin conocida acerca de las condiciones de excepcin recibidas por el proveedor de datos de SNMP. La mayora de los valores de los atributos en este grupo pueden definirse en el archivo de configuracin de condiciones de excepcin. Consulte el Apndice E, Configuracin de condiciones de excepcin de SNMP, en la pgina 229 para obtener ms informacin.
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
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
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
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
Severity
La gravedad de la condicin de excepcin como se define en el archivo de configuracin de condiciones de excepcin
Entradas vlidas
Source_Name
El nombre de host o direccin IP del agente de SNMP que ha enviado la condicin de excepcin
Entradas vlidas
Source_Status
Identifica un estatus con una fuente como se define en el archivo de configuracin de condiciones
Entradas vlidas
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
205
Entradas vlidas
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
Apndice D. Mandatos de consola

Este apndice contiene descripciones y sintaxis de los mandatos de consola que puede utilizar con los proveedores de datos de Tivoli Universal Agent.
Utilizacin de mandatos de consola

La interfaz de mandatos de consola permite controlar dinmicamente la configuracin operativa de un sistema Tivoli Universal Agent. Este servicio es particularmente til ya que permite que Tivoli Universal Agent d soporte a aplicaciones sin interrupcin cuando nuevas aplicaciones pasan a estar en lnea o cambian los atributos. La interfaz se invoca utilizando el programa KUMPCON. Adems, tambin existe la posibilidad de emitir mandatos de consola desde Tivoli Enterprise Portal. Para emitir mandatos desde Tivoli Enterprise Portal, pulse con el botn derecho del botn en un sistema gestionado de Tivoli Universal Agent, y seleccione la opcin Actuacin... . Para obtener ms informacin acerca de los mandatos de actuacin, consulte la publicacin Tivoli Enterprise Portal Administrators Guide o la ayuda en lnea de Tivoli Universal Agent. Los mandatos de consola se resumen en la Tabla 29 en la pgina 209 y se describen con mayor detalle en los siguientes apartados. Los mandatos disponibles mediante Actuacin estn marcados con un asterisco (*).
Invocacin de la interfaz de mandatos de consola en el sistema operativo Windows

Los mandatos de consola se invocan desde la lnea de mandatos mediante el programa KUMPCON:
mandato KUMPCON [parmetro]
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.
Invocacin de la interfaz de mandatos de consola en los sistemas operativos UNIX

En sistemas operativos UNIX, no es posible ejecutar el programa KUMPCON directamente. En su lugar, utilice el script de shell um_console, que sirve como contenedor para KUMPCON. El script um_console establece las variables de entorno correctas para que KUMPCON pueda encontrar las bibliotecas compartidas, los paquetes de recursos y otros archivos que necesita para ejecutar correctamente. En los sistemas operativos UNIX, escriba el siguiente mandato:
um_console -h <dir_instalacin>
Nota: El parmetro -h es necesario si no ha establecido la variable de entorno <dir_instalacin> con anterioridad.
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>
Especificacin de nombres de metarchivo y de aplicacin en los mandatos

Cuando se especifica un metarchivo, deber utilizar exactamente el mismo nombre utilizado cuando se defini dicho metarchivo por primera vez en Tivoli Universal Agent. Por ejemplo, si se ha importado un metarchivo en Tivoli Universal Agent utilizando su nombre calificado al completo, deber utilizar el nombre calificado al completo en los otros mandatos de consola. Y de forma inversa, si se ha definido un metarchivo en Tivoli Universal Agent utilizando un nombre no calificado, deber utilizarse dicho nombre no calificado en el resto de mandatos. Algunos mandatos de consola aceptan el nombre de aplicacin de Tivoli Universal Agent como parmetro de entrada en lugar del nombre de metarchivo. En dichos casos, el nombre de la aplicacin es sensible a maysculas y minsculas y debe coincidir exactamente con el nombre de la aplicacin especificada en la sentencia APPL en el metarchivo. Si ha creado subdirectorios en el directorio de trabajo, puede realizar la referencia a un metarchivo o a una aplicacin utilizando una va de acceso relativa:
kumpcon import .\SNMP\standard\RFC1213_mib-2.mdl
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"
Sistemas de varias interfaces

Si ejecuta kumpcon en un sistema con varias interfaces y ha configurado Tivoli Universal Agent para utilizar una interfaz en particular mediante la variable de entorno KUM_DCH_HOST_NAME, necesitar establecer la variable de entorno KUMP_API_DPAPI_HOST con el mismo valor si est enviando mandatos al proveedor de datos de ASFS o de servidor de API.
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
Envo de mandatos de consola a una instancia de Tivoli Universal Agent alternativa

La interfaz de la consola de mandatos de un Tivoli Universal Agent no primario requiere que se especifique la variable de entorno KUMP_DPCONSOLE_PORT para tener como destino el Tivoli Universal Agent correcto. De forma predeterminada, el Tivoli Universal Agent de destino es el primario y utiliza el puerto de consola 7700. Para impedir que emita parmetros de forma accidental para un Tivoli Universal Agent equivocado cuando se est accediendo a una instancia alternativa de Tivoli Universal Agent mediante la interfaz de consola, el Nombre de instancia aparece junto a cada proveedor de datos en el indicador para introducir el proveedor de datos de destino. La siguiente captura de pantalla muestra cmo al configurar KUMP_DPCONSOLE_PORT en 8700 se provoca que los proveedores de datos TEST aparezcan listados para que se sepa a qu instancia de Tivoli Universal Agent se est accediendo. Puede determinar el puerto correcto de escucha de la consola a utilizar comprobando el espacio de trabajo UAGENT DPLOG.
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
SHOW SHUTDOWN* TRAPCNFG* UNPACK
VALIDATE
* Estos mandatos tambin estn disponibles utilizando una seleccin de actuacin.
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
Figura 13. Ejemplo de KUMPCON GENERATE (en ingls)
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
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
218
MNL ADD NODE

Aade un recurso de red a la lista de nodos gestionados.
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
MNL REMOVE NODE

Elimina un recurso de red de una lista de nodos gestionados.
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
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
Apndice E. Configuracin de condiciones de excepcin de SNMP

Este apndice documenta el archivo de configuracin que el Proveedor de datos de SNMP utiliza para representar informacin de condiciones de excepcin en un formato de lectura ms sencilla y para asignar categoras, niveles de gravedad, estatus e ID de fuente a las condiciones de excepcin. Tambin contiene instrucciones para la modificacin del archivo predeterminado o su sustitucin por un archivo de configuracin propio.
El archivo de configuracin de condiciones de excepcin de SNMP, trapcnfg

Durante el arranque, el Proveedor de datos de SNMP lee un archivo de configuracin denominado trapcnfg. Uno de los propsitos de este archivo es convertir la informacin de condiciones de excepcin de SNMP en un formato ms legible. Otro es asignar categoras, niveles de gravedad e ID de fuente a condiciones de excepcin especficas, ya que estas no estn definidas por SNMP. Es posible modificar el archivo trapcnfg para ajustarlo a las necesidades especficas del sitio aadiendo nuevas condiciones de excepcin o definiciones de empresa o bien cambiando las ya existentes. Tambin puede utilizar su propio archivo de configuracin. Si la base de informacin MIB en la que se basa un metarchivo de SNMP contiene definiciones de condiciones de excepcin, tambin se distribuir junto con el metarchivo MIB un archivo denominado trapcnfg_Nombremib, donde Nombremib es el nombre MIB de la empresa. El propsito de estos archivos trapcnfg_Nombremib es ayudarle a construir el archivo trapcnfg. En ellos encontrar registros de definiciones empresariales y de condiciones de excepcin que podr copiar y pegar en el archivo de configuracin de condiciones de excepcin oficial.
Ubicacin del archivo de configuracin

Es posible colocar el archivo de configuracin de condiciones de excepcin donde desee. El Proveedor de datos de SNMP determina la ubicacin del archivo de la siguiente manera: si la variable de entorno KUMP_SNMP_TRAPCNFG_FILE est establecida, el proveedor de datos busca el archivo especificado en la ubicacin del directorio especificado. Si esta variable no est establecida, el proveedor de datos busca trapcnfg en el directorio de trabajo especificado en KUM_WORK_PATH.
Utilizacin del archivo trapd.conf de HP OpenView

El archivo trapcnfg tiene un formato muy similar, pero no idntico, al archivo de configuracin de condiciones de excepcin de HP OpenView Network Node Manager (trapd.conf), por lo que es posible copiar el archivo OpenView y reutilizar muchas de las sentencias de definicin, si es necesario. Para utilizar trapd.conf como base del archivo de configuracin, utilice KUMP_SNMP_TRAPCNFG_FILE. Por ejemplo:
KUMP_SNMP_TRAPCNFG_FILE=C:\ibm\itm\tmaitm6\work\trapd.conf
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
Figura 14. Ejemplos de tipos de registros de configuracin 2 y 3
231
Valores predeterminados del archivo trapcnfg

Las tablas de este apartado indican los valores predeterminados soportados por el Proveedor de datos de SNMP.
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
Modificacin del archivo trapcnfg

Puede aadir registros de definicin de empresa o de condiciones de excepcin a trapcnfg para ajustarse a sus necesidades de supervisin. Tambin puede modificar los registros existentes. Para ilustrar el proceso de fusin de las definiciones de condiciones de excepcin de un archivo trapcnfg_mibName con el archivo trapcnfg de Tivoli Universal Agent, se suministra un ejemplo de un pequeo archivo trapcnfg_mibName que se gener durante el proceso de conversin de MIB:
naiAntiVirus {1.3.6.1.4.1.3401} naiAntiVirusTrap {1.3.6.1.4.1.3401} 6 1 A 1 0 "Sucesos de estatus" SDESC La informacin de alarma NAI AntiVirus se muestra en el atributo Value_List. EDESC
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
Modificacin de las definiciones predeterminadas

Las definiciones predeterminadas se listan como comentarios en trapcnfg. Para modificarlas, suprima la seal de comentario (#) y cambie los valores.
Mandato de consola TRAPCNFG

La interfaz de consola de Tivoli Universal Agent, kumpcon en Windows y um_console en UNIX, acepta un argumento de TRAPCNFG que ordena al Proveedor de datos de SNMP que vuelva a cargar el archivo trapcnfg, teniendo en cuenta los cambios.
234
Apndice F. Expresiones regulares ICU

El siguiente apndice se ha extrado de la publicacin ICU User Guide. Este apndice describe las caractersticas especficas de la implementacin de expresiones regulares ICU. Esta informacin es esencial si utiliza la funcin de expresin regular de Tivoli Universal Agent porque los diferentes lenguajes de programacin implementan expresiones regulares de forma ligeramente distinta.
Tabla 34. Metacaracteres de expresiones regulares Carcter \a \A Descripcin Coincidencia con un BELL, \u0007. Coincidencia al principio de la entrada. Difiere de ^ en el sentido de que \A no coincide despus de una lnea nueva dentro de la entrada. Coincidencia si la posicin actual es un lmite de palabra. Los lmites se producen en las transiciones entre caracteres de palabra (\w) y no palabra (\W), omitiendo las marcas de combinacin. Para obtener ms informacin sobre los lmites de palabras, vea ICU Boundary Analysis. Coincidencia con un carcter de retroceso, BACKSPACE, \u0008. Coincidencia si la posicin actual no es un lmite de palabra. Coincidencia con un carcter de control-X. Coincidencia con cualquier carcter con la categora general Unicode de Nd (Nmero, dgito decimal). Coincidencia con cualquier carcter que no sea un dgito decimal. Coincidencia con un carcter ESCAPE, \u001B. Termina una sentencia \Q ... \E entre comillas. Coincidencia con un carcter de salto de pgina, FORM FEED, \u000C. Coincidencia si la posicin actual est al final de la coincidencia anterior. Coincidencia con un carcter de salto de lnea, LINE FEED, \u000A. Coincidencia con el carcter citado. Coincidencia con cualquier carcter con la propiedad Unicode especificada. Coincidencia con cualquier carcter que no tenga la propiedad Unicode especificada. Coloca comillas entre los siguientes caracteres, hasta \E. Coincidencia con un carcter de retorno de carro, CARRIAGE RETURN, \u000D. Coincidencia con un carcter de espacio en blanco. El espacio en blanco se define como [\t\n\f\r\p{Z}]. Coincidencia con un carcter que no es un espacio en blanco.
\b, fuera de un [Set]
\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.
++ ?+ {n}+ {n,}+ {n,m}+ ( ... )
(?: ... )
(?> ... )
(?# ... ) (?= ... )
(?! ... )
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
Apndice G. Referencia de variables de entorno

Este apndice documenta las variables de entorno de Tivoli Universal Agent y de sus proveedores de datos.
Tivoli Universal Agent y las variables de entorno del proveedor de datos

Las variables de entorno de Tivoli Universal Agent y sus proveedores de datos permiten alterar temporalmente los valores de ubicacin, puertos, directorios de trabajo y semejantes. En la siguiente tabla se describen las variables de entorno de Tivoli Universal Agent, as como cada uno de los proveedores de datos.
Tabla 38. Variables de entorno de Tivoli Universal Agent Variable de entorno KUM_WORK_PATH Descripcin Establece el directorio de trabajo predeterminado para Tivoli Universal Agent. Valor predeterminado Ejemplo
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
KUMA_STARTUP_DP KUMA_REPORT_REQUEST_ EXPIRATION
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
directorio de trabajo /Tivoli/ MiConfig
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
/home/ metafiles/ test
KUMP_META_SERVER
Sin servidor de metarchivos
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
KUMP_API_VERBOSE Proveedor de datos de socket KUMP_DP_PORT
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
Consulte Proveedor de datos de envo en la pgina 60
Consulte Proveedor de datos de envo en la pgina 60
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
Proveedor de datos de SNMP - Descubrimiento de red
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
KUMP_SNMP_CHECK_ CONFIG_INTERVAL KUMP_SNMP_USE_ICMPD
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.
Proveedor de datos de SNMP - Gestin de condiciones de excepcin
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
Admin como ID de usuario, tivoli como contrasea
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.
Actualizacin a la versin 6.2.0 de Tivoli Universal Agent

La actualizacin a Tivoli Universal Agent, versin 6.2.0 desde una versin anterior es un proceso sencillo. Debe tener en cuenta lo siguiente: v Todos los metarchivos de Universal y archivos de trabajo de configuracin de Universal Agent existentes son reutilizables, tal cual estn, en Tivoli Universal Agent, V6.2. v No existen programas de utilidad de actualizacin o herramientas especiales de conversin que tenga que ejecutar. v Una actualizacin en Tivoli Universal Agent, V6.2 requiere que se vuelva a compilar y a enlazar cualquier programa cliente de API C/C++ que se haya escrito. Actualice el entorno de desarrollo del programa cliente de API con el programa cliente de API UA620. Copie tambin la DLL de KUMPAPI de UA620 o la biblioteca compartida en el directorio o va de acceso donde se ejecuta el programa cliente. v Para la compatibilidad con versiones anteriores, las DLL y las bibliotecas compartidas de Tivoli Universal Agent cuyos nombres contengan un nmero de versin, como por ejemplo, kum0610.dll y libkump610.so, han conservado los mismos nombres en Tivoli Universal Agent V6.2. El binario principal de Universal Agent ha cambiado de kuma610 a kuma620, pero los nombres de las DLL y las bibliotecas compartidas siguen siendo los mismos en V6.2.
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
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
Apndice I. Inicio de proveedores de datos como procesos independientes

Este apndice est dirigido a aquellos usuarios avanzados que desean iniciar los proveedores de datos de Tivoli Universal Agent como procesos independientes.
Inicio de los proveedores de datos

En la mayora de casos de supervisin, los proveedores de datos se ejecutan como subprocesos de Tivoli Universal Agent. Esta es la modalidad predeterminada de funcionamiento. Simplifica la configuracin y reduce la incidencia de los problemas. No obstante, puede que algunos usuarios encuentren que es necesario ejecutar los proveedores de datos como procesos independientes y autnomos, y generalmente en hosts distintos de aquel donde se est ejecutando Tivoli Universal Agent. Esta tcnica es til si la recopilacin de datos debe producirse de alguna de las siguientes maneras: v fuera de un cortafuegos v en un sistema especial con recursos limitados v para supervisar un archivo o ejecutar un script en un sistema remoto Tivoli Universal Agent soporta la ejecucin de proveedores de datos como procesos independientes, pero debe establecer algunas variables de entorno adicionales y crear scripts o mandatos para la ejecucin de ejecutables del proveedor de datos.
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
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.
Conexin con Tivoli Universal Agent

Debe establecer las variables de entorno de modo que se conecte correctamente el proveedor de datos autnomo a Tivoli Universal Agent. De forma predeterminada, un proveedor de datos presupone que el Tivoli Universal Agent al que se est conectando se ejecuta en el host local. Para conectar el proveedor de datos autnomo a un sistema Tivoli Universal Agent que se ejecuta en otro lugar, deber establecer la variable de entorno KUMP_DCH_HOST en el nombre de host remoto correcto. En el siguiente ejemplo se conecta un proveedor de datos autnomo a un Tivoli Universal Agent que se ejecuta en un sistema denominado FIN1:
KUMP_DCH_HOST=FIN1
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
v El siguiente ejemplo se utiliza para controlar la gestin de seales de proceso:

KBB_SIG1=dumpoff -asyncoff
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
start /min kumpfile exit
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.
Detencin de los proveedores de datos

Para detener un proveedor de datos autnomo, puede terminar el script o el archivo .bat que ha iniciado el ejecutable del proveedor de datos. Como alternativa, puede invocar el mandato SHUTDOWN desde la ventana Actuacin o desde el programa de mandatos de consola, kumpcon en los sistemas operativos Windows y um_console en los sistemas operativos UNIX.
Apndice I. Inicio de proveedores de datos como procesos independientes
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.
Sistema gestionado fuera de lnea

Despus de terminar la conclusin del proveedor de datos, los sistemas gestionados activados por el proveedor de datos pasan a estar en gris en el Navigator de Tivoli Enterprise Portal para reflejar su estado fuera de lnea.
260
Apndice J. Determinacin de problemas

Este apndice est pensado para proporcionar consejos tiles sobre la resolucin de problemas que pueden ayudarle en la determinacin de problemas de Tivoli Universal Agent. Dada la gran capacidad de personalizacin de Tivoli Universal Agent, y dado que con sus proveedores de datos y con la funcin de emisor de SNMP combina mltiples agentes de Tivoli Monitoring en uno, este agente puede presentar ms de un reto de depuracin que otros agentes. Diferentes configuraciones de Tivoli Universal Agent influyen en la naturaleza del problema y en cmo debe actuar para analizarlo. Por ejemplo, a continuacin se muestran algunas preguntas tiles que le permiten tener una visin inicial de los problemas de Tivoli Universal Agent: v Qu proveedores de datos estn en ejecucin? v Qu tipos de metarchivos se han activado (Script, SNMP, ODBC, etc.)? v Qu funciones de metarchivo se estn utilizando? v El problema se produce para una instancia de Tivoli Universal Agent alternativa? v Est configurado Tivoli Universal Agent en un servidor de supervisin remoto o concentrador? v Qu tipo de datos se recopilan? v Tipo de datos de la aplicacin: Polled (Sondeado), Sampled (Muestreado), Keyed (Con clave) o Event (Suceso)? v Hay alguna variable de entorno de Tivoli Universal Agent especial vigente? v Se ha activado recientemente un metarchivo nuevo o cambiado? v El problema afecta a una interfaz de programacin personalizada para Tivoli Universal Agent? v Si es as, se ha modificado recientemente el cdigo fuente de script o del programa? El tipo de datos que se recopila, como salida de script, registros de archivos, variables MIB, etc., pueden indicarnos si el problema implica posiblemente el formateo o la disponibilidad de los datos. Instancias de Tivoli Universal Agent alternativas utilizan nmeros de puerto diferentes, que afectan a la interfaz de consola de Tivoli Universal Agent y a los puertos de escucha de socket y de API. Las instancias alternativas tambin utilizan diferentes nombres de archivos de configuracin, que tendrn un sufijo de nombre de instancia.
Rastreo de Tivoli Universal Agent

Tivoli Universal Agent utiliza el mismo recurso de rastreo RAS1 que otros componentes de Tivoli Monitoring 6.x. Los valores de rastreo de Tivoli Universal Agent se especifican en la variable de entorno KBB_RAS1 del archivo \TMAITM6\KUMENV en sistemas Windows y en el archivo $ITMinstall_dir/config/ um.ini en sistemas UNIX y Linux. De forma predeterminada, Tivoli Universal Agent utiliza rastreo RAS1 de nivel ERROR. Para obtener rastreo ms detallado, debe aadir generalmente uno o ms parmetros (UNIT:kxxx &opciones) al valor de la variable de entorno KBB_RAS1, por ejemplo:
KBB_RAS1=ERROR (UNIT:kumamain ALL) (UNIT:kumpdpda Error Output)
Tivoli Universal Agent soporta adems varias variables de entorno de depuracin especiales para rastrear un proveedor de datos o componente particular.
Valores de depuracin especiales

La variable de entorno KUMP_SCRIPT_DEBUG=Y le ahorra tener que entrar mltiples parmetros (UNIT:kxxx &opciones) a la hora de diagnosticar un problema de proveedor de datos Script. Con KUMP_SCRIPT_DEBUG=Y, todos los aspectos de ejecucin de scripts, entre ellos el anlisis de
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
Para diagnosticar un problema de recopilacin de datos MIB, especifique:

KUMP_SNMP_DEBUG_MIB_MANAGER=Y KUMP_SNMP_DEBUG_MIB_IO=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
Espacio de trabajo DPLOG

El espacio de trabajo UAGENT DPLOG tiene informacin de estatus til sobre la salud y el estado de un proveedor de datos, y a veces un problema de Tivoli Universal Agent se puede diagnosticar rpidamente examinando simplemente el espacio de trabajo DPLOG. La columna DP_Log_Text en DPLOG tiene mensajes informativos, de aviso y de error sobre los principales sucesos en la vida de un proveedor de datos, tales como: v si un metarchivo se ha validado correctamente v si un metarchivo no se ha podido validar (lo que significa que la aplicacin no aparecer en lnea) v si una fuente de datos estaba disponible durante el arranque v qu puertos de consola y puertos de escucha de sockets se han utilizado o no estaban disponibles v cundo se ha iniciado y parado una supervisin de un script, un archivo, un URL, una aplicacin MIB SNMP o una fuente de datos ODBC v cundo la supervisin ha pasado de un archivo a otro v cundo un script ha finalizado con un cdigo de retorno que no es cero v cundo se ha conectado y desconectado un programa cliente de API o de socket Algunas acciones dirigidas por mandato, como operaciones de renovacin del metarchivo, tambin se registran en DPLOG. DPLOG es una tabla de sucesos puros, lo que significa que slo guarda las 100 filas de datos ms recientes (a menos que se alteren temporalmente mediante KUMA_MAX_EVENT_ENTRIES). Por consiguiente, es posible que no pueda ver mensajes DPLOG anteriores si ya se han desplazado. Existe un espacio de trabajo DPLOG independiente para cada proveedor de datos. Si activa cuatro proveedores de datos y se est produciendo un problema, por ejemplo con la recepcin de la interrupcin SNMP, examine el navegador del portal en &localhost&SNMPdp:UAGENT00, y examine los mensaje en el DPLO particular.
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.
Espacio de trabajo ACTION

Siempre que se emite un mandato de Actuacin o se activa una Accin refleja, se aade una fila de datos al espacio de trabajo UAGENT ACTION. La tabla ACTION es Con clave y sus filas tienen un valor de tiempo de vida (TTL) de 30 minutos. A diferencia de DPLOG, que es especfico del DP, la tabla ACTION la comparten todos los DP. Si est ejecutando varios DP, el espacio de trabajo ACTION debajo de cada aplicacin UAGENT tiene las mismas filas de datos. La columna Action_Result se actualiza con el xito o la anomala de una accin refleja, una poltica o un mandato de Actuacin. La columna Action_Result es un buen lugar para comprobar si desea conocer qu ha sucedido en una accin refleja determinada o un mandato de Actuacin. Por ejemplo: Ha emitido un mandato de Actuacin > Monitor Start para iniciar la recopilacin de datos MIB, pero el espacio de trabajo de la aplicacin SNMP est vaco. Compruebe el espacio de trabajo ACTION para ver si se ha producido un error en el mandato Monitor Start. Consulte el apartado Espacios de trabajo UAGENT en la pgina 117 para obtener ms informacin.
Recopilacin de la documentacin correcta

La informacin de determinacin bsica de problemas incluye lo siguiente: descripcin del problema, permanente o intermitente, el nivel de versin/compilacin/fixpack de Tivoli Universal Agent, la plataforma y el nivel de SO donde se ejecutaba Tivoli Universal Agent. La indicacin de la hora del componente Tivoli Universal Agent y el nivel de compilacin se pueden encontrar cerca de la parte superior del registro RAS1:
+454F4EBB.0001 Component: +454F4EBB.0001 Driver: +454F4EBB.0001 Timestamp: +454F4EBB.0001 Target: -----> KUM610 5/5/06 DP type kum d6173a/3647132.25 Jun 22 2006 18:51:10 wv7i386 ASFS product Universal Agent <----
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.
Lectura del registro de Tivoli Universal Agent

Igual que el espacio de trabajo DPLOG contiene sucesos importantes en el ciclo de vida de Tivoli Universal Agent, el registro RAS1 de Tivoli Universal Agent tambin. Hay muchos mensajes de rastreo RAS1 de nivel ERROR que pueden ayudar a resolver un problema en Tivoli Universal Agent sin tener siempre que reproducir el problema con un rastreo detallado.
Qu hay que buscar

A continuacin, se muestran algunos mensajes RAS1 de Tivoli Universal Agent de un registro de Tivoli Monitoring 6.1 de un cliente. El problema es que Tivoli Universal Agent se cuelga poco despus de arrancar. Determinadas partes clave de informacin aparecen resaltadas en negrita para mostrar qu hay que buscar y cmo obtener un conocimiento rpido de un registro de Tivoli Universal Agent:
(4345879C.002C-1:kumamain.cpp,698,"UA_Main") Arranque de Universal Agent en proceso !43539976.0000!=================> Registro de servicio RAS1 de IBM Tivoli <=============== +43539976.0000 System Name: abcd1234 Process ID: 2172 +43539976.0000 Program Name: kuma610 Task Name: kuma610 +43539976.0000 System Type: SunOS;5.9 MAC1_ENV Macro: 0xA326 +43539976.0000 Start Date: 2005/10/17 Start Time: 14:30:46 +43539976.0000 AS Limit: None Core Limit: None +43539976.0000 CPU Limit: None Data Limit: None +43539976.0000 Fsize Limit: None Nofile Limit: 64K +43539976.0000 Stack Limit: 8M Service Point: abcd1234_um +43539976.0000 UTC Start Time: 43539976 ITM Home: /opt/IBM/ITM +43539976.0000 ITM Process: abcd1234_um +43539976.0000 Executable Name: /opt/IBM/ITM/sol286/um/bin/kuma610 +43539976.0000 KBB_RAS1: ERROR +43539976.0000 KBB_ENVPATH:
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.
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.
Reconocimiento de un registro incorrecto

Otro aspecto de una lectura eficaz de registro es ser capaz de reconocer cundo se dispone de un registro incompleto o incorrecto.
!454A059C.0000!===========> Registro de servicio RAS1 de IBM Tivoli <====================== +454A059C.0000 System Name: SWXYZ01 Process ID: 2460 +454A059C.0000 Program Name: kuma610 User Name: SYSTEM +454A059C.0000 Task Name: kuma610 System Type: Win2003;5.2-SP1 +454A059C.0000 MAC1_ENV Macro: 0xC112 Start Date: 2006/11/02 +454A059C.0000 Start Time: 09:50:04 CPU Count: 4 +454A059C.0000 Page Size: 4K Phys Memory: 2048M +454A059C.0000 Virt Memory: 2048M Page Space: 3948M +454A059C.0000 Service Point: system.swxyz01_um UTC Start Time: 454a059c +454A059C.0000 ITM Home: C:\IBM\ITM ITM Process: swxyz01_um +454A059C.0000 Executable Name: C:\IBM\ITM\TMAITM6\kuma610.exe +454A059C.0000 KBB_RAS1: ERROR: (UNIT:kumamain ALL) (UNIT:kump ALL) +454A059C.0000 KBB_RAS1_LOG: C:\IBM\ITM\logs\swxyz01_um_454a059c-.log +454A059C.0000 KBB_ENVPATH: C:\IBM\ITM\TMAITM6\KUMENV ========================================================================== (454A059C.0000-15B0:kumamain.cpp,749,"UA_Main") Arranque de Universal Agent en proceso (454A059E.0000-15B0:krabufwk.cpp,135,"CTIRA_Set_DefaultCodepage") Entorno local de IRA predeterminado en_US (454A059E.0001-15B0:krabufwk.cpp,144,"CTIRA_Set_DefaultCodepage") Pgina de cdigos de IRA predeterminada
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.
Categoras habituales de problemas

En este apartado se indican algunos casos de ejemplo de problemas de Tivoli Universal Agent tpicos para ayudar a comprender cmo se utiliza el rastreo disponible y los recursos de diagnsticos para resolver un problema.
Problemas de condiciones de excepcin de SNMP

Es importante comprender la diferencia entre los problemas de condicin de excepcin de SNMP de entrada y de salida. Tivoli Universal Agent es capaz tanto de enviar como de recibir condiciones de excepcin de SNMP, y dichas acciones se realizan utilizando componentes de Tivoli Universal Agent completamente diferentes; por lo tanto, siempre es bueno definir primero el tipo de problema de condicin de excepcin porque cada uno requiere un enfoque de diagnstico diferente. Si el problema est relacionado con la imposibilidad de recibir o visualizar correctamente una condicin de excepcin, el problema afecta a la funcin de receptor de condiciones de excepcin del proveedor de datos de SNMP y no a la funcin de emisor de SNMP. El emisor de SNMP slo pertenece a condiciones de excepcin de SNMP de salida. Las condiciones de excepcin de entrada requieren que el DP de SNMP se ejecute con la siguiente variable de entorno:
KUMP_SNMP_MONITOR_TRAP=Y
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
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
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:
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
A continuacin se muestra un ejemplo de registro detallado kumstrap:

44849629 44849629 44849629 44849629 44849629 44849629 4484963A 4484963A 4484963B ------------------------>>>>> >>>>> ----Tivoli Universal Agent SNMP trap listener daemon started Verbose output file is /opt/IBM/ITM/logs/kumstrap.log Opening default trap listening port 162 socket 5 opened and set to blocking IO socket 5 bound to 9.48.153.26[162] Listening for traps... RegisterTrapInterest received from DP at 9.48.153.26[64945] Sending acknowledgment to DP at 9.48.153.26[64945] Listening for traps...
Errores de inicio de Tivoli Universal Agent

En este apartado se describen los errores de inicio de Tivoli Universal Agent.
/opt/IBM/ITM/bin# ./itmcmd agent start um Iniciando el agente... No se ha podido iniciar el agente. Compruebe el archivo de registro.
Comprobacin del archivo de registro $hostname_um_&timestamp.log

Si Tivoli Universal Agent no consigue iniciarse, compruebe el ltimo archivo &hostname_um_ &timestamp.log en el directorio /logs. A continuacin se muestra un ejemplo de registro de una anomala de arranque:
(4345879E.0000-2:kum0sock.c,134,"KUM0_OpenLocalSocket") vinculacin errnea para la direccin local TCP socket 8, puerto=1919, nmero de error=125 (4345879E.0001-2:kumdsock.cpp,1059,"ipcSock::allocateDCHport") Error: No se han podido abrir los sockets TCP/UDP enlazados a Universal Agent DCH puerto 1919 (4345879E.0002-2:kumdsock.cpp,1060,"ipcSock::allocateDCHport") Determinar si otra copia de Universal Agent ya est activa en este sistema. Saliendo... (4345879E.0003-2:kumamain.cpp,357,"StopAgentProcess") El proceso de Universal Agent se est deteniendo
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.
Resolucin de problemas sobre el uso de puertos

Puede emitir el mandato netstat a para obtener informacin sobre el uso de puertos en el sistema local. Un mandato ps indica si hay otro proceso kuma620 activo en este sistema.
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 */
Consideraciones importantes sobre el cortafuegos

Si la ejecucin se realiza en un sistema con un cortafuegos instalado, deber configurar el cortafuegos de modo que permita que el sistema local (bucle de retorno o E/S de IP hacia la direccin IP de mquina local y desde sta) utilice la conectividad UDP. Como mnimo, se necesita el puerto UDP 1919, como puerto de escucha predeterminado. De lo contrario, el sistema se puede quedar atrapado en un bucle sin fin.
Resolucin de problemas de vinculacin

Un error de vinculacin con EADDRNOTAVAIL significa que el nombre de host local no se ha configurado, debido posiblemente a un error cometido en la especificacin de DCB0_HOSTNAME. Tivoli Universal Agent intenta vincular un socket de escucha con una direccin IP que no est disponible en el sistema local. Durante el arranque, Tivoli Universal Agent debe vincular varios sockets de escucha con puertos locales, incluido el puerto de DCH 1919. Si Tivoli Universal Agent se ha configurado para utilizar una direccin de host que no coincide con la direccin de host del sistema local, todas las llamadas de vinculacin de socket generarn errores de tipo direccin no disponible. En los sistemas UNIX, estos errores de vinculacin son probablemente el resultado de escribir un valor de host incorrecto en respuesta a la solicitud de configuracin:
Especifique el Nombre de red principal opcional o "ninguno" (El valor predeterminado es: ninguno):
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.
Ninguna salida en el espacio de trabajo de portal

Hay muchos tipos de problemas de tipo no hay salida en Tivoli Universal Agent. Como ejemplo, suponga que el sistema gestionado DM37X est en lnea pero no hay salida. En primer lugar, determine de qu tipo de problema no hay salida se trata: v Si las entradas xxxxx:DM37X00 en el portal Navigator no tienen un signo + situado junto a ellas, significa que no hay ninguna consulta para abrir y visualizar los datos del espacio de trabajo. Probablemente se trata de un problema de presentacin del servidor del portal. Compruebe si hay un archivo DM3ODI00 coincidente, no vaco, en el directorio \cnps o /cq/data y en el directorio \work de Tivoli Universal Agent. Es decir, determine si el servidor del portal conoce esta aplicacin Tivoli Universal Agent. v Las entradas xxxxx:DM37X00 tienen signos + y se pueden seleccionar, pero los espacios de trabajo estn completamente en blanco, incluso sin encabezados de columna, y se visualiza un error de solicitud KFWITM220E en el cliente del portal. Este problema se debe con toda probabilidad a que el servidor de supervisin concentrador no contiene los archivos DM3CAT00 y DM3ATR00 en los directorios RKDSCATL y ATTRLIB. v El error KFWITM220E para un espacio de trabajo de Tivoli Universal Agent suele significar que falta un archivo CAT o es incorrecto en el servidor de supervisin concentrador. Cuando se abre un espacio de trabajo de Tivoli Universal Agent o se produce una renovacin, el servidor del portal enva una sentencia SQL Select al servidor de supervisin concentrador para los atributos UA1, UA2, etctera. A menudo puede diagnosticar este tipo de problemas examinando el archivo de registro del servidor de supervisin concentrador:
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
Y posteriormente, se visualizan muchos mensajes parecidos a los siguientes:

-B6C:kumdchsv.cpp,1877,"DCHserver::dp_data") Error: attrType <?> attrName <Nombre_host> controlField <11> no forma parte de los atributos registrados. -B04:kumpdchc.c,311,"KUMP_DCHclientRoutine") *** dp_data errneo. Sincronizacin de DCH necesaria para SEptr @11E25EE8 tabla <BetaNumericScript> -B04:kumpdchc.c,669,"KUMP_DCHclientRoutine") >>>>>redirigiendo dp_data para sincronizar DCH para SEptr @11E25EE8 tabla <BetaNumericScript>
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.
Problemas en la interfaz de consola

Si el mandato Import de un metarchivo no hace que el sistema gestionado asociado se inserte en el rbol de Navigator, debern realizarse las siguientes comprobaciones: v Compruebe si el mandato Import ha emitido algn mensaje de error. Por ejemplo: D:\IBM\ITM\ TMAITM6> kumpcon import freespace.mdl KUMPS043E El mandato ha fallado. No se ha encontrado el metarchivo. v Compruebe si el mandato Import o Refresh ha fallado al conectarse a Tivoli Universal Agent. Por ejemplo, se visualiza el mensaje de error KUMPS005E No se puede conectar con el servidor de mandatos de consola en myhost[7700]. Las siguientes explicaciones de KUMPS005E son las ms habituales: Tivoli Universal Agent no est en ejecucin. Una instancia de Tivoli Universal Agent alternativa est ejecutndose, a la escucha en el puerto 8700 en lugar del valor predeterminado 7700. Si ste fuera el caso, establezca la variable de entorno KUMP_DPCONSOLE_PORT=8700 antes de emitir los mandatos de consola. Un cortafuegos est bloqueando la conexin de socket entre kumpcon y kuma620. Si todas las comunicaciones de puerto en el sistema requieren un permiso explcito, debe otorgarse acceso a kcumpcon al puerto de escucha del servidor de consola abierto por kuma620. La comunicacin de socket entre kumpcon y kuma620 utiliza un UDP regular y no ip:pipe, ip:spipe ni ningn otro mtodo suministrado por Tivoli Monitoring para pasar por los cortafuegos. Tivoli Universal Agent se ejecuta en un sistema multi-NIC y el servidor de mandatos de consola est a la escucha en una direccin IP no predeterminada. En dicho caso, debe utilizarse el mandato Set de consola para acceder a la direccin IP correcta. v Suponiendo que un metarchivo FILE DP se est importando, compruebe si el archivo de registro listado en la sentencia //SOURCE FILE existe en el directorio especificado. Para un metarchivo DP de SCRIPT, compruebe si el archivo de script listado en la sentencia //SOURCE SCRIPT existe. Si se especifica un archivo de script sin informacin de va de acceso, Tivoli Universal Agent presupone que est situado en el directorio \TMAITM6\scripts en los sistemas Windows o en $ITMinstall_dir/$ARCH/ um/scripts en los sistemas UNIX y Linux. v Compruebe si el nombre de va de acceso completo del archivo de registro o el archivo de script contiene blancos intercalados. En tal caso, el nombre debe ir entre comillas simples; por ejemplo, //Source Script Perl.exe C:\Archivos de programa\scripts\Monitor.pl arg1 arg2. Esta misma comilla simple es necesaria si se especifican el intrprete de scripts o envfile con nombres de vas de acceso que contienen blancos intercalados. v Compruebe si el metarchivo importado se ha aadido al archivo \work\KUMPCNFG. Actualizar KUMPCNFG es uno de los ltimos pasos de un mandato Import e indica hasta dnde ha avanzado el mandato Import. v Compruebe si se han subido los archivos aaaATR00, aaaCAT00 y aaaODI00 en los directorios del servidor del portal y del servidor de supervisin. Compruebe si estos tres archivos coinciden de tamao y fecha de las copias locales que Tivoli Universal Agent conserva en el directorio \work. Si no coinciden, podra haber un problema al subir un archivo. v Si la importacin o la renovacin se quedan atascadas en un bucle sin fin con varios mensajes de tipo Mandato en progreso..., compruebe si Tivoli Universal Agent sigue activo o se ha detenido. Si se ha detenido, compruebe si hay un archivo de imagen de memoria. Si Tivoli Universal Agent sigue activo, pero en un bucle sin fin, podra ser necesario que reprodujera los pasos con el rastreo de Tivoli Universal Agent detallado para sealar la causa del problema.
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.
Datos personalizados no resumidos

Especifique la opcin PRIMARYKEY para los campos clave con el fin de indicar al Agente de resumen y poda cmo distinguir entre varias instancias. La opcin siguiente se utiliza para designa un atributo clave:
OPTION{PRIMARYKEY=n}
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
Consulte el Apndice B, Definiciones de atributos, en la pgina 169.
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.
Desplazamiento por la interfaz mediante el teclado

El producto utiliza teclas de atajo y aceleradores estndar, que se encuentran documentados en el sistema operativo. Si desea obtener ms informacin, consulte la documentacin que proporciona su sistema operativo.
Ampliacin de lo que aparece en la pantalla

Puede ampliar la informacin de las ventanas del producto mediante los recursos que proporcionan los sistemas operativos en los que se ejecuta el producto. Por ejemplo, en un entorno de Microsoft Windows, puede reducir la resolucin de la pantalla para aumentar el tamao de los fonts del texto en pantalla. Si desea obtener ms informacin, consulte la documentacin que proporciona su sistema operativo.
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

620 Uausers

Caricato da

Informazioni sul documento

Titolo originale

Copyright

Formati disponibili

Condividi questo documento

Condividi o incorpora il documento

Opzioni di condivisione

Hai trovato utile questo documento?

Questo contenuto è inappropriato?

Copyright:

Formati disponibili

620 Uausers

Caricato da

Copyright:

Formati disponibili

Tivoli Universal Agent

Gua del usuario

Tivoli Universal Agent

Gua del usuario

Copyright IBM Corp. 2003, 2007

IBM Tivoli Universal Agent: Gua del usuario

46 49 49 50 51 51 51 51 53 56 56 56 57 57 59 60 60 61 61 61 62 62 . 63 . 64 . 64 . 64 . 66 . 66 . 67 . 67 . 67 . 69 . 70 . 70 . 71 . 71 . 71 . 72 . 74 . 74 . 74 . 75 . 76 . 77 . 78 . 78 . 80 . 100 . 101 . 102 . 102 . 102 . 102 . 103 . 108 . 108

IBM Tivoli Universal Agent: Gua del usuario

IBM Tivoli Universal Agent: Gua del usuario

IBM Tivoli Universal Agent: Gua del usuario

IBM Tivoli Universal Agent: Gua del usuario

Copyright IBM Corp. 2003, 2007

IBM Tivoli Universal Agent: Gua del usuario

Copyright IBM Corp. 2003, 2007

IBM Tivoli Universal Agent: Gua del usuario

Acerca de esta publicacin

Biblioteca de IBM Tivoli Monitoring

Copyright IBM Corp. 2003, 2007

IBM Tivoli Open Process Automation Library (OPAL)

Acceso a la terminologa en lnea

Acceso a las publicaciones en lnea

IBM Tivoli Universal Agent: Gua del usuario

Formacin tcnica de Tivoli

Convenios empleados en esta gua

Acerca de esta publicacin

Convenios de tipo de letra

Variables y vas de acceso que dependen del sistema operativo

Sintaxis de mandatos de Tivoli

IBM Tivoli Universal Agent: Gua del usuario

Acerca de esta publicacin

IBM Tivoli Universal Agent: Gua del usuario

Captulo 1. Visin general de Tivoli Universal Agent

Funcionamiento de Tivoli Universal Agent

Copyright IBM Corp. 2003, 2007

API, Socket, Archivo, Script (ASFS)

IBM Tivoli Universal Agent: Gua del usuario

Figura 1. Funcionamiento de Tivoli Universal Agent

Captulo 1. Visin general de Tivoli Universal Agent

Definicin de datos para Tivoli Universal Agent

Suministro de datos a Tivoli Universal Agent

IBM Tivoli Universal Agent: Gua del usuario

Trabajo con los datos

Un caso de supervisin sencillo

Seleccin del proveedor de datos

Captulo 1. Visin general de Tivoli Universal Agent

Preparacin de la fuente de datos

Definicin de la aplicacin de Tivoli Universal Agent

IBM Tivoli Universal Agent: Gua del usuario

Visualizacin de datos de atributos desde FTPLOGFILE

Creacin de una poltica de automatizacin

Captulo 1. Visin general de Tivoli Universal Agent

IBM Tivoli Universal Agent: Gua del usuario

Captulo 2. Cmo comenzar

Configuracin de Tivoli Universal Agent

Seleccin de un proveedor de datos

Seleccin de los datos que se desean supervisar

Determinacin de la ubicacin de los datos

Determinacin del proveedor de datos

Determinacin del nmero necesario de agentes de Tivoli Universal Agent

IBM Tivoli Universal Agent: Gua del usuario

Establecimiento de las variables de entorno

Nombre y ubicacin del archivo de variables de entorno

Edicin de variables de entorno en los sistemas operativos Windows