IBM Cognos Real-time Monitoring Versión 10.2public.dhe.ibm.com/software/data/cognos/documentation/docs/es/1… · Versión 10.2.0 Guía de instalación y configuración. Nota Antes

IBM Cognos Real-time MonitoringVersión 10.2.0

Guía de instalación y configuración

��

NotaAntes de utilizar esta información y el producto al que da soporte, lea la información de “Avisos” en la página 117.

Información sobre el producto

Este manual es la traducción del original en inglés IBM Cognos Real-time Monitoring Version 10.2.0 Installation andConfiguration Guide.

Este documento se aplica a IBM Cognos Business Intelligence Versión 10.2.0 y también puede aplicarse a versionesposteriores. Para comprobar si hay versiones más recientes de este documento, visite los centros de información deIBM Cognos (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp).

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2003, 2012.

http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp

Contenido

Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Capítulo 1. ¿Cómo se instala y se configura la aplicación Real-time Monitoring? . . . . 1Revisión de las notas de la versión . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Capítulo 2. Planificación para la instalación de Real-time Monitoring . . . . . . . . . 3Componentes que Real-time Monitoring utiliza . . . . . . . . . . . . . . . . . . . . . . . . 3

Componentes de servidor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Gestión de datos de aplicación: componentes de base de datos . . . . . . . . . . . . . . . . . 4Componentes de servidor opcionales . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Arquitectura de Real-time Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Requisitos de memoria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Costes de memoria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Consideraciones de memoria adicionales para Real-time Monitoring . . . . . . . . . . . . . . . . 9

Configuración de navegadores web . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Capítulo 3. Preparación para la instalación de Real-time Monitoring . . . . . . . . . 13Revisión de los entornos soportados . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Verificación de los requisitos del sistema. . . . . . . . . . . . . . . . . . . . . . . . . . 13Preparación de las bases de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Configuración de la migración tras error activa-pasiva . . . . . . . . . . . . . . . . . . . . . 15

Capítulo 4. Instalación y configuración de los servidores de aplicación . . . . . . . . 17Instalación de los componentes del servidor de aplicaciones de Real-time Monitoring . . . . . . . . . . 17Establecimiento de los parámetros de inicio iniciales. . . . . . . . . . . . . . . . . . . . . . 18Establecimiento de las propiedades del sistema durante el inicio . . . . . . . . . . . . . . . . . 20Instalación de fixpacks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Instalación de los fixpacks de Windows . . . . . . . . . . . . . . . . . . . . . . . . . 23Instalación de los fixpacks de UNIX y Linux . . . . . . . . . . . . . . . . . . . . . . . 25

Capítulo 5. Actualización desde una versión anterior o reinstalación de Real-timeMonitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Capítulo 6. Instalación de Real-time Monitoring en IBM WebSphere Application Server 31Instalación y despliegue de Real-time Monitoring en IBM WebSphere Application Server . . . . . . . . . 31

Revisión y verificación de los requisitos para IBM WebSphere . . . . . . . . . . . . . . . . . 31Configuración preliminar de Real-time Monitoring en WebSphere . . . . . . . . . . . . . . . . 32Modificación de los valores de configuración de la máquina virtual Java en WebSphere . . . . . . . . . 33Creación y configuración de la conexión de metadatos en WebSphere . . . . . . . . . . . . . . . 37Definición de orígenes de datos en WebSphere . . . . . . . . . . . . . . . . . . . . . . 42Despliegue de Real-time Monitoring en IBM WebSphere Application Server . . . . . . . . . . . . . 43Configuración del servidor de aplicaciones para la gestión del contenido dinámico . . . . . . . . . . 44

Prueba de Real-time Monitoring tras la instalación en IBM WebSphere Application Server . . . . . . . . . 45Carga de los ejemplos de Real-time Monitoring en IBM WebSphere Application Server . . . . . . . . . 45Importación de los metadatos de ejemplo en Real-time Monitoring . . . . . . . . . . . . . . . . 46

Desinstalación de Real-time Monitoring de IBM WebSphere Application Server. . . . . . . . . . . . . 46Realización de la copia de seguridad de los metadatos de Real-time Monitoring . . . . . . . . . . . 47Desinstalación de IBM WebSphere Application Server . . . . . . . . . . . . . . . . . . . . 47Ejecución del programa de desinstalación de Real-time Monitoring . . . . . . . . . . . . . . . . 47Desinstalación de la base de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Capítulo 7. Instalación de Real-time Monitoring en un servidor de aplicaciones OracleWebLogic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

© Copyright IBM Corp. 2003, 2012 iii

Instalación y despliegue de Real-time Monitoring en un servidor de aplicaciones Oracle WebLogic . . . . . . 49Revisión y verificación de los requisitos para Oracle WebLogic . . . . . . . . . . . . . . . . . 49Modificación de los valores de configuración de la máquina virtual Java . . . . . . . . . . . . . . 50Creación y configuración de la conexión de metadatos . . . . . . . . . . . . . . . . . . . . 56Definición de orígenes de datos en WebLogic . . . . . . . . . . . . . . . . . . . . . . . 58Despliegue de Real-time Monitoring en un servidor de aplicaciones Oracle WebLogic . . . . . . . . . 59

Prueba de Real-time Monitoring tras la instalación en el servidor de aplicaciones Oracle WebLogic . . . . . . 60Carga de los ejemplos de Real-time Monitoring en el servidor de aplicaciones Oracle WebLogic . . . . . . 60Importación de los metadatos de ejemplo en Real-time Monitoring . . . . . . . . . . . . . . . . 61

Desinstalación de Real-time Monitoring del servidor de aplicaciones Oracle WebLogic . . . . . . . . . . 61Realización de la copia de seguridad de los metadatos de Real-time Monitoring . . . . . . . . . . . 62Desinstalación del servidor de aplicaciones Oracle WebLogic . . . . . . . . . . . . . . . . . . 62Ejecución del programa de desinstalación de Real-time Monitoring . . . . . . . . . . . . . . . . 62Desinstalación de la base de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Capítulo 8. Instalación de Real-time Monitoring en un servidor de aplicaciones JBoss 65Instalación y despliegue de Real-time Monitoring en un servidor de aplicaciones JBoss . . . . . . . . . . 65

Revisión y verificación de los requisitos para Real-time Monitoring en un servidor de aplicaciones JBoss . . . 65Modificación de los valores de configuración de la máquina virtual Java . . . . . . . . . . . . . . 67Creación y configuración de la conexión de metadatos . . . . . . . . . . . . . . . . . . . . 73Definición de orígenes de datos en JBoss . . . . . . . . . . . . . . . . . . . . . . . . 75Despliegue de Real-time Monitoring en un servidor de aplicaciones JBoss . . . . . . . . . . . . . 75Consideraciones al desplegar Real-time Monitoring en un servidor de aplicaciones JBoss . . . . . . . . 77

Prueba de Real-time Monitoring tras la instalación en el servidor de aplicaciones JBoss . . . . . . . . . . 78Carga de los ejemplos de Real-time Monitoring en el servidor de aplicaciones JBoss . . . . . . . . . . 78Importación de los metadatos de ejemplo en Real-time Monitoring . . . . . . . . . . . . . . . . 79

Desinstalación de Real-time Monitoring del servidor de aplicaciones JBoss . . . . . . . . . . . . . . 79Realización de la copia de seguridad de los metadatos de Real-time Monitoring . . . . . . . . . . . 80Desinstalación del servidor de aplicaciones JBoss . . . . . . . . . . . . . . . . . . . . . . 80Ejecución del programa de desinstalación de Real-time Monitoring . . . . . . . . . . . . . . . . 80Desinstalación de la base de datos . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

Capítulo 9. Instalación, configuración y desinstalación de los archivos de servidor webde Real-time Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Instalación de los archivos de servidor web de Real-time Monitoring . . . . . . . . . . . . . . . . 83Configuración de un servidor Apache o IBM HTTP Server para la gestión del contenido estático . . . . . . . 84Configuración de Microsoft Internet Information Server para que funcione con la aplicación Real-time Monitoringinstalada en un WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . . . 86Configuración de Microsoft Internet Information Server para que funcione con la aplicación Real-time Monitoringinstalada en un servidor de aplicaciones WebLogic . . . . . . . . . . . . . . . . . . . . . . 87Configuración de Microsoft Internet Information Server para que funcione con la aplicación Real-time Monitoringinstalada en un servidor de aplicaciones JBoss . . . . . . . . . . . . . . . . . . . . . . . . 89Verificación de la configuración para el contenido estático y dinámico . . . . . . . . . . . . . . . . 90Configuración del inicio de sesión único para eTrust SiteMinder. . . . . . . . . . . . . . . . . . 90Desinstalación de Real-time Monitoring del servidor web . . . . . . . . . . . . . . . . . . . . 91

Capítulo 10. Configuración de Real-time Monitoring tras la instalación . . . . . . . . 93Configuración de Real-time Monitoring en IBM Cognos Real-time Monitoring Workbench . . . . . . . . . 93Configuración de los valores de LDAP (Lightweight Directory Access Protocol) . . . . . . . . . . . . 95

Consideraciones relacionadas con la conectividad LDAP (Lightweight Directory Access Protocol). . . . . . 95

Capítulo 11. Resolución de problemas de instalación. . . . . . . . . . . . . . . . 97Resolución de problemas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

Búsqueda en bases de datos de conocimientos Knowledge Base . . . . . . . . . . . . . . . . . 99Obtención de arreglos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Cómo ponerse en contacto con el soporte de IBM . . . . . . . . . . . . . . . . . . . . . 100Intercambio de información con IBM . . . . . . . . . . . . . . . . . . . . . . . . . 101Suscripción a actualizaciones de soporte . . . . . . . . . . . . . . . . . . . . . . . . 102

Inicio en modo a prueba de fallos . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Aparece el mensaje de error Almacén de claves no encontrado . . . . . . . . . . . . . . . . . . 104

iv IBM Cognos Real-time Monitoring Versión 10.2.0: Guía de instalación y configuración

En la consola del servidor de aplicaciones aparece el mensaje de error No es posible conectarse con la base dedatos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Los menús y controles de IBM Cognos Real-time Monitoring Dashboard aparecen truncados o no funcionancorrectamente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Falta el dominio de red en la imagen de máquina virtual de Real-time Monitoring . . . . . . . . . . . 105Comando no válido: WebSpherePluginConfig . . . . . . . . . . . . . . . . . . . . . . . 105Error del servidor de aplicaciones: propiedad no disponible . . . . . . . . . . . . . . . . . . . 105Aparece el mensaje Error de procesamiento . . . . . . . . . . . . . . . . . . . . . . . . 105Aparece el mensaje Error de seguridad . . . . . . . . . . . . . . . . . . . . . . . . . . 105

Capítulo 12. Configuración de JMS (Java Messaging Service) . . . . . . . . . . . 107

Apéndice A. Características de accesibilidad. . . . . . . . . . . . . . . . . . . 109Atajos del teclado para el asistente de instalación . . . . . . . . . . . . . . . . . . . . . . 109

Apéndice B. Ajuste de mapas geográficos . . . . . . . . . . . . . . . . . . . . 111Cómo mejorar la precisión del geocodificador . . . . . . . . . . . . . . . . . . . . . . . 111Ampliación del soporte de mapas geográficos . . . . . . . . . . . . . . . . . . . . . . . 112

Interfaz IGeocoder. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Clase GeoPoint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

Índice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Contenido v

vi IBM Cognos Real-time Monitoring Versión 10.2.0: Guía de instalación y configuración

Introducción

Este documento se ha elaborado para utilizarse con IBM® Cognos Real-timeMonitoring, que es una solución de inteligencia empresarial operativa que ofrecepaneles de control interactivos de autoservicio, consulta ad hoc, generación deinformes y análisis, tareas incorporadas y gestión de excepciones para satisfacer lasnecesidades de supervisión continuada de la organización.

Esta guía contiene instrucciones para instalar, actualizar y configurar Real-timeMonitoring.

Destinatarios

Para utilizar esta guía, debe estar familiarizado con lo siguiente:v Conceptos relacionados con la creación de informesv Conceptos relacionados con la creación de tablas de puntuaciónv Conceptos relacionados con las bases de datosv Problemas de seguridadv Conceptos básicos relacionados con la administración de los sistemas operativos

Microsoft Windows y UNIXv Entorno de servidor e infraestructura de seguridad existentes en la organizaciónv Conocimientos relacionados con el uso de los servidores de aplicaciones,

servidores web y proveedores de directorios

Búsqueda de información

Para buscar documentación sobre los productos de IBM Cognos en la web, incluidatoda la documentación traducida, acceda a uno de los Information Center de IBMCognos (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp). Lasactualizaciones de las notas de la versión se publican directamente en losInformation Center e incluyen enlaces con las últimas notas técnicas y APAR.

También puede leer las versiones en PDF de las notas de la versión del producto ylas guías de instalación directamente de los discos del producto de IBM Cognos.

Características de accesibilidad

Las características de accesibilidad ayudan a los usuarios que tienen algunadiscapacidad física, por ejemplo movilidad restringida o visión limitada, a utilizarproductos de tecnología de la información. Este producto ofrece características deaccesibilidad cuando se integra con IBM Cognos Workspace. Este producto soportala navegación mediante el teclado y ofrece soporte de lector de pantalla cuando sevisualizan métricas en Cognos Workspace. Para obtener información sobre lascaracterísticas de accesibilidad cuando se utiliza el producto con IBM CognosWorkspace, consulte la sección sobre accesibilidad de la publicación IBM CognosReal-time Monitoring Dashboard Guía del usuario. Si no se integra con IBM CognosWorkspace, sólo el programa de instalación tendrá características de accesibilidad.Para obtener más información sobre las características de accesibilidad delprograma, consulte: Apéndice A, “Características de accesibilidad”, en la página109.

© Copyright IBM Corp. 2003, 2012 vii

http://pic.dhe.ibm.com/infocenter/cogic/v1r0m0/index.jsp

http://pic.dhe.ibm.com/infocenter/cogic/v1r0m0/index.jsp

La documentación HTML de IBM Cognos tiene características de accesibilidad. Losdocumentos PDF son suplementarios y, como tales, no incluyen características deaccesibilidad adicionales.

Ejemplos

Los archivos de ejemplo podrían contener datos ficticios generados manual oautomáticamente, datos reales de fuentes académicas o públicas o datos que seutilizan con el permiso del titular del copyright con el fin de poder utilizar éstoscomo datos de ejemplo para desarrollar aplicaciones de ejemplo. Los nombres deproducto mencionados podrían ser marcas registradas de sus respectivospropietarios. Está prohibido realizar cualquier tipo de duplicación no autorizada.

Cláusulas de previsión

En esta documentación se describe la funcionalidad actual del producto. Es posibleque también se incluyan referencias a elementos que no están disponibles. Pero nodebe entenderse que estos vayan a estar disponibles en un futuro. Tales referenciasno suponen el compromiso, promesa u obligación legal de lanzar el material, elcódigo ni la funcionalidad correspondientes. El desarrollo, presentación y duraciónde las características la funcionalidad dependen exclusivamente de IBM.

viii IBM Cognos Real-time Monitoring Versión 10.2.0: Guía de instalación y configuración

Capítulo 1. ¿Cómo se instala y se configura la aplicaciónReal-time Monitoring?

En esta guía se proporcionan instrucciones relacionadas con la instalación yconfiguración de IBM Cognos Real-time Monitoring.

Puede instalar Real-time Monitoring en IBM WebSphere Application Server, en unservidor de aplicaciones Oracle WebLogic o en un servidor de aplicaciones JBoss,con IBM HTTP Server, Apache HTTP Server o Microsoft Internet InformationServer (IIS) configurado para servir contenido web estático.

Si ya utiliza IBM Cognos Real-time Monitoring y desea actualizar el entorno a unaversión más reciente, consulte la información del apartado Capítulo 5,“Actualización desde una versión anterior o reinstalación de Real-timeMonitoring”, en la página 29 en lugar de esta lista de comprobación.1. “Revisión de las notas de la versión”.2. Capítulo 2, “Planificación para la instalación de Real-time Monitoring”, en la

página 3.v “Componentes que Real-time Monitoring utiliza” en la página 3.v “Arquitectura de Real-time Monitoring” en la página 5.v “Requisitos de memoria” en la página 6.v “Configuración de navegadores web” en la página 9.

3. Capítulo 3, “Preparación para la instalación de Real-time Monitoring”, en lapágina 13.v “Revisión de los entornos soportados” en la página 13.v “Verificación de los requisitos del sistema” en la página 13.v “Preparación de las bases de datos” en la página 15.v “Configuración de la migración tras error activa-pasiva” en la página 15.

4. Capítulo 4, “Instalación y configuración de los servidores de aplicación”, en lapágina 17.v Capítulo 6, “Instalación de Real-time Monitoring en IBM WebSphere

Application Server”, en la página 31.v Capítulo 7, “Instalación de Real-time Monitoring en un servidor de

aplicaciones Oracle WebLogic”, en la página 49.v Capítulo 8, “Instalación de Real-time Monitoring en un servidor de

aplicaciones JBoss”, en la página 65.5. Capítulo 9, “Instalación, configuración y desinstalación de los archivos de

servidor web de Real-time Monitoring”, en la página 83.6. Capítulo 10, “Configuración de Real-time Monitoring tras la instalación”, en la

página 93.7. Capítulo 11, “Resolución de problemas de instalación”, en la página 97.

Revisión de las notas de la versiónAntes de determinar los requisitos que tienen aplicación y de planificar lainstalación de IBM Cognos Real-time Monitoring, debe revisar las notas de laversión.

© Copyright IBM Corp. 2003, 2012 1

En las notas de la versión se proporciona información relacionada con losproblemas que se han solucionado en la versión actual. También debe revisar lasnotas de la versión para obtener información acerca de los problemas conocidos yabiertos y acerca de las soluciones temporales asociadas. Para obtener laactualización más reciente de las notas de la versión, visite el centro del cliente deIBM Cognos (http://www.ibm.com/software/data/cognos/customercenter/).

2 IBM Cognos Real-time Monitoring Versión 10.2.0: Guía de instalación y configuración

http://www.ibm.com/software/data/cognos/customercenter/


Capítulo 2. Planificación para la instalación de Real-timeMonitoring

Antes de instalar IBM Cognos Real-time Monitoring y de configurar el servidor deaplicaciones, debe conocer los requisitos básicos mínimos para el software y elhardware. También debe tener en cuenta las dimensiones de la memoria.

Componentes que Real-time Monitoring utilizaEn esta sección se describen los componentes de servidor y base de datos queutiliza IBM Cognos Real-time Monitoring.

IBM Cognos Real-time Monitoring es una aplicación basada en la web paramodelar y visualizar indicadores clave de rendimiento (KPI) en tiempo real.Proporciona al servidor funcionalidad que le permiten procesar los eventos deflujo, así como la realización de agregaciones y la generación de alertas en tiemporeal.

Real-time Monitoring incluye un servidor y una herramienta de modelado, que sedenomina Real-time Monitoring Workbench.

Real-time Monitoring se integra fácilmente en la infraestructura existente mediantela utilización de los recursos que ya están presentes en el entorno. Algunos deestos recursos existentes son necesarios, como:v Un esquema de base de datos para los metadatos, los datos operativos y los

datos de codificación geográfica.v Un servidor de aplicaciones.v Un servidor web.

Otros recursos son opcionales, como un proveedor de seguridad para laautenticación.

Componentes de servidorIBM Cognos Real-time Monitoring cuenta con componentes de nivel de web y concomponentes de nivel de aplicación.

Componentes de nivel de web

Las comunicaciones web en Real-time Monitoring se realizan por medio delservidor web. El contenido estático, como las bibliotecas de JavaScriptTM, losarchivos HTML y las imágenes, puede residir en un servidor web instalado en elmismo sistema en el que reside el servidor de aplicaciones o en un servidor webinstalado en un sistema por separado. Para acceder al contenido estático, debeconfigurar un servidor web. Para la integración de Real-time Monitoring con IBMCognos Workspace, el contenido estático de Real-time Monitoring debe residir enel mismo servidor web que aloja a IBM Cognos Business Intelligence.

Componentes de nivel de aplicación

El nivel de aplicaciones de Real-time Monitoring contiene los servidores deReal-time Monitoring. Se necesita un servidor de aplicaciones para poder instalar


el servidor de Real-time Monitoring. El servidor de Real-time Monitoring ejecutalas solicitudes que proceden de la máquina cliente y que el servidor web reenvía.El nivel de aplicación está dividido lógicamente en los componentes siguientes.v IBM Cognos Real-time Monitoring Workbench

Real-time Monitoring Workbench es la herramienta de modelado para crear ygestionar los metadatos relacionados con la empresa que se utilizan en losanálisis de Real-time Monitoring y los indicadores clave de rendimiento (KPI).Los metadatos se almacenan en un almacenamiento de base de datos persistente;Real-time Monitoring Query Engine accede a éstos para realizar su análisis, yReal-time Monitoring Dashboard para llevar a cabo su visualización.

v IBM Cognos Real-time Monitoring DashboardReal-time Monitoring Dashboard es una herramienta de visualización queproporciona una vista unificada de los KPI en tiempo real y un visor de alertas.Los objetos de panel de control, que están ensamblados en un panel de control,sondean las vistas y los cubos de acuerdo con los intervalos planificados paraactualizarse automáticamente.

v IBM Cognos Real-time Monitoring Query EngineReal-time Monitoring Query Engine es un almacén de datos de tecnología deflujo que contribuye a la ejecución y el cálculo de las consultas en tiempo real amedida que la infraestructura de agentes de Real-time Monitoring adquierenuevos datos. Los datos se calculan de forma incremental a medida que éstosfluyen por el motor. Es un concepto distinto a una base de datos tradicional,donde los cálculos se ejecutan en función de la demanda. El modelo deReal-time Monitoring se suscribe de la forma siguiente:flujos de datos > vistasvistas > vistasvistas + tablas de consulta > vistastablas de consulta > dimensionesvistas + dimensiones > cubosLos datos se almacenan en la memoria y se actualizan incrementalmente amedida que se adquieren más datos de la infraestructura de agentes y de queéstos pasan a formar parte del flujo de objetos de Real-time Monitoring.

Gestión de datos de aplicación: componentes de base dedatos

La aplicación IBM Cognos Real-time Monitoring utiliza los datos que se hanalmacenado en diversas varias bases de datos.

Incluye lo siguiente:v Esquemas de metadatos (obligatorios)

Las definiciones del modelo de Real-time Monitoring, como las definiciones deagentes, flujos de datos, tablas de consulta, vistas, cubos, objetos de panel decontrol, paneles de control y alertas, se almacenan en este esquema.

v Esquema operativo (obligatorio)Las funcionalidades de recuperación y almacenamiento de Real-time Monitoringutilizan este esquema para almacenar los datos recuperados de las tablas deconsulta.

v Esquema geográfico (obligatorio)Real-time Monitoring utiliza este esquema para almacenar en la memoria cachélas coordenadas de codificación geográfica, como las coordenadas de la latitud y


la longitud de las regiones, y para proporcionar sugerencias y modificacionespara resolver las abreviaturas de las ubicaciones geográficas, como AZ, quepodría interpretarse como Arizona o como Azerbaiyán.

v Esquema de datos (opcional)Los datos que se utilizan para rellenar los indicadores clave de rendimiento(KPI) suelen almacenarse en una o varias de estas bases de datos existentes.

Componentes de servidor opcionalesIBM Cognos Real-time Monitoring también puede configurarse con componentesde servidor opcionales, incluido un proveedor de seguridad que puede utilizarsepara la autenticación de usuario.

Proveedor de seguridad para autenticación

De forma predeterminada, Real-time Monitoring soporta la autenticación de basede datos interna, donde los usuarios, los roles y la información de correlaciónusuario-rol se almacenan en el esquema de metadatos. Opcionalmente, puedeconfigurarse para conectarse con proveedores de directorios, como el LDAP(Lightweight Directory Access Protocol), ADS (Active Directory Service) e IBMTivoli Directory Services. Real-time Monitoring también puede configurarse paraconectarse con un servidor de IBM Cognos Business Intelligence 10.1 u 8.4.

Arquitectura de Real-time MonitoringAntes de instalar IBM Cognos Real-time Monitoring, deberá estar familiarizado conla arquitectura del sistema.

Debe configurar navegadores web para su funcionamiento con Real-timeMonitoring. Debe ejecutar el instalador en el servidor de aplicaciones y, si se hainstalado en un sistema por separado, en el servidor web para que éste puedafuncionar con el servidor de aplicaciones. Real-time Monitoring accede a los datospor medio de un servidor de bases de datos, como DB2, SQL Server, Oracle,MySQL o Postgres. Opcionalmente, puede configurar Real-time Monitoring paraque funcione con un proveedor de directorios de autenticación. El diagramasiguiente muestra la arquitectura de Real-time Monitoring:

Capítulo 2. Planificación para la instalación de Real-time Monitoring 5

Requisitos de memoriaPuede estimar el coste básico del tamaño de la memoria en función de los orígenesde datos y del tipo de análisis que se ha planificado realizar.

La asignación de tamaño de memoria puede ser un proceso complejo, pues existendiversas variables que han de considerarse que pueden producir correlaciones demayor complejidad. A continuación se indican los factores principales quecontribuyen al uso de memoria:v Frecuencia de solicitudv Tamaño de los datosv Complejidad de los datosv Estructuras utilizadas

Figura 1. Arquitectura de Real-time Monitoring


El análisis en IBM Cognos Real-time Monitoring depende del uso de las vistas ycubos que crea para almacenar y analizar los datos y de los objetos de panel decontrol que crea para supervisar los datos.

Costes de memoriaExisten dos formas de llevar los datos desde los orígenes de datos externos hastaIBM Cognos Real-time Monitoring: definir flujos de datos y crear tablas deconsulta.

En las secciones siguientes se describen los objetos y los costes de memoria que seasocian a los diversos objetos en Real-time Monitoring.

Flujos de datosPara procesar flujos de datos, se asigna memoria, que posteriormente se liberarádespués de haberse procesado los datos.

Los flujos de datos, puesto que utilizan memoria a medida que se procesan losdatos, no tienen un requisito de memoria fijo. El consumo de memoria varía enfunción de la cantidad de datos y de la frecuencia de actualización de los datos.

Coste

El coste de memoria para los flujos de datos es igual al tamaño de los datos sinprocesar que entran en el sistema como resultado de la carga de datos que seproduce durante un intervalo de tiempo determinado. La memoria, necesaria parapoder procesar flujos de datos en tiempo real o en tiempo casi real, se asigna yposteriormente se libera.

Tablas de consultaLas tablas de consulta incrementan el requisito de memoria si se utiliza laprerrecuperación. La prerrecuperación mejora el rendimiento, pues los datos de latabla de consulta se colocan en la memoria caché; sin embargo, el rendimiento seobtiene a expensas de la memoria.

Aunque existen otros modos de conversión que necesitan menos requisitos dememoria, debe considerar el coste que conlleva la utilización de menos requisitosde memoria frente al rendimiento.

Coste

El coste de memoria para las tablas de conversión es igual al coste del tamaño delos datos sin procesar que entran en el sistema como datos de tabla de conversión.La memoria para los cubos y las vistas para el análisis incrementa el coste totaltras el acceso a los datos (que podrían realizar un paso a través en el caso de losflujos de datos o bien retenerse en la memoria en el caso de los datos de búsquedade prerrecuperación).

VistasLas vistas podrían consumir pequeñas cantidades de memoria o grandescantidades de memoria, en función del número de filas de datos que debanmantenerse.

Real-time Monitoring tiene la siguiente clasificación de vistas:v Vistas sin estado, que no mantienen datos agregados.


Las vistas sin estado sólo conservan en la memoria el último conjunto de filas, amenos que se haya establecido “Mantener en la vista”, que puede incrementar elnúmero de conjuntos de filas almacenados. Un conjunto de filas podría contenermás de una fila de datos.

v Vistas completas, que almacenan datos agregados y que, con frecuencia, sealmacenan mientras tiene vigencia una ventana con marco de eventos o detiempo.Las vistas completas almacenan la información agregada y varias filas de datoshistóricos que podrían ser necesarios para volver a calcular las agregaciones.Mediante la reducción del número de grupos exclusivos y ventanas de tiempo,puede reducir la cantidad de memoria necesaria para almacenar los datos.

Coste

El análisis del coste para las vistas podría ser difícil de pronosticar si se desconocequé vistas deberán crearse. El espacio de memoria final dependerá de cómo agrupelos datos y de qué atributos utilice. Cuanto más detallados sean los atributos, másdatos se necesitarán (que siguen siendo menos que los datos sin procesar, pues seagregan en función de la agrupación definida) y, por lo tanto, más memoria senecesitará. Para obtener una estimación, deberá analizar los datos sin procesar, suscaracterísticas y cómo se utilizarán.

CubosLos cubos, en función de la granularidad de sus dimensiones, pueden necesitargran cantidad de memoria.

Por ejemplo, un cubo con una dimensión de tiempo o ventana de tiempo quetenga una granularidad de segundos necesita más memoria que uno que tenga unagranularidad de minutos. Para reducir el espacio de memoria, debe reducir lacantidad de datos o bien la granularidad. La reducción de memoria que puedeobtenerse variará en función de las necesidades específicas actuales; sin embargo,también deberá considerar futuras necesidades al establecer la memoria para loscubos.

Coste

El análisis del coste de memoria para los cubos es similar al de las vistascompletas. La vista entramada base que contiene todos los datos para un cubodeterminado puede incrementar su tamaño considerablemente, en función de lagranularidad de los atributos dimensionales. Si es posible, realice algún tipo demuestreo de los datos de hechos (transaccionales) para determinar quécombinaciones de agrupaciones exclusivas están presentes en los datos.

Windows (frecuencia)IBM Cognos Real-time Monitoring incorpora el concepto de ventanas cuando sehace referencia a los datos del flujo.

Las ventanas pueden definirse en términos del número de eventos que seproducen en un plazo de tiempo (por ejemplo, una ventana de siete días o unaventana de una hora). Para realizar el análisis operativo o supervisión, debeconocer el intervalo de tiempo del análisis.

La utilización de ventanas de tiempo incrementa la memoria necesaria, pues IBMCognos Real-time Monitoring retiene filas individuales. El espacio de memoria seincrementa en función del tamaño y de la granularidad de la ventana. (Lagranularidad sólo se aplica a las ventanas de tiempo.) Las ventanas se crean como


parte del proceso de creación de las vistas o cubos. Mediante la reducción delnúmero de grupos de ventanas exclusivos, por ejemplo, truncando la indicación defecha y hora en los minutos, puede reducir el número de grupos que debenalmacenarse en la memoria. Se ha implementado un algoritmo de optimizaciónpara que la agregación tenga lugar dentro de un grupo de tiempo, en lugar deaplicarse el almacenamiento de "filas individuales" que se describe en esta sección.

Coste

Puede estimar el coste aproximado de memoria para las ventanas en función deltamaño y granularidad de las ventanas. El coste de memoria para las ventanasbasadas en eventos es más fácil de calcular, pues conocerá exactamente cuántoseventos se retendrán en la memoria y el número de grupos que se calcularán apartir de las vistas y cubos. Las ventanas basadas en tiempo se calculan en funcióndel número de grupos exclusivos de esa ventana y del tamaño de la ventana. Otrofactor es el tipo de ventana: deslizante o en movimiento. Una ventana deslizantepodría tener un coste fijo aproximado tras haberse completado. El coste dememoria para las ventanas en movimiento crece y disminuye a medida que laventana se mueve y vuelve a completarse.

Consideraciones de memoria adicionales para Real-timeMonitoring

Deben ajustarse todavía más los costes de memoria para tener en cuenta el trabajoque realizan los usuarios de Real-time Monitoring.

La mayoría de los costes de memoria de Real-time Monitoring son fijos, porque losconjuntos de resultados y los datos se conservan en la memoria. Aunque puedenreducirse, sigue siendo necesario conservar algunos datos en la memoria. Algunoscostes de memoria son transitorios, pues el uso de memoria puede incrementarse oreducirse según sea necesario para procesar los datos en función de la carga detrabajo.

Por ejemplo, los usuarios podrían crear paneles de control o realizar análisis adhoc que generarán consultas que se ejecutarán en el servidor. La estrategia delservidor consiste en colocar en la memoria caché estas consultas, reteniéndolas enla memoria o haciendo que caduquen transcurrido un plazo de tiempodeterminado.

Una práctica correcta para estimar el tamaño es obtener una estimación inicial delos costes de memoria fija. A continuación, añada los costes relacionados con lospaneles de control y los análisis ad hoc de los cubos subyacentes. Este coste dememoria variará en función del número de usuarios simultáneos y de susactividades. Asimismo, Real-time Monitoring hace uso de la recogida de basura dela memoria, que necesita memoria adicional para poder funcionar correctamente.La memoria óptima necesaria para que el proceso JavaTM pueda hacer un usoóptimo es aproximadamente el doble de la memoria que se necesita paraalmacenar los datos.

Configuración de navegadores webIBM Cognos Real-time Monitoring Workbench e IBM Cognos Real-time MonitoringDashboard pueden utilizarse en navegadores web Internet Explorer. Asimismo,Firefox está soportado cuando se visualizan objetos de Real-time Monitoring enIBM Cognos Workspace. Tanto Cognos Real-time Monitoring Workbench comoReal-time Monitoring Dashboard utilizan configuraciones de navegador similares.


Para consultar una lista actualizada de navegadores soportados para IBM CognosReal-time Monitoring, visite el centro del cliente de IBM Cognos(http://www.ibm.com/software/data/cognos/customercenter/).

En la tabla siguiente se muestran los valores de navegador que deben habilitarse.

Tabla 1. Valores de navegador para IBM Cognos Real-time Monitoring

Navegador Valor

Internet Explorer v Permitir cookies

v Permitir ventanas emergentes

v Secuencias de comandos ActiveX

v Permitir META REFRESH

v Ejecutar controles y conectores de ActiveX

v Activar script de los controles de ActiveX marcadoscomo seguros

v Comportamientos binarios y script

v Permitir el acceso al portapapeles por programa

v Permitir ventanas iniciadas por secuencias decomandos sin restricciones de tamaño o posición

El rendimiento se optimiza cuando el servidor deReal-time Monitoring se encuentra en la zona de la"Intranet local" en los valores de la seguridad.

Firefox (soportado cuando sevisualizan objetos de Real-timeMonitoring en IBM CognosWorkspace)

v Permitir cookies

v Habilitar Java

v Habilitar JavaScript

v Cargar imágenes

Real-time Monitoring requiere el conector de Adobe Flash Player para mostrar lasinterfaces de usuario de la aplicación Real-time Monitoring.

Real-time Monitoring utiliza las siguientes cookies para almacenar la informaciónde los usuarios.

Tabla 2. Cookies que utiliza IBM Cognos Real-time Monitoring

Cookie Tipo Función

cam_passport

sessionid

Temporal por sesión Contiene un identificador de sesión deusuario exclusivo que es válido mientrasdura la sesión del navegador. En función dela configuración, puede que exista más deuna cookie cam_passport o sessionid. Cadacookie se encuentra en un directorio distinto.

ObiOpenURL Temporal por sesión Contiene la ruta para los cuadros de diálogonecesarios para diversas acciones de usuario.

dbUser Permanente Contiene el nombre del usuario en el panelde control en las sesiones de navegador,cuando la casilla de verificación Recordar minombre de usuario en este sistema se haestablecido en la página de inicio de sesióndel panel de control.



Tabla 2. Cookies que utiliza IBM Cognos Real-time Monitoring (continuación)

Cookie Tipo Función

wbUser Permanente Contiene el nombre del usuario en unentorno de trabajo en las sesiones denavegador, cuando la casilla de verificaciónRecordar mi nombre de usuario en estesistema se ha establecido en la página deinicio de sesión del entorno de trabajo.

cognos_sso Temporal por sesión Contiene un identificador de sesión deusuario exclusivo para un inicio de sesiónúnico con BI que es válido mientras dura lasesión del navegador.

loginErrorKey Temporal por sesión Contiene una clave de mensaje para loserrores relacionados con el inicio de sesión.

Después de actualizar o de instalar software nuevo, reinicie el navegador web yaconseje a los usuarios que borren la memoria caché del navegador. Por ejemplo,para borrar la memoria caché del navegador en Internet Explorer, en el menúHerramientas, pulse Opciones de Internet y pulse Eliminar.



Capítulo 3. Preparación para la instalación de Real-timeMonitoring

Antes de instalar IBM Cognos Real-time Monitoring en un servidor deaplicaciones, como IBM WebSphere, Oracle WebLogic o JBoss se debe llevar a cabouna tarea preliminar.

Debe llevar a cabo las siguientes tareas:1. Revisión de los entornos soportados.2. Verificación de los requisitos del sistema.3. Preparación de las bases de datos.4. Consideraciones relacionadas con los clústeres de servidor de aplicaciones y la

migración tras error activa-pasiva.

Revisión de los entornos soportadosPara garantizar el correcto funcionamiento de IBM Cognos Real-time Monitoring,aplique todos los parches del sistema operativo mínimos necesarios y utilice sólolas versiones de otro software soportadas para Real-time Monitoring.

Para ver una lista actualizada de los entornos que Real-time Monitoring soporta,incluida información acerca de los sistemas operativos, parches, navegadores,servidores web, servidores de directorios, servidores de bases de datos y servidoresde aplicaciones, visite el centro del cliente de IBM Cognos (http://www.ibm.com/software/data/cognos/customercenter/).

Verificación de los requisitos del sistemaVerifique que tiene los requisitos del sistema para instalar y ejecutar loscomponentes de IBM Cognos Real-time Monitoring en un sistema.

Utilice las tablas siguientes para comprobar los requisitos mínimos de hardware yde software. Puede que se necesiten recursos adicionales para entornos distribuidoso entornos de producción. Real-time Monitoring es una aplicación que hace un usointensivo de la red y que ofrece rápida actualización de los datos que necesita unaconexión de red y CPU óptimas para poder ejecutarse con eficiencia en el cliente.

Requisitos de hardware

Tabla 3. Requisitos de hardware de Real-time Monitoring

Requisito Especificación

Sistema operativo Servidor Microsoft Windows de 64 bits

Servidor UNIX de 64 bits

Servidor Linux de 64 bits

Servidor Linux en IBM System z de 64 bits

RAM Mínimo: 16 GB



Tabla 3. Requisitos de hardware de Real-time Monitoring (continuación)


Especificaciones del sistema operativo Límite de descriptor de archivos establecidoen 2048 en sistemas operativos UNIX yLinux

Espacio en disco Tras la instalación del software se necesitan,como mínimo, 20 GB de espacio libre.Preferiblemente, se realizaría en unaconfiguración RAID 5.

Para todas las bases de datos, el tamañoaumentará con el tiempo. Asegúrese de quedispone de suficiente espacio de disco paranecesidades futuras.

Requisitos de software

Tabla 4. Requisitos de software de Real-time Monitoring


Servidor web Debe existir un servidor web instalado einiciado. Las opciones incluyen ApacheHTTP Server, IBM HTTP Server o MicrosoftIIS Server.

Java Runtime Environment (JRE) Se ha instalado una versión de IBM del JREcon IBM WebSphere Application Server.

Para WebLogic y JBoss, se recomienda el JREde Java SE HotSpot. Real-time Monitoringnecesita el JRE y JDK de Java 5 o posterior.

Utilice el JRE que se instala con el servidorde aplicaciones que utiliza, si Real-timeMonitoring soporta esa versión del JRE.

Base de datos Debe disponer de una de las siguientesbases de datos para almacenar los datos deIBM Cognos en un entorno de producción:

v IBM DB2

v Oracle

v Microsoft SQL Server

v MySQL

v PostgreSQL

Se necesita conectividad TCP/IP para todoslos tipos de bases de datos.

Servidor de aplicaciones IBM WebSphere, Oracle WebLogic o JBoss


Preparación de las bases de datosIBM Cognos Real-time Monitoring utiliza varias bases de datos para almacenar lainformación, como los metadatos acerca de los objetos que se han creado en elsistema. Las bases de datos también pueden utilizarse como orígenes de datos.

Obtenga controladores JDBC (Java Database Connectivity) antes de configurarnuevas bases de datos que habrán de utilizarse con Real-time Monitoring. Debeutilizar los controladores JDBC adecuados que proporciona el proveedor deservidor de aplicaciones o el proveedor de base de datos.

Cree bases de datos dedicadas para los metadatos, los datos operativos y los datosgeográficos. Asimismo, cree una cuenta de usuario dedicada para estas bases dedatos que permita al usuario crear tablas y consultar tablas.

Configuración de la migración tras error activa-pasivaIBM Cognos Real-time Monitoring puede configurarse para ejecutarse conmigración tras error activa-pasiva de modo que sólo exista una instancia deReal-time Monitoring en ejecución al mismo tiempo. Si la instancia primariaexperimenta algún error, puede iniciarse la instancia secundaria.

Esta configuración conlleva la configuración de dos nodos, idénticos, pero el iniciode sólo uno de ellos. Los dos nodos deben tener la misma configuración para labase de datos de metadatos y todas las demás bases de datos que utilizan JNDI(Java Naming and Directory Interface). El directorio de punto de comprobación yde registro de recuperación debe encontrarse en una ubicación a la que puedanacceder al mismo tiempo ambos nodos del servidor de aplicaciones. Cuando elservidor primario se establece en estado fuera de línea, el servidor secundario seestablece en estado en línea mediante la utilización de la misma base de datos demetadatos, y la recuperación tiene lugar desde los mismos archivos de punto decomprobación y de registro de recuperación.

La migración tras error de Real-time Monitoring se implementa en el nivel de labase de datos y del compartimiento de archivos, y no depende de ningunasemántica de clúster.

La migración tras error activa-pasiva puede aplicarse siguiendo los pasos que seproporcionan durante el despliegue.

Procedimiento1. Configure una segunda instancia de Real-time Monitoring en un sistema

secundario. Esta es la instancia pasiva.2. Configure los metadatos de Real-time Monitoring de modo que pueda

accederse a éstos desde las instancias activa y pasiva de Real-time Monitoring.3. Configure un servidor de archivos compartidos para los puntos de

comprobación y los registros de recuperación.4. Configure el acceso de URL para los usuarios de Real-time Monitoring

mediante un equilibrador de carga o proxy que pueda detectar el estado delservidor de aplicaciones de forma continuada.Si la instancia activa de Real-time Monitoring experimenta algún error, lainstancia pasiva puede activarse para dar servicio a las solicitudes de Real-timeMonitoring. El equilibrador de carga que configure dirigirá el tráfico a la

Capítulo 3. Preparación para la instalación de Real-time Monitoring 15

instancia que está en ejecución actualmente. En caso de producirse unamigración tras error, los usuarios deberán volver a iniciar la sesión en elsistema.


Capítulo 4. Instalación y configuración de los servidores deaplicación

Debe ejecutar el instalador en el servidor utilizado para el entorno del servidor deaplicaciones y, a continuación, preparar los valores de registro y configurar laspropiedades del sistema.

Si el entorno del servidor web también reside en el mismo sistema que el servidorde aplicaciones, instale los archivos del servidor web. Si el servidor web reside enun sistema distinto, elimine la selección de la opción de los archivos del servidorweb y ejecute el instalador por separado en el servidor web.

En esta sección se da por supuesto que ha adquirido el CD del producto o que hadescargado el paquete de instalación adecuado y que dispone de derechosadministrativos en el servidor en el que desea instalar IBM Cognos Real-timeMonitoring.

Instalación de los componentes del servidor de aplicaciones deReal-time Monitoring

Para instalar los componentes de servidor de IBM Cognos Real-time Monitoring,ejecute el asistente de instalación desde el paquete de instalación o desde el CD delproducto.

Para realizar una instalación completa, debe instalar componentes en el servidor y,a continuación, configurar éstos para que funcionen en el entorno de que dispone.Por lo general, ejecutará el instalador de IBM Cognos Real-time Monitoring enmodo interactivo. Esto significa que, en una GUI (interfaz gráfica de usuario), elinstalador le solicitará que proporcione información, y deberá ejecutarse desde unaestación de trabajo del sistema X Window, un terminal X o un PC u otro sistemaque tenga instalado software de servidor X. Para ejecutar una instalación en modointeractivo, la consola conectada al sistema debe soportar una interfaz gráfica deusuario basada en Java.

Para los sistemas que se ejecutan en un entorno Linux en IBM System z, existe unrequisito (requisito de software opcional): debe disponer de software X Windowcapaz de representar una interfaz gráfica de usuario (de esta forma, obtendrá lasbibliotecas motif que necesita). Debe habilitar el host remoto para que dirija susalida a la pantalla local. También debe establecer la variable de entorno DISPLAY.Por ejemplo, escriba export DISPLAY=nombre_host:número_pantalla.

Procedimiento1. Realice uno de los pasos siguientes en función del entorno utilizado:

v En el sistema operativo Microsoft Windows, en el directorio win64 delpaquete que ha descargado, efectúe una doble pulsación en el archivoissetup.exe y siga las instrucciones del asistente de instalación.

v En un sistema operativo UNIX o Linux, en el directorio correspondiente alsistema operativo, escriba ./issetup y siga las instrucciones del asistente deinstalación.

2. En la página Ubicación de instalación, especifique la ubicación de IBM Cognosy pulse Siguiente.


Por ejemplo, en un servidor que ejecuta el sistema operativo MicrosoftWindows, el valor predeterminado es C:\Archivos de programa\ibm\cognos\c10_64.Si no utiliza el directorio de instalación predeterminado, utilice un nombre dedirectorio que sólo contenga caracteres ASCII. Algunos servidores web nosoportan caracteres que no sean ASCII en los nombres de los directorios.

3. En la página Selección de componentes, seleccione si han de instalarse losarchivos del servidor de aplicaciones y del servidor web o bien si sólo han deinstalarse los archivos del servidor de aplicaciones.El valor predeterminado es instalar ambos conjuntos de archivos en el servidorde aplicaciones.v Si el servidor de aplicaciones y el servidor web residen en el mismo sistema,

pulse Siguiente.v Si el servidor web reside en un sistema distinto del servidor de aplicaciones,

expanda IBM Cognos Real-time Monitoring, elimine la selección deArchivos del servidor web de Real-time Monitoring y pulse Siguiente.

4. Complete los pasos del asistente de instalación y pulse Terminar.

Resultados

Ahora está preparado para establecer los parámetros de inicio iniciales. Paraobtener más información, consulte “Establecimiento de los parámetros de inicioiniciales”.

Establecimiento de los parámetros de inicio inicialesEstablezca el nivel de registro para habilitar la depuración.

El valor preferido es habilitar el nivel de registro bajo que registra información dedepuración básica para el Asignador de DDL, que registra información cuando serealizan solicitudes para guardar objetos. Cuando este valor está habilitado, si seproduce una anomalía, como un bloqueo completo del sistema, el archivo deregistro contiene las definiciones que se han guardado. Esto le permite volver acrear los metadatos correctamente en caso de que se produzca un problema.

El registro de la información de depuración también puede ayudar al personal desoporte de IBM Cognos a depurar el sistema en caso de que solicite su soportepara realizar la instalación de IBM Cognos Real-time Monitoring. De formapredeterminada, el registro está activado.

Nota: Todos los espacios de los nombres de las propiedades deben incluir elcarácter de escape de la barra inclinada invertida (\). Para todos los sistemasoperativos, incluido el sistema operativo Microsoft Windows, utilice barrasinclinadas hacia la derecha (/) en los nombres de rutas, en lugar de barrasinclinadas invertidas, para eliminar la necesidad potencial de tener que especificarcaracteres de escape para éstos. Por ejemplo: Additional\ Log4j\Properties=C:/Program Files/ibm/cognos/c10_64/realtime/configuration/log4j.properties.

Procedimiento1. Para asegurarse de que el registro está activado, abra el archivo

log4j.properties, que se encuentra en el directorio ubicación_c10/realtime/configuration, y asegúrese de que se ha realizado la entrada siguiente:com.cognos.obi.metadata.DDLDispatch=com.cognos.obi.settings.DbgLow


2. Tras visualizar el archivo log4j.properties, edite el archivo realtime.properties,que también se encuentra en el directorio ubicación_c10/realtime/configuration,para asegurarse de que la ubicación del archivo log4j.properties se haregistrado con exactitud aquí.Localice la siguiente entrada y asegúrese de que no contiene comentarios:Additional\ Log4j\ Properties=<path>

donde <ruta> es la ruta absoluta del archivo log4j.properties que controla losadicionadores, el formateo y los niveles para IBM Cognos Real-timeMonitoring.Por ejemplo, en un servidor que ejecuta el sistema operativo MicrosoftWindows, escriba Additional\ Log4j\ Properties=c:/ProgramFiles/ibm/cognos/c10_64/realtime/configuration/log4j.properties

Por ejemplo, en un servidor que ejecuta el sistema operativo Linux, escribaAdditional\ Log4j\ Properties=/opt/ibm/cognos/c10_64/realtime/configuration/log4j.properties

Para obtener instrucciones detalladas acerca de la edición del archivorealtime.properties y del establecimiento de los niveles de registro y de otraspropiedades de inicio, consulte “Establecimiento de las propiedades del sistemadurante el inicio” en la página 20.

3. Para establecer la ruta en la que ha de grabarse el archivo de registro, asegúresede que la siguiente entrada no contiene comentarios y de que tiene una rutaválida.Logging\ Directory=<path>

donde <ruta> es la ruta absoluta del directorio en el que desea que se grabenlos archivos de registro.Por ejemplo, en un servidor que ejecuta el sistema operativo MicrosoftWindows, escriba Logging\ Directory=c:/Program Files/ibm/cognos/c10_64/realtime/logs

Por ejemplo, en un servidor que ejecuta el sistema operativo Linux, escribaLogging\ Directory=/opt/ibm/cognos/c10_64/realtime/logs

4. Para establecer la ruta en la que ha de grabarse el archivo de registro derecuperación, asegúrese de que la siguiente entrada no contiene comentarios yde que tiene una ruta válida.Recovery\ Log\ Directory=<path>

donde <ruta> es la ruta absoluta del directorio en el que desea que se grabenlos registros de recuperación.Por ejemplo, en un servidor que ejecuta el sistema operativo MicrosoftWindows, escriba Recovery\ Log\ Directory=c:/Program Files/ibm/cognos/c10_64/realtime/checkpoints

Por ejemplo, en un servidor que ejecuta el sistema operativo Linux, escribaRecovery\ Log\ Directory=/opt/ibm/cognos/c10_64/realtime/checkpoints

5. Para utilizar un prefijo para los nombres de los archivos de registro, asegúresede que la siguiente entrada no contiene comentarios y de que tiene un prefijo.Log\ File\ Prefix=<prefix>

donde <prefijo> es el prefijo que desea anteponer a los archivos de registro. Porejemplo:Log\ File\ Prefix=rtm

Con esto, los registros generados se denominarían rtm_detailed.log, rtm.log, etc.

Capítulo 4. Instalación y configuración de los servidores de aplicación 19

Resultados

Se han establecido el nivel de registro y otros parámetros de registro. El nivel deregistro estará en vigor hasta que el archivo se cambie editándolo manualmente outilizando los controles de la interfaz de usuario para restablecer el nivel deregistro. Para desactivar el registro editando el archivo, sustituya el nivel dedepuración por la entrada siguiente:

com.cognos.obi.metadata.DDLDispatch=com.cognos.obi.settings.Inherit

El archivo sólo se lee cuando el servidor se inicia por primera vez. La realizaciónde modificaciones en el archivo implica la necesidad de reiniciar la aplicación en elservidor de aplicaciones.

Establecimiento de las propiedades del sistema durante el inicioAntes de instalar y de desplegar IBM Cognos Real-time Monitoring en un servidorde aplicaciones, debe editar el archivo realtime.properties que especificapropiedades del sistema.

El archivo se encuentra en el directorio ubicación_c10/realtime/configuration. Estaspropiedades se necesitan para que el funcionamiento de Real-time Monitoring seacorrecto. Sólo una entrada de propiedad es obligatoria para el primer inicio deReal-time Monitoring. Todas las demás propiedades son opcionales. Sin embargo,sin las entradas de propiedades opcionales, Real-time Monitoring Workbenchvisualizará el diálogo de la página web Primera configuración para establecerpropiedades del sistema adicionales.

La ruta de los archivos de propiedades puede ser relativa o absoluta. Puesto que esmás precisa, se prefiere la ruta absoluta, y se utiliza en todos los pasos de estetema. Sin embargo, el establecimiento de las propiedades también puede realizarsecon rutas relativas. Para utilizar rutas relativas, debe determinar el directorio basede las rutas relativas. La utilización de la ruta relativa aporta a la aplicación másportabilidad entre sistemas operativos. Proporcione una ruta, como/opt/ibm/cognos/c10_64/configuration/keystores/, que pueda crearse en lossistemas operativos Microsoft Windows y Linux.

Las propiedades definidas en el archivo de texto sustituyen a las propiedades quese han establecido utilizando los valores del sistema de Real-time MonitoringWorkbench. Al reiniciarse el servidor, las propiedades definidas en el archivo detexto sobrescribirán las propiedades que se han establecido utilizando los valoresdel sistema de Real-time Monitoring Workbench. En el archivo de texto, establezcasólo las propiedades que no deseará cambiar posteriormente en Real-timeMonitoring Workbench.

Para obtener una descripción completa de todas las propiedades del sistema,consulte la sección Gestión de la administración del sistema de la Guía del usuariode IBM Cognos Real-time Monitoring Workbench.

Nota: Todos los espacios de los nombres de las propiedades deben incluir elcarácter de escape de la barra inclinada invertida (\). Para todos los sistemasoperativos, incluido el sistema operativo Microsoft Windows, utilice barrasinclinadas hacia la derecha (/) en los nombres de rutas, en lugar de barrasinclinadas invertidas, para eliminar la necesidad potencial de tener que especificar


caracteres de escape para éstos. Por ejemplo: Admin\ Keystore\Location=c:/Program Files/ibm/cognos/c10_64/realtime/configuration/keystore/admin.jks.

Procedimiento1. Edite el archivo realtime.properties, que se encuentra en el directorio

ubicación_c10/realtime/configuration.Este archivo establece las propiedades del sistema durante el proceso de iniciodel servidor. Para JBoss y Oracle WebLogic, debe especificar la ubicación delarchivo de propiedades (realtime.properties) en el script que se utiliza paraejecutar el servidor de aplicaciones. (Para JBoss, debe editar run.bat en elsistema operativo Microsoft Windows o bien run.sh en el sistema operativoUNIX. Para WebLogic, debe editar startWebLogic.cmd en el sistema operativoMicrosoft Windows o bien startWebLogic.sh en el sistema operativo UNIX.)Para IBM WebSphere, debe especificar la ubicación del archivo de propiedadespor medio de IBM WebSphere Administrative Console.

2. Establezca la propiedad obligatoria siguiente.Admin\ Keystore\ Location=<path>

donde <ruta> es la ruta absoluta de admin.jks en el sistema de archivos delservidor. Es el almacén de claves que se utiliza para cifrar la contraseña delusuario administrador.Por ejemplo, en un servidor que ejecuta el sistema operativo MicrosoftWindows, escriba Admin\ Keystore\ Location=c:/Program Files/ibm/cognos/c10_64/realtime/configuration/keystore/admin.jks

Por ejemplo, en un servidor que ejecuta el sistema operativo Linux, escribaAdmin\ Keystore\ Location=(/opt/ibm/cognos/c10_64/realtime/configuration/keystore/admin.jks

3. Opcionalmente, establezca las propiedades necesarias siguientes. Si estaspropiedades no se establecen ahora, podrán establecerse desde Real-timeMonitoring Workbench tras iniciarse el servidor.v SMTP\ Host=<host_ip>

donde <ip_host> es el IP de host o el nombre del servidor SMTP que seutiliza para enviar alertas por medio de IBM Cognos Real-time Monitoring.Por ejemplo:SMTP\ Host=localhost

v SMTP\ From\ Address=<email_address>

donde <dirección_correo_electrónico> es la dirección de correo electrónico quese utilizará para los mensajes de alerta de correo electrónico de IBM CognosReal-time Monitoring del usuario que enviará correo electrónico por mediodel cliente SMTP. La dirección puede ser la cuenta de correo electrónico deun usuario administrador. Por ejemplo:SMTP\ From\ Address=rtmadmin@localhost

v SMTP\ User=<smtp_user>

donde <usuario_smtp> es un nombre de usuario que el servidor SMTP aceptasi necesita autenticación. Si no se ha habilitado la autenticación SMTP, estapropiedad no se utiliza pero, a pesar de ello, sigue siendo necesarioestablecerla.SMTP\ Password=<smtp_password> proporciona la contraseña para esteusuario.

v Keystore\ Location=<path>


donde <ruta> es la ruta absoluta de user_sample.jks en el sistema de archivosdel servidor.Por ejemplo, en un servidor que ejecuta el sistema operativo MicrosoftWindows, escriba Keystore\ Location=c:/Program Files/ibm/cognos/c10_64/realtime/configuration/keystore/user_sample.jks

Por ejemplo, en un servidor que ejecuta el sistema operativo Linux, escribaKeystore\ Location=/opt/ibm/cognos/c10_64/realtime/configuration/keystore/user_sample.jks

El almacén de claves user_sample.jks se utiliza para cifrar las contraseñas detodos los usuarios a excepción del usuario rtmadmin.

Importante: Si tiene usuarios que se han creado cuando el almacén de clavesestablecido era distinto, no elimine el almacén de claves de la ubicaciónantigua. La ubicación del almacén de claves que se había utilizadoanteriormente deberá encontrarse en la misma ruta de archivo cuando eseusuario vuelva a iniciar la sesión. Durante el siguiente inicio de sesión, trasla autenticación del almacén de claves antiguo, la contraseña se almacenaráen el archivo de almacén de claves actual.

v Keystore\ Password =<pwd>

donde <contraseña> es la contraseña del almacén de claves de usuario. Es8deb5102f8. Por ejemplo:Keystore\ Password=8deb5102f8

v User\ PrivateKey\ Password=<pwd>

donde <contraseña> es la contraseña de clave privada para el cifrado deusuario. Es 8deb5102f8. Por ejemplo:User\ PrivateKey\ Password=8deb5102f8

Resultados

Después de haber completado el establecimiento de las propiedades del sistema,debe especificar la ubicación de las propiedades como un argumento JVM en cadaservidor de aplicaciones. Para obtener información detallada acerca de cómo hacerreferencia al archivo realtime.properties para el servidor de aplicaciones que utilizaen particular, consulte lo siguiente:v “Modificación de los valores de configuración de la máquina virtual Java en

WebSphere” en la página 33 para IBM WebSphere Application Server.v “Modificación de los valores de configuración de la máquina virtual Java” en la

página 50 para el servidor de aplicaciones Oracle WebLogic.v “Modificación de los valores de configuración de la máquina virtual Java” en la

página 67 para el servidor de aplicaciones JBoss.

Instalación de fixpacksIBM proporciona paquetes de mantenimiento provisionales que contienenactualizaciones para uno o más componentes del producto de IBM Cognos. Sicuando instale o actualice su producto hay un fixpack disponible, debe instalarlodespués de instalar los componentes de IBM Cognos.

Si el fixpack pasa a estar disponible después de implementar su producto de IBMCognos, debe detener el servicio, instalar el fixpack en la misma ubicación que loscomponentes de IBM Cognos y, a continuación, iniciar el servicio.


Los fixpacks son acumulativos. Cuando instala el fixpack más reciente, incluiráactualizaciones de todos los fixpack anteriores. Los fixpacks se pueden descargardel servicio de soporte de IBM, en http://www.ibm.com/support/us/en/.

Nota: Los fixpacks no son instalaciones independientes. Debe instalarlos ensistemas que tengan instalados componentes de IBM Cognos. Instale los fixpacksque correspondan a su versión del producto. Para comprobar la versión, abra elarchivo de lista de componentes que se encuentra en ubicación_c10\cmplst.txt yverifique la línea que empieza por REALMON_version=.

Instalación de los fixpacks de WindowsSiga estos pasos para instalar los fixpacks de IBM Cognos Real-time Monitoring ensistemas operativos Windows.

Antes de empezar

Antes de instalar el fixpack:1. Como paso opcional pero recomendado, realice una copia de seguridad de los

metadatos y la configuración de Real-time Monitoring:a. Inicie IBM Cognos Real-time Monitoring Workbench utilizando un ID de

usuario con privilegios de administrador.b. En la pestaña Consola de administración, pulse el botón Valores del

sistema.c. En el menú desplegable de configuración, seleccione Configuración del

punto de comprobación.d. Pulse el botón Ejecutar punto de comprobación ahora.e. Vaya a la pestaña Consola de administración y pulse el botón

Importar/Exportar.f. En la ventana Importar/Exportar, seleccione la operación Exportar

metadatos a un archivo JAR (descargar).g. Establezca las opciones de exportación en Exportación personalizada y

seleccione todas las opciones disponibles.h. Pulse Aceptar. Se le solicitará una ubicación donde descargar el archivo en

su sistema.

Nota: Asegúrese de que no se bloqueen las ventanas emergentes.2. Detenga la aplicación Real-time Monitoring:

a. Detenga y retire el despliegue de Real-time Monitoring. Los pasos variaránen función del tipo de servidor de aplicaciones:v Consulte “Desinstalación de IBM WebSphere Application Server” en la

página 47.v Consulte “Desinstalación del servidor de aplicaciones Oracle WebLogic”

en la página 62.v Consulte “Desinstalación del servidor de aplicaciones JBoss” en la página

80.b. Detenga el servidor de aplicaciones. Para obtener información detallada,

consulte la documentación del servidor de aplicaciones que utiliza.c. Detenga el servidor web. Para obtener información detallada, consulte la

documentación del servidor web que utiliza.


http://www.ibm.com/support/us/en/

3. Como paso opcional pero recomendado, realice una copia de seguridad delcontenido del directorio de instalación original de RTM. Este directorio incluyeel contenido estático.

4. Como paso opcional pero recomendado, realice una copia de seguridad de lasbases de datos operativos, geográficos y de metadatos. Para obtenerinformación detallada, consulte la documentación del producto de base dedatos que utiliza.

Procedimiento1. Inserte el disco del fixpack para el sistema operativo Windows o vaya a la

ubicación en la que ha descargado y extraído los archivos.2. En el disco o en la ubicación de descarga, vaya a directorio win32 y efectúe una

doble pulsación en el archivo issetup.exe.3. Siga las indicaciones del asistente de instalación y realice la instalación en la

misma ubicación que el producto Cognos Real-time Monitoring existente.El programa issetup le solicita que permita que el fixpack cree una copia deseguridad en la carpeta de instalación antes de copiar los archivos nuevos.

4. Despliegue la nueva versión del archivo EAR de Real-time Monitoring(Realtime.ear, Realtime-weblogic.ear, o Realtime-jboss5.ear) de acuerdo conlas instrucciones de su servidor de aplicaciones.v Consulte “Despliegue de Real-time Monitoring en IBM WebSphere

Application Server” en la página 43.v Consulte “Despliegue de Real-time Monitoring en un servidor de

aplicaciones Oracle WebLogic” en la página 59.v Consulte “Despliegue de Real-time Monitoring en un servidor de

aplicaciones JBoss” en la página 75.5. Asegúrese de que el servidor web apunte al directorio webcontent o copie el

directorio webcontent en la ubicación que utiliza el servidor web.

Qué hacer a continuación

Verifique que el fixpack se ha instalado correctamente:1. Reinicie el servidor web. Para obtener información detallada, consulte la

documentación del servidor web que utiliza.2. Reinicie el servidor de aplicaciones y la aplicación Real-time Monitoring. Para

obtener información detallada, consulte la documentación del servidor deaplicaciones que utiliza.

3. Inicie sesión en Real-time Monitoring Workbench y verifique que todos losobjetos anteriores todavía existan y que estén habilitados. Para obtener másinformación, consulte Capítulo 11, “Resolución de problemas de instalación”, enla página 97.

4. Inicie sesión en Real-time Monitoring Dashboard y verifique que todos lospaneles de control estén disponibles.

5. Si Cognos Business Intelligence (BI) 10.1 se ha integrado con Real-timeMonitoring, confirme que puede ver los objetos de paneles de control de BI.Para obtener más información, consulte el tema sobre configuración del sistemapara su integración con Cognos Workspace“” en la publicación Real-timeMonitoring Workbench Guía del usuario.

Si Cognos BI se ha integrado con Cognos Real-time Monitoring, actualice CognosBI al mismo nivel de fixpack.


Instalación de los fixpacks de UNIX y LinuxSiga estos pasos para instalar los fixpacks de IBM Cognos Real-time Monitoring ensistemas operativos en sistemas operativos UNIX y Linux.

Antes de empezar

Antes de instalar el fixpack:1. Como paso opcional pero recomendado, realice una copia de seguridad de los

metadatos y la configuración de Real-time Monitoring:a. Inicie IBM Cognos Real-time Monitoring Workbench utilizando un ID de

usuario con privilegios de administrador.b. En la pestaña Consola de administración, pulse el botón Valores del

sistema.c. En el menú desplegable de configuración, seleccione Configuración del

punto de comprobación.d. Pulse el botón Ejecutar punto de comprobación ahora.e. Vaya a la pestaña Consola de administración y pulse el botón

Importar/Exportar.f. En la ventana Importar/Exportar, seleccione la operación Exportar

metadatos a un archivo JAR (descargar).g. Establezca las opciones de exportación en Exportación personalizada y

seleccione todas las opciones disponibles.h. Pulse Aceptar. Se le solicitará una ubicación donde descargar el archivo en

su sistema.

Nota: Asegúrese de que no se bloqueen las ventanas emergentes.2. Detenga la aplicación Real-time Monitoring:

a. Detenga y retire el despliegue de Real-time Monitoring. Los pasos variaránen función del tipo de servidor de aplicaciones:v Consulte “Desinstalación de IBM WebSphere Application Server” en la

página 47.v Consulte “Desinstalación del servidor de aplicaciones Oracle WebLogic”

en la página 62.v Consulte “Desinstalación del servidor de aplicaciones JBoss” en la página

80.b. Detenga el servidor de aplicaciones. Para obtener información detallada,

consulte la documentación del servidor de aplicaciones que utiliza.c. Detenga el servidor web. Para obtener información detallada, consulte la

documentación del servidor web que utiliza.3. Como paso opcional pero recomendado, realice una copia de seguridad del

contenido del directorio de instalación original de RTM. Este directorio incluyeel contenido estático.

4. Como paso opcional pero recomendado, realice una copia de seguridad de lasbases de datos operativos, geográficos y de metadatos. Para obtenerinformación detallada, consulte la documentación del producto de base dedatos que utiliza.

Procedimiento1. Si va a utilizar un disco, monte el disco del fixpack que sea apropiado para su

sistema operativo UNIX o Linux, utilizando extensiones de archivo Rock Ridge.


Importante: Para montar el disco de IBM Cognos en HP-UX, lleve a cabo losiguiente:v Añada el directorio pfs_mount a su ruta.

Por ejemplo,PATH=/usr/sbin/:$PATHexport PATH

v Para iniciar los daemons de NFS necesarios y ejecutarlos en segundo plano,escriba bg pfs_mountd y, a continuación, bg pfsd.

v Para montar la unidad, escribapfs_mount -t rrip <device> <mount_dir> -o xlat=unix

Por ejemplo,pfs_mount -t rrip /dev/dsk/c0t2d0 /cdrom -o xlat=unix

Ahora ya puede instalar o copiar archivos como usuario distinto al usuarioroot utilizando un disco de IBM Cognos desde esta unidad.

v Cuando haya completado la instalación, escriba pfs_umount /cdrom y cancelelos daemons pfsd y pfs_mountd para desmontar el disco.

2. Si va a utilizar una descarga, vaya a la ubicación donde descargó y extrajo losarchivos del fixpack.

3. Para iniciar el asistente de instalación, escriba:./issetup

4. Siga las indicaciones del asistente de instalación para realizar la instalación enla misma ubicación que el producto Cognos Real-time Monitoring existente.El programa issetup le solicita que permita que el fixpack cree una copia deseguridad en la carpeta de instalación antes de copiar los archivos nuevos.

5. Despliegue la nueva versión del archivo EAR de Real-time Monitoring(Realtime.ear, Realtime-weblogic.ear, o Realtime-jboss5.ear) de acuerdo conlas instrucciones de su servidor de aplicaciones.v Consulte “Despliegue de Real-time Monitoring en IBM WebSphere

Application Server” en la página 43.v Consulte “Despliegue de Real-time Monitoring en un servidor de

aplicaciones Oracle WebLogic” en la página 59.v Consulte “Despliegue de Real-time Monitoring en un servidor de

aplicaciones JBoss” en la página 75.

Qué hacer a continuación

Verifique que el fixpack se ha instalado correctamente:1. Reinicie el servidor web. Para obtener información detallada, consulte la

documentación del servidor web que utiliza.2. Reinicie el servidor de aplicaciones y la aplicación Real-time Monitoring. Para

obtener información detallada, consulte la documentación del servidor deaplicaciones que utiliza.

3. Inicie sesión en Real-time Monitoring Workbench y verifique que todos losobjetos anteriores todavía existan y que estén habilitados. Para obtener másinformación, consulte Capítulo 11, “Resolución de problemas de instalación”, enla página 97.

4. Inicie sesión en Real-time Monitoring Dashboard y verifique que todos lospaneles de control estén disponibles.

5. Si Cognos Business Intelligence (BI) 10.1 se ha integrado con Real-timeMonitoring, confirme que puede ver los objetos de paneles de control de BI.


Para obtener más información, consulte el tema sobre configuración del sistemapara su integración con Cognos Workspace“” en la publicación Real-timeMonitoring Workbench Guía del usuario.

Si Cognos BI se ha integrado con Cognos Real-time Monitoring, actualice CognosBI al mismo nivel de fixpack.



Capítulo 5. Actualización desde una versión anterior oreinstalación de Real-time Monitoring

En esta sección se describe cómo actualizar a una nueva versión de IBM CognosReal-time Monitoring. Estos pasos también se aplican a la actualización desdeCognos Now! versión 4.5.2.2 hasta Real-time Monitoring.

Nota: Como preparativo ante cualquier posible problema que pudieraexperimentar durante la actualización, lea las notas de la versión antes de realizarla actualización.

Antes de empezar

Antes de iniciar una actualización, debe realizar una copia de seguridad de todoslos metadatos y de las bases de datos geográficas y operativas. También debeanotar u obtener una captura de pantalla de las configuraciones de los orígenes dedatos y de la configuración del proveedor de autenticación.

Procedimiento1. Inicie la sesión en IBM Cognos Real-time Monitoring Workbench.2. Exporte los metadatos de Real-time Monitoring utilizando la característica de

importación/exportación tal y como se describe en la Guía del usuario de IBMCognos Real-time Monitoring Workbench.

3. Anote los valores existentes del sistema que desee reutilizar. Para visualizarlos valores del sistema, pulse el botón Valores del sistema.

4. Detenga Real-time Monitoring.5. Suprima las tablas de la base de datos de metadatos.

Las bases de datos operativas y geográficas de las versiones anteriores puedenseguir utilizándose. Para mantener intacta la base de datos de metadatosanterior, cree y especifique un esquema de base de datos distinto al configurarla nueva versión; sin embargo, no deberá suprimir la base de datos decontexto ni ninguna otra base de datos personalizada.

6. Realice los pasos para la desinstalación de IBM Cognos Real-time Monitoringtal como se describe para cada servidor de aplicaciones. Sólo debe desinstalarel archivo EAR. Si no puede ejecutar el programa de desinstalación porqueestá desinstalando una versión anterior del software, puede suprimir losarchivos de aplicación manualmente.v Consulte “Desinstalación de IBM WebSphere Application Server” en la

página 47.v Consulte “Desinstalación del servidor de aplicaciones Oracle WebLogic” en

la página 62.v Consulte “Desinstalación del servidor de aplicaciones JBoss” en la página

80.7. Ejecute el instalador de Real-time Monitoring.

Para obtener más información, consulte Capítulo 4, “Instalación yconfiguración de los servidores de aplicación”, en la página 17.

8. Despliegue la nueva versión del archivo EAR para IBM Cognos Real-timeMonitoring en el servidor de aplicaciones:


v Consulte “Despliegue de Real-time Monitoring en IBM WebSphereApplication Server” en la página 43.

v Consulte “Despliegue de Real-time Monitoring en un servidor deaplicaciones Oracle WebLogic” en la página 59.

v Consulte “Despliegue de Real-time Monitoring en un servidor deaplicaciones JBoss” en la página 75.

Nota: No es necesario configurar las conexiones de los orígenes de datos en elservidor de aplicaciones. Puede utilizar las conexiones que ya se habíanconfigurado antes de la instalación. Si no ha suprimido las tablas demetadatos existentes, cambie la conexión de origen de datos para losmetadatos por un esquema de base de datos distinto. Las versiones anterioresdel esquema de metadatos no son compatibles con la nueva versión.

9. Inicie la sesión en IBM Cognos Real-time Monitoring Workbench.

Nota: Puede que deba volver a configurar los valores iniciales tal como sedescribe en la sección “Configuración de Real-time Monitoring en IBM CognosReal-time Monitoring Workbench” en la página 93.

10. Si los usuarios existen en un servidor LDAP (Lightweight Directory AccessProtocol), en un servidor ADS (Active Directory Service) o en IBM TivoliDirectory Server, debe utilizar esos sistemas para sincronizar todos losusuarios, roles y pertenencias a roles.

11. Importe los metadatos que ha exportado en el primer paso de esteprocedimiento.Utilice la característica Importar/Exportar en IBM Cognos Real-timeMonitoring Workbench tal como se describe en la Guía del usuario de IBMCognos Real-time Monitoring Workbench.

12. Para verificar la instalación, inicie la sesión en Real-time Monitoring comortmadmin.


Capítulo 6. Instalación de Real-time Monitoring en IBMWebSphere Application Server

En esta sección se describe cómo instalar, desplegar y desinstalar IBM CognosReal-time Monitoring en IBM WebSphere Application Server.

Instalación y despliegue de Real-time Monitoring en IBM WebSphereApplication Server

IBM Cognos Real-time Monitoring puede instalarse y desplegarse en IBMWebSphere Application Server.

Ya deberá haber ejecutado el instalador de Real-time Monitoring en el servidor deaplicaciones. Para obtener más información, consulte “Instalación de loscomponentes del servidor de aplicaciones de Real-time Monitoring” en la página17.

Revisión y verificación de los requisitos para IBM WebSphereEn esta sección se describen los requisitos para instalar y desplegar IBM CognosReal-time Monitoring en IBM WebSphere Application Server.

En esta sección se da por supuesto que está familiarizado con IBM WebSphere.Específicamente, debe saber cómo realizar lo siguiente:v Utilizar la consola administrativa de IBM WebSphere.v Crear un ámbito de servidor dedicado.v Establecer una ruta de clase.v Configurar un nuevo proveedor JDBC.

Instalación de IBM WebSphere Application ServerInstale el IBM WebSphere Application Server adecuado y soportado, tal como seespecifica en el centro del cliente de IBM Cognos.

Para obtener más información, consulte “Revisión de los entornos soportados” enla página 13.

Controladores JDBC (Java Database Connectivity)Instale el controlador JDBC (Java Database Connectivity) correcto para las bases dedatos de metadatos utilizadas.

A continuación se indican las distintas bases de datos que puede utilizar para lastablas de metadatos.v IBM DB2v SQL Server 2000 con SP3 o posteriorv SQL Server 2005v SQL Server 2008v MySQL 5.0 o posteriorv PostgreSQLv Oracle 9.2 o posterior


Además de las bases de datos indicadas anteriormente, puede acceder a otrasbases de datos, siempre que exista un controlador de Tipo 4 para la base de datosque desea utilizar. Sin embargo, sólo se han certificado las bases de datosanteriormente indicadas.

Consulte los sitios web siguientes para determinar cuál es el controlador de basede datos adecuado para la base de datos que utiliza. Los controladores de Tipo 4son la opción de preferencia para IBM Cognos Real-time Monitoring. Obtenga elcontrolador JDBC de cliente de la instalación o proveedor del servidor de bases dedatos al que ha planificado acceder:v Para IBM WebSphere 6.0, consulte

http://www.ibm.com/support/docview.wss?&uid=swg27007298v Para IBM WebSphere 6.1, consulte

http://www.ibm.com/support/docview.wss?&uid=swg27007642v Para IBM WebSphere 7.1, consulte

http://www.ibm.com/support/docview.wss?&uid=swg27012369

Seleccione el sistema operativo correcto y consulte la sección que trata acerca delos controladores JDBC.

Configuración preliminar de Real-time Monitoring enWebSphere

Revise los requisitos, las recomendaciones y las limitaciones siguientes paratenerlos en cuenta e instalar y desplegar IBM Cognos Real-time Monitoringcorrectamente en IBM WebSphere Application Server.

Cree una instancia de servidor dedicada en IBM WebSphere Application Serverpara la instalación de IBM Cognos Real-time Monitoring. Encontrará instruccionesdetalladas para crear una nueva instancia de servidor en las ubicaciones que seindican en la tabla siguiente.

Tabla 5. Información adicional sobre IBM WebSphere Application Server

Versión Enlace con documentación en línea

6.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0

Seleccione WebSphere Application Server > Configuración delentorno de servicio de aplicaciones > Creación y supresión deperfiles.


Seleccione WebSphere Application Server > Configuración delentorno de servicio de aplicaciones > Creación y supresión deperfiles.


Seleccione WebSphere Application Server > Configuración delentorno de servicio de aplicaciones > Gestión de perfiles.

Si utiliza las versiones Network Deployment o Extended Deployment de IBMWebSphere Application Server, debe crear un ámbito de servidor dedicado para eldespliegue de Real-time Monitoring. Todas las actividades de instalación deReal-time Monitoring deben realizarse dentro del ámbito de este servidor.


http://www-01.ibm.com/support/docview.wss?rs=180&uid=swg27007298



http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/topic/com.ibm.websphere.base.doc/info/aes/ae/tpro_profiles.html






http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tpro_profiles.html

http://publib.boulder.ibm.com/infocenter/wasinfo/v7r0/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tpro_profiles.html

Debe localizar el archivo Realtime.ear, que se encuentra en el directorioubicación_c10/realtime/bin64, para el servidor. Se utilizará durante el despliegue.

Nota: Si utiliza IBM WebSphere Application Server versión 7 o posterior, el archivolog4j y el paquete JaxB que se entregan con WebSphere no son compatibles conReal-time Monitoring. Para evitar problemas relacionados con estaincompatibilidad, debe copiar los siguientes archivos JAR, que se encuentran en eldirectorio ubicación_c10/realtime/bin64, en el directorio endorsed del servidor deaplicaciones: log4j-1.2.7.jar, jaxb-api.jar, jaxb-impl.jar, jaxb-xjc.jar y jaxb1-impl.jar. Siel directorio endorsed no existe en el servidor de aplicaciones, deberá crearlo. Eldirectorio endorsed puede encontrarse en la ubicación siguiente:v En sistemas operativos Windows: C:\Archivos de programa\ibm\WebSphere\

AppServer\java\jre\lib\endorsed

v En sistemas operativos UNIX o Linux: /opt/IBM/WebSphere/AppServer/java/jre/lib/endorsed

Modificación de los valores de configuración de la máquinavirtual Java en WebSphere

En esta sección se describe cómo modificar los valores de configuración de JVM(máquina virtual Java) por medio de la consola administrativa de IBM WebSphereApplication Server.

En la consola administrativa de IBM WebSphere, en el cuadro de los argumentosJVM genéricos, debe especificar cada uno de los argumentos JVM necesarios, quedeberán separarse mediante un espacio. Puesto que WebSphere tiene valoresespecíficos para el almacenamiento dinámico inicial y el almacenamiento dinámicomáximo, debe especificar los valores -Xms y -Xmx en esos campos específicos.Encontrará instrucciones detalladas para establecer los parámetros JVM en lasubicaciones que se indican en la tabla siguiente.

Tabla 6. Enlaces con información adicional para establecer los parámetros de JVM



Seleccione WebSphere Application Server > Configuración del entornode servicio de aplicaciones > Administración de servidores deaplicaciones > Configuración de la JVM.





Existen valores específicos que corresponden a la asignación de RAM. Para evitarintentos de reasignación de memoria, -Xms y -Xmx deben establecerse en el mismovalor: la cantidad de memoria mínima y máxima que ha de asignarse al servidorde Real-time Monitoring. Para un servidor con 16 GB de RAM, el valor preferidoes un mínimo de 12 GB. Por lo general, es preferible asignar un número querepresente aproximadamente 3/4 de la RAM total.

Capítulo 6. Instalación de Real-time Monitoring en IBM WebSphere Application Server 33

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/topic/com.ibm.websphere.base.doc/info/aes/ae/trun_jvm.html









Establezca -Xmxns y -Xmxnx en el mismo valor. El número debe ser 1/4 del tamañoseleccionado para -Xms.

En la siguiente tabla se proporcionan ejemplos de los valores de parámetros que seutilizarían para un tamaño de memoria de 16 GB y de 32 GB.

Tabla 7. Ejemplos de valores de parámetros de JVM

Memoria Valor de parámetro

16 GB -Xms12288M

-Xmx12288M

-Xmns3072M

-Xmnx3072M

32 GB -Xms24576M

-Xmx24576M

-Xmns6144M

-Xmnx6144M

También debe especificar los valores de la recogida de basura. La entrada-Xgcthreads8 debe ser igual al número de núcleos de procesador disponibles. Porejemplo, si existen dos procesadores de doble núcleo, especifique -Xgcthreads4. Siexisten 4 procesadores de doble núcleo, o 2 procesadores de núcleo cuádruple,especifique -Xgcthreads8.

Los valores -verbose:sizes y -verbose:gc son útiles en la determinación deproblemas de recogida de basura durante la ejecución. También deben establecerse.El último valor debe apuntar al directorio de registro; por ejemplo:

-xverbosegclog:"c:/program files/ibm/cognos/c10_64/realtime/logs"

Si existe un espacio en la ruta, la totalidad del parámetro deberá especificarse entrecomillas. En el nombre de la ruta, utilice barras inclinadas hacia la derecha (/) enlugar de barras inclinadas invertidas (\).

Procedimiento1. Inicie la consola administrativa de IBM WebSphere.2. Incluya el archivo obiProperties.jar que se encuentra en el directorio

ubicación_c10/realtime/bin64 en la ruta de clase de la máquina virtual Java.v Por ejemplo, en un servidor que ejecuta el sistema operativo Windows,

especifique:c:/Archivos de programa/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux,especifique:/opt/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar

3. Si utiliza las versiones Network Deployment o Extended Deployment de IBMWebSphere Application Server, añada los siguientes valores a la ruta de clasede la máquina virtual Java antes de crear los agentes de servicio web:


v ubicación_c10/realtime/bin64/wsdl4j.jar

v ubicación_c10/realtime/bin64/wsif.jar

v ubicación_instalación_WebSphere/optionalLibraries/Apache/Struts/1.2.9/commons-logging.jar

4. Establezca los parámetros de JVM de modo que se haga un uso óptimo de lamemoria y la recogida de basura (GC). A continuación se indican losparámetros de JVM de ejemplo recomendados para ejecutar Real-timeMonitoring en IBM Java para WebSphere:-Xms24576M

-Xmx24576M

-Xmns6144M

-Xmnx6144M

-verbose:sizes

-verbose:gc

-Xgcthreads8

-Xgcpolicy:gencon

-Xcompactgc

-Xalwaysclassgc

-Xverbosegclog:/var/log/realtime/realtime-gc.log

Nota: Escriba la entrada de -Xms en el cuadro del almacenamiento dinámicoinicial. Escriba la entrada de -Xmx en el cuadro del almacenamiento dinámicomáximo. No repita estas entradas en el cuadro de los argumentos JVMgenéricos.

5. Asegúrese de que la propiedad com.cognos.obi.bootstrap.envpropname se haestablecido en BOOTPROPS y de que la propiedad BOOTPROPS de la JVMapunta al archivo realtime.properties que ha editado durante la preparaciónpara la instalación.-DBOOTPROPS=<c10_location>/realtime/configuration/realtime.properties

-Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS

donde <ubicación_c10> especifica la ubicación del archivo realtime.propertiesque contiene las propiedades de inicialización.

6. Establezca el tipo de codificación de archivos en UTF8.-Dfile.encoding=utf8

7. Opcionalmente, establezca la propiedad anonymousaccessenabled en true parahabilitar el inicio de sesión anónimo. Establezca esta propiedad en false parainhabilitar el inicio de sesión anónimo. Cuando se ha habilitado estapropiedad, en la pantalla de inicio de sesión se muestra el enlace Iniciarsesión como usuario anónimo.-Danonymousaccessenabled=true

Con el inicio de sesión anónimo habilitado, puede iniciar la sesiónautomáticamente en IBM Cognos Real-time Monitoring Dashboard o en IBMCognos Real-time Monitoring Workbench sin especificar un nombre deusuario y contraseña mediante la utilización de la URL siguiente:http://nombre_servidor/cognos/realtime/landing/landingpage.htmEsto le permite seleccionar la aplicación. Si ha configurado el servidor paraque utilice un puerto distinto del puerto predeterminado, puede que debaespecificar el puerto.

8. Opcionalmente, si se necesitan conexiones http salientes, como conexiones conservicios web o con servicios de codificación geográfica, para poder atravesar


un servidor proxy desde el entorno de servidor, añada la propiedad JVMsiguiente al script de inicio con el fin de que la capa de conectividad de Javautilice el servidor proxy para todas las llamadas salientes.-Dhttp.proxyHost=<fully qualified server name of http proxy>

-Dhttp.proxyPort=<http proxy port number>

-Dhttps.proxyHost=<fully qualified server name of https proxy>

-Dhttps.proxyPort=<https proxy server port>

Nota: No están soportados los servidores proxy que necesitan autenticación.9. Guarde la nueva configuración.

10. Opcionalmente, establezca los parámetros de idioma y de entorno local talcomo se describe en “Establecimiento de parámetros de idioma y de entornolocal para Real-time Monitoring en WebSphere Application Server”.Sólo será necesario que realice este paso si desea inicializar los metadatos enun entorno local distinto del entorno local predeterminada del servidor.

11. Guarde los cambios.12. Reinicie IBM WebSphere Application Server.

Establecimiento de parámetros de idioma y de entorno local paraReal-time Monitoring en WebSphere Application ServerPuede establecer parámetros opcionales para la base de datos de metadatos,incluidos el idioma, el país o región y el nivel de clasificación.

Los valores predeterminados se basan en los valores de entorno local del servidor.Debe establecer estos valores predeterminados antes de iniciar el servidor deaplicaciones por primera vez. Estos parámetros se añaden al script de inicio delservidor de aplicaciones y utilizan el formato básico siguiente:

-Dcom.cognos.obi.property.[PARÁMETRO]=[VALOR]

En la tabla siguiente se describe cada parámetro. A continuación de esta tabla seproporcionan procedimientos específicos para establecer los parámetros en laconfiguración del servidor de aplicaciones.

Tabla 8. Valores de parámetros opcionales para la base de datos de metadatos deWebSphere Application Server

Parámetro Descripción

LOCALE_LANGUAGE Código de idioma ISO de dos caracteres para elservidor.

Por ejemplo, para establecer el parámetro LANGUAGEen Portugués, debe añadir el comando siguiente:

-Dcom.cognos.obi.property.LOCALE_LANGUAGE=PTNota: El comando -D ha de anteponerse al valor.

LOCALE_REGION Código de país o región ISO de dos caracteres para elservidor.

Por ejemplo, para establecer el parámetro de país oregión en Brasil, debe añadir el comando siguiente:

-Dcom.cognos.obi.property.LOCALE_REGION=BR


Tabla 8. Valores de parámetros opcionales para la base de datos de metadatos deWebSphere Application Server (continuación)


LOCALE_COLLATION Se establece en true o false para indicar si han derealizarse o no comparaciones de cadenas dependientesdel entorno local. (El valor predeterminado es false.)

COLLATE_STRENGTH Especifica el nivel de clasificación, es decir, el grado decomparación y clasificación de los caracteres noingleses; los niveles de clasificación son: primario,secundario, terciario o idéntico. El nivel de clasificaciónprimario es el menos discriminante y el nivel declasificación idéntico es el más discriminante. (El valorpredeterminado es terciario.) Para obtener másinformación acerca de los parámetros de ordenación,consulte la documentación de Java en:

http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.htmlNota: Este valor sólo tiene efecto siLOCALE_COLLATION se ha establecido en true.

COLLATE_DECOMPOSITION Especifica uno de los modos de descomposición declasificación siguientes: ninguno, canónico o completo.(El valor predeterminado es canónico.) Para obtenermás información acerca de los parámetros deordenación, consulte la documentación de Java en:

http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.htmlNota: Este valor sólo tiene efecto siLOCALE_COLLATION se ha establecido en true.

Procedimiento1. En la consola administrativa de IBM WebSphere, vaya a Argumentos de JVM

genéricos.2. Añada valores de parámetros utilizando la sintaxis siguiente:

com.cognos.obi.property.[PARAMETER]=[VALUE]

Nota: Para delimitar varios valores, utilice un espacio. El comando -D ha deanteponerse a cada valor.

3. Guarde los cambios.4. Reinicie WebSphere Application Server.

Resultados

Los cambios realizados en las propiedades de la JVM se han establecido.

Creación y configuración de la conexión de metadatos enWebSphere

Esta sección contiene las tareas que deberá llevar a cabo para configurar laconexión de metadatos en IBM WebSphere Application Server. El almacén de basede datos ya deberá existir.


http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.html




Creación de un alias JAAS (Java Authentication andAuthorization Service) para todas las bases de datosMediante la creación de un alias de autenticación conforme a la cuenta de usuariodedicada para la base de datos, puede eliminar la necesidad de tener queconfigurar posteriormente propiedades personalizadas para estos parámetros.

Se hará referencia a este alias en la configuración.

Procedimiento1. Inicie IBM WebSphere Application Server y abra la consola administrativa de

IBM WebSphere.2. Cree un nuevo alias JAAS con los valores siguientes y pulse Aceptar.

Tabla 9. Valores de alias JAAS

Campo Descripción

Alias Cualquier valor. Se utilizará para configurar un proveedor JDBC.

ID de usuario ID de usuario válido para la base de datos seleccionada.

Contraseña Contraseña válida para el ID de usuario.

Descripción Descripción de texto opcional.

Resultados

Ahora, el nuevo alias se muestra en la lista.

Configuración de un nuevo proveedor JDBC (Java DatabaseConnectivity)En la consola administrativa de IBM WebSphere, debe configurar un nuevoproveedor JDBC (Java Database Connectivity).

Encontrará instrucciones detalladas para crear un nuevo proveedor JDBC en lasubicaciones que se indican en la tabla siguiente.

Tabla 10. Enlaces con información adicional sobre proveedores de JDBC



Seleccione WebSphere Application Server y busque el tema que trataacerca de la configuración de un proveedor JDBC y un origen de datos.





Procedimiento1. Seleccione un tipo de base de datos soportado y el proveedor JDBC, tal como

se indica en la tabla siguiente:


http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/topic/com.ibm.websphere.base.doc/info/aes/ae/tdat_tccrtprovds.html


http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tdat_tccrtprovds.html




Tabla 11. Proveedor de JDBC soportado

Base de datos Proveedor JDBC

DB2 Proveedor de controlador JDBC universal de DB2

Microsoft SQL Server Controlador JDBC Connect incorporado de IBM WebSphere paraMicrosoft SQL Server

Microsoft SQL Server(WAS 7)

Controlador JDBC de Microsoft SQL Server

MySQL Seleccione Proveedor de JDBC definido por el usuario yespecifique el nombre de clase de implementación para MySQL:com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource

PostgreSQL Seleccione Proveedor de JDBC definido por el usuario yespecifique el nombre de clase de implementación paraPostgreSQL: org.postgresql.jdbc2.optional.ConnectionPool

Oracle Controlador JDBC de Oracle

2. En las opciones de tipo de implementación, seleccione Origen de datos de laagrupación de conexiones.

3. Al definir los valores de la ruta de clase, utilice la configuración siguientesegún proceda, sustituyendo [FILE_PATH] por valores reales:

Tabla 12. Valores de ruta de clase para bases datos soportadas

Base de datos Valor de adición a ruta de clase

DB2 [RUTA_ARCHIVO]/db2jcc.jar

[RUTA_ARCHIVO]/db2jcc_license_cu.jar

Para WebSphere Network Deployment Versión 7.0y DB2 ESE 9.7, utilice db2jcc4.jar.

Microsoft SQL Server 2005 y 2008 (IBMWebSphere 7)

Establezca el valor de la ruta de clase ensqljdbc4.jar. (Sólo funciona con JDK1.6.)

Microsoft SQL Server 2005 (sólo IBMWebSphere 6.1.x)

Para Microsoft SQL Server 2005, conserve intactoslos controladores nativos predeterminados:sqlserver.jar, base.jar y util.jar.

Microsoft SQL Server 2000 ubicación_archivo/mssqlserver.jar

ubicación_archivo/msbase.jar

ubicación_archivo/msutil.jar

Asegúrese de que se han suprimido todas lasdemás entradas para los mismos JAR.

MySQL 5.0 o posterior ubicación_archivo/mysql-connector-java-[versión]-bin.jar

PostgreSQL ubicación_archivo/postgresql-[versión].jdbc3.jar


Tabla 12. Valores de ruta de clase para bases datos soportadas (continuación)

Base de datos Valor de adición a ruta de clase

Oracle ubicación_archivo/ojdbc14.jar (para Oracle 10g.)

ubicación_archivo/ojdbc6.jar (para Oracle 11g. Sólofunciona con JDK1.6).

4. Para los clientes gruesos de DB2 (Tipo 2) y Oracle (Tipo 2), establezca la ruta dela biblioteca nativa de modo que apunte al cliente de la instalación.

5. Guarde la nueva configuración del proveedor.Ahora puede configurar el origen de datos, tal como se describe en la sección“Definición del origen de datos de IBM WebSphere”.

Definición del origen de datos de IBM WebSphereEsta sección describe cómo definir el origen de datos para la nueva configuracióndel proveedor JDBC (Java Database Connectivity).

Encontrará instrucciones detalladas en las ubicaciones que se indican en la tablasiguiente.

Tabla 13. Enlaces con información adicional acerca de JDBC



Seleccione WebSphere Application Server y busque el tema quetrata acerca de la configuración de un proveedor JDBC y unorigen de datos.





Procedimiento1. Especifique los valores que se indican a continuación:

Tabla 14. Valores de origen de datos JDBC

Valor Valor

Nombre com.cognos.obi.metadata.metaDatasource

Nombre JNDI com.cognos.obi.metadata.metaDatasource

Persistencia gestionada porcontenedor

Elimine la selección de la casilla de verificación











Tabla 14. Valores de origen de datos JDBC (continuación)

Valor Valor

Sólo Oracle 10g Para Oracle, especifique el nombre de clase ayudante deorigen de datos siguiente:

Seleccione el ayudante de almacén de datos Oracle10g

Oracle 11g Seleccione el ayudante de almacén de datos Oracle11g (sólose soporta en WAS7.x)

Microsoft SQL Server Para Microsoft SQL Server, utilice el valor predeterminadoseleccionado:

Ayudante de almacén de datos de Microsoft SQL Server

Alias de autenticacióngestionada por componente

Seleccione el valor que ha creado en “Creación de un aliasJAAS (Java Authentication and Authorization Service) paratodas las bases de datos” en la página 38.

2. Configure las propiedades para el origen de datos de los metadatoscom.cognos.obi.metadata.metaDatasource tal como se describe en la tablasiguiente.

Tabla 15. Valores de propiedades de origen de datos de los metadatos

Tipo de base de datos

Propiedadpredeterminada/personalizada Valor

DB2 (Tipo 4) serverName Especifique el nombre de host o la dirección IPdel sistema en el que se ejecuta la base dedatos.

portNumber Especifique el número de puerto en el que seejecuta DB2. (Por lo general es 50000, aunquesu configuración podría diferir.)

databaseName Especifique el nombre de la base de datos.

Microsoft SQL Server(2000, 2005 y 2008)

serverName Especifique el nombre de host o la dirección IPdel sistema en el que se ejecuta la base dedatos.

portNumber Especifique el número de puerto desde el quese ejecuta Microsoft SQL Server. (Por logeneral es 1433, aunque su configuraciónpodría diferir.)

databaseName Especifique el nombre de la base de datos.

selectMethod Opcionalmente, para selectMethod, seleccione"cursor".

MySQL 50 o posterior URL jdbc:mysql://[nombre_host]:[puerto]/[nombre_esquema]


Tabla 15. Valores de propiedades de origen de datos de los metadatos (continuación)

Tipo de base de datos

Propiedadpredeterminada/personalizada Valor

PostgreSQL URL jdbc:postgresql://[host_base_datos]:[puerto]/[nombre_base_datos]

Oracle URL Controlador ligero:

jdbc:oracle:thin:@[host name]:[port]:[SID]

Por ejemplo:jdbc:oracle:thin:@orclhost:1521:orcl

Controlador grueso (OCI):

jdbc:oracle:oci:@[tnsalias]

Por ejemplo: jdbc:oracle:oci:@RTMtns

driverType Especifique "thin" para ligero u "oci" paragrueso, según proceda.

3. Pulse Aceptar para guardar la nueva configuración del proveedor.4. Pruebe la nueva conexión.

Definición de orígenes de datos en WebSpherePara la instalación, debe definir los dos orígenes de datos siguientes: un origen dedatos para los mapas geográficos y un origen de datos operativo.

Opcionalmente, puede definir orígenes de datos para los agentes JDBC (JavaDatabase Connectivity).

Definición del origen de datos para mapas geográficosDebe definir un origen de datos para los mapas geográficos.

Para configurar el soporte para los mapas geográficos, siga los pasoscorrespondientes a la creación de un origen de datos con IBM WebSphereApplication Server que se describen en la sección “Creación y configuración de laconexión de metadatos en WebSphere” en la página 37. Sin embargo, deberáespecificar el nombre y el nombre JNDI (Java Naming and Directory Interface(JNDI) con nombre como com.cognos.obi.geo.geoDatasource.

Definición de un origen de datos operativosUn origen de datos operativos es un repositorio de base de datos que se utilizapara almacenar y hacer persistentes los datos de búsqueda.

Para configurar el origen de datos operativos, siga los mismos pasos que los queha utilizado para crear un origen de metadatos. Sin embargo, deberá especificar elnombre y el nombre JNDI (Java Naming and Directory Interface) con nombrecomo com.cognos.obi.operational. Para crear un origen de datos, siga elprocedimiento que se describe en “Creación y configuración de la conexión demetadatos en WebSphere” en la página 37


Definición de orígenes de datos opcionales adicionalesPara cada agente JDBC (Java Database Connectivity) (por ejemplo, para acceder alflujo de datos o a los datos de la tabla de consulta) que crea en IBM CognosReal-time Monitoring Workbench, cree un origen de datos en la instalación de IBMWebSphere.

Para la conexión con los orígenes de datos JDBC es preferible utilizar el nombreJNDI (Java Naming and Directory Interface) con agrupaciones de conexiones. Elnombre JNDI que aquí se especifica se utiliza desde Real-time MonitoringWorkbench al configurar un agente JDBC. Si no existe un controlador deagrupación de conexiones disponible, una alternativa es especificar una conexiónbasada en URL desde Real-time Monitoring Workbench. El nombre JNDI (JavaNaming and Directory Interface) debe ser exclusivo para cada origen de datos.Para crear un origen de datos, siga el procedimiento que se describe en “Creacióny configuración de la conexión de metadatos en WebSphere” en la página 37

Despliegue de Real-time Monitoring en IBM WebSphereApplication Server

En esta sección se describe el proceso para desplegar IBM Cognos Real-timeMonitoring en el servidor de aplicaciones.

Para obtener más información acerca del despliegue de aplicaciones en IBMWebSphere Application Server, consulte la tabla siguiente.

Tabla 16. Enlaces a información adicional sobre el despliegue de aplicaciones en IBMWebSphere Application Server


6.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/

Seleccione WebSphere Application Server y busque el temaque trata acerca de la instalación de archivos de aplicaciónJ2EE.


Seleccione WebSphere Application Server y busque el temaque trata acerca de la instalación de archivos de aplicaciónJ2EE.


Seleccione WebSphere Application Server y busque el temaque trata acerca de la instalación de archivos de aplicaciónempresarial.

Procedimiento1. Inicie IBM WebSphere Application Server, si no está en ejecución actualmente, y

abra la consola administrativa de IBM WebSphere.2. Expanda el nodo Aplicaciones y pulse Aplicaciones de empresa.

Esta acción visualizará la página de las aplicaciones empresariales.3. Pulse el botón Instalar.4. Seleccione ubicación_c10/realtime/bin64/Realtime.ear en el soporte o disco de

instalación.donde ubicación_c10 es la ubicación en la que se ha instalado IBM CognosReal-time Monitoring.


http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/topic/com.ibm.websphere.base.doc/info/aes/ae/trun_app_install.html









5. Pulse Siguiente.6. Al preparar la página de instalación de la aplicación que se visualiza, seleccione

la opción Generar enlaces predeterminados y pulse Siguiente.7. Para conservar los valores predeterminados en todos los demás pasos, puede

dirigirse directamente al paso final y pulsar Finalizar.IBM WebSphere instala IBM Cognos Real-time Monitoring.Después de haber confirmado el despliegue, configure el servidor web para lagestión del contenido estático. Para obtener información acerca de laconfiguración del contenido estático, consulte Capítulo 9, “Instalación,configuración y desinstalación de los archivos de servidor web de Real-timeMonitoring”, en la página 83

8. Inicie IBM Cognos Real-time Monitoring en IBM WebSphere Application Server.Después de haber configurado IBM WebSphere Application Server y de haberdesplegado Real-time Monitoring, debe iniciar Real-time Monitoringdirectamente en el servidor de aplicaciones.

Configuración del servidor de aplicaciones para la gestión delcontenido dinámico

En esta sección se describe cómo configurar el servidor de aplicaciones para lagestión del contenido dinámico.

Sin embargo, para poder configurar el contenido dinámico, primero deberáconfigurar el contenido estático tal como se describe en Capítulo 9, “Instalación,configuración y desinstalación de los archivos de servidor web de Real-timeMonitoring”, en la página 83.

Será necesario configurar el servidor de aplicaciones para la gestión del contenidodinámico porque, para enviar las solicitudes desde el servidor web hasta IBMWebSphere Application Server, se utiliza el conector del servidor web. El conectordel servidor web se instala en el sistema servidor web. Sin embargo, el archivo deconfiguración (plugin-cfg.xml) para el conector se genera por medio de WebSphereApplication Server y, a continuación, se mueve a la ubicación adecuada en elservidor web. Para obtener más información acerca del archivo plugin-cfg.xml,consulte el tema siguiente: http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/topic/com.ibm.websphere.express.doc/info/exp/ae/rwsv_plugincfg.html.

Nota: Para manejar contenido dinámico, debe realizar estos pasos adicionales sóloen IBM WebSphere Application Server. Estos pasos no son necesarios en el servidorde aplicaciones JBoss ni en el servidor de aplicaciones Oracle WebLogic.

Procedimiento1. Asegúrese de que ha desplegado el archivo EAR en IBM WebSphere

Application Server.2. Vaya a la consola administrativa de IBM WebSphere Application Server,

seleccione Entorno. Pulse Actualizar configuración global de plug-in deservidor Web.IBM WebSphere Application Server actualizará el archivo de conector para queel servidor web pueda servir contenido estático. Ahora, el servidor web puededevolver URI dinámicos para los servlets y las JSP a IBM WebSphere.

3. Copie el archivo de configuración del conector en el servidor web remoto. Elarchivo de configuración es <WAS_HOME>/profiles/<nombre_perfil>/config/cells/plugin-cfg.xml.


http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/rwsv_plugincfg.html

http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/rwsv_plugincfg.html

Nota: Si el servidor web se ha instalado en el mismo sistema que el servidorde aplicaciones, especifique la ubicación del archivo plugin-cfg.xml en elarchivo realtime.conf. Consulte Capítulo 9, “Instalación, configuración ydesinstalación de los archivos de servidor web de Real-time Monitoring”, en lapágina 83 para obtener más información acerca del archivo realtime.conf.

Resultados

Después de haber confirmado el despliegue, configure el servidor web para lagestión del contenido estático. Para obtener información acerca de la configuracióndel contenido estático, consulte Capítulo 9, “Instalación, configuración ydesinstalación de los archivos de servidor web de Real-time Monitoring”, en lapágina 83.

Prueba de Real-time Monitoring tras la instalación en IBM WebSphereApplication Server

Después de haber instalado IBM Cognos Real-time Monitoring en el servidor deaplicaciones y el servidor web, puede probar la instalación instalando y utilizandolos ejemplos que se han empaquetado con el producto.

Procedimiento1. Validar que el contenido estático y dinámico se ha configurado correctamente.

Consulte “Verificación de la configuración para el contenido estático ydinámico” en la página 90.

2. Opcionalmente, cargar los ejemplos. Consulte “Carga de los ejemplos deReal-time Monitoring en IBM WebSphere Application Server”.

3. Iniciar Real-time Monitoring Workbench e importar los metadatos de ejemplo.Consulte “Importación de los metadatos de ejemplo en Real-time Monitoring”en la página 46.

Carga de los ejemplos de Real-time Monitoring en IBMWebSphere Application Server

Cargue datos en IBM WebSphere Application Server para comprobar que laaplicación funciona.

El directorio ubicación_c10/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/data contiene el esquema de base de datos Derby que contendrálas tablas, datos y activadores de demostración del centro de asistencia telefónica.Esta demostración necesita el controlador Apache Derby 10.5.3. Para obtenerinformación acerca de la descarga de un controlador Apache Derby actualizado,consulte la dirección:

http://db.apache.org/derby/derby_downloads.html

El directorio ubicación_c10/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/metadata contiene una exportación del modelo de objetosutilizado para la demostración del centro de asistencia telefónica; es independientede la base de datos.

Procedimiento1. Localice los archivos de ejemplo en el directorio ubicación_c10/realtime/

webcontent/samples/sdk.


2. Copie la base de datos ubicación_c10/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/data/ccdemo en el siguiente directorio de IBMWebSphere Application Server.ubicación_instalación_WebSphere/AppServer/derby/databases

3. Copie el archivo derby.jar actualizado que ha descargado desde el sitio delsoporte de Apache en el directorio derby/lib; es decir, en el directorioubicación_instalación_WebSphere/AppServer/derby/lib.

4. Mediante la utilización de la consola administrativa de IBM WebSphere, cree unorigen de datos con las siguientes propiedades generales.

Tabla 17. Propiedades del origen de datos de ejemplos de Real-time Monitoring en IBM WebSphere ApplicationServer

Propiedad general Valor

Ámbito cells:nombre_máquinaNode01Cell:nodes:nombre_máquinaNode01:servers:server1

Nombre com.cognos.obi.demo.ccdemo

Nombre JNDI com.cognos.obi.demo.ccdemo

Proveedor Proveedor de Derby JDBC

Nombre de base de datos ubicación_instalación_WebSphere/AppServer/derby/databases/ccdemo

Asegúrese de seleccionar el ayudante de almacén de datos Derby como clasede ayudante de almacén de datos.

5. Pruebe la conexión y guarde el trabajo.6. Reinicie IBM WebSphere Application Server.

Resultados

Tras haber preparado los orígenes de datos de ejemplo, puede importar losmetadatos de ejemplo.

Importación de los metadatos de ejemplo en Real-timeMonitoring

Mediante la utilización de IBM Cognos Real-time Monitoring Workbench, importelos metadatos de ejemplo.

Procedimiento1. Inicie Real-time Monitoring.2. Importe el archivo export.jar desde el directorio ubicación_c10/realtime/

webcontent/samples/sdk/callcenter/CallCenterDemo/metadata utilizando lafunción de importación de Real-time Monitoring Workbench.Para obtener más información acerca de la importación de metadatos, consultela sección que trata acerca de la importación de metadatos en la Guía del usuariode IBM Cognos Real-time Monitoring Workbench.

Desinstalación de Real-time Monitoring de IBM WebSphere ApplicationServer

Antes de desinstalar IBM Cognos Real-time Monitoring, determine si necesitahacer una copia de seguridad de alguna parte de las bases de datos o metadatosde la aplicación. Esto es especialmente importante si dispone de archivos dealmacén de claves que se han guardado con contraseñas de usuario.


Realice una copia de seguridad de los archivos de almacén de claves paraconservar los ID de usuario y las contraseñas. Ejecute el programa dedesinstalación que se ha instalado como parte del proceso de instalación.Asimismo, suprima y anule manualmente el despliegue de los componentes yarchivos de la aplicación Real-time Monitoring que residen en diversas ubicacionesdel servidor de aplicaciones y del servidor web, como los directorios y archivos deregistro.

Procedimiento1. Opcionalmente, haga una copia de seguridad de los metadatos que se asocian a

IBMCognos Real-time Monitoring.2. Realice la desinstalación de IBM WebSphere Application Server.3. Ejecute el programa de desinstalación de IBM Cognos Real-time Monitoring.4. Desinstale la base de datos.

Realización de la copia de seguridad de los metadatos deReal-time Monitoring

Antes de realizar la desinstalación, puede que desee realizar una copia deseguridad de los metadatos que se asocian a IBM Cognos Real-time Monitoring.

En algunas actualizaciones, puede que sea necesario realizar la restauración apartir de un conjunto de archivos de copia de seguridad en lugar de actualizar elsoftware. Si desea realizar la actualización, lea las instrucciones de la actualizaciónantes de cerrar el sistema y de desinstalar la versión anterior. Para obtener másinformación, consulte Capítulo 5, “Actualización desde una versión anterior oreinstalación de Real-time Monitoring”, en la página 29.

Procedimiento1. Inicie la sesión en IBM Cognos Real-time Monitoring Workbench.2. Utilice la característica Exportar tal como se describe en los temas que tratan

acerca de la exportación de metadatos de la Guía del usuario de IBM CognosReal-time Monitoring Workbench.

3. Cierre la sesión de IBM Cognos Real-time Monitoring Workbench.

Desinstalación de IBM WebSphere Application ServerEn esta sección se describe cómo desinstalar IBM Cognos Real-time Monitoring deIBM WebSphere Application Server.

Procedimiento1. En la consola administrativa de IBM WebSphere, desinstale la aplicación IBM

Cognos Real-time Monitoring.2. En la consola administrativa de IBM WebSphere, elimine la instancia de

servidor en la que se ejecutaba Real-time Monitoring.

Ejecución del programa de desinstalación de Real-timeMonitoring

Ejecute el programa de desinstalación para eliminar IBM Cognos Real-timeMonitoring del servidor de aplicaciones o del servidor web, si este último se hainstalado en otro sistema.


Procedimiento1. Inicie el programa de desinstalación.2. Seleccione el idioma que desea utilizar para el programa de desinstalación y

pulse Siguiente.3. Seleccione IBM Cognos Real-time Monitoring y pulse Siguiente.4. Cuando se haya completado el programa de desinstalación, pulse Terminar.

Resultados

Se suprimirán todos los archivos de programa. Los archivos de registro deReal-time Monitoring que permanecen en los directorios ubicación_c10/instlog yubicación_c10/uninstall pueden suprimirse con seguridad.

Desinstalación de la base de datosPara desinstalar las bases de datos, debe suprimir el almacén de archivos y lastablas de metadatos.

Procedimiento1. Abra el directorio de registro de recuperación y el directorio de punto de

comprobación y, a continuación, suprima el almacén de archivos *.dat yDEFAULTRECOVERYLOGGER_ *.

2. Suprima las tablas de la base de datos de metadatos realizando lo siguiente:v Acceda a la base de datos o al esquema de base de datos que se ha utilizado

para la base de datos de metadatos de IBM Cognos Real-time Monitoring.v Suprima las tablas para la base de datos de metadatos. Las tablas que han de

suprimirse son: METADATA_OBJECTS, ALLOCATED_UID yUNCOMMITTED_TID.

3. Suprima las bases de datos operativas y geográficas.


Capítulo 7. Instalación de Real-time Monitoring en un servidorde aplicaciones Oracle WebLogic

En esta sección se describe cómo instalar y desplegar IBM Cognos Real-timeMonitoring mediante la utilización de un servidor de aplicaciones OracleWebLogic.

Instalación y despliegue de Real-time Monitoring en un servidor deaplicaciones Oracle WebLogic

IBM Cognos Real-time Monitoring puede instalarse y desplegarse en un servidorde aplicaciones Oracle WebLogic.


Revisión y verificación de los requisitos para OracleWebLogic

En esta sección se describen los requisitos para desplegar IBM Cognos Real-timeMonitoring en un servidor de aplicaciones Oracle WebLogic.

En esta sección se da por supuesto que está familiarizado con Oracle WebLogic.Debe saber cómo realizar lo siguiente:v Iniciar y detener el servidor de aplicaciones Oracle WebLogic.v Establecer las variables CLASSPATH y JAVA_HOME.v Crear una conexión de base de datos JDBC (Java Database Connectivity).

Instalación del servidor de aplicaciones Oracle WebLogicInstale el servidor de aplicaciones Oracle WebLogic adecuado y soportado, talcomo se especifica en el centro del cliente de IBM Cognos.

Para obtener más información, consulte “Revisión de los entornos soportados” enla página 13.

Controladores JDBC (Java Database Connectivity)Instale el controlador JDBC (Java Database Connectivity) correcto para las bases dedatos utilizadas.

A continuación se indican las distintas bases de datos que puede utilizar para losmetadatos, los orígenes de datos o las tablas de consulta.v IBM DB2v Microsoft SQL Server 2000 con SP3 o posteriorv Microsoft SQL Server 2005v Microsoft SQL Server 2008v MySQL 5.0 o posteriorv PostgreSQLv Oracle 9.2 o posterior


Además de las bases de datos indicadas anteriormente, puede acceder a otrasbases de datos, siempre que exista un controlador de Tipo 4 para la base de datosque desea utilizar. Sin embargo, sólo se han certificado las bases de datosanteriormente indicadas.

Consulte las siguientes URL para determinar cuál es el controlador de base dedatos adecuado para la base de datos que utiliza. Los controladores de Tipo 4 sonla opción de preferencia para IBM Cognos Real-time Monitoring. Obtenga elcontrolador JDBC de cliente del servidor de bases de datos al que ha planificadoacceder:v http://download-llnw.oracle.com/docs/cd//E13222_01/wls/docs91/

jdbc_drivers/index.htmlv http://download.oracle.com/docs/cd/E13222_01/wls/docs100/jdbc_drivers/

usedriver.htmv http://download.oracle.com/docs/cd//E13222_01/wls/docs103/jdbc_drivers/

index.html

Localización de los archivos necesariosPara instalar y desplegar IBM Cognos Real-time Monitoring correctamente en unservidor de aplicaciones Oracle WebLogic, debe tener los archivos necesarios.

Es necesario lo siguiente:v Un dominio disponible en el servidor de aplicaciones Oracle WebLogic.

Es el nombre que necesitará en el procedimiento que se describe en la sección“Creación de la agrupación de conexiones de metadatos JDBC (Java DatabaseConnectivity)” en la página 56 al identificar la ubicación de dominio BEAWebLogic.

v Realtime-weblogic.ear para Oracle WebLogic 9.x o posterior.El archivo EAR se proporciona en el disco de instalación de IBM CognosReal-time Monitoring. El archivo EAR se encuentra en el directorioubicación_c10/realtime/bin64.

Modificación de los valores de configuración de la máquinavirtual Java

En esta sección se describe cómo modificar los valores de configuración de JVM(máquina virtual Java) editando los scripts de inicio. Se da por supuesto que utilizauna JVM Java SE HotSpot Versión 1.5.


Establezca -XX:NewSize y -XX:MaxNewSize en el mismo valor. El número debe ser1/4 del tamaño seleccionado para -Xms.





16 GB -Xms12288M

-Xmx12288M

-XX:NewSize=3072M

-XX:MaxNewSize=3072M

32 GB -Xms24576M

-Xmx24576M

-XX:NewSize=6144M


También debe especificar los valores de la recogida de basura. La entrada-XX:ParallelGCThreads debe ser igual al número de núcleos de procesadordisponibles. Por ejemplo, si existen dos procesadores de doble núcleo, especifique:

-XX:ParallelGCThreads=4

Si existen 4 procesadores de doble núcleo, o 2 procesadores de núcleo cuádruple,especifique:


Los valores -verbose:gc y -Dsun.rmi.dgc.client.gcInterval son útiles en ladeterminación de problemas de recogida de basura durante la ejecución. Tambiéndeben establecerse. El último valor debe apuntar al directorio de registro; porejemplo:

-Xloggc:"c:/program files/ibm/cognos/c10_64/realtime/logs"


Procedimiento1. Si el servidor de aplicaciones Oracle WebLogic está en ejecución, apáguelo

realizando lo siguiente:v En la consola del servidor de aplicaciones Oracle WebLogic, abra Servers.v Seleccione el servidor. Debe tratarse del mismo dominio de servidor que el

que se ha creado para esta instalación e despliegue.v En el panel que se visualiza, seleccione la pestaña Control.v Pulse Shutdown of this server.

2. Localice el script de inicio de Oracle WebLogic y ábralo en un editor de texto(startWebLogic.cmd en el sistema operativo Microsoft Windows ystartWebLogic.sh en el sistema operativo UNIX).Para el servidor Oracle WebLogic Versión 9.x o posterior, el script de inicio seencuentra en el directorio <inicio_dominio>/bin.

Capítulo 7. Instalación de Real-time Monitoring en un servidor de aplicaciones Oracle WebLogic 51

3. Para incluir los archivos obiProperties.jar y log4j-1.2.7.jar, que se encuentran enel directorio ubicación_c10/realtime/bin64/, inicie el archivostartWebLogic.cmd o el archivo startWebLogic.sh y establezca lo siguiente enlos valores de la ruta de clase.v En un servidor que ejecuta el sistema operativo Microsoft Windows:

set CLASSPATH=c:/Archivos de programa/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar;c:/Archivos de programa/ibm/cognos/c10_64/realtime/bin64/log4j-1.2.7.jar;%CLASSPATH%

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:CLASSPATH=/opt/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar:/opt/ibm/cognos/c10_64/realtime/bin64/log4j-1.2.7.jar:$CLASSPATH

4. Localice y modifique el valor JAVA_HOME del directorio para indicar eldirectorio inicial de JAVA JDK y asegúrese de que la versión modificadaapunta a la ubicación actual de Java SE HotSpot JDK.v El valor predeterminado es JRockit.v El valor recomendado corresponde a Java SE HotSpot JDK.

5. Establezca los parámetros de JVM de modo que se haga un uso óptimo de lamemoria y la recogida de basura (GC). A continuación se indican losparámetros de JVM de ejemplo recomendados para ejecutar Real-timeMonitoring (para la JVM Java SE HotSpot Versión 1.5):-server

-Xms24576M

-Xmx24576M

-XX:NewSize=6144M


-XX:PermSize=256M

-XX:MaxPermSize=256M

-XX:ThreadStackSize=300

-XX:MaxTenuringThreshold=0

-XX:SurvivorRatio=128

-XX:+UseTLAB

-verbose:gc

-Dsun.rmi.dgc.client.gcInterval=600000

-Xloggc:<location of the GC logs>

-XX:-UsePerfData

-XX:+PrintVMOptions

-XX:+TraceClassUnloading

-XX:+DisableExplicitGC

-XX:+CMSParallelRemarkEnabled

-XX:+PrintGCDetails

-XX:+PrintGCTimeStamps

-XX:+UseParNewGC

-XX:+UseConcMarkSweepGC

-XX:ParallelGCThreads=<number of cpus>

-XX:CMSMarkStackSize=8M

-XX:CMSMarkStackSizeMax=32M

-XX:+UseCMSCompactAtFullCollection

-XX:CMSFullGCsBeforeCompaction=0

-XX:+ParallelRefProcEnabled


-XX:+CMSClassUnloadingEnabled

-XX:+CMSPermGenSweepingEnabled

-XX:+CMSIncrementalMode

-XX:+CMSIncrementalPacing

-XX:CMSIncrementalDutyCycleMin=0

-XX:CMSIncrementalDutyCycle=10

-XX:+UseCMSInitiatingOccupancyOnly

6. Asegúrese de que el parámetro JAVA_OPTIONS de la propiedadcom.cognos.obi.bootstrap.envpropname se ha establecido en BOOTPROPS yde que la propiedad BOOTPROPS de la JVM apunta al archivorealtime.properties que ha editado durante la preparación para la instalacióntal como se describe en “Establecimiento de las propiedades del sistemadurante el inicio” en la página 20.v En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTIONS=%JAVA_OPTIONS% "-DBOOTPROPS=<bootstrap_file>"

set JAVA_OPTIONS=%JAVA_OPTIONS%"-Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS"

donde <archivo_inicialización> especifica la ubicación del archivorealtime.properties que contiene las propiedades de inicialización.

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:JAVA_OPTIONS="$JAVA_OPTIONS -DBOOTPROPS=<bootstrap_file>"

JAVA_OPTIONS="$JAVA_OPTIONS-Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS"


7. Establezca el tipo de codificación de archivos en UTF8.v En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTIONS=%JAVA_OPTIONS% "-Dfile.encoding=utf8"

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:JAVA_OPTIONS="$JAVA_OPTIONS -Dfile.encoding=utf8"

8. Opcionalmente, establezca la propiedad anonymousaccessenabled en true parahabilitar el inicio de sesión anónimo. Establezca esta propiedad en false parainhabilitar el inicio de sesión anónimo. Cuando se ha habilitado estapropiedad, en la pantalla de inicio de sesión se muestra el enlace Iniciarsesión como usuario anónimo.v En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTIONS=%JAVA_OPTIONS% "-Danonymousaccessenabled=true"

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:JAVA_OPTIONS="$JAVA_OPTIONS -Danonymousaccessenabled=true"

Con el inicio de sesión anónimo habilitado, puede iniciar la sesiónautomáticamente en IBM Cognos Real-time Monitoring Dashboard o en IBMCognos Real-time Monitoring Workbench sin especificar un nombre deusuario y contraseña mediante la utilización de la URL:http://nombre_servidor/cognos/realtime/landing/landingpage.htmEsto le permite seleccionar la aplicación.

9. Opcionalmente, si se necesitan conexiones http salientes, como conexiones conservicios web o con servicios de codificación geográfica, para poder atravesarun servidor proxy desde el entorno de servidor, añada la propiedad JVM


siguiente al script de inicio con el fin de que la capa de conectividad de Javautilice el servidor proxy para todas las llamadas salientes.v En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTIONS=%JAVA_OPTIONS% "-Dhttp.proxyHost=<fully qualifiedserver name of http proxy>"

set JAVA_OPTIONS=%JAVA_OPTIONS% "-Dhttp.proxyPort=<http proxy portnumber>"

set JAVA_OPTIONS=%JAVA_OPTIONS% "-Dhttps.proxyHost=<fully qualifiedserver name of https proxy>"

set JAVA_OPTIONS=%JAVA_OPTIONS% "-Dhttps.proxyPort=<https proxyserver port>"

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:JAVA_OPTIONS="$JAVA_OPTIONS -Dhttp.proxyHost=<fully qualified servername of http proxy>"

JAVA_OPTIONS="$JAVA_OPTIONS -Dhttp.proxyPort=<http proxy portnumber>"

JAVA_OPTIONS="$JAVA_OPTIONS -Dhttps.proxyHost=<fully qualified servername of https proxy>"

JAVA_OPTIONS="$JAVA_OPTIONS -Dhttps.proxyPort=<https proxy serverport>"

Nota: No están soportados los servidores proxy que necesitanautenticación.

10. Opcionalmente, establezca los parámetros de idioma y de entorno local talcomo se describe en “Establecimiento de los parámetros de idioma y deentorno local en un servidor de aplicaciones Oracle WebLogic”.Sólo será necesario que realice este paso si desea inicializar los metadatos enun entorno local distinto del entorno local predeterminada del servidor.

11. Guarde y cierre el archivo del script de inicio.

Establecimiento de los parámetros de idioma y de entorno localen un servidor de aplicaciones Oracle WebLogicPuede establecer parámetros opcionales para la base de datos de metadatos,incluidos el idioma, el país o región y el nivel de clasificación.

Los valores predeterminados se basan en los valores de entorno local del servidor.Establezca estos valores predeterminados antes de iniciar el servidor deaplicaciones por primera vez. Estos parámetros se añaden al script de inicio delservidor de aplicaciones y utilizan el formato básico siguiente:




Tabla 19. Valores de parámetros opcionales para la base de datos de metadatos delservidor de aplicaciones WebLogic


LOCALE_LANGUAGE Código de idioma ISO de dos caracteres para elservidor.


En un servidor que ejecuta el sistema operativoMicrosoft Windows:

set JAVA_OPTIONS=%JAVA_OPTIONS%"-Dcom.cognos.obi.property.LOCALE_LANGUAGE=PT"

En un servidor que ejecuta el sistema operativo AIX,Solaris o Linux:

JAVA_OPTIONS="$JAVA_OPTIONS-Dcom.cognos.obi.property.LOCALE_LANGUAGE=PT"


Por ejemplo, para establecer el parámetro de país oregión en Brasil, debe añadir el comando siguiente:

En un servidor que ejecuta el sistema operativoMicrosoft Windows:

set JAVA_OPTIONS=%JAVA_OPTIONS%"-Dcom.cognos.obi.property.LOCALE_REGION=BR"


JAVA_OPTIONS="$JAVA_OPTIONS-Dcom.cognos.obi.property.LOCALE_REGION=BR"


COLLATE_STRENGTH Especifica el nivel de clasificación, es decir, el grado decomparación y clasificación de los caracteres noingleses; los niveles de clasificación son: primario,secundario, terciario o idéntico. El nivel de clasificaciónprimario es el menos discriminante y el nivel declasificación idéntico es el más discriminante. (El valorpredeterminado es terciario.) Para obtener másinformación acerca de los parámetros de ordenación,consulte la documentación de Java en:

http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.html.Nota: Este valor sólo tiene efecto siLOCALE_COLLATION se ha establecido en true.




Tabla 19. Valores de parámetros opcionales para la base de datos de metadatos delservidor de aplicaciones WebLogic (continuación)


COLLATE_DECOMPOSITION Especifica uno de los modos de descomposición declasificación siguientes: ninguno, canónico o completo.(El valor predeterminado es canónico.) Para obtenermás información acerca de los parámetros deordenación, consulte la documentación de Java en:http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.html.Nota: Este valor sólo tiene efecto siLOCALE_COLLATION se ha establecido en true.

Procedimiento1. Localice la variable de entorno JAVA_OPTIONS en el archivo

startWebLogic.cmd o en el archivo startWebLogic.sh.2. Añada valores de parámetros utilizando la sintaxis siguiente:



3. Guarde y cierre el script de ejecución.

Creación y configuración de la conexión de metadatosEn esta sección se describe cómo crear la agrupación de conexiones JDBC (JavaDatabase Connectivity) y el origen de datos de los metadatos necesarios en laconsola de BEA WebLogic.

Configuración de Oracle WebLogic 9.x y versiones posterioresPara Oracle WebLogic 9.x o versiones posteriores, sólo ha de realizarse un únicopaso: crear el origen de datos junto con los valores de la agrupación de conexiones.

Consulte las URL siguientes para conocer el procedimiento de Oracle WebLogicpara configurar el origen de datos de los metadatos con los valores de laagrupación de conexiones:v Para Oracle WebLogic 9.2, vaya a:

http://download.oracle.com/docs/cd/E13222_01/wls/docs92/ConsoleHelp/taskhelp/jdbc/jdbc_datasources/CreateDataSources.html

v Para Oracle WebLogic 10gR3, vaya a:http://download.oracle.com/docs/cd/E12840_01/wls/docs103/ConsoleHelp/taskhelp/jdbc/jdbc_datasources/CreateDataSources.html

Creación de la agrupación de conexiones de metadatos JDBC (Java DatabaseConnectivity):

En esta sección se describen los valores necesarios para crear la agrupación deconexiones de metadatos JDBC (Java Database Connectivity) necesario en laconsola de BEA WebLogic.

Consulte la URL siguiente para conocer el procedimiento de Oracle WebLogiccorrespondiente a la configuración de la agrupación de conexiones de metadatos:




http://download.oracle.com/docs/cd/E13222_01/wls/docs92/index.html

Procedimiento

1. Seleccione una de las bases de datos que IBM Cognos Real-time Monitoringsoporta.v DB2v Microsoft SQL Serverv MySQLv PostgreSQLv OracleCuando selecciona un tipo de base de datos, el campo del controlador de basede datos visualiza dinámicamente las opciones de controlador de la base dedatos seleccionada.

2. Seleccione el controlador en el campo del controlador de base de datos.v Para DB2, seleccione el controlador (Tipo 2) de DB2 de IBM o el controlador

(Tipo 4) de DB2 de IBM según proceda.v Para Microsoft SQL Server 2000 y 2005, seleccione el controlador (Tipo 4) de

Microsoft SQL Server de Oracle WebLogic.v Para Microsoft SQL Server 2008, seleccione el controlador correspondiente a

"Otros" y especifique la ruta de clase para sqljdbc4.jar y las credenciales parala conexión con SQL Server 2008.

v Para MySQL, seleccione la versión del controlador (Tipo 4) de MySQL y lautilización de com.mysql.jdbc.Driver.

v Para PostgreSQL, seleccione la versión del controlador (tipo 4) dePostgreSQL.

v Para el cliente ligero de Oracle, seleccione las versiones del controlador(Ligero) de Oracle 9.0.1, 9.2.0, 10, 11 (sólo Oracle WebLogic 10gR3).

v Para el cliente grueso de Oracle (OCI), seleccione las versiones delcontrolador de Oracle (OCI) 9.0.1, 9.2.0, 10, 11 (sólo Oracle WebLogic 10gR3).

Resultados

Tras realizar el despliegue, deberá modificar la configuración de la conexión, talcomo se describe en “Incremento de la capacidad máxima de la agrupación deconexiones de metadatos JDBC (Java Database Connectivity)” en la página 58.

Creación de la conexión de metadatos:

En esta sección se describen los valores necesarios para crear el origen de datos delos metadatos JDBC necesario en la consola de BEA WebLogic.

Consulte la URL siguiente para conocer el procedimiento de Oracle WebLogiccorrespondiente a la configuración del origen de datos de los metadatos:

http://download.oracle.com/docs/cd/E13222_01/wls/docs92/index.html

Procedimiento

1. Para el valor del nombre, especifique com.cognos.obi.metadata.metaDatasource.2. Para el nombre JNDI, especifique com.cognos.obi.metadata.metaDatasource.3. Elimine la selección de la casilla de verificación Support Global Transactions.


4. Para el nombre del conjunto, seleccione el nombre de la agrupación deconexiones que ha creado en el procedimiento que se describe en “Creación dela agrupación de conexiones de metadatos JDBC (Java Database Connectivity)”en la página 56.

Incremento de la capacidad máxima de la agrupación deconexiones de metadatos JDBC (Java Database Connectivity)Después de haber desplegado la agrupación de conexiones configurado, debemodificar la configuración de la conexión incrementando la capacidad máxima.

Procedimiento1. En la configuración de la agrupación de conexiones de metadatos JDBC (Java

Database Connectivity), cambie el valor de la capacidad máxima por 20.

Nota: Puede aceptar los valores predeterminados para los valores deconfiguración restantes.

2. En la sección de las opciones avanzadas, pulse Show.3. Seleccione Test Reserved Connections.4. Guarde los valores de configuración.5. Pruebe la agrupación de conexiones y asegúrese de que la prueba se completa

correctamente.Ahora, la agrupación de conexiones JDBC se ha completado correctamente.

Definición de orígenes de datos en WebLogicPara la instalación, debe definir los dos orígenes de datos siguientes: un origen dedatos para los mapas geográficos y un origen de datos operativo.


Definición del origen de datos para mapas geográficos paraReal-time Monitoring en un servidor de aplicaciones OracleWebLogicDebe definir un origen de datos para los mapas geográficos.

Para configurar el soporte para los mapas geográficos, siga los pasoscorrespondientes a la creación de un origen de datos con la consola del servidor deaplicaciones Oracle WebLogic que se describen en la sección “Creación yconfiguración de la conexión de metadatos” en la página 56. Sin embargo, deberáespecificar el nombre y el nombre JNDI (Java Naming and Directory Interface(JNDI) con nombre como com.cognos.obi.geo.geoDatasource.

Definición de un origen de datos operativos para Real-timeMonitoring en un servidor de aplicaciones Oracle WebLogicUn origen de datos operativos es un repositorio de base de datos que se utilizapara almacenar y hacer persistentes los datos de búsqueda.

Para configurar el origen de datos operativos, siga los mismos pasos que paracrear un origen de metadatos. Sin embargo, deberá especificar el nombre y elnombre JNDI (Java Naming and Directory Interface) con nombre comocom.cognos.obi.operational. Para crear un origen de datos, siga el procedimientoque se describe en “Creación y configuración de la conexión de metadatos” en lapágina 56


Definición de orígenes de datos opcionales adicionales paraReal-time Monitoring en un servidor de aplicaciones OracleWebLogicPara cada agente JDBC (Java Database Connectivity) (por ejemplo, para acceder alflujo de datos o a los datos de la tabla de consulta) que crea en IBM CognosReal-time Monitoring Workbench, debe crear un origen de datos en la instalaciónde Oracle.

Para la conexión con los orígenes de datos JDBC es preferible utilizar el nombreJNDI (Java Naming and Directory Interface) con agrupaciones de conexiones. Elnombre JNDI que aquí se especifica se utiliza desde Real-time MonitoringWorkbench al configurar un agente JDBC. Si no existe un controlador deagrupación de conexiones disponible, una alternativa es especificar una conexiónbasada en URL desde Real-time Monitoring Workbench. El nombre JNDI (JavaNaming and Directory Interface) debe ser exclusivo para cada origen de datos.Para crear un origen de datos, siga el procedimiento descrito en “Creación yconfiguración de la conexión de metadatos” en la página 56.

Despliegue de Real-time Monitoring en un servidor deaplicaciones Oracle WebLogic

En esta sección se describe el proceso para desplegar IBM Cognos Real-timeMonitoring en un servidor de aplicaciones Oracle WebLogic.

Procedimiento1. Consulte la URL siguiente para obtener instrucciones acerca de cómo desplegar

el archivo EAR.Para Oracle WebLogic 9.2, consulte:http://download.oracle.com/docs/cd/E13222_01/wls/docs92/ConsoleHelp/taskhelp/deployment/InstallApplicationsAndModules.html.Para Oracle WebLogic 10gR3, consulte http://download.oracle.com/docs/cd/E13222_01/wls/docs103/ConsoleHelp/taskhelp/deployment/InstallApplicationsAndModules.html

2. Durante el despliegue, se dirigirá al archivo Realtime-weblogic.ear del disco deinstalación de IBM Cognos Real-time Monitoring. Es el archivo EAR quedesplegará en el servidor de aplicaciones Oracle WebLogic.Para confirmar el despliegue, abra un navegador web y vaya al sitio websiguiente:http://<host>:<puerto>/realtime/Controller/RequestInfoAction/ListInfoPor ejemplo:http://localhost:7001/realtime/Controller/RequestInfoAction/ListInfo

Resultados



Prueba de Real-time Monitoring tras la instalación en el servidor deaplicaciones Oracle WebLogic




2. Opcionalmente, cargar los ejemplos. Consulte “Carga de los ejemplos deReal-time Monitoring en el servidor de aplicaciones Oracle WebLogic”.


Carga de los ejemplos de Real-time Monitoring en el servidorde aplicaciones Oracle WebLogic

Cargue datos para comprobar si la aplicación funciona.

El directorio ubicación_c10/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/data contiene el esquema de base de datos Derby que contendrálas tablas, datos y activadores de demostración del centro de asistencia telefónica.Esta demostración necesita el controlador Apache Derby 10.5.3. Para obtenerinformación acerca de la descarga de Apache Derby, consulte la dirección:




webcontent/samples/sdk.2. Cree el directorio /derby/databases en el directorio

ubicación_instalación_WebLogic/wlserver_número_versión/.3. Copie la base de datos ubicación_c10/realtime/webcontent/samples/sdk/

callcenter/CallCenterDemo/data/ccdemo en el siguiente directorio del servidorde aplicaciones Oracle WebLogic.ubicación_instalación_WebLogic/wlserver_número_versión/derby/databases

4. Copie el archivo derby.jar que ha descargado desde el sitio del soporte deApache en el directorio /derby/databases; es decir, en el directorioubicación_instalación_WebLogic/wlserver_número_versión/derby/databases.

5. Mediante la utilización de la consola de BEA WebLogic, cree un origen de datoscon las siguientes propiedades generales.


Tabla 20. Propiedades del origen de datos de ejemplos de Real-time Monitoring en elservidor de aplicaciones Oracle WebLogic

Propiedad general Valor

Nombre com.cognos.obi.demo.ccdemo

Nombre JNDI com.cognos.obi.demo.ccdemo

Tipo de base de datos Proveedor de Derby JDBC

Nombre de base de datos ubicación_instalación_WebLogic/wlserver_número_versión/derby/databases/ccdemo

Asegúrese de seleccionar el ayudante de almacén de datos Derby como clasede ayudante de almacén de datos.

6. Pruebe la conexión y guarde el trabajo.

Resultados






Desinstalación de Real-time Monitoring del servidor de aplicacionesOracle WebLogic

Antes de desinstalar IBM Cognos Real-time Monitoring, determine si necesitahacer una copia de seguridad de alguna parte de las bases de datos o metadatosde la aplicación. Esto es especialmente importante si dispone de archivos dealmacén de claves que se han guardado con contraseñas de usuario.

Realice una copia de seguridad de los archivos de almacén de claves paraconservar los ID de usuario y las contraseñas. Ejecute el programa dedesinstalación que se ha instalado como parte del proceso de instalación.Asimismo, suprima y anule manualmente el despliegue de los componentes yarchivos de la aplicación Real-time Monitoring que residen en el servidor deaplicaciones y en el servidor web, como los directorios y archivos de registro.


IBMCognos Real-time Monitoring.2. Realice la desinstalación del servidor de aplicaciones Oracle WebLogic.


3. Ejecute el programa de desinstalación de IBM Cognos Real-time Monitoring.4. Desinstale la base de datos.


Antes de realizar la desinstalación, puede que desee hacer una copia de seguridadde los metadatos que se asocian a IBM Cognos Real-time Monitoring.


Procedimiento1. Inicie la sesión en IBM Cognos Real-time Monitoring Workbench.2. Utilice la característica Exportar tal como se describe en la sección que trata



Desinstalación del servidor de aplicaciones Oracle WebLogicEn esta sección se describe cómo desinstalar IBM Cognos Real-time Monitoring delservidor de aplicaciones Oracle WebLogic.

Procedimiento1. Inicie el servidor de aplicaciones Oracle WebLogic, si todavía no está en

ejecución.2. En la consola de administración de Oracle WebLogic, en la configuración de las

aplicaciones, anule el despliegue de la aplicación IBM Cognos Real-timeMonitoring.





Resultados











Capítulo 8. Instalación de Real-time Monitoring en un servidorde aplicaciones JBoss

En esta sección se describe cómo instalar y desplegar IBM Cognos Real-timeMonitoring en un servidor de aplicaciones JBoss.

Instalación y despliegue de Real-time Monitoring en un servidor deaplicaciones JBoss

IBM Cognos Real-time Monitoring puede instalarse y desplegarse en un servidorde aplicaciones JBoss.

Antes de empezar


Procedimiento1. Revisión y verificación de los requisitos.2. Modifique los valores de la máquina virtual Java (JVM).3. Opcionalmente, configuración de los parámetros de metadatos.4. Creación y configuración de la conexión de metadatos.5. Definición de otros orígenes de datos obligatorios y opcionales.6. Despliegue de Real-time Monitoring en un servidor de aplicaciones JBoss.7. Revisión de las consideraciones relacionadas con la ejecución de Real-time

Monitoring en una instancia del servidor de aplicaciones JBoss.

Revisión y verificación de los requisitos para Real-timeMonitoring en un servidor de aplicaciones JBoss

En esta sección se describen los requisitos para instalar y desplegar IBM CognosReal-time Monitoring en un servidor de aplicaciones JBoss.

En esta sección se da por supuesto que está familiarizado con el servidor deaplicaciones JBoss. Específicamente, debe saber cómo realizar lo siguiente:v Iniciar y detener el servidor de aplicaciones JBoss.v Establecer las variables CLASSPATH y JAVA_OPTS.v Crear y configurar una conexión de metadatos.

Instalación del servidor de aplicaciones JBossAntes de instalar el servidor de aplicaciones, compruebe la hoja de datos de laplataforma de aplicaciones empresariales de JBoss.

Puede obtener la hoja de datos en:

http://www.jboss.com/pdf/jb_ent_app_platform_04_07.pdf


Instale el servidor de aplicaciones JBoss adecuado y soportado, tal como seespecifica en el centro del cliente de IBM Cognos. Para obtener más información,consulte “Revisión de los entornos soportados” en la página 13.

Controladores JDBC (Java Database Connectivity)En esta sección se describe cómo instalar el controlador JDBC (Java DatabaseConnectivity) correcto para los metadatos.

Para obtener más información, consulte “Creación y configuración de la conexiónde metadatos” en la página 73. En la siguiente tabla se indican los archivos decontrolador JDBC para las distintas bases de datos que puede utilizar para lastablas de metadatos. IBM Cognos Real-time Monitoring puede utilizarse concualquier base de datos que tenga un controlador de Tipo 4; sin embargo, sólo sesoportan las bases de datos que se indican a continuación.

Tabla 21. Archivos de controlador JDBC soportados para bases de datos de metadatos

Base de datos de metadatos Controlador JDBC

DB2 8.2 db2jcc.jar

db2jcc_license_cu.jar

Oracle 9.2 o posterior Controlador ligero de Oracle (ojdbc14.jar)

ojdbc6.jar (para Oracle 11g, sólo funciona con JDK1.6)

Controlador grueso de Oracle (OCI)Nota: Debe utilizar el controlador JDBC Oracle 10Gpara ambas configuraciones.

Microsoft SQL Server 2008 sqljdbc.jar (sólo funciona con JDK 1.5.)

sqljdbc4.jar (sólo funciona con JDK 1.6.)

Microsoft SQL Server 2005 sqljdbc.jarNota: Debe asegurarse de que los controladores de laversión 2000 no se encuentran en la ruta de clase.

Microsoft SQL Server 2000 sqljdbc.jar

O uno de los controladores siguientes: mssqlserver.jar,msbase.jar o msutil.jarNota: El controlador sqljdbc.jar es compatible con lasversiones anteriores a las versiones 2000.

MySQL 5.0 o posterior mysql-connector-java-[versión]-bin.jar

PostgreSQL postgresql-[versión].jdbc3.jar

Actualmente existe un problema de Microsoft relacionado con el controladorsqljdbc.jar, que se ha solucionado tal como se indica en el artículo 917054 deMicrosoft Knowledge Base.

El controlador sqljdbc.jar es compatible con las versiones anteriores a la versión2000. Sin embargo, si utiliza el controlador 2005 (sqljdbc.jar), debe asegurarse deque los controladores de la versión 2000 no se encuentran en la ruta de clase.


Modificación de los valores de configuración de la máquinavirtual Java

En esta sección se describe cómo modificar los valores de configuración de JVM(máquina virtual Java) editando los scripts de inicio. Se da por supuesto que utilizauna JVM Java SE HotSpot Versión 1.5.


Establezca -XX:NewSize y -XX:MaxNewSize en el mismo valor. El número debe ser1/4 del tamaño seleccionado para -Xms.




16 GB -Xms12288M

-Xmx12288M

-XX:NewSize=3072M


32 GB -Xms24576M

-Xmx24576M

-XX:NewSize=6144M


También debe especificar los valores de la recogida de basura. La entrada-XX:ParallelGCThreads debe ser igual al número de núcleos de procesadordisponibles. Por ejemplo, si existen dos procesadores de doble núcleo, especifique:


Si existen 4 procesadores de doble núcleo, o 2 procesadores de núcleo cuádruple,especifique:


Los valores -verbose:gc y -Dsun.rmi.dgc.client.gcInterval son útiles en ladeterminación de problemas de recogida de basura durante la ejecución. Tambiéndeben establecerse. El último valor debe apuntar al directorio de registro; porejemplo:

-Xloggc:"c:/program files/ibm/cognos/c10_64/realtime/logs"

Capítulo 8. Instalación de Real-time Monitoring en un servidor de aplicaciones JBoss 67


Procedimiento1. Si el servidor de aplicaciones JBoss ya está en ejecución, ciérrelo.2. Localice y abra el script de ejecución que inicia el servidor de aplicaciones

JBoss. Este archivo se encuentra en:...\%JBOSS_HOME%\bin\run.bat (en un servidor que ejecuta el sistemaoperativo Microsoft Windows).../$JBOSS_HOME/bin/run.sh (en un servidor que ejecuta el sistemaoperativo UNIX)

3. Para incluir el archivo obiProperties.jar, que se encuentra en el directorioubicación_c10/realtime/bin64/, edite el archivo run.bat o run.sh paraestablecer lo siguiente en los valores de la ruta de clase.v En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JBOSS_CLASSPATH=%JBOSS_CLASSPATH%;C:/Archivos~1/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:JBOSS_CLASSPATH=$JBOSS_CLASSPATH:/opt/ibm/cognos/c10_64/realtime/bin64/obiProperties.jar

4. Establezca las variables de entorno. (Para un servidor que ejecuta el sistemaoperativo AIX, Linux o Solaris, utilice el JDK. El JRE es insuficiente.)v En un servidor que ejecuta el sistema operativo Microsoft Windows:

Cree una variable de entorno denominada JAVA_HOME que apunte aldirectorio de instalación del JDK. Por ejemplo:C:\Archivos de programa\Java\jdk1.5.0_14\Para ejecutar Java desde la línea de comandos, añada el directorio jre\bin ala ruta. Por ejemplo:C:\Archivos de programa\Java\jdk1.5.0_14\jre\binPara crear la variable de entorno, abra el Panel de control desde el menúInicio (si es necesario, cambie a la Vista clásica) y, a continuación, abra elapplet del sistema. Seleccione la pestaña Avanzado y pulse el botónVariables de entorno. Pulse el botón Nuevo de las variables del sistemapara crear la variable JAVA_HOME.

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:Cree una variable de entorno denominada JAVA_HOME que apunte aldirectorio de instalación del JDK. Añada $JAVA_HOME/bin a la ruta delsistema para poder ejecutar Java desde la línea de comandos. Por ejemplo,en Linux con el shell bash, puede hacerlo añadiendo las líneas siguientes alarchivo .bashrc del directorio inicial:export JAVA_HOME=<jdk_directory>

export PATH=$PATH:$JAVA_HOME/bin

donde <directorio_jdk> es el directorio de instalación del JDK (por ejemplo,/usr/java/jdk1.6.0_07). Deberá seleccionar el JDK adecuado en función dela versión del servidor de aplicaciones JBoss utilizada.

Para obtener más información acerca de los requisitos previos para el servidorde aplicaciones JBoss, consulte lo siguiente:v http://www.jboss.org/file-access/default/members/jbossas/freezone/

docs/Installation_Guide/4/pdf/Installation_Guide.pdf


v http://www.jboss.org/file-access/default/members/jbossas/freezone/docs/Installation_Guide/beta500/html-single/index.html#Pre_Requisites-Configuring_Your_Java_Environment

5. Asegúrese de que el parámetro JAVA_OPTS de la propiedadcom.cognos.obi.bootstrap.envpropname se ha establecido en BOOTPROPS yde que la propiedad BOOTPROPS de la JVM apunta al archivorealtime.properties que ha editado durante la preparación para la instalaciónque se describe en “Establecimiento de las propiedades del sistema durante elinicio” en la página 20v En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS% "-DBOOTPROPS=<bootstrap_file>"

set JAVA_OPTS=%JAVA_OPTS%"-Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS"


v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:JAVA_OPTS="$JAVA_OPTS -DBOOTPROPS=<bootstrap_file>"

JAVA_OPTS="$JAVA_OPTS-Dcom.cognos.obi.bootstrap.envpropname=BOOTPROPS"


6. Establezca el tipo de codificación de archivos en UTF8 tal como se muestra enlos ejemplos siguientes:A continuación se muestran ejemplos para cada sistema operativo:v En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS% "-Dfile.encoding=utf8"

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=utf8"

7. Opcionalmente, establezca la propiedad anonymousaccessenabled, tal como semuestra a continuación, en true para habilitar el inicio de sesión anónimo.Establezca esta propiedad en false para inhabilitar el inicio de sesión anónimo.Cuando se ha habilitado esta propiedad, en la pantalla de inicio de sesión semuestra el enlace Iniciar sesión como usuario anónimo.v En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS% "-Danonymousaccessenabled=true"

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:JAVA_OPTS="$JAVA_OPTS -Danonymousaccessenabled=true"

Con el inicio de sesión anónimo habilitado, puede iniciar la sesiónautomáticamente en IBM Cognos Real-time Monitoring Dashboard o en IBMCognos Real-time Monitoring Workbench sin especificar un nombre deusuario y contraseña mediante la utilización de la URL:http://nombre_servidor/cognos/realtime/landing/landingpage.htmEsto le permite seleccionar la aplicación.

8. Opcionalmente, si se necesitan conexiones http salientes, como conexiones conservicios web o con servicios de codificación geográfica, para poder atravesarun servidor proxy desde el entorno de servidor, añada la propiedad JVM alscript de inicio con el fin de que la capa de conectividad de Java utilice elservidor proxy para todas las llamadas salientes.A continuación se muestran ejemplos para cada sistema operativo.


v En un servidor que ejecuta el sistema operativo Microsoft Windows:set JAVA_OPTS=%JAVA_OPTS% "-Dhttp.proxyHost=<fully qualified servername of http proxy>"

set JAVA_OPTS=%JAVA_OPTS% "-Dhttp.proxyPort=<http proxy port number>"

set JAVA_OPTS=%JAVA_OPTS% "-Dhttps.proxyHost=<fully qualified servername of https proxy>"

set JAVA_OPTS=%JAVA_OPTS% "-Dhttps.proxyPort=<https proxy serverport>"

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyHost=<fully qualified server nameof http proxy>"

JAVA_OPTS="$JAVA_OPTS -Dhttp.proxyPort=<http proxy port number>"

JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyHost=<fully qualified server nameof https proxy>"

JAVA_OPTS="$JAVA_OPTS -Dhttps.proxyPort=<https proxy server port>"

Nota: No están soportados los servidores proxy que necesitanautenticación.

9. Opcionalmente, añada un valor JAVA_OPTS, tal como se muestra acontinuación, para inhabilitar el registro doble de la salida del sistema.

Nota: Es una solución al error 877974 de JBoss.v En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS%

"-Dorg.jboss.logging.Log4jService.catchSystemOut=false"

"-Dorg.jboss.logging.Log4jService.catchSystemErr=false"

Nota: La información anteriormente indicada debe especificarse en unaúnica línea.

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:JAVA_OPTS="$JAVA_OPTS

-Dorg.jboss.logging.Log4jService.catchSystemOut=false

-Dorg.jboss.logging.Log4jService.catchSystemErr=false"

Nota: La información anteriormente indicada debe especificarse en unaúnica línea.

10. Active la JVM de 64 bits añadiendo la línea siguiente al valor JAVA_OPTS, talcomo se muestra a continuación:v En un servidor que ejecuta el sistema operativo Microsoft Windows:

set JAVA_OPTS=%JAVA_OPTS% "-D64"

v En un servidor que ejecuta el sistema operativo AIX, Solaris o Linux:JAVA_OPTS="$JAVA_OPTS -D64"

11. Establezca los parámetros de JVM de modo que se haga un uso óptimo de lamemoria y la recogida de basura (GC). A continuación se indican losparámetros de JVM de ejemplo recomendados para ejecutar Real-timeMonitoring (para la JVM Java SE HotSpot Versión 1.5):-server

-Xms24576M

-Xmx24576M


-XX:NewSize=6144M


-XX:PermSize=256M

-XX:MaxPermSize=256M

-XX:ThreadStackSize=300

-XX:MaxTenuringThreshold=0

-XX:SurvivorRatio=128

-XX:+UseTLAB

-verbose:gc

-Dsun.rmi.dgc.client.gcInterval=600000

-Xloggc:<location of the GC logs>

-XX:-UsePerfData

-XX:+PrintVMOptions

-XX:+TraceClassUnloading

-XX:+DisableExplicitGC

-XX:+CMSParallelRemarkEnabled

-XX:+PrintGCDetails

-XX:+PrintGCTimeStamps

-XX:+UseParNewGC

-XX:+UseConcMarkSweepGC

-XX:ParallelGCThreads=<number of cpus>

-XX:CMSMarkStackSize=8M

-XX:CMSMarkStackSizeMax=32M

-XX:+UseCMSCompactAtFullCollection

-XX:CMSFullGCsBeforeCompaction=0

-XX:+ParallelRefProcEnabled

-XX:+CMSClassUnloadingEnabled

-XX:+CMSPermGenSweepingEnabled

-XX:+CMSIncrementalMode

-XX:+CMSIncrementalPacing

-XX:CMSIncrementalDutyCycleMin=0

-XX:CMSIncrementalDutyCycle=10

-XX:+UseCMSInitiatingOccupancyOnly

12. Opcionalmente, establezca los parámetros de idioma y de entorno local talcomo se describe en “Establecimiento de los parámetros de idioma y deentorno local”.Sólo será necesario que realice este paso si desea inicializar los metadatos enun entorno local distinto del entorno local predeterminada del servidor.

13. Guarde y cierre el archivo del script de inicio.

Establecimiento de los parámetros de idioma y de entorno localPuede establecer parámetros opcionales para la base de datos de metadatos,incluidos el idioma, el país o región y el nivel de clasificación.

Los valores predeterminados se basan en los valores de entorno local del servidor.Debe establecer estos valores predeterminados antes de iniciar el servidor deaplicaciones por primera vez. Estos parámetros se añaden al script de inicio delservidor de aplicaciones y utilizan el formato básico siguiente:




Tabla 23. Valores de parámetros opcionales para la base de datos de metadatos delservidor de aplicaciones JBoss


LOCALE_LANGUAGE Código de idioma ISO de dos caracteres para el servidor.


En un servidor que ejecuta el sistema operativo MicrosoftWindows:

set JAVA_OPTS=%JAVA_OPTS%"-Dcom.cognos.obi.property.LOCALE_LANGUAGE=PT"


JAVA_OPTS="$JAVA_OPTS-Dcom.cognos.obi.property.LOCALE_LANGUAGE=PT"


Por ejemplo, para establecer el país o región en Brasil,los valores deben especificarse de la forma siguiente:

En un servidor que ejecuta el sistema operativo MicrosoftWindows:

set JAVA_OPTS=%JAVA_OPTS%"-Dcom.cognos.obi.property.LOCALE_REGION=BR"


JAVA_OPTS="$JAVA_OPTS-Dcom.cognos.obi.property.LOCALE_REGION=BR"


COLLATE_STRENGTH Especifica el nivel de clasificación, es decir, el grado decomparación y clasificación de los caracteres no ingleses;los niveles de clasificación son: primario, secundario,terciario o idéntico. El nivel de clasificación primario esel menos discriminante; el nivel de clasificación idénticoes el más discriminante. (El valor predeterminado esterciario.) Para obtener más información acerca de losparámetros de ordenación, consulte la documentación deJava en:

http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.html.Nota: Este valor sólo tiene efecto siLOCALE_COLLATION se ha establecido en true.




Tabla 23. Valores de parámetros opcionales para la base de datos de metadatos delservidor de aplicaciones JBoss (continuación)


COLLATE_DECOMPOSITION Especifica uno de los modos de descomposición declasificación siguientes: ninguno, canónico o completo.(El valor predeterminado es canónico.) Para obtener másinformación acerca de los parámetros de ordenación,consulte la documentación de Java en:http://download.oracle.com/javase/1.5.0/docs/api/java/util/Locale.html.Nota: Este valor sólo tiene efecto siLOCALE_COLLATION se ha establecido en true.

Procedimiento1. Localice la variable de entorno JAVA_OPTS en el archivo run.bat o run.sh.2. Añada valores de parámetros utilizando la sintaxis siguiente:



3. Guarde y cierre el script de ejecución. Los cambios realizados en laspropiedades de JVM se aplicarán la próxima vez que se reinicie el servidor.

Creación y configuración de la conexión de metadatosEn este procedimiento, debe copiar el controlador (o controladores) de base dedatos en el directorio de JBoss y, a continuación, crear y desplegar un descriptor deorigen de metadatos.

El descriptor de origen de metadatos define la configuración de la conexión debase de datos, incluida información como la URL de la conexión de base de datos,el nombre de usuario y la contraseña asociada, etc.

Nota: Este descriptor debe ser un origen de datos <distinto de un origen de datostx>. Encontrará una plantilla del archivo de descriptor (obi_metadata-ds.xml) en eldirectorio ubicación_c10/realtime/configuration/jboss.

Procedimiento1. Copie los archivos de controlador de base de datos (por ejemplo, ojdbc14.jar

para Oracle 10g) en el directorio /server/default/lib.2. Establezca el origen de datos de los metadatos:

a. Copie el archivo obi_metadata-ds.xml, que se encuentra en el directorioubicación_c10/realtime/configuration/jboss/ en el directorio/server/default/deploy de la instalación de JBoss.

b. Abra el archivo obi_metadata-ds.xml en un editor de texto.c. Añada la etiqueta <use-java-context> inmediatamente después del elemento

<nombre-jndi> y establézcala como sigue:v Para JBoss 4.2.3: establézcala en false, por ejemplo, <use-java-

context>false</use-java-context>

v Para JBoss 5.1: establézcala en true, por ejemplo, <use-java-context>true</use-java-context>




d. Establezca los parámetros de la URL de conexión y de la clase decontrolador que se muestran en la tabla siguiente, en función del tipo debase de datos utilizado.

Tabla 24. Valores de URL de conexión y parámetros de clase de controlador

Valor Base de datos Formato del valor

<URL_conexión> DB2 jdbc:db2://[host]:[puerto]/[nombre_base_datos]

Microsoft SQL Server 2000 jdbc:microsoft:sqlserver://[host]:[puerto];selectMethod=cursor;databaseName=[nombre_base_datos]

Microsoft SQL Server 2005 jdbc:sqlserver://[host]:[puerto];selectMethod=cursor;databaseName=[nombre_base_datos]

Microsoft SQL Server 2008 jdbc:sqlserver://[host]:[puerto];selectMethod=cursor;

databaseName=[nombre_base_datos]

MySQL jdbc:mysql://[host_base_datos]:[puerto]/[nombre_base_datos]

PostgreSQL jdbc:postgresql://[host_base_datos]:[puerto]/[nombre_base_datos]

Oracle Ligero:

jdbc:oracle:thin:@[host_base_datos]:[puerto_base:datos]:[SID_base_datos]

Grueso (OCI):

jdbc:oracle:oci:@[alias_tns]

<clase_controlador> DB2 com.ibm.db2.jcc.DB2Driver

Microsoft SQL Server 2000 Si utiliza los controladores 2000 (msutil.jar, mssqlserver.jar, msbase.jar),especifique: com.microsoft.jdbc.sqlserver.SQLServerDriver

Si utiliza el controlador 2005 (sqljdbc.jar), especifique:com.microsoft.sqlserver.jdbc.SQLServerDriver

Microsoft SQL Server 2005 com.microsoft.sqlserver.jdbc.SQLServerDriver

Microsoft SQL Server 2008 com.microsoft.sqlserver.jdbc.SQLServerDriver

MySQL com.mysql.jdbc.Driver

PostgreSQL org.postgresql.Driver

Oracle oracle.jdbc.driver.OracleDriver

e. Modifique los parámetros del nombre de usuario y de la contraseña. Debencoincidir con los valores de base de datos que ha especificado en elparámetro de la URL de conexión.

Nota: Para todas las bases de datos, también debe especificar un nombre deusuario y una contraseña en los elementos correspondientes del archivoobi_metadata-ds.xml.

f. Guarde y cierre el archivo obi_metadata-ds.xml.3. Copie los archivos de controlador de base de datos (sqljdbc.jar, msbase.jar,

mssqlserver.jar, msutil.jar) en el directorio /server/default/lib.


Definición de orígenes de datos en JBossPara la instalación, debe definir los dos orígenes de datos siguientes: un origen dedatos para los mapas geográficos y un origen de datos operativo.


Definición del origen de datos para mapas geográficosDebe definir un origen de datos para los mapas geográficos.

Para configurar el soporte para los mapas geográficos, siga los pasoscorrespondientes a la creación de un origen de datos con el servidor deaplicaciones JBoss que se describen en la sección “Creación y configuración de laconexión de metadatos” en la página 73. Sin embargo, deberá especificar el nombrey el nombre JNDI (Java Naming and Directory Interface (JNDI) con nombre comocom.cognos.obi.geo.geoDatasource.

Procedimiento1. Haga una copia del archivo obi_metadata-ds.xml y cambie el nombre de éste

por obi_geo-ds.xml.2. Especifique el nombre y el nombre JNDI como

com.cognos.obi.geo.geoDatasource.

Definición de un origen de datos operativosUn origen de datos operativos es un repositorio de base de datos que se utilizapara almacenar y hacer persistentes los datos de búsqueda.

Para configurar el origen de datos operativos, siga los mismos pasos que paracrear un origen de metadatos. Sin embargo, deberá especificar el nombre y elnombre JNDI (Java Naming and Directory Interface) con nombre comocom.cognos.obi.operational. Para crear un origen de datos, siga el procedimientoque se describe en “Creación y configuración de la conexión de metadatos” en lapágina 73

Definición de orígenes de datos opcionales genéricosPara cada agente JDBC (Java Database Connectivity) (por ejemplo, para acceder alflujo de datos o a los datos de la tabla de consulta) que crea en IBM CognosReal-time Monitoring Workbench, debe crear un origen de datos en la instalaciónde JBoss.

Para la conexión con los orígenes de datos JDBC es preferible utilizar el nombreJNDI (Java Naming and Directory Interface) con agrupaciones de conexiones. Elnombre JNDI que aquí se especifica se utiliza desde Real-time MonitoringWorkbench al configurar un agente JDBC. Si no existe un controlador deagrupación de conexiones disponible, una alternativa es especificar una conexiónbasada en URL desde Real-time Monitoring Workbench. El nombre JNDI (JavaNaming and Directory Interface) debe ser exclusivo para cada origen de datos.Para crear un origen de datos, siga el procedimiento descrito en “Creación yconfiguración de la conexión de metadatos” en la página 73.

Despliegue de Real-time Monitoring en un servidor deaplicaciones JBoss

En esta sección se proporciona el proceso de instalación de JBoss específico de IBMCognos Real-time Monitoring.


Antes de continuar, asegúrese de completar los pasos de configuración que seindican en Capítulo 3, “Preparación para la instalación de Real-time Monitoring”,en la página 13.

Registro de JBossEn las instalaciones de JBoss, los mensajes que se envían a cualquier registro deIBM Cognos Real-time Monitoring también pueden registrarse en el archivo .logdel servidor de aplicaciones JBoss.

De forma predeterminada, el servidor de aplicaciones JBoss registra todos losmensajes que envían los servidores de Real-time Monitoring, además de suspropios mensajes y de los mensajes de las otras aplicaciones que se ejecutan enéste. Puede desactivar el registro de archivos de mensajes de Real-time Monitoringcon el archivo de configuración log4j.xml de JBoss.

De forma predeterminada, los servidores de Real-time Monitoring publicanmensajes informativos o mensajes a los que corresponde una gravedad mayor.Puede cambiar el tipo de mensajes que desea que éstos publiquen con la Consolade administración de IBM Cognos Real-time Monitoring Workbench. Para obtenermás información, consulte la información que trata acerca del registro en la Guíadel usuario de IBM Cognos Real-time Monitoring Workbench.

Procedimiento1. En función de la versión de JBoss que utilice, edite el archivo de configuración

jboss-log4j.xml o log4j.xml que se encuentra en el directorioserver/default/conf/ de JBoss. En ese archivo, desplácese hasta la secciónsiguiente:<root>

<appender-ref ref="CONSOLE"/>

<appender-ref ref="FILE"/>

</root>

2. Cambie la definición de <raíz> y, en la sección "Categorías", añada una nuevacategoría, tal como se indica a continuación:<root>

<appender-ref ref="CONSOLE"/>

</root>

...

<category name="org">

<appender-ref ref="FILE"/>

</category>

Esto indicará al servidor de aplicaciones JBoss que envíe todos los mensajes,como los mensajes que publica el servidor de aplicaciones JBoss, desde lascategorías "org" hasta la consola. Los mensajes de las categorías "com" (comocom.cognos) no se registrarán en el archivo.

3. Guarde el archivo jboss-log4j.xml o log4j.xml que ha cambiado.

Importante: No realice este cambio en la configuración del registro mientras elservidor de aplicaciones está en ejecución porque éste duplicaría los mensajesen la consola y en el archivo.

Instalación del servidor de aplicaciones JBossPara instalar y desplegar IBM Cognos Real-time Monitoring correctamente, debeutilizar el archivo EAR para el servidor de aplicaciones JBoss que utilice.


Procedimiento1. Vaya al directorio ubicación_c10/realtime/bin64 para encontrar el archivo EAR

correspondiente a la versión del servidor de aplicaciones JBoss que utiliza:v Para JBoss 4.2.3: utilice Realtime.ear

v Para JBoss 5.1: utilice Realtime-jboss5.ear

2. Copie el archivo EAR correspondiente en el directorio $JBOSS_HOME/server/default/deploy.

Consideraciones al desplegar Real-time Monitoring en unservidor de aplicaciones JBoss

En esta sección se describen algunas consideraciones que han de observarse aldesplegar IBM Cognos Real-time Monitoring en un servidor de aplicaciones JBoss.

Cifrado de la contraseña de base de datos de JBossPor razones de seguridad, puede que deba cifrar las contraseñas que se utilizanpara iniciar la sesión en la base de datos.

Para obtener información acerca de cómo cifrar la contraseña de base de datos,consulte el sitio web de JBoss:

http://www.jboss.org/community/docs/DOC-9703

Modificación del servidor de aplicaciones JBoss para mejorar elrendimientoEl procedimiento de esta sección puede mejorar el rendimiento global de la red deIBM Cognos Real-time Monitoring.

Nota: Para realizar este procedimiento es necesario reiniciar el servidor deaplicaciones JBoss.

Procedimiento1. Localice y abra el archivo server.xml. Para la versión 4.2.x, el archivo se

encuentra en el directorio \server\default\deploy\jboss-web.deployer.2. Localice el bloque que aparece debajo de la cabecera .

Nota: El número de puerto específico y otros valores podrían variar.Este bloque debería tener el aspecto siguiente:

<Connector port="8080" address="${jboss.bind.address}"

maxThreads="400" minSpareThreads="75" maxSpareThreads="100"

enableLookups="false" redirectPort="8443" acceptCount="100"

connectionTimeout="20000" disableUploadTimeout="true"/>

3. Añada los parámetros siguientes:compression="on"

socketBuffer="1045576"

4. Guarde y cierre el archivo server.xml.5. Reinicie el servidor de aplicaciones JBoss.


Resultados


Prueba de Real-time Monitoring tras la instalación en el servidor deaplicaciones JBoss




2. Opcionalmente, cargar los ejemplos. Consulte “Carga de los ejemplos deReal-time Monitoring en el servidor de aplicaciones JBoss”.


Carga de los ejemplos de Real-time Monitoring en el servidorde aplicaciones JBoss

Cargue datos para comprobar si la aplicación funciona.

El directorio ubicación_c10/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/data contiene el esquema de base de datos Derby que contendrálas tablas, datos y activadores de demostración del centro de asistencia telefónica.Esta demostración necesita el controlador Apache Derby 10.5.3. Para obtenerinformación acerca de la descarga de Apache Derby, consulte la dirección:



El directorio ubicación_c10/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/config contiene archivos de configuración de origen de datospara configurar el origen de datos.


webcontent/samples/sdk.2. Cree el directorio /derby/databases en el directorio ubicación_instalación_JBoss/

server/.


3. Copie la base de datos ubicación_c10/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/data/ccdemo en el siguiente directorio del servidorde aplicaciones JBoss.ubicación_instalación_JBoss/server/derby/databases

4. Copie el archivo derby.jar que ha descargado desde el sitio del soporte deApache en el directorio ubicación_instalación_JBoss/server/derby/databases.

5. Copie el archivo obi_ccdemo-ds.xml, que se encuentra en el directorioubicación_c10/realtime/webcontent/samples/sdk/callcenter/CallCenterDemo/config, en el directorio ubicación_instalación_JBoss/server/default/deploy de lainstalación de JBoss.

6. Reinicie el servidor de aplicaciones JBoss.

Resultados






Desinstalación de Real-time Monitoring del servidor de aplicacionesJBoss

Antes de desinstalar IBM Cognos Real-time Monitoring, determine si necesitahacer una copia de seguridad de alguna parte de las bases de datos o metadatosde la aplicación.

Esto es especialmente importante si dispone de archivos de almacén de claves quese han guardado con contraseñas de usuario. Realice una copia de seguridad de losarchivos de almacén de claves para conservar los ID de usuario y las contraseñas.Ejecute el programa de desinstalación que se ha instalado como parte del procesode instalación. Asimismo, suprima y anule manualmente el despliegue de loscomponentes y archivos de la aplicación Real-time Monitoring que residen endiversas ubicaciones del servidor de aplicaciones y del servidor web, como losdirectorios y archivos de registro.


IBMCognos Real-time Monitoring.2. Realice la desinstalación del servidor de aplicaciones JBoss.3. Ejecute el programa de desinstalación de IBM Cognos Real-time Monitoring.


4. Desinstale la base de datos.


Antes de realizar la desinstalación, puede que desee hacer una copia de seguridadde los metadatos que se asocian a IBM Cognos Real-time Monitoring.


Procedimiento1. Inicie la sesión en IBM Cognos Real-time Monitoring Workbench.2. Utilice la característica Exportar tal como se describe en la sección que trata



Desinstalación del servidor de aplicaciones JBossEn esta sección se describe cómo desinstalar IBM Cognos Real-time Monitoring delservidor de aplicaciones JBoss.

Procedimiento1. Detenga IBM Cognos Real-time Monitoring.

v ...\%JBOSS_HOME%\bin\shutdown.bat (sistema operativo MicrosoftWindows)

v .../$JBOSS_HOME/bin/shutdown.sh (sistema operativo UNIX)2. Elimine el archivo EAR de la aplicación del directorio de despliegue de JBoss.

v Para JBoss 4.2.3: <JBOSS_HOME>/server/default/deploy/Realtime.earv Para JBoss 5.1: <JBOSS_HOME>/server/default/deploy/Realtime-jboss5.ear

3. Elimine el contenido de los directorios de JBoss siguientes:<JBOSS_HOME>/server/<config-type>/tmp

<JBOSS_HOME>/server/<config-type>/conf/jboss.web






Resultados










Capítulo 9. Instalación, configuración y desinstalación de losarchivos de servidor web de Real-time Monitoring

En esta sección se describe cómo instalar, configurar y desinstalar archivos deservidor de IBM Cognos Real-time Monitoring.

En esta sección se da por supuesto que ha adquirido el CD del producto o que hadescargado el paquete de instalación adecuado y que dispone de derechosadministrativos en el servidor web para el que desea instalar los archivos que IBMCognos Real-time Monitoring necesita para funcionar. Si el servidor web seencuentra físicamente en un sistema distinto al del servidor de aplicaciones, debeejecutar el instalador de Real-time Monitoring en el servidor que se utiliza para elentorno del servidor web y, a continuación, configurar ese servidor para elcontenido estático.

El servidor web gestiona el contenido estático y redirige las solicitudes decontenido dinámico. Para la integración de IBM Cognos Real-time Monitoring conIBM Cognos Workplace, el contenido estático de Real-time Monitoring debe residiren el mismo servidor web que aloja a IBM Cognos Business Intelligence.

Instalación de los archivos de servidor web de Real-time MonitoringPara instalar los archivos de servidor de IBM Cognos Real-time Monitoring, ejecuteel asistente de instalación desde el paquete de instalación o desde el CD delproducto.

Si el servidor web se encuentra en un sistema distinto al del servidor deaplicaciones, debe ejecutar el instalador en el servidor web. Si el servidor web seencuentra en el mismo sistema que el servidor de aplicaciones, y ha ejecutado elinstalador y ha incluido los archivos del servidor web, debe seguir los pasos quecorresponden a la configuración del servidor web para que apunte al directoriowebcontent, que se instala siguiendo estos procedimientos.

Para realizar una instalación completa, debe instalar componentes en el servidor y,a continuación, configurar éstos para que funcionen en el entorno de que dispone.Por lo general, ejecutará el instalador de IBM Cognos Real-time Monitoring enmodo interactivo. Esto significa que, en una GUI (interfaz gráfica de usuario), elinstalador le solicitará que proporcione información, y deberá ejecutarse desde unaestación de trabajo del sistema X Window, un terminal X o un PC u otro sistemaque tenga instalado software de servidor X. Para ejecutar una instalación en modointeractivo, la consola conectada al sistema debe soportar una interfaz gráfica deusuario basada en Java.

Para los sistemas que se ejecutan en un entorno Linux en IBM System z, existe unrequisito (requisito de software opcional): debe disponer de software X Windowcapaz de representar una interfaz gráfica de usuario (de esta forma, obtendrá lasbibliotecas motif que necesita). Debe habilitar el host remoto para que dirija susalida a la pantalla local. También debe establecer la variable de entorno DISPLAY.Por ejemplo, escriba export DISPLAY=nombre_host:número_pantalla.

Procedimiento1. Realice uno de los pasos siguientes en función del entorno utilizado:


v En un servidor que ejecuta el sistema operativo Microsoft Windows, en eldirectorio win64 del paquete que ha descargado, efectúe una doble pulsaciónen el archivo issetup.exe y siga las instrucciones del asistente de instalación.

v En un servidor que ejecuta el sistema operativo UNIX o Linux, en eldirectorio correspondiente al sistema operativo, escriba ./issetup y siga lasinstrucciones del asistente de instalación.

2. En la página Ubicación de instalación, especifique la ubicación de IBM Cognosy pulse Siguiente.Por ejemplo, en un servidor que ejecuta el sistema operativo MicrosoftWindows, el valor predeterminado esC:\Archivos de programa\ibm\cognos\c10_64Si desea realizar la instalación en un sistema que contiene otros componentesde IBM Cognos, como IBM Cognos Business Intelligence Versión 10.1.0, realicela instalación en el mismo directorio.Si no utiliza el directorio de instalación predeterminado, utilice un nombre dedirectorio que sólo contenga caracteres ASCII. Algunos servidores web nosoportan caracteres que no sean ASCII en los nombres de los directorios.

3. Si desea realizar la instalación sólo en el servidor web, en la página Selecciónde componentes, expanda IBM Cognos Real-time Monitoring, elimine laselección de Archivos del servidor de aplicaciones de Real-time Monitoring ypulse Siguiente.

4. Complete los pasos del asistente de instalación y pulse Terminar.

Resultados

El directorio webcontent de Real-time Monitoring se instala para el servidor web.Ahora está preparado para configurar el servidor web. Para obtener másinformación, consulte:v “Configuración de un servidor Apache o IBM HTTP Server para la gestión del

contenido estático”v “Configuración de Microsoft Internet Information Server para que funcione con

la aplicación Real-time Monitoring instalada en un WebSphere ApplicationServer” en la página 86

v “Configuración de Microsoft Internet Information Server para que funcione conla aplicación Real-time Monitoring instalada en un servidor de aplicacionesWebLogic” en la página 87

v “Configuración de Microsoft Internet Information Server para que funcione conla aplicación Real-time Monitoring instalada en un servidor de aplicacionesJBoss” en la página 89

Configuración de un servidor Apache o IBM HTTP Server para lagestión del contenido estático

En esta sección se describe cómo configurar el servidor web Apache HTTP o IBMHTTP Server (IHS) para la gestión de contenido estático para IBM CognosReal-time Monitoring que se ha instalado en IBM WebSphere Application Server,en el servidor de aplicaciones Oracle WebLogic o en el servidor de aplicacionesJBoss.

En estos pasos se da por supuesto que ya ha instalado el servidor web ApacheHTTP o IBM HTTP Server (IHS).


Como parte de esta tarea, debe editar el archivo realtime.conf para actualizar lainformación específica de la configuración de que dispone. Debe editar el archivocon la ruta de URL del servidor de aplicaciones en todas las líneas ProxyPass yProxyPassReverse.

Antes de empezar

Para completar estas tareas, debe disponer de acceso al directorio webcontent queel instalador de IBM Cognos Real-time Monitoring ha instalado. El archivorealtime.conf debe copiarse en la estructura de directorios del servidor web ApacheHTTP o IBM HTTP Server (IHS). Debe disponer de derechos administrativos parael servidor de aplicaciones y el servidor web. Debe conocer la ruta de URL y losnombres de los puertos del servidor de aplicaciones, así como la ubicación delarchivo httpd.conf, que se encuentra en el directorio <raíz_apache>/conf.

Procedimiento1. Recopile la siguiente información para poder configurar el servidor web de

modo que apunte al directorio webcontent que ha instalado y al servidor deaplicaciones.v Ubicación del directorio webcontentv Ruta de URL del servidor de aplicaciones, como http://localhost:8001/

realtime o bien http://localhost:8080/realtime2. En el servidor web, si el directorio conf.d todavía no existe, debe crear el

directorio conf.d en el mismo nivel que el directorio conf.3. Copie el archivo realtime.conf, que se encuentra en el directorio

ubicación_c10/realtime/configuration, en el directorio conf.d.4. Edite la copia del archivo realtime.conf que ha copiado en el directorio conf.d y

realice los cambios siguientes:v Si utiliza IBM WebSphere Application Server, debe añadir la entrada

siguiente.WebSpherePluginConfig "<appserver_install_root>\profiles\<profile_name>\config\cells\plugin-cfg.xml"

v Cambie la línea Alias para que apunte a la ubicación de su directorio deaplicación web.Por ejemplo, en el sistema operativo Microsoft Windows, escriba:Alias /cognos/realtime "C:/Program Files/ibm/cognos/c10_64/realtime/webcontent"

v Cambie las entradas ProxyPass y ProxyPassReverse para que reflejen laubicación y el puerto del servidor de aplicaciones.Cambie la dirección IP y la parte del puerto del URI en función del nombrede host y del puerto en que se ejecuta el servidor de aplicaciones.

5. Edite el archivo httpd.conf.Si el archivo httpd.conf todavía no contiene esta entrada, debe añadir lasiguiente línea dentro del archivo httpd.conf:Include conf.d/*.conf

6. Guarde los cambios que ha realizado.7. Reinicie el servidor web.

Capítulo 9. Instalación, configuración y desinstalación de los archivos de servidor web de Real-time Monitoring 85

Configuración de Microsoft Internet Information Server para quefuncione con la aplicación Real-time Monitoring instalada en unWebSphere Application Server

La aplicación IBM Cognos Real-time Monitoring que se ha instalado en IBMWebSphere Application Server puede configurarse para utilizar Microsoft InternetInformation Server (IIS) como componente de servidor web.

Para configurar Microsoft Internet Information Server (IIS) con IBM WebSphereApplication Server, consulte el Information Center siguiente, donde seproporcionan pasos detallados para realizar estas tareas:

Tabla 25. Enlaces con información adicional sobre cómo configurar ISS con WebSphereApplication Server


6.0 http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_manualWebIIS.html



IBM WebSphere Application Server utiliza un conector binario exclusivo para cadaservidor web soportado. El conector proporciona información acerca del servidorde aplicaciones al servidor web, que utiliza la información para comunicarse con elservidor de aplicaciones y ejecutar aplicaciones específicas en el servidor deaplicaciones.

Procedimiento1. Instale el conector de WebSphere Application Server en el servidor IIS.2. En la consola administrativa de WebSphere Application Server, actualice la

configuración global del conector del servidor web.3. En el servidor IIS, cree un directorio virtual cuyo alias sea realtime, con una

instalación predeterminada.4. Asegúrese de que el directorio virtual dispone de privilegios de lectura y

ejecución y de que el archivo index.htm de Habilitar página de contenidopredeterminado se muestra al principio de la lista.

5. Añada el filtro ISAPI (Interfaz de programación de aplicaciones de servicios deInternet) a la configuración de IIS.Especifique iisWASPlugin para el nombre del filtro y vaya al archivoiisWASPlugin_http.dll, que se encuentra en la carpeta ubicación de instalación deWebSphere/Plugins/bin/IIS_webserver1 del ejecutable.

6. Guarde el trabajo realizado.7. Para configurar el servidor web para la ejecución de extensiones de WebSphere

Application Server, añada una nueva extensión de servidor web con el nombreWASPlugin.Para la ruta, vaya al archivo iisWASPlugin_http.dll.


http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.base.doc/info/aes/ae/tins_manualWebIIS.html









8. Asegúrese de que está seleccionada la casilla de verificación Establecer elestado de extensión a Permitida.

9. En IIS, detenga y vuelva a iniciar el sitio web predeterminado.

Resultados

El servidor web de Real-time Monitoring se ha configurado y debería poder iniciarla sesión en Real-time Monitoring Workbench para finalizar la configuración.

Configuración de Microsoft Internet Information Server para quefuncione con la aplicación Real-time Monitoring instalada en unservidor de aplicaciones WebLogic

La aplicación IBM Cognos Real-time Monitoring que se ha instalado en unservidor de aplicaciones Oracle WebLogic puede configurarse para utilizarMicrosoft Internet Information Server (IIS) como componente de servidor web.

Microsoft Internet Information Server (IIS) proporciona contenido estático, porejemplo páginas web, a los usuarios de Real-time Monitoring. Para gestionar elcontenido dinámico, IIS utiliza un proxy para consultar las solicitudes para elservidor de aplicaciones WebLogic. Como conector de IIS, que debe instalar en elservidor de aplicaciones WebLogic, gestiona la coordinación entre IIS y WebLogic.

Para obtener instrucciones detalladas, consulte el sitio siguiente:

http://download.oracle.com/docs/cd/E12840_01/wls/docs103/plugins/isapi.html

Como parte del proceso de instalación de Real-time Monitoring, se instalandiversos archivos de ejemplo que le ayudarán a configurar el funcionamientoconjunto de IIS y Oracle WebLogic. El siguiente archivo se encuentra en eldirectorio ubicación_c10/configuration: iisproxy.ini.

Antes de empezar

Antes de iniciar esta tarea, asegúrese de que dispone de derechos administrativospara el servidor de aplicaciones y el servidor web, y de que ha localizado elarchivo de ejemplo.

Procedimiento1. Cree un directorio virtual en IIS denominado cognos y especifique que éste

apunte a la ubicación predeterminada para IIS, como:c:\inetput\wwwroot

2. Para redirigir las solicitudes para la página inicial a la página inicial deReal-time Monitoring, edite las propiedades de Sitio Web predeterminado yel directorio virtual cognos. En la sección Directorio particular o Directoriovirtual, seleccione Una redirección a una dirección URL, redirija a/cognos/realtime/ y establezca las casillas de verificación La misma direcciónURL que arriba y Un directorio por debajo de la URL escrita.

3. Cree un directorio virtual dentro del directorio cognos denominado realtimeen Sitio Web predeterminado. Su Directorio de contenido del sitio webdebería ser ubicación_c10/realtime/webcontent


4. Edite las propiedades del directorio virtual realtime. En la pestañaDocumentos, asegúrese de que la casilla de verificación Habilitar página decontenido predeterminado está establecida y de que index.htm es el primerelemento de la lista.

5. Localice los archivos iisproxy.dll e iisforward.dll, que se encuentran en eldirectorio ubicación_instalación_WebLogic/server/plugin/win/x64,ubicación_instalación_WebLogic/server/plugin/win/64 oubicación_instalación_WebLogic/server/plugin/win/32, y copie los archivos enun directorio al que IIS pueda acceder.Asegúrese de que los permisos para el archivo iisproxy.dll incluyen al usuarioque ejecutará IIS, como IUSR_nombre_máquina.

6. Configure los valores de conexión del proxy:v Para configurar los valores de conexión del proxy por extensión de archivo,

utilice el Administrador de Internet Information Service para seleccionar elsitio web, establecer las propiedades del sitio web y configurar los valoresde la aplicación.

v Para configurar los valores de conexión del proxy por ruta, utilice elAdministrador de Internet Information Service para registrar el archivo.wlforward como un tipo de archivo especial que el archivo iisproxy.dllgestionará en IIS. Este procedimiento requiere que defina una propiedad,WlForwardPath, en iisproxy.ini y que establezca el parámetro PathTrim paraque se elimine la extensión de los archivos WlForwardPath cuando seanecesario.El archivo iisproxy.ini que se proporciona en el directoriorealtime/configuration tiene los valores correctos para WlForwardPath. Sinembargo, si no se ejecuta en el mismo servidor que IIS, este archivo debemodificarse para que apunte al servidor WebLogic correcto (consulte el paso8).

7. Para establecer los parámetros de configuración, copie y edite el archivoiisproxy.ini, que se encuentra en el directorio ubicación_c10/realtime/configuration, en la misma ubicación que el archivo iisproxy.dll.

8. Si WebLogic no se ejecuta en el mismo servidor que IIS, o si no se ejecuta enel puerto predeterminado 7001, edite el archivo para definir el host y elnúmero de puerto que el host del servidor WebLogic utiliza para gestionar lassolicitudes del proxy desde el conector de Microsoft Internet InformationServer.

9. Mediante la utilización de la consola del Administrador de IIS, habilite elconector permitiendo todas las extensiones ISAPI desconocidas.

10. Mediante la utilización de la consola del Administrador de IIS, habilite lacompresión del contenido estático y dinámico.

11. En función de las necesidades de seguridad que tengan aplicación o de otrasconsideraciones relacionadas con la configuración, puede que deba realizar lastareas siguientes.v Habilitar la autorización básica.v Configurar la autenticación de perímetro.v Habilitar SSL (Capa de sockets seguros).

12. Tras haber finalizado, reinicie el Servicio de administración IIS.


Configuración de Microsoft Internet Information Server para quefuncione con la aplicación Real-time Monitoring instalada en unservidor de aplicaciones JBoss

La aplicación IBM Cognos Real-time Monitoring que se ha instalado en unservidor de aplicaciones JBoss puede configurarse para utilizar Microsoft InternetInformation Server (IIS) como componente de servidor web.

Estos procedimientos requieren que descargue e instale Apache Tomcat Connector(isapi_redirect.dll) desde Apache Software Foundation. Como parte del proceso deinstalación de Real-time Monitoring, se instalan diversos archivos de ejemplo quele ayudarán a configurar el funcionamiento conjunto de IIS y JBoss. En eldirectorio ubicación_c10/configuration encontrará los archivos siguientes:isapi_redirect.properties, rewrite.properties, uriworkermap.properties yworkers.properties.

Para configurar Microsoft Internet Information Server (IIS) con un servidor deaplicaciones JBoss, consulte el siguiente sitio web:

http://community.jboss.org/wiki/UsingModjk12WithJBossAndIIS

Antes de empezar

Antes de iniciar esta tarea, asegúrese de que dispone de derechos administrativospara el servidor de aplicaciones y el servidor web, y de que ha localizado losarchivos de ejemplo.

Procedimiento1. Desde en sitio web de Apache Software Foundation, descargue

isapi_redirect-1.2.28-chunking.dll desde la página de las versiones en binariode Apache Tomcat Connectors. Guarde este archivo en el directorioubicación_c10/realtime/configuration y cambie su nombre porisapi_redirect.dll. Desde el Explorador de Microsoft Windows, pulse con elbotón derecho del ratón en el archivo y pulse Propiedades. Si aparece el botónDesbloquear, pulse éste y, a continuación, pulse Aceptar.

Nota: La versión 1.2.30 no funciona con Real-time Monitoring.2. Edite el archivo ubicación_c10/realtime/configuration/isapi_redirect.properties.

Si la ubicación de los archivos de configuración y del archivo de registro, quese representa mediante ubicación_c10, no es exacta, modifique los valores de laubicación de log_file, worker_file, rewrite_rule_file y worker_mount_file.

3. Edite el archivo ubicación_c10/realtime/configuration/worker.properties.4. Abra la aplicación de administración Internet Administration Services.5. Cree un directorio virtual en Sitio Web predeterminado denominado jakarta,

sólo con permisos de Ejecución. El directorio inicial debería serubicación_c10/realtime/configuration/

6. Cree un directorio virtual en IIS denominado cognos. Especifique que ésteapunte a la ubicación predeterminada para IIS, como:c:\inetput\wwwrootPara redirigir las solicitudes para la página inicial a la página inicial deReal-time Monitoring, edite las propiedades de Sitio Web predeterminado yel directorio virtual cognos. En la sección Directorio particular o Directoriovirtual, seleccione Una redirección a una dirección URL, redirija a


/cognos/realtime/ y establezca las casillas de verificación La misma direcciónURL que arriba y Un directorio por debajo de la URL escrita.

7. Cree un directorio virtual dentro del directorio cognos denominado realtimeen Sitio Web predeterminado. Su Directorio de contenido del sitio webdebería ser ubicación_c10/realtime/webcontentEdite las propiedades del directorio virtual realtime. En la pestañaDocumentos, asegúrese de que la casilla de verificación Habilitar página decontenido predeterminado está establecida y de que index.htm es el primerelemento de la lista.

8. Edite las propiedades del Sitio Web predeterminado. Añada un filtro ISAPIdenominado Realtime JBoss, con el ejecutable ubicación_c10/realtime/configuration/isapi_redirect.dll.

9. Habilite la compresión HTTP del contenido estático y del contenido dinámicoen IIS.

10. Reinicie el Servicio de administración IIS.

Verificación de la configuración para el contenido estático y dinámicoDespués de haber configurado los servidores para el contenido estático y dinámico,debe verificar la configuración.

Realice lo siguiente para verificar que los servidores se han configuradocorrectamente.

Procedimiento

En el navegador web, escriba la URL siguiente:http://nombre_servidor_web:puerto_servidor_web

Resultados

El navegador debería redirigirle a la página de aterrizaje de IBM Cognos Real-timeMonitoring. Si pulsa Modelar mis datos en tiempo real, debería obtener unapantalla de inicio de sesión para IBM Cognos Real-time Monitoring.

Configuración del inicio de sesión único para eTrust SiteMinderEn esta sección se describe cómo configurar el inicio de sesión único (SSO) paraeTrust SiteMinder.

Procedimiento1. Configure SiteMinder de modo que tenga una variable de cabecera, como

SM_USER, que contiene el nombre del usuario que inicia la sesión.2. En IBM Cognos Real-time Monitoring, sincronice todos los usuarios desde el

mismo proveedor de directorios que el que SiteMinder utiliza.Todos los nombres de usuario que se pasan por medio de la variable decabecera SM_USER deben existir en Real-time Monitoring.

3. Inicie la sesión en IBM Cognos Real-time Monitoring Workbench y vaya aValores del sistema, en Consola de administración.

4. En Valores del sistema, realice lo siguiente:v Seleccione Gestión y autenticación de usuarios

v Seleccione la casilla de verificación Habilitar inicio de sesión único.v Establezca Cabecera de solicitud en SM_USER.


Nota: Debe establecer la URL de cierre de sesión en una URL distinta de lautilizada para IBM Cognos Real-time Monitoring Workbench o Dashboard.

Desinstalación de Real-time Monitoring del servidor webEjecute el programa de desinstalación para eliminar IBM Cognos Real-timeMonitoring del servidor web, si éste se ha instalado en otro sistema.


pulse Siguiente.3. Seleccione IBM Cognos Real-time Monitoring y pulse Siguiente.4. Cuando se haya completado el programa de desinstalación, pulse Terminar.5. Si se trata de un servidor web Apache HTTP o IBM HTTP Server (IHS),

también deberá eliminar realtime.conf del directorio conf.d.

Resultados




Capítulo 10. Configuración de Real-time Monitoring tras lainstalación

En esta sección se describe cómo configurar IBM Cognos Real-time Monitoring trasla instalación de la aplicación en el servidor de aplicaciones y la configuración delcontenido estático en el servidor web.

Para obtener información detallada acerca de la configuración de lainteroperabilidad entre Real-time Monitoring e IBM Cognos Workspace, consulte lasección que trata acerca de la configuración de la interoperabilidad en lapublicación IBM Cognos Real-time Monitoring Workbench Guía del usuario.

Configuración de Real-time Monitoring en IBM Cognos Real-timeMonitoring Workbench

En esta sección se describe cómo definir valores para IBM Cognos Real-timeMonitoring.

La mayor parte de los valores de configuración para Real-time Monitoring serealizan desde la Consola de administración de Real-time Monitoring Workbench.Tras instalar y desplegar Real-time Monitoring, deberá definir algunos valores paraque los usuarios puedan utilizar el producto:v Identificar un directorio para los archivos de registro (registrador de

recuperación y ubicación de punto de comprobación).v Habilitar el correo electrónico mediante la configuración de la conexión SMTP

(protocolo simple de transferencia de correo).v Especificar la ubicación y la contraseña del almacén de claves del usuario.

Todos los valores de configuración se describen en los pasos siguientes.

Existen algunos valores que son necesarios para poder configurar cubos y vistas deReal-time Monitoring como un origen de datos en IBM Cognos BusinessIntelligence. Al publicar un paquete, asegúrese de eliminar la selección de Modode consulta dinámica de los cubos y las vistas. En IBM Cognos FrameworkManager, esta opción está establecida de forma predeterminada.

Para las vistas, después de haber creado un asunto de consulta en una vista, en laventana Definición de asunto de consulta, en la pestaña Información sobreconsultas, pulse Opciones. A continuación, en la pestaña Configuración de SQL,en Tipo de SQL, seleccione Cognos, que podría ser el valor predeterminado.

Procedimiento1. Inicie la sesión en IBM Cognos Real-time Monitoring Workbench.

Mediante Microsoft Internet Explorer 6.0 o una versión más reciente, conéctesecon IBM Cognos Real-time Monitoring Workbench desde el servidor deaplicaciones que ejecuta IBM Cognos Real-time Monitoring:http://nombre_servidor_web:puerto_servidor_web/cognos/realtime/landing/landingpage.htm

2. En la página de inicio de sesión, especifique el nombre de usuario rtmadmin yla contraseña manager.


La primera vez que inicie la sesión tras la instalación, un cuadro de diálogo lesolicitará que complete diversos valores de configuración del sistemanecesarios, si anteriormente no se han configurado. Si se han configuradopropiedades de inicio desde un archivo de texto, el cuadro de diálogo noaparecerá.

3. Pulse Valores del sistema.4. Complete los valores de configuración siguientes en Configuración del sistema:

Tabla 26. Valores del sistema obligatorios de Real-time Monitoring

Valor Ubicación de la opción en Valores del sistema

Directorio de registro derecuperación

Configuración del punto de comprobación

Directorio de registro Registro

Host SMTP Configuración SMTP. Es el nombre del host de correoelectrónico que proporciona el transporte. Un nombre típicopodría ser: correo.midominio.com.

Dirección de origenSMTP

Configuración SMTP. Es la dirección que aparece en el campoDe para todos los mensajes de correo electrónico que el sistemaenvía.

Usuario de SMTP Configuración SMTP. Es el nombre de usuario que el sistemautiliza para acceder al transporte.

Ubicación del almacén declaves

Configuración de cifrado. Es la ubicación y nombre del almacénde claves del usuario.

Contraseña del almacénde claves

Configuración de cifrado. Es la contraseña del almacén declaves del usuario. Esta contraseña se utiliza para abrir elalmacén de claves. La contraseña del almacén de claves que seproporciona para éste en el disco de instalación es 8deb5102f8.

Contraseña de la claveprincipal del usuario

Configuración de cifrado. Es la contraseña de la clave privadadel usuario. Esta contraseña se utiliza como origen para cifrar elusuario. La contraseña del almacén de claves que seproporciona en el disco de instalación es 8deb5102f8.

La configuración SMTP (protocolo simple de transferencia de correo) especificacómo ha de conectarse Real-time Monitoring con el servidor de correo queenvía las notificaciones de correo electrónico. El servidor es externo respecto aReal-time Monitoring y su administración la realiza el administrador delsistema de correo electrónico. Póngase en contacto con el administrador paraconfigurar una cuenta para Real-time Monitoring y para obtener informacióndetallada acerca de estos valores de configuración.Necesitará almacenes de claves de administrador y de usuario para el cifrado ydescifrado de las contraseñas. Debe especificar las ubicaciones de estosalmacenes de claves. De forma predeterminada, el archivo del almacén declaves del administrador, admin.jks, y el archivo del almacén de claves deusuario, user_sample.jks, se encuentran en el directorio ubicación_c10/realtime/configuration/keystore. La contraseña para Contraseña del almacén de clavesdel administrador y Contraseña de la clave primaria del administrador para elarchivo admin.jks es 40fd2442fa. Estas contraseñas se utilizan para cifrar elusuario rtmadmin. La contraseña para Contraseña del almacén de claves yContraseña de la clave principal del usuario para el archivo user_sample.jks es8deb5102f8. Estas contraseñas se utilizan para cifrar usuarios distintos delusuario rtmadmin.


Nota: Existen almacenes de claves de ejemplo en el directorio\ubicación_c10\realtime\configuration\keystore, y se le aconseja crear los suyospropios.

5. Pulse Aceptar.

Nota: No podrá salir del cuadro de diálogo Configuración del sistema hastaque haya completado todos los valores de configuración.

6. Para empezar a trabajar, pulse Modelar mis datos en tiempo real.

Configuración de los valores de LDAP (Lightweight Directory AccessProtocol)

Además de permitirle crear manualmente usuarios y permisos de usuario, IBMCognos Real-time Monitoring le permite importar información de usuario de losproveedores del protocolo LDAP (Lightweight Directory Access Protocol)soportados.

Real-time Monitoring puede integrarse con cualquier proveedor de LDAP quesoporte el protocolo LDAP Versión 3. Para obtener una lista de proveedores deautenticación soportados, consulte el sitio web del centro del cliente de IBMCognos.

IBM Cognos Real-time Monitoring puede configurarse para la realización desincronizaciones planificadas con el servidor LDAP para actualizar los usuarios yroles existentes. También se puede realizar una sincronización manual.

Nota: En Real-time Monitoring, un "rol" se correlaciona con un "grupo" en elservidor LDAP. En el proceso de sincronización, Real-time Monitoring añade oactualiza los usuarios. Los grupos LDAP se convierten en roles en Real-timeMonitoring. Al importar los roles, éstos conservan sus asignaciones de usuarioLDAP.

Para obtener más información sobre LDAP, consulte “Consideraciones relacionadascon la conectividad LDAP (Lightweight Directory Access Protocol)” y la secciónsobre LDAP en la Guía del usuario de IBM Cognos Real-time Monitoring Workbench.

Consideraciones relacionadas con la conectividad LDAP(Lightweight Directory Access Protocol)

En esta sección se identifica lo que es necesario tener en cuenta al utilizar laconectividad LDAP(Lightweight Directory Access Protocol).v Si un usuario o rol se crea localmente en el servidor de IBM Cognos Real-time

Monitoring y el mismo usuario se encuentra en el origen del protocolo LDAP(Lightweight Directory Access Protocol), el usuario de LDAP se pasa por alto.Sólo existe una excepción, el usuario rtmadmin.

v Puesto que los permisos nunca se almacenan cuando se utiliza el protocoloLDAP (Lightweight Directory Access Protocol), al importar roles, usuarios ypertenencias a roles desde un origen de LDAP externo, no se importa ningúnpermiso. Los permisos se asignan localmente en IBM Cognos Real-timeMonitoring Workbench. Para obtener más información, consulte las secciones enlas que se describen los permisos en las publicaciones Guía del usuario de IBMCognos Real-time Monitoring Workbench e IBM Cognos Real-time MonitoringTechnical Reference.

Capítulo 10. Configuración de Real-time Monitoring tras la instalación 95



v Real-time Monitoring importa un usuario, pero no se importa ninguno de losgrupos o roles a los que se ha asignado el usuario. El usuario se crea y sigue sinasignarse a ningún rol en Real-time Monitoring.

v Si Real-time Monitoring importa un rol pero éste no tiene ningún usuariomiembro, el rol se creará, pero no tendrá ningún miembro.

v Los usuarios que se han creado manualmente en Real-time Monitoring sólopueden asignarse a roles creados manualmente. Asimismo, los usuariossincronizados desde LDAP también pueden asignarse a roles creadosmanualmente. Sin embargo, los roles sincronizados desde LDAP no puedenasignarse a usuarios creados manualmente. Sólo los usuarios sincronizadospueden asignarse a roles sincronizados. Tales asignaciones deben realizarse en elservidor LDAP o en el servidor de Microsoft Active Directory.


Capítulo 11. Resolución de problemas de instalación

En esta sección se describen tareas que puede realizar en caso de que sea necesariosolucionar algún problema de instalación.

Resolución de problemasResolución de problemas es un enfoque sistemático para solucionar un problema. Elobjetivo de la resolución de problemas es determinar la razón por la que algo nofunciona como estaba previsto y decidir cómo resolverlo.

El primer paso en el proceso de resolución de problemas es describir el problemaen su totalidad. Las descripciones de problemas le ayudan a usted y alrepresentante del soporte técnico de IBM a determinar por dónde comenzar paraencontrar la causa del problema. Este paso supone formularse las siguientespreguntas básicas:v ¿Cuáles son los síntomas del problema?v ¿Dónde se ha producido el problema?v ¿Cuándo se ha producido el problema?v ¿En qué condiciones se ha producido el problema?v ¿Se puede reproducir el problema?

Las respuestas a estas preguntas suelen conllevar una buena descripción delproblema, lo cual puede conducir a la resolución del mismo.

¿Cuáles son los síntomas del problema?

Al empezar a describir un problema, la pregunta más obvia es “¿Cuál es elproblema?” Esta pregunta puede parecer sencilla, sin embargo, puede desgranarseen otras cuestiones diversas que crean una imagen más descriptiva del problema.Estas cuestiones pueden ser:v ¿Quién, o qué, informa del problema?v ¿Cuáles son los códigos de error y los mensajes?v ¿Cómo ha fallado el sistema? Por ejemplo, ¿el problema se debe a un bucle o a

que el sistema se ha colgado, se ha apagado, ha visto reducido su rendimiento oha arrojado un resultado incorrecto?

¿Dónde se ha producido el problema?

La determinación del lugar en el que se ha originado el problema no siempre esfácil, pero es uno de los pasos más importantes a la hora de resolver un problema.Puede haber muchas capas tecnológicas entre los componentes fallidos y los queoriginan el informe del problema. Redes, discos, unidades, etc., sólo son algunosde los componentes que deben tomarse en cuenta al investigar problemas.

Las preguntas siguientes contribuyen a detectar en qué capa tecnológica se haproducido el problema:v ¿El problema es específico de una plataforma o sistema operativo, o por el

contrario es común en varias plataformas o sistemas operativos?v ¿Se da soporte al entorno y configuración actuales?


Si una capa informa del problema, el problema no tiene por qué haberse generadonecesariamente en esa capa. Parte de la tarea de identificar dónde se origina unproblema es conocer el entorno en el que existe. Tómese un tiempo en describir elentorno del problema en su totalidad, incluyendo el sistema operativo y la versión,todas las aplicaciones de software correspondientes y sus versiones, y el hardware.Compruebe si realmente el entorno de ejecución está soportado; muchos de losproblemas identificados se originan por la incompatibilidad de ciertos niveles desoftware que no están diseñados para ejecutarse juntos o no se han probadosuficientemente en combinación.

¿Cuándo se ha producido el problema?

Desarrolle una cronología detallada de los eventos que han conducido hasta elerror, sobre todo en los casos en los que sólo ha ocurrido una vez. Para desarrollarfácilmente una cronología, realice el proceso en orden inverso: empiece en elmomento en que se comunicó el error (con la máxima precisión posible, incluso enmilisegundos) y vaya retrocediendo por los registros y la información. Por logeneral, la investigación se detiene en el primer evento sospechoso que seencuentra en un registro de diagnóstico.

Para desarrollar una cronología detallada de los eventos, conteste a estaspreguntas:v ¿El problema ocurre sólo en un momento concreto del día o de la noche?v ¿Con qué frecuencia se repite el problema?v ¿Cuál es la secuencia de eventos que conduce al momento en que se comunicó

el problema?v ¿El problema ha ocurrido después de un cambio del entorno, como una

actualización o la instalación de software o hardware?

¿En qué condiciones se ha producido el problema?

Conocer los sistemas y las aplicaciones que se estaban ejecutando en el momentoen que se produjo el problema constituye una parte importante del proceso deresolución de problemas. Estas preguntas sobre su entorno pueden ayudarle aidentificar la causa del problema:v ¿El problema siempre ocurre cuando se realiza la misma tarea?v ¿Es necesario que se dé una secuencia determinada de eventos para que el

problema se produzca?v ¿Falló alguna otra aplicación a la vez?

Responder a este tipo de preguntas puede ayudarle a explicar el entorno en el quese produjo el problema y correlacionar cualquier tipo de dependencia. Recuerdeque sólo porque varios problemas puedan haber ocurrido más o menos a la vez notienen por qué estar relacionados.

¿Se puede reproducir el problema?

Los problemas que pueden reproducirse suelen ser más fáciles de resolver. Noobstante, los problemas que pueden reproducirse pueden presentar una desventaja.Si el problema tiene un impacto empresarial importante, no querrá que vuelva arepetirse. Si es posible, vuelva a crear el problema en un entorno de desarrollo oprueba, que suele ofrecer más flexibilidad y control durante la investigación.Responda a las preguntas siguientes:v ¿Se puede volver a crear el problema en un sistema de prueba?


v ¿Son varios los usuarios o aplicaciones que han encontrado el mismo tipo deproblema?

v ¿Se puede volver a crear el problema ejecutando un solo comando, una serie decomandos o bien una aplicación específica?

Búsqueda en bases de datos de conocimientos KnowledgeBase

Probablemente encontrará soluciones a problemas si busca en las bases de datos deconocimientos IBM Knowledge Base. Puede optimizar los resultados a través de losrecursos disponibles, herramientas de soporte y métodos de búsqueda.

Acerca de esta tarea

Puede encontrar información útil si busca en el Information Center de IBMCognos, pero en ocasiones necesitará profundizar más allá del Information Centerpara resolver problemas.

Procedimiento

Para buscar la información que necesita en las bases de datos de conocimientos,utilice uno o más de estos métodos:v Busque el contenido que necesita a través de IBM Support Portal (IBM Cognos

Business Intelligence Support Portal).IBM Support Portal es una visión unificada y centralizada de todas lasherramientas de soporte técnico e información para todos los sistemas, softwarey servicios de IBM. IBM Support Portal le permite acceder a la cartera desoporte electrónico de IBM desde un único lugar. Puede personalizar las páginaspara centrarse solamente en la información y en los recursos que necesita para laprevención de problemas y para resolverlos más rápidamente. Familiarícese conIBM Support Portal visitando los vídeos de demostración (https://www.ibm.com/blogs/SPNA/entry/the_ibm_support_portal_videos) acerca deesta herramienta. Estos vídeos constituyen una presentación de IBM SupportPortal, exploran el entorno de la resolución de problemas y otros recursos, ydemuestran de qué manera puede personalizar la página moviendo, añadiendoy suprimiendo portlets.

v Busque contenido sobre IBM Cognos a través de uno de estos recursos técnicosadicionales:– APAR (informes de problemas) de IBM Cognos BI– Sitio web de IBM Cognos BI Support– Foros y comunidades de IBM Cognos.

v Busque contenido a través de la herramienta de búsqueda de cabecera maestrade IBM. Puede utilizar la búsqueda de cabecera maestra de IBM escribiendo lacadena de búsqueda en el campo de búsqueda situado en la parte superior decualquiera de las páginas de ibm.com.

v Busque contenido utilizando cualquier motor de búsqueda externo, comoGoogle, Yahoo o Bing. Si utiliza un motor de búsqueda externo, será másprobable que los resultados incluyan información que no pertenezca al dominiode ibm.com. Sin embargo, en ocasiones puede encontrar información útil sobreresolución de problemas de productos IBM en grupos de noticias, foros y blogsque no se encuentran en ibm.com.

Consejo: Especifique “IBM” y el nombre del producto en su búsqueda si deseainformación sobre un producto IBM.

Capítulo 11. Resolución de problemas de instalación 99

http://www.ibm.com/support/entry/portal/Overview/Software/Information_Management/Cognos_Business_Intelligence

http://www.ibm.com/support/entry/portal/Overview/Software/Information_Management/Cognos_Business_Intelligence

https://www.ibm.com/blogs/SPNA/entry/the_ibm_support_portal_videos

http://www.ibm.com/search/csass/search?q=&ibm-go-btn.x=0&ibm-go-btn.y=0&ibm-go-btn=Go&sn=spe&filter=language:en+collection:dblue+ibmcontenttypeid:CT748&prod=U487531B48832U38::#q%253d%2526filter%253d%252btsswrelease%253a841%2520%252bibmcontenttypeid%253aCT748%2520%252blanguage%253aen%2520%252bcollection%253adblue%2526prod%253dU487531B48832U38%2526sn%253dspe%2526sortby%253d-moddate%2526o%253d0

http://www.ibm.com/support/entry/portal/Overview/Software/Information_Management/Cognos_8_Business_Intelligence

http://www.ibm.com/support/entry/portal/Forums_communities/Software/Information_Management/Cognos_Business_Intelligence_and_Financial_Performance_Management

Obtención de arreglosPuede que haya un arreglo del producto disponible para resolver su problema.

Procedimiento

Para buscar e instalar arreglos:1. Determine qué arreglo necesita Central de arreglos) (http://www.ibm.com/

support/fixcentral/)2. Descargue el arreglo. Abra el documento descargado y siga el enlace de la

sección de descarga del paquete“”.3. Aplique el arreglo siguiendo las instrucciones de la sección de instrucciones de

instalación del documento de descarga“”.4. Suscríbase para recibir notificaciones semanales por correo electrónico sobre

arreglos y otro tipo de información de soporte de IBM.

Cómo ponerse en contacto con el soporte de IBMEl soporte de IBM ofrece acceso a una gran variedad de recursos de IBM paraayudarle en las cuestiones de software.

Antes de empezar

Después de intentar encontrar una respuesta o solución a un problema medianteotras opciones de autoayuda como las notas técnicas, puede ponerse en contactocon el servicio de soporte de IBM. Para ponerse en contacto con el soporte de IBM,su compañía debe tener un contrato de mantenimiento activo con IBM, y usteddebe tener autorización para enviar consultas a IBM. También debe tener a manola siguiente información:v Su número de identificación de clientev Su número de solicitud de servicio, si es una solicitud de servicio en cursov Un número de teléfono donde se le pueda localizarv La versión del software que utilizav La versión del entorno operativo que utilizav Una descripción de lo que estaba haciendo cuando se produjo el problemav La transcripción exacta de los mensajes de error que se visualizaronv Los pasos que emprendió para intentar resolver el problema

Para obtener información sobre los tipos de soporte disponibles, consulte el temaSupport portfolio en Software Support Handbook.

Procedimiento

Siga estos pasos para ponerse en contacto con el soporte de IBM y consultar unproblema:1. Defina el problema, recopile información de contexto y determine la gravedad.

Para obtener más información, consulte el tema Getting IBM support enSoftware Support Handbook.

2. Recopile información de diagnóstico.3. Remita el problema al soporte de IBM de una de estas formas:

v Mediante el asistente de soporte de IBM (ISA): utilice esta característica paraabrir, actualizar y ver una solicitud de servicio electrónico (Electronic Service


http://www.ibm.com/support/fixcentral/

http://www14.software.ibm.com/webapp/set2/sas/f/handbook/offerings.html

http://www14.software.ibm.com/webapp/set2/sas/f/handbook/getsupport.html

Request) en IBM. Todo dato que se haya recopilado puede adjuntarse a estasolicitud de servicio. De esta manera se agiliza el análisis y se reduce eltiempo de resolución.

v En línea a través de IBM Support Portal: puede abrir, actualizar y ver todaslas solicitudes de servicio desde el portlet de solicitud de servicio en lapágina del mismo nombre.

v Por teléfono: para conocer el número de teléfono al que debe llamar, consultela página web Directory of worldwide contacts.

Resultados

Si el problema que remite es por un defecto de software, por falta dedocumentación o porque ésta no es precisa, el soporte de IBM crea un informeautorizado de análisis de programa (APAR). El APAR describe el problema endetalle. Siempre que sea posible, el soporte de IBM ofrece una solución temporalque puede implementarse hasta que se resuelve el APAR y se remite el arreglo.IBM publicar los APAR resueltos en el sitio web de soporte de IBM a diario, demanera que otros usuarios con el mismo problema puedan acceder a la mismasolución.

Intercambio de información con IBMPara diagnosticar o identificar un problema, puede que necesite proporcionar alsoporte de IBM datos e información sobre el sistema.

En otros casos, puede que el soporte de IBM le proporcione herramientas oprogramas de utilidad para su uso en la determinación de problemas.

Envío de información al soporte de IBMPara minimizar el tiempo de resolución del problema, puede enviar información derastreo y diagnóstico al soporte de IBM.

Procedimiento

Para enviar información de diagnóstico al soporte de IBM:1. Abra un registro de gestión de problemas (PMR). Puede utilizar IBM Support

Assistant o bien la herramienta de solicitud de servicio de IBM.2. Recopile los datos de diagnóstico que necesite. Los datos de diagnóstico

contribuyen a minimizar el tiempo que se tarda en resolver su PMR. Puederecopilar los datos de diagnóstico manual o automáticamente.

3. Comprima los archivos con el programa TRSMAIN o AMATERSE. Descargue elprograma de utilidad gratuito de IBM en el sistema IBM Cognos BI e instálelomediante el comando TSO RECEIVE.

4. Transfiera los archivos a IBM. Puede utilizar uno de los métodos siguientespara transferir los archivos a IBM:v La herramienta de solicitud de serviciov Métodos estándares de carga de datos: FTP, HTTPv Métodos seguros de carga de datos: FTPS, SFTP, HTTPSv Correo electrónicoSi utiliza un producto de IBM Cognos y utiliza ServiceLink / IBMLink paraenviar PMR, puede enviar datos de diagnóstico al soporte de IBM a través deun correo electrónico o utilizando FTP.Todos estos métodos de intercambio de datos se explican en el sitio web delsoporte de IBM.


http://www.ibm.com/software/support/

http://www.ibm.com/planetwide/

http://www.ibm.com/software/support/isa

http://www.ibm.com/software/support/isa

http://www.ibm.com/support/servicerequest

http://www.ibm.com/support/servicerequest

http://www-01.ibm.com/software/support/exchangeinfo.html

Recepción de información del soporte de IBMOcasionalmente, puede que un representante del soporte técnico de IBM le soliciteque descargue herramientas de diagnóstico u otros archivos. Puede utilizar FTPpara descargar dichos archivos.

Antes de empezar

Asegúrese de que el representante de soporte técnico de IBM le ha proporcionadolos datos del servidor preferido que deberá utilizar para descargar los archivos, asícomo el directorio exacto y los nombres de archivo a los que debe acceder.

Procedimiento

Para descargar archivos desde el soporte de IBM:1. Utilice FTP para conectarse al sitio que le ha indicado el representante de

soporte técnico de IBM y conéctese como usuario anónimo. Utilice su direcciónde correo electrónico como contraseña.

2. Vaya al directorio apropiado:a. Vaya al directorio /fromibm.

cd fromibm

b. Vaya al directorio que le haya indicado el representante de soporte técnicode IBM.cd nameofdirectory

3. Habilite el modo binario para la sesión.binary

4. Utilice el comando get para descargar el archivo que le haya especificado elrepresentante de soporte técnico de IBM.get filename.extension

5. Finalice la sesión de FTP.quit

Suscripción a actualizaciones de soportePara mantenerse informado de las noticias más importantes sobre los productos deIBM que utiliza, suscríbase a las actualizaciones.

Acerca de esta tarea

Mediante la suscripción para recibir actualizaciones, puede recibir tambiéninformación técnica importante y actualizaciones de recursos y herramientas desoporte específicos. Puede suscribirse a actualizaciones de dos formas:

Feeds RSS y suscripciones a medios de comunicación socialLos siguientes feeds RSS y suscripciones a medios de comunicación socialestán disponibles para IBM Cognos BI:v Feed RSS para un foro de developerWorks.v Suscripción al blog Cognos Support notebookv Feed RSS para el sitio de soporte de IBM Cognos Business Intelligence

Para obtener información sobre RSS, incluidos los pasos para comenzar yuna lista de las páginas web de IBM con RSS, visite el sitio IBM SoftwareSupport RSS feeds.


http://www.ibm.com/developerworks/forums/forum.jspa?forumID=2335

https://www.ibm.com/developerworks/mydeveloperworks/blogs/roller-ui/rendering/feed/cognossupport/entries/atom?lang=en

http://www-947.ibm.com/systems/support/myfeed/xmlfeeder.wss?feeder.requid=feeder.create_public_feed&feeder.feedtype=RSS&feeder.maxfeed=25&OC=SSEP7J&feeder.subdefkey=swgimgmt&feeder.channel.title=Cognos%20Business%20Intelligence&feeder.channel.descr=The%20latest%20updates%20about%20Cognos%20Business%20Intelligence

http://www.ibm.com/software/support/rss/

http://www.ibm.com/software/support/rss/

My NotificationsCon My Notifications, puede suscribirse a las actualizaciones de soporte decualquier producto de IBM. Puede especificar que desea recibir avisosdiarios o semanales por correo electrónico. Puede especificar qué tipo deinformación desea recibir, como publicaciones, consejos y sugerencias,noticias breves sobre productos (también conocidas como alertas),descargas y controladores. My Notifications le permite personalizar ycategorizar los productos sobre los que desea permanecer informado, asícomo los métodos de entrega que mejor se adapten a sus necesidades.

Procedimiento

Para suscribirse a las actualizaciones de soporte:1. Suscríbase a los feeds RSS del Producto.2. Para suscribirse a My Notifications, empiece visitando IBM Support Portal y

pulse My Notifications en el portlet Notifications.3. Ya está registrado en My support, inicie la sesión y vaya al paso siguiente. Si

no está registrado, pulse en Regístrese ahora. Cumplimente el formulario deregistro con su dirección de correo electrónico como ID de IBM y pulseEnviar.

4. Pulse Edit profile.5. Pulse Add products y elija una categoría de producto; por ejemplo, Software.6. En la segunda lista, seleccione un segmento de producto; por ejemplo, Data &

Information Management.7. En la tercera lista, seleccione un subsegmento de producto, por ejemplo,

Databases.8. Seleccione los productos de los que desee recibir actualizaciones.9. Pulse Add products.

10. Después de seleccionar todos los productos que sean de su interés, pulseSubscribe to email en la pestaña Edit profile.

11. Seleccione Please send these documents by weekly email.12. Actualice su dirección de correo electrónico según convenga.13. En Documents list, seleccione la categoría del producto; por ejemplo,

Software.14. Seleccione los tipos de documentos para los que desea recibir información.15. Pulse Update.

Resultados

Recibirá las notificaciones de actualizaciones que ha solicitado hasta que modifiquesus feeds RSS y sus preferencias en My Notifications. Puede modificar suspreferencias cuando quiera (por ejemplo, si deja de utilizar un producto y empiezaa utilizar otro distinto).

Inicio en modo a prueba de fallosSi el sistema IBM Cognos Real-time Monitoring está haciendo uso del 100% de laCPU, la cantidad de memoria es baja o el sistema no responde, puede que deseeiniciar la aplicación en modo a prueba de fallos.

Cuando inicia Real-time Monitoring en modo a prueba de fallos, todos los eventos,como los flujos de datos y las tablas de conversión, están en pausa. IBM Cognos


http://www.ibm.com/software/support/

Real-time Monitoring Dashboard y Workbench visualizan un banner en el que seindica que el sistema está actualmente en modo a prueba de fallos. El modo aprueba de fallos estará en vigor hasta que establezca la propiedad del modo aprueba de fallos en false.

Procedimiento1. Detenga Real-time Monitoring.2. Edite el archivo realtime.properties para incluir la línea siguiente:

Safe\ Mode=true3. En el servidor de aplicaciones, vuelva a iniciar Real-time Monitoring.

Resultados

Real-time Monitoring se iniciará en modo a prueba de fallos.

Consejo: Para desactivar el modo a prueba de fallos, elimine la entrada del modoa prueba de fallos del archivo realtime.properties y vuelva a iniciar Real-timeMonitoring.

Aparece el mensaje de error Almacén de claves no encontradoAl intentar iniciar IBM Cognos Real-time Monitoring Dashboard o IBM CognosReal-time Monitoring Workbench, aparece un mensaje que indica que no se haencontrado el almacén de claves.

Compruebe la ruta del almacén de claves para asegurarse de que se haespecificado con exactitud.

En la consola del servidor de aplicaciones aparece el mensaje de errorNo es posible conectarse con la base de datos

En la consola del servidor de aplicaciones aparece un mensaje que indica que no esposible conectarse con la base de datos de IBM Cognos Real-time Monitoring.

Asegúrese de lo siguiente:v La base de datos está en ejecución.v Puede accederse a la base de datos desde el servidor de aplicaciones en el que se

ha instalado Real-time Monitoring.v El origen de datos tiene los parámetros de conexión adecuados.

Los menús y controles de IBM Cognos Real-time MonitoringDashboard aparecen truncados o no funcionan correctamente

A medida que trabaja con IBM Cognos Real-time Monitoring Dashboard, loscontroles no aparecen correctamente.

Por ejemplo, no puede ver todos los elementos de selección si pulsa el controlSeleccionar carpeta.

Asegúrese de que los valores del navegador permiten ventanas iniciadas porsecuencias de comandos sin restricciones de tamaño o posición. Para obtenerinstrucciones detalladas acerca de la configuración de los navegadores, consulte“Configuración de navegadores web” en la página 9.


Falta el dominio de red en la imagen de máquina virtual de Real-timeMonitoring

IBM Cognos Real-time Monitoring puede ejecutarse en una máquina virtualcuando deben realizarse pruebas de configuración o desarrollar un sistema deformación.

Puede que una representación de máquina virtual de Real-time Monitoring nocumpla todos los requisitos, como disponer de un dominio de red para las cookiesque permiten el inicio de sesión único.

Puede sustituir una dirección IP (Protocolo Internet) para un dominio de red alconfigurar el inicio de sesión único en una máquina virtual.

Comando no válido: WebSpherePluginConfigDebe tener WebSpherePluginConfig establecido en el archivo realtime.conf si deseaejecutar Apache como servidor web con WebSphere Application Server de IBMCognos.

Puede que reciba un mensaje de error en el que se indica que existe un comandono válido si WebSpherePluginConfig se ha escrito incorrectamente o si se hadefinido mediante un módulo no incluido en la configuración del servidor.

Para solucionar este problema, debe eliminar el comentario o suprimir la línearelacionada con WebSpherePluginConfig.

Error del servidor de aplicaciones: propiedad no disponibleEl servidor de aplicaciones indica que el servlet se ha iniciado, pero que unapropiedad no está disponible.

Esto indica que el archivo obiProperties.jar no se ha encontrado en la ruta de claseo que no se ha cargado. Si la configuración se ha establecido correctamente, puedeque sea necesario volver a iniciar el servidor de aplicaciones para que los cambiosentren en vigor.

Aparece el mensaje Error de procesamientoLos mensajes de error de procesamiento pueden incluir problemas relacionadoscon la conectividad de la red.

Compruebe si existen problemas relacionados con el rendimiento.

Aparece el mensaje Error de seguridadLos problemas de seguridad pueden incluir problemas relacionados con laautenticación.

Asegúrese de que la ejecución del proveedor de autenticación es correcta.



Capítulo 12. Configuración de JMS (Java Messaging Service)

Para utilizar JMS (Java Messaging Service), debe personalizar el bean controladopor mensaje (MDB) para el servidor de aplicaciones utilizado.

Para personalizar el MDB, realice los pasos siguientes.

Procedimiento1. Si no dispone de ANT en el servidor, instálelo.2. Cree un directorio denominado mdb en el servidor.3. Localice el directorio /samples/cqmdb en el CD de instalación y copie el

contenido de /samples/cqmdb en el directorio mdb que acaba de crear.4. Establezca las variables del sistema JAVA_HOME y ANT_HOME en el servidor.

La variable JAVA_HOME establece la ruta para Java. La variable ANT_HOMEestablece la ruta para ANT. Por ejemplo:v JAVA_HOME=/usr/java6_64v ANT_HOME=/opt/apache-ant-1.7.1

5. En el directorio mdb, localice y abra el archivo env.properties.6. Establezca las siguientes propiedades en el archivo env.properties:

v jms_jarEstablezca esta propiedad en la ruta para los archivos J2EE JAR del servidorde aplicaciones. Por ejemplo,jms_jar=/opt/WebSphere/lib/j2ee.jar

v JMS.TOPICNAMESi implementa un Tema JMS, establezca esta propiedad en el nombre delTema JMS. Por ejemplo, JMS.QUEUENAME=Topic111. Asegúrese de suprimirJMS.QUEUENAME del archivo si especifica JMS.TOPICNAME.

v JMS.QUEUENAMESi implementa una Cola JMS, establezca esta propiedad en el nombre de laCola JMS. Por ejemplo, JMS.QUEUENAME=Queue111. Asegúrese desuprimir JMS.TOPICNAME del archivo si especifica JMS.QUEUENAME.

v JMS.JNDINAMEEstablezca JMS.JNDINAME en el mismo nombre JNDI de la cola o tema enque el MDB está a la escucha. Por ejemplo, JMS.JNDINAME=jms/com.cognos.obi.Queue111.

v JMS.EVENTNAMEEstablezca JMS.EVENTNAME en el nombre de flujo de datos que haplanificado configurar en IBM Cognos Real-time Monitoring Workbench. Porejemplo, JMS.EVENTNAME=event111.

v APP.INSTANCENAMEEstablezca APP.INSTANCENAME en el nombre de la instancia de IBMCognos Real-time Monitoring. Por ejemplo,APP.INSTANCENAME=cognosrtm.

v APP.PORTEstablezca APP.PORT en el puerto del servidor web en el que se ejecuta IBMCognos Real-time Monitoring. Por ejemplo, APP.PORT=80. El valorpredeterminado es 80.


v APP.HOSTEstablezca APP.HOST en el nombre de host para IBM Cognos Real-timeMonitoring. Por ejemplo, APP.HOST=localhost. El valor predeterminado eslocalhost.

7. Ejecute ANT en el directorio mdb.Tras completarse la ejecución de ANT, debería ver un archivo EAR en eldirectorio mdb/deploy. El archivo EAR será jmsmdb_topic_<nombre_tema>.earo bien jmsmdb_queue_<nombre_cola>.ear, en función de si ha especificado elnombre de un Tema JMS o de una Cola JMS en el archivo env.properties. Porejemplo, si ha especificado JMS.TOPICNAME=Topic111, ANT creará el archivojmsmdb_topic_Topic111.ear. Si ha especificado JMS.QUEUE=Queue111, ANTcreará el archivo jmsmdb_queue_Queue111.ear.

8. Despliegue el MDB en el servidor de aplicaciones.


Apéndice A. Características de accesibilidad

Las características de accesibilidad ayudan a los usuarios que tienen algunadiscapacidad física, por ejemplo movilidad restringida o visión limitada, a utilizarproductos de tecnología de la información.

Visite el centro de accesibilidad de IBM (http://www.ibm.com/able) para obtenermás información sobre el compromiso de IBM con la accesibilidad.

Atajos del teclado para el asistente de instalaciónLos atajos del teclado, o teclas de atajo, ofrecen un método más fácil y confrecuencia más rápido de navegar y utilizar el software.

El asistente de instalación utiliza las teclas de navegación estándar del sistemaoperativo Microsoft Windows, además de las teclas específicas de la aplicación.

Nota: Los siguientes atajos del teclado se basan en teclados estándar de EE.UU.

En la tabla siguiente se muestran los atajos del teclado que se pueden utilizar pararealizar algunas de las principales tareas del asistente de instalación en el sistemaoperativo Windows.

Tabla 27. Lista de atajos del teclado en un sistema operativo Windows

Para Pulse

Ir al campo siguiente de una página Tabulador

Ir al campo anterior de una página Mayús+Tabulador

Cerrar el asistente de instalación Alt+F4

Ir al paso siguiente de la configuración Alt+N

Volver al paso anterior de la configuración Alt+B

Ir a la selección siguiente de una lista Flecha abajo

Ir a la selección anterior de una lista Flecha arriba

En la tabla siguiente se muestran los atajos del teclado que se pueden utilizar pararealizar algunas de las principales tareas del asistente de instalación en los sistemasoperativos UNIX o Linux.

Tabla 28. Lista de atajos del teclado en un sistema operativo UNIX o Linux

Para Pulse

Ir al campo siguiente de una página Tabulador

Ir al campo anterior de una página Mayús+Tabulador

Cerrar el asistente de instalación Alt+F4

Ir a la selección siguiente de una lista Flecha abajo

Ir a la selección anterior de una lista Flecha arriba


http://www.ibm.com/able

En la tabla siguiente se muestran los atajos del teclado que se pueden utilizar pararealizar algunas de las principales tareas de la página Contrato de licencia delasistente de instalación.

Tabla 29. Lista de atajos del teclado en la página Contrato de licencia

Para Pulse

Aceptar el contrato de licencia Alt+A

Rechazar el contrato de licencia Alt+D

Salir del asistente de instalación Alt+x

En la tabla siguiente se muestran los atajos del teclado que se pueden utilizar pararealizar algunas de las principales tareas de IBM Cognos Configuration en unsistema operativo Windows.

Tabla 30. Lista de atajos del teclado para IBM Cognos Configuration en un sistemaoperativo Windows

Para Pulse

Guardar la configuración actual Crtl+S

Cerrar IBM Cognos Configuration Alt+F4

Cambiar el nombre al elemento seleccionado F2

Mostrar el menú Archivo Alt+F

Mostrar el menú Edición Alt+E

Mostrar el menú Ver Alt+V

Mostrar el menú Acciones Alt+A

Mostrar el menú Ayuda Alt+H

En la tabla siguiente se muestran los atajos del teclado que se pueden utilizar pararealizar algunas de las principales tareas de IBM Cognos Configuration en unsistema operativo UNIX o Linux.

Tabla 31. Lista de atajos del teclado para IBM Cognos Configuration en un sistemaoperativo UNIX o Linux

Para Pulse

Guardar la configuración actual Crtl+S

Cerrar IBM Cognos Configuration Alt+F4

Cambiar el nombre al elemento seleccionado F2


Apéndice B. Ajuste de mapas geográficos

En este apéndice se explica el esquema de base de datos geográfico y cómo puedemejorar la precisión de la geocodificación mediante la base de datos y el softwarede geocodificación.

Cómo mejorar la precisión del geocodificadorPara mejorar la precisión de los resultados del geocodificador, puede modificar lastablas ABBREVMAP y GEOCODECACHE en el origen de datos geográficos.v ABBREVMAP

La tabla ABBREVMAP expande las abreviaturas para evitar la ambigüedad anteel geocodificador. La tabla ABBREVMAP contiene las columnas ABBREV,EXPANSION y CATEGORY. El sistema utiliza la tabla para expandir lasabreviaturas de estado, provincia o país o región al nombre completo.Actualmente, la tabla tiene expansiones de nombres de estados de EE.UU. y deprovincias canadienses. En todas las filas de la tabla, la columna ABBREValmacena la abreviatura, la columna EXPANSION contiene la abreviatura que sedebe expandir y la columna CATEGORY almacena la categoría a la que se debeaplicar esta abreviatura. Los valores posibles para CATEGORY son city,stateprovince, country, region y postal code. Tenga en cuenta que se esperaque los valores de las columnas ABBREV y EXPANSION estén en mayúsculassin espacios iniciales ni finales y que no haya más de un espacio entre laspalabras.

v GEOCODECACHELa tabla GEOCODECACHE guarda en memoria caché los resultados de losgeocodificadores. La tabla GEOCODECACHE correlaciona la dirección lógicacon las coordenadas GPS de latitud/longitud que devuelve el geocodificador.Contiene las columnas ADDRESS, LATITUDE, LONGITUDE, ACCURACY yLAST_ACCESS. La columna ADDRESS almacena la dirección. Esta direccióndebe escribirse en mayúsculas, y se deben eliminar todos los espacios ajenos,incluidos los espacios junto a las comas. LATITUDE y LONGITUDE son lascoordenadas GPS. ACCURACY puede ser cualquier número. Sin embargo, sieste valor es 6 o un valor superior, se considerará una ubicación exacta.LAST_ACCESS es la hora en milisegundos desde EPOCH. Cuanto mayor seaeste número, más posibilidades habrá de que se almacene en la memoria cachéen el inicio.Si el geocodificador utilizado no puede buscar una dirección en particular, o lascoordenadas obtenidas no son correctas, puede rellenar previamente la tablaGEOCODECACHE en el origen de datos geográficos. Para rellenar previamentela tabla:– Escriba toda la dirección en mayúsculas y elimine todos los espacios iniciales

y finales (incluidos los espacios alrededor de las comas).– Añada los valores de latitud y longitud necesarios en las columnas

correspondientes e incluya los números que desee en las columnas restantes.

Puede mejorar la precisión agregando más abreviaturas a la tabla ABBREVMAP enel origen de datos geográficos. Asegúrese de que todas las entradas están enmayúsculas y de suprimir todos los espacios innecesarios.


Ampliación del soporte de mapas geográficosEsta sección describe cómo crear un geocodificador.

Puede ampliar el soporte de los Mapas geográficos creando su propiogeocodificador. Para crear un geocodificador, debe implementar la interfazcom.cognos.obi.maps.IGeocoder. En Configuración del sistema > Mapasgeográficos de IBM Cognos Real-time Monitoring Workbench, puede especificar elnombre de clase del geocodificador personalizado y rellenar los campos Clave degeocodificador y URL con los valores que necesita el geocodificador. Elgeocodificador puede acceder a estos valores como parámetros mediante ladevolución de llamada init(url,key) que deberá implementar.

Interfaz IGeocoderPuede crear su propio geocodificador implementando la interfaz IGeocoder de Java(com.cognos.obi.maps.IGeocoder).

Para utilizar esta interfaz es necesario implementar dos métodos: init y geocode.

void init(String url, String key)

El método init es una devolución de llamada de inicialización. Se llama después decrear el geocodificador, y se presupone que la clase de geocodificador tendrá unconstructor sin argumentos. Los argumentos representan los parámetros “URL basepara geocodificador” y “Clave de geocodificador” en Valores del sistema paramapas geográficos. Los parámetros de método se definen como sigue:v url

URL de la URL base del geocodificador especificada en los valores del sistemapara Mapas geográficos en la Consola de administración de Real-timeMonitoring Workbench.

v claveClave del geocodificador que se utiliza en los valores del sistema para Mapasgeográficos en la Consola de administración de Real-time MonitoringWorkbench.GeoPoint geocode(String address) throws VCException

El método de código geográfico toma una dirección y devuelve un objetoGeoPoint que representa la latitud y la longitud de la dirección dada. Si no esposible asignar las coordenadas a la dirección, el método de código geográficodebe generar una VCException. Además, los geocodificadores deben serreentrantes; es decir, seguros ante los subprocesos. Para obtener más informaciónsobre el objeto GeoPoint, consulte “Clase GeoPoint” en la página 114.

Puede utilizar el método del geocodificador de la interfaz IGeocoder para devolverlos valores de latitud y longitud de los valores de dimensión que losgeocodificadores predeterminados no pueden manejar. Por ejemplo, tiene unadimensión Sales Territory con tres niveles: World, Country or Region y Local. Estosniveles tienen los valores siguientes:v World: “Asia and Pacific”, “Americas”, “Europe”v Country or Region: “USA and Canada”, “Mexico and Central America”v Local: “New England”, “West Coast”

Puesto que el geocodificador de Google predeterminado no puede reconocervalores como “West Coast” o “USA and Canada” y no puede proporcionar


coordenadas de latitud y longitud para dichos valores, necesitará ungeocodificador personalizado que pueda proporcionar la latitud y la longitudcorrectas para estas direcciones.

Para asegurarse de que las direcciones no son ambiguas, Real-time Monitoringagrega a la dirección todos los niveles de dimensión que tienen una granularidadmás alta. Por ejemplo, “West Coast” puede referirse a la costa oeste de EE.UU. yCanadá o de México y América Central. Por lo tanto, la dirección será “WestCoast,USA and Canada,Americas” para especificar la dirección correctacorrespondiente a la costa oeste de EE.UU. y Canadá. Asimismo, Real-timeMonitoring establece la cadena en letras mayúsculas y elimina los espaciosadicionales para guardar los resultados en la memoria caché con eficiencia. Elgeocodificador debería tomar direcciones como “WESTCOAST,USAANDCANADA,AMERICAS” o “MEXICOANDCENTRALAMERICA,AMERICAS” y devolver la latitud y la longitud correctas para esadirección. Real-time Monitoring también expande las abreviaturas en función de latabla ABBREVMAP. Por ejemplo, las abreviaturas de los estados de California yOregón se expanden de CA y OR a CALIFORNIA y OREGON.

Los niveles de dimensión crean la dirección que proporciona el geocodificador.Puede programar el geocodificador personalizado como desee de manera queproporcione las longitudes y latitudes correctas correspondientes a las direccionesque espera que reciba.

Las direcciones se guardan en la caché en memoria y en la tablaGEOCODECACHE de la memoria caché de la base de datos. Una vez que seconcatena el sistema, coloca el texto en mayúsculas y elimina los espaciossobrantes (canonicalización) y expande las abreviaturas, se devuelve la coordenadageográfica. Si la dirección no está en la caché en memoria, se comprobará lamemoria caché de base de datos y se devolverán las coordenadas en caso de que ladirección exista en la memoria caché de la base de datos. Si la dirección no seencuentra en la caché en memoria ni en la memoria caché de la base de datos, elgeocodificador procesa la dirección y devuelve las coordenadas. La caché enmemoria y la tabla GEOCODECACHE se actualizan con la nueva dirección si eltamaño de la memoria caché es distinto a cero.

Puede hacer que el sistema utilice siempre el geocodificador para devolver lascoordenadas estableciendo el tamaño de la memoria caché en cero. Elestablecimiento del tamaño de la memoria caché en cero da lugar a que todas lassolicitudes pasen por alto las memorias caché. Esto resulta útil para correlacionarlas coordenadas móviles y cuando se depura un geocodificador personalizado.

La memoria caché de base de datos guarda la dirección y las coordenadas en latabla GEOCODECACHE. Sin embargo, estas direcciones solo pueden eliminarsemanualmente. Puede rellenar previamente la tabla con sus propias coordenadas sila dirección que utiliza coincide con la dirección de salida después de laconcatenación, la canonicalización y la expansión de las abreviaturas.

El flujo de trabajo para procesar direcciones y actualizar las memorias caché semuestra en el diagrama siguiente:

Apéndice B. Ajuste de mapas geográficos 113

Tras haber creado el geocodificador personalizado, deberá colocarlo en un archivoJAR y asegurarse de que forma parte de la ruta de clase que Real-time Monitoringutiliza.

Clase GeoPointLa clase GeoPoint contiene información de longitud y latitud. Se devuelve unobjeto GeoPoint del método de geocódigo de la interfaz IGeocoder.

El constructor de GeoPoint esGeoPoint(double latitude, double longitude, int accuracy)

La clase GeoPoint tiene los métodos getterv getLatitude

v getLongitude

v getAccuracy

double getLatitude()

Devuelve una coordenada de latitud en grados como un valor doble.

double getLongitude()

Figura 2. Pasos para procesar direcciones y actualizar las memorias caché


Devuelve una coordenada de longitud en grados como un valor doble.

int getAccuracy()

Indica la precisión de las coordenadas de latitud y longitud. Cuanto mayor sea elvalor devuelto, más precisas serán las coordenadas. Si el valor es 6 o superior, lascoordenadas se consideran como una ubicación exacta.

Apéndice B. Ajuste de mapas geográficos 115


Avisos

Esta información se ha desarrollado para productos y servicios que se ofrecen entodo el mundo.

Es posible que IBM no ofrezca los productos, los servicios o las característicasmencionados en este documento en otros países. Póngase en contacto con elrepresentante local de IBM para obtener información sobre los productos yservicios disponibles actualmente en su zona. Las referencias a productos,programas o servicios de IBM no pretenden afirmar o implicar que sólo puedanutilizarse productos, programas o servicios de IBM. En su lugar, podrá utilizarsecualquier producto, programa o servicio con características equivalentes que noinfrinja ningún derecho de propiedad intelectual de IBM. No obstante, esresponsabilidad del usuario evaluar y verificar el funcionamiento de los productos,programas o servicios que no sean de IBM. Este documento puede incluirdescripciones de productos, servicios o características que no forman parte de latitularidad de licencia o programa que ha adquirido.

Puede que IBM tenga patentes o solicitudes de patentes pendientes relacionadascon los temas principales que se tratan en este documento. La adquisición de estedocumento no le otorga ninguna licencia sobre estas patentes. Puede enviar susconsultas sobre licencias, por escrito, a la dirección siguiente:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785EE.UU.

Para realizar consultas sobre licencias relacionadas con la información de doblebyte (DBCS), póngase en contacto con el Departamento de propiedad intelectual deIBM de su país o envíe sus consultas, por escrito, a la dirección:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.1623-14, Shimotsuruma, Yamato-shiKanagawa 242-8502 Japón

El párrafo siguiente no es aplicable al Reino Unido ni a ningún otro país dondetales disposiciones sean incompatibles con la legislación local: INTERNATIONALBUSINESS MACHINES CORPORATION PROPORCIONA ESTA PUBLICACIÓN"TAL CUAL", SIN GARANTÍA DE NINGUNA CLASE, YA SEA EXPRESA OIMPLÍCITA, INCLUIDAS, PERO SIN LIMITARSE A ELLAS, LAS GARANTÍASIMPLÍCITAS DE NO VULNERACIÓN DE DERECHOS, COMERCIABILIDAD OADECUACIÓN PARA UN FIN DETERMINADO. En algunos estados no estápermitida la renuncia de las garantías expresas o implícitas en determinadastransacciones, por lo tanto, puede que esta declaración no se aplique a su caso.

Esta información podría incluir imprecisiones técnicas o errores tipográficos.Periódicamente se realizan cambios en la información que aquí se presenta; talescambios se incorporarán en nuevas ediciones de la publicación. IBM puede


efectuar, en cualquier momento y sin previo aviso, mejoras y cambios en losproductos y programas descritos en esta publicación.

Las referencias hechas en esta publicación a sitios web que no son de IBM seproporcionan sólo para la comodidad del usuario y no constituyen un aval de esossitios web. La información de esos sitios web no forma parte de la información delpresente producto de IBM y la utilización de esos sitios web se realiza bajo laresponsabilidad del usuario.

IBM puede utilizar o distribuir cualquier información que se le facilite de lamanera que considere adecuada, sin contraer por ello ninguna obligación con elremitente.

Los tenedores de licencias de este programa que deseen obtener información acercade éste con el fin de permitir: (i) el intercambio de información entre programascreados independientemente y otros programas (incluido el presente) y (ii) lautilización mutua de la información que se ha intercambiado, deben ponerse encontacto con:

IBM Software GroupAttention: Licensing3755 Riverside DrOttawa, ON K1V 1B7Canadá

Dicha información puede estar disponible, sujeta a los términos y condicionesapropiados, incluido en algunos casos, el pago de una tarifa.

El programa bajo licencia descrito en este documento y todo el material bajolicencia asociado a él, los proporciona IBM según los términos del IBM CustomerAgreement, del Acuerdo Internacional de Licencia de Programa de IBM o decualquier otro acuerdo equivalente existente entre las partes.

Los datos de rendimiento contenidos en este documento se obtuvieron en unentorno controlado. Por lo tanto, los resultados obtenidos en otros entornosoperativos pueden variar significativamente. Puede que algunas mediciones sehayan obtenido en sistemas de desarrollo y no existe ninguna garantía que permitaafirmar que puedan obtenerse las mismas mediciones en sistemas dedisponibilidad general. Es más, puede que algunas mediciones sean estimacionesobtenidas por extrapolación. Los resultados reales podrían variar. Los usuarios deeste documento deben verificar los datos que se aplican a su entorno específico.

La información referente a productos que no son de IBM se ha obtenido de losproveedores de esos productos, de sus anuncios publicados o de otras fuentesdisponibles públicamente. IBM no ha probado esos productos y no puedeconfirmar la precisión de la información relacionada con el rendimiento, lacompatibilidad ni ningún otro aspecto relacionado con productos que no son deIBM. Las preguntas relacionadas con las prestaciones de los productos que no sonde IBM deben dirigirse a los proveedores de esos productos.

Todas las declaraciones relacionadas con futuras directrices o intenciones de IBMestán sujetas a cambios o a su retirada sin previo aviso y sólo representanobjetivos.

Esta información contiene ejemplos de datos e informes que se utilizan enoperaciones empresariales de uso habitual. Para ilustrarlos de la forma más


completa posible, los ejemplos incluyen nombres de personas, empresas, marcas yproductos. Todos estos nombres son ficticios y cualquier similitud que pudieradarse con nombres y direcciones que utilice una empresa real es pura coincidencia.

Si está viendo esta información en una copia software, es posible que no semuestren las fotografías e ilustraciones en color.

Marcas registradas

IBM, el logotipo de IBM, ibm.com y Cognos son marcas registradas deInternational Business Machines Corp., registradas en varias jurisdicciones de todoel mundo. Otros nombres de productos y servicios pueden ser marcas registradasde IBM o de otras compañías. Hay disponible una lista actual de marcasregistradas de IBM en la sección “ Copyright and trademark information” de laweb www.ibm.com/legal/copytrade.shtml.

Los términos siguientes son marcas registradas de otras compañías:v Adobe, el logotipo de Adobe, PostScript y el logotipo de PostScript son marcas

registradas de Adobe Systems Incorporated en los Estados Unidos o en otrospaíses.

v Microsoft, Windows, Windows NT y el logotipo de Windows son marcasregistradas de Microsoft Corporation en los Estados Unidos o en otros países.

v Linux es una marca registrada de Linus Torvalds en los Estados Unidos o enotros países.

v UNIX es una marca registrada de The Open Group en los Estados Unidos o enotros países.

v Java y todas las marcas registradas y logotipos basados en Java son marcasregistradas de Oracle y/o sus filiales.

Avisos 119

http://www.ibm.com/legal/copytrade.shtml


Índice

Aactualizador

instalar 22actualizar 29

desde Cognos Now! 29Linux en IBM System z 29

agente JDBCJBoss 75WebLogic 59WebSphere 43

agrupación de conexiones JDBC 57incrementar la capacidad en WebLogic 58

ajustemapas geográficos 111

alias JAAS 38Almacén de claves no encontrado 104almacenes de claves 93

mensajes de error 104archivo EAR 29archivo realtime.conf 85

configurar, WebSphere 44archivo realtime.properties

configurar 21archivos de configuración

realtime.conf, WebSphere 44realtime.properties 21

archivos de registros 93archivos JAR 33arquitectura 5asistente de instalación 83asuntos de consulta 93atajos de teclado 109

Bbases de datos 15

componentes 4configuración 15controladores JDBC, JBoss 66controladores JDBC, WebLogic 49controladores JDBC, WebSphere 31desinstalar, JBoss 81desinstalar, WebLogic 63desinstalar, WebSphere 48servidor 5

Ccaracterísticas de accesibilidad 109Clase GeoPoint 114Cognos Now!

actualizar 29comando no válido 105compatibilidad

JaxB y WebSphere 33compatibilidad JaxB

WebSphere 33componentes

nivel de aplicación 3nivel web 3

componentes de nivel de aplicación 3componentes de nivel de web 3conexión de metadatos

JBoss 73WebLogic 56, 57WebSphere 38

configuración de LoadModule 85configurar 3

archivo realtime.conf, WebSphere 44archivo realtime.properties 21conexión de metadatos, JBoss 73conexión de metadatos, WebLogic 56conexión de metadatos, WebSphere 38IBM HTTP Server 85Java Messaging Service 107Microsoft IIS y servidor de aplicaciones JBoss 89Microsoft IIS y WebLogic 87Microsoft IIS y WebSphere 86navegadores web 10Real-time Monitoring tras la instalación 93servidor Apache 85servidor web 83

contenidodinámico 90dinámico, WebSphere 44estático 85, 90

contenido dinámico 90verificar la configuración 90WebSphere 44

contenido estático 3, 85, 90verificar la configuración 90

contraseñacifrar en JBoss 77

controladores JDBC 15JBoss 66WebLogic 49WebSphere 31

cookieshabilitar en navegadores web 10

correo electrónico 93costes

cubos 8flujos de datos 7memoria 7tablas de consulta 7ventanas 9vistas 8

cubos 8

Ddatos de aplicación 4definiciones de modelo 4desinstalar

bases de datos, JBoss 81bases de datos, WebLogic 63bases de datos, WebSphere 48de JBoss 79, 80de WebLogic 61, 62de WebSphere 47


determinación de problemasintercambiar información con el soporte de IBM 101

Eejemplos

cargar, JBoss 78cargar, WebLogic 60cargar, WebSphere 45

entornos soportados 13errores del servidor de aplicaciones 105esquema de datos 5esquema de metadatos 4esquema geográfico 4esquema operativo 4eTrust SiteMinder 90

Ffalta el dominio de red

resolución de problemas 105feeds RSS

resolución de problemas 102fixpack

instalar 22fixpacks

instalar 23, 25flujos de datos 7Framework Manager 93

Ggeocodificador

interfaz 112precisión 111

grupos 95

IIBM Cognos

actualizador 22instalación del paquete de mantenimiento 22

IBM HTTP server 85importar metadatos de ejemplo

JBoss 79WebLogic 61WebSphere 46

indicadores de rendimiento clave 5instalar

archivos de servidor web de Real-time Monitoring 83en JBoss 65, 77en WebLogic 49en WebSphere 31servidor web 83

JJBoss

agente JDBC 75cifrar la contraseña 77conexión de metadatos 73configurar IIS 89definir orígenes de datos 75desinstalar bases de datos 81desinstalar Real-time Monitoring 79, 80

JBoss (continuación)desplegar Real-time Monitoring en 76instalar Real-time Monitoring en 65, 77mejorar el rendimiento de la red 77Nombre JNDI 75orígenes de datos opcionales 75orígenes de datos operativos 75prácticas recomendadas 77probar la instalación de Real-time Monitoring 78registro 76requisitos 65

JNDI 15

LLDAP

consideraciones para la conectividad 95grupos 95valores 95

Linux en IBM System zactualizar 29

Mmapas geográficos

ajuste 111ampliar soporte 112Clase GeoPoint 114geocodificador 112JBoss 75precisión del geocodificador 111WebLogic 58WebSphere 42

memoriaconsideraciones adicionales 9costes 7requisitos 6

mensajes de errorAlmacén de claves no encontrado 104comando no válido 105errores de procesamiento 105errores de seguridad 105No es posible conectarse con la base de datos 104

menússolucionar errores 104

metadatosejemplos, JBoss 78ejemplos, WebLogic 60ejemplos, WebSphere 45importar ejemplos, JBoss 79importar ejemplos, WebLogic 61importar ejemplos, WebSphere 46realizar la copia de seguridad, JBoss 80realizar la copia de seguridad, WebLogic 62realizar la copia de seguridad, WebSphere 47

Microsoft IISy servidor de aplicaciones JBoss 89y WebLogic 87y WebSphere 86

migración tras error activa-pasiva 15modo a prueba de fallos 104modo de consulta dinámica 93


Nnavegador 5navegadores web 5

configurar 10No es posible conectarse con la base de datos 104Nombre JNDI


notas de la versión 2

Oobjeto gráfico geográfico 4objeto gráfico geográfico de Real-time Monitoring 4orígenes de datos

definir, JBoss 75definir, WebLogic 58definir, WebSphere 40, 42mapas geográficos, JBoss 75mapas geográficos, WebLogic 58mapas geográficos, WebSphere 42opcional, JBoss 75opcional, WebLogic 59opcional, WebSphere 43operacional, JBoss 75operacional, WebSphere 43operativo, WebLogic 58

Pparámetros de metadatos


permisos 95planificar

actualizar 29instalar 3migración tras error activa-pasiva 15notas de la versión 2

preparación 13bases de datos 15propiedades de valores del sistema 21valores de registro 18

prerrecuperación 7probar

tras la instalación, JBoss 78tras la instalación, WebLogic 60tras la instalación, WebSphere 45

procesamientomensajes de error 105

programa de desinstalaciónJBoss 80WebLogic 62WebSphere 48

propiedades de valores del sistema 21proveedor de directorios de autenticación 5proveedor JDBC en Websphere 38

RReal-time Monitoring

arquitectura 5componentes 3

Real-time Monitoring (continuación)configuración preliminar en WebSphere 32configurar en Real-time Monitoring Workbench 93configurar tras la instalación 93datos de aplicación 4desinstalar de JBoss 79desinstalar de WebLogic 61desinstalar de WebSphere 47desplegar, JBoss 76desplegar, WebLogic 59desplegar, WebSphere 43ejemplos, JBoss 78ejemplos, WebLogic 60ejemplos, WebSphere 45entornos soportados 13instalar archivos de servidor web 83preparación para la instalación 13requisitos del sistema 13roles 95

Real-time Monitoring Dashboard 4Real-time Monitoring Query Engine 4Real-time Monitoring Workbench 3, 4, 93realizar la copia de seguridad de los metadatos


recuperar y almacenar 4registro, JBoss 76rendimiento 7

JBoss 77requisitos

hardware 13JBoss 65memoria 6sistema 13software 14WebLogic 49WebSphere 31

requisitos de hardware 13requisitos de software 14requisitos del sistema 13resolución de problemas 97

arreglosobtener 100

buscar en bases de datos de conocimientos KnowledgeBase 99

contactar con el soporte de IBM 100falta el dominio de red 105identificar problemas 97intercambiar información con el soporte de IBM 101Knowledge Base

buscar soluciones a problemas 99menús de Dashboard 104obtener arreglos 100suscribirse al soporte 102

roles 95

Sscripts Java

habilitar en navegadores web 10secuencias de comandos ActiveX

habilitar en navegadores web 10seguridad

mensajes de error 105service pack

instalar 22

Índice 123

service packsinstalar 23, 25

servidor Apache 85servidor de aplicaciones 5servidor web

conector 44instalar y configurar 83

SMTP 93soporte de IBM

contactar 100enviar y recibir información 101

suprimir bases de datosJBoss 81WebLogic 63WebSphere 48

suscribirplantillas de resolución de problemas 102

Ttablas de consulta 7teclas de atajo 109

Uusuarios 95

Vvalores 93

JVM, JBoss 68JVM, WebLogic 51JVM, WebSphere 34LDAP 95sistema 93

valores de JVMconfigurar 107JBoss 68WebLogic 51WebSphere 34

valores del navegador Firefox 10valores del navegador Internet Explorer 10ventanas 8versiones de producto 22vistas 7, 93

WWebLogic

agente JDBC 59agrupación de conexiones de metadatos JDBC 57conexión de metadatos 56, 57configurar IIS 87definir orígenes de datos 58desinstalar bases de datos 63desinstalar Real-time Monitoring 61, 62desplegar Real-time Monitoring en 59incrementar la capacidad de la agrupación de conexiones

JDBC 58instalar Real-time Monitoring en 49Nombre JNDI 59orígenes de datos opcionales 59orígenes de datos operativos 58probar la instalación de Real-time Monitoring 60requisitos 49

WebSphereagente JDBC 43conexión de metadatos 38configuración preliminar 32configurar IIS 86definir orígenes de datos 40, 42desinstalar bases de datos 48desinstalar Real-time Monitoring 47desplegar en 43instalar en 31Nombre JNDI 43orígenes de datos opcionales 43orígenes de datos operativos 43probar la instalación de Real-time Monitoring 45proveedor JDBC 38requisitos 31