guía de instalación y configuración para...

IBM Cognos Business IntelligenceVersión 10.2.0

Guía de instalación y configuraciónpara z/OS

��

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

Información sobre el producto

Este documento se aplica a IBM Cognos Business Intelligence Versión 10.2.0 y puede aplicarse también a lasversiones posteriores.

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2011, 2013.

Contenido

Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

Capítulo 1. Novedades . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Características nuevas de la versión 10.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . 1

IBM Cognos Mobile disponible para IBM BI para z/OS . . . . . . . . . . . . . . . . . . . . 1IBM Cognos Workspace instalado con el servidor de IBM BI . . . . . . . . . . . . . . . . . . 1IBM Cognos Connection Installer for Cognos Insight . . . . . . . . . . . . . . . . . . . . . 2Pasarela de IBM Cognos de 64 bits . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Instalación de IBM Cognos Dynamic Cubes . . . . . . . . . . . . . . . . . . . . . . . . 2IBM Cognos Dynamic Query Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . 3Configuraciones del espacio de nombres de autenticación LDAP predefinidas . . . . . . . . . . . . 3Configuración de aplicaciones de arrendamiento múltiple en IBM Cognos Configuration . . . . . . . . . 4Opción para ver el estado de las instalaciones silenciosas en la pantalla . . . . . . . . . . . . . . 4Opción para inicializar Cognos Configuration desde un archivo distinto . . . . . . . . . . . . . . 4Archivado de contenido de IBM Cognos . . . . . . . . . . . . . . . . . . . . . . . . . 5Conectividad JDBC a orígenes de datos y el modo de consulta dinámica . . . . . . . . . . . . . . 5Funciones de búsqueda en índice . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Paneles de control interactivos fusionados con las características de IBM Cognos Viewer . . . . . . . . . 6

Características modificadas en la versión 10.2.0 . . . . . . . . . . . . . . . . . . . . . . . . 6Cambios en la ubicación de instalación predeterminada y en el alias web . . . . . . . . . . . . . . 6Cambios en los FMID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Soporte mejorado para el proveedor de autenticación RACF . . . . . . . . . . . . . . . . . . 7Acceso seguro al supervisar las métricas del sistema externamente . . . . . . . . . . . . . . . . 7

Capítulo 2. Referencia rápida: Lista de comprobación de la instalación . . . . . . . . 9Lista de comprobación previa a la instalación . . . . . . . . . . . . . . . . . . . . . . . . 9Lista de comprobación de la instalación . . . . . . . . . . . . . . . . . . . . . . . . . . 12Lista de comprobación posterior a la instalación . . . . . . . . . . . . . . . . . . . . . . . 12Lista de comprobación de configuración para los componentes de servidor en el sistema z/OS . . . . . . . 14Lista de comprobación de la prueba de los componentes de servidor en el sistema z/OS . . . . . . . . . 17Lista de comprobación de la instalación y la configuración de los componentes de Windows . . . . . . . . 17Lista de comprobación para instalar IBM Cognos Mobile en z/OS en una instancia de IBM Cognos BI existente. . 18

Capítulo 3. Descripción general: Instalaciones de IBM Cognos Business Intelligencefor z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Capítulo 4. Planificación de la instalación de los componentes de servidor de IBMCognos BI en el sistema z/OS. . . . . . . . . . . . . . . . . . . . . . . . . . 21Instalaciones de IBM Cognos Business Intelligence . . . . . . . . . . . . . . . . . . . . . . 21

Componentes de software de la instalación base . . . . . . . . . . . . . . . . . . . . . . 21Componentes de software opcionales . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Planificación de la capacidad para las instalaciones de z/OS . . . . . . . . . . . . . . . . . . . 23Revisión de requisitos de hardware y software para los componentes de z/OS . . . . . . . . . . . . . 24

Valores de memoria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Verificación de versiones de software soportadas y requisitos de hardware . . . . . . . . . . . . . 27

Conjuntos de datos del producto . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Uso de Cognos Content Database como almacén de contenido . . . . . . . . . . . . . . . . . . 29

Capítulo 5. Preparación del sistema z/OS para la instalación . . . . . . . . . . . . 31Cuentas de usuario para la instalación y ejecución del producto . . . . . . . . . . . . . . . . . . 31

Verificación de los valores de cuenta de usuario . . . . . . . . . . . . . . . . . . . . . . 32Valores de variables de entorno en el sistema z/OS . . . . . . . . . . . . . . . . . . . . . . 33

Uso de shells de z/OS UNIX System Services para establecer variables de entorno . . . . . . . . . . 35Utilización de un archivo .tcshrc para establecer las variables de entorno . . . . . . . . . . . . . . 36

© Copyright IBM Corp. 2011, 2013 iii

Editar el archivo .profile para establecer las variables de entorno . . . . . . . . . . . . . . . . 37Verificación de los valores de las variables de entorno . . . . . . . . . . . . . . . . . . . . 38

Directrices para los valores iniciales de los subsistemas DB2 . . . . . . . . . . . . . . . . . . . 39Establecimiento de parámetros de inicialización para z/OS UNIX System Services. . . . . . . . . . . . 41

Capítulo 6. Instalación de componentes de IBM Cognos BI en el sistema z/OS . . . . 45IBM Custom-Build Product Delivery Option . . . . . . . . . . . . . . . . . . . . . . . . 46

IBM Cognos BI for z/OS Program Directory . . . . . . . . . . . . . . . . . . . . . . . 46Sistema de archivos del producto . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Montaje manual del sistema de archivos de destino del servidor de IBM Cognos BI . . . . . . . . . . . 48Archivos de respuestas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

Modificación de un archivo de respuestas . . . . . . . . . . . . . . . . . . . . . . . . 50Ejecución del programa de instalación de IBM Cognos en modo silencioso . . . . . . . . . . . . . 51

Instalación de IBM Cognos Mobile . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Añadir una instalación base para IBM Cognos Mobile . . . . . . . . . . . . . . . . . . . . 53Genere y modifique el archivo de respuestas para IBM Cognos Mobile . . . . . . . . . . . . . . 54Instalar IBM Cognos Mobile en modalidad silenciosa . . . . . . . . . . . . . . . . . . . . 55

Verificación de la instalación de los componentes de servidor de IBM Cognos y los permisos de archivo . . . . 55Adición de componentes de servidor a una instalación existente en el sistema z/OS . . . . . . . . . . . 56Desinstalación de componentes de servidor de IBM Cognos BI en el sistema z/OS . . . . . . . . . . . 56

Capítulo 7. Tareas posteriores a la instalación en z/OS UNIX System Services . . . . . 59Actualización del entorno de Java en el sistema z/OS después de la instalación . . . . . . . . . . . . 59Configuración de un sistema X Windows para el acceso remoto . . . . . . . . . . . . . . . . . . 59

Inicio de IBM Cognos Configuration en z/OS UNIX System Services . . . . . . . . . . . . . . . 60Base de datos del almacén de contenido . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Creación de una base de datos del almacén de contenido en DB2 para z/OS . . . . . . . . . . . . 61Creación de espacios de tabla para un almacén de contenido en DB2 para z/OS . . . . . . . . . . . 62Configuración de la conectividad para la base de datos del almacén de contenido . . . . . . . . . . . 66Verificación de la conectividad JDBC con el almacén de contenido . . . . . . . . . . . . . . . . 67

Base de datos de IBM Cognos Mobile . . . . . . . . . . . . . . . . . . . . . . . . . . 68Creación de espacios de tabla para la base de datos de Cognos Mobile en DB2 para z/OS . . . . . . . . 68

Configuración de la conectividad JDBC para las bases de datos relacionales . . . . . . . . . . . . . . 69IBM Cognos Business Intelligence for z/OS y la Herramienta de Informes de Subcapacidad de IBM. . . . . . 70

Capítulo 8. Configuración de los componentes de IBM Cognos BI en el sistema z/OSdespués de la instalación . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Instalaciones básicas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Cambios de configuración . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Capítulo 9. Consideraciones de configuración para desplegar IBM Cognos BI for z/OSen WebSphere Application Server . . . . . . . . . . . . . . . . . . . . . . . . 75Comunicación web en un entorno de servidor de aplicaciones . . . . . . . . . . . . . . . . . . 77Ajuste del valor de tiempo de espera de conexión predeterminado para IBM Cognos Business Intelligence . . . 78Tareas de configuración en IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . . 78

Creación de los archivos de aplicaciones para desplegarlos en WebSphere Application Server . . . . . . . 78Cambio de las propiedades de configuración del servidor de IBM Cognos . . . . . . . . . . . . . 79Configuración de la conexión a una base de datos del almacén de contenido de DB2 para WebSphereApplication Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Configurar una conexión a la base de datos de IBM Cognos Mobile . . . . . . . . . . . . . . . 81Configuración de una conexión con un servidor de correo para WebSphere Application Server . . . . . . 82Configuración de una pasarela de servlet . . . . . . . . . . . . . . . . . . . . . . . . 82

Creación de una instancia de JVM independiente en IBM WebSphere . . . . . . . . . . . . . . . . 84Establecimiento de variables de entorno para ejecutar IBM Cognos BI en Websphere Application Server . . . . 84

Verificación de los valores de las variables de entorno configurados en WebSphere Application Server . . . . 85Registro de aplicaciones de Cognos Business Intelligence en WebSphere Application Server . . . . . . . . 86Configuración de las propiedades de WebSphere Application Server . . . . . . . . . . . . . . . . 87Conexión con el portal de IBM Cognos BI después del despliegue en WebSphere Application Server . . . . . 88Anulación del registro de asignadores . . . . . . . . . . . . . . . . . . . . . . . . . . 89

iv IBM Cognos Business Intelligence Versión 10.2.0: Guía de instalación y configuración para z/OS

Capítulo 10. Tareas de configuración para desplegar IBM Cognos BI for z/OS en elcontenedor de servlet de Apache Tomcat . . . . . . . . . . . . . . . . . . . . . 91Configuración de IBM HTTP Web Server para ver el contenido estático de IBM Cognos BI . . . . . . . . . 91Configuración de los componentes de servidor de IBM Cognos para que se ejecuten en el contenedor de servletde Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

Configuración de la conexión a una base de datos del almacén de contenido de DB2 para el contenedor deservlet de Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Configurar una conexión a la base de datos de IBM Cognos Mobile . . . . . . . . . . . . . . . 94Configuración de una conexión con un servidor de correo para el contenedor de servlet de Tomcat . . . . . 95Configuración de la conexión a Cognos Content Database . . . . . . . . . . . . . . . . . . . 96Inicio de los servicios de IBM Cognos . . . . . . . . . . . . . . . . . . . . . . . . . 97

Verificación de la instalación y la configuración de servidor de los componentes de servidor en el contenedor deservlet de Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Cambio del despliegue del contenedor de servlet Tomcat a WebSphere Application Server . . . . . . . . . 98Ajuste de los recursos de memoria para el servicio de IBM Cognos. . . . . . . . . . . . . . . . . 99

Capítulo 11. Varias instancias de componentes de servidor . . . . . . . . . . . . 101Configuraciones de Content Manager . . . . . . . . . . . . . . . . . . . . . . . . . . 101

Instancias de Content Manager activas y en espera . . . . . . . . . . . . . . . . . . . . . 102Configuración de la conexión a una base de datos del almacén de contenido de DB2 para cada instancia deContent Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102Configuración de las propiedades de entorno de la instancia de Content Manager activa predeterminada . . 104Configuración de las propiedades de entorno de las instancias de Content Manager en espera . . . . . . 105Inicio de varias instancias de Content Manager . . . . . . . . . . . . . . . . . . . . . . 106

Configuración de las propiedades de entorno de varias instancias de los componentes de nivel de aplicación . . 106Configuración de la pasarela para varias instancias de servidor. . . . . . . . . . . . . . . . . . 107Configuración de varias instancias de los servicios de índice para la búsqueda en índice . . . . . . . . . 108

Capítulo 12. Instalación de componentes de Windows . . . . . . . . . . . . . . . 111Revisión de los requisitos de hardware y software para los componentes de Windows . . . . . . . . . . 111Instalación de Cognos Framework Manager en un sistema Windows . . . . . . . . . . . . . . . . 112

Valores predeterminados para Cognos Framework Manager . . . . . . . . . . . . . . . . . . 113Configuración de Cognos Framework Manager para comunicarse con los componentes de servidor en elsistema z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Prueba de la instalación de Cognos Framework Manager . . . . . . . . . . . . . . . . . . . 114

Instalación de IBM Cognos Cube Designer . . . . . . . . . . . . . . . . . . . . . . . . 115Instalación de Cognos Insight desde Cognos Connection . . . . . . . . . . . . . . . . . . . . 115Instalación del cliente Cognos Transformer en un sistema Windows . . . . . . . . . . . . . . . . 116

Valores predeterminados para el cliente Cognos Transformer . . . . . . . . . . . . . . . . . 117Configuración del cliente Cognos Transformer para que se comunique con los componentes de servidor enz/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118Prueba de la instalación de cliente de Cognos Transformer . . . . . . . . . . . . . . . . . . 119

Instalación de IBM Cognos Software Development Kit en sistemas Cognos Framework Manager . . . . . . 119Instalación de la documentación traducida del producto en los sistemas Windows . . . . . . . . . . . 120Desinstalación de los componentes de Windows. . . . . . . . . . . . . . . . . . . . . . . 121

Capítulo 13. Tareas de configuración opcionales para Framework Manager . . . . . 123Actualización de las propiedades de ubicación de archivo para Cognos Framework Manager en sistemasWindows Vista . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Actualización del archivo de preferencias de ejemplo de Cognos Transformer para sistemas Windows Vista . . . 124Creación de una ubicación de instalación de red para modeladores de Cognos Transformer . . . . . . . . 125

Exportación de los archivos de configuración de IBM Cognos Transformer . . . . . . . . . . . . . 126Despliegue de Cognos Transformer para modeladores . . . . . . . . . . . . . . . . . . . . 127

Capítulo 14. Opciones de configuración y ejemplos para los componentes de servidor 129Creación de espacios de tabla para una base de datos de notificaciones en DB2 para z/OS . . . . . . . . 129Configuración de la instalación de IBM Cognos Dynamic Cubes en el sistema z/OS. . . . . . . . . . . 130Cambio de los valores de configuración predeterminados . . . . . . . . . . . . . . . . . . . 131

Estructura de los valores de URI . . . . . . . . . . . . . . . . . . . . . . . . . . . 131Configuración de la ubicación de salida de informe . . . . . . . . . . . . . . . . . . . . 133

Contenido v

Cambio de ubicación de los gráficos de mapa para IBM Cognos Report Studio . . . . . . . . . . . 134Valores de cookie utilizados por los componentes de IBM Cognos . . . . . . . . . . . . . . . . 135Versiones del protocolo de Internet . . . . . . . . . . . . . . . . . . . . . . . . . . 136Habilitación de la opción IPv6 al iniciar IBM Cognos Configuration . . . . . . . . . . . . . . . 137Creación de otra instancia de Cognos Content Database . . . . . . . . . . . . . . . . . . . 137

Fuentes en informes con formato PDF y HTML . . . . . . . . . . . . . . . . . . . . . . . 139Adición de fuentes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139Especificación de la ubicación de las fuentes disponibles . . . . . . . . . . . . . . . . . . . 140Correlación de fuentes soportadas con fuentes instaladas . . . . . . . . . . . . . . . . . . . 140Cambio de fuentes incluidas para los informes PDF . . . . . . . . . . . . . . . . . . . . 141Cambio de la fuente predeterminada para los informes PDF. . . . . . . . . . . . . . . . . . 142

Valores de seguridad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Configuración de valores criptográficos. . . . . . . . . . . . . . . . . . . . . . . . . 143IBM Cognos Application Firewall . . . . . . . . . . . . . . . . . . . . . . . . . . 143Configuración de los componentes de IBM Cognos para que utilicen IBM Cognos Application Firewall . . . 144Cifrado de las propiedades de archivos temporales . . . . . . . . . . . . . . . . . . . . . 145

Comunicaciones de confianza entre los componentes de IBM Cognos . . . . . . . . . . . . . . . 146Configuración de SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147Paquetes de cifrado para SSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148Configuración de los componentes de IBM Cognos para servidores web habilitados para SSL . . . . . . 149Configuración de la pasarela para utilizar un espacio de nombres . . . . . . . . . . . . . . . . 149

Proceso de configuración para repositorios de mensajes de registro . . . . . . . . . . . . . . . . 150Repositorios de mensajes de registro . . . . . . . . . . . . . . . . . . . . . . . . . 151Directrices para la creación de una base de datos de registro de DB2 para z/OS . . . . . . . . . . . 152Creación de espacios de tabla para una base de datos de registro en DB2 para z/OS . . . . . . . . . 152Configuración de la conectividad con la base de datos de registro . . . . . . . . . . . . . . . . 155

Configuración del archivado de contenido de IBM Cognos . . . . . . . . . . . . . . . . . . . 156Creación de una ubicación de archivo para un repositorio de sistema de archivos . . . . . . . . . . 156Especificación de un tiempo de disponibilidad para la ejecución del proceso de archivado . . . . . . . 157Especificación del tiempo de ejecución de subprocesos . . . . . . . . . . . . . . . . . . . 158Archivado de formatos seleccionados de salidas de informe . . . . . . . . . . . . . . . . . . 159Eliminación de los objetos de versión marcados de la cola . . . . . . . . . . . . . . . . . . 159

Configuración de valores de arrendamiento múltiple . . . . . . . . . . . . . . . . . . . . . 159Identificar información de arrendamiento . . . . . . . . . . . . . . . . . . . . . . . . 160Habilitación del arrendamiento múltiple . . . . . . . . . . . . . . . . . . . . . . . . 162Inhabilitación del arrendamiento múltiple . . . . . . . . . . . . . . . . . . . . . . . . 164

Valores globales para requisitos multiculturales . . . . . . . . . . . . . . . . . . . . . . . 164Correlación de entornos de productos . . . . . . . . . . . . . . . . . . . . . . . . . 165Informes en un idioma preferido . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Correlación de entornos locales del contenido . . . . . . . . . . . . . . . . . . . . . . 167Cambio del huso horario del servidor . . . . . . . . . . . . . . . . . . . . . . . . . 168

Capítulo 15. Requisitos de configuración para los proveedores de autenticación . . . 169Inhabilitación del acceso anónimo . . . . . . . . . . . . . . . . . . . . . . . . . . . 169Restricción del acceso de usuario al espacio de nombres de Cognos . . . . . . . . . . . . . . . . 170Requisitos de configuración para LDAP . . . . . . . . . . . . . . . . . . . . . . . . . 171

Configuración de un espacio de nombres de LDAP utilizando una plantilla . . . . . . . . . . . . 171Correlación de LDAP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Configuración de un espacio de nombres de LDAP. . . . . . . . . . . . . . . . . . . . . 172Configuración de un espacio de nombres de LDAP para un IBM Directory Server . . . . . . . . . . 174Configuración de propiedades de usuario personalizadas para un espacio de nombres de LDAP . . . . . 175Habilitación de la comunicación segura con un servidor LDAP. . . . . . . . . . . . . . . . . 176Inicio de sesión único entre un servidor LDAP y los componentes de IBM Cognos BI . . . . . . . . . 177Operación de sustitución . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178

Requisitos de configuración del proveedor de autenticación personalizado . . . . . . . . . . . . . . 179Configuración de un espacio de nombres para un proveedor de autenticación personalizado . . . . . . . 179

Requisitos de autenticación de RACF . . . . . . . . . . . . . . . . . . . . . . . . . . 180Configuración de un espacio de nombres RACF . . . . . . . . . . . . . . . . . . . . . . 180Habilitación del inicio de sesión único entre RACF y los componentes de IBM Cognos BI . . . . . . . . 181

Supresión de un proveedor de autenticación . . . . . . . . . . . . . . . . . . . . . . . . 182

vi IBM Cognos Business Intelligence Versión 10.2.0: Guía de instalación y configuración para z/OS

Capítulo 16. Configuración de IBM Cognos Workspace . . . . . . . . . . . . . . 183Prueba de IBM Cognos Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . 183Configuración del acceso a IBM Cognos Workspace . . . . . . . . . . . . . . . . . . . . . 183Base de datos de Human Task and Annotation Services . . . . . . . . . . . . . . . . . . . . 184

Creación de una base de datos de Human Task and Annotation en DB2 para z/OS . . . . . . . . . . 184Creación de espacios de tabla para la base de datos de Human Task and Annotation en DB2 en z/OS . . . 185Configurar la base de datos de Human Task and Annotation Services . . . . . . . . . . . . . . 187

Cambio del estilo de los objetos de informe en IBM Cognos Workspace . . . . . . . . . . . . . . . 187

Capítulo 17. Opciones de configuración para el soporte de entidad emisora decertificados de terceros . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189Opciones de línea de comandos para script de certificado de terceros . . . . . . . . . . . . . . . 189

Generación de claves y solicitudes de firma de certificados mediante un script . . . . . . . . . . . 190Configuración de los componentes de IBM Cognos para que utilicen una entidad emisora de certificados externa 191

Capítulo 18. Supervisión del rendimiento . . . . . . . . . . . . . . . . . . . . 193Control del rendimiento mediante el uso de las funciones del gestor de carga de trabajo . . . . . . . . . 193Supervisión de métricas del sistema con JMX. . . . . . . . . . . . . . . . . . . . . . . . 196

Capítulo 19. Mantenimiento del producto . . . . . . . . . . . . . . . . . . . . 199Aplicación de un nivel de servicio a una instalación existente . . . . . . . . . . . . . . . . . . 199Realización de tareas posteriores a la instalación después de aplicar un nuevo nivel de servicio . . . . . . . 200

Apéndice A. Características de accesibilidad. . . . . . . . . . . . . . . . . . . 201Atajos del teclado para el asistente de instalación de IBM Cognos . . . . . . . . . . . . . . . . . 201Atajos del teclado para IBM Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . 201

Apéndice B. Opciones de la línea de comandos IBM Cognos Configuration . . . . . 203

Apéndice C. Ejemplos de IBM Cognos BI . . . . . . . . . . . . . . . . . . . . 205Restauración de los archivos de copia de seguridad de la base de datos de ejemplos . . . . . . . . . . 205Informes de ejemplo para el modo de consulta dinámica . . . . . . . . . . . . . . . . . . . . 207

Modificación de las conexiones de origen de datos según los orígenes de datos de ejemplo . . . . . . . 208Importación del contenido de los ejemplos de consulta dinámica (paquetes) al almacén de contenido . . . . 208

Apéndice D. Resolución de un problema . . . . . . . . . . . . . . . . . . . . 211Recursos para resolver problemas . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

Support Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Recopilación de información . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Solicitudes de servicio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Herramientas de determinación de problemas . . . . . . . . . . . . . . . . . . . . . . 212Centro del cliente de Cognos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Productos y mantenimiento mediante Shop zSeries . . . . . . . . . . . . . . . . . . . . . 213Bases de conocimientos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Archivos de registro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214Archivos de volcado de imagen de memoria . . . . . . . . . . . . . . . . . . . . . . . 216Ejecución de scripts de limpieza de índices y bases de datos . . . . . . . . . . . . . . . . . 216

Mensajes de consola . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217Limitaciones de juego de caracteres para los mensajes en la consola del sistema z/OS . . . . . . . . . 218

Problemas al iniciar el producto . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230Establecimiento de las variables de entorno de JDBC para un almacén de contenido DB2 . . . . . . . . 230El servicio de IBM Cognos BI no se inicia o falla después de iniciarse . . . . . . . . . . . . . . 232No se ha podido iniciar el servicio de IBM Cognos porque otro proceso está utilizando el puerto . . . . . 232Error de Content Manager al iniciar los servicios de IBM Cognos . . . . . . . . . . . . . . . . 233Aparece el error DPR-ERR-2014 en el archivo de registro de la instalación de Content Manager . . . . . . 233IBM Cognos Report Studio no se inicia . . . . . . . . . . . . . . . . . . . . . . . . . 234Aparece el error DPR-ERR-2022 en el navegador web al abrir la página del portal de IBM Cognos . . . . . 234

Problemas al configurar el producto . . . . . . . . . . . . . . . . . . . . . . . . . . . 234Error al intentar cifrar información al guardar la configuración . . . . . . . . . . . . . . . . . 234

Contenido vii

El despliegue de aplicaciones de IBM Cognos BI en IBM WebSphere Application Server falla. . . . . . . 235Problemas al crear una conexión ODBC con un origen de datos DB2 en el sistema z/OS . . . . . . . . . 235El parámetro de subsistema DB2 para z/OS IDLE THREAD TIMEOUT (IDTHTOIN) hace que se agote el tiempode espera de las conexiones del servidor de informes . . . . . . . . . . . . . . . . . . . . . 236Los informes fallan con errores de inicio de sesión y UDA-SQL-0114, UDA-SQL-0107, RQP-DEF-0177 . . . . . 236

Avisos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237

Índice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

viii IBM Cognos Business Intelligence Versión 10.2.0: Guía de instalación y configuración para z/OS

Introducción

Este documento se ha concebido para su utilización con IBM® Cognos BusinessIntelligence for z/OS. La información incluye instrucciones para planificar,preparar, completar y mantener las instalaciones del producto, la configuración delproducto después de la instalación, la configuración de los ejemplos y algunosconsejos y técnicas para la resolución de problemas.

Público

A continuación se indican los conocimientos recomendados necesarios para darsoporte a una configuración básica:v z/OS UNIX System Services (USS)v SMP/E y JCLv SSL (Secure Sockets Layer) para habilitar la seguridad, si lo deseav Acceso para un administrador de bases de datos DB2 que pueda crear la base de

datos del almacén de contenido datos y, si lo desea, la base de datos de ejemplosv Servidor de seguridad (RACF), para autenticar los clientes y los servidores de

IBM Cognos BI for z/OS y para autorizar el acceso a los recursos

Documentación relacionada

Nuestra documentación comprende guías del usuario, guía de introducción, guíasde las características nuevas, notas de la versión y otros materiales para satisfacerlas necesidades de nuestro diverso público.

La documentación está disponible en el Information Center de tareas básicas dez/OS (publib.boulder.ibm.com/infocenter/zos/basics).

Búsqueda de información

La documentación del producto está disponible con el producto, en los InformationCenter y en documentos técnicos.

Para encontrar la documentación de producto más actual, incluyendo toda ladocumentación traducida, acceda al Information Center de IBM Cognos(pic.dhe.ibm.com/infocenter/cbi/v10r2m0).

También puede leer las versiones en formato PDF de los archivos de ayuda enlínea del producto pulsando los enlaces de PDF en la parte superior de cadapágina HTML o acceder a los PDF desde la página web de documentación deproducto IBM Cognos (www.ibm.com/support/docview.wss?uid=swg27024067).

Documentación del producto IBM Cognos Software DevelopmentKit

Después de instalar IBM Cognos Software Development Kit, tendrá a sudisposición la documentación del desarrollador en el propio producto.

Para acceder a la documentación, utilice uno de estos métodos:

© Copyright IBM Corp. 2011, 2013 ix

publib.boulder.ibm.com/infocenter/zos/basics

publib.boulder.ibm.com/infocenter/zos/basics

http://pic.dhe.ibm.com/infocenter/cbi/v10r2m0

https://www.ibm.com/support/docview.wss?uid=swg27024067


v En los sistemas Cognos Framework Manager, en el menú Inicio, pulse en lacarpeta de atajos de la documentación de IBM Cognos.

v En Cognos Administration, pulse Ayuda > Más documentación; enDocumentación del producto podrá abrir los documentos de IBM CognosSoftware Development Kit en formato PDF o HTML.

v En el directorio de idioma de la instalación. Por ejemplo, el directorioubicación_c10/webcontent/documentation/en.

Está disponible la documentación siguiente:

Tabla 1. Documentación de IBM Cognos Software Development Kit

Título del documento Descripción

IBM Cognos Software Development KitDeveloper Guide (dg_sdk.pdf)

Gestión de los procesos de IBM Cognos eimplementación de soluciones de informespersonalizados mediante un conjunto deservicios web, bibliotecas e interfaces deprogramación para cualquier plataformaproporcionado con IBM Cognos SoftwareDevelopment Kit

Framework Manager Developer Guide(dg_fm_sdk.pdf)

Creación y publicación de modelos utilizandola API de Cognos Framework Manager

Mashup Service Developer Guide(dg_cms.pdf)

Desarrollo de aplicaciones con IBM CognosMashup Service que expone salidas de IBMCognos,como informes y análisis, comoservicios web (tanto SOAP como REST)

IBM Cognos Custom AuthenticationProvider Developer Guide (dg_auth.pdf)

Creación de un proveedor de autenticaciónpersonalizado o un proveedor de inicio desesión de confianza mediante la API deproveedor de autenticación personalizado

Características de accesibilidad

Las características de accesibilidad ayudan a los usuarios que tienen unadiscapacidad física, por ejemplo movilidad restringida o visión limitada, a utilizarproductos de tecnología de la información.

El programa de instalación de IBM Cognos e IBM Cognos Configuration disponende características de accesibilidad. Para obtener más información sobre estascaracterísticas, consulte la sección de Apéndice A, “Características deaccesibilidad”, en la página 201 en este documento.

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.

Proyecciones futuras

En esta documentación se describe la funcionalidad actual del producto. Puede quese incluyan referencias a elementos que actualmente no están disponibles. Sinembargo, no deberá deducirse su futura disponibilidad real. Estas referencias noconstituyen un compromiso, promesa ni obligación legal que implique la entregade ningún tipo de material, código o funcionalidad. El desarrollo, entrega ycomercialización de las características o funcionalidad son aspectos que quedan ala entera discreción de IBM.

x IBM Cognos Business Intelligence Versión 10.2.0: Guía de instalación y configuración para z/OS

Declaración de limitación de responsabilidad de los ejemplos

Viaje de aventuras, Ventas de VA, las variaciones del nombre Viaje de aventuras yEjemplo de planificación representan operaciones empresariales ficticias con datosde ejemplo utilizados para desarrollar aplicaciones de ejemplo para IBM y losclientes de IBM. Estos registros ficticios incluyen datos de ejemplo para lastransacciones de ventas, la distribución de productos, la gestión financiera y losrecursos humanos. Cualquier parecido con nombres, direcciones, números decontacto o valores de transacciones reales es pura coincidencia. Otros archivos deejemplo pueden contener datos ficticios generados manual o informáticamente,datos relativos a hechos procedentes de fuentes públicas o académicas, o datosutilizados con el permiso del poseedor del copyright, para utilizarlos como datosde ejemplo para desarrollar las aplicaciones de ejemplo. Los nombres de productosa los que se hace referencia pueden ser marcas registradas de sus respectivospropietarios. Está prohibido realizar cualquier tipo de duplicación no autorizada.

Introducción xi

xii IBM Cognos Business Intelligence Versión 10.2.0: Guía de instalación y configuración para z/OS

Capítulo 1. Novedades

Esta sección contiene una lista de las características nuevas, modificadas, obsoletasy eliminadas que afectan a la instalación y configuración para esta versión. Lepermitirá planificar sus estrategias de actualización y despliegue de aplicaciones,así como las necesidades de formación de sus usuarios.

Para obtener información sobre cómo actualizar, consulte la guía Guía de instalacióny configuración de su producto.

Para obtener información sobre las nuevas características de esta versión, consultela Guía de características nuevas.

Para ver una lista actualizada de los entornos soportados por los productos de IBMCognos, tales como sistemas operativos, parches, navegadores, servidores web,servidores de bases de datos y servidores de aplicaciones, visite el sitio web delcentro del cliente de Cognos (http://www.ibm.com/software/data/cognos/customercenter).

Características nuevas de la versión 10.2.0En los temas siguientes se describen las nuevas características de IBM CognosBusiness Intelligence for z/OS versión 10.2.0.

IBM Cognos Mobile disponible para IBM BI para z/OSIBM Cognos Mobile está disponible para instalarse con IBM Cognos BusinessIntelligence en el sistema operativo z/OS.

IBM Cognos Mobile amplía la instalación de Cognos BI existente para que losusuarios puedan ver informes de IBM Cognos BI en las tabletas o los dispositivossmartphone, incluidos Apple iPhone y Research in Motion BlackBerry, e interactuarcon dichos informes.Conceptos relacionados:“Instalación de IBM Cognos Mobile” en la página 53IBM Cognos Mobile se debe instalar en la misma ubicación que el servidor de IBMCognos Business Intelligence.

IBM Cognos Workspace instalado con el servidor de IBM BIIBM Cognos Workspace se incluye con el servidor de IBM Cognos BusinessIntelligence.

IBM Cognos espacio permite de forma rápida y sencilla ensamblar espacios detrabajo interactivos utilizando contenido de IBM Cognos y orígenes de datosexternos. Después de comprobar que Cognos Workspace se está ejecutando,configure el acceso a las funciones y características protegidas.

© Copyright IBM Corp. 2011, 2013 1

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

Conceptos relacionados:Capítulo 16, “Configuración de IBM Cognos Workspace”, en la página 183IBM Cognos Workspace se instala con el servidor de IBM Cognos BI. Después dela instalación, es necesario realizar ciertas tareas de configuración. También puederealizar tareas de configuración opcionales.

IBM Cognos Connection Installer for Cognos InsightUtilice IBM Cognos Connection Installer for Cognos Insight para instalar softwarede suministro en los servidores de Cognos Business Intelligence. De este modo,varios usuarios podrán instalar Cognos Insight en sus sistemas desde la interfaz deCognos Business Intelligence.

Los usuarios a los que el administrador de Cognos BI ha asignado el rol deEnhanced Consumer pueden instalar Cognos Insight en sus sistemas medianteCognos Connection.

IBM Cognos Insight permite analizar datos, explorar escenarios e influir en lasdecisiones mediante la creación de espacios de trabajo personales o gestionados.Utilice estos espacios de trabajo interactivos para comunicar los resultados a losdirectores. Dado que Cognos Insight soporta la reescritura, también puede utilizarestos espacios de trabajo para recopilar y consolidar objetivos, compromisos yprevisiones de gestión.Tareas relacionadas:“Ejecución del programa de instalación de IBM Cognos en modo silencioso” en lapágina 51Ejecute el instalador de IBM Cognos en modo silencioso. Registre las respuestas alas opciones de instalación en el archivo de respuestas.“Instalación de Cognos Insight desde Cognos Connection” en la página 115Los usuarios finales pueden instalar IBM Cognos Insight en sus sistemas desde lapágina Bienvenido al software de IBM Cognos. Cognos Insight se inicia despuésde que se haya completado la instalación.

Pasarela de IBM Cognos de 64 bitsEn las versiones anteriores, si instalaba versiones de 64 bits de IBM CognosBusiness Intelligence, sólo estaban disponibles las versiones de 32 bits delcomponente de pasarela. En esta versión, también están disponibles las versionesde 64 bits de la pasarela. Puede beneficiarse de las ventajas del hardware de 64 bitsy de las nuevas bibliotecas de 64 bits.

Cuando configura el servidor web para ver contenido estático de IBM Cognos, esnecesario realizar una configuración adicional para poder utilizar las bibliotecas de64 bits.Tareas relacionadas:“Configuración de IBM HTTP Web Server para ver el contenido estático de IBMCognos BI” en la página 91Para ver las páginas web de IBM Cognos BI, configure los directorios virtuales enel servidor web. Para utilizar la versión de 64 bits de la pasarela de IBM CognosBI, utilice un script para copiar los archivos necesarios.

Instalación de IBM Cognos Dynamic CubesIBM Dynamic Cubes son bases de datos optimizadas que proporcionan unrendimiento de las consultas de alta velocidad en conjuntos de metadatos grandespara la creación de informes y análisis de Business Intelligence.

2 IBM Cognos Business Intelligence Versión 10.2.0: Guía de instalación y configuración para z/OS

En IBM Cognos Configuration, habilite la versión de 64 bits del servidor deinformes. Instale el software de IBM Dynamic Cubes Designer en la mismaubicación que Framework Manager.Tareas relacionadas:“Configuración de la instalación de IBM Cognos Dynamic Cubes en el sistemaz/OS” en la página 130Para utilizar IBM Cognos Dynamic Cubes, seleccione la versión de 64 bits para elmodo de ejecución del servidor de informes para los componentes de nivel deaplicación. Instale IBM Cognos Dynamic Query Analyzer en un sistema Windowsy configúrelo para que se comunique con los componentes de servidor de IBMCognos Business Intelligence en el sistema z/OS.“Instalación de IBM Cognos Cube Designer” en la página 115Instale IBM Cognos Cube Designer en la misma ubicación que IBM CognosFramework Manager. IBM Cognos Cube Designer es la aplicación que se utilizapara modelar metadatos dimensionales y cubos dinámicos.

IBM Cognos Dynamic Query AnalyzerIBM Cognos Dynamic Query Analyzer proporciona una interfaz gráfica para losregistros del árbol de ejecución producidos por las consultas de modo de consultadinámica.

DQA permite que un administrador de informes identifique fácilmente todas laspartes individuales de una consulta de modo de consulta dinámica y le permiterealizar la resolución de problemas del rendimiento de la consulta.

Para utilizar DQA, instálelo en el sistema operativo Linux o en un sistemaWindows. A continuación, configure DQA para que se comunique con loscomponentes del servidor de IBM Cognos en el sistema z/OS.Tareas relacionadas:“Configuración de la instalación de IBM Cognos Dynamic Cubes en el sistemaz/OS” en la página 130Para utilizar IBM Cognos Dynamic Cubes, seleccione la versión de 64 bits para elmodo de ejecución del servidor de informes para los componentes de nivel deaplicación. Instale IBM Cognos Dynamic Query Analyzer en un sistema Windowsy configúrelo para que se comunique con los componentes de servidor de IBMCognos Business Intelligence en el sistema z/OS.

Configuraciones del espacio de nombres de autenticaciónLDAP predefinidas

En IBM Cognos Configuration, puede configurar fácilmente un espacio de nombresLDAP para los componentes de IBM Cognos mediante la selección de una plantillapara un proveedor LDAP.

Capítulo 1. Novedades 3

Tareas relacionadas:“Configuración de un espacio de nombres de LDAP utilizando una plantilla” en lapágina 171Para configurar fácilmente un espacio de nombres de LDAP, elija una de unconjunto de plantillas configuradas previamente para cada tipo de proveedor deautenticación LDAP.

Configuración de aplicaciones de arrendamiento múltiple enIBM Cognos Configuration

Puede utilizar nuevas propiedades en IBM Cognos Configuration para configurarentornos de Business Intelligence que den soporte a las aplicaciones dearrendamiento múltiple.

En función del entorno, puede aplicar las propiedades avanzadasmultitenancy.TenantPattern o multitenancy.ITenantProvider a espacios denombres individuales o a todos los espacios de nombres del entorno.Conceptos relacionados:“Configuración de valores de arrendamiento múltiple” en la página 159IBM Cognos Business Intelligence (BI) proporciona prestaciones que facilitan laadministración y protección de las aplicaciones de arrendamiento múltiple.

Opción para ver el estado de las instalaciones silenciosas enla pantalla

Puede utilizar la opción -displayLog para ver el estado de la instalación silenciosaen la pantalla.

Por ejemplo, el siguiente comando ejecuta el programa de instalación en modosilencioso. El programa de instalación utiliza test.ats como archivo de respuestasy muestra el estado de la instalación en la pantalla.

./issetup -s test.ats -displayLog

Tareas relacionadas:“Ejecución del programa de instalación de IBM Cognos en modo silencioso” en lapágina 51Ejecute el instalador de IBM Cognos en modo silencioso. Registre las respuestas alas opciones de instalación en el archivo de respuestas.

Opción para inicializar Cognos Configuration desde unarchivo distinto

Puede utilizar la opción -startupfile ruta/nombrearchivo.xml para especificar unarchivo de arranque distinto del archivo cogstartup.xml al iniciar la herramientade configuración de IBM Cognos.

El archivo cogstartup.xml todavía debe existir en el directorio de configuración.

Por ejemplo, el comando siguiente ejecuta el programa de instalación en modosilencioso utilizando el archivo test.xml que se encuentra en el directorio deconfiguración para establecer los parámetros de configuración.

cogconfig.sh -s -startupfile <ubicación_c10>/configuration/test.xml


Conceptos relacionados:Apéndice B, “Opciones de la línea de comandos IBM Cognos Configuration”, en lapágina 203Utilice las opciones de línea de comandos con el comando de configuración paramodificar el comportamiento de IBM Cognos Configuration cuando se inicie.

Archivado de contenido de IBM CognosUtilice el archivado de contenido de IBM Cognos para almacenar versiones desalida de informe y sus especificaciones de informe de origen en un repositorio dearchivado de contenido externo.Conceptos relacionados:“Configuración del archivado de contenido de IBM Cognos” en la página 156Para mejorar el rendimiento del sistema y aumentar la escalabilidad, utilice elarchivado de contenido de IBM Cognos para almacenar versiones de salida deinforme y sus especificaciones de informe de origen en el sistema de archivos.Archivar disminuye el tamaño de la base de datos del almacén de contenido.

Conectividad JDBC a orígenes de datos y el modo deconsulta dinámica

Puede conectarse a orígenes de datos soportados utilizando la conectividad JavaDatabase Connectivity (JDBC). Cuando se utiliza la conectividad JDBC, el modo deconsulta dinámica está disponible y optimiza las consultas y mejora el rendimiento.

Para poder utilizar el modo de consulta dinámica, es necesario realizar ciertastareas de configuración.Tareas relacionadas:“Configuración de la conectividad JDBC para las bases de datos relacionales” en lapágina 69En IBM Cognos Business Intelligence en z/OS, debe utilizar el modo de consultadinámica para conectarse con las bases de datos relacionales. Instale loscontroladores JDBC de tipo 4 en cada ubicación en la que haya instalado loscomponentes de nivel de aplicación. También puede modificar un archivo deconfiguración para señalar los archivos de controlador JDBC.

Funciones de búsqueda en índiceAhora, la función de búsqueda en índice es el modo de búsqueda predeterminadoen el producto de servidor de IBM Cognos Business Intelligence. Sin embargo, esnecesario realizar ciertas tareas de configuración para habilitar los servicios deíndice y para configurar la escalabilidad. Debe crear el índice antes de utilizar lafunción de búsqueda en índice.

Para obtener información sobre la creación del índice y la configuración de lospermisos de usuario para la búsqueda en índice, consulte la publicación Guía deadministración y seguridad.


Tareas relacionadas:“Configuración de varias instancias de los servicios de índice para la búsqueda eníndice” en la página 108En un entorno con un gran volumen de solicitudes de informes, puede instalarvarias instancias de los componentes de nivel de aplicación. Puede configurarvarias instancias de los servicios de índice para la búsqueda en índice.

Paneles de control interactivos fusionados con lascaracterísticas de IBM Cognos Viewer

Dispondrá de un panel de control interactivo cuando instale el servidor de CognosBusiness Intelligence.

El panel de control y las características de IBM Cognos Viewer se han fusionado enuna única interfaz de usuario.

Características modificadas en la versión 10.2.0En los temas siguientes se describen los cambios en las características respecto a laversión anterior.

Cambios en la ubicación de instalación predeterminada y enel alias web

Los cambios en la ubicación de instalación y en el alias web podrían afectar a lasestrategias de actualización.

La ubicación de instalación predeterminada está representada por ubicación_c10.

En el caso de los componentes instalados en sistemas Windows, la ubicaciónpredeterminada es C:\Archivos de programa\IBM\cognos\c10.

En el caso de los componentes de servidor instalados en UNIX System Services, laubicación predeterminada en la que se instalará el producto después de ejecutar elprograma de instalación es /prefijoruta/usr/lpp/cognos/HCGCA20/IBM.

El alias web predeterminado en IBM Cognos Configuration ha pasado de cognos8a ibmcognos.

Cambios en los FMIDSe utiliza un FMID para instalar los componentes de software de IBM CognosBusiness Intelligence for z/OS.

El programa de utilidad SMP/E se utiliza para instalar software y realizar elmantenimiento de éste en el sistema z/OS.

Durante la primera parte del proceso de instalación, el programa de utilidadSMP/E se utiliza para instalar el producto en el sistema de z/OS UNIX SystemServices.

Hay seis kits de instalación incluidos en un Functional Modifier Identifier (FMID).Instale el FMID HCGCA20 mediante el programa de utilidad SMP/E.


Conceptos relacionados:Capítulo 6, “Instalación de componentes de IBM Cognos BI en el sistema z/OS”,en la página 45Una instalación completa en el sistema z/OS requiere dos programas diferentes.Utilice el programa de instalación SMP/E (System Modification ProgramExtended) para instalar los componentes de servidor de IBM Cognos BusinessIntelligence en el sistema z/OS. A continuación, utilice el instalador de IBMCognos para finalizar la instalación de los componentes en las ubicaciones en lasque se ejecutarán.

Soporte mejorado para el proveedor de autenticación RACFEn las versiones anteriores, si se quería utilizar un proveedor Resource AccessControl Facility (RACF) para la autenticación, se creaba un espacio de nombres deproveedor Java™ personalizado. En el servidor de IBM Cognos BI, versión 10.2.0,puede configurar un espacio de nombres RACF directamente en IBM CognosConfiguration.Tareas relacionadas:“Configuración de un espacio de nombres RACF” en la página 180Utilice IBM Cognos Configuration para configurar un espacio de nombres RACF(Resource Access Control Facility) para la autenticación.

Acceso seguro al supervisar las métricas del sistemaexternamente

En las versiones anteriores, se podían supervisar las métricas del sistemaexternamente mediante Java Management Extensions (JMX). Ahora IBM CognosConfiguration proporciona dos propiedades nuevas que se pueden utilizar paraproteger el acceso a las métricas en el entorno Java.Tareas relacionadas:“Supervisión de métricas del sistema con JMX” en la página 196Puede supervisar las métricas del sistema fuera de IBM Cognos Administrationmediante el uso de la tecnología Java Management Extensions (JMX) estándar delsector.


Capítulo 2. Referencia rápida: Lista de comprobación de lainstalación

Utilice la lista de comprobación de la instalación como referencia rápida para lastareas de instalación necesarias.

Lista de comprobación previa a la instalaciónAntes de instalar el producto, planifique la infraestructura y prepare el sistemaz/OS:__ v Planifique la arquitectura de la instalación.

Para saber cuáles son los componentes base y las funciones opcionales, asícomo para determinar dónde instalarlos, consulte: “Instalaciones de IBMCognos Business Intelligence” en la página 21.

__ v Revise los requisitos mínimos de hardware.

Tabla 2. Requisitos mínimos de hardware para los componentes de servidor de IBMCognos BI

Requisito Especificación

Sistema operativo z/OS

z/OS UNIX System Services (z/OS UNIX) con un sistema dearchivos HFS o ZFS)

Número deprocesadores centrales

Mínimo: 2

Espacio de disco Consulte la publicación Program Directory para ver los requisitosde espacio de disco

Asigne suficiente espacio de disco para los directorios de losarchivos de instalación, temporales y de registro. Puesto que losdirectorios bajo el directorio de instalación principal puedenmontarse en diferentes volúmenes, asegúrese de que cadadirectorio montado tiene suficiente espacio de disco libre.

Asigne un 20% de espacio de disco adicional para permitir elcrecimiento de los archivos temporales y de registro.

Asigne suficiente espacio de disco para el directorio del perfil deWebSphere Application Server. El directorio debe tener unacapacidad de 500 MB como mínimo para el despliegue de losarchivos de contenido web de IBM Cognos.

__ v Revise los requisitos de software obligatorios.

Tabla 3. Requisitos de software obligatorio para los componentes de servidor de IBMCognos BI


Java RuntimeEnvironment (JRE)

Si utiliza WebSphere Application Server, utilice el JRE que seinstala junto con dicho producto, si está soportado en IBMCognos.


Tabla 3. Requisitos de software obligatorio para los componentes de servidor de IBMCognos BI (continuación)


Navegador web Para todos los navegadores web soportados, lo siguiente estáhabilitado:

v cookies

v JavaScript

Base de datos (almacénde contenido)

Debe tener una de las siguientes bases de datos disponible paraalmacenar los datos de IBM Cognos:

v IBM DB2 para z/OS

La base de datos debe estar configurada para utilizar un juegode caracteres Unicode.

v Cognos Content Database

Cognos Content Database está disponible con el producto, pero nose instala automáticamente durante la personalización a menosque se especifique en el archivo response.ats.

__ v Revise los requisitos de software opcionales.

Tabla 4. Requisitos de software opcional


Servidor web IBM HTTP Server

Servidor deaplicaciones

WebSphere Application Server (requiere el despliegue de unsirviente de 64 bits)

Base de datos(consulta)

IBM DB2 para z/OS

La base de datos de consulta debe estar instalada en el mismosysplex que el servidor de IBM Cognos BI. Es necesario realizartareas de configuración adicionales de DB2 si la base de datos deconsulta se encuentra en una LPAR distinta de la del servidor deIBM Cognos BI (componentes de nivel de aplicación).

Base de datos(ejemplos del productoIBM Cognos)

IBM DB2 para z/OS

Compatibilidad conLDAP versión 3

IBM Tivoli Directory Server

De forma predeterminada, IBM Cognos BI for z/OS se instala conel acceso anónimo habilitado.

Servidor de correo Necesario para las notificaciones.

Debe ser accesible a través de un cortafuegos.

La administración del sistema de z/OS debe configurar elcortafuegos para permitir el tráfico SMTP entre el servidor de IBMCognos BI y el servidor de correo que se utiliza para lasnotificaciones.

__ v Cree una cuenta de usuario de la instalación.Asegúrese de que la cuenta de usuario tiene permisos de acceso completopara la instalación de IBM Cognos Business Intelligence. Si utiliza WebSphereApplication Server, este grupo debe incluir el usuario que inicia el servidor deaplicaciones y el usuario propietario de los archivos de IBM BI.


Para que sea más fácil, también puede utilizar la cuenta de usuario delservidor de aplicaciones para instalar y ejecutar los componentes de IBMCognos.

Tabla 5. Resumen y descripción de las cuentas de usuario

Cuenta de usuario Descripción

Cuenta de usuario delinstalador para IBMCognos

Esta cuenta es propietaria de los archivos de instalación de IBMCognos.

Cuenta de usuario queejecuta IBM Cognos BIpara z/OS

Esta cuenta debe tener otorgado el privilegio para ejecutarprogramas que utilizan el plan DSNACLI.

Cuenta de usuario queejecutará el servidorde aplicaciones

El usuario que inicia el servidor de aplicaciones y el usuariopropietario de los archivos de IBM Cognos deben pertenecer almismo grupo.

__ v Establezca las variables de entorno en el sistema z/OS.

Tabla 6. Lista de variables de entorno previas a la instalación para IBM Cognos BI for z/OS

Variable de entorno Valores o ejemplos Descripción

_BPXK_AUTOCVT ON Esta variable de entornode tiempo de ejecucióndebe establecerse en ONpara convertirautomáticamente aEBCDIC los archivoscon codificación ASCII amedida que el instaladorde IBM Cognos lee losarchivos.

_CEE_RUNOPTS POSIX(ON), FILETAG(AUTOCVT,AUTOTAG)

Establezca esta variablepara el instalador deIBM Cognos que creaarchivos que deben estarcorrectamenteetiquetados.

JAVA_HOME ${WASHOME}/java64 Apunta a la ubicaciónde instalación de JavaRuntime Environment(JRE).

Por ejemplo, si estáutilizando WebSphereApplication Server,establezca la variable deentorno JAVA_HOMEpara utilizar la JVM quese proporciona conWebSphere ApplicationServer.

PATH $JAVA_HOME/bin

LIBPATH /usr/lib:${LIBPATH} El instalador de IBMCognos requiere elarchivo Xm_31dll.

Capítulo 2. Referencia rápida: Lista de comprobación de la instalación 11

Tabla 6. Lista de variables de entorno previas a la instalación para IBM Cognos BI forz/OS (continuación)


Conectividad JDBC

v JDBCHOME

v JDBCCLASSES

v CLASSPATH

Variables JDBC

v ${DB2HOME}/db2910_jdbc

v ${JDBCHOME)/classes

v $CLASSPATH: ${JDBCCLASSES}/db2jcc_javax.jar

v $CLASSPATH: ${JDBCCLASSES}/db2jcc4.jar

v $CLASSPATH: ${JDBCCLASSES}/db2jcc_license_cisuz.jar

v $CLASSPATH: ${JDBCCLASSES}/sqlj4.zip

Establezca estasvariables de entornopara habilitar laconectividad JDBC conel almacén de contenidoDB2.

Si procede, establézcalasen la región de sirvienteen la consolaadministrativa deWebSphere.

Conectividad ODBC

v DSNAOINI

v STEPLIB

Variables ODBC

v /u/user1/db2odbc/odbciniv prefix.SDSNEXIT:

prefix.SDSNLOAD:prefix.SDSNLOD2

Nota: Continuación de líneacorrespondiente a este valor.

Establezca las variablesde entorno de ODBCpara permitir al sistemautilizar el procesador delínea de comandos deDB2 y para especificar laubicación del archivo deinicialización de ODBCde DB2.


__ v Verifique los valores de cuenta de usuario y verifique los valores de lasvariables de entorno.

Lista de comprobación de la instalaciónPuede instalar los componentes de servidor en el sistema z/OS y los componentesde modelado en los sistemas Microsoft Windows. Puede instalar los componentesopcionales en ambos sistemas:__ v Localice el directorio del programa.__ v Utilice el programa de instalación de SMP/E para instalar los componentes

base y opcionales en el sistema z/OS.__ v Modifique el archivo /pathprefix/usr/lpp/ibm/cognos/BI_installer_10.2.1/

response.ats para registrar sus opciones de instalación.__ v Utilice el programa de instalación de IBM Cognos para completar la

instalación ejecutando el comando ./issetup -s location/response.ats.__ v Verifique la instalación de los componentes de z/OS y el archivo de permisos.

Lista de comprobación posterior a la instalaciónConfigure el entorno después de la instalación y antes de configurar loscomponentes del producto:


Creación de espacios de tabla de DB2 para las bases de datosdel almacén de contenido__ v Si utiliza DB2 en z/OS para la base de datos del almacén de contenido, cree

un almacén de contenido en DB2 para z/OS. La base de datos debe tener unaagrupación de búferes con un tamaño de página de 32 KB y otra con untamaño de página de 16 KB para la instancia de la base de datos.

__ v En el caso de un almacén de contenido de DB2, cree espacios de tabla paraun almacén de contenido de DB2 en el sistema z/OS ejecutando el scriptubicación_c10/configuration/schemas/content/db2zOS/tablespace_db2zOS.sql y la tabla siguiente, que le ayudará a reemplazar losparámetros genéricos por los apropiados para su entorno.

Tabla 7. Nombres de parámetros y descripción para el script de espacios de tabla dealmacén de contenido

Nombre del parámetro Descripción

CMSCRIPT_STOGROUP Especifica el nombre del grupo de almacenamiento.

CMSCRIPT_DATABASE Especifica el nombre de la base de datos del almacénde contenido.

CMSCRIPT_CS_ID Especifica la identificación del subsistemacorrespondiente a la base de datos del almacén decontenido.

El identificador no debe tener más de dos caracteres.

CMSCRIPT_TABLESPACE Especifica el nombre del espacio de tabla quecontiene todas las tablas base en el almacén decontenido.

No se incluyen las tablas auxiliares.

El nombre no puede tener más de 6 caracteres.

CMSCRIPT_LARGE_BP Especifica el nombre de la agrupación de búferes másgrande asignada para objetos especialmente grandes.

Esta es la agrupación de búferes de 32 KB que se creócuando el administrador de base de datos creó la basede datos del almacén de contenido en el sistemaz/OS.

CMSCRIPT_REGULAR_BP Especifica el nombre de la agrupación de búferes detamaño normal asignada para los objetos normales ygrandes.


CMSCRIPT_USERNAME Especifica la cuenta de usuario que accede a la basede datos del almacén de contenido.

__ v Edite y después ejecute el archivo de script ubicación_c10/configuration/schemas/content/db2zOS/rightsGrant_db2zOS.sql sustituyendo losparámetros genéricos por los apropiados para su entorno.

__ v Edite y después ejecute el archivo de scriptubicación_c10/configuration/schemas/delivery/zosdb2/NC_TABLESPACES.sql sustituyendo los parámetrosgenéricos por los apropiados para su entorno.


Tabla 8. Nombres y descripciones de parámetros de espacios de tabla para una base dedatos de notificaciones DB2 en z/OS


NCCOG Especifica el nombre de la base de datos denotificaciones.

DSN8G810 Especifica el nombre del grupo dealmacenamiento.

BP32K Especifica el nombre de la agrupación debúferes.

__ v Edite y después ejecute el archivo de scriptubicación_c10/configuration/schemas/hts/zosdb2/HTS_tablespaces.sql sustituyendo los parámetrosgenéricos por los apropiados para su entorno.

Tabla 9. Nombres y descripciones de parámetros de espacios de tabla para tareashumanas en DB2 para z/OS


NCCOG Especifica el nombre de la base de datos.


BP32K Especifica el nombre de la agrupación debúferes de 32 k.

__ v Edite y, a continuación, ejecute el archivo de script HTS2_CREATE_Db2zos.sql.__ v Edite y, a continuación, ejecute el archivo de script ubicación_c10/

configuration/schemas/ans/zosdb2/ANN_TABLESPACES.sql.__ v Edite y, a continuación, ejecute el archivo de script ANS2_CREATE_Db2zos.sql.__ v En el caso de un almacén de contenido de DB2, copie o cree un enlace

simbólico para el controlador JDBC y los archivos de licencia de la instalaciónde DB2 en la instalación de IBM Cognos BI.

__ v Verifique la conectividad JDBC con el almacén de contenido.

Configuración de conexiones JDBC con los orígenes de datos__ v “Configuración de la conectividad JDBC para las bases de datos relacionales”

en la página 69.__ v En IBM Cognos Administration, cree conexiones a orígenes de datos.__ v En IBM Cognos Administration, administre Query Service.__ v En IBM Cognos Framework Manager, habilite que los paquetes utilicen el

modo de consulta dinámica y que, a continuación, se publiquen.__ v Utilice IBM Cognos Dynamic Query Analyzer para visualizar una

representación gráfica de las consultas generadas cuando se ejecuta uninforme y para solucionar problemas de las consultas.

Lista de comprobación de configuración para los componentes deservidor en el sistema z/OS

Complete las tareas de configuración obligatorias antes de personalizar lainstalación del producto para que se ajuste mejor a su entorno.__ v Configure un sistema X Windows para el acceso remoto.


Establezca la variable de entorno siguiente en z/OS: exportDISPLAY=nombre_host:número_pantalla. Nombre_host es la dirección IP delsistema que mostrará la interfaz gráfica de usuario.

__ v Inicie Cognos Configuration.Vaya al directorio ubicación_c10/bin64 y escriba el comando siguiente:./cogconfig.sh

__ v Configure la conexión con una base de datos del almacén de contenido deDB2.En el panel Explorador, en Acceso a datos, Content Manager, pulse Almacénde contenido y establezca las propiedades.En el panel Explorador, pulse Configuración local y añada las Propiedadesavanzadas siguientes:

Tabla 10. Nombres y valores de los parámetros

Nombre del parámetro Valor (ejemplos)

CMSCRIPT_CREATE_IN COGUCST1.T1TSCS

CMSCRIPT_STOGROUP DBOIUSR

CMSCRIPT_DATABASE COGUCS

CMSCRIPT_CS_ID T1

CMSCRIPT_TABLESPACE TSCS

CMSCRIPT_LARGE_BP BP32K

CMSCRIPT_REGULAR_BP BP16K0

__ v Configure las propiedades del entorno.En el panel Explorador, pulse Entorno. En el panel Propiedades, cambie laparte de localhost de todas las propiedades de URI por el nombre de host ola dirección IP del servidor de IBM Cognos BI.

__ v Configure una conexión con un servidor de correo (para evitar avisos en IBMCognos Configuration).En el panel Explorador, en Acceso a datos, pulse Notificación. En el panelPropiedades, en la propiedad del servidor de correo SMTP, escriba el nombrede host y el puerto del servidor de correo SMTP (saliente).

Configuración de WebSphere Application Server__ v Configurar componentes de servidor IBM Cognos en IBM Cognos

Configuration.__ v Cree una única instancia sirviente de 64 bits para la aplicación IBM Cognos BI

for z/OS.__ v En la consola administrativa de WebSphere establezca las variables de entorno

para ejecutar IBM Cognos BI en WebSphere Application Server.

Tabla 11. Variables de entorno para IBM Cognos Business Intelligence for z/OS

Variable de entorno Valor

_BPX_JOBNAME CGC

_BPXK_AUTOCVT ON

_CEE_RUNOPTS POSIX(ON),FILETAG(AUTOCVT,AUTOTAG),HEAPPOOLS(ALIGN),HEAPPOOLS64(ALIGN)

Nota: Continuación de línea correspondiente a estevalor.


Tabla 11. Variables de entorno para IBM Cognos Business Intelligence forz/OS (continuación)


STEPLIB prefix.SDSNEXIT:prefix.SDSNLOAD:prefix.SDSNLOD2

DSNAOINI /u/user1/db2odbc/odbcini

Especifica un archivo de inicialización de ODBCpara el subsistema de ODBC (DSN) y el plan(DSNACLI).

IBM_JAVA_ENABLE_ASCII_FILETAG Se establece en ON porque z/OS utiliza lacodificación de caracteres EBCDIC y las aplicacionesJava de IBM Cognos BI utilizan la codificaciónASCII.

LIBPATH ubicación_c10/bin64 :ubicación_c10/bin:/bin

Incluya el directorio /bin para asegurarse de que losalmacenes de claves se codifican correctamente alinicio.

PATH ubicación_c10/bin64 :ubicación_c10/bin:/bin


__ v Configure WebSphere Application Server.__ v Instale una nueva aplicación de empresa mediante el archivo de aplicación

creado por IBM Cognos Configuration (la raíz de contexto predeterminada esp2pd).

__ v Establezca las propiedades siguientes:

Tabla 12. Valores de los parámetros

Parámetro Valor

Tamaño de montón de JVM Superior a 256 MB

(-Xms) 756 MB

(-Xmx) 756 MB

En la administración deWebSphere, en Entorno >Variables de WebSphere

Cree los dos pares de nombre-valor de WebSpheresiguientes

v name=protocol_http_timeout_output_recovery

value=session

v name=protocol_https_timeout_output_recovery

value=session

__ v Establezca en 1 el número mínimo de instancias y el número máximo deinstancias para las instancias del servidor de IBM Cognos.

__ v Detenga y luego reinicie la instancia del servidor de aplicaciones WebSphereutilizada para los componentes de IBM Cognos BI.


Lista de comprobación de la prueba de los componentes de servidoren el sistema z/OS

Verifique la instalación y la configuración de los componentes de servidor de IBMCognos BI probando la instalación y la configuración:__ v Utilice la característica de prueba en IBM Cognos Configuration cuando

configure los componentes para asegurarse de que la configuración es válida.__ v Compruebe si el almacén de contenido se ha creado satisfactoriamente y si

Content Manager se ha iniciado abriendo un navegador web y escribiendohttp://nombre_host:puerto/p2pd/servlet.

__ v Compruebe la disponibilidad del asignador de un navegador web yescribiendo http://nombre_host:puerto/p2pd/servlet/dispatch.

__ v Conéctese al portal de IBM Cognos abriendo un navegador web y escribiendohttp://nombre_host:puerto/ibmcognos si utiliza una pasarela CGI, ohttp://nombre_host:puerto/raíz_contexto/servlet/Gateway si utiliza unapasarela de servlet.

Lista de comprobación de la instalación y la configuración de loscomponentes de Windows

Para poder crear informes, debe instalar Cognos Framework Manager y utilizarlopara modelar y empaquetar los datos:__ v Revise los requisitos de hardware y software para los componentes de

Windows.

Tabla 13. Requisitos del sistema para Cognos Framework Manager


Sistema operativo (32 bits) Windows

Espacio de disco Mínimo: 500 MB de espacio libre en launidad que contiene el directorio temporalutilizado por los componentes de IBMCognos Business Intelligence

Base de datos Si es necesario, software de cliente de basede datos instalado en el mismo sistema queCognos Framework Manager

Conectividad de base de datos configurada

__ v Utilice el asistente de instalación para instalar Cognos Framework Manageren un sistema Windows.

__ v Configure Cognos Framework Manager para comunicarse con loscomponentes de servidor en el sistema z/OS.Utilice IBM Cognos Configuration para configurar el URI de pasarela y elURI de asignador para aplicaciones externas con el fin de asegurarse de queCognos Framework Manager puede comunicarse con los componentes deservidor de IBM Cognos BI.

__ v Pruebe la instalación de Cognos Framework Manager; para ello, inicie IBMCognos Framework Manager desde el menú de atajo de Windows.Si ve la página de bienvenida de Cognos Framework Manager, su instalaciónfunciona.


Lista de comprobación para instalar IBM Cognos Mobile en z/OS enuna instancia de IBM Cognos BI existente

Instale IBM Cognos Mobile sobre una instalación existente de IBM Cognos BI.

Utilice los pasos siguientes para instalar IBM Cognos Mobile en z/OS en unainstancia de IBM Cognos BI existente:__ v Detenga los servicios de IBM Cognos BI.__ v Edite el archivo uninst.ini en el directorio de instalación de IBM Cognos BI

para añadir un valor de instalación base para IBM Cognos Mobile.__ v Edite el archivo de respuestas para habilitar los componentes de IBM Cognos

Mobile para la instalación.__ v Instale IBM Cognos Mobile en la misma ubicación que los componentes de

servidor de IBM Cognos BI.__ v Ejecute scripts para crear los espacios de tabla para IBM Cognos Mobile en la

base de datos del almacén de contenido.__ v Añada la base de datos de dispositivo móvil como un recurso para IBM

Cognos Mobile en IBM Cognos Configuration. Si está utilizando la base dedatos del almacén de contenido, debe añadir dicha base de datos como basede datos de dispositivo móvil.

__ v Reinicie los servicios.Si está utilizando IBM WebSphere Application Server, debe generar un nuevoarchivo EAR y volver a desplegar la aplicación IBM Cognos BI.


Capítulo 3. Descripción general: Instalaciones de IBM CognosBusiness Intelligence for z/OS

Siga estos accesos directos para poner en marcha una instalación básica de IBMCognos Business Intelligence for z/OS.

Procedimiento1. Planifique la instalación de los componentes de servidor en el sistema z/OS.

a. Asegúrese de que cumple los requisitos mínimos de hardware y softwarecorrespondientes a los sistemas de destino y de distribución.

b. Cree cuentas de usuario para la instalación y ejecución del producto.c. Establezca las variables de entorno.

2. Instale los componentes necesarios, lo que incluye la instalación de loscomponentes de servidor en el sistema z/OS y la instalación de CognosFramework Manager en un sistema Windows.Una instalación básica incluye los componentes necesarios que deben instalarseantes de que el sistema IBM Cognos BI for z/OS esté operativo. Loscomponentes necesarios son: una pasarela, componentes de nivel de aplicación,Content Manager y Cognos Framework Manager. Otros componentesopcionales, como ejemplos y Cognos Transformer, se pueden añadir cuando serealiza la instalación o posteriormente, después de que la instalación básica estéen marcha.a. Utilice SMP/E para instalar los componentes en el sistema z/OS UNIX.b. Utilice el instalador y los archivos de respuestas de IBM Cognos para

completar la instalación de los componentes de IBM Cognos BI for z/OS.3. Para que exista comunicación entre los componentes de IBM Cognos y otro

software, se requieren algunas tareas posteriores a la instalación en el sistemaz/OS.Después de la instalación y antes de la configuración, debe establecer lacomunicación entre los recursos de su entorno y los componentes de servidorde IBM Cognos BI en z/OS.

4. Configure una instalación básica para que el producto se ejecute.Se requieren muy pocas tareas de configuración para ejecutar una instalaciónbásica de los componentes de IBM Cognos. IBM Cognos debe tener acceso a labase de datos del almacén de contenido. Otras tareas comunes adicionalesincluyen la habilitación de la seguridad y la configuración de una cuenta deservidor de correo.Utilice la interfaz gráfica de usuario de IBM Cognos Configuration paraconfigurar de forma interactiva los componentes de IBM Cognos. Puesto queesto requiere una rutina de pantalla gráfica de servidor X, debe tener lasbibliotecas X instaladas en el sistema z/OS. Debe poder conectarse a unservidor X, un PC o un sistema UNIX que ejecute el software de servidor X. (Elservidor X es el cliente y el cliente X es el servidor z/OS.)IBM Cognos Configuration es una aplicación Java que se utiliza para configurarambos componentes de servidor en el sistema z/OS y el componente demodelado en sistemas Windows.

5. Pruebe la instalación.


Utilice la característica de prueba de la herramienta de configuración paraprobar la conectividad a los recursos de su entorno desde los componentes deIBM Cognos for z/OS. También puede probar la conexión con los componentesde IBM Cognos desde la web escribiendo el URL del asignador y ContentManager. Además, si puede iniciar una sesión para acceder a IBM CognosConnection, significa que su instalación funciona.Para facilitar la resolución de problemas, pruebe una instalación básica paraasegurarse de que el producto funciona antes de personalizar los valores.

6. Personalice los valores para aprovechar los activos corporativos, mejorar elrendimiento, o mejorar la seguridadPuede configurar el producto para utilizar los activos corporativos existentes,como los proveedores de seguridad, los servidores de aplicaciones o losportales. Puede también ajustarlo para aumentar el rendimiento y mejorar laseguridad.

Qué hacer a continuación

Durante el ciclo de vida del producto, puede ser necesario aplicar servicio técnico.IBM proporciona la herramienta para ayudarle a mantener el software actualizado.


Capítulo 4. Planificación de la instalación de los componentesde servidor de IBM Cognos BI en el sistema z/OS

La clave para una instalación correcta es la planificación.

Al instalar IBM Cognos Business Intelligence for z/OS, decida cómo lo instalará yconfigurará para proporcionar el mejor rendimiento posible. Las opciones deinstalación y configuración que seleccione dependen de los requisitos, los recursosy sus preferencias.

Instalaciones de IBM Cognos Business IntelligenceLa forma más sencilla y rápida forma de ejecutar IBM Cognos Business Intelligencefor z/OS en su entorno es asegurarse de que una instalación básica funciona antesde añadir o configurar los componentes opcionales. Una instalación básica de IBMCognos BI requiere un servidor web, un almacén de contenido y componentes deservidor de IBM Cognos BI (pasarela, nivel de aplicación y Content Manager).

Puede instalar todos los componentes de servidor juntos en un único servidor o envarios servidores. Sin embargo, debe instalar el programa de utilidad CognosTransformer para crear PowerCubes en un directorio distinto al de loscomponentes de servidor de IBM Cognos BI.

Componentes de software de la instalación baseIBM Cognos BI for z/OS requiere que se instale como mínimo una instancia decada componente de servidor de BI. Debe instalar la pasarela de IBM Cognos, loscomponentes de nivel de aplicación y Content Manager en el sistema z/OS UNIX.También debe instalar Cognos Framework Manager en un sistema Windows.

El diagrama siguiente muestra los componentes de instalación obligatoria de losque consta la funcionalidad base del producto.


Componentes de software opcionalesDespués de verificar que la instalación básica funciona, puede añadir componentesopcionales al sistema. Debe instalar los componentes opcionales en ubicacionesespecíficas para asegurarse de que el producto funciona.

El diagrama siguiente muestra los componentes opcionales que puede instalar paraampliar la funcionalidad del producto.

Figura 1. Componentes de servidor de instalación base


Planificación de la capacidad para las instalaciones de z/OSLa planificación de la capacidad en el sistema z/OS significa determinar elhardware necesario para que el sistema funcione correctamente con la carga detrabajo prevista.

La planificación de la capacidad es la ciencia de medir las variables conocidas ydesarrollar una estimación precisa de los requisitos de recursos según dichasmediciones. También es el arte de permitir variables desconocidas y valorar suimpacto en las estimaciones derivadas de las variables conocidas.

Para determinar los requisitos, trabaje con el representante de IBM Cognos pararecopilar información sobre los siguientes atributos:v Usuarios de IBM Cognos

Estime el número de usuarios de IBM Cognos que espera tener, y cuándo esperaque utilicen IBM Cognos Business Intelligence.

v Complejidad de la aplicación

Figura 2. Componentes de servidor opcionales

Capítulo 4. Planificación de la instalación de los componentes de servidor de IBM Cognos BI en el sistema z/OS 23

Evalúe la complejidad del procesamiento que los usuarios exigirán de IBMCognos Business Intelligence.

v Su infraestructuraCaracterísticas de z/OS, Unix System Services, el origen de datos, el servidor deaplicaciones y la infraestructura y los entornos de seguridad.

La planificación de la capacidad es un proceso en curso. Después de implementarIBM Cognos Business Intelligence, supervise y modifique la capacidad según seanecesario para satisfacer sus expectativas de rendimiento.

Revisión de requisitos de hardware y software para los componentesde z/OS

Revise los requisitos mínimos de hardware y de software de requisito previo parainstalar y ejecutar IBM Cognos Business Intelligence for z/OS en el sistemaprincipal. Pueden ser necesarios recursos adicionales para los entornos deproducción o para entornos más grandes.

Antes de empezar

Asegúrese de revisar los entornos de software soportados en el centro del clientede IBM Cognos (http://www.ibm.com/software/data/cognos/customercenter/)para ver las versiones del producto soportadas y los niveles de mantenimientonecesarios.

Consulte el archivo de las notas de la versión en el Information Center de IBMCognos BI para obtener detalles acerca de la información de última hora sobreproblemas conocidos.

Procedimiento1. Utilice la tabla siguiente para comprobar los requisitos mínimos de hardware

para instalar y ejecutar los componentes de IBM Cognos BI en el sistemaoperativo z/OS. Pueden ser necesarios recursos adicionales para los entornosde producción.

Tabla 14. Requisitos mínimos de hardware para los componentes de servidor de IBMCognos BI


Sistema operativo z/OS

z/OS UNIX System Services (z/OS UNIX) con un sistema dearchivos HFS o ZFS)

Número deprocesadores centrales

Mínimo: 2



Tabla 14. Requisitos mínimos de hardware para los componentes de servidor de IBMCognos BI (continuación)


Espacio de disco Consulte la publicación Program Directory para ver los requisitosde espacio de disco

Asigne suficiente espacio de disco para los directorios de losarchivos de instalación, temporales y de registro. Puesto que losdirectorios bajo el directorio de instalación principal puedenmontarse en diferentes volúmenes, asegúrese de que cadadirectorio montado tiene suficiente espacio de disco libre.

Asigne un 20% de espacio de disco adicional para permitir elcrecimiento de los archivos temporales y de registro.

Asigne suficiente espacio de disco para el directorio del perfil deWebSphere Application Server. El directorio debe tener unacapacidad de 500 MB como mínimo para el despliegue de losarchivos de contenido web de IBM Cognos.

2. En función de la salida que desee generar, como por ejemplo el rastreo,asegúrese de que se cumpla una de las condiciones siguientes:v Tiene suficiente espacio de spool.v Los registros de salida se dirigen a un conjunto de datos o a un archivo USS

(Unix System Services).3. Utilice la tabla siguiente para comprobar los requisitos de software obligatorio

para instalar y ejecutar las bibliotecas de destino de IBM Cognos BI en elsistema operativo z/OS.

Tabla 15. Requisitos de software obligatorio para los componentes de servidor de IBMCognos BI


Java RuntimeEnvironment (JRE)

Si utiliza WebSphere Application Server, utilice el JRE que seinstala junto con dicho producto, si está soportado en IBMCognos.

Navegador web Para todos los navegadores web soportados, lo siguiente estáhabilitado:

v cookies

v JavaScript

Base de datos (almacénde contenido)

Debe tener una de las siguientes bases de datos disponible paraalmacenar los datos de IBM Cognos:

v IBM DB2 para z/OS

La base de datos debe estar configurada para utilizar un juegode caracteres Unicode.

v Cognos Content Database

Cognos Content Database está disponible con el producto, pero nose instala automáticamente durante la personalización a menosque se especifique en el archivo response.ats.

4. Utilice la tabla siguiente para comprobar los requisitos de software opcionalpara instalar y ejecutar IBM Cognos BI for z/OS.


Tabla 16. Requisitos de software opcional


Servidor web IBM HTTP Server

Servidor deaplicaciones

WebSphere Application Server (requiere el despliegue de unsirviente de 64 bits)

Base de datos(consulta)

IBM DB2 para z/OS

La base de datos de consulta debe estar instalada en el mismosysplex que el servidor de IBM Cognos BI. Es necesario realizartareas de configuración adicionales de DB2 si la base de datos deconsulta se encuentra en una LPAR distinta de la del servidor deIBM Cognos BI (componentes de nivel de aplicación).

Base de datos(ejemplos del productoIBM Cognos)

IBM DB2 para z/OS

Compatibilidad conLDAP versión 3

IBM Tivoli Directory Server

De forma predeterminada, IBM Cognos BI for z/OS se instala conel acceso anónimo habilitado.

Servidor de correo Necesario para las notificaciones.

Debe ser accesible a través de un cortafuegos.

La administración del sistema de z/OS debe configurar elcortafuegos para permitir el tráfico SMTP entre el servidor de IBMCognos BI y el servidor de correo que se utiliza para lasnotificaciones.

Tareas relacionadas:“Revisión de los requisitos de hardware y software para los componentes deWindows” en la página 111Antes de instalar los componentes de Windows, asegúrese de que tiene suficientesrecursos del sistema en el entorno para los modelos.

Valores de memoriaLos valores de memoria dependen de muchos factores, como el nivel de actividadprevista en el servidor, la complejidad de las aplicaciones de IBM Cognos, elnúmero de usuarios y las solicitudes y los tiempos de respuesta aceptables.

Si su entorno soporta más de 100 usuarios con nombre, es complejo, experimentaperíodos de alta utilización o incluye cualquier combinación de estos factores,considere la posibilidad de realizar un plan de capacidad. Para obtener másinformación, visite los IBM Software Services para Cognos (http://www.ibm.com/software/analytics/cognos/services/).

Para determinar los valores que son más adecuados para su entorno, serecomienda realizar pruebas de rendimiento.

Utilice los siguientes valores de memoria como un punto de partida y ajústelos enfunción del uso de memoria del sistema.v 2 GB para el sistema operativo base y el software que lo acompaña, como el

software antivirus, de copia de seguridad y de gestión de empresav 4 GB para una JVM de Content Manager de 64 bitsv 4 GB para una JVM de nivel de aplicación de 64 bits


http://www.ibm.com/software/analytics/cognos/services/

v 2 GB para la JVM de gráficos (IBM Cognos Workspace)v 2-4 GB para la JVM de Query Service (modo de consulta dinámica)v 1 GB por núcleo para los procesos de los servicios de informes (modo de

consulta dinámica) (JVM)v 2 GB por núcleo para los procesos de los servicios de informes (modo de

consulta compatible) (BIBuS)

En la tabla siguiente se muestran los valores de memoria recomendados por nivelde arquitectura para un sistema operativo de 64 bits.

Tabla 17. Valores de memoria recomendados por nivel de arquitectura

Nivel de arquitectura Valores de memoria

Nivel de IBM Cognos Gateway 2 GB

Nivel de IBM Cognos Application (modo de consultacompatible)

2 GB por núcleo

Nivel de aplicación de IBM Cognos (modalidad deconsulta dinámica)

4 GB + 1 GB por núcleo

Nivel de IBM Cognos Content Manager 4 GB

Podrían requerirse más recursos cuando se instala software adicional.

Verificación de versiones de software soportadas y requisitosde hardware

Para asegurarse de que se dispone de las versiones de software soportadasadecuadas y de que se ha asignado espacio suficiente para los componentes deservidor de IBM Cognos Business Intelligence, pruebe las asignaciones de espaciopara IBM Cognos Business Intelligence y la ubicación de destino de lasaplicaciones desplegadas, y pruebe las versiones del software instalado.

Procedimiento1. Asegúrese de que el espacio de disco asignado cumple los requisitos indicados

en la publicación Program Directory y asigne un 20% adicional para permitir elcrecimiento de los archivos temporales y de registro.v Para listar todos los discos montados, escriba el comando siguiente:

df -k

v Para proporcionar detalles para un punto de montaje específico, escriba elcomando siguiente:df -v mount_point

v Para revisar la información de volumen, en TSO/ISPF, escriba el comandosiguiente:LISTC ENT(’HFS or zFS dataset’) ALL

2. El administrador del sistema z/OS debe asignar 500 MB como mínimo para eldespliegue de los archivos de contenido web de IBM Cognos en el directoriodel perfil de WebSphere Application Server.

3. Para verificar si se han aplicado las actualizaciones adecuadas a IBM DB2,puede utilizar el siguiente ejemplo de trabajo JCL con el procedimientoSMPROC.a. Para verificar que se ha aplicado una SYSMOD determinada, por ejemplo,

para verificar que se han aplicado el APAR PK93123 y el PTF UK52962 paraIBM DB2 versión 9, puede utilizar un comando JCL como el siguiente:


//LIST JOB ’accounting info’,MSGLEVEL=(1,1)//LIST EXEC SMPPROC//SMPCNTL DD *SET BDY(db2_target_data_set) /* Set to target zone. */.LIST

SYSMOD(UK52962) /* and this SYSMOD. *//* */.

/*

b. Para verificar que se instalado un FMID para IBM DB2 versión 9, puedeutilizar un comando JCL como el siguiente://LIST JOB ’accounting info’,MSGLEVEL=(1,1)//LIST EXEC SMPPROC//SMPCNTL DD *SET BDY(db2_target_data_set) /* Set to target zone. */.LIST

FORFMID(HDB9910) /* and this FMID. *//* */.

/*

4. Inicie sesión en UNIX System Services como el usuario que ejecuta la aplicaciónde IBM Cognos en WebSphere Application Server.a. Vaya al directorio $WASHOME/bin.b. Escriba el siguiente comando:

./versionInfo.sh

Debe tener instalada la versión 7.0.0.15 como mínimo.

Conjuntos de datos del productoEl código del producto IBM Cognos Business Intelligence for z/OS reside enconjuntos de datos que contienen las funciones del producto y los sistemas dearchivos jerárquicos (HFS) de UNIX System Services HFS. El calificador de altonivel predeterminado para los conjuntos de datos del producto es CGC.

Contenido de los conjuntos de datos del producto

El producto IBM Cognos BI for z/OS tiene dos tipos de conjuntos de datos.v Conjuntos de distribución

Estos conjuntos de datos se utilizan como entrada al instalar el código delproducto y también se utilizan para copia de seguridad en caso de que seanecesaria una recuperación en un entorno de producción.

Tabla 18. Bibliotecas de distribución del servidor de IBM Cognos Business Intelligence

Descripción Nombre

scripts de shell ejecutables ACGCBASE

sistema de archivos de distribución ACGCZTAR

JCL de ejemplo ACGCSAMP

v Conjuntos de datos de destinoEstos conjuntos de datos se utilizan durante la ejecución y la personalización delproducto. Los conjuntos de datos de destino contienen el código ejecutable quese necesita para ejecutar IBM Cognos BI for z/OS.

Tabla 19. Bibliotecas de destino del servidor de IBM Cognos Business Intelligence

Descripción Nombre

scripts de shell ejecutables SCGCBASE


Tabla 19. Bibliotecas de destino del servidor de IBM Cognos BusinessIntelligence (continuación)

Descripción Nombre

sistema de archivos de destino SCGCZTAR

JCL de ejemplo SCGCSAMP

Convenciones de nomenclatura de los conjuntos de datos delproducto

Asegúrese de seleccionar una convención de nomenclatura de conjuntos de datosdel producto que permita conservar y mantener al menos dos copias de lasbibliotecas del producto a efectos de mantenimiento.

Algunos de los conjuntos de datos del producto deben tener el mismo calificadorde nombre de conjunto de datos de alto nivel para que el producto funcionecorrectamente. El mantenimiento del producto es más sencillo si todos losconjuntos de datos del producto tienen el mismo calificador de alto nivel. Por otraparte, para continuar ejecutando el producto mientras se aplica el mantenimiento,debe tener al menos dos copias de los conjuntos de datos del producto:v Una copia para ejecutar el entorno de ejecución de IBM Cognos BI for z/OSv Una copia a la que se le aplica el mantenimiento (servicio)

Elija un calificador de nivel medio para cada una de las versiones y de los nivelesde mantenimiento del producto. Este calificador de nivel medio puede reflejar unadistinción simple del entorno de prueba y de producción, como, por ejemplo, conCGC.VPROD.* o CGC.VTEST.*, o puede incluir información específica del nivel deservicio de CGC..BLDXXX.*

Existen muchos lugares donde debe especificar los nombres de conjuntos de datosdel producto. Para evitar confusiones, utilice el esquema de definición de nombresde conjuntos de datos más sencillo que cumpla sus objetivos de mantenimiento.

Uso de Cognos Content Database como almacén de contenidoCognos Content Database se proporciona para su comodidad junto con elproducto. Son embargo, de forma predeterminada no se instala. Debe seleccionarsepara que se instale como componente cuando instale los componentes de servidorde IBM Cognos BI.

Cognos Content Database puede ser útil en los entornos de prueba o de prueba deconcepto.Tareas relacionadas:“Configuración de la conexión a Cognos Content Database” en la página 96Si Cognos Content Database y Content Manager no se ejecutan en una mismaubicación, debe establecer las propiedades de conexión de base de datos paraCognos Content Database. Si Cognos Content Database y Content Manager sí seejecutan en una misma ubicación, Content Manager utiliza los valorespredeterminados para comunicarse con Cognos Content Database.


Capítulo 5. Preparación del sistema z/OS para la instalación

Es necesario realizar tareas previas a la instalación en el sistema z/OS antes deinstalar el código del producto.

Cuentas de usuario para la instalación y ejecución del productoEl administrador de z/OS debe crear los usuarios y los grupos necesarios en elsistema z/OS.

En la mayoría de las instalaciones, IBM Cognos Business Intelligence for z/OSdebe estar instalado bajo su propia y exclusiva identidad de usuario del sistemaoperativo. Además, la instalación requiere la cuenta de nadie (nobody).

La cuenta de nadie (nobody), que se asigna a los usuarios o a los procesos, nodebe tener permisos especiales.

Requisitos para la cuenta de usuario de la instalación

Para instalar IBM Cognos BI for z/OS en UNIX System Services, cree un grupopara el usuario de la instalación. Este grupo se utiliza para controlar el acceso a losdirectorios y los archivos del directorio de configuración creado en el sistema dearchivos HFS.

Cuando se crea un grupo, este debe contener el usuario que es el propietario de losarchivos de IBM Cognos. Por ejemplo, si crea un grupo con el nombre "cognos" yun usuario con el nombre "cognos", debe cambiar la propiedad del grupo de losarchivos de instalación de IBM Cognos al grupo "cognos" y cambiar los permisosde archivo de todos los archivos de IBM Cognos por GROUP READABLE/WRITABLE/EXECUTABLE.

La instalación puede realizarse utilizando la autorización raíz o una autorizaciónque no sea raíz.

IBM Cognos respeta la máscara de creación de modo de archivo (umask) de lacuenta que ejecuta el programa de instalación. Esto sólo afecta a los directorios deinstalación. No afecta a los permisos de archivos de los directorios. Sin embargo,los archivos generados en tiempo de ejecución, como los registros, respetan lamáscara. Utilice el valor umask 022 en el directorio de instalación.

Requisitos para la cuenta de usuario que ejecuta IBM Cognos

La cuenta con la que IBM Cognos BI se ejecuta debe tener las característicassiguientes:v Para utilizar orígenes de datos de DB2, se le debe haber otorgado el privilegio

para ejecutar programas que utilizan el plan DSNACLI.Por ejemplo: grant EXECUTE on plan DSNACLI to cognos.Asegúrese de que la cuenta de usuario tiene suficiente autorización para enlazarla CLI.

v Tener acceso a todos los recursos necesarios, como impresoras.


v Tener los derechos necesarios para iniciar la sesión como servicio y actuar comoparte del sistema operativo.

v Ser miembro del grupo de administración local.

Por ejemplo, para imprimir informes con una impresora de red, la cuenta debetener acceso a la impresora de red o se debe asignar una cuenta de inicio de sesiónal proceso de IBM Cognos.

Cuenta de usuario de WebSphere Application Server

Esta cuenta de usuario tiene permisos de acceso completo para la instalación deIBM Cognos. En UNIX System Services, el grupo del sistema operativo debe incluirel usuario que inicia el servidor de aplicaciones y el usuario que es propietario delos archivos de IBM Cognos (por ejemplo, el grupo cognos). Asigne la propiedaddel grupo de los archivos de IBM Cognos al grupo cognos y cambie los permisosde archivo de todos los archivos de IBM Cognos por GROUP READABLE/WRITABLE/ EXECUTABLE. Para que sea más fácil, también puede utilizar lacuenta de usuario del servidor de aplicaciones para instalar y ejecutar loscomponentes de IBM Cognos.

Verificación de los valores de cuenta de usuarioPara verificar la información de cuenta de usuario, puede utilizar TSO para ver losvalores de usuario y grupo.

Procedimiento1. En TSO, inicie la sesión como el usuario que ejecuta la aplicación de IBM

Cognos BINormalmente, la cuenta del usuario del servidor de aplicaciones tambiénejecuta los componentes de IBM Cognos.

2. Asegúrese de que la cuenta de usuario tiene el privilegio SPECIAL en RACF.3. Utilice el comando siguiente para verificar los valores de grupo:

LISTGRP GROUPNAME

Por ejemplo, si el nombre de grupo es OMVS, escriba el comando siguiente:LISTGRP OMVS

La salida mostrará todos los subgrupos y todos los usuarios pertenecientes aeste grupo. Asegúrese de que los usuarios de WebSphere y Cognos aparecen enla lista.Si la cuenta de usuario no tiene el atributo SPECIAL, se mostrará un error deautorización.

4. También puede la pertenencia a grupos de un usuario determinado mediante elcomando siguiente:LISTUSER USERNAME

Por ejemplo, si el nombre de usuario es OMVS, escriba el comando siguiente:LISTUSER OMVS

La salida mostrará la pertenencia en todos los grupos y valores exclusivos paraeste usuario.


Valores de variables de entorno en el sistema z/OSLos componentes de IBM Cognos Business Intelligence utilizan los valores de lasvariables de entorno para fines de configuración. Algunas de estas variablestambién se deben establecer en la consola administrativa de WebSphereApplication Server.

Debe establecer variables de entorno para el perfil de usuario que ejecuta elproducto IBM Cognos BI. Los scripts de ejemplo .tcshrc y .profile se instalancomo parte del conjunto de datos CGCSAMP..

Nota: Por lo general, se utiliza la cuenta de usuario del servidor de aplicacionespara ejecutar los componentes de IBM Cognos.

Tabla 20. Lista de variables de entorno previas a la instalación para IBM Cognos BI forz/OS


_BPXK_AUTOCVT ON Esta variable de entornode tiempo de ejecucióndebe establecerse en ONpara convertirautomáticamente aEBCDIC los archivoscon codificación ASCII amedida que el instaladorde IBM Cognos lee losarchivos.

_CEE_RUNOPTS POSIX(ON), FILETAG(AUTOCVT,AUTOTAG)

Establezca esta variablepara el instalador deIBM Cognos que creaarchivos que deben estarcorrectamenteetiquetados.

JAVA_HOME ${WASHOME}/java64 Apunta a la ubicaciónde instalación de JavaRuntime Environment(JRE).

Por ejemplo, si estáutilizando WebSphereApplication Server,establezca la variable deentorno JAVA_HOMEpara utilizar la JVM quese proporciona conWebSphere ApplicationServer.

PATH $JAVA_HOME/bin

LIBPATH /usr/lib:${LIBPATH} El instalador de IBMCognos requiere elarchivo Xm_31dll.

Capítulo 5. Preparación del sistema z/OS para la instalación 33

Tabla 20. Lista de variables de entorno previas a la instalación para IBM Cognos BI forz/OS (continuación)


Conectividad JDBC

v JDBCHOME

v JDBCCLASSES

v CLASSPATH

Variables JDBC

v ${DB2HOME}/db2910_jdbc

v ${JDBCHOME)/classes

v $CLASSPATH: ${JDBCCLASSES}/db2jcc_javax.jar

v $CLASSPATH: ${JDBCCLASSES}/db2jcc4.jar

v $CLASSPATH: ${JDBCCLASSES}/db2jcc_license_cisuz.jar

v $CLASSPATH: ${JDBCCLASSES}/sqlj4.zip

Establezca estasvariables de entornopara habilitar laconectividad JDBC conel almacén de contenidoDB2.


Conectividad ODBC

v DSNAOINI

v STEPLIB

Variables ODBC

v /u/user1/db2odbc/odbciniv prefix.SDSNEXIT:

prefix.SDSNLOAD:prefix.SDSNLOD2


Establezca las variablesde entorno de ODBCpara permitir al sistemautilizar el procesador delínea de comandos deDB2 y para especificar laubicación del archivo deinicialización de ODBCde DB2.


Tabla 21. Lista de variables de entorno posteriores a la instalación para IBM Cognos BI forz/OS


IBM_JAVA_ENABLE_ASCII_FILETAG ON Se establece en ONporque z/OS utiliza lacodificación decaracteres EBCDIC y lasaplicaciones Java deIBM Cognos BI utilizanla codificación ASCII.

LIBPATH ${JDBCHOME}/lib:/bin:${COGROOT}/bin64:${COGROOT}/bin:$JAVA_HOME/bin:${LIBPATH}


Apunta a los directoriosubicación_c10/bin64 yubicación_c10/bin.

Añada la ubicación delas bibliotecas de JDBC.


Tabla 21. Lista de variables de entorno posteriores a la instalación para IBM Cognos BI forz/OS (continuación)


PATH Si COGROOT es el directoriode nivel superior de lainstalación del servidor deIBM Cognos BI:

/bin:${COGROOT}/bin64:${COGROOT}/bin:$JAVA_HOME/bin:${PATH}

Apunta a los directoriosubicación_c10/bin64 yubicación_c10/bin.

Añada el directorioJAVA_HOME/bin.

_BPX_JOBNAME CGC Se establece enWebSphere ApplicationServer.

Identifica lasextensiones de espaciode direcciones que seejecutan en WebSphereApplication Servercomo procesos deCognos.

DISPLAY nombre_host:número_pantalla En IBM CognosConfiguration en z/OS,permite la visualizaciónde la interfaz deusuario.

LANG C Esta variable deentorno debeestablecerse en C paraasegurarse de que elsistema operativopueda localizar elconjunto de programasde utilidad de lenguajeque contiene el archivocat X11.

Tareas relacionadas:“Establecimiento de las variables de entorno de JDBC para un almacén decontenido DB2” en la página 230IBM Cognos Business Intelligence for z/OS utiliza la conectividad JDBC paracomunicarse con el almacén de contenido. Debe configurar las variables de entornoadecuadas para habilitar las clases utilizadas por el controlador JDBC.

Uso de shells de z/OS UNIX System Services para establecervariables de entorno

Tanto el shell de z/OS como el shell tcsh proporcionan comandos que ofrecen unaforma eficaz para solicitar una variedad de servicios, como establecer variables deentorno

Hay dos shells disponibles en z/OS UNIX System Services:v El shell de z/OS

La mayoría de los ejemplos de la guía utilizan este shell.


v El shell tcshTcsh es un shell de Unix que se basa en el shell C (csh) y es compatible con este.

Utilización de un archivo .tcshrc para establecer las variablesde entorno

Utilice el archivo .tcshrc de ejemplo como guía para establecer las variables deshell correspondientes al usuario que ejecuta IBM Cognos Business Intelligence.

Acerca de esta tarea

Si desea revisar y editar el ejemplo en el sistema z/OS, localice el miembroCGCTCSH en el conjunto de datos CGCSAMP y, a continuación, cópielo en eldirectorio inicial en UNIX System Services del usuario que ejecutará la instalaciónde IBM Cognos. En UNIX System Services, utilice el archivo que ha copiado paraañadir el contenido al archivo .tschrc existente para el usuario, o si es necesario,cree un nuevo archivo .tschrc.

Si desea revisar y editar el ejemplo en UNIX System Services, inicie la sesión comoel usuario que ejecuta IBM Cognos Business Intelligence y abra el archivo .tcshrcpara editarlo.

Procedimiento1. Revise y edite el ejemplo.

#!/bin/tcshumask 022

setenv EDITOR visetenv TMPDIR ${HOME}/tempsetenv TERM vt100

# X client machinesetenv DISPLAY �.ip.address:0.0�

#DB2 variablessetenv DB2HOME /usr/lpp/dsn910#setenv DB2HOME /usr/lpp/dsn810setenv DB2BASE ${DB2HOME}/db2910_base#setenv DB2BASE /usr/lpp/db2/db2810setenv CLPPROPERTIESFILE �/u/coguser/clp.properties�alias db2="java com.ibm.db2.clp.db2"

#JDBC variablessetenv JDBCHOME ${DB2HOME}/db2910_jdbc#setenv JDBCHOME $/usr/lpp/db2/db2810/jccsetenv JDBCCLASSES ${JDBCHOME}/classessetenv CLASSPATH $CLASSPATH:${JDBCCLASSES}/db2jcc_javax.jarsetenv CLASSPATH $CLASSPATH:${JDBCCLASSES}/sqlj4.zipsetenv CLASSPATH $CLASSPATH:${JDBCCLASSES}/db2jcc4.jarsetenv CLASSPATH $CLASSPATH:${JDBCCLASSES}/db2jcc_license_cisuz.jarsetenv CLASSPATH ${DB2BASE}/lib/clp.jar:${CLASSPATH}

#ASCII Application variablessetenv _BPXK_AUTOCVT ONsetenv _CEE_RUNOPTS "POSIX(ON), FILETAG(AUTOCVT, AUTOTAG)"

#JAVA variablessetenv WASHOME /usr/lpp/zWebSphere/V7R0setenv JAVA_HOME ${WASHOME}/java64setenv IBM_JAVA_ENABLE_ASCII_FILETAG ON


#ODBC variablessetenv DSNAOINI /u/user1/db2odbc/odbcinisetenv STEPLIB �prefix.SDSNEXIT:prefix.SDSNLOAD:prefix.SDSNLOD2�

#Command Pathsetenv COGROOT "�/pathprefix/usr/lpp/ibm/cognos/BI_10.2.0�"setenv PATH "/bin:${COGROOT}/bin64:${COGROOT}/bin:${PATH}"

2. Compruebe que los valores son adecuados para su entorno.Por ejemplo, elimine o añada marcas de comentario para las variables deentorno de las versiones de software que no vaya a utilizar.

3. Para la variable de entorno DISPLAY, cambie el valor de .ip.address:0,0 para quese ajuste a su entorno.Esta variable ayuda a garantizar que se muestra la interfaz gráfica de usuariode IBM Cognos Configuration.

4. Para establecer la variable de entorno CLPPROPERTIESFILE, cambie eldirectorio para incluir el nombre de la ruta completa donde se encuentra elarchivo de propiedades.

5. Para establecer la variable de entorno STEPLIB, cambie el valor de prefix paraque se ajuste a su entorno.

6. Para establecer la variable de entorno COGROOT, cambie el valor de pathprefixpara que se ajuste a su entorno.

7. Guarde y cierre el archivo.

Editar el archivo .profile para establecer las variables deentorno

Utilice el archivo .profile de ejemplo como guía para establecer las variables deshell correspondientes al usuario que ejecuta IBM Cognos Business Intelligence.


Si desea revisar y editar el ejemplo en el sistema z/OS, localice el miembroCGCPROFL en el conjunto de datos CGCSAMP y, a continuación, cópielo en eldirectorio inicial en UNIX System Services del usuario que ejecutará la instalaciónde IBM Cognos. En UNIX System Services, utilice el archivo que ha copiado paraañadir el contenido al archivo .profile existente para el usuario, o si es necesario,cree un nuevo archivo .profile.

Si desea revisar y editar el ejemplo en UNIX System Services, inicie la sesión comoel usuario que ejecuta IBM Cognos Business Intelligence y abra el archivo .profilepara editarlo.

Procedimiento1. En UNIX System Services, inicie la sesión como el usuario que ejecuta IBM

Cognos Business Intelligence y abra el archivo .profile para editarlo.#!/bin/tcshumask 022

export EDITOR=viexport TMPDIR=${HOME}/tempexport TERM=vt100

# X client machineexport DISPLAY=�.ip.address:0.0�

#DB2 variablesexport DB2HOME=/usr/lpp/dsn910


#export DB2HOME=/usr/lpp/dsn810export DB2BASE=${DB2HOME}/db2910_base#export DB2BASE=$/usr/lpp/db2/db2810export CLPPROPERTIESFILE=�/u/coguser/clp.properties��alias db2="java com.ibm.db2.clp.db2"

#JDBC variablesexport JDBCHOME=${DB2HOME}/db2910_jdbc#export JDBCHOME=$/usr/lpp/db2/db2810/jccexport JDBCCLASSES=${JDBCHOME}/classesexport LIBPATH=${JDBCHOME}/lib:/usr/lib:${LIBPATH}export PATH=${JDBCHOME}/bin:${PATH}export CLASSPATH=$CLASSPATH:${JDBCCLASSES}/db2jcc_javax.jarexport CLASSPATH=$CLASSPATH:${JDBCCLASSES}/sqlj4.zipexport CLASSPATH=$CLASSPATH:${JDBCCLASSES}/db2jcc4.jarexport CLASSPATH=$CLASSPATH:${JDBCCLASSES}/db2jcc_license_cisuz.jarexport CLASSPATH=${DB2BASE}/lib/clp.jar:${CLASSPATH}

#ASCII Application variablesexport _BPXK_AUTOCVT=ONexport _CEE_RUNOPTS="POSIX(ON), FILETAG(AUTOCVT, AUTOTAG)"

#JAVA variablesexport WASHOME=/usr/lpp/zWebSphere/V7R0export JAVA_HOME=${WASHOME}/java64export IBM_JAVA_ENABLE_ASCII_FILETAG=ON

#ODBC variablesexport DSNAOINI=�/u/user1/db2odbc/odbcini�export STEPLIB=�prefix.SDSNEXIT:prefix.SDSNLOAD:prefix.SDSNLOD2�

#Command Pathexport COGROOT="�/pathprefix/usr/lpp/ibm/cognos/BI_10.2.0�"export PATH="/bin:${COGROOT}/bin64:${COGROOT}/bin:${PATH}"

2. Compruebe que los valores son adecuados para su entorno.Por ejemplo, elimine o añada marcas de comentario para las variables deentorno de las versiones de software que no vaya a utilizar.

3. Para la variable de entorno DISPLAY, cambie el valor de .ip.address:0,0 para quese ajuste a su entorno.Esta variable ayuda a garantizar que se muestra la interfaz gráfica de usuariode IBM Cognos Configuration.

4. Para establecer la variable de entorno CLPPROPERTIESFILE, cambie eldirectorio para incluir el nombre de la ruta completa donde se encuentra elarchivo de propiedades.

5. Para establecer la variable de entorno STEPLIB, cambie el valor de prefix paraque se ajuste a su entorno.

6. Para establecer la variable de entorno COGROOT, cambie el valor de pathprefixpara que se ajuste a su entorno.

7. Para establecer la variable de entorno DSNAOINI, cambie el directorio paraincluir el nombre de la ruta completa donde se encuentra el archivo deinicialización de ODBC.


Verificación de los valores de las variables de entornoPara asegurarse de que el entorno de z/OS UNIX System Services está preparadocorrectamente para la instalación de IBM Cognos Business Intelligence for z/OS,puede utilizar UNIX System Services para comprobar si las variables de entornoestán establecidas.


Procedimiento1. Inicie sesión en UNIX System Services como el usuario que ejecuta IBM

Cognos.La cuenta con la que IBM Cognos se ejecuta debe tener configuradasdeterminadas variables de entorno.

2. En el shell de UNIX System Services, compruebe que las variables de entornoestán establecidas.

Tabla 22. Valores de las variables de entorno previos a la instalación

Variable de entorno Valores o ejemplos

_BPXK_AUTOCVT ON

_CEE_RUNOPTS "POSIX(ON), FILETAG(AUTOCVT,AUTOTAG)"

JAVA_HOME ${WASHOME}/java64

PATH $JAVA_HOME/bin:/bin:${COGROOT}/bin64:${COGROOT}/bin:$JAVA_HOME/bin:${PATH}

IBM_JAVA_ENABLE_ASCII_FILETAG ON


Nota: Continuación de línea correspondiente aeste valor.


LIBPATH ${JDBCHOME}/lib:/bin:${COGROOT}/bin64:${COGROOT}/bin:$JAVA_HOME/bin:${LIBPATH}

Nota: Continuación de línea correspondiente aeste valor.

DISPLAY nombre_host:número_pantalla

LANG C

v Para ver una lista de las variables de entorno establecidas en el shell, escribael comando siguiente:env

v Pruebe las variables de entorno una por una mediante el comando siguiente:env | grep environment_variable

Directrices para los valores iniciales de los subsistemas DB2En la guía de instalación de DB2, siga las instrucciones que se proporcionan a losadministradores del sistema y de base de datos acerca de la planificación y lainstalación de subsistemas DB2. Revise los parámetros de subsistema DB2 antes deinstalar IBM Cognos Business Intelligence for z/OS. Debido a la utilización desubprocesos de ODBC para conectar con los orígenes de datos de IBM Cognos y eluso de conexiones JDBC para acceder a la base de datos del almacén de contenido,es posible que se apliquen consideraciones adicionales.

IBM Cognos Business Intelligence for z/OS utiliza una arquitectura de variossubprocesos para ejecutar tantas solicitudes de los usuarios como sea posible, deforma simultánea. También reutiliza las conexiones de base de datos para evitar la


actividad general asociada con el establecimiento de estas. Algunas acciones deusuario pueden dejar conexiones a DB2 inactivas durante un largo periodo detiempo. Si las aplicaciones de IBM Cognos se ejecutan con ubicación compartidacon otras aplicaciones, es necesario llegar a un acuerdo sobre el equilibrioaceptable para algunos de los valores sugeridos, como IDTHTION, ya que estosvalores están en el nivel de subsistema DB2.

Para dar cabida a este nivel de alta simultaneidad y reutilización de conexiones,utilice los valores iniciales sugeridos de la tabla siguiente.

Tabla 23. Valores iniciales sugeridos para los parámetros de subsistema DB2

Parámetro desubsistema DB2

Valor inicialsugerido Descripción

IDBACK 800 Determina el número máximo de conexionesODBC simultáneas.

Se trata de un importante parámetro de ajuste detamaño para acceder a los almacenes de datos.

MAXDBAT 800 Determina el número máximo de subprocesosremotos simultáneos.

Este parámetro implica ajustar el tamaño delalmacén de contenido para que Content Managerpueda acceder a él.

CONDBAT 10000 Especifica el número máximo de conexiones DDF(recurso de datos distribuidos) de entrada.

CTHREAD 800 Controla el número de subprocesos aliados que sehan iniciado en el sistema local.

El valor de este parámetro incluye conexionesODBC, pero debe dejar espacio para otros usuariosde subprocesos, como los programas de utilidad olos supervisores.

IDTHTOIN 0 Para asegurarse de que los procesos no seterminan antes de que IBM Cognos BusinessIntelligence for z/OS acabe de procesar losinformes, considere establecer en cero el valor detiempo de espera de subproceso inactivo.

Con esta acción, los subprocesos se mantendránactivos hasta que los usuarios de IBM CognosBusiness Intelligence for z/OS hayan acabado deutilizar los informes.

NUMLKTS 2000 Determina el número máximo de bloqueos porespacio de tabla.

Potencialmente, puede añadirse un mayor númerode subprocesos mediante la utilización delconector ODBC.

Un valor superior para este parámetro puedeayudar a evitar los errores relacionados con elbloqueo.

NUMLKUS 10000 Establece el número máximo de bloqueos porusuario.


Tabla 23. Valores iniciales sugeridos para los parámetros de subsistemaDB2 (continuación)

Parámetro desubsistema DB2

Valor inicialsugerido Descripción

EDMPOOL 144175 Especifica el tamaño de la agrupación de EDM(gestor de descriptores de entorno).

El valor del parámetro debe revisarse. Se puedencrear más objetos de EDM con la implementaciónde subprocesos de Cognos y de ODBC.

A medida que pruebe los informes de IBM Cognos Business Intelligence que sehan desplegado, puede continuar personalizando los valores de DB2 para suentorno.

Establecimiento de parámetros de inicialización para z/OS UNIXSystem Services

Configure los valores de los parámetros de inicialización para los componentes deIBM Cognos directamente en SYS1.PARMLIB.

Cada miembro del conjunto de datos PARMLIB proporciona valores deconfiguración que el usuario puede controlar. Puede cambiar muchos de estosvalores de forma dinámica, sin necesidad de reiniciar el sistema.

Para obtener más información, consulte la publicación z/OS V1R10 MVSInitialization and Tuning Reference, SA22-7592 (http://www.ibm.com/support/docview.wss?uid=pub1sa22759217).

SYS1.SAMPLIB proporciona un miembro parmlib BPXPRMXX de ejemplo. Utilicela tabla siguiente para establecer los parámetros de z/OS.

Tabla 24. Lista de los parámetros de z/OS USS y los valores sugeridos para ellos

Parámetro de z/OSUSS Definición y valores necesarios o sugeridos

AUTOCVT Permite la conversión automática de datos EBCDIC a ASCII yviceversa.

Valor predeterminado: OFF

Valor necesario: ON excepto cuando se inicia IBM HTTP WebServer para ver el contenido estático.

Puede utilizar los comandos SETOMVS o SET OMVS para cambiarel valor de AUTOCVT entre ON y OFF.

IPCSEMNOPS Especifica el número máximo de operaciones para cada llamada deoperación de semáforo.

Valor predeterminado: 25

Valor sugerido: 25


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

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

Tabla 24. Lista de los parámetros de z/OS USS y los valores sugeridos paraellos (continuación)


IPCSEMNSEMS Especifica el número máximo de semáforos para cada conjunto desemáforos.


Valor sugerido: 1000

MAXASSIZE Especifica la cantidad máxima de memoria de espacio dedirecciones.



MAXCORESIZE Especifica el tamaño máximo del archivo de volcado de imagen dememoria que un proceso puede crear.



MAXCPUTIME Especifica el máximo de CPU, en segundos, por espacio dedirecciones creado por rlogind, telnetd y daemons.


MAXFILESIZE Especifica el tamaño máximo de los archivos.


Valor sugerido: NOLIMIT, 2147483647 o parámetros de omisiónequivalentes

MAXMMAPAREA Especifica el número máximo de páginas de 4K de memoria para lacorrelación de memoria de los archivos de UNIX (mmap).



MAXPROCUSER Especifica el número máximo de procesos que un único ID deusuario de z/OS UNIX puede tener activos simultáneamente.



MAXQUEUEDSIGS Especifica el número máximo de señales que z/OS UNIX permitetener en cola simultáneamente en un único proceso.


MAXSHAREPAGES Especifica el número máximo de páginas de 4K de memoriacompartida para la correlación de memoria de los archivos deUNIX (llamadas mmap y shmat solamente).




Tabla 24. Lista de los parámetros de z/OS USS y los valores sugeridos paraellos (continuación)


MAXTHREADS Especifica el número máximo de subprocesos que un único procesopuede tener activos actualmente.



MAXTHREADTASKS Especifica el número máximo de tareas de MVS que un únicoproceso puede tener activas simultáneamente.



SHRLIBRGNSIZE Identifica la cantidad máxima de espacio de bibliotecas compartidasdel sistema para todos los espacios de direcciones que utilizanbibliotecas compartidas del sistema.


Valor sugerido: no más de 100 MB

Conceptos relacionados:“Problemas al crear una conexión ODBC con un origen de datos DB2 en el sistemaz/OS” en la página 235Puede que encuentre problemas, como, por ejemplo errores de conexión en IBMCognos Administration, al configurar una conexión con orígenes de datos DB2debido a los valores de codificación de los archivos.Tareas relacionadas:“Configuración de IBM HTTP Web Server para ver el contenido estático de IBMCognos BI” en la página 91Para ver las páginas web de IBM Cognos BI, configure los directorios virtuales enel servidor web. Para utilizar la versión de 64 bits de la pasarela de IBM CognosBI, utilice un script para copiar los archivos necesarios.


Capítulo 6. Instalación de componentes de IBM Cognos BI enel sistema z/OS

Una instalación completa en el sistema z/OS requiere dos programas diferentes.Utilice el programa de instalación SMP/E (System Modification ProgramExtended) para instalar los componentes de servidor de IBM Cognos BusinessIntelligence en el sistema z/OS. A continuación, utilice el instalador de IBMCognos para finalizar la instalación de los componentes en las ubicaciones en lasque se ejecutarán.

SMP/E y componentes de servidor de IBM Cognos BI

El programa de utilidad SMP/E se utiliza para instalar software y realizar elmantenimiento de éste en el sistema z/OS.

Durante la primera parte del proceso de instalación, el programa de utilidadSMP/E se utiliza para instalar las funciones del producto en el sistema de z/OSUNIX System Services.

Hay varios kits de instalación incluidos en un Functional Modifier Identifier(FMID). Instale el FMID HCGCA20 mediante el programa de utilidad SMP/E.

La tabla siguiente lista los componentes de instalación incluidos en el FMIDHCGCA20.

Tabla 25. Descripciones de los FMID de IBM Cognos BI for z/OS

Componente Descripción

IBM Cognos Business Intelligence Server forz/OS 10.2.0 de 64 bits multilingüe

Obligatorio: Proporciona componentes deservidor principales.

IBM Cognos Business IntelligenceTransformer for z/OS 10.2.0 multilingüe

Opcional: Proporciona el programa deutilidad para crear PowerCubes.

IBM Cognos Business Intelligence Samples10.2.0

Opcional: Proporciona ejemplos delproducto para probar las características delproducto y para la resolución de problemas.

IBM Cognos Software Development Kit10.2.0 de 64 bits - Inglés

Opcional: Proporciona una colección deservicios web, bibliotecas e interfaces deprogramación para cualquier plataforma.

IBM Cognos Supplementary LanguagesDocumentation 10.2.0

Opcional: Proporciona documentacióntraducida del producto.

IBM Cognos Mobile 10.2.0.2 Opcional: Permite a los usuarios ver einteractuar con informes de IBM Cognos BIen tabletas y en dispositivos smartphone.

Instalador de IBM Cognos y componentes de servidor de IBMCognos BI

El programa de utilidad de instalador de IBM Cognos copia los componentes deservidor en una sola ubicación de despliegue desde la que se ejecuta el producto.


Si instala Cognos Transformer, el instalador utiliza una segunda ubicación dedespliegue. Los componentes de servidor BI, los ejemplos, IBM Cognos Insight,IBM Cognos Software Development Kit, IBM Cognos Mobile y la documentacióntraducida son independientes de Cognos Transformer.

IBM Custom-Build Product Delivery OptionPara instalar el código del producto IBM Cognos Business Intelligence for z/OSdebe utilizar una CBPDO (Custom-Build Product Delivery Option) de IBM. UnaCBPDO carga el contenido del soporte de instalación en el sistema z/OS.

Una CBPDO contiene el producto y el servicio acumulativo correspondiente alproducto. El documento Memo to Users Extension de la CBPDO contieneinformación sobre la CBPDO y las características y el servicio que incluye. Tambiéncontiene información de instalación de la CBPDO.

IBM Cognos BI for z/OS Program DirectoryLa publicación Program Directory de IBM Cognos Business Intelligence for z/OSproporciona instrucciones para la instalación del producto a las bibliotecas deSMP/E (System Modification Program Extended).

El directorio de instalación lo crea el administrador del sistema y el formato dearchivo es zFS para permitir la asignación de espacio para crecer.

Trabajos de instalación de ejemplo

La publicación Program Directory (GI10-8938-00) proporciona información acerca delos trabajos de instalación de ejemplo que SMP/E utiliza para instalar el productoy el servicio en el sistema z/OS. De forma predeterminada, SMP/E instala todoslos elementos incluidos en la cinta de Custom Build Product Delivery Option enzonas globales, de destino y de distribución de SMP/E nuevas.

Existe información detallada acerca de los trabajos de instalación en la publicaciónIBM Cognos Business Intelligence for z/OS Program Directory, así como en loscomentarios al inicio de cada trabajo.

Uno de los parámetros que deberá especificar en muchos de los trabajos deinstalación es el calificador de alto nivel (HLQ). Algunos trabajos también necesitanque proporcione el prefijo de ruta para la ubicación de instalación.

Resultados de la ejecución de los trabajos de instalación deSMP/E

Tras haber ejecutado un trabajo, compruebe la salida de este antes de continuarcon el siguiente trabajo. Si un trabajo termina de forma anómala, averigüe por quéha fallado (el registro de trabajos contiene los mensajes de error generados en cadaejecución). Corrija el error y, a continuación, continúe tal como se indica en ladescripción del trabajo. No intente ejecutar el trabajo siguiente hasta que el trabajoanterior se haya ejecutado correctamente.

Cuando los trabajos de instalación finalicen, tendrá todos los elementos instaladosen nuevas zonas globales, de destino y de distribución de SMP/E.


Sistema de archivos del productoEl directorio del producto IBM Cognos Business Intelligence y todos sussubdirectorios se encuentran en el mismo sistema de archivos jerárquico (HFS).

Sistema de archivos del producto de instalación

Durante el proceso de instalación, todos los archivos del producto IBM CognosBusiness Intelligence for z/OS del producto se copian en su propio directorio deproducto dentro de dos directorios padre. La lista siguiente describe el contenidode los directorios padre.v /prefijoruta/usr/lpp/cognos/HCGCA20/installer/IBM

Este directorio contiene los archivos del actualizador y del producto sincomprimir. Estos archivos se utilizan para invocar el programa de instalación deIBM Cognos (issetup.sh) para personalizar la instalación del producto o paraactualizar la personalización con arreglos durante el mantenimiento.

v /prefijoruta/usr/lpp/cognos/HCGCA20/IBM

Este directorio está vacío y es la ubicación predeterminada en la que el productose instalará después de ejecutar el programa de instalación de IBM Cognos.Antes de la personalización, debe montar el sistema de archivos de destino.

Utilice un sistema de archivos HFS o zFS para cada uno de los dos directorios.

Archivos de instalación sin comprimir

Cada kit de instalación se instala en archivos sin comprimir en su propio directoriodel producto. Por ejemplo, IBM Cognos BI for z/OS se instala en su propiodirectorio, que es distinto del de los ejemplos de IBM Cognos BI. Desde estosdirectorios, ejecute el instalador de personalización que instala los componentes delproducto en las ubicaciones correspondientes.

En la tabla siguiente se enumeran las funciones del producto y el directorio en elque se encuentra el instalador de personalización.

Tabla 26. Archivos de producto sin comprimir y ubicaciones de directorio

Componente Directorio

Servidor de IBM Cognos BusinessIntelligence para z/OS

/usr/lpp/cognos/HCGCA20/installer/cgc_bisrvr/IBM/

IBM Cognos Software Development Kit /usr/lpp/cognos/HCGCA20/installer/cgc_bisdk/IBM/

IBM Cognos BI Transformer /usr/lpp/cognos/HCGCA20/installer/cgc_bitrsfrmr/IBM/

IBM Cognos Business IntelligenceSupplementary Languages Documentation

/usr/lpp/cognos/HCGCA20/installer/cgc_lp/IBM/

Ejemplos de IBM Cognos BusinessIntelligence

/usr/lpp/cognos/HCGCA20/installer/cgc_bisamples/IBM/

IBM Cognos Connection Installer for CognosInsight

/usr/lpp/cognos/HCGCA20/installer/cgc_cdbiint/IBM/

IBM Cognos Mobile /usr/lpp/cognos/HCGCA20/installer/cgc_biext/IBM

Capítulo 6. Instalación de componentes de IBM Cognos BI en el sistema z/OS 47

Archivos de instalación del actualizador sin comprimir

El actualizador de los archivos de instalación se instalan con cada componente delproducto. El instalador del actualizador se invoca cuando hay tareas demantenimiento disponibles.

Tabla 27. Archivos del actualizador sin comprimir y ubicaciones de directorio

FMID Directorio

Actualizador - servidor de IBM CognosBusiness Intelligence para z/OS

/usr/lpp/cognos/HCGCA20/installer/cgc_upbisrvr/IBM/

Actualizador - IBM Cognos SoftwareDevelopment Kit

/usr/lpp/cognos/HCGCA20/installer/cgc_upbisdk/IBM/

Actualizador - IBM Cognos BI Transformer /usr/lpp/cognos/HCGCA20/installer/cgc_upbitrsfrmr/IBM/

Actualizador - IBM Cognos BusinessIntelligence Supplementary LanguagesDocumentation

/usr/lpp/cognos/HCGCA20/installer/cgc_uplp/IBM/

Actualizador - Ejemplos de IBM CognosBusiness Intelligence

/usr/lpp/cognos/HCGCA20/installer/cgc_upbisamples/IBM/

IBM Cognos Connection Installer for CognosInsight

/usr/lpp/cognos/HCGCA20/installer/cgc_upcdbiint/IBM/

Sistema de archivos del producto de personalización

El SMP/E crea la estructura de HFS para los archivos del producto. Después decrear la estructura de HFS, debe completar la personalización de la instalaciónejecutando el instalador de IBM Cognos. El instalador de IBM Cognos crea laestructura de archivos y copia los archivos del producto en ubicaciones específicas.El producto se ejecuta desde esta ubicación.

En esta documentación, se utiliza el término ubicación_c10 para representar laubicación de instalación de los componentes del producto IBM Cognos BI forz/OS.

Montaje manual del sistema de archivos de destino del servidor deIBM Cognos BI

Para poder acceder al sistema de archivos de destino que contiene la función basepara los componentes de servidor de IBM Cognos Business Intelligence, debemontar el sistema de archivos. Puede montar manualmente el sistema de archivosde destino, o puede utilizar un trabajo JCL.

Procedimiento1. Vaya al directorio /prefijoruta/usr/lpp/cognos/HCGCA20/IBM.

SMP/E ha creado este directorio. Se trata del directorio en el que se instala elproducto después de ejecutar el programa de instalación de IBM Cognosdurante la personalización.

2. Asegúrese de que el directorio tenga los permisos ug+rwx.3. Para montar el sistema de archivos de z/OS UNIX que se ha creado mediante

el trabajo CGCZAL opcional, utilice el siguiente comando:/usr/bin/mount -v -tZFS -f HLQ.SCGCZFS /pathprefix/usr/lpp/cognos/HCGCA20/IBM


Archivos de respuestasIBM Cognos Business Intelligence for z/OS utiliza una instalación silenciosa parapersonalizar la instalación. En lugar de solicitarle opciones de instalación, elprograma de instalación instala el software utilizando un conjunto predefinido deopciones, que están almacenadas en un archivo de respuestas.

archivos de respuestas del producto

Cada función del producto tiene un archivo de respuestas. No todas las seccionesestán presentes en los archivos de respuestas para cada función del producto. Porejemplo, el archivo de respuestas para el servidor de IBM Cognos BI contiene másopciones de instalación que el archivo de respuestas para IBM Cognos BISupplementary Languages.

Secciones de un archivo de respuestas

El archivo de respuestas está dividido en secciones. Cada sección tiene unpropósito específico y contiene las variables que puede definir. Cada sección de unarchivo de respuestas corresponde a un cuadro de diálogo de una sesióninteractiva de instalación.

Cada sección de un archivo de respuestas empieza por una línea, entre corchetes,que especifica el número de diálogo, seguida de un título que especifica el nombrede la sección, tal como se muestra en el ejemplo siguiente:[Dialog1]Title=Welcome to the Installation Wizard

Valores para las opciones de instalación

Los valores de las variables se especifican en el siguiente formato:

<variable name>=<value>

No debe haber ningún espacio ni delante ni detrás del signo igual.

Cada valor del archivo de respuestas pertenece a uno de los tipos indicados en latabla siguiente.

Tabla 28. Ejemplos de tipos de valor en el archivo de respuestas

Tipo Ejemplos

Booleano Para todas las variables excepto los términosde aceptación de licencia

v 0 = no o falso

v 1= sí o verdadero

Para los términos de aceptación de licencia

s = sí

n = no

Cadena /


Modificación de un archivo de respuestasGenere y modifique un archivo de respuestas para especificar y registrar suspreferencias de instalación.

Antes de empezar

Establezca las siguientes variables de entorno para asegurarse de que los archivosestán etiquetados correctamente:v _BPXK_AUTOCVT

v _CEE_RUNOPTS

v JAVA_HOME


Edite los archivos de respuestas de cada función de servidor (también llamadocomponente de servidor) para que se ajuste a su entorno antes de utilizarlos comoentrada para una instalación silenciosa. El archivo de respuestas de cada funciónde servidor podría no tener todas las secciones que se describen en el siguienteprocedimiento.

Procedimiento1. Asegúrese de que el sistema de archivos utilizado para almacenar los

componentes de IBM Cognos Business Intelligence Server está montado.2. Para generar un archivo de respuestas para una instalación desatendida, vaya

al directorio raíz de instalación y escriba el comando siguiente:./issetup -ats <nombre_archivo>

Por ejemplo, vaya al directorio /pathprefix/usr/lpp/cognos/BI_installer_10.2.0/cgcbisrv/IBM/zos64 y escriba el comando siguiente:/user/lpp/home/response.ats

Nota: La ubicación del archivo issetup depende de la función del servidor queestá instalando. El ejemplo anterior utiliza el servidor de IBM Cognos BI. Paragenerar un archivo de respuestas para los ejemplos de IBM Cognos BI, laubicación del archivo issetup es /prefijoruta/usr/lpp/cognos/BI_installer_10.2.0/cgcbismp/IBM/zos64.

3. Abra el archivo de respuestas que puede generar en un editor de texto.Cada sección del archivo de respuestas corresponde a un cuadro de diálogo deuna sesión interactiva de instalación. Cada sección de un archivo de respuestasempieza por una línea, entre corchetes, que especifica el número del cuadro dediálogo, seguida de un título que especifica el nombre de la sección.

4. En la sección [Dialog1], compruebe que haya un "1" junto al código de idiomaque desea utilizar.

5. En las secciones [Dialog2] y [Dialog3], junto a la variable I Agree, compruebeque la aceptación del acuerdo de licencia y de las condiciones que no son deIBM, si los hay, tiene el valor "y".Al modificar el valor de I Agree por "y" o al asegurarse de que este es el valorutilizado, acepta las condiciones del acuerdo de licencia y las condiciones queno son de IBM.Por ejemplo: I Agree=y

6. En la sección [Dialog4], junto a la variable APPDIR, especifique la ubicación deinstalación donde se instalará el producto.


Determinado software, como los ejemplos de IBM Cognos BI e IBM CognosSupplementary Languages Documentation, debe instalarse en la mismaubicación que el componente de pasarela del servidor de IBM Cognos BI. IBMCognos Software Development Kit debe estar instalado en cada ubicación en laque haya un componente de servidor de IBM Cognos. Por ejemplo:APPDIR=//pathprefix/usr/lpp/cognos/BI_10.2.0

7. Si va a instalar en el mismo directorio en el que está el software IBM Cognos BIexistente y desea crear una copia de seguridad, escriba "1" junto a la variableBackup.Por ejemplo: Backup=1

8. En la sección [Component List], escriba '1" junto a los componentes que deseainstalar.Si no desea instalar un componente, asigne el valor "0".

9. Guarde los cambios que ha realizado en el archivo de respuestas.

Ejecución del programa de instalación de IBM Cognos enmodo silencioso

Ejecute el instalador de IBM Cognos en modo silencioso. Registre las respuestas alas opciones de instalación en el archivo de respuestas.

Antes de empezar

Asegúrese de efectuar las tareas siguientes:v Para cada instalación, ha generado y modificado un archivo de respuestas

adaptado a su entorno.v Establezca la variable de entorno _BPXK_AUTOCVT en ON.v Establezca la variable de entorno _CEE_RUNOPTS en el valor siguiente:

POSIX(ON), FILETAG(AUTOCVT, AUTOTAG).v Asegúrese de que la variable de entorno LIBPATH contiene el directorio

/usr/lib.Por ejemplo: /usr/lib:${LIBPATH}El instalador de IBM Cognos requiere el archivo Xm_31.dll. De lo contrario, esposible que vea el mensaje de error siguiente.CEE3501S No se ha encontrado el módulo Xm_31.dll.

No se ha podido determinar la información de rastreo.


Cada una de las funciones de servidor de IBM Cognos tiene un programa deinstalación y un archivo de respuestas. El archivo de respuestas se utiliza comoentrada para la instalación silenciosa.

Procedimiento1. Vaya al HFS donde SMP/E ha instalado los archivos de instalación para el

servidor de IBM Cognos BI.Por ejemplo, el HFS predeterminado es ea ubicación siguiente:/prefijoruta/usr/lpp/cognos/BI_installer_10.2.0/cgcbisrv/

2. Localice el archivo response.ats en la raíz de la carpeta de instalación.3. En el indicador de comandos, escriba el comando siguiente:

v Para ejecutar el programa de instalación mediante un archivo de respuestas,escriba el comando siguiente:


./issetup -s ubicación/response.ats

v Para visualizar el resultado del progreso de la instalación en la pantalla,escriba el siguiente comando:./issetup -s ubicación/response.ats -displayLog

Para ver las opciones para ejecutar el programa de instalación en modosilencioso, escriba el siguiente comando:./issetup -h .La variable ubicación es el directorio donde ha copiado el archivo de respuestas(response.ats) que desea utilizar. Por ejemplo, para utilizar un archivotest.ats en el directorio inicial del usuario de cogadmin, escriba el comandosiguiente:./issetup -s /user/lpp/home/cogadmin/test.ats

Resultados

El código de salida (estado de retorno) indica que el programa de instalación se haejecutado correctamente.v Devuelve un estado de cero (0).

La instalación se ha realizado correctamente.v Devuelve un estado distinto a cero (0).

Si se devuelve un estado de retorno distinto a cero (0), compruebe si haymensajes de error en los archivos de registro. Los errores se graban en eldirectorio ubicación_c10/instlog en un archivo de registro de errores deresumen. El formato del nombre del archivo es tl-código_producto-versión-aaaammdd-hhmm_summary-error.txt.Si sucede algún error antes de que se produzca suficiente inicialización, losmensajes de registro se envían a un archivo de registro en el directorio Temp. Elformato del archivo es tl-código_producto-versión-aaaammdd-hhmm.txt.

v Mensaje de error de licencia no aceptada.Si se muestra el mensaje de error siguiente, asegúrese de que el archivo estécodificado en ASCII.DS_MSG_PREFIXIDS_COPYRIGHT_LOGOIDS_MSG_START_INSTALL_UNATTENDEDIDS_MSG_PREFIXIDS_MSG_READ_ARCHIVE Licencia no aceptadaen el archivo de respuestas "/u/cognos/c10/response.ats".La instalación no puede continuar.

Por ejemplo, para codificar el archivo, utilice el comando siguiente:chtag -t -cISO8859-1 /u/cognos/c10/response.ats


Repita estos pasos para el resto de las instalaciones utilizando los archivos derespuestas adecuados. Asegúrese de instalar los componentes en las ubicacionesnecesarias:v Instale IBM Cognos Software Development Kit en el mismo directorio que cada

componente de servidor de IBM Cognos BIv Instale los ejemplos de IBM Cognos e IBM Cognos Supplementary Languages

Documentation en el mismo directorio que el componente de pasarela delservidor de IBM Cognos BI.

v Instale IBM Cognos Transformer en un directorio diferente al de los otroscomponentes del servidor de IBM Cognos BI.


v Instale Cognos Connection Installer for Insight en la misma ubicación que loscomponentes de nivel de aplicación de IBM Cognos y que el componente depasarelaInstale el componente Cognos Insight BI Integration donde estén instalados loscomponentes de nivel de aplicación. Instale el componente Cognos Insight BIIntegration Gateway donde esté instalado el componente de pasarela.Asegúrese de que el administrador de BI asigna a todos los usuarios que debeninstalar Cognos Insight el rol Enhanced Consumer. El rol Enhanced Consumercorresponde a la prestación Panel de control ejecutivo que se asigna en IBMCognos Administration. Para obtener más información acerca de cómo asignarprestaciones, consulte la publicación IBM Cognos Business Intelligence Guía deadministración y seguridad.

Cuando las instalaciones hayan finalizado, puede que sea necesario realizaralgunas tareas posteriores a la instalación antes de configurar el producto.Conceptos relacionados:“Opción para ver el estado de las instalaciones silenciosas en la pantalla” en lapágina 4Puede utilizar la opción -displayLog para ver el estado de la instalación silenciosaen la pantalla.“IBM Cognos Connection Installer for Cognos Insight” en la página 2Utilice IBM Cognos Connection Installer for Cognos Insight para instalar softwarede suministro en los servidores de Cognos Business Intelligence. De este modo,varios usuarios podrán instalar Cognos Insight en sus sistemas desde la interfaz deCognos Business Intelligence.“Instalaciones de IBM Cognos Business Intelligence” en la página 21La forma más sencilla y rápida forma de ejecutar IBM Cognos Business Intelligencefor z/OS en su entorno es asegurarse de que una instalación básica funciona antesde añadir o configurar los componentes opcionales. Una instalación básica de IBMCognos BI requiere un servidor web, un almacén de contenido y componentes deservidor de IBM Cognos BI (pasarela, nivel de aplicación y Content Manager).Tareas relacionadas:“Revisión de los requisitos de hardware y software para los componentes deWindows” en la página 111Antes de instalar los componentes de Windows, asegúrese de que tiene suficientesrecursos del sistema en el entorno para los modelos.

Instalación de IBM Cognos MobileIBM Cognos Mobile se debe instalar en la misma ubicación que el servidor de IBMCognos Business Intelligence.

Antes de instalar el componente, debe modificar un archivo en la instalación delservidor BI.

Añadir una instalación base para IBM Cognos MobilePara poder instalar IBM Cognos Mobile, debe añadir una instalación base alarchivo uninst.ini en el directorio de instalación de IBM Cognos BI.

Procedimiento1. Vaya al directorio ubicación_c10/uninstall.2. Edite el archivo uninst.ini para incluir los componentes de IBM Cognos

Mobile en la sección [Component List].


COGMOB_APP=1COGMOB_SRVR=1COGMOB_CLIENT=1MOBILESERVER_VERC=1MOBILECLIENT_VERC=1


Genere y modifique el archivo de respuestas para IBMCognos Mobile

Genere y modifique un archivo de respuestas para especificar y registrar suspreferencias de instalación.

Procedimiento1. Asegúrese de que se ha montado el sistema de archivos que se utiliza para

almacenar los componentes de IBM Cognos Mobile.2. Para generar un archivo de respuestas para una instalación desatendida, vaya

al directorio raíz de instalación: /pathprefix/usr/lpp/cognos/HCGCA20/installer/cgc_biext/IBM/zos64.

3. escriba el siguiente mandato:./issetup -ats <nombre_archivo>

4. Abra el archivo de respuestas que ha generado en un editor de texto.Cada sección del archivo de respuestas corresponde a un cuadro de diálogode una sesión interactiva de instalación. Cada sección de un archivo derespuestas empieza por una línea, entre corchetes, que especifica el númerodel cuadro de diálogo, seguida de un título que especifica el nombre de lasección.

5. En la sección [Dialog1], compruebe que haya un "1" junto al código deidioma que desea utilizar.

6. En las secciones [Dialog2] y [Dialog3], junto a la variable I Agree, asegúresede que el valor está establecido en "y".Al modificar el valor de I Agree por "y" o al asegurarse de que este es elvalor utilizado, acepta las condiciones del acuerdo de licencia y lascondiciones que no son de IBM.Por ejemplo: I Agree=y

7. En la sección [Dialog4], junto a la variable APPDIR, entre la ubicación deinstalación donde ya está instalado el servidor de IBM Cognos BI.IBM Cognos Mobile incluye los componentes de nivel de aplicación y loscomponentes de pasarela. Si está distribuyendo componentes, asegúrese deinstalar la pasarela de IBM Cognos Mobile en la ubicación donde ha instaladola pasarela de servidor de IBM Cognos BI y los Componentes de nivel deaplicación de IBM Cognos Mobile en la ubicación donde ha instalado losComponentes de nivel de aplicación de IBM Cognos BI. Por ejemplo:APPDIR=//pathprefix/usr/lpp/cognos/BI_10.2.0

8. Si va a instalar en el mismo directorio en el que está el software IBM CognosBI existente y desea crear una copia de seguridad, escriba "1" junto a lavariable Backup.Por ejemplo: Backup=1

9. En la sección [Component List], escriba "1" junto a los componentes que deseainstalar.Si no desea instalar un componente, asigne el valor "0".IBM Cognos Mobile incluye los componentes siguientes:


v COGMOB_APP

v COGMOB_SRVR

v COGMOB_CLIENT

En una instalación distribuida, debe instalar COGMOB_APP en la ubicación dondeha instalado los componentes de nivel de aplicación de servidor de IBMCognos BI. Los componentes COGMOB_SRVR y COGMOB_CLIENT se deben instalardonde ha instalado el componente de pasarela de servidor de IBM Cognos BI.

10. Guarde los cambios y cierre el archivo.

Instalar IBM Cognos Mobile en modalidad silenciosaEjecute el instalador de IBM Cognos en modo silencioso.

Procedimiento1. Vaya a HFS donde SMP/E ha instalado los archivos de instalación para IBM

Cognos Mobile. Por ejemplo, el HFS predeterminado es la ubicación siguiente:/pathprefix/usr/lpp/cognos/HCGCA20/installer/cgc_biext/IBM/zos64

2. En el indicador de comandos, escriba el comando siguiente:v Para ejecutar el programa de instalación utilizando el archivo de respuestas

que ha creado, escriba el mandato siguiente:./issetup -s ubicación/response.ats

v Para visualizar el resultado del progreso de la instalación en la pantalla,escriba el siguiente comando:./issetup -s ubicación/response.ats -displayLog

Verificación de la instalación de los componentes de servidor de IBMCognos y los permisos de archivo

Para asegurarse de que los componentes de servidor de IBM Cognos BusinessIntelligence se han instalado correctamente, puede ver la estructura de directoriosde la instalación y los permisos de archivo en UNIX System Services. Confirmeque los privilegios de usuario sobre los directorios en los que hay contenidodesplegado o en los que se colocarán los archivos temporales sean los adecuados.

Procedimiento1. En UNIX System Services, inicie la sesión como el usuario que ejecuta la

instalación de IBM Cognos.Para mayor simplicidad, normalmente la cuenta de usuario del servidor deaplicaciones también se utiliza para ejecutar los componentes de IBM Cognos.

2. Vaya al directorio ubicación_c10.3. Para ver la propiedad y los permisos de todos los subdirectorios, escriba el

siguiente comando:ls -al

4. Verifique que el grupo mostrado es el grupo cognos.5. Compruebe que el directorio tiene los permisos drwxrwxr-x.6. Verifique la versión de Java que se está utilizado para IBM Cognos BI for z/OS.

a. Asegúrese de que el directorio JAVA_HOME/bin esté incluido en la variablePATH.

b. Escriba el siguiente comando:java -version


Adición de componentes de servidor a una instalación existente en elsistema z/OS

Puede añadir los componentes de IBM Cognos a una instalación existente. Porejemplo, después de verificar que una instalación básica funciona, puede instalarsoftware opcional, tal como IBM Cognos Dynamic Cubes o IBM Cognos SoftwareDevelopment Kit. En algunas situaciones, por motivos de rendimiento o deseguridad, puede que desee instalar instancias adicionales de componentes deservidor de IBM Cognos Business Intelligence, tales como la pasarela o ContentManager en espera.

Procedimiento1. Si su producto IBM Cognos Business Intelligence se está ejecutando, detenga

los servicios de IBM Cognos.2. Vaya al HFS donde SMP/E ha instalado los archivos de instalación para el

servidor de IBM Cognos BI.Por ejemplo, el valor predeterminado de HFS es/prefijoruta/usr/lpp/cognos/BI_installer_10.2.0/cgcbisrv/

3. Localice el archivo response.ats en la raíz de la carpeta de instalación.4. En el indicador de comandos, escriba el comando siguiente:

./issetup -s ubicación/response.ats

El parámetro ubicación es el directorio donde ha copiado el archivo derespuestas (response.ats) que desea utilizar.

5. Si es necesario, configure el componente para comunicarse con los componentesde servidor existentes.Para obtener más información, consulte los pasos de configuración delcomponente.

6. Para volver a establecer el producto IBM Cognos Business Intelligence enestado de servicio, guarde la configuración e inicie el servicio de IBM Cognos.

Desinstalación de componentes de servidor de IBM Cognos BI en elsistema z/OS

Para eliminar componentes de servidor de IBM Cognos Business Intelligence deUNIX System Services, utilice el programa de desinstalación.

Antes de empezar

Si ejecuta aplicaciones de IBM Cognos BI en WebSphere Application Server, utilicela consola administrativa para detener la aplicación si está en ejecución y retire eldespliegue de la parte de Java de los componentes de IBM Cognos BI. Puede queel servidor de aplicaciones no elimine completamente todos los directorios oarchivos de las aplicaciones desplegadas al retirar el despliegue; por lo tanto, talvez tenga que realizar esta acción manualmente.

Procedimiento1. Detenga los procesos de IBM Cognos BI.

v Determine el PID (identificador de proceso) del proceso de IBM Cognos BIescribiendo el mandato siguiente: ps -ef | grep cogbootstrapservice.

v Escriba el mandato siguiente: kill -TERM pid

2. Vaya al directorio ubicación_c10/uninstall.


3. Abra el archivo denominado uninst.ini en un editor de texto.4. En la sección denominada [Package List] (Lista de paquetes), entre 1 para cada

componente que desee desinstalar. Entre 0 si desea dejar el componenteinstalado. De forma predeterminada, está establecida la eliminación de todoslos componentes instalados.

Tabla 29. Códigos de paquete. En la tabla siguiente se describen los paquetes listados enla sección [Package List]:

Código de paquete Producto

BISRVR Servidor de IBM Cognos BI

BISAMPLES Ejemplos

LP Supplementary Languages Documentation

BITRSFRMR IBM Cognos BI Transformer

SDK IBM Cognos Software Development Kit

5. Guarde y cierre el archivo.6. Vaya al directorio ubicación_c10/uninstall y ejecute el mandato siguiente:

./uninst -u -s

Resultados

La desinstalación no elimina ningún archivo que haya cambiado desde lainstalación, como los archivos de datos de usuario y configuración. La ubicación deinstalación se conserva, y estos archivos se conservarán hasta que los suprima.


Capítulo 7. Tareas posteriores a la instalación en z/OS UNIXSystem Services

Después de instalar, pero antes de configurar, debe configurar su entorno z/OSUNIX System Services para asegurarse de que los recursos u otro software que seutiliza en el sistema z/OS pueda comunicarse con los componentes de IBMCognos Business Intelligence.

Actualización del entorno de Java en el sistema z/OS después de lainstalación

Después de la instalación del servidor de IBM Cognos Business Intelligence en elsistema z/OS, asegúrese de que las variables de entorno que están relacionadascon el entorno de Java están definidas.

Procedimiento1. Asegúrese de establecer en ON la variable de entorno

IBM_JAVA_ENABLE_ASCII_FILETAG.El sistema z/OS utiliza la codificación de caracteres EBCDIC. Sin embargo, IBMCognos BI crea archivos, como por ejemplo los mensajes de registro, que debenestar codificados como archivos de texto ASCII.

2. Asegúrese de que la variable de entorno JAVA_HOME está establecida en laubicación de JRE.Si utiliza WebSphere Application Server, establezca JAVA_HOME en el JRE quese entrega con dicho producto.

Configuración de un sistema X Windows para el acceso remotoIBM Cognos Configuration es una herramienta de configuración gráfica. Debetener software del sistema WindowsX capaz de presentar una interfaz gráfica deusuario si desea utilizar IBM Cognos Configuration para configurar IBM Cognos BIfor z/OS.


A menos que tenga la intención de realizar una configuración manual en la queeditará los archivos de configuración, debe configurar los componentes de servidorde IBM Cognos BI desde un sistema en el que esté instalado el software deservidor X. Debe habilitar el host remoto (el sistema z/OS ) para dirigir la salida ala pantalla local.

Procedimiento1. Inicie la sesión en el sistema de visualización (es decir, el que mostrará la

interfaz gráfica de usuario).2. Abra una ventana de terminal y utilice Telnet o SSH para conectarse al sistema

z/OS donde están instalados los componentes de IBM Cognos BI.3. Para acceder a IBM Cognos Configuration en z/OS y permitir que se muestre

su interfaz de usuario, establezca la variable de entorno DISPLAY.Por ejemplo, escriba export DISPLAY=nombre_host:número_pantalla.


Nombre_host es la dirección IP del sistema que mostrará la interfaz gráfica deusuario.

4. Establezca la variable de entorno LANG en C.Por ejemplo, escriba export LANG=C.La variable de entorno garantiza que el sistema operativo pueda localizar elconjunto de programas de utilidad de lenguaje que contiene el archivo cat X11.

Resultados

El cliente X remoto (el sistema z/OS) establece una conexión con el sistema local(el servidor X) y proporciona la pantalla.

Inicio de IBM Cognos Configuration en z/OS UNIX SystemServices

Utilice IBM Cognos Configuration para configurar componentes y para iniciar ydetener servicios.

Antes de empezar

Asegúrese de establecer todas las variables de entorno, tales como JAVA_HOME.Asegúrese de que ha copiado todos los archivos necesarios, como los archivos delcontrolador JDBC, en la instalación de IBM Cognos.

Procedimiento1. Para conectar con la instalación de IBM Cognos Business Intelligence, utilice un

programa que proporciona inicios de sesión de la interfaz gráfica (GUI) remota.IBM Cognos Configuration está basado en la interfaz de usuario.

2. Inicie la sesión como el usuario que es propietario de des archivos deinstalación.

3. Vaya al directorio ubicación_c10/bin64 y escriba ./cogconfig.sh.Si IBM Cognos Configuration no se abre, asegúrese de que ha establecido lavariable de entorno DISPLAY.Si ve un mensaje JAVA.Lang.unsatisfied link, verifique que está utilizandouna versión soportada de Java.Si ve un mensaje Java.lang.unsupportedClassVersionError, asegúrese de queestá utilizando una versión de 64 bits de Java.

Base de datos del almacén de contenidoEl almacén de contenido es una base de datos que Content Manager utiliza paraalmacenar datos y valores de configuración global, como el idioma y los formatosde moneda mostrados en la interfaz de usuario, la información de conexión deorigen de datos y el contenido específico del producto.

Los modelos de diseño y los archivos de registro no se almacenan en el almacén decontenido.

Tipos de bases de datos para el almacén de contenido

Debe crear el almacén de contenido para poder utilizar el producto. Puede utilizaruna de las bases de datos siguientes para el almacén de contenido:


Tabla 30. Tipos de bases de datos, codificación de caracteres y protocolos para el almacénde contenido

Base de datosCodificación decaracteres

Identificador dejuego de caracterescodificados (CCSID) Protocolo

DB2 para z/OS UTF-8 Unicode TCP/IP

Cognos ContentDatabase

preconfigurado n/a preconfigurado

Cognos Content Database se puede instalar y configurar como la base de datos delalmacén de contenido predeterminada en un solo sistema de prueba o de pruebade concepto. Si tiene previsto utilizar Cognos Content Database como almacén decontenido en un entorno de prueba, debe seleccionarlo durante la instalación. Trasfinalizar la instalación, se crea y se configura una base de datos.

No utilice Cognos Content Database en un entorno de producción.

Secuencia de ordenación

IBM Cognos Business Intelligence for z/OS utiliza un único orden de clasificaciónque especifica las reglas que utiliza la base de datos para interpretar, recopilar,comparar y presentar los datos de caracteres. Por ejemplo, un orden declasificación define si la letra A es menos que, igual a o mayor que la letra B; si laordenación distingue mayúsculas y minúsculas y si la ordenación distingue entrecaracteres acentuados y no acentuados. Para obtener más información acerca de laordenación y las secuencias de ordenación, consulte la documentación de la basede datos.

Creación de una base de datos del almacén de contenido enDB2 para z/OS

La base de datos DB2 que cree en el sistema z/OS para el almacén de contenidodebe contener los valores de configuración especificados.

Como alternativa, puede crear un almacén de contenido mediante un script DDL(lenguaje de definición de datos) que se genera desde IBM Cognos Configuration.Puede generar el archivo DDL al crear espacios de tabla para el almacén decontenido DB2.

Procedimiento1. Cree una base de datos, un grupo de almacenamiento y una cuenta de usuario

para el almacén de contenido.Debe tener autorización de administrador del sistema (SYSADM) o de control delsistema (SYSCTRL) para crear la base de datos.

2. Asegúrese de que el sistema de base de datos tiene el siguiente almacenamientovirtual:v Una agrupación de búferes con un tamaño de página de 32 KB.v Una segunda agrupación de búferes con un tamaño de página de 16 KB.

3. Asegúrese de que la base de datos tiene UNICODE como CCSID.4. Asegúrese de que el administrador de base de datos otorga los derechos

CONNECT, CREATEIN y CREATE TABLE o que otorga DBADM al usuarioque gestiona la base de datos del almacén de contenido.

Capítulo 7. Tareas posteriores a la instalación en z/OS UNIX System Services 61

Por ejemplo, para otorgar DBADM al usuario CGCUSERGRANT CREATETAB ON DATABASE CMDB101 TO CGCUSER

a. Asegúrese de que el usuario tiene privilegios para crear un índice en lasagrupaciones de búferes que se crearon y se reservaron al crear la base dedatos del almacén de contenido.Por ejemplo:GRANT USE OF BUFFERPOOL BP2 TO CGCUSER

b. Asegúrese de que el usuario tiene privilegios para crear un índice en ungrupo de almacenamiento que se haya creado al crear la base de datos delalmacén de contenido.Por ejemplo:GRANT USE OF STOGROUP SGDBT1DT TO CGCUSER


El administrador de base de datos debe realizar una copia de seguridad delalmacén de contenido con regularidad, ya que contiene la información deseguridad y aplicación de datos de IBM Cognos Business Intelligence. Paragarantizar la seguridad y la integridad de la base de datos de almacén decontenido, protéjala frente a accesos no autorizados o inapropiados.Tareas relacionadas:“Creación de espacios de tabla para un almacén de contenido en DB2 para z/OS”El administrador de base de datos deberá ejecutar scripts para crear un conjuntode espacios de tabla necesarios para la base de datos de almacén de contenido.Deberá modificar los scripts para sustituir los parámetros de marcador de posiciónpor los que sean apropiados para el entorno.

Creación de espacios de tabla para un almacén de contenidoen DB2 para z/OS

El administrador de base de datos deberá ejecutar scripts para crear un conjuntode espacios de tabla necesarios para la base de datos de almacén de contenido.Deberá modificar los scripts para sustituir los parámetros de marcador de posiciónpor los que sean apropiados para el entorno.

De forma predeterminada, el almacén de contenido se utiliza para notificaciones,tareas humanas y anotaciones. Puede crear bases de datos por separado para cadauna de ellas.


Asegúrese de que utiliza las convenciones de nomenclatura para DB2 en z/OS. Porejemplo, todos los nombres de parámetros deben comenzar por una letra y nodeben tener más de ocho caracteres. Existen dos excepciones al límite de longitudde caracteres:v CMSCRIPT_CS_ID no tiene más de 2 caracteres.v CMSCRIPT_TABLESPACE no tiene más de 6 caracteres.

El motivo de la excepción es que cuando dos parámetros se concatenan, lalongitud de caracteres no puede superar los 8.

Para obtener más información, consulte el Information Center de IBM DB2.


Procedimiento1. Conéctese a la base de datos como un usuario que tenga privilegios para crear

y descartar espacios de tabla y permitir la ejecución de sentencias SQL.2. Vaya al directorio que contenga los scripts:

ubicación_c10/configuration/schemas/content/db2zOS

3. Haga una copia de seguridad del archivo de script tablespace_db2zOS.sql yguarde el archivo en otra ubicación.

4. Abra el archivo de script tablespace_db2zOS.sql original.a. Añada una sentencia de conexión al principio del script.

Por ejemplo:connect to databasename;

b. Utilice la tabla siguiente como ayuda para sustituir los parámetros genéricospor otros adecuados a su entorno.No todos los parámetros enumerados se encuentran en el script, aunquealgunos se pueden añadir en el futuro.

Tabla 31. Nombres de parámetros y descripción para el script de espacios de tabla dealmacén de contenido


CMSCRIPT_STOGROUP Especifica el nombre del grupo de almacenamiento.

CMSCRIPT_DATABASE Especifica el nombre de la base de datos del almacénde contenido.

CMSCRIPT_CS_ID Especifica la identificación del subsistemacorrespondiente a la base de datos del almacén decontenido.

El identificador no debe tener más de dos caracteres.

CMSCRIPT_TABLESPACE Especifica el nombre del espacio de tabla quecontiene todas las tablas base en el almacén decontenido.

No se incluyen las tablas auxiliares.

El nombre no puede tener más de 6 caracteres.

CMSCRIPT_LARGE_BP Especifica el nombre de la agrupación de búferes másgrande asignada para objetos especialmente grandes.


CMSCRIPT_REGULAR_BP Especifica el nombre de la agrupación de búferes detamaño normal asignada para los objetos normales ygrandes.


CMSCRIPT_USERNAME Especifica la cuenta de usuario que accede a la basede datos del almacén de contenido.

5. Guarde y ejecute el script.


Por ejemplo, si configura el archivo clp.properties y su alias de DB2 en superfil o el archivo de script tcshrc, escriba el comando siguiente para ejecutarel script:db2 -tvf tablespace_db2zOS.sql

6. Otorgue los derechos de usuario de IBM Cognos a los espacios de tabla que secrearon cuando se ejecutó el archivo de script tablespace_db2zOS.sql:a. Haga una copia del archivo de script rightsGrant_db2zOS.sql en otra

ubicación.b. En la herramienta de acceso remoto, abra el archivo de script

rightsGrant_db2zOS.sql original y reemplace los parámetros del marcadorde posición por los valores apropiados para su entorno.Asegúrese de que usa los mismos valores que empleó al asignar recursos alas agrupaciones de búferes y a la cuenta de usuario.

c. Añada una sentencia de conexión al principio del script.Por ejemplo:connect to databasename;

d. Guarde y ejecute el script.Por ejemplo:db2 -tvf rightsGrant_db2zOS.sql

7. Para crear los espacios de tabla de notificaciones, vaya al directorioubicación_c10/configuration/schemas/delivery/zosdb2.a. Haga una copia de seguridad del archivo de script NC_TABLESPACES.sql y

guarde el archivo en otra ubicación.b. Abra el archivo de script NC_TABLESPACES.sql original y utilice la tabla

siguiente para que le sea más fácil reemplazar los parámetros de marcadorde posición por los adecuados para el entorno.






No todos los parámetros enumerados se encuentran en el script, pero sepueden añadir en el futuro.

c. Guarde y ejecute el script.Por ejemplo:db2 -tvf NC_TABLESPACES.sql

d. Abra el archivo de script NC_CREATE_DB2.sql y sustituya el parámetro demarcador de posición NCCOG por el nombre de la base de datos denotificaciones.

e. Guarde el script.El servicio Job and Schedule Monitoring Service ejecutará automáticamenteel script. Sin embargo, puede optar por ejecutarlo cuando lo desee.

8. Para crear los espacios de tabla de tareas humanas, vaya al directorioubicación_c10/configuration/schemas/hts/zosdb2.


a. Haga una copia de seguridad del archivo de script hts_tablespaces.sql yguarde el archivo en otra ubicación.

b. Abra el archivo de script HTS_TABLESPACES.sql original y utilice la tablasiguiente como ayuda para sustituir los parámetros genéricos porparámetros adecuados para el entorno.






Consulte el script para obtener una lista completa de los parámetrosnecesarios.

c. Guarde y ejecute el script.d. Abra el archivo de script HTS2_CREATE_Db2zos.sql y utilice la tabla siguiente

para que le sea más fácil reemplazar los parámetros genéricos por losadecuados para el entorno.



NCCOG El nombre de la base de datos.


e. Guarde y ejecute el script.9. Para crear los espacios de tabla de anotaciones, vaya al directorio

ubicación_c10/configuration/schemas/ans/zosdb2.a. Haga una copia de seguridad del archivo de script ANN_TABLESPACES.sql y

guarde el archivo en otra ubicación.b. Abra el archivo de script ANN_TABLESPACES.sql original y utilice la tabla

siguiente como ayuda para sustituir los parámetros genéricos porparámetros adecuados para el entorno.

Tabla 35. Nombres y descripciones de parámetros de espacios de tabla para anotacionesen DB2 para z/OS



DSN8G810 Nombre del grupo de almacenamiento

BP32K El nombre de la agrupación dealmacenamientos intermedios de 32 k.


c. Guarde y ejecute el script.


d. Abra el archivo de script ANS2_CREATE_Db2zos.sql y utilice la tabla siguientepara que le sea más fácil reemplazar los parámetros genéricos por losadecuados para el entorno.





e. Guarde y ejecute el script.Tareas relacionadas:“Creación de espacios de tabla para una base de datos de notificaciones en DB2para z/OS” en la página 129Si está utilizando DB2 para z/OS, un administrador de base de datos debe ejecutarscripts para crear un conjunto de espacios de tabla necesario para la base de datosde notificaciones. Los scripts deben modificarse para sustituir los parámetros demarcador por otros que sean apropiados para el entorno.“Creación de espacios de tabla para la base de datos de Human Task andAnnotation en DB2 en z/OS” en la página 185Si está utilizando DB2 para z/OS, un administrador de base de datos debe ejecutarscripts para crear los espacios de tabla necesarios en la base de datos de HumanTask and Annotation. El script debe modificarse para sustituir los parámetros demarcador de posición por los que sean apropiados para el entorno.

Configuración de la conectividad para la base de datos delalmacén de contenido

Para que Content Manager acceda a una base de datos del almacén de contenidoDB2, debe instalar controladores JDBC de tipo 4 en cada ubicación donde estáinstalado Content Manager.

Procedimiento1. Si desea crear un enlace simbólico al controlador y los archivos de licencia,

asegúrese de que tiene permiso de escritura en el directorio en el que reside elenlace.a. Para crear un enlace simbólico con el archivo del controlador universal,

db2jcc.jar, escriba el comando siguiente:ln -s $JDBCCLASSES/db2jcc.jar

c10_location/webapps/p2pd/WEB-INF/lib/db2jcc.jar

b. Para crear un enlace simbólico con el archivo de licencia,db2jcc_license_cisuz.jar, escriba el comando siguiente:ln -s $JDBCCLASSES/db2jcc_license_cisuz.jar

c10_location/webapps/p2pd/WEB-INF/lib/db2jcc_license_cisuz.jar

2. Si desea copiar los archivos de controlador y de licencia, en la instalación deDB2, vaya al directorio donde se encuentran el controlador JDBC y los archivosde licencia.Por ejemplo, el directorio $DB2HOME/db2910_jdbc/classes.

3. Copie los archivos siguientes en el directorio ubicación_c10/webapps/p2pd/WEB-INF/lib.v el archivo del controlador universal, db2jcc.jarv el archivo de licencia, db2jcc_license_cisuz.jar, para DB2 en z/OS


Verificación de la conectividad JDBC con el almacén decontenido

Para asegurarse de que la conexión JDBC con el almacén de contenido DB2 se harealizado correctamente, puede probar la conectividad.

Procedimiento1. Para verificar que la versión del controlador JDBC que está utilizando es

correcta, escriba el comando siguiente:java -cp $JDBCCLASSES/db2jcc.jar com.ibm.db2.jcc.DB2Jcc -version

Se muestra la versión.El ejemplo siguiente muestra un ejemplo de la respuesta:IBM DB2 JDBC Universal Driver Architecture 3.63.107

2. Modifique la variable CLASSPATH en el archivo .profile para incluir elarchivo clp.jar.por ejemplo, si instala el procesador de línea de comandos en el directorio/usr/lpp/db2910_base, puede emitir el siguiente comando para modificar lavariable CLASSPATH:export CLASSPATH=$CLASSPATH:/usr/lpp/db2910_base/lib/clp.jar

3. Opcionalmente, puede definir la variable de entorno CLPPROPERTIESFILE enel archivo .profile para incluir el nombre de la ruta completa donde seencuentra el archivo de propiedades.Puede copiar el archivo CLPPROPERTIES en el directorio inicial cognos yutilizarlo. En el directorio en el que se ha instalado el procesador de línea decomandos hay un archivo de propiedades de ejemplo.Emita el comando siguiente para definir la variable de entornoCLPPROPERTIESFILE en el archivo .profile:export CLPPROPERTIESFILE=/usr/lpp/db2910_base/samples/clp.properties

a. Si ha instalado el procesador de línea de comandos en el directorio/usr/lpp/db2910_base, copie en su directorio inicial el archivoclp.properties predeterminado de /usr/lpp/dir_inst_raíz_db2/dir_vers_db2_base/samples/clp.properties.Por ejemplo, copie el archivo clp.properties de la siguiente ubicación:/usr/lpp/db2/db2910/db2910_base/samples

en la ubicación siguiente:/u/user1/

b. Para personalizar el archivo clp.properties para el sistema, abra el archivoen un editor y cambie las líneas de código siguientes:#Create your own alias name for DB2 servers#SERVER1=<URL>,<username>,<password>

La variable URL tiene un formato similar al siguiente:dirección_IP:puerto/NOMBRE_UBICACIÓN

CGCSAMP=<IPaddress>:4741/<DB2LOC>,user-1,password-2

c. Para definir la variable de entorno CLPPROPERTIESFILE en el archivo.profile, emita el comando siguiente:export CLPPROPERTIESFILE=/u/user1/clp.properties

d. En el indicador de comandos, pruebe la conexión escribiendo db2.Por ejemplo, si tiene alias db2 configurado en el archivo .profile o.tcshrc, utilice el comando siguiente:connect to CGCSAMP


Debería ver un mensaje similar al siguiente si la conexión se ha establecidocorrectamente:DSNC101I: El comando "CONNECT" ha finalizado correctamente

e. Recuerde eliminar las credenciales de la base de datos en el archivoclp.properties después de probar la conexión.Las credenciales de la base de datos se almacenan temporalmente en textosin formato en el archivo.

Tareas relacionadas:“Establecimiento de las variables de entorno de JDBC para un almacén decontenido DB2” en la página 230IBM Cognos Business Intelligence for z/OS utiliza la conectividad JDBC paracomunicarse con el almacén de contenido. Debe configurar las variables de entornoadecuadas para habilitar las clases utilizadas por el controlador JDBC.

Base de datos de IBM Cognos MobilePuede utilizar la base de datos del almacén de contenido como base de datos deIBM Cognos Mobile o puede utilizar otra base de datos. Si no utiliza la base dedatos del almacén de contenido como base de datos de IBM Cognos Mobile, utilicelos mismos valores que ha utilizado para la base de datos del almacén decontenido cuando cree la base de datos de IBM Cognos Mobile.

IBM Cognos Mobile necesita una conexión de base de datos independiente en IBMCognos Configuration desde la base de datos del almacén de contenido.

Creación de espacios de tabla para la base de datos deCognos Mobile en DB2 para z/OS

Un administrador de base de datos deberá ejecutar scripts para crear un conjuntode espacios de tabla necesarios para la base de datos de Mobile. Los scripts debenmodificarse para sustituir los parámetros de marcador por otros que seanapropiados para el entorno.

Asegúrese de que utiliza las convenciones de nomenclatura para DB2 en z/OS. Porejemplo, todos los nombres de parámetros deben comenzar por una letra y nodeben tener más de ocho caracteres.

Para obtener más información, consulte el Information Center de IBM DB2.

Procedimiento1. Conéctese a la base de datos como un usuario que tenga privilegios para crear

y descartar espacios de tabla y permitir la ejecución de sentencias SQL.2. Vaya al directorio que contenga los scripts:

ubicación_c10/configuration/schemas/mobile/db2zOS.3. Abra el archivo de script tablespace_db2zOS.sql.4. Añada una sentencia de conexión al principio del script.

Por ejemplo:connect to databasename/

5. Utilice la información siguiente, que le ayudará a reemplazar los parámetrosgenéricos por otros adecuados a su entorno.

COGMOBDBEspecifica el nombre de la base de datos Mobile.


DB0AUSREspecifica el nombre del grupo de almacenamiento.

BP32KEspecifica el nombre de la agrupación de búferes.

6. Guarde y ejecute el script tablespace_db2zOS.sql.Por ejemplo:db2 -td/ -vf tablespace_db2zOS.sql

7. Abra el archivo de script rightsGrant_db2zOS.sql y sustituya los parámetrosde marcador de posición COGMOBDB y MOBUSR por el nombre de base de datos yel nombre de usuario necesarios, respectivamente.

8. Añada una sentencia de conexión al principio del script.Por ejemplo:connect to databasename/

9. Guarde y ejecute el script rightsGrant_db2zOS.sql.Por ejemplo:db2 -td/ -vf rightsGrant_db2zOS.sql

10. Abra el archivo de script initialize-schema-version-table.sql, sustituya elparámetro de marcador de posición COGMOBDB con el nombre de base de datosnecesaria y guarde el script.

11. Abra el archivo de script upgrade-lock-object-init.sql, sustituya losparámetros de marcador de posición COGMOBDB, DB0AUSR y BP32K por losnombres necesarios de base de datos, grupo de almacenamiento y agrupaciónde almacenamiento intermedio y guarde el script.

12. Abra los archivos de script restantes con upgrade y sustituya los parámetrosde marcador de posición COGMOBDB y DB0AUSR por el nombre de base de datosy el nombre de grupo de almacenamiento necesarios, respectivamente.

13. Guarde los scripts, pero no los ejecute manualmente.Los scripts se ejecutarán automáticamente cuando se inicie el servicio deMobile.

Resultados

Se crea la base de datos de Cognos Mobile. Ahora puede especificar la base dedatos de Cognos Mobile en IBM Cognos Configuration.

Configuración de la conectividad JDBC para las bases de datosrelacionales

En IBM Cognos Business Intelligence en z/OS, debe utilizar el modo de consultadinámica para conectarse con las bases de datos relacionales. Instale loscontroladores JDBC de tipo 4 en cada ubicación en la que haya instalado loscomponentes de nivel de aplicación. También puede modificar un archivo deconfiguración para señalar los archivos de controlador JDBC.

Antes de empezar

Para revisar una lista actualizada de los entornos soportados por IBM CognosBusiness Intelligence, consulte la página de entornos de software soportados en elsitio web del centro del cliente de /IBM Cognos (http://www.ibm.com/software/data/cognos/customercenter/).



La tabla siguiente muestra el tipo de origen de datos y la ubicación de los archivosde controlador JDBC.

Procedimiento1. Si el servicio de IBM Cognos se está ejecutando, deténgalo.2. Si no desea modificar el archivo de propiedades, sino que desea instalar los

archivos de controlador JDBC, copie los archivos de controlador JDBC en eldirectorio ubicación_c10/v5dataserver/lib.En DB2 para z/OS, vaya al directorio $DB2HOME/db2910_jdbc/classes y copie elarchivo de controlador universal db2jcc4.jar y el archivo de licenciadb2jcc_license_cisuz.jar.Para obtener información sobre cómo conectar con otros orígenes de datos,consulte la publicación Dynamic Query Analyzer Guía del usuario.

3. Si no desea instalar los archivos de controlador JDBC, en su lugar puedemodificar el archivo de propiedades con la ubicación de los archivos decontrolador JDBC.a. Busque el archivo instalación_c10/v5dataserver/

databaseDriverLocations.properties.sample.b. Cambie el nombre del archivo por databaseDriverLocations.properties.c. En un editor de texto, abra el archivo databaseDriverLocations.properties.d. Siga las indicaciones del archivo para señalar los archivos de controlador

JDBC.4. Inicie el servicio de IBM Cognos.


Cree conexiones de origen de datos que utilicen conectividad JDBC para las basesde datos relacionales. Publique paquetes con la opción de utilizar el modo deconsulta dinámica. Para obtener más información, consulte la publicación IBMCognos Guía de administración y seguridad. Habilite los modelos y paquetes deFramework Manager para que utilicen el modo de consulta dinámica.Conceptos relacionados:“Conectividad JDBC a orígenes de datos y el modo de consulta dinámica” en lapágina 5Puede conectarse a orígenes de datos soportados utilizando la conectividad JavaDatabase Connectivity (JDBC). Cuando se utiliza la conectividad JDBC, el modo deconsulta dinámica está disponible y optimiza las consultas y mejora el rendimiento.

IBM Cognos Business Intelligence for z/OS y la Herramienta deInformes de Subcapacidad de IBM

La Herramienta de Informes de Subcapacidad de IBM (SCRT) es una herramientagratuita de IBM que genera informes sobre la capacidad de licencia necesaria paralos productos candidatos a la subcapacidad que se ejecutan en el sistema z/OS.

Para obtener información sobre SCRT, consulte: Herramienta de Informes deSubcapacidad (SCRT) (http://www.ibm.com/systems/z/resources/swprice/subcap/scrt/). Para obtener información acerca de los precios de software dezSeries, consulte:IBM System z Software Pricing (http://www.ibm.com/servers/eserver/zseries/swprice/).


http://www.ibm.com/servers/eserver/zseries/swprice/scrt/

http://www.ibm.com/servers/eserver/zseries/swprice/scrt/

http://www.ibm.com/servers/eserver/zseries/swprice/

Durante el inicio, IBM Cognos Business Intelligence for z/OS escribe una cadenaen el recurso de gestión del sistema (SMF, System Management Facility). CuandoSCRT procesa los registros SMF, reconoce que Cognos BI for z/OS se ha instaladoy es candidato para el precio de subcapacidad. En los registros SMF, todas lasinstancias de Cognos que se están ejecutando dentro de una LPAR estánidentificadas bajo el mismo ID.

Para utilizar SCRT con el producto, debe estar ya instalado en el entorno z/OSbase. La cadena proporcionada por el producto a la herramienta para los registrosSMF 89 incluye la información siguiente:v Propietario del producto: IBM CORPv Número de producto: 5655-Y26v Nombre de producto: Cognos BI 10.2.0v Versión del producto: Versión 10.2.0v Función del producto: servidor de BI

Para habilitar el producto para SCRT, configure el sistema z/OS para registrar losregistros SMF 89.Tareas relacionadas:“Registro de aplicaciones de Cognos Business Intelligence en WebSphereApplication Server” en la página 86Habilite System Management Facility (SMF) para recopilar información sobreaplicaciones de IBM Cognos Business Intelligence for z/OS, que se ejecutan dentrode WebSphere Application Server.


Capítulo 8. Configuración de los componentes de IBMCognos BI en el sistema z/OS después de la instalación

Para completar la instalación, la configuración y la verificación de los componentesde IBM Cognos Business Intelligence en la mínima cantidad de tiempo, realiceúnicamente los cambios esenciales en los valores predeterminados. Su primerobjetivo es una instalación rápida y sin errores. Posteriormente podrá cambiar losvalores para que se adapten mejor a su entorno.

Instalaciones básicasAntes de personalizar el producto, configure una instalación básica. Instale,configure e inicie una instancia de la pasarela, los componentes de nivel deaplicación y Content Manager en el sistema z/OS, y configure e instale CognosFramework Manager en un sistema Windows.

Después de instalar los componentes necesarios, pero antes de configurarlos, sonnecesarios unos pasos adicionales para que los componentes de IBM Cognospuedan comunicarse con el software en el entorno. Inicialmente, configuresolamente los valores obligatorios para asegurarse de que el producto funciona.

La secuencia en la que inicie los servicios es importante. Primero debe configurarlos servicios donde haya instalado Content Manager y, a continuación, iniciarlos.

Cambios de configuraciónPuede supervisar los cambios de configuración que realice en los componentes deIBM Cognos Business Intelligence.

Cada vez que guarda una configuración después de realizar cambios, se guardanautomáticamente versiones con indicación de fecha y hora de los archivos deconfiguración siguientes en el directorio ubicación_c10/configuration:

Los archivos siguientes registran los cambios:v cogstartup.xml

Este archivo registra los valores de configuración. Un ejemplo de nombre dearchivo es cogstartup_200211231540.xml.

v coglocale.xml

Este archivo registra los valores de entorno local que se utilizan para losinformes multilingües. Un ejemplo de nombre de archivo escoglocale_200211261401.xml.

Si no puede guardar una configuración o si tiene problemas con una configuración,puede revertir a un archivo de configuración anterior. Puede utilizar los archivosde configuración para revisar el historial de configuración.


Capítulo 9. Consideraciones de configuración para desplegarIBM Cognos BI for z/OS en WebSphere Application Server

Para las instalaciones de prueba de IBM Cognos Business Intelligence for z/OSutilice Tomcat como contenedor de servlet. En los despliegues de producción ocorporativos, utilice IBM WebSphere Application Server. Se necesita realizar ciertaconfiguración adicional.

Después de aplicar servicio técnico en el entorno, las aplicaciones de IBM Cognosdeben volverse a desplegar en WebSphere Application Server.

Asignación de espacio de disco para el directorio del perfil deWebSphere

El administrador del sistema z/OS debe asignar suficiente espacio de disco para eldirectorio $WAS_INSTALL_ROOT/profiles/default/installedApps. El directorio debetener una capacidad de 500 MB como mínimo para el despliegue de los archivosde contenido web de IBM Cognos.

Instancias de WebSphere Application Server

Cada instancia de WebSphere Application Server está dividida en dos regiones:v Región de controlador

Esta JVM (Java Virtual Machine) recibe las solicitudes HTTP procedentes de losclientes y luego direcciona estas solicitudes a un gestor de carga de trabajo.

v Región de sirvienteEsta JVM selecciona y ejecuta el trabajo del gestor de carga de trabajo. El gestorde carga de trabajo se inicia y detiene el sirviente. El sirviente contiene losservlets de IBM Cognos BI.

El gestor de carga de trabajo envía las solicitudes a la JVM sirviente que contieneel código de las aplicaciones de IBM Cognos BI.

El sirviente se basa en la región de controlador para numerosos servicios, como,por ejemplo, la comunicación, la seguridad y el control de las transacciones.

Escalado de las aplicaciones - Gestor de carga de trabajo yasignadores de IBM Cognos

Los asignadores de IBM Cognos gestionan la distribución de las solicitudes. Elasignador inicia los servicios de IBM Cognos que procesan las solicitudes y lasdireccionan al servicio adecuado. El asignador es una aplicación de variossubprocesos que utiliza uno o más subprocesos por solicitud.

El esquema de equilibrio de carga del asignador es un algoritmo estático. Puedeespecificar un peso para cada asignador. Un asignador con un peso de 2 puedehacer el doble de trabajo que un asignador con un peso de 1, etc. Cada asignadordistribuye el trabajo entre todos los asignadores utilizando un algoritmo de rondarecíproca ponderado. Para obtener más información, consulte la publicación Guíade administración y seguridad.


Aunque el gestor de carga de trabajo normalmente gestiona el número de procesossirviente de forma dinámica, se producirán conflictos si se utiliza el gestor de cargade trabajo para gestionar la carga de las solicitudes de IBM Cognos BI. Losasignadores de IBM Cognos BI están diseñados para equilibrar la carga de lassolicitudes entrantes.

Importante: Establezca en 1 el número mínimo y máximo de sirvientes que elgestor de carga de trabajo gestiona.

Una sola instancia de IBM Cognos BI desplegada en WebSphereApplication Server

Cada instancia de WebSphere Application Server tiene una región de controlador yuna región de sirviente y escucha las solicitudes de IBM Cognos BI en un puertodedicado.

Si necesita varios procesos del servidor de informes de IBM Cognos para gestionarlas solicitudes, el asignador de IBM Cognos inicia los procesos.

Debe impedir que WebSphere Application Server y el gestor de carga de trabajo seescalen e inicien otra región sirviente durante la configuración.

En el diagrama siguiente se muestra una única instancia de IBM Cognosdesplegada en WebSphere Application Server

Varias instancias de IBM Cognos BI desplegadas en WebSphereApplication Server

Puede configurar instancias de WebSphere Application Server adicionales, cadauna de las cuales tendrá una región de controlador que gestionará un sirviente.

Cada región sirviente contiene un componente de IBM Cognos BI.

Cada instancia de WebSphere Application Server utiliza un puerto exclusivo.

Asegúrese de que WebSphere Application Server está instalado y operativo en cadaubicación donde se hayan instalado componentes de IBM Cognos BI.

En el diagrama siguiente se muestran varias instancias de aplicaciones de IBMCognos desplegadas en WebSphere Application Server.

Java VirtualMachine

Controlador

ContentManager

Componentes denivel de aplicación

Sirviente 1WorkloadManager Queue

SolicitudesHTTP(S)

Figura 3. Despliegue de una instancia única


Conceptos relacionados:“Cuentas de usuario para la instalación y ejecución del producto” en la página 31El administrador de z/OS debe crear los usuarios y los grupos necesarios en elsistema z/OS.

Comunicación web en un entorno de servidor de aplicacionesUtilice WebSphere Application Server como un servidor web para gestionarsolicitudes.

Pasarela de servlet

Puede ejecutar la pasarela de servlet de IBM Cognos en WebSphere ApplicationServer en lugar de utilizar un servidor web. Si se utiliza la pasarela de servlet, elentorno no necesita un servidor web. El servidor de aplicaciones y la pasarela deservlet sustituyen las funciones proporcionadas por el servidor web y otraspasarelas de IBM Cognos.

La pasarela de servlet está desplegada en otra instancia del servidor deaplicaciones que el asignador y los servlets de Content Manager. La pasarela deservlet maneja la navegación en el portal y el contenido estático de formaindependiente del servidor de aplicaciones principal.

Asignador externo de IBM Cognos

El asignador es un servlet que maneja las solicitudes y aloja un conjunto deservicios. Los servicios están registrados en, y controlados por, el asignador. Eldireccionamiento de las solicitudes empieza cuando una solicitud llega a unasignador por primera vez. El asignador que se configura como el primero, ofrontal, recibe la solicitud y, a continuación, puede reenviar la solicitud a otrosasignadores. Para obtener más información, consulte la publicación IBM CognosGuía de administración y seguridad, y el documento de prácticas recomendadasPrácticas probadas de IBM Cognos: Enrutamiento por distribuidores en IBM Cognos 8 BIexplicado.

Java VirtualMachine

Controlador 1

ContentManager

Application TierComponents


Java VirtualMachine

Controlador2

ContentManager

Componentes denivel de aplicación


Puerto yyyy

Puerto xxxx

SolicitudesHTTP(S)::

Figura 4. Despliegue de varias instancias

Capítulo 9. Consideraciones de configuración para desplegar IBM Cognos BI for z/OS en WebSphere Application Server 77

Tareas relacionadas:“Configuración de IBM HTTP Web Server para ver el contenido estático de IBMCognos BI” en la página 91Para ver las páginas web de IBM Cognos BI, configure los directorios virtuales enel servidor web. Para utilizar la versión de 64 bits de la pasarela de IBM CognosBI, utilice un script para copiar los archivos necesarios.

Ajuste del valor de tiempo de espera de conexión predeterminado paraIBM Cognos Business Intelligence

El valor predeterminado para el valor de tiempo de espera de conexión que seutiliza en IBM Cognos Business Intelligence son 25 segundos. Algunos servidoresde aplicaciones, como IBM WebSphere, utilizan un valor más corto. Para evitarconflictos entre los valores de tiempo de espera de conexión, cambie el valor detiempo de espera de conexión en IBM Cognos BI. El valor debe ser menor que elvalor que se configura en el servidor de aplicaciones.

Procedimiento1. Abra el archivo ubicación_c10/configuration/BIBusTK.xml en un editor de

texto.2. Busque la siguiente cadena:

<BIBUSTK_CONNECTION_TIMEOUT>25000</BIBUSTK_CONNECTION_TIMEOUT>

3. Cambie el valor al 90% del valor especificado para el servidor de aplicaciones.Por ejemplo, WebSphere utiliza un valor de tiempo de espera de conexiónpredeterminado de 30 segundos. Calcule el 90% de 30 segundos, que es 27segundos. Cambie la cadena por<BIBUSTK_CONNECTION_TIMEOUT>27000</BIBUSTK_CONNECTION_TIMEOUT>

4. Guarde el archivo.5. Repita estos pasos en todas las ubicaciones en las que ha instalado IBM Cognos

BI.

Tareas de configuración en IBM Cognos ConfigurationEs necesario realizar algunas actualizaciones de los valores de configuraciónpredeterminados en IBM Cognos Configuration para poder ejecutar IBM CognosBusiness Intelligence en un servidor de aplicaciones.

Creación de los archivos de aplicaciones para desplegarlosen WebSphere Application Server

Utilice el asistente de creación de aplicaciones en IBM Cognos Configuration paracrear el archivo de aplicación.

Procedimiento1. Asegúrese de asignar suficiente espacio de disco para el directorio del perfil de

WebSphere Application Server. El directorio debe tener una capacidad de 500MB como mínimo para el despliegue de los archivos de contenido web de IBMCognos.

2. Abra IBM Cognos Configuration.3. Detenga el servicio de IBM Cognos si está en ejecución.


Si el servicio de IBM Cognos se está ejecutando en Tomcat y se intenta crear laaplicación p2pd mediante el asistente de creación de aplicaciones, verá elsiguiente mensaje de error:[ ERROR ] Unable to generate the application file filepath/p2pd.ear’.Problem creating war: The process cannot access the file because anotherprocess has locked a portion of the file.

4. Pulse Acción > Crear archivos de aplicación.Debe crear el archivo de aplicación en el sistema en el que va a desplegar elarchivo.

5. Siga las instrucciones del asistente.Si necesita más información sobre las opciones o los valores del asistente, pulseel botón de ayuda en el asistente.El asistente le permitirá seleccionar el tipo de aplicación que debe crearse y laraíz de contexto utilizada para acceder a la aplicación.El valor de la raíz de contexto especificado en el asistente debe ser el mismoque el indicado en la pestaña Entorno, y se utiliza para el despliegue en elservidor de aplicaciones. Para IBM Cognos Business Intelligence, el nombrepredeterminado de la raíz de contexto y del directorio de aplicación es p2pd, ypuede utilizarse en la mayoría de los casos. Para la pasarela de servlet de IBMCognos, el nombre predeterminado del directorio de aplicación y de la raíz decontexto es ServletGateway. Otros valores de despliegue de aplicacionespredeterminados, como el nombre de la aplicación, se pueden cambiar para quese ajusten mejor a su entorno.

6. Si utiliza el asignador como pasarela, asegúrese de que ha seleccionado que seincluya el contenido estático en el archivo de despliegue.

Resultados

No es necesario volver a crear ni volver a desplegar el archivo al realizar cambiosde configuración, ya que la información de configuración se almacena fuera de laaplicación. Sin embargo, después de aplicar servicio técnico, debe volver adesplegar las aplicaciones de IBM Cognos en WebSphere Application Server.

Cambio de las propiedades de configuración del servidor deIBM Cognos

Si no ha utilizado el asistente de creación de aplicaciones para configurar laspropiedades del entorno, debe actualizar manualmente los valores de laspropiedades del servidor. Debe actualizar las propiedades del entorno con elnombre de host o la dirección IP del sistema en el que se instalan los componentesde IBM Cognos Business Intelligence. Para evitar conflictos con otras aplicaciones,asigne números de puerto exclusivos para la aplicación Cognos BI.

En un sysplex, los discos son propiedad de una imagen de z/OS. Cuando unaaplicación realiza una operación de E/S en un disco que no es propiedad de laaplicación, el rendimiento puede ser lento. De forma predeterminada, WebSphereApplication Server establece el directorio de trabajo actual en el directorio inicialdel usuario. Si la propiedad del disco es diferente entre el directorio inicial delusuario y el directorio de instalación de Cognos, puede producirse un problema derendimiento de E/S. Al establecer la raíz de la plantilla, el administrador seasegura de que WebSphere Application Server y Cognos BI utilizan el mismodirectorio de trabajo.


Procedimiento1. Inicie IBM Cognos Configuration.2. Asegúrese de que la ubicación de instalación completa de todas las fuentes está

especificada para los componentes de nivel de aplicación.De manera predeterminada, la ubicación de instalación no utiliza una ruta deacceso completa.

3. En el panel Explorador, pulse Entorno.4. En el panel Propiedades, cambie la parte de localhost de la propiedad de URI

de cada componente.Utilice el nombre del sistema o la dirección IP del sistema donde se encuentrael componente y asigne un número de puerto.El servidor de aplicaciones debe configurarse para que escuche en el nombre dehost o la dirección IP indicados en el URI. Si cambia el valor predeterminadode la raíz de contexto, que es p2pd, debe cambiar también la parte de raíz decontexto del URI.v En URI de Content Manager pulse el valor y, a continuación, pulse el icono

de edición. Cambie el valor y a continuación pulse Aceptar.v Para todas las demás propiedades del URI, pulse el valor para cambiarlo.

5. Para el valor de URI de pasarela, escriba el URI del asignador externoutilizando la siguiente sintaxis:http[s]://nombre_host:puerto/p2pd/servlet/dispatch/ext

Para obtener un mayor rendimiento, dirija las solicitudes al asignador externopara el procesamiento en lugar de utilizar una pasarela.

6. Pulse Archivo > Guardar.7. Para mejorar el rendimiento, cambie el valor del parámetro template.root.

a. Vaya al directorio ubicación_c10/webapps/p2pd/WEB-INF.b. Abra el archivo xts.properties en un editor de texto,c. Para evitar problemas de rendimiento durante el arranque debido a la

propiedad del disco zFS, debe cambiar el parámetro template.root paraindicar la ruta absoluta del directorio raíz de instalación de Cognos BI.template.root=ubicación_c10/templates/ps

Configuración de la conexión a una base de datos delalmacén de contenido de DB2 para WebSphere ApplicationServer

Debe especificar la información del servidor de bases de datos para garantizar queContent Manager se puede conectar a la base de datos que utiliza para el almacénde contenido. Content Manager utiliza el inicio de sesión de la base de datos paraacceder al almacén de contenido DB2.

Procedimiento1. En la ubicación donde haya instalado Content Manager, inicie IBM Cognos

Configuration.2. En el panel Explorador, en Acceso a datos > Content Manager, pulse Almacén

de contenido.3. En el panel Propiedades, en la propiedad Nombre de base de datos, escriba el

nombre o el alias de la base de datos.4. Cambie las credenciales de inicio de sesión para especificar un ID de usuario y

una contraseña válidos:


a. Pulse el cuadro Valor situado junto a la propiedad Identificador de usuarioy contraseña y, a continuación, pulse el botón de edición cuando aparezca.Asegúrese de que especifica el mismo ID de usuario que ha especificadopara CMSCRIPT_USERNAME al crear los espacios de tabla.

b. Escriba los valores apropiados y pulse Aceptar.5. Para la propiedad Servidor de bases de datos y número de puerto, escriba un

valor, utilizando la sintaxis host:puerto.6. En el panel Propiedades, junto a Propiedades avanzadas, pulse dentro del

cuadro Valor y, a continuación, pulse el botón de edición.7. Pulse Añadir para añadir todos los parámetros excepto

CMSCRIPT_USERNAME, que se ha utilizado para crear los espacios de tabla.






CMSCRIPT_CS_ID T1




8. Pulse Archivo > Guardar.Las credenciales de inicio de sesión se cifran de inmediato.

9. Para probar la conexión entre Content Manager y la base de datos del almacénde contenido, pulse Acciones > Probar.

Configurar una conexión a la base de datos de IBM CognosMobile

En IBM Cognos Configuration, debe añadir la base de datos que está utilizandocomo la base de datos de IBM Cognos Mobile. Debe añadir la base de datos si estáutilizando la base de datos de almacén de contenido o una base de datosindependiente.

Procedimiento1. Abra IBM Cognos Configuration.2. En el panel Explorer (Explorador), bajo Data Access (Acceso a datos), pulse el

botón derecho del ratón en Mobile (Dispositivo móvil) y pulse New Resource(Nuevo recurso) > Database (Base de datos).

3. Entre un Nombre para la base de datos y asegúrese de que se selecciona labase de datos DB2 en Type (Tipo).

4. Pulse Aceptar.5. Para la propiedad Servidor de bases de datos y número de puerto, escriba un

valor, utilizando la sintaxis host:puerto.6. Cambie las credenciales de inicio de sesión para especificar un ID de usuario y

una contraseña válidos:a. Pulse el cuadro Valor situado junto a la propiedad Identificador de usuario

y contraseña y, a continuación, pulse el botón de edición cuando aparezca.b. Escriba los valores apropiados y pulse Aceptar.


7. Para la propiedad de Nombre de base de datos, escriba el nombre de la basede datos o el alias de base de datos.Si está utilizando la base de datos del almacén de contenido, entre el nombre oel alias de dicha base de datos.

8. Pulse Archivo > Guardar.

Configuración de una conexión con un servidor de correopara WebSphere Application Server

Si desea enviar informes por correo electrónico, deberá configurar una conexión auna cuenta de servidor de correo.


Si no tiene planificado enviar informes por correo electrónico o no desea configurarinmediatamente una cuenta de servidor de correo, no es necesario que configureuna conexión. Sin embargo, cuando guarde la configuración y, posteriormente,inicie los servicios en IBM Cognos Configuration, podrá ver un mensaje de avisocuando se pruebe la conexión con el servidor de correo. Puede ignorar el aviso sinpeligro alguno.

Procedimiento1. En el panel Explorador, en Acceso a datos, pulse Notificación.2. En el panel Propiedades, en la propiedad Servidor de correo SMTP, escriba el

nombre de host y el puerto del servidor de correo SMTP (saliente).Para poder abrir informes enviados por correo electrónico, debe cambiar laparte correspondiente al nombre de host de URI de pasarela, localhost, por ladirección IP del sistema o por el nombre del sistema. De lo contrario, el URLdel mensaje de correo electrónico contendrá localhost y los usuarios remotos nopodrán abrir el informe.Para poder abrir los informes que se envían como enlaces, asegúrese de queURI de pasarela en los servidores de informes y de notificaciones especifiqueun servidor web accesible que aloje contenido de IBM Cognos.

3. Pulse el cuadro Valor situado junto a la propiedad Cuenta y contraseña y, acontinuación, pulse el botón de edición.

4. Escriba los valores apropiados en el cuadro de diálogo Valor - Cuenta ycontraseña y, a continuación, pulse Aceptar.Si no se necesitan las credenciales de inicio de sesión para el servidor SMTP,elimine la información predeterminada para la propiedad Cuenta y contraseña.Cuando se le pida confirmación para dejar esta propiedad en blanco, pulse Sí.Asegúrese de que se ha eliminado el nombre de usuario predeterminado. De locontrario, se utilizará la cuenta predeterminada y las notificaciones nofuncionarán correctamente.

5. En la ventana Propiedades, escriba el valor apropiado para la cuenta delremitente predeterminado.

6. Para probar la conexión al servidor de correo, en el panel Explorador pulse conel botón derecho del ratón en Notificación > Probar.

Configuración de una pasarela de servletSi configura una pasarela de servlet de IBM Cognos, el servidor de aplicaciones yla pasarela de servlet de IBM Cognos sustituyen las funciones proporcionadas por


un servidor web. El despliegue de una pasarela de servlet es útil cuando se utilizael inicio de sesión único entre WebSphere Application Server y los componentes deIBM Cognos Business Intelligence.

Antes de empezar

Asegúrese de que se han efectuado las tareas siguientes:v WebSphere Application Server está en ejecución.

En cada sistema donde piense instalar la pasarela de servlet, WebSphereApplication Server debe estar instalado y en ejecución.

v Los componentes de pasarela de IBM Cognos BI se han instalado en el mismosistema que WebSphere Application Server.

v El asignador de IBM Cognos BI y los componentes de Content Manager estáninstalados y en ejecución en el entorno.

v La cuenta de usuario de WebSphere Application Server tiene permiso de accesocompleto para la instalación de IBM Cognos.


En lugar de direccionar las solicitudes directamente al asignador, puede desplegarla pasarela de servlet en una instancia de JVM distinta de las instancias de JVMque se ejecutan en el asignador de IBM Cognos BI y los servlets de ContentManager. Con este tipo de despliegue se separa la carga para servir contenidoestático de las aplicaciones principales.

Procedimiento1. Si es necesario, cree una instancia de JVM independiente.

Si tiene previsto ejecutar IBM Cognos BI y la pasarela de servlet de IBMCognos en el mismo servidor de aplicaciones, la pasarela de servlet debedesplegarse en una instancia de JVM independiente.

2. Compruebe que los componentes de IBM Cognos están configuradoscorrectamente.

3. Establezca las variables de entorno.4. Configure la pasarela de servlet de IBM Cognos para que se ejecute en

WebSphere Application Server.5. Si es necesario, cambie el script de inicio del servidor de aplicaciones.6. Configure las propiedades del servidor de aplicaciones y despliegue la pasarela

de servlet de IBM Cognos.7. Si es necesario, habilite SSL.

Resultados

Ahora puede acceder a los componentes de IBM Cognos BI mediante la pasarelade servlet de IBM Cognos especificando el URI de pasarela. Por ejemplo:http[s]:nombre_host:puerto/ServletGateway

El URI de pasarela de servlet de IBM Cognos no distingue entre mayúsculas yminúsculas.


Creación de una instancia de JVM independiente en IBM WebSpherePara eliminar posibles conflictos de clase Java o de recursos de sistema, ejecuteIBM Cognos Business Intelligence for z/OS en una instancia de Java VirtualMachine (JVM) aislada del resto de las aplicaciones. Esto garantiza que IBMCognos BI for z/OS no afecta a las aplicaciones existentes.


Cuando sea posible, instale IBM Cognos BI for z/OS en una instancia de JVM quesea independiente de los procesos administrativos de WebSphere ApplicationServer para aislar IBM Cognos y las funciones administrativas del servidor deaplicaciones.

Si utiliza la pasarela de servlet de IBM Cognos, asegúrese de que la ejecuta en unainstancia distinta de la de IBM Cognos BI for z/OS.

En el sistema z/OS, un sirviente de WebSphere Application Server es el espacio dedirecciones en el que reside la JVM; la aplicación de IBM Cognos BI se ejecuta enel sirviente.

Procedimiento

Cree una instancia de servidor independiente en IBM WebSphere.Cuando se crea una instancia de servidor independiente, también se crea una JVMaislada. Para obtener más información, consulte la documentación de WebSphereApplication Server.

Establecimiento de variables de entorno para ejecutar IBM Cognos BIen Websphere Application Server

Debe establecer variables de entorno para identificar la ubicación de Java VirtualMachine (JVM) y la ubicación de la instalación de IBM Cognos.


Establezca las variables de entorno para la región de sirviente en la consolaadministrativa de WebSphere.

Procedimiento

Establezca las variables de entorno siguientes para la región de sirviente en laconsola administrativa de WebSphere:

Tabla 38. Variables de entorno para IBM Cognos Business Intelligence for z/OS


_BPX_JOBNAME CGC

_BPXK_AUTOCVT ON

_CEE_RUNOPTS POSIX(ON),FILETAG(AUTOCVT,AUTOTAG),HEAPPOOLS(ALIGN),HEAPPOOLS64(ALIGN)

Nota: Continuación de línea correspondiente a estevalor.


Tabla 38. Variables de entorno para IBM Cognos Business Intelligence forz/OS (continuación)




Especifica un archivo de inicialización de ODBCpara el subsistema de ODBC (DSN) y el plan(DSNACLI).

IBM_JAVA_ENABLE_ASCII_FILETAG Se establece en ON porque z/OS utiliza lacodificación de caracteres EBCDIC y las aplicacionesJava de IBM Cognos BI utilizan la codificaciónASCII.

LIBPATH ubicación_c10/bin64 :ubicación_c10/bin:/bin


PATH ubicación_c10/bin64 :ubicación_c10/bin:/bin


Para instalar varias instancias de IBM Cognos BI, establezca las variables LIBPATH yPATH dentro del ámbito de la instancia del servidor de aplicaciones y no comovariables global, a fin de garantizar que cada instancia tenga un valor único.Tareas relacionadas:“Configuración de las propiedades de WebSphere Application Server” en la página87Debe configurar las propiedades de WebSphere Application Server y desplegar loscomponentes de IBM Cognos Business Intelligence.

Verificación de los valores de las variables de entornoconfigurados en WebSphere Application Server

Para asegurarse de que WebSphere Application Server está correctamenteconfigurado para el despliegue de aplicaciones de IBM Cognos BusinessIntelligence for z/OS, puede utilizar UNIX System Services para probar si lasvariables de entorno están establecidas.

Procedimiento1. Inicie sesión en UNIX System Services como el usuario que ejecuta IBM

Cognos.La cuenta con la que IBM Cognos BI se ejecuta debe tener configuradasdeterminadas variables de entorno en WebSphere Application Server.

2. En el shell de UNIX System Services, compruebe que las variables de entornoestán establecidas.

Tabla 39. Variables de entorno para WebSphere Application Server


_BPXK_AUTOCVT ON


Tabla 39. Variables de entorno para WebSphere Application Server (continuación)


_CEE_RUNOPTS POSIX(ON), FILETAG(AUTOCVT, AUTOTAG)Nota: El único carácter de espacio de esta cadena seencuentra antes de la palabra AUTOTAG.

JAVA_HOME ${WASHOME}/java64

PATH $JAVA_HOME/bin:/bin:${COGROOT}/bin64:${COGROOT}/bin:$JAVA_HOME/bin:${PATH}

IBM_JAVA_ENABLE_ASCII_FILETAG ON



LIBPATH ${JDBCHOME}/lib:/bin:${COGROOT}/bin64:${COGROOT}/bin:$JAVA_HOME/bin:${PATH}:${LIBPATH}

DISPLAY nombre_host:número_pantalla

LANG C

v Para ver una lista de las variables de entorno establecidas en el shell, escribael comando siguiente:env

v Para probar las variables de entorno una por una, utilice el comandosiguiente:env | grep <environment variable>

Registro de aplicaciones de Cognos Business Intelligence enWebSphere Application Server

Habilite System Management Facility (SMF) para recopilar información sobreaplicaciones de IBM Cognos Business Intelligence for z/OS, que se ejecutan dentrode WebSphere Application Server.

Por ejemplo, utilice esta información para supervisar la fiabilidad del sistema,identificar el uso de recursos del sistema y ejecutar tareas relacionadas con elrendimiento que su organización podría necesitar.

Procedimiento1. Vaya al directorio ubicación_c10/configuration/samples.2. Localice el archivo CognosSCRT.registrar.xml en el directorio

instancia_WAS/AppServer/properties/version.El archivo debe estar en la instancia de WebSphere Application Server en la quese ejecuta IBM Cognos BI.

3. Elimine la extensión .xml.La extensión de archivo .xml se utiliza para garantizar que la codificación delarchivo será ASCII. Para registrarlo en WebSphere Application Server, elarchivo debe utilizar una extensión .registrar.El programa reconoce automáticamente la extensión de archivo .registrar.


Conceptos relacionados:“IBM Cognos Business Intelligence for z/OS y la Herramienta de Informes deSubcapacidad de IBM” en la página 70La Herramienta de Informes de Subcapacidad de IBM (SCRT) es una herramientagratuita de IBM que genera informes sobre la capacidad de licencia necesaria paralos productos candidatos a la subcapacidad que se ejecutan en el sistema z/OS.

Configuración de las propiedades de WebSphere Application ServerDebe configurar las propiedades de WebSphere Application Server y desplegar loscomponentes de IBM Cognos Business Intelligence.

Antes de empezar

El rendimiento depende de que el acceso al spool sea eficiente. En función de lasalida que desee generar, como por ejemplo el rastreo, asegúrese de que se cumplauna de las condiciones siguientes:v Tiene suficiente espacio de spool.v Los registros de salida se dirigen a un conjunto de datos o a un archivo USS

(Unix System Services).Por ejemplo, para obtener información sobre cómo redirigir SYSPRINT aarchivos HFS para que se puedan ver con los editores habituales, consulte eldocumento Directing SYSPRINT Output to an HFS File in WebSphere for z/OS,TD101087, en el sitio Web de documentos técnicos de IBM: http://www.ibm.com/support/techdocs/atsmastr.nsf/Web/TechDocs.

Si el rastreo está activado, los espacios de direcciones de WebSphere ApplicationServer para z/OS pueden generar un gran número de registros de rastreo.

Procedimiento1. Inicie WebSphere Application Server, y, a continuación, abra la consola

administrativa de WebSphere.2. Instale una nueva aplicación de empresa mediante el archivo de aplicación

creado por IBM Cognos Configuration.Para IBM Cognos BI, la raíz de contexto predeterminada es p2pd, y puedeutilizarse en la mayoría de los casos. Para la pasarela de servlet de IBMCognos, la raíz de contexto predeterminada es ServletGateway. Otros valoresde despliegue de aplicaciones predeterminados, como el nombre de laaplicación, se pueden cambiar para que se ajusten mejor a su entorno. El valorde la raíz de contexto que se utilice para desplegar la aplicación debe coincidircon el valor de la raíz de contexto que se ha especificado en IBM CognosConfiguration al ejecutar el asistente de creación de aplicaciones.

3. Cambie la memoria predeterminada utilizada por la JVM.Normalmente, la memoria se establece añadiendo o cambiando el tamaño demontón Java inicial y máximo. Para obtener información sobre estosparámetros, consulte la documentación de la JVM o de WebSphere ApplicationServer.Establezca el tamaño de montón de la JVM en un valor superior a los 256 MB.Para que el rendimiento sea estable, asigne el mismo tamaño al valor mínimoinicial, -Xms, y al valor máximo, -Xmx.a. Establezca el mínimo inicial (-Xms) en 756 MB.b. Establezca el valor máximo (-Xmx) en 756 MB.


http://www.ibm.com/support/techdocs/atsmastr.nsf/Web/TechDocs

http://www.ibm.com/support/techdocs/atsmastr.nsf/Web/TechDocs

4. En la administración de WebSphere, en Entorno > Variables de WebSphere,cree los dos pares de nombre-valor de WebSphere siguientes y guárdelos en laconfiguración maestra:v name = protocol_http_timeout_output_recovery

value = SESSION

v name = protocol_https_timeout_output_recovery

value = SESSION

5. Para especificar el número de subprocesos de aplicaciones que se utilizan encada uno de los sirvientes que se ejecutan en un servidor de aplicaciones,establezca servant_region_custom_thread_count en 500.Si especifica un valor para esta propiedad personalizada, debe asignar el valorCUSTOM a la propiedad Workload profile en la página de valores adicionalesde z/OS de los servicios ORB en la consola administrativa para que este valorentre en vigor. Para obtener más información, consulte el Information Center deWebSphere Application Server.

6. Establezca en 1 el número mínimo de instancias y el número máximo deinstancias para las instancias del servidor de IBM Cognos.Esto garantiza que se utilizan los asignadores de IBM Cognos para escalar laaplicación.

7. Detenga y luego reinicie la instancia del servidor de aplicaciones WebSphereutilizada para los componentes de IBM Cognos Business Intelligence.

8. Compruebe que los componentes de IBM Cognos BI se estén ejecutando; paraello, busque el siguiente mensaje en la consola de administración del servidorde aplicaciones o en el archivo de registro del servidor de aplicaciones:El asignador está listo para procesar solicitudes.

Conexión con el portal de IBM Cognos BI después del despliegue enWebSphere Application Server

Puede ejecutar todas aplicaciones de IBM Cognos basadas en web desde IBMCognos Connection. Después de haber completado la configuración, puede probarsi la instalación es correcta; para ello, conéctese al portal de IBM Cognos BusinessIntelligence.

Procedimiento1. Abra un navegador web.2. Escriba el URL de la pasarela.

v Si utiliza el asignador como pasarela, escribahttp://nombre_host:puerto/p2pd/servlet/dispatch/ext.Por ejemplo:http://myserver:9080/p2pd/servlet/dispatch/ext

v Si utiliza una pasarela de servlet, escribahttp://nombre_host:puerto/pasarela_servlet.

La página web puede tardar unos minutos en iniciarse. Si ve el portal de IBMCognos, la instalación funciona.


Habilitación de SSL en el entorno de servidor de aplicacionesSi utiliza Secure Socket Layer (SSL) para los componentes de IBM Cognos, tambiéndebe habilitar SSL en el entorno de servidor de aplicaciones. A continuación,identifique el certificado de servidor SSL para los componentes de IBM Cognos.

Procedimiento1. Configure el servidor de aplicaciones para que utilice SSL.

Otra entidad emisora de certificados (CA) genera un certificado de servidorSSL. También se proporciona el certificado de la CA que generó el certificadode servidor SSL.Para obtener más información sobre cómo configurar el servidor deaplicaciones para que use SSL, consulte la documentación del servidor deaplicaciones. Para obtener información sobre cómo utilizar certificados de CAen su servidor de aplicaciones, consulte la documentación de la CA.

2. Copie el certificado de CA en el directorio ubicación_c10/bin y cambie elnombre del archivo por ca.cer.Este archivo debe estar en formato X.509 con codificación base-64.

3. En el directorio ubicación_c10/bin, escriba: ThirdPartyCertificateTool.sh -T-i -r ca.cer -k ../configuration/signkeypair/jCAKeystore -p contraseña

Escriba jCAKeystore como nombre del almacén de claves de CA.

Anulación del registro de asignadoresDebe anular el registro de todos los asignadores de IBM Cognos BusinessIntelligence que se hayan registrado con anterioridad y que ya no se utilicen. Porejemplo, si inicialmente configuró e inició el producto para que se ejecutase enTomcat, y ahora utiliza WebSphere Application Server, debe eliminar todos losasignadores de Tomcat que se están ejecutando actualmente.

Procedimiento1. Abra IBM Cognos Connection; para ello, conéctese al portal de IBM Cognos BI

y pulse Contenido de IBM Cognos en la página Bienvenido.2. En la esquina superior derecha, pulse Lanzar > IBM Cognos Administration.

Para eliminar los asignadores, utilice IBM Cognos Administration. Para accedera esta herramienta, debe tener permisos de ejecución para la función protegidaAdministration.

3. En la pestaña Configuración, pulse Asignadores y servicios.4. Para el asignador cuyo registro desea anular, pulse Acciones > Más > Anular

registro.5. En el cuadro de diálogo de confirmación, pulse Aceptar.

Resultados

La información del asignador se eliminará de Content Manager.


Si ha exportado el almacén de contenido antes de configurar los componentes deIBM Cognos BI para que se ejecuten en WebSphere Application Server, importe eldespliegue para restaurar y cifrar los datos utilizando las nuevas claves de cifrado.Para obtener más información, consulte el tema sobre la importación de un entornode destino en la publicación Guía de administración y seguridad.


Capítulo 10. Tareas de configuración para desplegar IBMCognos BI for z/OS en el contenedor de servlet de ApacheTomcat

De forma predeterminada, IBM Cognos Business Intelligence for z/OS instala yutiliza Tomcat como contenedor de servlet.

Utilice Tomcat como contenedor de servlet para las instalaciones de prueba o deprueba de concepto, o bien para resolver los problemas de instalación. Se requierenpocos cambios de configuración para tener una instalación básica de IBM CognosBusiness Intelligence for z/OS en marcha de forma rápida.

Configuración de IBM HTTP Web Server para ver el contenido estáticode IBM Cognos BI

Para ver las páginas web de IBM Cognos BI, configure los directorios virtuales enel servidor web. Para utilizar la versión de 64 bits de la pasarela de IBM CognosBI, utilice un script para copiar los archivos necesarios.

Nota: Utilice un servidor web para el servidor de aplicaciones Tomcat. ParaWebSphere Application Server, conéctese directamente con el asignador para ver elcontenido en línea.

Procedimiento1. Asegúrese de que el archivo ubicación_c10/configuration/cogstartup.xml

pertenece al mismo grupo que el servidor web.La cuenta con la que se ejecuta el servidor web debe tener acceso de lectura alarchivo cogstartup.xml. De forma predeterminada, el archivo cogstartup.xmltiene permiso de lectura para OTHER.

2. Asegúrese de que la variable de entorno _BPXK_AUTOCVT está establecida en Off.Por ejemplo:_BPXK_AUTOCVT=OFFexport _BPXK_AUTOCVT

3. Para utilizar la pasarela CGI de 64 bits, vaya al directorio ubicación_c10/cgi-bin y escriba el comando siguiente:./copyGateMod.sh 64bit

Los archivos de pasarela de 64 bits se copian desde el directorio cgi-bin/lib64al directorio cgi-bin.

4. Vaya al directorio DIR_IHS/conf y haga una copia de seguridad del archivohttpd.conf.Si se crea una copia de seguridad del archivo de configuración, la recuperaciónen caso de errores de edición resulta más fácil.

5. Abra el archivo httpd.conf en un editor de texto.6. Cree dos directorios virtuales.

a. Añada el siguiente texto al archivo httpd.conf para especificar dónde estánubicados los scripts CGI.ScriptAlias /ibmcognos/cgi-bin ubicación_c10/cgi-bin


ScriptAlias define dónde se encuentran los scripts CGI. Debe definirScriptAlias antes de Alias.El directorio debe tener permiso de ejecución.

b. Añada lo siguiente al archivo de texto para configurar una correlación entrelos URL y el directorio del sistema de archivos:Alias /ibmcognos ubicación_c10/webcontent

El directorio debe tener permiso de lectura.7. Si desea utilizar el navegador de imágenes para Report Studio, habilite Web

Distributed Authoring and Versioning (webDAV).8. Guarde el archivo y reinicie el servidor web.9. Establezca la variable de entorno _BPXK_AUTOCVT en ON.

Por ejemplo:_BPXK_AUTOCVT=ONexport _BPXK_AUTOCVT

Conceptos relacionados:“Pasarela de IBM Cognos de 64 bits” en la página 2En las versiones anteriores, si instalaba versiones de 64 bits de IBM CognosBusiness Intelligence, sólo estaban disponibles las versiones de 32 bits delcomponente de pasarela. En esta versión, también están disponibles las versionesde 64 bits de la pasarela. Puede beneficiarse de las ventajas del hardware de 64 bitsy de las nuevas bibliotecas de 64 bits.Tareas relacionadas:“Cambio de las propiedades de configuración del servidor de IBM Cognos” en lapágina 79Si no ha utilizado el asistente de creación de aplicaciones para configurar laspropiedades del entorno, debe actualizar manualmente los valores de laspropiedades del servidor. Debe actualizar las propiedades del entorno con elnombre de host o la dirección IP del sistema en el que se instalan los componentesde IBM Cognos Business Intelligence. Para evitar conflictos con otras aplicaciones,asigne números de puerto exclusivos para la aplicación Cognos BI.“Configuración de la pasarela para varias instancias de servidor” en la página 107Si instala el componente de pasarela en una ubicación distinta de la de ContentManager o de los componentes de nivel de aplicación, debe configurar la pasarelapara asegurarse de que podrá localizar un asignador.

Configuración de los componentes de servidor de IBM Cognos paraque se ejecuten en el contenedor de servlet de Tomcat

Debe actualizar las propiedades del entorno con el nombre de host o la direcciónIP del sistema en el que se instalan los componentes de IBM Cognos BusinessIntelligence para asegurarse de que los componentes pueden comunicarse entre sí.Debe asignar números de puerto para la aplicación de IBM Cognos que no entrenen conflicto con las aplicaciones existentes.

Procedimiento1. Inicie IBM Cognos Configuration.2. Asegúrese de que la ubicación de instalación completa de todas las fuentes está

especificada para los componentes de nivel de aplicación.3. En el panel Explorador, pulse Entorno.4. En el panel Propiedades, cambie la parte de localhost de todas las propiedades

de URI por el nombre de host o la dirección IP del servidor de IBM Cognos.


a. Para URI de asignador para pasarela y URI de Content Manager, pulse elvalor y, a continuación, pulse el botón de edición.

b. Cambie la parte de localhost y, a continuación, pulse Aceptar.c. Para todas las demás propiedades de URI, pulse el valor y cámbielo.

5. Para configurar una cuenta de servidor de correo, en el panel Explorador, enAcceso a datos, pulse Notificación.Para enviar informes por correo electrónico, debe configurar una conexión auna cuenta de servidor de correo. Si no tiene planificado enviar informes porcorreo electrónico o no desea configurar inmediatamente una cuenta deservidor de correo, no es necesario que configure una conexión. Sin embargo,cuando guarde la configuración y, posteriormente, inicie los servicios en IBMCognos Configuration, podrá ver un mensaje de aviso cuando se pruebe laconexión con el servidor de correo. Puede ignorar el aviso sin peligro alguno.a. En el panel Propiedades, en la propiedad Servidor de correo SMTP, escriba

el nombre de host y el puerto del servidor de correo SMTP (saliente).Para poder abrir informes enviados por correo electrónico, debe cambiar laparte correspondiente al nombre de host de URI de pasarela, localhost, porla dirección IP del sistema o por el nombre del sistema. De lo contrario, elURL del mensaje de correo electrónico contendrá localhost y los usuariosremotos no podrán abrir el informe.Para poder abrir los informes que se envían como enlaces, asegúrese de queURI de pasarela en los servidores de informes y de notificacionesespecifique un servidor web accesible que aloje contenido de IBM Cognos.

b. Pulse el cuadro Valor situado junto a la propiedad Cuenta y contraseña y, acontinuación, pulse el botón de edición.

c. Escriba los valores apropiados en el cuadro de diálogo Valor - Cuenta ycontraseña y, a continuación, pulse Aceptar.Si no se necesitan las credenciales de inicio de sesión para el servidor SMTP,elimine la información predeterminada para la propiedad Cuenta ycontraseña. Cuando se le pida confirmación para dejar esta propiedad enblanco, pulse Sí. Asegúrese de que se ha eliminado el nombre de usuariopredeterminado. De lo contrario, se utilizará la cuenta predeterminada y lasnotificaciones no funcionarán correctamente.

d. En la ventana Propiedades, escriba el valor apropiado para la cuenta delremitente predeterminado.

e. Pruebe la conexión al servidor de correo; en el panel Explorador pulse conel botón derecho del ratón en Notificación > Probar.


Configuración de la conexión a una base de datos delalmacén de contenido de DB2 para el contenedor de servletde Tomcat

Debe especificar la información del servidor de bases de datos para garantizar queContent Manager se puede conectar a la base de datos que utiliza para el almacénde contenido. Content Manager utiliza el inicio de sesión de la base de datos paraacceder al almacén de contenido DB2.


Configuration.

Capítulo 10. Tareas de configuración para desplegar IBM Cognos BI for z/OS en el contenedor de servlet de Apache Tomcat 93

2. En el panel Explorador, en Acceso a datos > Content Manager, pulse Almacénde contenido.

3. En el panel Propiedades, en la propiedad Nombre de base de datos, escriba elnombre o el alias de la base de datos.

4. Cambie las credenciales de inicio de sesión para especificar un ID de usuario yuna contraseña válidos:a. Pulse el cuadro Valor situado junto a la propiedad Identificador de usuario

y contraseña y, a continuación, pulse el botón de edición cuando aparezca.Asegúrese de que especifica el mismo ID de usuario que ha especificadopara CMSCRIPT_USERNAME al crear los espacios de tabla.

b. Escriba los valores apropiados y pulse Aceptar.5. Para la propiedad Servidor de bases de datos y número de puerto, escriba un

valor, utilizando la sintaxis host:puerto.6. En el panel Propiedades, junto a Propiedades avanzadas, pulse dentro del








CMSCRIPT_CS_ID T1






Tareas relacionadas:“Creación de espacios de tabla para un almacén de contenido en DB2 para z/OS”en la página 62El administrador de base de datos deberá ejecutar scripts para crear un conjuntode espacios de tabla necesarios para la base de datos de almacén de contenido.Deberá modificar los scripts para sustituir los parámetros de marcador de posiciónpor los que sean apropiados para el entorno.

Configurar una conexión a la base de datos de IBM CognosMobile

En IBM Cognos Configuration, debe añadir la base de datos que está utilizandocomo la base de datos de IBM Cognos Mobile. Debe añadir la base de datos si estáutilizando la base de datos de almacén de contenido o una base de datosindependiente.

Procedimiento1. Abra IBM Cognos Configuration.


2. En el panel Explorer (Explorador), bajo Data Access (Acceso a datos), pulse elbotón derecho del ratón en Mobile (Dispositivo móvil) y pulse New Resource(Nuevo recurso) > Database (Base de datos).

3. Entre un Nombre para la base de datos y asegúrese de que se selecciona labase de datos DB2 en Type (Tipo).

4. Pulse Aceptar.5. Para la propiedad Servidor de bases de datos y número de puerto, escriba un

valor, utilizando la sintaxis host:puerto.6. Cambie las credenciales de inicio de sesión para especificar un ID de usuario y


y contraseña y, a continuación, pulse el botón de edición cuando aparezca.b. Escriba los valores apropiados y pulse Aceptar.

7. Para la propiedad de Nombre de base de datos, escriba el nombre de la basede datos o el alias de base de datos.Si está utilizando la base de datos del almacén de contenido, entre el nombre oel alias de dicha base de datos.


Configuración de una conexión con un servidor de correopara el contenedor de servlet de Tomcat

Si desea enviar informes por correo electrónico, deberá configurar una conexión auna cuenta de servidor de correo.


Si no tiene planificado enviar informes por correo electrónico o no desea configurarinmediatamente una cuenta de servidor de correo, no es necesario que configureuna conexión. Sin embargo, cuando guarde la configuración y, posteriormente,inicie los servicios en IBM Cognos Configuration, podrá ver un mensaje de avisocuando se pruebe la conexión con el servidor de correo. Puede ignorar el aviso sinpeligro alguno.

Procedimiento1. En el panel Explorador, en Acceso a datos, pulse Notificación.2. En el panel Propiedades, en la propiedad Servidor de correo SMTP, escriba el

nombre de host y el puerto del servidor de correo SMTP (saliente).Para poder abrir informes enviados por correo electrónico, debe cambiar laparte correspondiente al nombre de host de URI de pasarela, localhost, por ladirección IP del sistema o por el nombre del sistema. De lo contrario, el URLdel mensaje de correo electrónico contendrá localhost y los usuarios remotos nopodrán abrir el informe.Para poder abrir los informes que se envían como enlaces, asegúrese de queURI de pasarela en los servidores de informes y de notificaciones especifiqueun servidor web accesible que aloje contenido de IBM Cognos.

3. Pulse el cuadro Valor situado junto a la propiedad Cuenta y contraseña y, acontinuación, pulse el botón de edición.

4. Escriba los valores apropiados en el cuadro de diálogo Valor - Cuenta ycontraseña y, a continuación, pulse Aceptar.Si no se necesitan las credenciales de inicio de sesión para el servidor SMTP,elimine la información predeterminada para la propiedad Cuenta y contraseña.


Cuando se le pida confirmación para dejar esta propiedad en blanco, pulse Sí.Asegúrese de que se ha eliminado el nombre de usuario predeterminado. De locontrario, se utilizará la cuenta predeterminada y las notificaciones nofuncionarán correctamente.

5. En la ventana Propiedades, escriba el valor apropiado para la cuenta delremitente predeterminado.

6. Pruebe la conexión al servidor de correo; en el panel Explorador pulse con elbotón derecho del ratón en Notificación > Probar.

Configuración de la conexión a Cognos Content DatabaseSi Cognos Content Database y Content Manager no se ejecutan en una mismaubicación, debe establecer las propiedades de conexión de base de datos paraCognos Content Database. Si Cognos Content Database y Content Manager sí seejecutan en una misma ubicación, Content Manager utiliza los valorespredeterminados para comunicarse con Cognos Content Database.

En un entorno de producción, deberá utilizar una base de datos corporativa, comoDB2 for z/OS, para el almacén de contenido.


Configuration.2. En el panel Explorador, en Acceso a datos > Content Manager, pulse con el

botón derecho del ratón en Almacén de contenido > Suprimir.De este modo se suprime la conexión al recurso predeterminado.

3. Pulse con el botón derecho del ratón en Content Manager > Nuevo recurso >Base de datos.

4. En el panel Propiedades, configure los componentes de servidor de IBMCognos Business Intelligence para utilizar Cognos Content Database comoalmacén de contenido:a. En Nombre, escriba cm.b. En Servidor de bases de datos y número de puerto, escriba el nombre del

sistema en el que ha instalado Cognos Content Database.c. En Identificador de usuario y contraseña, pulse el botón de edición y

escriba cognos tanto para el ID de usuario como para la contraseña paraacceder a Cognos Content Database.

5. Pulse Archivo > Guardar.Las credenciales de inicio de sesión se cifran de inmediato..

6. Para iniciar el servicio de Cognos Content Database, pulse con el botón derechodel ratón en IBM Cognos Content Database > Iniciar.Debe iniciar el servicio de Cognos Content Database antes de la prueba.



Tareas relacionadas:“Creación de otra instancia de Cognos Content Database” en la página 137Puede crear otra base de datos del almacén de contenido en Cognos ContentDatabase.

Inicio de los servicios de IBM CognosDebe registrar el servicio de IBM Cognos Business Intelligence para que losusuarios puedan acceder al mismo mediante IBM Cognos Connection. Pararegistrar el servicio, inicie el servicio en IBM Cognos Configuration.

Procedimiento1. Inicie IBM Cognos Configuration.2. Guarde la configuración.3. Pulse Acciones > Probar.4. Si la prueba falla, vuelva a configurar las propiedades afectadas y, a

continuación, pruebe de nuevo.Puede probar algunos componentes de forma individual si pulsa con el botónderecho del ratón en el componente en el panel Explorador y seleccionaProbar.No inicie el servicio hasta que se hayan superado todas las pruebas.

5. Pulse Acciones > Iniciar.El servicio de IBM Cognos puede tardar unos minutos en iniciarse.Esta acción inicia todos los servicios instalados.

Verificación de la instalación y la configuración de servidor de loscomponentes de servidor en el contenedor de servlet de Tomcat

Pruebe la instalación y la configuración para comprobar que los componentes deservidor de IBM Cognos Business Intelligence están utilizando el softwaresoportado, se pueden conectar con el software soportado y están funcionando.

Procedimiento1. Utilice la característica Probar en IBM Cognos Configuration cuando configure

los componentes para asegurarse de que la configuración es válida y que loscomponentes se han configurado para utilizar los productos de softwaresoportados.a. En el panel Explorador, pulse el nodo que desea probar o pulse

Configuración local par a probar todos los valores a la vez.b. Pulse Acciones > Probar.

Arregle los errores que haya y repita la prueba.c. Pulse Archivo > Guardar para guardar la configuración.

2. Compruebe si el almacén de contenido se ha creado correctamente y si ContentManager se ha iniciado.a. Abra un navegador web.b. Escriba http://nombre_host:puerto/p2pd/servlet.

Si Content Manager está en ejecución, se abrirá una página web quemostrará la hora actual y el estado en ejecución.Content Manager no se iniciará si el almacén de contenido no se ha creadoo si hay errores en las propiedades de conexión a la base de datos delalmacén de contenido.


3. Pruebe la disponibilidad del asignador.a. Abra un navegador web.b. Escriba http://nombre_host:puerto/p2pd/servlet/dispatch.

Si el asignador está disponible, se abrirá una página web que mostrará elportal de IBM Cognos sin las imágenes.

4. Conéctese al portal de IBM Cognos BI escribiendo lo siguiente, donde ibmcognoses el directorio virtual que ha creado al configurar el servidor web.http://nombre_host:puerto/ibmcognos

Si ve la página Bienvenido en el portal de IBM Cognos, la instalación funciona.

Cambio del despliegue del contenedor de servlet Tomcat a WebSphereApplication Server

Si los componentes de IBM Cognos Business Intelligence se ejecutan en elcontenedor de servlet Tomcat y desea realizar un despliegue en WebSphereApplication Server, debe también hacer una copia de seguridad de la informaciónde IBM Cognos existente.

Procedimiento1. Si hay datos en el almacén de contenido, inicie el servicio de IBM Cognos y

exporte todo el almacén de contenido mediante la herramienta de despliegue.Para obtener más información, consulte el tema sobre la creación de unaespecificación de despliegue de exportación en la publicación Guía deadministración y seguridad.

2. En IBM Cognos Configuration, pulse Archivo > Exportar como y guarde lainformación de configuración en un formato descifrado.

3. En IBM Cognos Configuration, detenga el servicio de IBM Cognos.4. Haga copia de seguridad de las siguientes claves criptográficas; para ello,

guarde los archivos y directorios correspondientes en una ubicación de archivodiferente.a. Haga copia de seguridad de los siguientes archivos:

v ubicación_c10/configuration/cogstartup.xml

v ubicación_c10/configuration/caSerial

v ubicación_c10configuration/cogconfig.prefs

v ubicación_c10/configuration/coglocale.xml

b. Haga copia de seguridad de los siguientes directorios:v ubicación_c10/configuration/csk

v ubicación_c10/configuration/encryptkeypair

v ubicación_c10/configuration/signkeypair

5. Suprima los archivos caSerial y cogconfig.prefs.6. Sustituya el archivo ubicación_c10/configuration/cogstartup.xml por el

archivo que contiene los datos descifrados exportados de IBM CognosConfiguration.En el directorio ubicación_c10/configuration, el archivo debe utilizar elnombre cogstartup.xml.La información de este archivo se volverá a cifrar automáticamente mediantenuevas claves criptográficas cuando guarde la configuración en IBM CognosConfiguration.


Ajuste de los recursos de memoria para el servicio de IBM CognosPuede cambiar la cantidad de recursos que utiliza el servicio de IBM Cognos. Deforma predeterminada, el servicio de IBM Cognos está configurado para que utiliceel mínimo de recursos de memoria para optimizar el tiempo de inicio.

Los valores de configuración del servicio de IBM Cognos sólo se aplican alcontenedor de servlet de Tomcat. Si desea configurar IBM Cognos BI para que seejecute en WebSphere Application Server, configure los recursos de memoria en elentorno de servidor de aplicaciones.

El servicio de IBM Cognos está disponible si ha instalado Content Manager o loscomponentes de nivel de aplicación.

Procedimiento1. Inicie IBM Cognos Configuration.2. En el panel Explorador, expanda Entorno > Servicios de IBM Cognos y, a

continuación, pulse IBM Cognos.3. En el panel Propiedades, cambie el valor de Memoria máxima en MB.

v Para reducir el tiempo de inicio, el espacio de memoria y los recursosutilizados, utilice el valor predeterminado.

v Para lograr un equilibrio entre un tiempo de inicio rápido y unas velocidadesde funcionamiento rápidas, escriba un valor que sea unas 1,5 veces el valorpredeterminado, como 1.152.

v Para aumentar las velocidades de funcionamiento, si el rendimiento es másimportante que un tiempo de inicio rápido y si su sistema tiene muchosrecursos, escriba un valor que sea aproximadamente el doble del valorpredeterminado, como 1.536.



Capítulo 11. Varias instancias de componentes de servidor

Puede instalar varias instancias de la pasarela, componentes de nivel de aplicacióny Content Manager en el sistema z/OS, y también puede instalar cada componenteo combinación de componentes en ubicaciones diferentes. Puede elegir estaspreferencias de instalación por motivos de rendimiento, por motivos de seguridado por otros motivos.

Instalación básica para varias instancias de un componente

Al instalar más de una instancia de un componente de servidor, hay muchasopciones para personalizar IBM Cognos BI. Sin embargo, para minimizar el tiemponecesario para garantizar una instalación satisfactoria, primero realice unainstalación básica. Instale una instancia de cada uno de los componentes deservidor necesarios en el sistema z/OS e instale Cognos Framework Manager enun sistema Windows. Después de configurar los componentes para comunicarseentre sí y verificar que la instalación funciona, puede personalizar los valores yañadir componentes opcionales.

Secuencia de instalación

En una instalación distribuida, la secuencia en la que se configuren e inicien loscomponentes es importante. Inicie los servicios para Content Manager antes deiniciar los servicios para otros componentes de servidor.

El componente de pasarela debe ser el último en configurarse para asegurarse deque se compartan las claves criptográficas y pueda tener lugar una comunicaciónsegura entre los componentes de servidor. El servidor especificado en la propiedadde URI de asignador externo en el sistema pasarela debe ser el último componentede servidor que inicie.

Instale y configure todos los componentes de servidor antes de instalar loscomponentes de Windows.

Secuencia de detención de los servicios

La secuencia en la que detenga los servicios es importante. Detenga loscomponentes de nivel de aplicación en primer lugar, seguidos del ContentManager en espera, y después el Content Manager activo.

También es importante detener los siguientes servicios o componentes:v Servidores web que albergan contenido de IBM Cognos.v Aplicaciones relacionadas con el servicio de IBM Cognos.v Aplicaciones de IBM Cognos Software Development Kit.

Configuraciones de Content ManagerEn una instalación en la que hay más de un Content Manager, o en la que ContentManager se encuentra en una ubicación aparte de otros componentes, debe habercomo mínimo un Content Manager configurado, en funcionamiento y accesibleantes de configurar otros componentes de IBM Cognos. Así se garantiza que el


servicio de entidad emisora de certificados, que se instala con Content Manager,esté disponible para emitir certificados a otros componentes.

Instancias de Content Manager activas y en esperaPuede instalar un número cualquiera de instalaciones de Content Manager, pero nopuede haber más de una activa. Cada una de las otras instalaciones actúa comoContent Manager en espera.

Un Content Manager en espera se utiliza para la protección por migración traserror. Si el Content Manager activo no está disponible debido a un error desoftware o hardware, un Content Manager en espera pasa a estar activo y lassolicitudes se dirigen a él.

Cuando el Content Manager activo falla, se pierden los datos no guardados de lasesión. Cuando otro Content Manager pasa a estar activo, puede que se solicite alos usuarios que inicien sesión.

De forma predeterminada, el primer Content Manager instalado con el servidor deIBM Cognos BI es el activo. Un administrador del servidor de IBM Cognos puedecambiar el Content Manager predeterminado y el Content Manager activo encualquier momento. Cuando IBM Cognos está iniciado, el Content Managerpredeterminado bloquea el almacén de contenido para que las instalaciones deContent Manager no puedan acceder a él. El resto de las instalaciones de ContentManager están en modo en espera.

Este mecanismo de migración tras error funciona porque los asignadores y elContent Manager activo se comunican regularmente entre sí. Si un asignador nopuede llegar al Content Manager, el asignador indica un Content Manager enespera, que se convierte en el Content Manager activo. El resto de las instalacionesde Content Manager permanecen en modo en espera para poder disponer desoporte de migración tras error de manera continua. Los Content Manager enespera recuperan valores criptográficos, como la clave simétrica común (utilizadapara cifrar y descifrar datos), del Content Manager activo.

Configuración de la conexión a una base de datos delalmacén de contenido de DB2 para cada instancia de ContentManager

Debe especificar la información del servidor de bases de datos para garantizar quelos componentes de Content Manager activo y en espera se puedan conectar a labase de datos que se utiliza para el almacén de contenido.


Configuration.2. En el panel Explorador, en Acceso a datos > Content Manager, pulse Almacén

de contenido.3. En el panel Propiedades, en la propiedad Nombre de base de datos, escriba el

nombre o el alias de la base de datos.4. Cambie las credenciales de inicio de sesión para especificar un ID de usuario y


y contraseña y, a continuación, pulse el botón de edición cuando aparezca.


Asegúrese de que especifica el mismo ID de usuario que ha especificadopara CMSCRIPT_USERNAME al crear los espacios de tabla.

b. Escriba los valores apropiados y pulse Aceptar.5. Para la propiedad de servidor de bases de datos y contraseña, escriba un valor,

utilizando la sintaxis host:puerto.6. En el panel Propiedades, junto a Propiedades avanzadas, pulse dentro del








CMSCRIPT_CS_ID T1






Entornos de desarrollo: Configuración de Cognos ContentDatabase

Si ha instalado Cognos Content Database en una ubicación distinta de la deContent Manager, debe establecer las propiedades de conexión de base de datospara Cognos Content Database.


Si ha instalado Cognos Content Database en la misma ubicación que ContentManager, Content Manager está configurado para utilizar Cognos ContentDatabase con los valores predeterminados.

En un entorno de producción, deberá utilizar una base de datos corporativa para elalmacén de contenido. Si ha utilizado Cognos Content Database en un sistema depruebas o en un sistema de prueba de concepto, puede utilizar las característicasdel portal de administración para hacer una copia de seguridad de los datos yarchivarlos antes de migrar a una base de datos corporativa en el entorno deproducción. Para obtener más información, consulte el tema sobre el despliegue detodo el almacén de contenido en la publicación Guía de administración y seguridad.


Configuration.2. En el panel Explorador, en Acceso a datos, Content Manager, pulse Almacén

de contenido.

Capítulo 11. Varias instancias de componentes de servidor 103

3. En el panel Propiedades, cambie las propiedades siguientes:a. En la propiedad Nombre, escriba cm.b. En la propiedad Servidor de bases de datos y número de puerto, escriba el

nombre del sistema en el que ha instalado Cognos Content Database.c. En la propiedad Identificador de usuario y contraseña, pulse el botón de

edición y escriba cognos tanto para el ID de usuario como para lacontraseña para acceder a Cognos Content Database.Cambie el ID de usuario y la contraseña predeterminados después deconfigurar el nuevo recurso.


5. Inicie el servicio de Cognos Content Database en la ubicación donde estáinstalado.

6. Para probar la conexión entre Content Manager y el almacén de contenido,pulse Acciones > Probar.Content Manager se conecta a la base de datos, comprueba los permisos debase de datos, y crea y llena una tabla. La tabla no se suprime y se utiliza cadavez que se repite la prueba.

Resultados

Ahora, Content Manager puede crear las tablas necesarias en el almacén decontenido cuando se inicie el servicio de IBM Cognos por primera vez. Si laspropiedades de conexión no se han especificado correctamente, las tablas no secrearán y no podrá conectarse a IBM Cognos Connection.

Configuración de las propiedades de entorno de la instanciade Content Manager activa predeterminada

Content Manager debe conocer las ubicaciones del almacén de contenido y de losotros componentes de Content Manager. También debe estar configurado paraalmacenar la clave simétrica localmente.


Si instala varios componentes de Content Manager para la migración tras error,debe designar uno de ellos como el activo. De forma predeterminada, el primeroque configure es el Content Manager activo.

Procedimiento1. En la ubicación donde haya instalado el Content Manager que desea designar

como activo, inicie IBM Cognos Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, pulse el valor de URI de Content Manager y, a

continuación, pulse el botón de edición.4. Especifique los URI para los demás componentes de Content Manager.

a. En el cuadro de diálogo Valor - URI de Content Manager, pulse Añadir.b. Pulse la fila vacía de la tabla y escriba el URI completo de la instancia de

Content Manager.No suprima el primer valor de la tabla. Este valor identifica la instancia deContent Manager local; es obligatorio.

c. Repita los pasos anteriores para cada URI que desee añadir.


Debe incluir en la lista todos los URI de Content Manager.d. Pulse Aceptar.

5. En el panel Explorador, en Seguridad, pulse Criptografía.6. En el panel Propiedades, en Valores de CSK, establezca Almacenar clave

simétrica localmente en Verdadero.7. Pulse Archivo > Guardar.

Configuración de las propiedades de entorno de lasinstancias de Content Manager en espera

El Content Manager en espera se utiliza para la migración tras error en el caso deque se produzca una anomalía en el software o en el hardware. El ContentManager en espera debe conocer las ubicaciones del almacén de contenido y de losotros componentes de Content Manager. También debe estar configurado paraalmacenar la clave simétrica localmente.

Antes de empezar

Asegúrese de que ya ha configurado al menos una instancia de Content Manager yque está en ejecución. Esto garantiza que la entidad emisora de certificados emiteun certificado de seguridad para el Content Manager en espera.

Procedimiento1. En la ubicación donde haya instalado el Content Manager que desea designar

como en espera, inicie IBM Cognos Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, pulse el valor de URI de Content Manager y, a

continuación, pulse el botón de edición.4. Especifique los URI para los demás componentes de Content Manager.

a. En el cuadro de diálogo Valor - URI de Content Manager, pulse Añadir.b. Pulse la fila vacía de la tabla y escriba el URI completo de la instancia de

Content Manager.No suprima el primer valor de la tabla. Este valor identifica la instancia deContent Manager local; es obligatorio.

c. Repita los pasos anteriores para cada URI que desee añadir.Debe incluir en la lista todos los URI de Content Manager.

d. Pulse Aceptar.5. En el panel Explorador, en Seguridad, pulse Criptografía.6. Asegúrese de que todos los valores criptográficos coincidan con los que ha

configurado para el Content Manager activo predeterminado.7. En el panel Explorador, en Acceso a datos > Content Manager, pulse Almacén

de contenido.8. Asegúrese de que los valores de todas las propiedades coincidan con los que ha

configurado para el Content Manager activo predeterminado.9. Pulse Archivo > Guardar.


Para la migración tras error, asegúrese de configurar proveedores de autenticaciónen todas las ubicaciones donde haya instalado Content Manager. Cuando elContent Manager activo predeterminado falla, el sistema conmuta


automáticamente a un Content Manager en espera y las solicitudes se dirigen a él.

Inicio de varias instancias de Content ManagerEl servicio del Content Manager activo debe iniciarse antes que los servicios decualquier otro componente.

Procedimiento1. En la ubicación donde haya instalado el Content Manager activo, inicie IBM

Cognos Configuration con la cuenta de usuario y grupo propietaria de losarchivos de instalación.

2. Asegúrese de guardar la configuración; de lo contrario no podrá iniciar elservicio de IBM Cognos BI.

3. Pulse Acciones > Probar.IBM Cognos Configuration comprueba la disponibilidad de las clavessimétricas comunes (CSK), prueba la configuración del espacio de nombres yprueba las conexiones con el almacén de contenido y la base de datos deregistro. Si utiliza la base de datos de notificaciones y el servidor de correo,éstos también se prueban.Si Probar no está disponible para su selección, en el panel Explorador, pulseConfiguración local.

4. Si la prueba falla, vuelva a configurar las propiedades afectadas y, acontinuación, pruebe de nuevo.Puede probar algunos componentes de forma individual si pulsa con el botónderecho del ratón en el componente en el panel Explorador y seleccionaProbar.No inicie el servicio hasta que se hayan superado todas las pruebas.

5. Pulse Acciones > Iniciar.El servicio de IBM Cognos BI puede tardar unos minutos en iniciarse.

6. Compruebe que Content Manager está en ejecución; para ello, escriba el URI deContent Manager en IBM Cognos Configuration.Por ejemplo, en un navegador web, escriba http://nombre_host:port/p2pd/servlet.El valor Estado debe ser En ejecución.

Configuración de las propiedades de entorno de varias instancias delos componentes de nivel de aplicación

Los componentes de nivel de aplicación deben conocer la ubicación de la pasarela,de Content Manager y de la base de datos de notificaciones.


Si instala los componentes de nivel de aplicación en una ubicación diferente a la deContent Manager, debe configurar cada instalación de componentes de nivel deaplicación para asegurarse de que puede localizar Content Manager y comunicarsecon él.

Los componentes de nivel de aplicación también deben conocer la ubicación de labase de datos de notificaciones que se utilizará para la información sobre trabajos yplanificaciones. Los componentes de nivel de aplicación deben utilizar la mismabase de datos de notificaciones que Content Manager.


Procedimiento1. En cada ubicación de los componentes de nivel de aplicación, inicie IBM

Cognos Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, cambie la parte de localhost de la propiedad URI de

Content Manager de modo que coincida con el nombre de host o la direcciónIP de la instancia de Content Manager.a. En el cuadro de diálogo Valor - URI de Content Manager, pulse Añadir.b. Pulse la fila vacía de la tabla y escriba el URI completo de Content

Manager.c. Pulse Aceptar.

4. Si utiliza un servidor de aplicaciones Tomcat, cambie la parte localhost de lapropiedad URI de pasarela por el nombre de host o la dirección IP de lainstancia de pasarela.

5. Pulse Archivo > Guardar.6. Pulse Acciones > Iniciar para iniciar los servicios.

Configuración de la pasarela para varias instancias de servidorSi instala el componente de pasarela en una ubicación distinta de la de ContentManager o de los componentes de nivel de aplicación, debe configurar la pasarelapara asegurarse de que podrá localizar un asignador.

Antes de empezar

Asegúrese de que el Content Manager activo está en ejecución y está disponible.


Se instala un asignador con cada instancia de Content Manager de loscomponentes de nivel de aplicación.

Para la protección de migración tras error, puede configurar más de un asignadorpara una pasarela. Cuando se configuran varios asignadores, las solicitudes sesuelen direccionar al primer asignador en la lista. Si este asignador deja de estardisponible, la pasarela determina el siguiente asignador en funcionamiento de lalista y direcciona las solicitudes a este. La pasarela supervisa el estado delasignador primario y las solicitudes se direccionan de nuevo a este componentecuando vuelve a estar en servicio.

Para proteger los datos, configure la pasarela para utilizar el asignador que seinstala con una instancia de componentes de nivel de aplicación.

Procedimiento1. En la ubicación de cada pasarela, inicie IBM Cognos Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, en Valores de pasarela, especifique los valores de la

propiedad URI de asignador para pasarela.a. Pulse la columna del valor.b. Pulse la columna de edición.c. Cambie la parte de localhost del URI por el nombre o la dirección IP de la

ubicación de los componentes de nivel de aplicación.


Si desea enviar solicitudes al asignador desde una aplicación IBM CognosSoftware Development Kit o una herramienta de modelado de IBM Cognos quese encuentra fuera del cortafuegos de red, utilice una pasarela dedicada queesté configurada para conectarse al asignador mediante el URI de asignadorinterno. Por ejemplo, http://localhost:9300/p2pd/servlet/dispatch.Por cuestiones de seguridad, el valor predeterminado de la propiedad URI deasignador para pasarela impide que el asignador acepte solicitudes de unaaplicación IBM Cognos Software Development Kit o una herramienta demodelado que se encuentre fuera del cortafuegos.Asegúrese de haber configurado la seguridad necesaria para esta pasareladedicada, como por ejemplo, SSL. No cambie la pasarela principal para queutilice el URI de asignador interno. Si lo hiciese, se reduciría la seguridad delportal y de las aplicaciones Studio de IBM Cognos.

4. En el panel Explorador, en Seguridad, Criptografía, pulse Cognos, elproveedor criptográfico predeterminado.

5. En el grupo de propiedades Configuración de la entidad emisora decertificados, establezca la propiedad Contraseña con un valor que secorresponda con la configuración en el Content Manager activopredeterminado.

6. Asegúrese de que todos los demás valores criptográficos coincidan con los queha establecido para el Content Manager activo predeterminado.

7. Para comprobar que la clave simétrica se puede recuperar, en el panelExplorador pulse con el botón derecho del ratón en Criptografía > Probar.

8. Pulse Archivo > Guardar.Tareas relacionadas:“Configuración de IBM HTTP Web Server para ver el contenido estático de IBMCognos BI” en la página 91Para ver las páginas web de IBM Cognos BI, configure los directorios virtuales enel servidor web. Para utilizar la versión de 64 bits de la pasarela de IBM CognosBI, utilice un script para copiar los archivos necesarios.

Configuración de varias instancias de los servicios de índice para labúsqueda en índice

En un entorno con un gran volumen de solicitudes de informes, puede instalarvarias instancias de los componentes de nivel de aplicación. Puede configurarvarias instancias de los servicios de índice para la búsqueda en índice.


En el diagrama siguiente se muestra el servicio de búsqueda en índice y el serviciode actualización de índice en el nivel de aplicaciones, y los servicios de datos deíndice en el nivel de datos.


Procedimiento1. Instale una instancia de los componentes de nivel de aplicación en el nivel de

aplicaciones.2. En el nivel de aplicación, habilite el servicio de búsqueda en índice y el servicio

de actualización de índice.3. Instale una instancia de los componentes de nivel de aplicación en el nivel de

datos.4. En el nivel de datos, habilite el servicio de búsqueda en índice.5. Si es necesario, instale instancias adicionales de los componentes de nivel de

aplicación en el nivel de aplicación.6. Para cada instancia adicional del nivel de aplicación, habilite el servicio de

búsqueda en índice.7. Instale una instancia de los componentes de nivel de aplicación en el nivel de

datos.8. Para la instancia adicional del nivel de datos, habilite el servicio de datos de

índice.

Figura 5. Ejemplo de configuración de los servicios de índice para los niveles de aplicación yde datos


Capítulo 12. Instalación de componentes de Windows

En el caso de un producto en funcionamiento, debe instalar componentes deWindows, como Framework Manager. No es necesario que instale componentesopcionales de Windows, como Cognos Transformer.

IBM Cognos Business Intelligence for z/OS no puede utilizar datos para informes,consultas, análisis u otras funciones de inteligencia empresarial a menos que anteslos datos se empaqueten y se publiquen en Cognos Framework Manager. Debeinstalar y configurar Cognos Framework Manager de modo que se comunique conlos componentes de servidor como parte de una instalación básica.

Opcionalmente, puede que desee instalarv Cognos Transformer, el componente de modelado OLAP que modela y crea

PowerCubesv IBM Cognos Business Intelligence Supplementary Languages Documentation,

con la documentación traducidav IBM Cognos Software Development Kit

Revisión de los requisitos de hardware y software para loscomponentes de Windows

Antes de instalar los componentes de Windows, asegúrese de que tiene suficientesrecursos del sistema en el entorno para los modelos.

Revise los requisitos mínimos de hardware y de software necesarios para instalar yejecutar los componentes de Windows. Pueden ser necesarios recursos adicionalespara los entornos de producción o para entornos más grandes. El tamaño de losmodelos determina los requisitos de hardware, como, por ejemplo, el espacio dedisco.

Procedimiento1. Utilice la tabla siguiente para comprobar los requisitos de hardware y software

para instalar y ejecutar Cognos Framework Manager en Windows.

Tabla 42. Requisitos del sistema para Cognos Framework Manager




Base de datos Si es necesario, software de cliente de basede datos instalado en el mismo sistema queCognos Framework Manager


2. Revise la lista actualizada de los entornos soportados por los productos de IBMCognos, como sistemas operativos, parches, navegadores, servidores de web,servidores de directorios, servidores de bases de datos y servidores de


aplicaciones en el sitio web del centro de recursos de IBM Cognos(http://www.ibm.com/software/data/support/cognos_crc.html).

3. Utilice la tabla siguiente para comprobar los requisitos de hardware y softwarepara instalar y ejecutar Cognos Transformer en Windows.

Tabla 43. Requisitos del sistema para Cognos Transformer




Base de datos Si es necesario, software de cliente de basede datos instalado en el mismo sistema queCognos Transformer


Otros Microsoft Data Access Component (MDAC)2.6 o posterior para su uso con los ejemplosdel producto

Instalación de Cognos Framework Manager en un sistema WindowsPara realizar una instalación completa de IBM Cognos Business Intelligence forz/OS, debe instalar Cognos Framework Manager en un sistema Windows.Framework Manager es una herramienta de modelado de metadatos de 32 bits.

Procedimiento1. Inicie el programa de instalación:

v Inserte el disco de Cognos Framework Manager (IBM Cognos BusinessIntelligence Modeling).Si el asistente de instalación no se abre automáticamente, vaya al directoriodel sistema operativo y efectúe una doble pulsación en el archivoissetup.exe.

v Vaya a la ubicación en la que se han descargado y extraído los archivos deinstalación y, a continuación, efectúe una doble pulsación en el archivoissetup.exe.

2. Siga las indicaciones del asistente de instalación para copiar los archivosnecesarios en el sistema.Instale en un directorio que contenga solamente caracteres ASCII en el nombrede ruta. Algunos servidores no soportan que los nombres de directoriocontengan caracteres que no sean ASCII. La instalación de Cognos FrameworkManager en un directorio que contenga un apóstrofo en el nombre de rutapuede dar como resultado que la ayuda no se abra correctamente.

3. Cuando aparezca un mensaje informativo referente a la instalación deSupplementary Languages Documentation, pulse Aceptar.Supplementary Languages Documentation contiene versiones traducidas deDirectrices de modelado de metadatos. Si desea que esta guía esté disponible envarios idiomas además del inglés, instale el contenido del disco. De locontrario, la instalación incluirá solamente la versión en inglés de la guía.

4. En la última página del asistente de instalación, seleccione Iniciar IBM CognosConfiguration para configurar Cognos Framework Manager inmediatamente.


http://www.ibm.com/software/data/support/cognos_crc.html

Puede optar por configurar Cognos Framework Manager más tarde iniciando laherramienta de configuración de la carpeta de programas IBM Cognos desde elatajo del menú Inicio de Windows.

5. Proteja el directorio de instalación frente al acceso no autorizado.


Se utiliza los valores predeterminados para la configuración. Puede cambiar estosvalores predeterminados durante la instalación o más adelante, para ajustarlosmejor a su entorno.Tareas relacionadas:“Configuración de Cognos Framework Manager para comunicarse con loscomponentes de servidor en el sistema z/OS”Para asegurarse de que Cognos Framework Manager puede comunicarse con loscomponentes de servidor de IBM Cognos Intelligence Business Intelligence en elsistema z/OS, debe definir las propiedades del entorno.

Valores predeterminados para Cognos Framework ManagerEl programa de instalación instala IBM Cognos Framework Manager utilizando losvalores predeterminados. Después de la instalación, utilice la herramienta deconfiguración para cambiar los valores de modo que se ajusten a su entorno.

En la tabla siguiente se enumeran los valores predeterminados para CognosFramework Manager.

Tabla 44. Valores predeterminados para Cognos Framework Manager

Propiedad Valor

URI de pasarela http://localhost:80/ibmcognos/cgi-bin/cognos.cgi

URI de asignador para aplicacionesexternas

http://localhost:9300/p2pd/servlet/dispatch

Tareas relacionadas:“Configuración de Cognos Framework Manager para comunicarse con loscomponentes de servidor en el sistema z/OS”Para asegurarse de que Cognos Framework Manager puede comunicarse con loscomponentes de servidor de IBM Cognos Intelligence Business Intelligence en elsistema z/OS, debe definir las propiedades del entorno.

Configuración de Cognos Framework Manager paracomunicarse con los componentes de servidor en el sistemaz/OS

Para asegurarse de que Cognos Framework Manager puede comunicarse con loscomponentes de servidor de IBM Cognos Intelligence Business Intelligence en elsistema z/OS, debe definir las propiedades del entorno.

Antes de empezar

Asegúrese de que los componentes de servidor se han instalado y configurado yde que están en ejecución.

Capítulo 12. Instalación de componentes de Windows 113


Para comunicarse con componentes de servidor, Cognos Framework Managerutiliza una de las rutas siguientes:v A través de la pasarelav Directamente al asignador de componentes de nivel de aplicación

Utilice esta ruta de comunicación para WebSphere Application Server.

Los valores de las propiedades que puede configurar para los sistemas CognosFramework Manager depende de la ruta de comunicación.

Procedimiento1. En el sistema en el que ha instalado Cognos Framework Manager, inicie IBM

Cognos Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, en el cuadro URI de pasarela, cambie la parte de

nombre de host de URI de pasarela, localhost, por la dirección IP del sistema opor el nombre de sistema.v Para utilizar una pasarela de servlet, utilice la sintaxis siguiente:

http[s]://nombre_host:puertoraíz_contexto/servlet/Gateway

donde raíz_contexto es el valor que asignó a la aplicación web ServletGatewaycuando desplegó la aplicación ServletGateway.

v Si no utiliza un servidor web, para utilizar el asignador como pasarela,utilice la sintaxis siguiente:http[s]://nombre_host:puerto/p2pd/servlet/dispatch/ext

4. Especifique el valor para el URI de asignador para aplicaciones externas.v Si el servidor web está configurado para no permitir el acceso anónimo,

escriba el URI del asignador.Asegúrese de que cambia el nombre de host localhost en el URI.

v Si el servidor web soporta la codificación de transferencia truncada e CognosFramework Manager se encuentra dentro del cortafuegos, escriba el URI delasignador.Asegúrese de que cambia el nombre de host localhost en el URI.

v Si utiliza una pasarela dedicada para la comunicación con una herramientade modelado,escriba el URI de asignador externo.

5. En el panel Explorador, en Criptografía, pulse Cognos, el proveedorcriptográfico predeterminado.

6. En el grupo de propiedades Configuración de la entidad emisora decertificados, en la propiedad Contraseña, escriba la contraseña que haconfigurado para el Content Manager activo predeterminado.


Prueba de la instalación de Cognos Framework ManagerVerifique que la instalación de Cognos Framework Manager funciona paraasegurarse de que Cognos Framework Manager puede comunicarse con loscomponentes de servidor de IBM Cognos Business Intelligence en z/OS.


Procedimiento

Para iniciar Cognos Framework Manager, en el menú Inicio, pulse Programas,IBM Cognos, IBM Cognos Framework Manager. Si ve la página Bienvenido deCognos Framework Manager, su instalación funciona. Si la instalación no funciona,compruebe la conexión de red para asegurarse de que se puede comunicar con loscomponentes de servidor de IBM Cognos en el sistema z/OS.

Instalación de IBM Cognos Cube DesignerInstale IBM Cognos Cube Designer en la misma ubicación que IBM CognosFramework Manager. IBM Cognos Cube Designer es la aplicación que se utilizapara modelar metadatos dimensionales y cubos dinámicos.


v Inserte el disco de IBM Cognos Cognos Cube Designer.Si el asistente de instalación no se abre automáticamente, vaya al directoriodel sistema operativo y efectúe una doble pulsación en el archivoissetup.exe.


2. Siga las instrucciones del asistente de instalación para copiar los archivosnecesarios en la misma ubicación que Framework Manager.

Conceptos relacionados:“Instalación de IBM Cognos Dynamic Cubes” en la página 2IBM Dynamic Cubes son bases de datos optimizadas que proporcionan unrendimiento de las consultas de alta velocidad en conjuntos de metadatos grandespara la creación de informes y análisis de Business Intelligence.

Instalación de Cognos Insight desde Cognos ConnectionLos usuarios finales pueden instalar IBM Cognos Insight en sus sistemas desde lapágina Bienvenido al software de IBM Cognos. Cognos Insight se inicia despuésde que se haya completado la instalación.

Antes de empezar

Asegúrese de que el administrador de BI asigna a todos los usuarios que debeninstalar Cognos Insight el rol Advanced Business Author. Para obtener másinformación acerca de cómo asignar prestaciones, consulte la publicación IBMCognos Business Intelligence Guía de administración y seguridad.

Procedimiento1. En un navegador web, escriba la dirección web de la pasarela de Cognos BI.

Por ejemplo, escriba http://host_local/ibmcognos siendo host_local el nombredel sistema en el que está instalado el portal de Cognos BI.

2. En la página Bienvenido al software de IBM Cognos, en el panel Misacciones, pulse Instalar y lanzar el software de espacio de trabajo deescritorio en mi sistema.


Consejo: Como alternativa, en la página IBM Cognos Connection, vaya almenú Lanzar y pulse IBM Cognos Insight.

3. Si es la primera vez que usa Cognos Insight, siga estos pasos.a. Pulse Instalar ahora. El archivo del instalador, CognosInsight.msi, se

descarga en el sistema. Esto puede tardar unos minutos.b. Si el archivo CognosInsight.msi no se ejecuta automáticamente después de

descargarlo, pulse Ejecutar si se le solicita o efectúe una doble pulsación enel archivo para ejecutarlo.

c. Si se le solicita, abra el archivo provagent.cogrcp_insight.Conceptos relacionados:“IBM Cognos Connection Installer for Cognos Insight” en la página 2Utilice IBM Cognos Connection Installer for Cognos Insight para instalar softwarede suministro en los servidores de Cognos Business Intelligence. De este modo,varios usuarios podrán instalar Cognos Insight en sus sistemas desde la interfaz deCognos Business Intelligence.

Instalación del cliente Cognos Transformer en un sistema WindowsIBM Cognos Transformer, la herramienta de modelado de metadatos para crearPowerCubes, es un componente de instalación opcional.

Antes de empezar

Los componentes de servidor de IBM Cognos Business Intelligence y el programade utilidad del servidor Cognos Transformer para crear PowerCubes en el sistemaz/OS deben estar instalados y en ejecución.


Para una instalación completa de Cognos Transformer, debe instalarlo en unsistema Windows y en el sistema z/OS. Los componentes de Cognos Transformerse instalan en ambos entornos y, a continuación, puede utilizar las características ylas herramientas apropiadas para cada entorno. Por ejemplo, el cliente CognosTransformer proporciona una interfaz gráfica de usuario para diseñar modelos enlos sistemas Windows. A continuación, cree cubos en el sistema z/OS.

El cliente Cognos Transformer debe estar instalado en un sistema Windows de 32bits.


v Inserte el disco de Cognos Transformer.Si el asistente de instalación no se abre automáticamente, vaya al directoriodel sistema operativo y efectúe una doble pulsación en issetup.exe.

v Vaya a la ubicación en la que se han descargado y extraído los archivos deinstalación y, a continuación, efectúe una doble pulsación en issetup.exe.

2. Siga las indicaciones del asistente de instalación para copiar los archivosnecesarios en el sistema.Instale en un directorio que contenga solamente caracteres ASCII en el nombrede ruta. Algunos servidores no soportan que los nombres de directoriocontengan caracteres que no sean ASCII. La instalación de Cognos Transformeren un directorio que contenga un apóstrofo en el nombre de ruta puede darcomo resultado que la ayuda no se abra correctamente.


3. Seleccione un idioma para la instalación.Cuando se selecciona un idioma en el asistente de instalación, este determina elidioma de la interfaz de usuario. Solamente se instala ese idioma. No sepueden cambiar las propiedades de idioma después de la instalación. Si deseacambiar el idioma de la interfaz de usuario, debe reinstalar CognosTransformer.

4. En la última página del asistente de instalación, seleccione Iniciar IBM CognosConfiguration para configurar Cognos Transformer inmediatamente.Puede optar por configurar Cognos Transformer más tarde iniciando laherramienta de configuración de la carpeta de programas IBM Cognos desde elatajo del menú Inicio de Windows.Cuando Cognos Transformer se instala en Windows Vista, si no tieneprivilegios de administrador sobre el sistema y realiza cambios en el archivocogtr.xml, el archivo actualizado se guarda de forma predeterminada en undirectorio de almacén virtual y no en el directorio ubicación_c10/configuration.

5. Proteja el directorio de instalación frente al acceso no autorizado.


Se utiliza los valores predeterminados para la configuración. Puede cambiar estosvalores predeterminados durante la instalación o más adelante, para ajustarlosmejor a su entorno.Tareas relacionadas:“Actualización del archivo de preferencias de ejemplo de Cognos Transformer parasistemas Windows Vista” en la página 124Si desea utilizar el archivo cogtr.xml.samples como plantilla, debe editar losvalores de preferencias predeterminados.

Valores predeterminados para el cliente Cognos TransformerEl programa de instalación instala el cliente Cognos Transformer utilizando losvalores predeterminados. Después de la instalación, utilice la herramienta deconfiguración para cambiar los valores de modo que se ajusten a su entorno.

En la tabla siguiente se enumeran los valores predeterminados para CognosTransformer.

Tabla 45. Valores predeterminados para Cognos Transformer

Propiedad Valor predeterminado

URI de pasarela http://localhost:80/ibmcognos/cgi-bin/cognos.cgi

URI de asignador para aplicacionesexternas

http://localhost:9300/p2pd/servlet/dispatch


Tareas relacionadas:“Configuración del cliente Cognos Transformer para que se comunique con loscomponentes de servidor en z/OS”Para permitir que el cliente Cognos Transformer se comunique con loscomponentes de servidor en z/OS, debe configurar las propiedades del entornocorrespondientes a Cognos Transformer en IBM Cognos Configuration.

Configuración del cliente Cognos Transformer para que secomunique con los componentes de servidor en z/OS

Para permitir que el cliente Cognos Transformer se comunique con loscomponentes de servidor en z/OS, debe configurar las propiedades del entornocorrespondientes a Cognos Transformer en IBM Cognos Configuration.

Antes de empezar

Asegúrese de que los componentes de servidor de IBM Cognos BusinessIntelligence, incluido Cognos Transformer, están instalados, configurados y enejecución. Así se garantiza que el servicio de entidad emisora de certificados emiteun certificado para Cognos Transformer. Asegúrese de que el servidor web estéconfigurado y en ejecución.

Procedimiento1. En el sistema en el que ha instalado Cognos Transformer, inicie IBM Cognos

Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, en el cuadro URI de pasarela, cambie la parte de

nombre de host de URI de pasarela, localhost, por la dirección IP del sistema opor el nombre de sistema.v Para utilizar una pasarela de servlet, utilice la sintaxis siguiente:

http[s]://nombre_host:puertoraíz_contexto/servlet/Gateway

donde raíz_contexto es el valor que asignó a la aplicación web ServletGatewaycuando se desplegó la aplicación ServletGateway.

v Si no utiliza un servidor web, para utilizar el asignador como pasarela,utilice la sintaxis siguiente:http[s]://nombre_host:puerto/p2pd/servlet/dispatch

4. Especifique el valor para el URI de asignador para aplicaciones externas.v Si el servidor web está configurado para no permitir el acceso anónimo,

escriba el URI del asignador.Asegúrese de que cambia el nombre de host localhost en el URI.

v Si el servidor web soporta la codificación de transferencia truncada e CognosFramework Manager se encuentra dentro del cortafuegos, escriba el URI delasignador.Asegúrese de que cambia el nombre de host localhost en el URI.

v Si utiliza una pasarela dedicada para la comunicación con una herramientade modelado,escriba el URI de asignador.

5. En el panel Explorador, en Criptografía, pulse Cognos, el proveedorcriptográfico predeterminado.

6. En el grupo de propiedades Configuración de la entidad emisora decertificados, en la propiedad Contraseña, escriba la contraseña que haconfigurado para el Content Manager activo predeterminado.



8. Si ha instalado Cognos Transformer en un sistema Windows Vista, actualice laspropiedades de ubicación de archivo.a. Inicie la sesión como administrador.b. En el directorio ubicación_c10\configuration, abra el archivo cogtr.xml en

un editor de texto.c. Localice todos los valores que utilizan una ruta relativa, "..\directorio".d. Sustituya el elemento de ruta relativa, "..", por la misma variable de entorno

y el mismo directorio raíz que se utiliza para las ubicaciones de archivo enel resto de los sistemas IBM Cognos BI.

e. Guarde el archivo como cogtr.xml.f. En el directorio ubicación_c10\CS7Gateways\bin, abra el archivo cs7g.ini en

un editor de texto.g. Añada las ubicaciones de los orígenes de datos IBM Cognos Series 7 al

archivo.h. Guarde el archivo.

Los cambios se aplicarán la próxima vez que abra Cognos Transformer.

Prueba de la instalación de cliente de Cognos TransformerVerifique que la instalación de Cognos Transformer funciona para asegurarse deque Cognos Transformer puede comunicarse con los componentes de servidor deIBM Cognos Business Intelligence en z/OS.

Procedimiento

Para iniciar IBM Cognos Transformer, en el menú Inicio, pulse Programas > IBMCognos > Transformer.Para iniciar IBM Cognos Transformer manualmente, efectúe una doble pulsaciónen el archivo cogtr.exe del directorio ubicación_c10\bin.Si ve la ventana de Cognos Transformer, la instalación funciona.

Instalación de IBM Cognos Software Development Kit en sistemasCognos Framework Manager

Si tiene la intención de crear y publicar modelos utilizando la API de CognosFramework Manager, debe instalar IBM Cognos Software Development Kit.

Antes de empezar

Asegúrese de que los componentes de IBM Cognos BI, incluido CognosFramework Manager, están instalados.

Si tiene la intención de utilizar el conector de Microsoft Excel de ejemplo, debetener el archivo MSINET.OCX instalado en la subcarpeta System32 de la carpetaWindows.


Instale los archivos de Software Development Kit desde el CD IBM CognosSoftware Development Kit en cada sistema en el que se vayan a desarrollaraplicaciones de IBM Cognos Software Development Kit, en la misma ubicación deinstalación que Cognos Framework Manager.



v Inserte el disco de IBM Cognos Software Development Kit en todos lossistemas en los que ha instalado Cognos Framework Manager.Si el asistente de instalación no se abre automáticamente, vaya al directoriodel sistema operativo y efectúe una doble pulsación en issetup.exe.

v Vaya a la ubicación en la que se han descargado y extraído los archivos deinstalación y, a continuación, efectúe una doble pulsación en issetup.exe.

2. Siga las instrucciones del asistente de instalación para copiar los archivosnecesarios en la ubicación en la que ha instalado Cognos Framework Manager.Una vez finalizada la instalación, puede acceder a la documentación de IBMCognos Software Development Kit mediante el atajo del menú Inicio deWindows.

3. Si desea ejecutar el reproductor de script de Cognos Framework Managerdesde fuera del directorio ubicación_c10\bin, configure la variable de entornoFM_INI_FILE_PATH como variable del sistema en Windows.La variable de entorno debe señalar al directorio ubicación_c10\configuration\fm.ini.

4. Para permitir la búsqueda o la importación de objetos del sistema tales comotablas, vistas, sinónimos, procedimientos almacenados o funciones desde unabase de datos relacional en Cognos Framework Manager, edite la entradacorrespondiente a ImportDatabaseSystemObjects en el archivo fm.ini.De forma predeterminada, ImportDatabaseSystemObjects tiene el valor FALSE.Los usuarios pueden ver solamente las tablas de usuario en la importación ylos cuadros de diálogo del editor de expresiones. Para permitir la búsqueda o laimportación de los objetos del sistema, establezca la preferencia en TRUE.

Instalación de la documentación traducida del producto en lossistemas Windows

La instalación del producto en Windows incluye un conjunto limitado dedocumentación traducida a algunos idiomas. Para acceder al conjunto completo dedocumentación traducida en los sistemas en los que se ha instalado CognosFramework Manager o Cognos Transformer, debe instalar la documentación deIBM Cognos Business Intelligence Supplementary Languages Documentation.

Antes de empezar

Asegúrese de que se han efectuado las tareas siguientes:v Se han instalado los componentes de Windows.

No puede instalar Supplementary Languages Documentation en una ubicaciónnueva. La documentación debe estar instalada sobre una instalación existente.

v Se dispone de espacio de disco suficiente.Necesita al menos 220 MB de espacio de disco.


v Inserte el disco de IBM Cognos Supplementary Languages Documentation entodos los sistemas en los que ha instalado Cognos Framework Manager y elcliente Cognos Transformer.


Si el asistente de instalación no se abre automáticamente, vaya al directoriodel sistema operativo y efectúe una doble pulsación en el archivoissetup.exe.


2. Siga las instrucciones del asistente de instalación para copiar los archivosnecesarios en la ubicación en la que ha instalado Cognos Framework Managery el cliente Cognos Transformer.

3. Cuando se le solicite que seleccione los componentes que se instalarán,asegúrese de que Fuentes de idiomas adicionales no esté seleccionado.Para añadir soporte para los caracteres del yen japonés o del won coreano,debe instalar fuentes adicionales en el sistema z/OS en el que están instaladoslos componentes de nivel de aplicación.

4. En la página Finalizar del asistente de instalación, elija la opción que desee.La documentación traducida del producto está disponible localmente.

Desinstalación de los componentes de WindowsUtilice el programa de desinstalación para eliminar los componentes de Windows.

Antes de empezar

Cierre todos los programas antes de desinstalar. De lo contrario, puede quealgunos archivos no se eliminen.

Procedimiento1. En el menú Inicio, pulse Programas > IBM Cognos > Desinstalar IBM Cognos

> Desinstalar IBM Cognos.2. Siga las instrucciones del asistente de desinstalación para desinstalar los

componentes.El archivo cognos_uninst_log.htm registra las actividades que el asistente paradesinstalación realiza durante la desinstalación de los archivos. Para encontrarel archivo de registro, busque en el directorio temp.

3. Suprima todos los archivos temporales de Internet de los navegadores web delos sistemas.Para obtener más información, consulte la documentación del navegador web.

Resultados

La desinstalación no elimina ningún archivo que haya cambiado desde lainstalación, como los archivos de datos de usuario y configuración. La ubicación deinstalación permanece en su sistema y estos archivos se conservan hasta que lossuprima mediante el programa Explorador de Windows.


Capítulo 13. Tareas de configuración opcionales paraFramework Manager

Framework Manager está diseñado para funcionar en numerosos entornos.Inicialmente se establece un número de propiedades de configuraciónpredeterminadas para permitir que funcionen con los mínimos cambios. Cambie elcomportamiento predeterminado después de realizar una instalación básicacorrectamente.

Actualización de las propiedades de ubicación de archivo paraCognos Framework Manager en sistemas Windows Vista

Si instala componentes de cliente de IBM Cognos en sistemas Windows Vista, debecambiar las propiedades de las ubicaciones de los archivos en IBM CognosConfiguration para asegurarse de que el producto utiliza una sola ubicación dedatos para todos los usuarios.


Windows Vista tiene una mejora de seguridad que impide a múltiples usuarioscompartir ubicaciones de datos. Puede definir variables de entorno y utilizarlas enIBM Cognos Configuration al especificar ubicaciones de archivo. Esto le permitedirigir los archivos aplicables a un área accesible para los usuarios de IBM Cognos.En Windows, hay dos variables de entorno predeterminadas para usuarios: unapara todos los usuarios y otra para el usuario específico.

Dado que las variables de entorno representan ubicaciones de la raíz del sistema,puede incluir el nombre del directorio raíz de la ubicación de instalación cuandoespecifique las ubicaciones de archivo en IBM Cognos Configuration.

Además, si instala Cognos Transformer en un sistema Windows Vista y piensautilizar el archivo de ejemplo cogtr.xml como una plantilla, debe actualizar laspreferencias predeterminadas en el archivo de configuración de CognosTransformer.

Procedimiento1. En todos los sistemas en los que estén instalados los componentes de modelado

de IBM Cognos, inicie IBM Cognos Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, pulse Ubicación de archivos de despliegue.4. Sustituya el elemento de ruta relativa, "..", por la variable de entorno y el

directorio raíz adecuados:v Para una ubicación de archivo única por usuario, utilice %LOCALAPPDATA%

v Para una ubicación de archivo única para todos los usuarios del sistema,utilice %PUBLIC%

5. Repita el paso 4 para las siguientes propiedades:


Tabla 46. Propiedades y grupo funcional

Grupo funcional del Explorador Propiedad

Entorno Ubicación de archivos de datos

Ubicación de archivos de mapa

Ubicación de archivos temporales

Entorno, Registro, Archivo Ubicación del archivo de registro

Criptografía Ubicación del almacén de claves simétricascomunes

Criptografía, Cognos Ubicación de certificado

Ubicación del almacén de claves de firma

Ubicación del almacén de claves de cifrado


Resultados

Las variables de entorno se resuelven cuando se accede a las ubicaciones dearchivo durante las actividades de sistema.

Actualización del archivo de preferencias de ejemplo de CognosTransformer para sistemas Windows Vista

Si desea utilizar el archivo cogtr.xml.samples como plantilla, debe editar losvalores de preferencias predeterminados.


Gracias a las mejoras de seguridad en Windows Vista, Microsoft ha cambiado laestructura de los directorios de usuario. Si desea que todos los usuarios tengan losmismos directorios predeterminados, debe cambiar las preferenciaspredeterminadas a una ubicación común a la que tendrán acceso los usuarios. Sidesea que los usuarios tengan los directorios de Windows Vista, puede suprimirlas preferencias predeterminadas para los directorios.

Procedimiento1. Inicie la sesión como administrador.2. En el directorio ubicación_c10\configuration, abra el archivo

cogtr.xml.sample en un editor de texto en modo elevado pulsando con elbotón derecho del ratón en el editor de texto y seleccionando Ejecutar comoadministrador.

3. Si desea que todos los usuarios tengan los mismos directorios predeterminados,cambie los directorios a una ubicación en la que todos los usuarios tenganacceso de lectura y escritura.Los directorios que deben cambiarse son los siguientes:v <Preference Name="CubeSaveDirectory" Type="string" Value="..\temp"/>

v <Preference Name="DataSourceDirectory" Type="string"Value="..\temp"/>

v <Preference Name="DataWorkDirectory" Type="string" Value="..\temp"/>

v <Preference Name="LogFileDirectory" Type="string" Value="..\logs"/>


v <Preference Name="ModelSaveDirectory" Type="string" Value="..\temp"/>

v <Preference Name="ModelWorkDirectory" Type="string" Value="..\temp"/>

4. Si desea que los usuarios tengan los directorios predeterminados de WindowsVista, suprima las preferencias especificadas en el paso 3 del archivo.Los directorios predeterminados de Cognos Transformer en el sistema operativoWindows Vista se indican en la tabla siguiente.

Tabla 47. Directorios y ubicaciones predeterminados para Cognos Transformer

Directorio Ubicación

CubeSaveDirectory Documents\Transformer\PowerCubes

DataSourceDirectory En IBM Cognos Configuration, en Entorno, propiedadUbicación de archivos de datos

LogFileDirectory Documents\Transformer\Logs

ModelSaveDirectory Documents\Transformer\Models

ModelWorkDirectory En IBM Cognos Configuration, en Entorno > propiedadUbicación de archivos temporales

5. Cambie otros valores según sea necesario.6. Guarde el archivo como cogtr.xml.

Los cambios se aplicarán la próxima vez que abra Cognos Transformer.Conceptos relacionados:“Versiones del protocolo de Internet” en la página 136IBM Cognos Business Intelligence for z/OS da soporte a IPv4 e IPv6.

Creación de una ubicación de instalación de red para modeladores deCognos Transformer

Su organización podría tener usuarios avanzados o empresariales especializadosque deseen crear PowerCubes que se modelan a partir de una combinación deorígenes de datos personales y empresariales. Estos usuarios podrían quererrealizar sus propios análisis de los datos de su línea de negocios o de un pequeñogrupo de usuarios. Un instalador o un administrador puede descargar un archivoejecutable en una ubicación web o LAN, donde los modeladores pueden ejecutar elarchivo para lanzar el asistente de instalación de IBM Cognos Transformer.

Antes de empezar

Los modeladores deben tener privilegios para crear un origen de datos en IBMCognos Administration. Los modeladores no necesitan acceso directo a IBMCognos Administration. Pueden crear y actualizar orígenes de datos utilizandoherramientas de línea de comandos o Cognos Transformer. Puede proporcionar alos modeladores una carpeta protegida en IBM Cognos Connection para quepubliquen en ella los paquetes PowerCube.

Los modeladores deben tener acceso a una ubicación en la que almacenar elPowerCube una vez creado. Esta ubicación también debe ser accesible para elservicio de IBM Cognos BI y puede ser un recurso compartido protegido en unaLAN.

Para crear PowerCubes en un servidor Cognos Transformer específico, losmodeladores deben tener privilegios de FTP para transferir modelos y privilegiosde ejecución para crear cubos en ese servidor. Los modeladores pueden transferir

Capítulo 13. Tareas de configuración opcionales para Framework Manager 125

modelos y ejecutar creaciones de cubos mediante archivos de secuencia decomandos. Los modeladores también pueden utilizar métodos automáticos paracrear PowerCubes.

Procedimiento1. Inserte el disco del producto de modelado de IBM Cognos Transformer o vaya

a la ubicación en la que archivos de instalación se han descargado y extraído.2. Si aparece la página de Bienvenida del asistente de instalación, salga del

asistente.3. En el disco, localice el archivo C8transformerinstall.exe.4. Copie el archivo en una ubicación segura a la que tengan acceso los

modeladores de Cognos Transformer.

Exportación de los archivos de configuración de IBM CognosTransformer

Para configurar los archivos de instalación de IBM Cognos Transformer para losmodeladores, copie un archivo de configuración exportado desde un sistemaCognos Transformer para utilizarlo con todos los demás sistemas CognosTransformer y, a continuación, ejecute una configuración silenciosa.


Para exportar la configuración, el sistema de origen debe tener los mismoscomponentes de IBM Cognos Business Intelligence que los sistemas CognosTransformer de destino.

Si algunos modeladores instalan en sistemas Windows Vista, debe crear un archivode exportación desde un sistema Windows Vista. Cree carpetas separadas en laubicación web o LAN para Windows y Windows Vista.

Procedimiento1. En IBM Cognos Configuration, pulse Archivo > Exportar como.2. Si desea exportar la configuración actual a una carpeta distinta, busque y abra

la carpeta en el cuadro Buscar en.Asegúrese de que la carpeta está protegida frente a accesos no autorizados.

3. En el cuadro Nombre de archivo, escriba un nombre para el archivo deconfiguración.

4. Pulse Guardar.5. Cambie el nombre del archivo exportado por cogstartup.xml.6. Copie el archivo cogstartup.xml exportado desde el sistema de origen en la

misma ubicación web o LAN que el archivo de instalación de CognosTransformer.

7. Si ha cambiado la configuración global del sistema de origen, copie el archivocoglocale.xml del sistema de origen en la misma ubicación web o LAN que elarchivo de instalación de Cognos Transformer.La ubicación predeterminada del archivo coglocale.xml esubicación_c10\configuration.

8. Si ha actualizado el archivo cogtr.xml, cópielo desde el directorioubicación_c10\configuration en la misma ubicación web o LAN que elarchivo de instalación de Cognos Transformer.


9. Si ha actualizado el archivo cs7g.ini, cópielo desde el directorioubicación_c10\CS7Gateways\bin en la misma ubicación web o LAN que elarchivo de instalación de Cognos Transformer.

Despliegue de Cognos Transformer para modeladoresUn especialista empresarial o un modelador de Cognos Transformer despliegaCognos Transformer para crear PowerCubes y publicarlos para su uso por parte deusuarios o grupos seleccionados.

Antes de empezar

Si IBM Cognos Connection está protegido, debe tener privilegios para crearorígenes de datos y publicar paquetes en IBM Cognos Connection.

Procedimiento1. En la ubicación web o LAN que ha proporcionado el administrador, ejecute el

archivo C8transformerinstall.exe.El contenido se expande en el directorio Documents and Settings\nombre_usuario\Local settings\Temp y, a continuación, se abre el asistente deinstalación de Cognos Transformer.

2. Siga las indicaciones del asistente de instalación y copie los archivos necesariosen el sistema.

3. En la página Finalizar del asistente, seleccione Ver las notas de la versión y, acontinuación, pulse Finalizar.

4. Cree una variable de entorno MANPATH y configúrela con el siguiente valor:/ubicación_c10/webcontent/documentation/en/cogtr_a.html

El documento cogtr_a.html proporciona la sintaxis para las opciones de líneade comandos de UNIX que están soportadas por IBM Cognos Transformer. Esposible acceder a la página man de IBM Cognos Transformer desde UNIXescribiendo cogtr man desde el directorio ubicación_c10/bin.

5. Vaya a la misma ubicación web o LAN que el archivo de instalación de CognosTransformer.

6. Si hay archivos .xml, cópielos en el directorio ubicación_Transformer\configuration.

7. Vaya al directorio ubicación_Transformer\bin.8. Escriba el comando de configuración:

./cogconfig.bat -s

IBM Cognos Configuration aplica los valores de configuración especificados enla copia local de cogstartup.xml, cifra las credenciales, genera los certificadosdigitales e inicia el servicio de IBM Cognos BI.

9. Para probar IBM Cognos Transformer, en el menú Inicio, pulse Programas,IBM Cognos BI, Transformer.Si ve la ventana de Transformer, la instalación funciona.

Capítulo 13. Tareas de configuración opcionales para Framework Manager 127

Capítulo 14. Opciones de configuración y ejemplos para loscomponentes de servidor

Originalmente, se utilizan los valores predeterminados de las propiedades elegidospor IBM Cognos para configurar los componentes. Después de instalar yconfigurar una instalación básica, puede cambiar una serie de valores si lascondiciones existentes hacen que los valores predeterminados sean inapropiados, opara que se ajusten mejor a su entorno. Puede configurar el sistema en el momentoen que lo necesite, a medida que las condiciones cambien.

Creación de espacios de tabla para una base de datos denotificaciones en DB2 para z/OS

Si está utilizando DB2 para z/OS, un administrador de base de datos debe ejecutarscripts para crear un conjunto de espacios de tabla necesario para la base de datosde notificaciones. Los scripts deben modificarse para sustituir los parámetros demarcador por otros que sean apropiados para el entorno.

Asegúrese de que utiliza las convenciones de nomenclatura para DB2 para z/OS.Por ejemplo, todos los nombres de parámetros deben empezar por una letra y lalongitud no debe exceder de 6 caracteres. Para obtener más información, consulteel Information Center de IBM DB2.

Procedimiento1. Conéctese a la base de datos como un usuario con privilegios para crear y

descartar espacios de tabla y permitir la ejecución de sentencias SQL.2. Vaya al directorio ubicación_c10/configuration/schemas/delivery/zosdb2.3. Abra el archivo de script NC_TABLESPACES.sql y utilice la tabla siguiente para

que le sea más fácil reemplazar los parámetros de marcador de posición por losadecuados para el entorno.






No todos los parámetros listados están en el script, pero se pueden añadir en elfuturo.

4. Guarde y ejecute el script.5. Abra el archivo de script NC_CREATE_DB2.sql y sustituya el parámetro de

marcador de posición NCCOG por el nombre de la base de datos denotificaciones.

6. Guarde el script.


El servicio Job and Schedule Monitoring Service ejecutará automáticamente elscript. Sin embargo, puede optar por ejecutarlo cuando lo desee.

Configuración de la instalación de IBM Cognos Dynamic Cubes en elsistema z/OS

Para utilizar IBM Cognos Dynamic Cubes, seleccione la versión de 64 bits para elmodo de ejecución del servidor de informes para los componentes de nivel deaplicación. Instale IBM Cognos Dynamic Query Analyzer en un sistema Windowsy configúrelo para que se comunique con los componentes de servidor de IBMCognos Business Intelligence en el sistema z/OS.

Procedimiento1. En cada instalación del componente de nivel de aplicación, seleccione la versión

de 64 bits del servidor de informes.a. En el panel Explorador de IBM Cognos Configuration, pulse Entorno.b. Pulse en el cuadro Valor de Modo de ejecución del servidor de informes y

seleccione 64 bits.c. Pulse Archivo > Guardar.

2. Instale IBM Cognos Dynamic Query Analyzer en un sistema Windows.a. Inserte el disco o vaya a la ubicación donde haya descargado y extraído los

archivos del fixpack.b. En el disco o en la ubicación de descarga, vaya al directorio win32 y efectúe

una doble pulsación en el archivo issetup.exe.c. Siga las instrucciones del asistente para la instalación.

Puede instalar Dynamic Query Analyzer en la misma ubicación que otrosproductos o en una ubicación diferente.

3. En el sistema Windows, configure Dynamic Query Analyzer para que secomunique con los componentes de servidor de IBM Cognos BusinessIntelligence.a. En el menú Inicio, pulse Programas > IBM Cognos 10 > IBM Cognos

Dynamic Query Analyzer.b. Pulse Ventana > Preferencias.c. En el panel de navegación, pulse Servidor.d. Cambie el URI de asignador de modo que señale a la ubicación y el puerto

del servidor de IBM Cognos BI que se ejecuta en el sistema z/OS.e. Si utiliza el contenedor de servlet Tomcat, cambie el URI de pasarela de

modo que señale a la ubicación y el puerto que utiliza IBM HTTP Server.f. Si utiliza WebSphere Application Server, cambie el URI de pasarela de modo

que utilice el mismo valor que el URI de asignador.g. Si IBM Cognos Business Intelligence está protegido, escriba su nombre de

usuario en el cuadro Nombre y la contraseña en el cuadro Contraseña yseleccione un Espacio de nombres adecuado. Si ha cambiado los valores delservidor, pulse Renovar para obtener una lista de los espacios de nombrespara el servidor.

h. En el cuadro URL del directorio de registros, especifique la ruta aldirectorio <ubicación_instalación>/logs/XQE del servidor. Este enlacepuede ser un enlace de protocolo http:// o file://. El administrador delservidor debe compartir esta ubicación ya que forma predeterminada no secomparte.


i. Si el enlace URL del directorio de registros está protegido, especifique elnombre de usuario requerido en el cuadro Nombre y la contraseña en elcuadro Contraseña.

j. Pulse Aceptar.4. Pruebe la configuración de Dynamic Query Analyzer.

a. En Dynamic Query Analyzer, pulse Windows > Mostrar vista.b. En el cuadro de diálogo Mostrar vista, seleccione Navegación > Almacén

de contenido y pulse Aceptar.Si la configuración es correcta, en el panel Almacén de contenido sevisualiza el contenido de IBM Cognos procedente del servidor especificado.

Conceptos relacionados:“Instalación de IBM Cognos Dynamic Cubes” en la página 2IBM Dynamic Cubes son bases de datos optimizadas que proporcionan unrendimiento de las consultas de alta velocidad en conjuntos de metadatos grandespara la creación de informes y análisis de Business Intelligence.“IBM Cognos Dynamic Query Analyzer” en la página 3IBM Cognos Dynamic Query Analyzer proporciona una interfaz gráfica para losregistros del árbol de ejecución producidos por las consultas de modo de consultadinámica.

Cambio de los valores de configuración predeterminadosPara que se ajuste mejor a su entorno, puede cambiar el valor predeterminado deuna propiedad o el valor que se hubiese establecido con anterioridad medianteIBM Cognos Configuration.

Cuando se cambia el valor de una propiedad, IBM Cognos Configurationcomprueba si se ha escrito el tipo de datos correcto y, si procede, si el valor estácomprendido dentro del rango necesario. Para poder guardar una configuración,debe especificar valores para las propiedades obligatorias, indicadas mediante unasterisco rojo.

Procedimiento1. Inicie IBM Cognos Configuration.2. En el panel Explorador, pulse el grupo, el componente o el recurso que desee:

El panel Propiedades muestra los valores de propiedad correspondientes alobjeto seleccionado.

3. Pulse el valor que desea cambiar.4. Escriba el nuevo valor de propiedad y pulse Intro.

Si el valor es válido, el valor se cambia por el valor nuevo. De lo contrario, semuestra un mensaje de error que indica el origen del error.

5. Si cambia el valor de una propiedad mientras el servicio de IBM Cognos estáen ejecución, debe reiniciar el servicio antes de que el cambio se aplique susistema.

Estructura de los valores de URILos elementos de un URI de IBM Cognos dependen del componente de IBMCognos.

Por ejemplo, el URI para los componentes de IBM Cognos utilizan la siguienteestructura:

Capítulo 14. Opciones de configuración y ejemplos para los componentes de servidor 131

v En el caso de un URI de Content Manager, URI de asignador para aplicacionesexternas o URI de asignadorprotocolo://nombre_host_o_IP:puerto/raíz_contexto/ruta_alias

v En el caso de un URI de pasarela o un URI de contenido web, la estructura delURLprotocolo://nombre_host_o_IP:puerto/directorio_virtual/aplicación_pasarela

Elementos de URI

Los elementos se describen en la siguiente tabla:

Tabla 49. Elementos de URI y su descripción

Elemento Descripción

protocolo Especifica el protocolo utilizado para solicitar y transmitirinformación; puede ser protocolo de transferencia dehipertexto (HTTP) o protocolo seguro de transferencia dehipertexto (HTTPS).

Ejemplo: http o https

nombre de host o IP Especifica la identidad del host en la red. Puede utilizar unadirección IP, un nombre de sistema o un nombre de dominiocompleto.

En una instalación distribuida, debe cambiar el elementolocalhost de un URI.

En un entorno mixto de servidores UNIX y Windows,asegúrese de que todos los servidores del entorno puedenresolver los nombres de host como direcciones IP.

Ejemplo: localhost o 192.168.0.1 o[2001:0db8:0000:0000:0000:148:57ab]:80

puerto Especifica el puerto en el que el sistema host atiende lassolicitudes.

El puerto predeterminado para Tomcat es 9300. El puertopredeterminado para un servidor web es 80.

Ejemplo: 9300 u 80

raíz contexto Tomcat o un servidor de aplicaciones la utilizan paradeterminar el contexto de la aplicación para que la solicitudse pueda direccionar a la aplicación web correcta para suprocesamiento.

Ejemplo: p2pd

ruta alias El servidor de aplicaciones la utiliza para direccionar unasolicitud al componente correcto de una aplicación web.

La ruta alias no debe modificarse; de lo contrario, loscomponentes de IBM Cognos BI no funcionaráncorrectamente.

Ejemplo: servlet/dispatch


Tabla 49. Elementos de URI y su descripción (continuación)

Elemento Descripción

directorio virtual El servidor web lo utiliza para correlacionar un alias o undirectorio virtual con una ubicación física.

Por ejemplo, en el URI de pasarela predeterminado dehttp://localhost:80/ibmcognos/cgi-bin/cognos.cgi, eldirectorio virtual es ibmcognos/cgi-bin.

Ejemplo: ibmcognos/

aplicación pasarela Especifica el nombre de la aplicación de la pasarela deCognos utilizada.

Por ejemplo, si va a acceder a los componentes de IBMCognos BI mediante una interfaz de pasarela común (CGI), laaplicación de pasarela predeterminada será cognos.cgi.

Ejemplo: cognos.cgi

Cambio de un puerto o de un valor de URISegún su entorno, puede que tenga que cambiar algunos elementos en un URI,como el puerto o el nombre de host.

Procedimiento1. Inicie IBM Cognos Configuration.2. En el panel Explorador, pulse el grupo o componente que corresponda:

v Para cambiar un elemento para el asignador, pulse Entorno.v Para cambiar un elemento para el servidor de registro local, en Entorno,

pulse Registro.3. En el panel Propiedades, pulse el cuadro Valor situado junto a la propiedad de

URI que desea cambiar.4. Seleccione el elemento y escriba la nueva información.

v Para cambiar el puerto utilizado por el asignador local, cambie el valor de lapropiedad URI de asignador interno.Dado que el cambio afecta a todos los URI basados en el asignador local,debe cambiar los URI de todos los componentes locales.

v Si cambia el puerto del asignador en el URI de asignador, asegúrese deespecificar el nuevo número de puerto al configurar los sistemas remotos queutilizan los servicios del asignador, Content Manager o IBM Cognos SoftwareDevelopment Kit en este sistema.


Configuración de la ubicación de salida de informeDe forma predeterminada, los archivos de salida de informe se guardan en elalmacén de contenido. Puede guardar una copia de la salida de informe en otraubicación de archivo. Si utiliza esta opción, también se guardará un archivodescriptor con la extensión _descr. Los archivos guardados no están gestionadospor IBM Cognos.



Si configura una ubicación de sistema de archivos que se encuentre dentro de IBMCognos, puede utilizar la salida de informe de nuevo. Esto también puede ser útilpara fines de archivado, porque los archivos que se guardan en el almacén decontenido se pueden suprimir regularmente debido a las reglas de conservación.

Para compartir la salida de informe con aplicaciones externas o con usuarios queno tienen el software de IBM Cognos, configure una ubicación de sistema dearchivos que esté fuera de IBM Cognos.

Procedimiento1. Cree un directorio para el sistema de archivos.

Asegúrese de que el directorio solamente es accesible para los usuariosautorizados.

2. En la ubicación de instalación de Content Manager, inicie IBM CognosConfiguration.

3. Para guardar la salida de informe fuera del producto, siga estos pasos:a. En el panel Explorador, pulse Acceso a datos > Content Manager.b. En la propiedad Guardar las salidas de informes en un sistema de

archivos, pulse Verdadero.c. Para probar la conexión con el directorio de salida de informe, pulse

Acciones > Probar.4. Para guardar la salida de informe dentro del producto, siga estos pasos:

a. Pulse Acciones > Editar configuración global.b. En el cuadro de diálogo Configuración global, pulse la pestaña General.c. En Raíz del sistema de archivos de la ubicación de archivo, escriba un URI

utilizando el formato.file://directorio

donde directorio es el directorio que se ha creado en el paso 1.Es necesario especificar la parte file:// del URI.

d. Para confirmar que se utilizará la ubicación correcta, pulse Probar.5. Pulse Archivo > Guardar.


Si guarda la salida de informe dentro del producto, un administrador debeconfigurar la ubicación de los archivos mediante el parámetro CM.OutPutLocationen IBM Cognos Administration. Para obtener más información, consulte el temasobre el establecimiento de una ubicación de archivo para la salida de informeguardada dentro de IBM Cognos en la publicación Guía de administración yseguridad.

Cambio de ubicación de los gráficos de mapa para IBMCognos Report Studio

IBM Cognos BI se entrega con un conjunto de gráficos de mapa que puede utilizaren Cognos Report Studio. De forma predeterminada, los gráficos de mapa sealmacenan en el directorio ubicación_c10/maps del sistema de Componentes denivel de aplicación. Puede cambiar la ubicación de los gráficos de mapa medianteIBM Cognos Configuration.


Procedimiento1. En el sistema de los componentes de nivel de aplicación, inicie IBM Cognos

Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, pulse el valor de Ubicación de archivos de mapa.4. Pulse el botón de edición.5. En el cuadro de diálogo Seleccionar carpeta, vaya hasta el directorio que desee

y, a continuación, pulse Seleccionar.6. Pulse Archivo > Guardar.

Valores de cookie utilizados por los componentes de IBMCognos

Los componentes de IBM Cognos determinan el dominio de cookies a partir de lasolicitud HTTP enviada por el cliente, que suele ser un navegador web.

En la mayoría de las configuraciones de red, las solicitudes HTTP pasan porintermediarios como servidores proxy y cortafuegos mientras se transmiten desdeel navegador a los componentes de IBM Cognos. Algunos intermediarios modificanla información que los componentes de IBM Cognos utilizan para calcular eldominio de cookies, y los componentes de IBM Cognos no pueden configurar lascookies posteriormente. El síntoma habitual de este problema es que se solicitarepetidamente a los usuarios que inicien sesión. Para evitar este problema,configure el dominio de las cookies.

Para establecer el valor correcto para el dominio de las cookies, utilice el formato yel valor que representan la más amplia cobertura para el host como se sugiere enla siguiente tabla.

Tabla 50. Host y formatos de host para dominios

Host Formato de host para el dominio

sistema o servidor nombre del sistema o del servidor (sinpuntos)

Ejemplo: miempresa

El sufijo es .com, .edu, .gov, .int, .mil, .net u.org.

.nombre.sufijo

(dos puntos)

Ejemplo: .miempresa.com

otro .nombre1.nombre2.sufijo

(tres puntos)

Ejemplo: .travelinfo.co.nz

Personalización de los valores de las cookiesSegún los requisitos de su entorno de IBM Cognos, puede que tenga que modificarlos valores que los componentes de IBM Cognos utilizan para crear cookies.

Procedimiento1. En cada ubicación de instalación de Content Manager, inicie IBM Cognos

Configuration.2. Pulse Acciones > Editar configuración global.


3. Pulse la pestaña General.4. Pulse en la columna Valor en Valores de cookies para cada propiedad que

desee cambiar y escriba el nuevo valor.Si deja la propiedad Dominio en blanco, el asignador deriva el dominio apartir del nombre de host de la solicitud.

5. Pulse Aceptar.

Versiones del protocolo de InternetIBM Cognos Business Intelligence for z/OS da soporte a IPv4 e IPv6.

En IBM Cognos Configuration, puede seleccionar IPv4 o IPv6 para la comunicaciónde IBM Cognos BI mediante la propiedad Versión de IP para la resolución delnombre de host. Por ejemplo:v IPv4: 192.168.0.1:80v IPv6: [2001:0db8:0000:0000:0000:148:57ab]:80

El valor se aplica solamente a la instalación en la que está definido. Si seleccionaUtilización de direcciones IPv4, todas las conexiones de salida de IBM Cognos BIen este sistema se establecerán mediante IPv4, y el asignador solamente aceptaráconexiones IPv4 de entrada. Si selecciona Utilización de direcciones IPv6, todaslas conexiones de salida de IBM Cognos en este sistema se establecerán medianteIPv6, y el asignador aceptará conexiones tanto IPv4 como IPv6 de entrada.

Las instalaciones cliente IPv4 pueden comunicarse con el asignador en lasinstalaciones de IBM Cognos que están configuradas para IPv6.

Los nombres de host especificados dentro de un URI se resuelven en función delvalor de la propiedad Versión de IP para la resolución del nombre de host. Sinembargo, si un URI se ha especificado con una dirección numérica, tiene prioridadrespecto a este valor, y la comunicación se realiza mediante IPv4.

Para que IBM Cognos Configuration acepte direcciones IPv6 en las propiedades delURI locales, debe iniciar IBM Cognos Configuration mediante la opción -ipv6.Puede especificar la opción cada vez que abra IBM Cognos Configuration desde lalínea de comandos.

En los sistemas Windows, puede establecer la opción de forma permanenteañadiéndola al atajo del menú Inicio.Tareas relacionadas:“Actualización del archivo de preferencias de ejemplo de Cognos Transformer parasistemas Windows Vista” en la página 124Si desea utilizar el archivo cogtr.xml.samples como plantilla, debe editar losvalores de preferencias predeterminados.

Cambio de la versión del protocolo de Internet por IPv6IBM Cognos BI soporta dos versiones de dirección IP: IPv4 e IPv6. IPv4 utilizadirecciones IP de 32 bits e IPv6 utiliza direcciones IP de 128 bits. De formapredeterminada se utiliza IPv4.

Procedimiento1. Inicie IBM Cognos Configuration.2. En el panel Explorador, pulse Entorno.


3. Pulse el cuadro Valor de Versión de IP para la resolución del nombre de hosty pulse Utilización de direcciones IPv4 o Utilización de direcciones IPv6.


Habilitación de la opción IPv6 al iniciar IBM CognosConfiguration

Para que IBM Cognos Configuration acepte direcciones IPv6 en las propiedades delURI locales, debe iniciar IBM Cognos Configuration mediante la opción -ipv6.Puede especificar la opción cada vez que abra IBM Cognos Configuration desde lalínea de comandos.

Procedimiento1. Vaya al directorio ubicación_c10/bin.2. Inicie IBM Cognos Configuration incluida la opción IPv6 en el comando:

./cogconfig.sh -ipv6

Para los componentes de Windows, escriba cogconfig.bat -ipv6

3. Edite las propiedades de URI que utilizan el formato IPv6 y escriba los valores.4. Pulse Archivo > Guardar.

Creación de otra instancia de Cognos Content DatabasePuede crear otra base de datos del almacén de contenido en Cognos ContentDatabase.


Durante la instalación de Cognos Content Database, se crea una base de datos eIBM Cognos ya está configurado para utilizar esa base de datos. Si desea instalarotra instancia de Cognos, debe hacerlo antes de configurar Content Manager.

Procedimiento1. En la ubicación en la que ha instalado la nueva instancia de Cognos Content

Database, en el directorio ubicación_c10/derby10.1.2.1/bin, utilice los scriptsij.bat o ij.ksh para crear una nueva base de datos.Utilice la sintaxis siguiente: connect 'jdbc:derby://host:puerto/nombre_bd;create=true;user=nombre_usuariopassword=contraseña';

Los archivos de base de datos de los archivos se encuentran en el directorioubicación_c10/contentstore.a. Asegúrese de que utiliza un nombre, un usuario y una contraseña diferentes

para el nuevo almacén de contenido.Por ejemplo, para crear una base de datos denominada contentstore2 en elpuerto número 1527 como usuario denominado cognos2 y con la contraseñacognos2, tendría que escribir: connect 'jdbc:derby://localhost:1527/contentstore2;create=true;user=cognos2;password=cognos2';

El nombre de la base de datos distingue entre mayúsculas y minúsculas.2. Cuando haya acabado de utilizar el programa de utilidad ij, desconéctese

mediante el comando siguiente: disconnect;


Cambio del nombre de usuario y la contraseñapredeterminados para Cognos Content Database

Si instala Cognos Content Database, se asigna un ID de usuario y una contraseña ala base de datos predeterminada que se crea. Seguramente querrá cambiar este IDde usuario y esta contraseña.


Las tareas de administración de Cognos Content Database se realizan con unprograma de utilidad llamado ij. Para obtener información acerca de este programade utilidad, consulte la documentación de Apache Derby. La documentación estádisponible en el directorio ubicación_c10/derby10.1.2.1/docs en el que hainstalado Cognos Content Database.

Procedimiento1. En la ubicación en la que ha instalado Cognos Content Database, vaya al

directorio ubicación_c10/derby10.1.2.1/bin.2. Inicie el programa de utilidad ij mediante el archivo de script ij.ksh.3. Conéctese a la base de datos predeterminada escribiendo el comando del

programa de utilidad ij siguiente:connect 'jdbc:derby://localhost:1527/cm;user=cognos;password=cognos';

Si ha cambiado el número de puerto predeterminado 1527, utilice el número depuerto correcto para Cognos Content Database.El nombre de base de datos predeterminado es cm y distingue entremayúsculas y minúsculas.

4. Cambie la contraseña predeterminada para el usuario cognos escribiendo elcomando del programa de utilidad ij siguiente:CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.user.cognos','NewPassword');

La nueva contraseña debe utilizarse para la siguiente conexión a la base dedatos.

5. Cierre el programa de utilidad ij escribiendo el comando siguiente: disconnect;

Creación de un nombre de usuario y una contraseñapredeterminados nuevos para Cognos Content Database

Si instala Cognos Content Database, puede crear un nombre de usuario y unacontraseña nuevos.

Procedimiento1. En la ubicación en la que ha instalado Cognos Content Database, vaya al

directorio ubicación_c10/derby10.1.2.1/bin.2. Inicie el programa de utilidad ij mediante el archivo de script ij.ksh.3. Conéctese a la base de datos predeterminada escribiendo el comando del

programa de utilidad ij siguiente: connect 'jdbc:derby://localhost:1527/cm;user=cognos;password=cognos';

Si ha cambiado el número de puerto predeterminado 1527, utilice el número depuerto correcto para Cognos Content Database.La base de datos predeterminada se llama cm. El nombre de la base de datosdistingue entre mayúsculas y minúsculas.


4. Cree un nuevo usuario; para ello, escriba el siguiente comando del programade utilidad ij: CALLSYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.user.NewUser','NewUserPassword');

5. Proporcione al usuario nuevo acceso completo a la base de datos; para ello,escriba el comando del programa de utilidad ij siguiente: CALLSYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.database.fullAccessUsers','cognos, NewUser');

La propiedad que está cambiando, la lista de usuarios, es un campo delimitadopor comas. En este paso, va a incluir el nuevo usuario en la lista de usuarioscon acceso completo. El usuario predeterminado, cognos, sigue formando partede la lista de usuarios con acceso completo. Puede eliminar el usuario cognos.

6. Cierre el programa de utilidad ij escribiendo el comando siguiente: disconnect;

Fuentes en informes con formato PDF y HTMLLos componentes de IBM Cognos utilizan fuentes para representar informes PDFen el servidor de IBM Cognos. Asimismo, los componentes de IBM Cognos utilizanfuentes para representar los gráficos que se utilizan en informes PDF y HTML.

Para mostrar la salida correctamente, las fuentes deben estar disponibles en ellugar en el que se representa el informe o el gráfico. En el caso de gráficos einformes PDF, las fuentes deben estar instaladas en el servidor de IBM Cognos. Siuna fuente solicitada no está disponible, los componentes de IBM Cognos lasustituyen por otra.

Dado que los informes HTML se representan en un navegador, las fuentesnecesarias deben estar instaladas en el sistema de todos los usuarios de IBMCognos que leerán el informe HTML. Si una fuente solicitada no está disponible, elnavegador la sustituirá por una fuente distinta.

Adición de fuentesPuede añadir fuentes que falten a la lista de fuentes soportadas.

De forma predeterminada, los componentes de IBM Cognos BI utilizan unconjunto de fuentes globales, que están disponibles en todas las ubicaciones delservidor de IBM Cognos.

Procedimiento1. En cada ubicación de Content Manager, inicie IBM Cognos Configuration.2. Pulse Acciones> Editar configuración global.3. Pulse la pestaña Fuentes.4. Pulse Añadir.5. En el cuadro Nombre de fuente soportada, escriba el nombre de la fuente y, a

continuación, pulse Aceptar.6. Pulse Archivo > Guardar.7. Instale fuentes nuevas en cada ubicación de componente de IBM Cognos.

Todas las fuentes globales, incluidas las fuentes nuevas que añada, deben estarinstaladas en todos los sistemas IBM Cognos de su entorno.

8. Si una fuente global no está instalada en todos los sistemas IBM Cognos, debecorrelacionar la fuente global con una fuente física instalada.


Especificación de la ubicación de las fuentes disponiblesDebe especificar la ubicación de instalación de todas las fuentes, incluidas lasfuentes que añade, a la lista de fuentes soportadas.


De forma predeterminada, la lista de fuentes contiene las fuentes instaladas en eldirectorio ubicación_c10/bin/fonts.

Procedimiento1. En cada ubicación en la que se hayan instalado los componentes de nivel de

aplicación, inicie IBM Cognos Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, en la propiedad Ubicaciones físicas de fuentes,

escriba la ubicación de las fuentes.Si hay varias rutas de fuentes, separe cada ruta mediante un punto y coma (;).Si utiliza un servidor de aplicaciones distinto de Tomcat, escriba la rutacompleta a la ubicación de las fuentes. Por ejemplo: ubicación_c10/bin/fonts.


Correlación de fuentes soportadas con fuentes instaladasPuede sustituir las fuentes globales, que no están instaladas en el sistema, porfuentes físicas.


Si añade una fuente a la lista de fuentes soportadas que no está instalada en elsistema de IBM Cognos, puede especificar qué fuente se debe utilizar comosustituto.

Si desea imprimir informes más rápidamente utilizando las fuentes PDFincorporadas, puede correlacionar una fuente global, como, por ejemplo Arial, conuna de las fuentes PDF incorporadas, como Helvetica-PDF:


aplicación, inicie IBM Cognos Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, pulse el cuadro Valor situado junto a la propiedad

Correlación de fuentes físicas y, a continuación, pulse el botón de edición.Se abre el cuadro de diálogo Valor: Correlación de fuentes físicas.

4. Pulse Añadir.5. En el cuadro Nombre de fuente global, escriba el nombre de la fuente que ha

añadido a la lista de fuentes soportadas.6. Pulse el cuadro Nombre de fuente física.

v Si conoce el nombre de la fuente física, escríbalo.v Si no conoce el nombre de fuente física, pulse el botón de edición. En el

cuadro de diálogo Nombre de fuente física, pulse Buscar ahora y, acontinuación, pulse un nombre de fuente en los resultados.

7. Repita los pasos del 4 al 6 para cada fuente global que requiera una correlación.8. Pulse Aceptar.



Cambio de fuentes incluidas para los informes PDFCuando un informe PDF se abre en Adobe Reader, todas las fuentes que se utilizanen dicho informe deben estar disponibles. Las fuentes deben estar incluidas en elinforme o estar instaladas en el sistema del usuario. Si una fuente no estádisponible en alguna de estas ubicaciones, Adobe Reader intentará reemplazarlapor una fuente adecuada. Esta sustitución puede provocar cambios en lapresentación del informe o que algunos caracteres no se visualicen.


Para garantizar que los informes PDF se muestran correctamente en Adobe Reader,IBM Cognos BI incluye las fuentes necesarias en los informes de formapredeterminada. Para minimizar el tamaño del archivo, IBM Cognos BusinessIntelligence únicamente incluye los caracteres (también denominados glifos) que seutilizan en el informe en lugar de todos los caracteres del conjunto de fuentes. IBMCognos BI únicamente incluye las fuentes si tienen licencia para incluirse. Lainformación de licencia está almacenada en la propia fuente e IBM Cognos BI lalee.

Si está seguro de que las fuentes empleadas en los informes están disponibles entodos los sistemas cliente, puede limitar o eliminar las fuentes incluidas parareducir el tamaño de los informes PDF. Cuando se limitan las fuentes, puedeespecificar si una fuente se incluye siempre o no se incluye nunca, mediante unalista de fuentes incluidas en IBM Cognos Configuration.

Procedimiento1. En la ubicación en la que está instalado Content Manager, inicie IBM Cognos

Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, en Valores de fuente, pulse el valor de Incluir

fuentes (servicio de informes por lotes) o Incluir fuentes (servicio deinformes) y, a continuación, pulse el botón de edición.

4. Si no utiliza el directorio de fuentes predeterminadas o si desea añadir una rutaa un directorio adicional, en el cuadro de diálogo Incluir fuentes en informesPDF, escriba la nueva ruta en el campo de rutas de fuente.Pulse Buscar ahora para obtener una lista de las fuentes disponibles en la rutao rutas especificadas.

5. En el caso de una fuente que estará siempre disponible en los sistemas cliente,desplácese hasta el nombre de la fuente y pulse la casilla de verificaciónNunca.IBM Cognos no incluye la fuente con ningún informe. Adobe Reader seleccionala fuente del sistema del usuario cuando se abre el informe.

6. En el caso de una fuente que puede no estar siempre disponible en los sistemascliente, desplácese hasta el nombre de la fuente y pulse la casilla de verificaciónSiempre.IBM Cognos incluye la fuente con todos los informes que la utilizan. AdobeReader utiliza la fuente incluida cuando se abre el informe.

7. Pulse Aceptar.


Cambio de la fuente predeterminada para los informes PDFPuede cambiar la fuente predeterminada que los componentes de IBM Cognosutilizan para los informes PDF. Puede ver esta fuente predeterminada al abrir uninforme.


Puede cambiar la fuente predeterminada en la ubicación donde está instaladoContent Manager. Una vez realizado el cambio, la fuente se convierte en lapredeterminada para todos los sistemas de su instalación.

Procedimiento1. En cada ubicación en la que está instalado Content Manager, inicie IBM Cognos

Configuration.2. En el menú Acciones, pulse Editar configuración global.3. Pulse la pestaña General.4. En el cuadro Valor, para Fuente predeterminada, escriba la fuente que desea

utilizar como predeterminada para los informes.5. Pulse Aceptar.6. Pulse Archivo > Guardar.7. En todos los sistemas con componentes de nivel de aplicación, asegúrese de

que la ubicación de instalación de la fuente predeterminada está especificada enla propiedad Ubicaciones físicas de fuentes (en Entorno en el panelExplorador ) o de que la fuente se encuentra en el directorio de fuentes deWindows.

8. Asegúrese de que la fuente predeterminada está instalada en todos los sistemasde su instalación de IBM Cognos.

Valores de seguridadExisten muchas propiedades que se pueden cambiar para mejorar la seguridad,incluidas las propiedades relacionadas con el cifrado, la autenticación y elprotocolo SSL.

Algunos de los valores de seguridad se establecen y se mantienen cuando IBMCognos se está ejecutando. Para obtener más información acerca de estos valores,consulte la publicación IBM Cognos Guía de administración y seguridad.

Valores criptográficos

Los componentes de IBM Cognos requieren un proveedor criptográfico; de locontrario, no se ejecutarán. Si suprime el proveedor criptográfico predeterminado,debe configurar otro proveedor para sustituirlo.

Puede configurar los siguientes valores criptográficos:v Valores criptográficos generalesv Valores para el proveedor criptográfico predeterminado

En una instalación distribuida, los sistemas IBM Cognos se comunican con ContentManager para determinar la confianza y obtener algunas claves criptográficas deContent Manager. Si cambia las claves criptográficas de Content Manager, porejemplo cambiando los servidores de aplicaciones o volviendo a instalar ContentManager, debe suprimir las claves criptográficas en el resto de las instalaciones de


IBM Cognos. A continuación, debe guardar la configuración en cada ubicación paraasegurarse de que los componentes de IBM Cognos pueden obtener las nuevasclaves criptográficas de Content Manager. Todos los componentes de IBM CognosBI de una instalación distribuida deben utilizar los mismos valores de proveedorcriptográfico.

SSL (Secure Sockets Layer)

El protocolo Secure Sockets Layer (SSL) se utiliza para proteger la comunicaciónentre los componentes de IBM Cognos.

Además, puede configurar conexiones SSL entre los componentes de IBM Cognosy otros servidores. Debe asegurarse de que SSL está configurado para los otrosservidores antes de configurar una confianza compartida entre los componentes deIBM Cognos y los otros servidores.

Configuración de valores criptográficosLos componentes de IBM Cognos BI requieren un proveedor criptográfico; de locontrario, no se ejecutarán. Si suprime el proveedor criptográfico predeterminado,debe configurar otro proveedor para sustituirlo.

Procedimiento1. Inicie IBM Cognos Configuration.2. En el panel Explorador, en Seguridad, pulse Criptografía.3. En el panel Propiedades, cambie los valores predeterminados pulsando el

cuadro Valor y, a continuación, seleccionando el valor adecuado:v En las instalaciones que no tienen Content Manager, si no desea almacenar

las CSK localmente, en Valores de CSK, cambie Almacenar clave simétricalocalmente por Falso.Si Almacenar clave simétrica localmente es Falso, la clave se recupera deContent Manager cuando se necesita. La propiedad Ubicación del almacénde claves simétricas comunes se pasa por alto.

v Si desea que los componentes en ambos extremos de una transmisióndemuestren su identidad, en Valores de SSL, cambie Utilizar autenticaciónmutua por Verdadero.No cambie el valor Utilizar confidencialidad.

v Si desea cambiar el algoritmo de resumen, seleccione otro valor en lapropiedad Algoritmo de resumen.


IBM Cognos Application FirewallIBM Cognos Application Firewall (CAF) analiza y valida las solicitudes HTTP yXML antes de que se procesen. IBM Cognos Application Firewall podría modificarestas solicitudes HTTP y XML.

IBM Cognos Application Firewall protege los productos web de IBM Cognos frentea datos malintencionados. Las formas más comunes de datos malintencionados sonlos desbordamientos del búfer y los ataques cross-site scripting (XSS), ya sea através de la inserción de scripts en páginas válidas o la redirección a otro sitioweb. Mediante IBM Cognos Configuration, puede cambiar los valores para elsoporte de otras herramientas XSS y puede añadir nombres de host y de dominio ala lista de nombres válidos de IBM Cognos.


Puede realizar un seguimiento de la actividad del cortafuegos consultando elarchivo de registro, que contiene las solicitudes rechazadas. De formapredeterminada, los mensajes de registro se almacenan en el archivoubicación_c10/logs/cogserver.log. Todos los valores de CAF deben ser losmismos para las instalaciones de componentes de nivel de aplicación de IBMCognos BI en un entorno distribuido. Por ejemplo, si CAF está inhabilitado enalgunas ubicaciones y habilitado en otras, puede que se dé un comportamientoinesperado y que se produzcan errores del producto.

Configuración de los componentes de IBM Cognos para queutilicen IBM Cognos Application Firewall

Todos los valores de IBM Cognos Application Firewall (CAF) deben ser los mismospara todas las instancias en las que se han instalado componentes de nivel deaplicación de IBM Cognos BI.


Los siguientes tipos de URL se aceptan en la validación de CAF:v URL completas (absolutas)

en el formato protocolo://host:puerto/ruta, donde protocolo es http o https y hostse valida con la lista de dominios válidos.

v URL relativas al directorio de instalación weben el formato /raíz_instalación_web/.*, donde raíz_instalación_web es el directorioweb de la pasarela, basado en el alias que ha configurado en el servidor web.

v URL específicas permitidas, como las siguientes (ninguna distingue entremayúsculas y minúsculas)about:blankJavaScript:window.close( )JavaScript:parent.close( )JavaScript:history.back( )parent.cancelErrorPage( )doCancel( )

Procedimiento1. En cada ubicación en la que se hayan instalado componentes de nivel de

aplicación de IBM Cognos BI, inicie IBM Cognos Configuration.2. En el panel Explorador, en Seguridad, pulse IBM Cognos Application

Firewall.3. En el panel Propiedades, en la propiedad Habilitar validación CAF, establezca

los valores adecuados.De forma predeterminada, IBM Cognos Application Firewall está habilitado.IBM Cognos Application Firewall es un componente esencial de seguridad deIBM Cognos que ayuda a protegerse frente a las vulnerabilidades depenetración. Si inhabilita IBM Cognos Application Firewall, eliminará estaprotección. En circunstancias normales, no inhabilite IBM Cognos ApplicationFirewall.

4. Si va a utilizar otra herramienta XSS que comprueba si hay determinadoscaracteres en los parámetros de solicitud GET, en el panel Propiedades, para lapropiedad Comprobación de XSS de terceros habilitada, cambie el valor porVerdadero.Los caracteres predeterminados que están prohibidos incluyen >, <, y '.


5. Añada nombres de host y de dominio a la lista de nombres válidos de IBMCognos:a. Para la propiedad Dominios o hosts válidos, pulse el valor y, a

continuación, pulse el botón de edición.b. En el cuadro de diálogo Valor: Dominios o hosts válidos, pulse Añadir.

Debe incluir los dominios de todos los hiperenlaces que se han añadido enIBM Cognos Connection. Para obtener más información, consulte el temaacerca de la creación de un URL en la Guía de administración y seguridad.

c. Pulse la fila en blanco de la tabla y escriba el nombre de host o de dominio.Para permitir un dominio y todos sus subdominios, utilice un caráctercomodín al principio del nombre de dominio.Por ejemplo: *.miempresa.com

d. Pulse Aceptar.IBM Cognos Application Firewall valida nombres de dominio y de hostpara proteger los URL que se crean. De forma predeterminada, IBM CognosApplication Firewall considera que los nombres de dominio derivados delas propiedades de configuración del entorno son nombres de dominioseguros. Es útil añadir nombres a la lista de nombres y hosts válidoscuando debe redirigir solicitudes a sistemas que no son IBM Cognosmediante las funciones Atrás o Cancelar o cuando utiliza el acceso a losdetalles en diferentes instalaciones de productos de IBM Cognos.

6. Guarde la configuración.7. Reinicie los servicios.

Cifrado de las propiedades de archivos temporalesLos archivos temporales almacenan los informes vistos recientemente y los datosutilizados por los servicios durante el procesamiento. Puede cambiar la ubicaciónde los archivos temporales y puede optar por cifrar su contenido.


De forma predeterminada, los componentes de IBM Cognos Business Intelligencealmacenan archivos temporales en el directorio ubicación_c10/temp y los archivosno se cifran.

Para lograr una seguridad óptima, deniegue cualquier acceso al directorio temp,excepto para la cuenta de servicio que se utilice para iniciar los servicios de IBMCognos.

Procedimiento1. Inicie IBM Cognos Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, en la propiedad Ubicación de archivos temporales,

escriba la ubicación nueva.4. Si necesita que se cifre el contenido de los archivos temporales, establezca la

propiedad Cifrar archivos temporales en Verdadero.5. Asegúrese de que la cuenta de usuario en la que se ejecutan los componentes

de IBM Cognos BI tiene privilegios de lectura y escritura para la ubicación dearchivos temporales.


Comunicaciones de confianza entre los componentes de IBM CognosUtilice el protocolo Secure Sockets Layer (SSL) para proteger la comunicación entrelos componentes de IBM Cognos, así como entre los componentes de IBM Cognosy otro software.

Conexiones internas únicamente

Si configura SSL para las conexiones internas, los componentes de IBM Cognosinstalados localmente utilizan este protocolo. El asignador atiende las conexionesseguras en un puerto distinto al de las solicitudes http remotas. Por lo tanto, debeconfigurar dos URI de asignador.

Si configura SSL para todas las conexiones, el asignador puede utilizar el mismopuerto para las conexiones internas y externas. Del mismo modo, si no utiliza SSLpara la comunicación local o remota, el asignador puede utilizar el mismo puertopara todas las comunicaciones.

Asimismo, debe actualizar los URI de Content Manager, el URI de asignador paralas aplicaciones externas y el URI de pasarela para utilizar SSL, si es necesario.

Conectores de Tomcat

Si el URI de asignador interno tiene el prefijo http pero el URI de asignadorexterno tiene el prefijo https o viceversa, tanto los conectores no SSL CoyoteHTTP/1.1 como los SSL Coyote HTTP/1.1 están habilitados en el archivoserver.xml.

Si los URI de asignador interno y externo utilizan protocolos o puertos distintos,sólo los componentes del sistema local pueden acceder al puerto de asignadorinterno. El URI de asignador interno también debe especificar localhost.

Instalaciones de una sola ubicación

En las instalaciones de una sola ubicación, si está ejecutando IBM Cognos BusinessIntelligence sin SSL, debe detener el servicio antes de añadir SSL a suconfiguración. Después de guardar la configuración con los valores de SSL, puedereiniciar el servicio.

Instalaciones distribuidas

En las instalaciones distribuidas, si utiliza el servicio de entidad emisora decertificados de IBM Cognos, debe realizar las tareas siguientes:__ v Configure todos los sistemas de IBM Cognos para que utilicen el protocolo no

seguro (http).__ v Establezca la confianza.

Asegúrese también de que sigue el orden necesario para configurar loscomponentes en un entorno distribuido. Esto significa que primero debeconfigurar el Content Manager activo y, a continuación, iniciar los serviciosantes de configurar otros componentes o iniciar servicios en otras ubicaciones.Al configurar primero el sistema Content Manager activo predeterminado einiciar los servicios, se asegura de que el servicio de entidad emisora decertificados del sistema de Content Manager activo predeterminado puedeemitir certificados a otros componentes en el entorno de IBM Cognos.

__ v Pruebe la instalación.


Después de configurar todos los sistemas en la instalación distribuida paraque utilicen el protocolo no seguro predeterminado, se recomienda probar lainstalación para asegurarse de que los componentes de IBM Cognosfuncionan correctamente. Tras probar la instalación, puede configurar elprotocolo SSL.

__ v Configure los componentes de IBM Cognos para utilizar el protocolo SSL.Al configurar IBM Cognos Business Intelligence para que utilice el protocoloSSL, asegúrese de configurar primero el sistema de Content Manager activopredeterminado para que utilice el protocolo y de iniciar los servicios en elsistema de Content Manager activo predeterminado. Tras realizar esto, puedeconfigurar el protocolo SSL en otros sistemas IBM Cognos de su entorno.

Añadir un componente en otra ubicación a una instalación

Si añade un sistema en un entorno con SSL habilitado, se le pedirá que aceptetemporalmente la confianza de un certificado al guardar la configuración. Alaceptar el certificado temporal, se permite que se establezca una confianzapermanente con el sistema de Content Manager.

Configuración de SSLPara garantizar la comunicación segura entre los componentes de IBM Cognos BI,configure el asignador y la pasarela para utilizar SSL.


Si configura SSL para las conexiones internas solamente, los componentes de IBMCognos que estén en la misma ubicación se comunicarán mediante este protocolo.El asignador atiende las conexiones seguras en un puerto distinto al de lassolicitudes http remotas. Por lo tanto, debe configurar dos URI de asignador.

Si configura SSL para las conexiones externas solamente, las comunicaciones de loscomponentes remotos de IBM Cognos con la instalación local utilizan el protocoloSSL. Debe configurar el asignador para que atienda las solicitudes remotas segurasen un puerto distinto al de las solicitudes HTTP locales. Asimismo, debe configurarlos URI de Content Manager y el URI de asignador para que las aplicacionesexternas utilicen el mismo protocolo y puerto que el asignador externo.

Procedimiento1. Inicie IBM Cognos Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, escriba los valores adecuados para URI de asignador

interno y URI de asignador externo:v Para configurar SSL para las conexiones internas solamente, en la propiedad

URI de asignador interno escriba https y un puerto para la comunicaciónSSL.En la propiedad URI de asignador externo escriba http y utilice el puertopredeterminado u otro disponible.Si utiliza Tomcat, la propiedad URI de asignador interno debe especificarlocalhost.Los puertos de los dos URI de asignador deben ser diferentes.

v Para configurar SSL para las conexiones externas solamente, en la propiedadURI de asignador externo escriba https y un puerto seguro.


En la propiedad URI de asignador interno escriba http y utilice el puertopredeterminado u otro disponible.Si utiliza Tomcat, la propiedad URI de asignador interno también debeespecificar localhost.Los puertos de los dos URI de asignador deben ser diferentes.

v Para configurar SSL para todas las conexiones, escriba el mismo URI para laspropiedades URI de asignador interno y URI de asignador externo. Escribahttps y un puerto seguro.

4. Configure el protocolo SSL para los otros URI de entorno, como los URI deContent Manager, el URI de asignador para aplicaciones externas y el URI depasarela.v Para las conexiones internas solamente, escriba https en los URI que

contengan localhost.v Para las conexiones externas solamente, escriba https en los URI que no

contengan localhost.v Para todas las conexiones, escriba https en todos los URI.

5. En el panel Explorador, pulse Seguridad > Criptografía.Para utilizar el protocolo SSL, debe especificar las contraseñas de los almacenesde claves de cifrado de IBM Cognos. Hay más valores de configuración enSeguridad > Criptografía > Cognos.


Paquetes de cifrado para SSLUna conexión SSL empieza con una negociación en la que el cliente y el servidorpresentan una lista de paquetes de cifrado soportados en orden de prioridad. Elpaquete de cifrado proporciona la calidad de protección para la conexión. Contienealgoritmos criptográficos, de autenticación, hash y de intercambio de claves. Elprotocolo SSL selecciona el paquete con prioridad máxima que soporta el cliente yel servidor.

Se ofrece una lista de paquetes de cifrado soportados por SSL. Puede eliminarpaquetes de cifrado que no cumplen sus requisitos y asignar una prioridad opreferencia a los paquetes de cifrado restantes. Los paquetes de cifradoseleccionados se presentan en orden de prioridad para ambas partes de lanegociación, cliente y servidor. Debe coincidir como mínimo uno de los paquetesde cifrado seleccionados entre las plataformas cliente y servidor.

La lista de paquetes de cifrado soportados se genera dinámicamente en cadainstalación, y depende de Java Runtime Environment (JRE) o de si ha instaladootro software criptográfico. Si ha realizado cambios, como la actualización del JREo la instalación de software que ha actualizado el JRE, esto puede afectar a lopaquetes de cifrado soportados disponibles. Si ya no dispone de un paquete decifrado soportado que se corresponda con el resto de sistemas en el entorno, esposible que tenga que cambiar el JRE para que coincida con los otros sistemas.

Clasificación de paquetes de cifrado para SSLPuede eliminar paquetes de cifrado que no cumplen sus requisitos y asignar unaprioridad o preferencia a los paquetes de cifrado restantes.

Procedimiento1. Inicie IBM Cognos Configuration.2. En el panel Explorador, pulse Criptografía > Cognos Manager.


3. En el panel Propiedades, pulse la columna Valor correspondiente a lapropiedad Paquetes de cifrado soportados.

4. Pulse el botón de edición.v Para mover un paquete de cifrado a la lista Valores actuales, pulse la casilla

de verificación de la lista Valores disponibles y, a continuación, pulseAñadir.

v Para subir o bajar un paquete de cifrado de la lista Valores actuales, pulse lacasilla de verificación y, a continuación, pulse las flechas hacia arriba o haciaabajo.

v Para eliminar un paquete de cifrado de la lista Valores actuales, pulse lacasilla de verificación y, a continuación, pulse Eliminar.

5. Pulse Aceptar.6. Pulse Archivo > Guardar.

Configuración de los componentes de IBM Cognos paraservidores web habilitados para SSL

Si utiliza el protocolo SSL, para acceder al portal IBM Cognos, debe cambiar losvalores de URI de pasarela en IBM Cognos Configuration para cada sistema en elque se hayan instalado los componentes de nivel de aplicación y FrameworkManager.

Antes de empezar

Para habilitar SSL en el servidor web, debe obtener un certificado de servidor webfirmado por una entidad emisora de certificados e instalarlo en el servidor web. Elcertificado no debe estar autofirmado, ya que los componentes de IBM Cognos noconfiarán en los certificados autofirmados.

Procedimiento1. En cada instalación de los componentes de nivel de aplicación y en cada

sistema Framework Manager, inicie IBM Cognos Configuration.2. En Configuración local, pulse Entorno y cambie el valor URI de pasarela de

http por https.3. En el campo de valor URI de pasarela, cambie el número de puerto por el

número de puerto SSL definido para el servidor web.Por ejemplo, el número de puerto predeterminado para las conexiones SSLnormalmente es 443.

4. Para verificar la confianza, acceda al portal escribiendo https://servername:443/ibmcognos.Se le solicitará que instale un certificado.Para que no se le solicite mediante una alerta de seguridad en cada nuevasesión, instale el certificado en uno de los almacenes de certificados delnavegador web.

Configuración de la pasarela para utilizar un espacio denombres

Si los componentes de IBM Cognos Business Intelligence utilizan varios espaciosde nombres, o si el acceso anónimo está habilitado y los componentes de IBMCognos utilizan un solo espacio de nombres, puede configurar la pasarela para quese conecte a un solo espacio de nombres.


Procedimiento1. Inicie IBM Cognos Configuration en el sistema en el que se encuentra la

pasarela.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, en el cuadro Valor situado junto a la propiedad

Espacio de nombres de la pasarela, escriba el ID del espacio de nombres quedesea utilizar.

4. Pulse Archivo > Guardar.5. Reinicie el servidor web.

Proceso de configuración para repositorios de mensajes de registroLos mensajes de registro son una importante herramienta de diagnóstico parainvestigar el comportamiento de IBM Cognos Business Intelligence for z/OS.Además de los mensajes de error, los mensajes de registro proporcionaninformación sobre el estado de los componentes y una visión de alto nivel de loseventos importantes.

Por ejemplo, los mensajes de registro pueden proporcionar información sobre losintentos de inicio y detención de servicios, la finalización de solicitudes deprocesamiento y los indicadores de errores muy graves. Los registros de auditoría,disponibles a partir de una base de datos de registro, ofrecen información sobre laactividad de informe y usuario.

Los servicios de IBM Cognos BI de cada sistema envían información sobre loserrores y eventos a un servidor de registro local. Hay un servidor de registro localinstalado en la carpeta ubicación_c10/logs de cada sistema con IBM Cognos BIque contiene Content Manager o componentes de nivel de aplicación. Dado que elservidor de registro utiliza un puerto diferente del de otros componentes de IBMCognos BI, sigue procesando eventos aunque se hayan inhabilitado otros serviciosen el sistema local como por ejemplo, el asignador.

En el flujo de trabajo siguiente se muestran las tareas necesarias para preparar elregistro.__ v Fase de planificación

Durante la planificación, determine la configuración de registro adecuadapara su entorno. Por ejemplo, evalúe los diversos repositorios de mensajes deregistro, como los archivos de registro y los servidores de registro remotos, elsyslog de UNIX o Linux o el registro de sucesos de Windows NT, además delarchivo de registro local. También puede enviar solamente información deregistro de auditoría a una base de datos. Tenga en cuenta la seguridad, porejemplo, los métodos disponibles para proteger los archivos de registro frentea errores del sistema y la manipulación indebida por parte de los usuarios.Para obtener información acerca de la planificación, consulte la publicaciónGuía de arquitectura y despliegue.

__ v Fase de configuraciónDurante la configuración, defina las propiedades de inicio del registro comopor ejemplo, los valores de conexión de las bases de datos. Si desea recopilarlos registros de auditoría, deberá crear también una base de datos de registro.Si debe protegerse la comunicación entre un servidor de registro local y unservidor de registro remoto, realice los cambios de configuración adecuadosen los dos sistemas con IBM Cognos BI. También puede habilitar algunas


características de registro, como el registro específico del usuario. Para obtenerinformación sobre la configuración del registro, consulte la publicación Guíade instalación y configuración.

__ v Fase de administraciónAl configurar el registro, especifique el nivel de detalle que se debe registrarpara que los mensajes se centren en la información relevante para suorganización. También pueden configurarse informes de auditoría para hacerun seguimiento de la actividad de los usuarios y los informes. Para obtenerinformación sobre la configuración del registro, consulte la publicación Guíade administración y seguridad.

Repositorios de mensajes de registroAl instalar Content Manager o los componentes de nivel de aplicación, se instalaautomáticamente un servidor de registro local. Puede especificar uno o variosrepositorios a los que el servidor de registro local envía mensajes de registro.

Puede especificar que los mensajes de registro se almacenen en el syslog de UNIX.Los mensajes relacionados con los procesos de inicio se muestran automáticamenteen la consola de z/OS.

Servidor de registro remoto

En una instalación distribuida, puede configurar el servidor de registro en cadainstalación de IBM Cognos BI para que envíe los mensajes de registro a un únicoservidor de registro remoto, que actúa como servidor de registro común. Despuéspuede configurar el servidor de registro común para que envíe los mensajes deregistro a un archivo local o a una base de datos en la misma ubicación o en otradistinta.

Si el servidor de registro remoto deja de estar disponible, los mensajes de registrose redirigen a los archivos de recuperación de la ubicación de instalación local, enel directorio ubicación_c10/logs/recovery/remote. Estos archivos de recuperacióncontienen información de indicación de fecha y hora en sus nombres de archivo, yno se pueden leer como los archivos de registro normales. Cuando el servidor deregistro remoto pasa a estar disponible, un proceso de recuperación automáticomueve toda la información de registro al servidor de registro remoto y suprime losarchivos de registro locales.

El archivo cogserver.log

El servidor de registro está configurado de forma predeterminada para enviar losmensajes de registro al archivo ubicación_c10/logs/cogserver.log. Si el archivo deregistro predeterminado no existe cuando el servicio de IBM Cognos BI se inicia, secrea automáticamente.

Puede configurar el servidor de registro para que envíe mensajes de registro a otroarchivo. Si configura un archivo de registro distinto, IBM Cognos BI intenta crearautomáticamente este archivo durante el inicio, además del archivo de registropredeterminado. Si la ubicación del archivo de registro configurado no es eldirectorio ubicación_c10/logs, debe asegurarse de que la ruta al archivo deregistro existe antes de iniciar el servicio de IBM Cognos BI.

Por ejemplo, si configura el servidor de registro para que envíe los mensajes alarchivo /usr/lpp/log_files/cognos.log, IBM Cognos BI intenta crearautomáticamente el archivo cognos.log en la carpeta /usr/lpp/log_files. Si esta


carpeta no existe, IBM Cognos BI no crea el archivo cognos.log y no se puederegistrar ningún mensaje de registro en dicho archivo. Tenga en cuenta que estosmensajes de registro no se registran en el archivo de registro predeterminado.Aunque IBM Cognos BI crea automáticamente el archivo de registropredeterminado incluso cuando hay configurado otro archivo de registro, elarchivo de registro predeterminado no se utiliza como copia de seguridad.

Base de datos

El servidor de registro también puede enviar registros de auditoría a una base dedatos en la misma ubicación de instalación o en otra ubicación distinta. Losregistros de auditoría proporcionan información sobre la actividad de los usuariosy los informes.

La base de datos de registro tiene los mismos requisitos de configuración y decuenta de usuario que la base de datos del almacén de contenido. Después deconfigurar los componentes de IBM Cognos BI para que envíen los mensajes a unabase de datos de registro y de reiniciar el servicio de IBM Cognos BI, loscomponentes de IBM Cognos BI crean las tablas y los campos de tabla necesarios.Puede probar la conexión con la base de datos de registro antes de reiniciar elservicio de IBM Cognos BI.Conceptos relacionados:“Mensajes de consola” en la página 217Los mensajes de instalación de IBM Cognos Business Intelligence for z/OS son unaimportante herramienta para resolver problemas.

Directrices para la creación de una base de datos de registrode DB2 para z/OS

La base de datos que cree para el registro debe contener algunos valores deconfiguración necesarios.

Utilice la siguiente lista de comprobación a modo de ayuda para configurar la basede datos de registro en DB2.__ v Inicie la sesión en el sistema z/OS como usuario con privilegios de

administrador en DB2 (autorización DBADM) en z/OS.__ v Cree una instancia de base de datos, un grupo de almacenamiento y una

cuenta de usuario para la base de datos de registro. IBM Cognos utiliza lascredenciales de la cuenta de usuario para comunicarse con el servidor debases de datos.

__ v Asegúrese de asignar una agrupación de búferes con un tamaño de página de16 KB para la instancia de la base de datos.

__ v En el caso de una base de datos de registro en DB2 en z/OS, losadministradores deben ejecutar un script de espacios de tabla para crearespacios de tablas que contendrán objetos grandes y otros datos de la base dedatos de registro y, a continuación, otorgar derechos de usuario a la tabla.

Creación de espacios de tabla para una base de datos deregistro en DB2 para z/OS

Un usuario con autorización de administrador de base de datos (DBADM) debeejecutar un script para crear un conjunto de espacios de tabla necesarios para labase de datos de registro. El script debe modificarse para sustituir los parámetrosde marcador de posición por los que sean apropiados para el entorno.



Asegúrese de que utiliza las convenciones de nomenclatura para DB2 en z/OS. Porejemplo, todos los nombres de parámetros deben comenzar por una letra y nodeben tener más de ocho caracteres. Para obtener más información, consulte elInformation Center de IBM DB2.


descartar espacios de tabla y permitir la ejecución de sentencias SQL.2. Abra el archivo de script LS_tablespace_db2zOS.sql y utilice la tabla siguiente

como ayuda para sustituir los parámetros genéricos por los adecuados para elentorno.

Tabla 51. Nombres y descripciones de los parámetros para la base de datos de registro


IPFSCRIPT_DATABASE Especifica el nombre de la base de datos deregistro.

IPFSCRIPT_STOGROUP Especifica el nombre del grupo dealmacenamiento.

IPFSCRIPT_TABLESPACE Especifica el nombre del espacio de tablaque contiene las tablas base en la base dedatos de registro.

Este espacio de tabla no es para las tablasauxiliares.

IPFSCRIPT_LOB_TABLESPACE Especifica el nombre del espacio de tablaque está asignado para las tablas auxiliares.

IPFSCRIPT_BP Especifica el nombre de la agrupación debúferes de 8 k que está asignada para losobjetos normales.

IPFSCRIPT_USERNAME Especifica la cuenta de usuario que accede ala base de datos de registro.

No todos los parámetros enumerados se encuentran en el script, pero sepueden añadir en el futuro.

3. Guarde y ejecute el script.4. Otorgue al usuario de IBM Cognos derechos sobre los espacios de tabla que se

crearon cuando se ejecutó el archivo de script LS_tablespace_db2zOS.sql:a. Abra el archivo de script LS_rightsGrant_db2zOS.sql, que se encuentra en

el directorio ubicación_c10/configuration/schemas/logging/db2zOS.b. Sustituya los valores de los parámetros por valores apropiados para el

entorno.Asegúrese de que usa los mismos valores que usó al crear las agrupacionesde búferes y la cuenta de usuario.

c. Guarde y ejecute el script LS_rightsGrant_db2zOS.sql.

Especificación del tipo de repositorio para los mensajes deregistro

Puede configurar un tipo de repositorio para los mensajes de registro y, acontinuación, configurar las propiedades para el repositorio específico. Tambiénpuede configurar más de un repositorio.


Procedimiento1. En las instalaciones en las que haya instalado Content Manager o

componentes de nivel de aplicación, inicie IBM Cognos Configuration.2. En el panel Explorador, en Entorno, pulse Registro.3. En el panel Propiedades, utilice la tabla siguiente para ayudar a establecer las

propiedades del servidor de registro.

Tabla 52. Tareas para establecer las propiedades del servidor de registro

Tarea Acción

Utilizar TCP entre los componentes de IBMCognos BI de un sistema y su servidor deregistro local

Establecer la propiedad Habilitar TCP enVerdadero.

UDP proporciona una comunicación másrápida con un menor riesgo de perderconexiones que TCP.

TCP se utiliza para la comunicación entre unservidor de registro local y un servidor deregistro remoto.

Cambiar el número de subprocesosdisponibles en el servidor de registro local

Escriba el valor en la propiedadSubprocesos de trabajo del servidor deregistro local.

Mantenga el valor predeterminado de 10. Elrango está entre 1 y 20. Sin embargo, si tieneun elevado número de mensajes de registro,puede asignar más subprocesos para mejorarel rendimiento.

Aplicar la codificación UTF-8 para losmensajes de registro escritos en un archivo

Establecer la propiedad Usar codificaciónUTF8 en Verdadero.

Si el componente de IBM Cognos BI utilizala codificación de varios bytes, debeestablecer esta propiedad en Verdadero yutilizar un editor de UTF-8 para ver elarchivo de registro. De lo contrario, elarchivo de registro podría contenercaracteres ilegibles.

4. En el panel Explorador, en Entorno, pulse con el botón derecho del ratón enRegistro > Nuevo recurso > Destino.a. En el cuadro Nombre, escriba el nombre del repositorio.b. En la lista Tipo, pulse Base de datos y, a continuación, pulse Aceptar.

5. En el panel Explorador, en Registro, pulse con el botón derecho del ratón elnombre de base de datos y pulse Nuevo recurso > Base de datos.a. En el cuadro Nombre, escriba el nombre del repositorio.b. En la lista Tipo, pulse Base de datos DB2 y, a continuación, pulse Aceptar.

6. En el panel Propiedades, escriba valores para Servidor de bases y número depuerto, Identificador de usuario y contraseña y Nombre de base de datosz/OS.Asegúrese de que el ID de usuario sea el mismo que el especificado para elparámetro IPFSCRIPT_USERNAMEen el archivo de scriptLS_tablespace_db2zOS.sql.

7. En el panel Explorador, pulse Configuración local.


8. En el panel Propiedades, junto a Propiedades avanzadas, pulse dentro delcuadro Valor y, a continuación, pulse el botón de edición.

9. Pulse Añadir y, a continuación, añada los nombres y valores de parámetros deconfiguración de la siguiente tabla:


Nombre del parámetro Valor

IPFSCRIPT_CREATE_IN Ubicación de las tablas base

Por ejemplo,databaseNameCMID.baseTableSpaceName

IPFSCRIPT_STOGROUP Nombre del grupo de almacenamiento

IPFSCRIPT_DATABASE Nombre de la base de datos de registro

IPFSCRIPT_LOB_TABLESPACE Nombre del espacio de tabla que estáreservado para las tablas auxiliares en labase de datos de registro.

10. Pulse Archivo > Guardar.11. Pruebe la conexión con la nueva base de datos. En el panel Explorador, en

Entorno, pulse el botón con el botón derecho del ratón en Registro > Probar.Los componentes de IBM Cognos BI se conectan a la base de datos. Si haconfigurado más de una base de datos para los mensajes de registro, loscomponentes de IBM Cognos BI prueban todas las bases de datos.

Resultados

Si el repositorio era un servidor de registro remoto, configure e inicie el servidorde registro remoto. A continuación, reinicie el servicio de IBM Cognos BI en elsistema local.

Si el repositorio era una base de datos, puede utilizar los componentes de IBMCognos BI para ejecutar los informes de registro desde la base de datos.

También puede establecer el nivel de registro, que controla la cantidad de detallesy el tipo de mensajes que se envían a un archivo de registro o a una base de datos.Para obtener instrucciones, consulte la publicación Guía de administración yseguridad.

Configuración de la conectividad con la base de datos deregistro

Después de crear una base de datos para los mensajes de registro, debe copiar loscontroladores JDBC a la instalación de IBM Cognos para asegurarse de que puedeconectarse a la base de datos.


En las instalaciones distribuidas, el servidor de registro local en una instalación decomponentes de nivel de aplicación puede enviar mensajes de registro a unservidor de registro remoto, el cual envía luego mensajes a la base de datos deregistro. Para DB2, el controlador JDBC y el archivo de licencia adecuadossolamente son necesarios en el sistema de los componentes de nivel de aplicaciónque contiene el servidor de registro remoto que se conecta a la base de datos deregistro.


Debe copiar el controlador JDBC y el archivo de licencia en el sistema de ContentManager, a menos que vaya a utilizar el mismo tipo de base de datos para losmensajes de registro que para el almacén de contenido.

Procedimiento1. En la instalación de DB2, vaya al directorio donde se encuentran el controlador

JDBC y de los archivos de licencia.Por ejemplo, el directorio $DB2HOME/db2910_jdbc/classes.

2. Copie o cree enlaces simbólicos para los siguientes archivos en losdirectoriosubicación_c10/webapps/p2pd/WEB-INF/lib y ubicación_c10/bin.v El archivo del controlador universal: db2jcc.jarv El archivo de licencia; por ejemplo: db2jcc_license_cisuz.jar

Configuración del archivado de contenido de IBM CognosPara mejorar el rendimiento del sistema y aumentar la escalabilidad, utilice elarchivado de contenido de IBM Cognos para almacenar versiones de salida deinforme y sus especificaciones de informe de origen en el sistema de archivos.Archivar disminuye el tamaño de la base de datos del almacén de contenido.

Los usuarios pueden buscar un elemento en un nombre de informe o un elementode datos en un informe. Los resultados dependen de los valores que se hanutilizado para crear el índice de búsqueda. El contenido archivado puede versepulsando en los enlaces de los resultados de la búsqueda.

El contenido archivado puede verse en IBM Cognos Connection o en el repositorioexterno.

Después de haber movido y archivado el contenido, éste se almacena en laubicación que se ha especificado al crear la conexión de origen de datos con elrepositorio externo.

Creación de una ubicación de archivo para un repositorio desistema de archivos

Para archivar informes o especificaciones de informe en un repositorio de sistemade archivos de archivado de contenido IBM Cognos, debe crear una raíz de aliasque apunte a una ubicación de archivo de una unidad local o una unidadcompartida de red.

Antes de empezar

Debe ser administrador y tener acceso a la ubicación del archivo. Content Managery los componentes de nivel de aplicación deben poder acceder a esta ubicaciónmediante un URI de archivo.


El repositorio de sistema de archivos se ha diseñado para un entorno de pruebas odesarrollo donde no se puede utilizar un repositorio de Enterprise ContentManagement (ECM). Aunque el sistema de archivos para el archivado decontenido de IBM Cognos proporciona la misma funcionalidad que un repositoriode ECM, no proporciona el mismo nivel de optimización y, por lo tanto, elrendimiento puede verse afectado en un entorno de producción.


Procedimiento1. Si el servicio de IBM Cognos está en ejecución, deténgalo.2. Inicie IBM Cognos Configuration.3. Pulse Acciones > Editar configuración global.4. En la pestaña General, seleccione Raíces de alias, pulse dentro del campo de

valor, pulse el botón de edición, y cuando aparezca el cuadro de diálogoValor-Raíces de alias, pulse Añadir.

5. En la columna Nombre de raíz de alias, escriba un nombre exclusivo para elrepositorio de sistema de archivos.

6. Escriba la ruta a la ubicación del sistema de archivos.7. Pulse Aceptar.8. Reinicie el servicio de IBM Cognos.

Esto puede tardar unos minutos.

Resultados

Utilice ese nombre de repositorio de sistema de archivos para crear una conexiónde origen de datos para utilizar con el software Cognos Content Archival. Paraobtener más información, consulte la publicación Guía de administración y seguridad.

Especificación de un tiempo de disponibilidad para laejecución del proceso de archivado

Para mantener un alto rendimiento del sistema durante las horas de altorendimiento del sistema, puede configurar un periodo de inactividad paraespecificar cuándo han de ejecutarse las tareas de archivado o de supresión.

Un periodo de inactividad es un periodo temporal durante el que se deniega elmovimiento de datos. De forma predeterminada, no se define ningún periodo deinactividad cuando se instala el software.

Procedimiento1. Vaya al directorio ubicación_c10/webapps/p2pd/WEB-INF/cm/tasks/manager.2. Mediante un editor de texto de XML, abra el archivo tasksManager.xml.3. Por ejemplo, para especificar un periodo de inactividad semanal de las 8 de la

mañana a las 5 de la tarde, de martes a viernes, añada el elemento<blackoutPeriods> siguiente como elemento hijo del elementobackgroundTasksManager.v start time = <hour>08</hour>

v stop time = <hour>17</hour>

v days =<day>Tuesday</day><day>Wednesday</day><day>Thursday</day><day>Friday</day>

4. Si es necesario, reduzca el número de subprocesos disponibles para losprocesos de archivado y supresión. El número máximo de subprocesos es 7.

5. Guarde y cierre el archivo.6. Reinicie las actividades en segundo plano en el servicio de Content Manager.


Especificación del tiempo de ejecución de subprocesosPuede utilizar subprocesos para planificar el tiempo de procesamiento del sistemaoperativo.

Las tareas en segundo plano de archivado y supresión utilizan subprocesos paramover el contenido. Los subprocesos son unidades de tiempo de procesamientoque el sistema operativo planifica.

Procedimiento1. Vaya al directorio ubicación_c10/webapps/p2pd/WEB-INF/cm/tasks/config.2. Mediante un editor de texto de XML, abra el archivo archiveTask.xml.3. Por ejemplo, para configurar tres subprocesos que se ejecutan desde la

medianoche hasta las 08:00 horas, un subproceso que se ejecuta desde las 08:00hasta las 17:00 horas, ningún subproceso que se ejecuta desde las 17:00 horashasta la medianoche y todos los subprocesos que se ejecutan todos los días dela semana, añada el elemento XML <executionPeriods> siguiente comoelemento hijo del elemento backgroundTask.

<executionPeriods><executionPeriod><threads>3</threads><startTime><hour>00</hour><minute>00</minute></startTime><stopTime><hour>08</hour><minute>00</minute></stopTime><days><day>Monday</day><day>Tuesday</day><day>Wednesday</day><day>Thursday</day><day>Friday</day><day>Saturday</day><day>Sunday</day></days></executionPeriod><executionPeriod><startTime><hour>08</hour><minute>00</minute></startTime><stopTime><hour>17</hour><minute>00</minute></stopTime><days><day>Monday</day><day>Tuesday</day><day>Wednesday</day><day>Thursday</day><day>Friday</day><day>Saturday</day><day>Sunday</day></days></executionPeriod></executionPeriods>



Archivado de formatos seleccionados de salidas de informePuede limitar el archivado para limitar éste a formatos de salida específicos. Deforma predeterminada, se archivan las salidas de cualquier formato determinado,incluidos PDF, XML, HTML y Excel.

Puede limitar el archivado de formatos de salida específicos en el repositorio.

Procedimiento1. Vaya al directorio ubicación_c10/webapps/p2pd/WEB-INF/cm/tasks/config.2. Mediante un editor de texto de XML, abra el archivo archiveTask.xml.3. Por ejemplo, para definir el archivado de versiones de salida de informe PDF

solamente, añada el siguiente elemento XML <outputFormats> como elementohijo del elemento XML runOptions.<outputFormats>

<outputFormat>PDF</outputFormat></outputFormats>

Puede utilizar el elemento outputFormats de ejemplo existente y modificar lalista para especificar los formatos de salida que han de archivarse.No puede archivar selectivamente varias versiones de salida de informe dearchivo, por ejemplo, HTML con gráficos.Guarde y cierre el archivo.

Eliminación de los objetos de versión marcados de la colaEl archivo deleteTask.xml es un archivo de configuración para la tarea en segundoplano, que recupera y suprime de la cola los objetos de la versión que se hanmarcado.

Existen dos tareas de mantenimiento de contenido que marcan y mueven elcontenido de la versión a una cola:v El actualizador de reglas de conservación, que actualiza y aplica reglas de

conservación a informes, consultas, análisis y objetos de documento.v La eliminación de contenido, que marca versiones e historiales.

El archivo deleteTask.xml se encuentra en el directorio ubicación_c10/webapps/p2pd/WEB-INF/cm/tasks/config.

Para obtener más información acerca de las reglas de conservación, consulte lapublicación IBM Cognos Guía de administración y seguridad.

Configuración de valores de arrendamiento múltipleEl arrendamiento múltiple ofrece la posibilidad de dar soporte a varios clientes uorganizaciones (arrendatarios) mediante un único despliegue de una aplicación, ala vez que se garantiza que los usuarios que pertenecen a cada arrendatario sólopodrán acceder a los datos para los que disponen de autorización de uso. Estasaplicaciones se denominan aplicaciones de arrendamiento múltiple.

IBM Cognos Business Intelligence (BI) proporciona prestaciones que facilitan laadministración y protección de las aplicaciones de arrendamiento múltiple.

En el siguiente diagrama se muestra cómo las prestaciones de arrendamientomúltiple de Cognos BI aíslan el acceso a los objetos del almacén de contenido. Losusuarios sólo pueden acceder a los objetos para los que disponen de autorización


de acceso dentro de cada agrupación de arrendatarios.

En este ejemplo, los usuarios tendrían acceso a los siguientes objetos:v Los usuarios que pertenecen al Arrendatario 1 pueden acceder a objeto_1,

objeto_2 y objeto_3.v Los usuarios que pertenecen al Arrendatario 2 pueden acceder a objeto_3,

objeto_4, objeto_5 y objeto_6.

Nota: El administrador del sistema puede acceder a todos los objetos del almacénde contenido.

Para poder utilizar el arrendamiento múltiple de IBM Cognos, primero debemodificar la configuración. Las propiedades de arrendamiento múltiple queespecifique para un espacio de nombres específico reemplazarán las propiedadesde arrendamiento múltiple que establezca globalmente.

Para configurar el arrendamiento múltiple, debe realizar las tareas siguientes:1. “Identificar información de arrendamiento”2. “Habilitación del arrendamiento múltiple” en la página 162Conceptos relacionados:“Configuración de aplicaciones de arrendamiento múltiple en IBM CognosConfiguration” en la página 4Puede utilizar nuevas propiedades en IBM Cognos Configuration para configurarentornos de Business Intelligence que den soporte a las aplicaciones dearrendamiento múltiple.

Identificar información de arrendamientoPara poder modificar la configuración para las aplicaciones de arrendamientomúltiple, primero debe identificar cómo se determina la información dearrendamiento (agrupación) en el entorno para los usuarios individuales. Acontinuación, ha de asociar la información de arrendamiento a propiedades dearrendamiento múltiple específicas.

Figura 6. Almacén de contenido configurado para utilizar las prestaciones de arrendamientomúltiple de Cognos BI


Para identificar la información de arrendamiento, puede utilizar la posición de unusuario dentro de una jerarquía o puede utilizar las propiedades que se asocian alos objetos de usuario. También puede crear código personalizado que se invoquedurante el proceso de autenticación de usuario.

Utilizar jerarquías para determinar la información dearrendamiento

Una forma de determinar la información de arrendamiento consiste en reutilizar lainformación de estructura de nodo dentro de una jerarquía.

Cuando reutiliza la información de estructura de nodo, puede utilizar lainformación que proporciona el atributo de usuario ancestors, que representa laruta jerárquica de una cuenta de usuario en forma de matriz. En la siguiente tablase muestra cómo podría correlacionar el atributo ancestors a una jerarquía paraidentificar la información de arrendamiento:

Tabla 54. Atributo ancestors correlacionado con la información de jerarquía

Información de ancestros Jerarquía Ejemplo de LDAP

ancestors[0] Nodo de directorio

ancestors[1] ID de espacio denombres

base DN

ancestors[2] Agrupación dearrendatarios, comolas carpetas

organizational units

Por ejemplo, si los usuarios se almacenan en un directorio LDAP y losarrendatarios se encuentran directamente bajo el Nombre distinguido (DN) de basecomo unidades organizativas, establezca la propiedad avanzadamultitenancy.TenantPattern en el valor siguiente:multitenancy.TenantPattern = ~/ancestors[2]/defaultName

Nota: Además de defaultName, pueden devolver información de arrendamiento loscalificadores de ancestros que se indican a continuación:v name/locale, donde locale se basa en la correlación de la configuración de

espacio de nombres. Si no se especifica ningún entorno local, el nombre es eltítulo del objeto. Por ejemplo, podría especificar: multitenancy.TenantPattern =~/ancestors[2]/name/EN-ca.

v searchPath/objectID. Por ejemplo, podría especificar:multitenancy.TenantPattern = ~/ancestors[2]/searchPath/objectId.

Utilizar atributos de objeto para determinar la información dearrendamiento

Si no puede utilizar la jerarquía de la estructura de nodos para determinar lainformación de arrendamiento, puede utilizar atributos de objeto específicos delproveedor de autenticación. Este método requiere que identifique también laspropiedades adicionales que se consultarán durante el proceso de autenticación deusuario.

Por ejemplo, si el atributo departmentNumber de un objeto de usuario de LDAPidentifica el arrendatario del usuario, establezca las propiedades avanzadasmultitenancy.TenantPattern y AdditionalUserPropertiesToQuery de la formasiguiente:


multitenancy.TenantPattern = ~/parameters/parameter_nameAdditionalUserPropertiesToQuery = parameters

En este ejemplo, también debe establecer la propiedad personalizada LDAPsiguiente:parameter_name = departmentNumber

Utilización de código personalizado para determinar lainformación de arrendamiento

Cuando la información de arrendamiento no puede obtenerse mediante unajerarquía o un atributo de usuario, debe crear una clase personalizada que seinvoque durante el proceso de autenticación de usuario para determinar lainformación de arrendamiento. Por ejemplo, puede que necesite unir datos devarios orígenes de autenticación, o desde un origen de autenticación y una base dedatos relacional.

En estos casos, ha de crear una clase Java personalizada utilizando IBM CognosSoftware Development Kit y especificar su nombre durante la configuración de BI.En este escenario, establezca la propiedad multitenancy.ITenantProvider de laforma siguiente:multitenancy.ITenantProvider = custom_class_name

donde custom_class_name representa el nombre de la clase personalizada, porejemplo, com.example.Class.

IBM Cognos Software Development Kit incluye una clase personalizada de ejemplopara determinar la información de arrendamiento. Encontrará los archivos deejemplo en el directorio ubicación_c10\sdk\java\AuthenticationProvider\MultiTenancyTenantProviderSample.

Habilitación del arrendamiento múltiplePara habilitar las prestaciones de arrendamiento múltiple de Cognos, ha deestablecer propiedades de autenticación avanzadas en todos los sistemas en los quese ha configurado Content Manager y, a continuación, reiniciar el servicio de IBMCognos.

Antes de empezarv Identificar cómo se determina la información de arrendamiento para usuarios

individuales del entorno. Para obtener más información, consulte: “Identificarinformación de arrendamiento” en la página 160.

v Compilar los archivos de clase Java personalizada necesarios en archivos JAR ycolocarlos en el directorio ubicación_c10/webapps/p2pd/WEB-INF/lib junto conlos archivos asociados o bien actualizar la variable de entorno CLASSPATH paraque incluya la ruta de estos archivos.

v Determinar si debe aplicar valores de arrendamiento múltiple a todos losespacios de nombres configurados o a espacios de nombres individuales. Laspropiedades de arrendamiento múltiple de un espacio de nombres especificadoreemplazan las propiedades de arrendamiento múltiple establecidas globalmente.Si un espacio de nombres no se ha configurado para utilizar el arrendamientomúltiple, para determinar quién puede acceder a los objetos se utilizarán laspolíticas y permisos para los objetos.


Procedimiento1. Abra IBM Cognos Configuration.2. Para configurar valores de arrendamiento múltiple globalmente o para espacios

de nombres individuales, utilice los pasos siguientes:v Para configurar la información de arrendamiento para todos los espacios de

nombres: en la ventana del Explorador, en Seguridad, pulse Autenticación.v Para configurar la información de arrendamiento para un espacio de

nombres: en la ventana del Explorador, en Seguridad, pulse Autenticación.Pulse en el espacio de nombres que desea configurar.

3. Pulse el botón Editar en la columna Valor de Propiedades avanzadas.4. Pulse Añadir.5. Añada las propiedades de arrendamiento múltiple que necesita.

En los siguientes escenarios se muestran combinaciones posibles depropiedades de arrendamiento múltiple:v Para utilizar la información de jerarquía, puede establecer la propiedad

siguiente:multitenancy.TenantPattern = ~/ancestors[2]/defaultName

Nota: Si utiliza espacios de nombres de Active Directory, también debeestablecer la propiedad avanzada MultiDomainTree en true para correlacionarlos arrendatarios con los dominios.

v Para utilizar los atributos de objeto específico de su proveedor deautenticación, como por ejemplo un número de departamento(departmentNumber), puede seguir estos pasos:a. Establezca las propiedades avanzadas siguientes:

multitenancy.TenantPattern = ~/parameters/parameter_nameAdditionalUserPropertiesToQuery = parameters

b. Establezca la siguiente propiedad personalizada de espacio de nombres:parameter_name = departmentNumber

v Para utilizar una clase Java personalizada, establecería la propiedadsiguiente:multitenancy.ITenantProvider = custom_class_name

donde nombre_clase_personalizada representa el nombre de una clave Java queha creado.

6. Pulse Aceptar.7. Pruebe los cambios. En la ventana del Explorador, pulse con el botón derecho

en Autenticación y pulse en Probar. En el registro aparece un mensaje en elque se muestra que el arrendamiento múltiple está habilitado.

8. En el menú Archivo, pulse Guardar.9. Reinicie los servicios de IBM Cognos para que los cambios entren en vigor.


Después de haberse habilitado el arrendamiento múltiple, el administrador delsistema debe establecer la información de arrendamiento para los objetos en elalmacén de contenido. Para obtener más información, consulte la publicación Guíade administración y seguridad.

Para realizar un seguimiento de las actividades del arrendatario, puede utilizar unabase de datos de registro.


Inhabilitación del arrendamiento múltiplePara inhabilitar el arrendamiento múltiple, debe eliminar todas las propiedades deautenticación avanzadas de arrendamiento múltiple en todos los sistemas en losque se ha configurado Content Manager.

Procedimiento1. Abra IBM Cognos Configuration.2. Para inhabilitar valores de arrendamiento que se han establecido globalmente o

para espacios de nombres específicos, utilice los pasos siguientes:v Para inhabilitar la información de arrendamiento para todos los espacios de

nombres: en la ventana Explorador, en Seguridad, pulse Autenticación.v Para inhabilitar los valores de arrendamiento para un espacio de nombres: en

la ventana Explorador, en Seguridad, pulse Autenticación. Pulse en elespacio de nombres que desea configurar.

Nota: Si se establecen las propiedades de arrendamiento múltiple globalmentee individualmente, las propiedades de un espacio de nombres específicoreemplazan las propiedades de arrendamiento múltiple globales.

3. Pulse el botón Editar en la columna Valor de Propiedades avanzadas.4. Seleccione las propiedades de arrendamiento múltiple que desea eliminar.5. Pulse el botón Eliminar.6. Pulse Aceptar.7. Pruebe los cambios. En la ventana del Explorador, pulse con el botón derecho

en Autenticación y pulse en Probar.8. En el menú Archivo, pulse Guardar.9. Reinicie el servicio de IBM Cognos.


Después de haber inhabilitado el arrendamiento múltiple, el administrador delsistema debe revisar y actualizar las políticas de los objetos y, a continuación,actualizar el arrendamiento para establecerlo en público.

Valores globales para requisitos multiculturalesCambie los valores de todo el sistema para el idioma, el entorno local, la fuente ylos valores de servidor.

El cuadro de diálogo de configuración global estará disponible donde se hayainstalado Content Manager. Importante: Si cambia los valores globales en unainstalación de Content Manager, debe realizar los mismos cambios en el resto delas instalaciones de Content Manager.

De forma predeterminada, los componentes de IBM Cognos se aseguran de quetodos los entornos locales, que pueden proceder de diferentes orígenes y estar endiversos formatos, utilizan una forma normalizada. Esto significa que todos losentornos locales ampliados se ajustan a un valor de idioma y código regional.Cada sistema tiene un entorno local del sistema predeterminado y un entorno localdel usuario por usuario. Los entornos locales de usuario pueden ser diferente delos entornos locales del sistema predeterminados. Si cambia los valores globales enuna instalación de Content Manager, debe realizar los mismos cambios en el restode las instalaciones de Content Manager.


Correlación de entornos de productosUtilice la tabla Correlaciones de entornos locales de productos para especificar elidioma utilizado en la interfaz de usuario cuando el idioma especificado en elentorno local del usuario no esté disponible.


Puede asegurarse de que todas las regiones de un entorno local utilizan el mismoidioma, o de que un entorno local específico y completo (idioma-región) utiliza unidioma determinado.

De forma predeterminada, el usuario ve la interfaz del producto en el idioma quecorresponde a la configuración de idioma del entorno local del usuario.

Procedimiento1. En cada instalación de Content Manager, inicie IBM Cognos Configuration.2. Pulse Acciones > Editar configuración global.3. Pulse la pestaña Correlaciones de entornos locales de productos.4. Pulse Añadir.5. En el cuadro Clave, escriba el entorno local del usuario:

v Para asegurarse de que todas las regiones de un entorno local ven la interfazde usuario en un idioma específico, escriba la parte de idioma del entornolocal, seguida de un guión (-) y un asterisco (*).Por ejemplo, escriba es-*

v Para asegurarse de que un entorno local completo (idioma-región) ve lainterfaz de usuario en un idioma específico, escriba el entorno localcompleto.Por ejemplo, escriba es-es

v Para correlacionar un idioma preferido con otro idioma, escriba la parte deidioma preferido del entorno local.Por ejemplo, escriba zh

Consejo: Para especificar el entorno local que se debe utilizar como valorpredeterminado, utilice el carácter comodín (*) para el valor Clave y, acontinuación, en el cuadro Correlación de entorno local, escriba el entornolocal.

6. En el cuadro Correlación de entorno local, escriba la parte de idioma delentorno local.Los entornos locales de usuario especificados en el cuadro Clave verán elcontenido en este idioma.

7. Repita los pasos anteriores para las demás correlaciones que desee realizar.8. Pulse Aceptar.9. Pulse Archivo > Guardar.

Informes en un idioma preferidoPuede correlacionar los entornos locales del usuario con un entorno local completo(idioma-región) o parcial (idioma). También puede correlacionar el idiomapreferido de un usuario con otro idioma si el contenido no está disponible en elidioma preferido del usuario.


Por ejemplo, si un informe no está disponible en un idioma preferido, por ejemploel vietnamita, pero está disponible en francés y alemán, puede utilizar la tabla decorrelaciones de contenido para correlacionar el idioma preferido (vietnamita) conotro idioma (francés o alemán). De este modo, verá el informe en el idiomacorrelacionado.

En los siguientes ejemplos se muestra el método que los componentes de IBMCognos BI utilizan para determinar qué informe visualiza el usuario si existenversiones en varios idiomas.

Ejemplo - El informe está disponible en dos entornos locales

Un informe está disponible en Content Manager en dos entornos locales, como, porejemplo, en-us (inglés-Estados Unidos) y fr-fr (francés-Francia), pero el entornolocal del usuario está definido como fr-ca (francés-Canadá). IBM Cognos BI utilizala correlación de entorno local para determinar qué informe visualiza el usuario.

En primer lugar, IBM Cognos BI comprueba si el informe está disponible enContent Manager en el entorno local del usuario. Si no está disponible en elentorno local del usuario, IBM Cognos BI correlaciona el entorno local del usuariocon un entorno local normalizado configurado en la pestaña Correlación deentorno local del contenido. Dado que el entorno local del usuario es fr-ca, secorrelaciona con fr. IBM Cognos BI utiliza el valor correlacionado para comprobarsi el informe está disponible en fr. En este caso, el informe está disponible en en-usy fr-fr, no en fr.

A continuación, IBM Cognos BI correlaciona cada uno de los informes disponiblescon un entorno local normalizado. Por lo tanto, en-us pasa a ser en y fr-fr pasa aser fr.

Puesto que el entorno local tanto del informe como del usuario se correlaciona confr, el usuario con el entorno local de usuario fr-ca verá el informe guardado con elentorno local fr-fr.

Ejemplo - El entorno local del informe y del usuario secorrelaciona con el mismo idioma

El entorno local del usuario y los entornos locales del informe se correlacionan conel mismo idioma. IBM Cognos BI elige qué entorno local utilizará. Por ejemplo, siel entorno local de un usuario es en-ca (inglés-Canadá) y los informes estándisponibles en en-us (inglés-Estados Unidos) y en-gb (inglés-Reino Unido), IBMCognos BI correlaciona todos los entornos locales con en. El usuario verá elinforme en el entorno local que IBM Cognos BI elija.

Ejemplo - Los entornos locales del informe y del usuario no secorrelacionan con el mismo idioma

Los entornos locales del informe y del usuario no se correlacionan con el mismoidioma. IBM Cognos BI elige el idioma. En este caso, puede que desee configuraruna correlación. Por ejemplo, si un informe está disponible en en-us(inglés-Estados Unidos) y fr-fr (francés-Francia), pero el entorno local del usuarioes es-es (español-España), IBM Cognos BI selecciona el idioma.


Correlación de entornos locales del contenidoUtilice la tabla Correlaciones de entornos locales del contenido para correlacionarlos entornos locales del usuario con un entorno local completo (idioma-región) oparcial (idioma). También puede correlacionar el idioma preferido de un usuariocon otro idioma si el contenido no está disponible en el idioma preferido delusuario.


De forma predeterminada, la tabla Correlaciones de entornos locales del contenidoincluye entornos locales que no contienen la región. Esto le permite utilizar sólo laparte de idioma del entorno local cuando especifica entornos locales y garantizaque siempre visualiza la información correcta. Por ejemplo, en una base de datosmultilingüe, los datos suelen estar disponibles en varios idiomas, como francés (fr),español (es) e inglés (en), en lugar de estar disponibles en distintos entornoslocales, como inglés de Canadá (en-ca), inglés de Estados Unidos (en-us) o francésde Francia (fr-fr).

Procedimiento1. En cada instalación de Content Manager, inicie IBM Cognos Configuration.2. Pulse Acciones > Editar configuración global.3. Pulse la pestaña Correlaciones de entorno local del contenido.4. Pulse Añadir.5. En el cuadro Clave, escriba el entorno local del usuario:

v Para asegurarse de que todas las regiones de un entorno local de usuario venel contenido en un idioma específico, escriba la parte de idioma del entornolocal, seguida de un guión (-) y un asterisco (*).Por ejemplo, escriba fr-*

v Para asegurarse de que un entorno local de usuario (idioma-región) ve elcontenido en un idioma específico, escriba el entorno local completo.Por ejemplo, escriba fr-ch

v Para correlacionar un idioma preferido con otro idioma, escriba la parte deidioma preferido del entorno local.Por ejemplo, escriba zh

Consejo: Para especificar el entorno local que se debe utilizar para un rango declaves, utilice el carácter comodín (*) con el valor Clave y, a continuación, en elcuadro Correlación de entorno local, escriba el entorno local. Por ejemplo, sidesea que todas las claves del alemán utilicen el entorno local alemán, escriba"de" en el cuadro Clave y escriba "de" en el cuadro Correlación de entornolocal.

6. En el cuadro Correlación de entorno local, escriba la parte de idioma delentorno local.Los entornos locales de usuario especificados en el cuadro Clave verán elcontenido en este idioma.

7. Repita los pasos anteriores para las demás correlaciones que desee realizar.8. Pulse Aceptar.9. Pulse Archivo > Guardar.


Cambio del huso horario del servidorPara cambiar el huso horario utilizado por Content Manager, seleccione otro husohorario de servidor en IBM Cognos Configuration.


Content Manager está configurado para utilizar el huso horario del sistemaoperativo de forma predeterminada. Todas las actividades planificadas en IBMCognos se establecen con este huso horario. Además, los usuarios de IBM CognosConnection utilizan este huso horario si establecen como preferencias el husohorario predeterminado.

Procedimiento1. Inicie IBM Cognos Configuration.2. Pulse Acciones > Editar configuración global.3. En el cuadro de diálogo Configuración global, pulse la pestaña General.4. Pulse la columna Valor de Huso horario del servidor y seleccione otro huso

horario de la lista.5. Pulse Archivo > Guardar.


Capítulo 15. Requisitos de configuración para losproveedores de autenticación

Puede configurar IBM Cognos Business Intelligence for z/OS para utilizar unproveedor de autenticación compatible con LDAP versión 3. IBM Cognos BI puedeutilizar las soluciones de almacenamiento y protección de datos centralizadas yautomatizadas que su organización utiliza para otras aplicaciones y recursos.

Inicio de sesión único

Después de configurar un proveedor de autenticación, puede habilitar el inicio desesión único para los componentes de IBM Cognos. Esto permite a un usuarioiniciar la sesión una sola vez y luego poder ir a otra aplicación sin que se le soliciteque inicie sesión de nuevo.

Autenticación

Los componentes de IBM Cognos BI se ejecutan con dos niveles de inicio desesión:v Inicio de sesión anónimo

De forma predeterminada, el acceso anónimo está habilitado.v Inicio de sesión autenticado

Debe configurar los componentes de IBM Cognos BI con un espacio de nombresadecuado para el tipo de proveedor de autenticación en su entorno.Puede configurar varios espacios de nombres para la autenticación y, acontinuación, seleccionar en tiempo de ejecución el espacio de nombres quedesee utilizar. Para obtener más información, consulte la publicación Guía deadministración y seguridad.

Seguridad de espacio de nombres

No inhabilite la seguridad después de habilitarla. Si suprime un espacio denombres, las entradas Mis páginas, Mis carpetas y Preferencias de usuario seperderán de forma permanente. Los valores de los permisos existentes se referirána usuarios, grupos o roles que ya no existen. Aunque esto no afecta alfuncionamiento de los permisos, un usuario que administre los valores de lospermisos puede ver entradas "desconocidas". Dado que estas entradas se refieren ausuarios, grupos y roles que ya no existen, puede suprimirlos de forma segura.

Inhabilitación del acceso anónimoSi sólo desea utilizar el inicio de sesión autenticado, puede utilizar IBM CognosConfiguration para inhabilitar el acceso anónimo.


De forma predeterminada, los componentes de IBM Cognos Business Intelligenceno requieren autenticación de usuario. Los usuarios pueden iniciar la sesión demanera anónima.


Procedimiento1. En cada ubicación en la que está instalado Content Manager, inicie IBM Cognos

Configuration.2. En el panel Explorador, pulse Seguridad > Autenticación > Cognos.

El recurso IBM Cognos representa el espacio de nombres de Cognos. El espaciode nombres de Cognos almacena información sobre los grupos de IBM Cognos,como Usuario anónimo, contactos y listas de distribución, y se refiere a objetosde otros espacios de nombres de seguridad.

3. En el panel Propiedades, pulse el cuadro situado junto a la propiedad Permitiracceso anónimo y, a continuación, seleccione Falso.



Ahora debe configurar un espacio de nombres, de manera que los usuarios tenganque proporcionar las credenciales de inicio de sesión cuando accedan a los recursosde IBM Cognos.Conceptos relacionados:“Requisitos de configuración para LDAP” en la página 171Puede configurar IBM Cognos Business Intelligence for z/OS para utilizar unespacio de nombres de LDAP como proveedor de autenticación.Tareas relacionadas:“Configuración de un espacio de nombres RACF” en la página 180Utilice IBM Cognos Configuration para configurar un espacio de nombres RACF(Resource Access Control Facility) para la autenticación.

Restricción del acceso de usuario al espacio de nombres de CognosSe puede restringir el acceso a los usuarios que pertenecen a cualquier grupo o roldefinido en el espacio de nombres incorporado de Cognos.


De forma predeterminada, todos los usuarios pertenecen a varios grupos o rolesincorporados. Para restringir el acceso, debe efectuar las tareas siguientes:__ v Habilite la propiedad para restringir el acceso mediante IBM Cognos

Configuration.__ v Elimine el grupo Todos de los roles y grupos de IBM Cognos incorporados

mediante IBM Cognos Administration.__ v Asegúrese de que los usuarios pertenecen al menos a uno de los roles o

grupos de IBM Cognos mediante IBM Cognos Administration.

Procedimiento1. En cada ubicación de Content Manager, inicie IBM Cognos Configuration.2. En el panel Explorador, en Seguridad, pulse Autenticación.3. En el panel Propiedades, cambie el valor de Restringir el acceso a los

miembros del espacio de nombres incorporado a Verdadero.4. Pulse Archivo > Guardar.



Ahora debe utilizar el portal para eliminar el grupo Todos de los roles y gruposincorporados y debe asegurarse de que los usuarios autorizados pertenecen comomínimo a un rol o grupo incorporado de IBM Cognos. Para obtener másinformación acerca de cómo añadir o eliminar miembros de un grupo o rol de IBMCognos, consulte la publicación Guía de administración y seguridad.

Requisitos de configuración para LDAPPuede configurar IBM Cognos Business Intelligence for z/OS para utilizar unespacio de nombres de LDAP como proveedor de autenticación.

Si instala más de un componente de Content Manager, debe configurarproveedores de autenticación idénticos en cada ubicación de Content Manager. Eltipo de proveedor de autenticación que seleccione y la manera de configurarlodeben ser idénticos en todas las instancias. La configuración debe contenerinformación a la que puedan acceder todos los componentes de Content Manager.

Configuración de un espacio de nombres de LDAP utilizandouna plantilla

Para configurar fácilmente un espacio de nombres de LDAP, elija una de unconjunto de plantillas configuradas previamente para cada tipo de proveedor deautenticación LDAP.

Procedimiento1. Inicie IBM Cognos Configuration.2. En el panel Explorador, en Seguridad, pulse con el botón derecho del ratón en

Autenticación > Nuevo recurso > Espacio de nombres.3. En el campo Nombre, escriba un nombre para el espacio de nombres.4. En la lista Tipo, seleccione la plantilla LDAP adecuada.

La plantilla se indica mediante LDAP - Tipo de proveedor de autenticación. Porejemplo, LDAP - IBM Tivoli es una plantilla que puede utilizar para configurarlos componentes de IBM Cognos para que utilicen IBM Tivoli Directory Server.

5. En el panel Propiedades, escriba un valor apropiado para la configuración.6. Para probar la conexión con el proveedor de autenticación y verificar que el

proveedor está soportado, en el panel Explorador, pulse con el botón derechodel ratón y pulse Probar.Vea los resultados de la prueba. Si los resultados muestran que el proveedorLDAP no está soportado, o que puede no estarlo, revise los entornos desoftware soportados en el centro del cliente de IBM Cognos(http://www.ibm.com/software/data/cognos/customercenter/).

7. Para guardar la configuración, pulse Archivo > Guardar.

Correlación de LDAPPara poder utilizar IBM Cognos Business Intelligence for z/OS con un servidorLDAP, el registro de usuarios de LDAP debe contener ya un mínimo deinformación sobre los usuarios y los grupos.

Capítulo 15. Requisitos de configuración para los proveedores de autenticación 171


Enlace de usuarios al servidor LDAP

Para enlazar un usuario con el servidor LDAP, el proveedor de autenticaciónLDAP debe construir el nombre distinguido (DN). Si la propiedad Utilizaridentidad externa está establecida en True, utiliza la propiedad Correlación deidentidad externa para intentar resolver el DN del usuario. Si no encuentra lavariable de entorno ni el DN en el servidor LDAP, intenta utilizar la propiedadBúsqueda de usuarios para construir el DN.

Correlación de identidad externa

Si los usuarios están almacenados jerárquicamente en el servidor de directorios,puede configurar las propiedades Búsqueda de usuarios y Correlación deidentidad externa para utilizar los filtros de búsqueda. Cuando el proveedor deautenticación LDAP realiza estas búsquedas, utiliza los filtros especificados paralas propiedades Búsqueda de usuarios y Correlación de identidad externa.También enlaza con el servidor de directorios utilizando el valor especificado parala propiedad Enlazar nombre distinguido y contraseña de usuario o el valoranónimo si no se ha especificado ningún valor.

Cuando un espacio de nombres de LDAP se ha configurado de modo que se utilicela propiedad Correlación de identidad externa para la autenticación, el proveedorde LDAP enlaza con el servidor de directorios utilizando Enlazar nombredistinguido y contraseña de usuario o utilizando anónimo si no se ha especificadoningún valor. Todos los usuarios que inician sesión en IBM Cognos BI medianteuna correlación de identidad externa ven los mismos usuarios, grupos y carpetasque el usuario de enlace.

Búsquedas que no utilizan la correlación de identidad externa

Si no utiliza la correlación de identidad externa, puede especificar si desea utilizarcredenciales de enlace para buscar el servidor de directorios LDAP configurando lapropiedad Utilizar credenciales de enlace para la búsqueda. Cuando la propiedadestá habilitada, las búsquedas se realizan utilizando las credenciales del usuario deenlace o el valor anónimo si no se ha especificado ningún otro valor. Si lapropiedad está inhabilitada, que es el valor predeterminado, las búsquedas serealizan utilizando las credenciales del usuario que ha iniciado la sesión. La ventajade utilizar credenciales de enlace es que, en lugar de cambiar los derechosadministrativos de varios usuarios, puede cambiar sólo los derechosadministrativos del usuario de enlace.

Si utiliza una sintaxis de DN, como uid=${userID}, ou=mycompany.com, para laspropiedades Búsqueda de usuarios, Correlación de identidad externa o Enlazarnombre distinguido y contraseña de usuario, deberá incluir caracteres de escapepara todos aquellos caracteres especiales que se utilicen en el DN.

Si utiliza una sintaxis de búsqueda, como (uid=${userID}), para las propiedadesBúsqueda de usuarios o Correlación de identidad externa, no debe incluircaracteres de escape para los caracteres especiales que se utilizan en el DN.

Configuración de un espacio de nombres de LDAPCuando se almacenan usuarios en un directorio de usuarios de LDAP, puedeconfigurar los componentes de IBM Cognos Business Intelligence for z/OS paraque utilicen un espacio de nombres de LDAP.


Procedimiento1. En cada ubicación donde haya instalado Content Manager, abra IBM Cognos

Configuration.2. En el panel Explorador, en Seguridad, pulse con el botón derecho del ratón en

Autenticación > Nuevo recurso > Espacio de nombres.a. En el cuadro Nombre, escriba un nombre para el espacio de nombres de

autenticación.b. En la lista Tipo, pulse el espacio de nombres correspondiente y, a

continuación, pulse Aceptar.El nuevo recurso de proveedor de autenticación aparece en el panelExplorador, bajo el componente Autenticación.

3. En el panel Propiedades, en la propiedad ID de espacio de nombres,especifique un identificador exclusivo para el espacio de nombres.

4. Especifique los valores de todas las propiedades necesarias restantes paraasegurarse de que los componentes de IBM Cognos puedan localizar y utilizarel proveedor de autenticación existente.

5. Si desea que el proveedor de autenticación LDAP enlace con el servidor dedirectorios utilizando un determinado valor de Enlazar nombre distinguido ycontraseña de usuario al realizar búsquedas, especifique estos valores.Si no se especifican los valores, el proveedor de autenticación LDAP se enlazacomo anónimo.Si la correlación de identidad externa está habilitada, Enlazar nombredistinguido y contraseña de usuario se utiliza para todo el acceso de LDAP.Si no está habilitada la correlación de identidad externa, Enlazar nombredistinguido y contraseña de usuario se utilizará únicamente cuando seespecifique un filtro de búsqueda para la propiedad Búsqueda de usuarios. Sies así, cuando se establezca el DN de usuario, las posteriores solicitudes delservidor LDAP se ejecutarán en el contexto de autenticación del usuario final.

6. Si no utiliza la correlación de identidad externa, utilice las credenciales deenlace para buscar en el servidor de directorio LDAP siguiendo estos pasos:a. Asegúrese de que Utilizar identidad externa se haya establecido en Falso.b. Establezca Utilizar credenciales de enlace para la búsqueda en Verdadero.c. Especifique el ID y la contraseña de usuario en Enlazar nombre distinguido

y contraseña de usuario.Si no especifica un ID y una contraseña de usuario, y se habilita el accesoanónimo, la búsqueda se realizará utilizando el valor anónimo.

7. Revise los valores de la correlación de los objetos y los atributos necesarios.En función de la configuración de LDAP, puede que tenga que cambiar algunosvalores predeterminados para garantizar una correcta comunicación entre loscomponentes de IBM Cognos Business Intelligence y el servidor LDAP.Todos los usuarios autenticados deben poder acceder a los atributos de LDAPcorrelacionados con la propiedad Nombre en Correlaciones de carpeta,Correlaciones de grupo y Correlaciones de cuenta. Además, la propiedadNombre no puede estar en blanco.

8. Pulse Archivo > Guardar.IBM Cognos Business Intelligence carga, inicializa y configura las bibliotecasdel proveedor del espacio de nombres.


Configuración de un espacio de nombres de LDAP para unIBM Directory Server

Puede configurar un nuevo espacio de nombres de LDAP para utilizarlo con IBMDirectory Server.

Procedimiento1. En cada ubicación donde haya instalado Content Manager, abra IBM Cognos

Configuration.2. En el panel Explorador, en Seguridad, pulse con el botón derecho del ratón

en Autenticación > Nuevo recurso > Espacio de nombres.3. En el cuadro Nombre, escriba un nombre para el espacio de nombres de

autenticación.4. En la lista Tipo, pulse LDAP y, a continuación, pulse Aceptar.

El nuevo recurso de espacio de nombres de autenticación aparece en el panelExplorador, bajo el componente Autenticación.

5. En el panel Propiedades, en la propiedad ID de espacio de nombres, escribaun identificador exclusivo para el espacio de nombres.No utilice los dos puntos (:) en la propiedad ID de espacio de nombres.

6. Especifique los valores de todas las propiedades necesarias restantes paraasegurarse de que IBM Cognos Business Intelligence for z/OS pueda localizary utilizar el proveedor de autenticación existente.a. En la propiedad Búsqueda de usuarios, escriba (cn=${IDusuario}).b. En la propiedad Enlazar nombre distinguido y contraseña de usuario,

escriba cn=root.7. Si desea que el proveedor de autenticación LDAP enlace con el servidor de

directorios utilizando un determinado valor de Enlazar nombre distinguido ycontraseña de usuario al realizar búsquedas, especifique estos valores.Si no se especifican los valores, el espacio de nombres de autenticación LDAPse enlaza como anónimo.

8. Si no utiliza la correlación de identidad externa, utilice las credenciales deenlace para buscar en el servidor de directorio LDAP siguiendo estos pasos:a. Asegúrese de que Utilizar identidad externa se haya establecido en Falso.b. Establezca Utilizar credenciales de enlace para la búsqueda en

Verdadero.c. Especifique el ID y la contraseña de usuario en Enlazar nombre

distinguido y contraseña de usuario.9. Para configurar las propiedades de correlación avanzadas de LDAP de manera

que se utilicen con los objetos de IBM Directory Server, utilice los valoresespecificados en la tabla siguiente.

Tabla 55. Propiedades de correlación avanzadas de LDAP

Correlac. Propiedad LDAP Valor LDAP

Carpeta Clase de objeto

Descripción

Nombre

organizationalunit,organization,container

description

ou,o,cn


Tabla 55. Propiedades de correlación avanzadas de LDAP (continuación)

Correlac. Propiedad LDAP Valor LDAP

Grupo Clase de objeto

Descripción

Miembro

Nombre

groupofnames

description

member

cn

Cuenta Clase de objeto

Teléfono de trabajo

Entorno local delcontenido

Descripción

Correo electrónico

Fax/Teléfono

Nombre de pila

Teléfono privado

Teléfono móvil

Nombre

Buscapersonas

Contraseña

Dirección postal

Entorno local delproducto

Apellidos

Nombre de usuario

inetorgperson

telephonenumber

(dejar en blanco)

description

mail

facsimiletelephonenumber

givenname

homephone

mobile

cn

pager

userPassword

postaladdress

(dejar en blanco)

sn

uid

Estas propiedades de correlación representan los cambios en función de unainstalación predeterminada de IBM Directory Server. Si ha modificado elesquema, puede que tenga que realizar cambios de correlación adicionales.Los atributos de LDAP que están correlacionados con la propiedad Nombreen las correlaciones Carpeta, Grupo y Cuenta deben estar accesibles paratodos los usuarios autenticados.La propiedad Nombre no debe estar en blanco.


Configuración de propiedades de usuario personalizadas paraun espacio de nombres de LDAP

Puede utilizar cualquier propiedad de usuario del proveedor de autenticaciónLDAP y ponerla a disposición de los componentes de IBM Cognos BusinessIntelligence for z/OS.



Para configurar las propiedades de usuario personalizadas, debe añadir estosatributos como propiedades personalizadas para el espacio de nombres de LDAP.Las propiedades personalizadas están disponibles como parámetros de sesión através de Cognos Framework Manager.

Procedimiento1. Abra Cognos Configuration en cada ubicación en la que haya instalado Content

Manager.2. En el panel Explorador, en Seguridad > Autenticación, pulse el espacio de

nombres de LDAP.3. En el panel Propiedades, pulse la columna Valor correspondiente a las

propiedades de Personalizado y pulse el botón de edición.4. En el cuadro Valor: Propiedades avanzadas, pulse Añadir.5. Pulse la columna Nombre y escriba el nombre que desea que los componentes

de IBM Cognos BI utilicen para el parámetro de sesión.6. Pulse la columna Valor y escriba el nombre del parámetro de cuenta en el

proveedor de autenticación LDAP.7. Repita los dos pasos anteriores para cada parámetro personalizado.8. Pulse Aceptar.9. Pulse Archivo > Guardar.

Habilitación de la comunicación segura con un servidor LDAPPara habilitar LDAP sobre SSL (LDAPS), instale un certificado con un formatocorrecto.

Para habilitar LDAPS, instale un certificado de servidor que esté firmado por unaentidad emisora de certificados en el servidor de directorios. El certificado deservidor debe ser una copia de uno de los siguientes certificados:v El certificado raíz de confianza y todos los demás certificados que componen la

cadena de confianza para el certificado de servidor de directorios.El certificado raíz de confianza es el certificado de la entidad emisora decertificados raíz que ha firmado el certificado de servidor de directorios.

v Sólo el certificado de servidor de directorios.

Los certificados deben ser de tipo Base64 codificados en formato ASCII (PEM).Ningún certificado, salvo el certificado raíz de confianza, debe estar autofirmado.

Procedimiento1. Cree un directorio para la base de datos de certificados.2. Cree la base de datos de certificados escribiendo

certutil -N -d directorio_certificados

donde directorio_certificados es el directorio que se ha creado en el paso 1.Este comando crea un archivo cert8.db y un archivo key3.db en el nuevodirectorio.

3. Añada el certificado de la entidad emisora de certificados (CA) o el certificadode servidor de directorios a la base de datos de certificados, escribiendo elcomando correspondiente al tipo de certificado:v Para un certificado CA, escriba


certutil -A -n nombre_certificado -d directorio_certificados -iCA.cert -t C,C,C

v Para un certificado de servidor de directorios, escribacertutil -A -n nombre_certificado-d nombre_certificado -icertificado_servidor.cert -t P

donde nombre_certificado es el alias que asigne, como el nombre de la entidademisora de certificados o el nombre de host, y certificado_servidor es el prefijodel archivo de certificado del servidor de directorios.

4. Copie el directorio de la base de datos de certificados en el directorioubicación_c10/configuration en cada instalación de Content Manager.

5. Configure el servidor de directorios para que utilice LDAPS y reinicie elservidor de directorios.Si desea obtener más información, consulte la documentación del servidor dedirectorios.

6. En cada ubicación de Content Manager en la que haya configurado el espaciode nombres de LDAP para utilizar el servidor de directorios, inicie CognosConfiguration.

7. En el panel Explorador, en Seguridad, Autenticación, pulse el espacio denombres de LDAP.

8. En el panel Propiedades, para la propiedad Host y puerto, cambie el puertopor el puerto LDAPS seguro.Para la propiedad Base de datos de certificados SSL, especifique la ruta deacceso al archivo cert7.db.

9. En el panel Explorador, pulse con el botón derecho del ratón en el espacio denombres de LDAP y pulse Probar.Si la prueba falla, revise las propiedades, asegurándose de utilizar elcertificado correcto.

10. Pulse Archivo > Guardar.11. Pulse Acciones > Reiniciar.12. Repita los pasos del 6 al 11 en cada instalación de Content Manager.

Inicio de sesión único entre un servidor LDAP y loscomponentes de IBM Cognos BI

Para simplificar el proceso de autenticación de los usuarios, habilite el inicio desesión único entre LDAP y los componentes de IBM Cognos Business Intelligencefor de z/OS.

Configure la propiedad Correlación de identidad externa para habilitar el inicio desesión único entre los componentes de IBM Cognos BI y LDAP. La propiedadCorrelación de identidad externa puede hacer referencia a una variable de entornoCGI o una variable de cabecera HTTP.

Entornos de servidor de aplicaciones

En el caso de una pasarela de servidor de aplicaciones o una entrada de asignadorque apunte a componentes de IBM Cognos BI, la propiedad Correlación deidentidad externa puede hacer referencia a la variable de sesiónuserPrincipalName. El valor resuelto de la propiedad Correlación de identidadexterna durante el tiempo de ejecución debe ser un DN de usuario válido.


Espacios de nombres de LDAP

Cuando un espacio de nombres de LDAP se configura de modo que se utilice lapropiedad Correlación de identidad externa para la autenticación, el proveedor deLDAP enlaza con el servidor de directorios utilizando Enlazar nombre distinguidoy contraseña de usuario o utilizando anónimo si no se ha especificado ningúnvalor. Todos los usuarios que inician sesión en IBM Cognos BI mediante unacorrelación de identidad externa ven los mismos usuarios, grupos y carpetas que elusuario de enlace.

Seguridad de Java

Si desea que los componentes de IBM Cognos BI funcionen con aplicaciones queutilizan la seguridad de servidor de aplicaciones o de Java, puede configurar lapropiedad Correlación de identidad externa para obtener el ID de usuario desdeel principal de usuario de Java. Incluya la señal${environment("USER_PRINCIPAL")} en el valor de la propiedad.

Operación de sustituciónPuede realizar ciertas tareas de edición de expresiones limitadas en la propiedadCorrelación de identidad externa mediante la operación de sustitución.

Función

La operación de sustitución devuelve una copia de la cadena con todas lasapariciones de la antigua subcadena sustituidas por la nueva subcadena.

Se aplican las siguientes reglas:v El carácter \ indica caracteres de escape en los parámetros de función. Es

necesario escapar los caracteres como \ y ".v No se soportan las llamadas a funciones anidadas.v No se soportan caracteres especiales.

Sintaxis

${replace(str , old , new)}

Parámetros de la operación de sustitución

En la tabla siguiente se enumeran las descripciones de los parámetros para laoperación de sustitución.

Tabla 56. Parámetros de la operación de sustitución y descripciones

Parámetro Descripción

str Cadena de la búsqueda.

old Subcadena que se va a sustituir por la nuevasubcadena.

new Subcadena que sustituye a la antiguasubcadena.

${replace(${environment("REMOTE_USER")},"NAMERICA\\",)}

${replace(${environment("REMOTE_USER")},"NAMERICA\\","")}


Requisitos de configuración del proveedor de autenticaciónpersonalizado

Puede configurar los componentes de IBM Cognos Business Intelligence for z/OSpara que utilicen un proveedor de autenticación Java personalizado.

Si ha implementado un proveedor de autenticación Java, puede hacer lo siguiente:v Configure los componentes de IBM Cognos para que lo utilicen.v Utilice un proveedor de autenticación personalizado para acceder y autenticar

usuarios en un origen de autenticación alternativo.v Utilice el proveedor de autenticación de cliente como un mecanismo de inicio de

sesión único para integrar los componentes de IBM Cognos BI con lainfraestructura de seguridad.

Cualquier configuración adicional para el acceso al origen de autenticación, elinicio de sesión único o los atributos personalizados depende de la implementacióndel proveedor de autenticación personalizado.

Para obtener más información, consulte la publicación Custom AuthenticationProvider Developer Guide.

Configuración de un espacio de nombres para un proveedorde autenticación personalizado

Puede configurar los componentes de IBM Cognos Business Intelligence for z/OSpara que utilicen un espacio de nombres de autenticación personalizado.

Antes de empezar

Asegúrese de que las versiones de Java Runtime Environment (JRE) y Java SDKque utiliza son compatibles entre sí. Si utiliza versiones soportadas de JRE y JavaSDK que no son compatibles entre sí, el proveedor de autenticación Javapersonalizado que configure no aparecerá en la lista de espacios de nombres enIBM Cognos Configuration.

Procedimiento1. En cada ubicación de Content Manager, abra IBM Cognos Configuration.2. En el panel Explorador, en Seguridad, pulse con el botón derecho del ratón en

Autenticación > Nuevo recurso > Espacio de nombres.3. En el cuadro Nombre, escriba un nombre para el espacio de nombres de

autenticación.4. En la lista Tipo, seleccione Proveedor Java personalizado y, a continuación,

pulse Aceptar.El nuevo recurso de proveedor de autenticación aparece en el panelExplorador, bajo el componente Autenticación.

5. En el panel Propiedades, en la propiedad ID de espacio de nombres, escribaun identificador exclusivo para el espacio de nombres.No utilice los dos puntos (:) en la propiedad ID de espacio de nombres.

6. Pulse Archivo > Guardar.7. En el panel Explorador, en Autenticación, pulse con el botón derecho del ratón

en el nuevo recurso de autenticación y pulse Probar para asegurarse de queIBM Cognos BI puede conectarse al nuevo espacio de nombres.


Resultados

IBM Cognos BI carga, inicializa y configura las bibliotecas del proveedor delespacio de nombres.

Cómo ocultar el espacio de nombres a los usuarios durante elinicio de sesión

Puede ocultar a los usuarios el espacio de nombres del proveedor de autenticacióndel cliente durante el inicio de sesión. Puede tener espacios de nombres de iniciode sesión de confianza y no mostrarlos en la lista de selección de espacios denombres que se visualiza cuando los usuarios inician la sesión.

Por ejemplo, puede integrar el inicio de sesión único entre los sistemas, peromantener la capacidad de los clientes de autenticarse directamente en IBM CognosBusiness Intelligence sin que se les pida que elijan un espacio de nombres.

Procedimiento1. En cada ubicación en la que haya configurado un proveedor de autenticación

Java personalizado, abra IBM Cognos Configuration.2. En el panel Explorador, en Seguridad > Autenticación, seleccione un

proveedor de autenticación Java personalizado.3. En el panel Propiedades, pulse el cuadro situado junto a Seleccionable para

autenticación y seleccione Falso.4. Pulse Archivo > Guardar.

Requisitos de autenticación de RACFEs necesario realizar ciertas tareas de configuración para poder utilizar ResourceAccess Control Facility (RACF) como proveedor de autenticación para IBM CognosBusiness Intelligence for z/OS.

Configuración de un espacio de nombres RACFUtilice IBM Cognos Configuration para configurar un espacio de nombres RACF(Resource Access Control Facility) para la autenticación.

Antes de empezar

Asegúrese de inhabilitar el acceso anónimo.

Para utilizar RACF, se necesita un servidor de directorios de Tivoli.

Para evitar poner en riesgo la seguridad y la integridad del sistema, un programadebe tener autorización de APF (recurso de programa autorizado) para poderacceder a las funciones restringidas y a las funciones del sistema sensibles. La JVMen la que se ejecuta IBM Cognos Business Intelligence en WebSphere ApplicationServer no es un programa autorizado. Sin embargo, Tivoli Directory Server es unprograma autorizado. Los componentes de IBM Cognos Business Intelligence forz/OS se comunican con Tivoli Directory Server mediante un proveedor deautenticación personalizado JAVA, y Tivoli Directory Server utiliza SDBM (gestiónde base de datos protegida) para comunicarse con RACF.


Procedimiento1. En la ubicación donde haya instalado Content Manager, abra IBM Cognos

Configuration.2. Cree un espacio de nombres RACF.

a. En el panel Explorador, en Seguridad, pulse con el botón derecho del ratónen Autenticación > Nuevo recurso > Espacio de nombres.

b. En el campo Nombre, escriba un nombre para el espacio de nombres deautenticación.

c. En la lista Tipo, seleccione RACF y, a continuación, pulse Aceptar.El nuevo recurso de proveedor de autenticación aparece en el panelExplorador, bajo el componente Autenticación.

3. En el panel Propiedades, en la propiedad ID de espacio de nombres,especifique un identificador exclusivo para el espacio de nombres.No utilice los dos puntos (:) en la propiedad ID de espacio de nombres.

4. En la propiedad Host y puerto, escriba el valor que se corresponda con TivoliDirectory Server.

5. En la propiedad Nombre distinguido de base, escriba el valor que coincida conel sufijo configurado para SDBM en Tivoli Directory Server.

6. Si está utilizando una conexión SSL con el proveedor RACF, defina lapropiedad Habilitar SSL en true.

7. Para correlacionar con propiedades de la cuenta RACF como el correoelectrónico y el número de teléfono, para las propiedades DATOS segmentobase y Segmento de TSO USERDATA en Correlaciones de cuenta, pulse lacolumna del valor y seleccione el valor en la lista desplegable.

8. En el menú Archivo, pulse Guardar.9. En el panel Explorador, en Autenticación, pulse con el botón derecho del ratón

en el nuevo recurso de autenticación y pulse Probar.Si la prueba es satisfactoria, el producto puede conectarse al nuevo proveedor.

Habilitación del inicio de sesión único entre RACF y loscomponentes de IBM Cognos BI

Habilite el inicio de sesión único entre RACF y los componentes de IBM Cognos BIpara simplificar el proceso de autenticación de los usuarios, evitar la necesidad devarios inicios de sesión y simplificar la gestión de la identidad de los usuarios enla red.


Puede habilitar el inicio de sesión único entre el proveedor RACF y loscomponentes de IBM Cognos BI configurando la correlación de identidad en IBMCognos Configuration, configurando IBM WebSphere Application Server paraestablecer REMOTE_USER y, a continuación, configurando WebSphere pararealizar la autenticación en RACF.

Al configurar un espacio de nombres RACF para que utilice la correlación deidentidad para la autenticación, el espacio de nombres RACF enlaza con elproveedor RACF mediante las credenciales de enlace o mediante un usuarioanónimo si no se especifican credenciales de enlace. Todos los usuarios que iniciansesión en IBM Cognos BI mediante una correlación de identidad ven los mismosusuarios, grupos y carpetas que el usuario de enlace.


Procedimiento1. Asegúrese de que ha configurado un proveedor de autenticación RACF en IBM

Cognos Configuration.2. Configure WebSphere para establecer REMOTE_USER; para ello, consulte la

documentación de WebSphere.3. Configure WebSphere para que la autenticación se realice con el proveedor

RACF; para ello, consulte la documentación de WebSphere.

Supresión de un proveedor de autenticaciónSi un espacio de nombres para un proveedor de autenticación deja de sernecesario, puede suprimirlo. Puede desconfigurar un espacio de nombres detectadopor los componentes de IBM Cognos Business Intelligence for z/OS.

No debe suprimir el espacio de nombres de Cognos. Contiene datos deautenticación que pertenecen a todos los usuarios y son necesarios para guardar laconfiguración.

Al suprimir un espacio de nombres, ya no podrá iniciar sesión en el espacio denombres. Los datos de seguridad del espacio de nombres permanecen en ContentManager hasta que los suprima de forma permanente en el portal. Para obtenermás información, consulte la publicación Guía de administración y seguridad.

Procedimiento1. Abra Cognos Configuration en cada ubicación en la que haya instalado Content

Manager.2. En el panel Explorador, en Seguridad > Autenticación, pulse con el botón

derecho del ratón en el espacio de nombres y pulse Suprimir.3. Pulse Sí para confirmar.

El espacio de nombres desaparecerá del panel Explorador y no podrá iniciarsesión en el espacio de nombres en ese sistema.

4. Pulse Archivo > Guardar.5. Repita los pasos anteriores del 1 al 4 en cada ubicación donde haya instalado

Content Manager.Ahora, debe iniciar la sesión en el portal y suprimir de manera permanente losdatos del espacio de nombres. Para obtener más información, consulte lapublicación Guía de administración y seguridad.

Resultados

Después de suprimir un espacio de nombres, aparecerá como inactivo en el portal.


Capítulo 16. Configuración de IBM Cognos Workspace

IBM Cognos Workspace se instala con el servidor de IBM Cognos BI. Después dela instalación, es necesario realizar ciertas tareas de configuración. También puederealizar tareas de configuración opcionales.

Por ejemplo, para obtener más información acerca de Cognos Workspace, puedeconfigurar los ejemplos del producto y, a continuación, puede utilizarlos.

Los ejemplos de Cognos Workspace se incluyen con los ejemplos de IBM CognosBusiness Intelligence.

Prueba de IBM Cognos WorkspacePuede probar IBM Cognos Workspace en cualquier momento después de iniciarseel servicio de IBM Cognos.

Procedimiento1. Abra un navegador e inicie sesión en IBM Cognos Connection.

2. Pulse en el botón de nuevo espacio de trabajo de la barra de herramientas.Si aparece un lienzo en blanco de espacio de trabajo de IBM CognosWorkspace, el servicio se ha iniciado correctamente.

3. Si hay informes disponibles, expanda una carpeta de informes en partes yarrastre una de ellas al lienzo.Si se abre el informe, IBM Cognos Workspace funciona correctamente.

Configuración del acceso a IBM Cognos WorkspaceConfigure el acceso a IBM Cognos Workspace otorgando los permisos necesariospara la prestación Panel de control ejecutivo a espacios de nombres, usuarios,grupos o roles específicos.


Puede otorgar acceso completo a IBM Cognos Workspace o puede otorgar accesosólo a la función de publicación.

IBM Cognos BI debe estar configurado y operativo para poder configurar el accesopara IBM Cognos Workspace.

Procedimiento1. En IBM Cognos Connection, en la esquina superior derecha, pulse Lanzar, IBM

Cognos Administration.2. En la pestaña Seguridad, pulse Funciones.3. Busque la prestación Panel de control ejecutivo.4. Para otorgar acceso a IBM Cognos Workspace y a toda su funcionalidad,

otorgue permisos de ejecución y de visita para la prestación Panel de controlejecutivo.


a. Pulse el botón Acciones que se encuentra junto al nombre de lafunción y, a continuación, seleccione Establecer propiedades.

b. Seleccione la pestaña Permisos.c. Otorgue el permiso de ejecución a todos los grupos de usuarios que deban

tener acceso a IBM Cognos Workspace y, a continuación, pulse Aceptar.5. Para otorgar acceso sólo a la función de publicación en IBM Cognos Workspace,

otorgue permisos de visita para la prestación Panel de control ejecutivo ypermisos de ejecución para la función protegida Publicar paneles de control enespacios de colaboración.

a. Pulse el botón Acciones que se encuentra junto a Utilizarcaracterísticas avanzadas de panel de control y pulse Establecerpropiedades.

b. Para establecer permisos de acceso de forma explícita para cada entrada,seleccione Reemplazar los permisos de acceso adquiridos de la entradapadre.

c. Para cada grupo de usuarios, seleccione la casilla de verificación que hayjunto a la entrada y, en el cuadro que aparece junto a la lista, seleccione lascasillas de verificación para otorgar permisos para la entrada.

d. Para añadir nuevas entradas a la lista, pulse Añadir y elija cómo seleccionarlas entradas.v Para seleccionar entradas disponibles, pulse el espacio de nombres

adecuado y, a continuación, seleccione las casillas de verificación situadasjunto a los usuarios, grupos o roles.

v Para buscar entradas, pulse Buscar e introduzca la frase que desea buscaren el cuadro Cadena de búsqueda. Para buscar opciones, pulse Editar.Busque la entrada que desee y pulse en ella.

v Para introducir el nombre de las entradas que desea añadir, pulse Tipo eintroduzca los nombres de grupos, roles o usuarios con el siguienteformato, donde un punto y coma (;) separa cada entrada;espacionombres/nombre_grupo;espacionombres/nombre_rol;espacionombres/nombre_usuario;

Otorgue los permisos adecuados para cada entrada nueva.e. Pulse Aceptar.

Base de datos de Human Task and Annotation ServicesDe forma predeterminada, los datos utilizados para Human Task and AnnotationServices en IBM Cognos Workspace se almacenan en la misma base de datos que elalmacén de contenido. Puede utilizar una base de datos independiente paraHuman Task and Annotation Services.

Creación de una base de datos de Human Task andAnnotation en DB2 para z/OS

La base de datos DB2 que cree en el sistema z/OS para Human Task andAnnotation Services debe contener los valores de configuración especificados.

Procedimiento1. Cree un subsistema de base de datos, un grupo de almacenamiento y una

cuenta de usuario para el almacén de contenido.


Debe tener autorización de administrador del sistema (SYSADM) o de control delsistema (SYSCTRL) para crear la base de datos.

2. Asegúrese de que la base de datos tiene las características siguientes:v UNICODE como CCSID.v Una agrupación de búferes con un tamaño de página de 32 KB.v Una segunda agrupación de búferes con un tamaño de página de 16 KB para

el subsistema de base de datos3. Asegúrese de que el administrador de base de datos otorga los derechos

CONNECT, CREATEIN y CREATE TABLE o que otorga DBADM al usuarioque gestiona la base de datos del almacén de contenido.Por ejemplo, para otorgar DBADM al usuario CGCUSERGRANT CREATETAB ON DATABASE CMDB101 TO CGCUSER

a. Asegúrese de que el usuario tiene privilegios para crear un índice en lasagrupaciones de búferes que se crearon y se reservaron al crear la base dedatos del almacén de contenido.Por ejemplo:GRANT USE OF BUFFERPOOL BP2 TO CGCUSER

b. Asegúrese de que el usuario tiene privilegios para crear un índice en ungrupo de almacenamiento que se haya creado al crear la base de datos delalmacén de contenido.Por ejemplo:GRANT USE OF STOGROUP SGDBT1DT TO CGCUSER

Creación de espacios de tabla para la base de datos deHuman Task and Annotation en DB2 en z/OS

Si está utilizando DB2 para z/OS, un administrador de base de datos debe ejecutarscripts para crear los espacios de tabla necesarios en la base de datos de HumanTask and Annotation. El script debe modificarse para sustituir los parámetros demarcador de posición por los que sean apropiados para el entorno.

Asegúrese de que utiliza las convenciones de nomenclatura para DB2 en z/OS. Porejemplo, todos los nombres de parámetros deben empezar por una letra y lalongitud no debe superar los seis caracteres. Para obtener más información,consulte el Information Center de IBM DB2.

Puede utilizar la base de datos del almacén de contenido o una base de datos porseparado para la base de datos de Human Task and Annotation. En cualquier caso,debe ejecutar los scripts para crear los espacios de tabla.


descartar espacios de tabla y permitir la ejecución de sentencias SQL.2. Para crear los espacios de tabla de tareas humanas, vaya al directorio

ubicación_c10/configuration/schemas/hts/zosdb2.a. Haga una copia de seguridad del archivo de script hts_tablespaces.sql y

guarde el archivo en otra ubicación.b. Abra el archivo de script HTS_TABLESPACES.sql original y utilice la tabla


Capítulo 16. Configuración de IBM Cognos Workspace 185







c. Guarde y ejecute el script.d. Abra el archivo de script HTS2_CREATE_Db2zos.sql y utilice la tabla siguiente






e. Guarde y ejecute el script.3. Para crear los espacios de tabla de anotaciones, vaya al directorio

ubicación_c10/configuration/schemas/ans/zosdb2.a. Haga una copia de seguridad del archivo de script ANN_TABLESPACES.sql y

guarde el archivo en otra ubicación.b. Abra el archivo de script ANN_TABLESPACES.sql original y utilice la tabla





DSN8G810 Nombre del grupo de almacenamiento

BP32K El nombre de la agrupación dealmacenamientos intermedios de 32 k.


c. Guarde y ejecute el script.d. Abra el archivo de script ANS2_CREATE_Db2zos.sql y utilice la tabla siguiente







e. Guarde y ejecute el script.Tareas relacionadas:“Creación de espacios de tabla para un almacén de contenido en DB2 para z/OS”en la página 62El administrador de base de datos deberá ejecutar scripts para crear un conjuntode espacios de tabla necesarios para la base de datos de almacén de contenido.Deberá modificar los scripts para sustituir los parámetros de marcador de posiciónpor los que sean apropiados para el entorno.

Configurar la base de datos de Human Task and AnnotationServices

De forma predeterminada, los datos utilizados para la característica Human Taskand Annotation Services en IBM Cognos Workspace se almacenan en la mismabase de datos que el almacén de contenido. Puede configurar una base de datosindependiente para Human Task and Annotation Services.


aplicación, inicie IBM Cognos Configuration.2. En el panel Explorador, pulse con el botón derecho en Human Task and

Annotation Services y seleccione Nuevo recurso > Base de datos.3. En el cuadro de diálogo Nuevo recurso - Base de datos, escriba un nombre

para la base de datos, seleccione Base de datos DB2 como el tipo y, acontinuación, pulse Aceptar.

4. En la ventana de propiedades de recursos de la base de datos, configure losvalores necesarios.

5. Pulse Archivo > Guardar.6. Para probar la conexión con la nueva base de datos, pulse Acciones > Probar.7. Repita estos pasos para cada componente de nivel de aplicación y la instancia

de Content Manager.

Cambio del estilo de los objetos de informe en IBM CognosWorkspace

Cuando arrastra un objeto de informe a un espacio de trabajo, éste aparece en elestilo degradado plateado y azul del producto. Puede configurar el aspecto delobjeto de informe en el estilo creado original cambiando una propiedad global enel archivo de configuración de IBM Cognos Viewer.

Los objetos de informe afectados por el valor global incluyen consultas, análisis,informes y partes de informes que se crearon mediante el estilo IBM CognosVersión 1.x, el estilo Versión 8.x y el estilo financiero (balance). Esos objetosadoptan el valor global aunque los guarde antes de cambiar dicho valor. El valorglobal sólo afecta a las miniaturas del espacio de trabajo si vuelve a ejecutar laminiatura.

Algunos objetos de informe no se verán afectados por el valor global y siempre serepresentarán en el estilo creado, como los informes de PowerPlay y las miniaturasde objetos de informe.

Capítulo 16. Configuración de IBM Cognos Workspace 187

Procedimiento1. Para cada instancia de Content Manager y de los componentes de nivel de

aplicación, vaya al directorio ubicación_c10/webapps/p2pd/WEB-INF/classes.2. Abra el archivo viewerconfig.properties en un editor de texto.3. Para que los objetos de informe aparezcan en el estilo original creado, cambie el

valor de useAuthoredReportStyles a true.4. Guarde el archivo y, a continuación, reinicie los servicios.


Capítulo 17. Opciones de configuración para el soporte deentidad emisora de certificados de terceros

De forma predeterminada, los componentes de IBM Cognos Business Intelligencefor z/OS utilizan un servicio de entidad emisora de certificados (CA) interna paraestablecer la raíz de confianza en la infraestructura de seguridad de IBM Cognos.Si ya utiliza una entidad emisora de certificados externa, puede configurar loscomponentes de IBM Cognos BI para que la utilicen.

Opciones de línea de comandos para script de certificado de tercerosExisten varias opciones de línea de comandos disponibles para utilizarlas con elscript de certificado de terceros. El script se utiliza para generar las claves y lassolicitudes de firma de certificado (CSR) que los componentes de IBM CognosBusiness Intelligence for z/OS necesitan.

En las tablas siguientes se enumeran las opciones para la herramienta de la líneade comandos que se utiliza para generar claves y solicitudes de firma.

Tabla 61. Opciones de línea de comandos y su descripción

Comando Descripción

-c Crear una nueva CSR

-i Importar un certificado

Tabla 62. Modificadores de operación y su descripción


-s Trabajar con la identidad de la firma

-e Trabajar con la identidad del cifrado

-T Trabajar con el almacén de confianza (sólocon -i)

Tabla 63. Distintivos de información y sus descripciones


-d DN que se debe utilizar para el certificado

-r CSR o ubicación del archivo de certificado(depende del modo)

-t Archivo del certificado de entidad emisorade certificados (sólo con -i)

-p Contraseña del almacén de claves (se debeproporcionar)

-a Algoritmo de par de claves. RSA o DSA.

Valor predeterminado: RSA

-a Algoritmo de par de claves. RSA o DSA.

Valor predeterminado: RSA

-D Ubicación del directorio


Tabla 64. Propiedades de ejemplo y sus valores

Propiedad Valor de ejemplo

DN del certificado de firma CN=SignCert,O=MiEmpresa,C=CA

DN del certificado de cifrado CN=EncryptCert,O=MiEmpresa,C=CA

Contraseña del almacén de claves contraseña

Generación de claves y solicitudes de firma de certificadosmediante un script

Utilice el programa de utilidad de línea de comandos para generar todas las clavespara los almacenes de claves de IBM Cognos y para generar las solicitudes defirma de certificados (CSR).

Antes de empezar

Haga copia de seguridad de los siguientes archivos o directorios:v ubicación_c10/configuration/cogstartup.xml

v ubicación_c10/configuration/signkeypair

v ubicación_c10/configuration/encryptkeypair

Procedimiento1. Mediante IBM Cognos Configuration, exporte la configuración sin cifrar.

a. Pulse Archivo > Exportar como.b. Cuando se le solicite si desea exportar el contenido descifrado, pulse Sí.c. En el cuadro de diálogo Exportar como, seleccione cogstartup.xml y, a

continuación, pulse Guardar.d. Cuando se le solicite si desea reemplazar el archivo existente, pulse Sí.e. Cuando se hayan realizado las tareas, cierre el cuadro de diálogo de IBM

Cognos Configuration.f. Guarde la configuración.g. Cierre IBM Cognos Configuration.

2. Vaya al directorio ubicación_c10/bin.3. Cree la solicitud de firma del certificado para las claves de firma escribiendo

el comando siguiente:ThirdPartyCertificateTool.sh -c -s -d "CN=SignCert,O=MiEmpresa,C=CA" -rsignRequest.csr -D ../configuration/signkeypair -p contraseña

El comando crea el archivo jSignKeystore en el directorio signkeypair,establece la contraseña especificada, crea un nuevo par de claves y loalmacena en el almacén de claves, y exporta el archivo signRequest.csr aldirectorio ubicación_c10/bin.

4. Cree la solicitud de firma del certificado para las claves de cifrado escribiendoel comando siguiente:ThirdPartyCertificateTool.sh -c -e -d "CN=EncryptCert,O=MiEmpresa,C=CA"-r encryptRequest.csr -D ../configuration/encryptkeypair -p contraseña

Puede ignorar de forma segura cualquier aviso acerca del registro.El comando crea el archivo jEncKeystore en el directorio encryptkeypair,establece la contraseña especificada, crea un nuevo par de claves y loalmacena en el almacén de claves, y exporta el archivo encryptRequest.csr aldirectorio ubicación_c10/bin.


5. Copie los archivos signRequest.csr y encryptRequest.csr que se hangenerando en un directorio al que la entidad emisora de certificados puedaacceder.

6. Proporcione los archivos signRequest.csr y encryptRequest.csr a la entidademisora de certificados.Para obtener más información, consulte la documentación de la entidademisora de certificados.La entidad emisora de certificados genera un certificado de firma y uncertificado de cifrado.

7. Copie el contenido de los certificados en los archivos de certificado.a. Copie el contenido del certificado de firma en un archivo

signCertificate.cer.b. Busque el certificado de la entidad emisora de certificados raíz para la

entidad emisora de certificados y copie el contenido en un archivodenominado ca.cer.

c. Copie ca.cer, signCertificate.cer y encryptCertificate.cer enubicación_c10/bin.Estos archivos deben tener formato PEM (ASCII codificado en Base-64).

8. Importe el certificado de firma al almacén de claves de firma IBM Cognos conel comando siguiente:ThirdPartyCertificateTool.sh -i -s -r signCertificate.cer -D../configuration/signkeypair -p contraseña -t ca.cer

9. Importe el certificado de cifrado del paso 11 al almacén de claves de cifradode IBM Cognos con el comando siguiente:ThirdPartyCertificateTool.sh -i -e -r encryptCertificate.cer -D../configuration/encryptkeypair -p contraseña -t ca.cer

El comando lee los archivos encryptCertificate.cer y ca.cer en el directorioubicación_c10/bin e importa los certificados de ambos archivos al archivojEncKeystore en el directorio encryptkeypair utilizando la contraseñaespecificada.

10. Importe el certificado de la entidad emisora de certificados del paso 12 alalmacén de confianza de IBM Cognos con el comando siguiente:ThirdPartyCertificateTool.sh -i -T -r ca.cer -D ../configuration/signkeypair -p contraseña

El comando lee el archivo ca.cer e importa el contenido al archivojCAKeystore en el directorio signkeypair utilizando la contraseña especificada.

Configuración de los componentes de IBM Cognos para que utilicenuna entidad emisora de certificados externa

Debe configurar cada instalación de componentes de IBM Cognos BusinessIntelligence for z/OS de modo que utilicen una entidad emisora de certificadosexterna.

Procedimiento1. Inicie IBM Cognos Configuration.2. En el panel Explorador, en Seguridad, Criptografía, pulse Cognos.3. En el panel Propiedades, en el grupo de propiedades Configuración de la

entidad emisora de certificados, pulse el cuadro Valor situado junto a lapropiedad Utilizar entidad emisora de certificados de terceros y pulseVerdadero.

Capítulo 17. Opciones de configuración para el soporte de entidad emisora de certificados de terceros 191

Nota: Al configurar esta propiedad como verdadera, se ignoran todas laspropiedades de la entidad emisora de certificados y el nombre de identidad.

4. Configure las propiedades siguientes para que coincidan con las que ha escritoen el programa de utilidad de línea de comandos:v Ubicación del almacén de claves de firma

v Contraseña del almacén de claves de firma

v Ubicación del almacén de claves de cifrado

v Contraseña del almacén de claves de cifrado

v Contraseña del almacén de claves de la entidad emisora de certificados

5. Pulse Archivo > Guardar.6. Para iniciar el servicio de IBM Cognos BI, pulse Acciones > Iniciar.

Esta acción inicia todos los servicios instalados que no se están ejecutando. Sidesea iniciar un determinado servicio, seleccione el nodo del servicio en elpanel Explorador y, a continuación, pulse Acciones > Iniciar.


Capítulo 18. Supervisión del rendimiento

Utilice la consola de IBM Cognos Administration y otras herramientas paraayudarle a mantener el rendimiento durante el ciclo de vida del producto.

Para obtener más información sobre IBM Cognos Administration, consulte lapublicación Guía de administración y seguridad.

Control del rendimiento mediante el uso de las funciones del gestorde carga de trabajo

Los requisitos de rendimiento de una instalación en un sysplex dependen de loselementos que WLM utiliza para gestionar las cargas de trabajo. Estos elementosincluyen cargas de trabajo, clases de servicio, reglas de clasificación y grupos declasificación.


Puede definir clases de servicio, que son agrupaciones de trabajo que tienenobjetivos de rendimiento, requisitos de recursos u objetivos operativos similares.También puede asociar las clases de servicio con las cargas de trabajo que ya sehayan creado. Asigne cada clase de servicio con una importancia relativa y uno delos objetivos siguientes:v Tiempo promedio de respuestav Tiempo de respuesta con percentilv Velocidad de ejecuciónv Discrecional

Para obtener más información sobre los valores de WLM, consulte la publicaciónSystem Programmer's Guide to: Workload Manager.

Procedimiento1. Para comenzar las definiciones de WLM, agrupe los componentes de trabajo en

cargas de trabajo que se puedan supervisar fácilmente.Por ejemplo, el gráfico siguiente muestra un ejemplo de la lista de cargas detrabajo de una instalación de IBM Cognos Business Intelligence que se ejecutadentro de una instancia de WebSphere Application Server.

Workload Selection List Row 1 to 15 of 21Command ===> ______________________________________________________________

Action Codes: 1=Create, 2=Copy, 3=Modify, 4=Browse, 5=Print, 6=Delete,/=Menu Bar

----Last Change-----Action Name Description User Date

__ DB2ADDR DB2 WORKLOAD SYSADM 1996/10/03__ DB2SPAS DB2 STORED PROCEDURE WORKLOAD SYSADM 1996/09/04__ DDF DB2 DDF WORKLOAD SYSADM 1996/09/04__ IRLM IRLM WORKLOAD SYSADM 1996/09/04__ OMVS OMVS WORKLOAD SYSADM 2010/05/26__ WAS_WKLD WebSphere Workloads SYSADM 2010/05/12


http://www.redbooks.ibm.com/abstracts/sg246472.html

2. Utilice las anotaciones del campo de descripción en la siguiente lista de clasesde servicio para definir los valores de clase de servicio iniciales de unainstalación típica de IBM Cognos Business Intelligence desplegada enWebsphere Application Server.

Service Class Selection List Row 1 to 14 of 23Command ===> ______________________________________________________________


Action Class Description Workload__ DB2ADDR DB2 ADDRS VEL60 IMP2 DB2ADDR__ DB2SPAS DB2 SPAS ADDR VEL25 IMP4 DB2SPAS__ DDF DDF LUNAME AVG R010 IMP3 DDF__ OMVSSRV OMVS SERVICE CLASS vel 70 OMVS__ WAS7CB WAS CB 0.5 Resp WAS_WKLD__ WAS7CR WAS V7 CR Vel 40 WAS_WKLD__ WAS7SR WAS V7 SR Vel 55 WAS_WKLD__ WAS7STC WAS V7 STC Vel 40 WAS_WKLD

Estos valores deben ajustarse según convenga.Por lo general, debe dar a DB2 la velocidad más alta (para el almacén decontenido, el almacén de datos o ambos), seguido de la región sirviente deWebSphere Application Server. La región sirviente de WebSphere ApplicationServer debe tener una velocidad superior a la de la región de control y la clasede servicio STC (tipo de subsistema de tarea iniciada). Sin embargo, todas lasclases de servicio de WebSphere Application Server se deben establecer envalores inferiores a los de DB2. Finalmente, proporcione la clase de ComponentBroker con un objetivo de tiempo de respuesta válido.

3. Defina las reglas de clasificación, que correlacionan el trabajo que llega alsistema con clases de informe y de servicio específicas.Por ejemplo, tal como se muestra en el gráfico siguiente, actualice los tipos desubsistema predeterminados CB (Component Broker), OMVS y STC.Command ===> ______________________________________________________________


------Class-------Action Type Description Service Report

__ ASCH not used__ CB Component Broker Requests WAS7CB WAS7CB__ CICS CICS TRANSACTION GROUP CICSTRN CICSRPT__ DB2 not used__ DDF DDF threads DDF__ IMS not used__ IWEB not used__ JES JES2 JOBS DEFAULTJ__ LSFM not used__ OMVS OMVS OMVSSRV__ SOM not used__ STC STARTED TASKS__ TSO TSO TASKS DEFAULTT

a. Añada un nombre de calificador de transacción preciso y clases de servicioy de informe a las reglas de subsistema existentes para Component Broker.Por ejemplo:

Modify Rules for the Subsystem Type Row 1 to 1 of 1Command ===> ___________________________________________ Scroll ===> PAGE

Subsystem Type . : CB Fold qualifier names? Y (Y or N)


Description . . . Component Broker Requests

Action codes: A=After C=Copy M=Move I=Insert ruleB=Before D=Delete row R=Repeat IS=Insert Sub-rule

More ===>--------Qualifier-------- -------Class--------

Action Type Name Start Service ReportDEFAULTS: WAS7CB WAS7CB

____ 1 TN BBO* ___ WAS7CB WAS7CB

b. Añada un nombre de calificador de transacción preciso y clases de servicioy de informe a las reglas de subsistema existentes para OMVS.Por ejemplo:


Subsystem Type . : OMVS Fold qualifier names? Y (Y or N)Description . . . OMVS



Action Type Name Start Service ReportDEFAULTS: OMVSSRV ________

____ 1 TN CGC ___ OMVSSRV CGC____ 1 TN CGC% ___ OMVSSRV CGCN____ 1 TN HTTP% ___ OMVSSRV HTTPN____ 1 UI * ___ OMVSSRV OMVSRPT

c. Añada un nombre de calificador de transacción preciso y clases de servicioy de informe a las reglas de subsistema existentes para STC.Por ejemplo:


Subsystem Type . : STC Fold qualifier names? Y (Y or N)Description . . . STARTED TASKS



Action Type Name Start Service ReportDEFAULTS: ________ ________

____ 1 TN BBOD* ___ SYSSTC WAS7AS____ 1 TN BBO%%%%S ___ WAS7SR WAS7SR____ 1 TN BBOFS* ___ WAS7SR WAS7CR____ 1 TN BBOS* ___ SYSSTC WAS7CR

4. Defina las clases de informe adecuadas para informes y análisis.Por ejemplo, puede crear informes de resumen de carga de trabajo de RMF porseparado para grupos de actividad específicos en función del nombre de clasede informe y de qué se ha asignado a cada clase.Para crear informes por espacio de direcciones, puede utilizar las definicionessiguientes como directrices.

Report Class Selection List Row 1 to 15 of 46Command ===> ______________________________________________________________


----Last Change-----Action Name Description User Date

__ CGC CGC REPORT CLASS SYSADM 2010/06/14__ CGCN CGC REPORT CLASS SYSADM 2010/06/15

Capítulo 18. Supervisión del rendimiento 195

__ DB2RPT DB2 REPORT CLASS SYSADM 1996/09/04__ DDFRPT DDF REPORT CLASS SYSADM 1996/09/04__ HTTPN HTTPN REPORT CLASS SYSADM 2010/07/06__ OMVSRPT omvs report class SYSADM 2005/11/22__ TCPRPT tcpip addr space report class SYSADM 2005/11/16__ WASCB WAS CB Report Class SYSADM 2010/09/27__ WASSTC WAS STC Report Class SYSADM 2010/09/27__ WAS7AS WAS App Server SYSADM 2010/10/02__ WAS7CB WAS CB Reporting Class SYSADM 2010/09/30__ WAS7CR WAS Control Region SYSADM 2010/10/02__ WAS7SR WAS Servant SYSADM 2010/10/02__ WAS7STC WAS STC Reporting Class SYSADM 2010/09/30

Supervisión de métricas del sistema con JMXPuede supervisar las métricas del sistema fuera de IBM Cognos Administrationmediante el uso de la tecnología Java Management Extensions (JMX) estándar delsector.

Antes de empezar

Para utilizar la característica de supervisión externa, debe instalar el Java SoftwareDevelopment Kit de IBM.


En primer lugar, deberá configurar dos propiedades JMX en IBM CognosConfiguration para permitir el acceso seguro a las métricas en el entorno de Java.A continuación, utilizará un ID de usuario seguro y una contraseña para conectarsea las métricas mediante una herramienta de conexión a JMX.

Procedimiento1. En la ubicación en la que está instalado Content Manager, inicie IBM Cognos

Configuration.2. En el panel Explorador, pulse Entorno.3. En el panel Propiedades, en Valores de asignador, pulse Puerto JMX externo.4. En el cuadro Valor, escriba un número de puerto disponible.5. En la propiedad Credencial JMX externa, en el cuadro Valor, pulse el icono

Editar, escriba un ID de usuario y una contraseña y, a continuación, pulseAceptar.

6.

El ID de usuario y la contraseña garantizan que solamente los usuariosautorizados puedan conectarse a los datos de las métricas del sistema en elentorno de Java utilizando el puerto especificado en Puerto JMX externo.

7. Guarde los cambios y reinicie el servicio.8. Para acceder a los datos de las métricas del sistema, especifique la información

siguiente en la herramienta de conexión a JMX:v El URL para conectarse a los datos de las métricas del sistema

Por ejemplo:service:jmx:rmi://servidor_Content_Manager/jndi/rmi://servidor_supervisión:<puerto_JMX>/proxyserver

siendo puerto_JMX el valor que ha escrito en Puerto JMX externo, yservidor_Content_Manager y servidor_supervisión, nombres de máquinas. Noutilice localhost, ni siquiera si se conecta de forma local.


v El ID de usuario y la contraseña para que la conexión sea seguraUtilice los mismos valores que haya configurado para Credencial JMXexterna.

Capítulo 18. Supervisión del rendimiento 197

Capítulo 19. Mantenimiento del producto

Los arreglos de mantenimiento temporales contienen actualizaciones para uno omás componentes del producto IBM Cognos Business Intelligence for z/OS y seaplican después de instalar el producto base.

Grupos de PSP (planificación de servicio preventivo)

Debe revisar la información del grupo de PSP (planificación de servicio preventivo)de un producto al aplicar el mantenimiento.

Visite el centro de soporte de software de IBM para obtener información sobre lasactualizaciones de PSP para IBM Cognos Business Intelligence for z/OS, o consultela publicación Program Directory. Aunque la publicación Program Directorycontiene una lista de los arreglos temporales de programa (PTF) necesarios, lainformación más reciente se encuentra en el centro de soporte de software de IBM.

Arreglos temporales de programa

Un PTF contiene un arreglo o un grupo de arreglos que repara un problemaconocido. Los PTF pueden aplicarse de forma individual y suelen formar parte deun paquete de arreglos que incluye varios PTF.

Fixpacks

Los fixpacks no son instalaciones independientes. Debe instalarlos en la mismaubicación que los componentes de IBM Cognos Business Intelligence existentes.

Los fixpacks son acumulativos y, por consiguiente, si hay varios fixpacksdisponibles, no es necesario instalar un fixpack anterior antes de instalar el másreciente. Sin embargo, primero debe instalar el código de disponibilidad general(GA).

Al aplicar el fixpack, el nuevo nivel del producto sobrescribe el nivel existente.

Si utiliza Websphere Application Server, la aplicación IBM Cognos se debedesplegar de nuevo después de aplicar el servicio.

Aplicación de un nivel de servicio a una instalación existenteEl servicio que se aplica a los conjuntos de datos de producto y a los sistemas dearchivos del producto requiere que se ejecute el programa de utilidad SMP/E(z/OS System Modification Program Extended) y, a continuación, el programa deinstalación de IBM Cognos.

Antes de empezarv Detenga los servicios.

Si el producto IBM Cognos está en ejecución, abra IBM Cognos Configuration ydetenga el servicio de IBM Cognos.

v Realice una copia de seguridad de la base de datos del almacén de contenido.v Realice una copia de seguridad de los archivos personalizados de la instalación

actual.



El programa SMP/E se utiliza para instalar los conjuntos de datos del actualizadory proporcionar el sistema de archivos del producto para el programa de instalaciónde IBM Cognos. Se utiliza un conjunto de scripts como parte del proceso posteriora la instalación para instalar los cambios del sistema de archivos de destino queson necesarios como consecuencia del mantenimiento del producto.

Después de aplicar servicio a una instalación existente, no se puede desinstalar.Para eliminar los arreglos de mantenimiento que se encuentran en una instalacióndel actualizador, debe desinstalar el producto base.

Procedimiento1. Para instalar los archivos del actualizador, ejecute los trabajos de instalación de

SMP/E necesarios.2. Para personalizar la instalación, genere y modifique el archivo de respuestas

correspondiente al programa de instalación del actualizador de IBM Cognos.3. Ejecute el instalador de IBM Cognos utilizando el archivo de respuestas

modificado.

Realización de tareas posteriores a la instalación después de aplicarun nuevo nivel de servicio

Es necesario realizar tareas posteriores a la instalación después de aplicar un nuevonivel de servicio.

Procedimiento1. Para que un producto IBM Cognos Business Intelligence desplegado vuelva a

estar en funcionamiento, abra IBM Cognos Configuration, guarde laconfiguración e inicie el servicio de IBM Cognos.

2. Si hay aplicaciones de IBM Cognos BI en ejecución en WebSphere ApplicationServer, vuelva a desplegarlas en el servidor de aplicaciones.


Apéndice A. Características de accesibilidad

Las características de accesibilidad ayudan a los usuarios que tienen unadiscapacidad física, por ejemplo movilidad restringida o visión limitada, a utilizarproductos de tecnología de la información.

Consulte IBM Accessibility Center para obtener más información acerca delcompromiso de IBM con respecto a la accesibilidad.

IBM Accessibility Center está disponible en línea en http://www.ibm.com/able.

Atajos del teclado para el asistente de instalación de IBM Cognosasistente de instalación de IBM Cognos proporciona atajos de teclado, o teclas deatajo.

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 65. Lista de atajos del teclado para el asistente de instalación de IBM Cognos

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+S

Volver al paso anterior de la configuración Alt+R

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 de la página del acuerdo de licencia delasistente de instalación.

Tabla 66. Lista de atajos del teclado en la página del acuerdo de licencia

Para Pulse

Aceptar el acuerdo de licencia Alt+A

Rechazar el acuerdo de licencia Alt+D

Salir del asistente de instalación Alt+S

Atajos del teclado para IBM Cognos ConfigurationIBM Cognos Configuration proporciona atajos de teclado, o teclas de atajo.


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 IBM Cognos Configuration en elsistema operativo Windows.

Nota: Los siguientes atajos del teclado se basan en teclados estándar de EE. UU.

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+A

Mostrar el menú Edición Alt+E

Mostrar el menú Ver Alt+V

Mostrar el menú Acciones Alt+C

Mostrar el menú Ayuda Alt+Y

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 z/OSUNIX System Services.

Para Pulse

Guardar la configuración actual Tabulador

Cerrar IBM Cognos Configuration Mayús+Tabulador

Cambiar el nombre al elemento seleccionado Alt+F4


Apéndice B. Opciones de la línea de comandos IBM CognosConfiguration

Utilice las opciones de línea de comandos con el comando de configuración paramodificar el comportamiento de IBM Cognos Configuration cuando se inicie.

Tabla 67. Opciones de línea de comandos y descripciones

Opción Descripciones

-h Visualiza comandos para IBM CognosConfiguration.

-s Ejecuta IBM Cognos Configuration en modosilencioso.

Utiliza los valores de propiedadespecificados en el archivo cogstartup.xmlpara configurar los componentes instaladosy después inicia todos los servicios.

./cogconfig.sh -s

cogconfig.bat -s

-stop Detiene todos los servicios de IBM Cognos.

./cogconfig.sh -stop

cogconfig.bat -stop

-startupfile ruta/nombre_archivo.xml Ejecuta IBM Cognos Configurationutilizando un archivo distinto del archivocogstartup.xml del directorioubicación_c10/configuration.

-test Utiliza los valores de propiedadespecificados en el archivo cogstartup.xmlpara probar los valores de configuración.

./cogconfig.sh -test

cogconfig.bat -test

-notest Inicia IBM Cognos Configuration con lastareas de prueba automática inhabilitadas.

./cogconfig.sh -notest

cogconfig.bat -notest

Esta opción no debe utilizarse la primeravez que inicia el producto o si estárealizando cambios de configuración.

-utf8 Guarda la configuración en codificaciónUTF-8.

./cogconfig.sh -s -utf8

cogconfig.bat -s -utf8


Tabla 67. Opciones de línea de comandos y descripciones (continuación)

Opción Descripciones

-l identificador de idioma Ejecuta IBM Cognos Configurationutilizando el idioma que especifica elidentificador de idioma.

Para ejecutar la herramienta deconfiguración en modo silencioso utilizandoel chino simplificado

./cogconfig.sh -l zh-cn

cogconfig.bat -l zh-cn

-e nombre_archivo.xml Exporta los valores de configuración actualesal archivo especificado.

./cogconfig.sh -e nombre_archivo.xml

cogconfig.bat -e nombrearchivo.xml

-log Crea un archivo de registro de errorescogconfig.timestamp.log en el directorioubicación_cognos/logs.

./cogconfig.sh -log

cogconfig.bat -log

-java:{local|env} Ejecuta IBM Cognos Configuration en lossistemas operativos Microsoft Windowsutilizando la versión de Java RuntimeEnvironment que se ha definido como:

v env: en el entorno, utilizando la variablede entorno JAVA_HOME

v local: localmente, desde el directorioubicación_c10/bin/jre

Si no establece este distintivo, IBM Cognosutiliza el valor de variable de entornoJAVA_HOME.

Para ejecutar IBMCognos Configuration enmodalidad silenciosa, utilizando la JVMlocal, escriba el mandato siguiente:

./cogconfig.sh -s -java:local

cogconfig.bat -s -java:local

Puede utilizar más de una opción de línea de comandos al mismo tiempo. Porejemplo, puede ejecutar IBM Cognos Configuration en modo silencioso y enviartodos los mensajes de error a un archivo de registro.


Apéndice C. Ejemplos de IBM Cognos BI

En los ejemplos de IBM Cognos Business Intelligence se ilustran las característicasdel producto y las prácticas técnicas y empresariales recomendadas. Tambiénpuede utilizarlos para probar y compartir técnicas de diseño de informes y laresolución de problemas.

Para ver ejemplos relacionados con distintos tipos de negocios, consulte losesquemas de productos en http://www.ibm.com. Para obtener información acercade opciones de instalación y entornos específicos, consulte la publicación IBMCognos Architecture and Deployment Guide o las prácticas recomendables y las guíasorientativas de implementación de IBM Cognos en http://www.ibm.com. Paraobtener más información acerca de los ejemplos de auditoría, consulte lapublicación IBM Cognos Guía de administración y seguridad.

Dónde encontrar los ejemplos

Los ejemplos se incluyen como un componente opcional con el producto. Losejemplos para cada estudio se describen en la guía de usuario relacionada y en laayuda en línea. Para utilizar los ejemplos, debe configurarlos.

Qué ejemplos existen

Los ejemplos se componen de las siguientes características:v Una base de datos que contiene todos los datos corporativos, los modelos de

ejemplo relacionados para realizar análisis y consultas, así como cubos, informes,consultas y plantillas de consulta de ejemplo.

v Informes interactivos que permiten colocar el cursor sobre las características delinforme para saber cómo funcionan las características y el motivo por el que sehan incluido

Seguridad

Puede añadir seguridad a los ejemplos utilizando una lista de empleados incluidacon el producto. La lista puede ser un archivo LDIF que puede importarse encualquier servidor de directorios.

Restauración de los archivos de copia de seguridad de la base dedatos de ejemplos

Para poder utilizar los ejemplos, debe restaurar los archivos de copia de seguridadde la base de datos de ejemplos. Esta acción vuelve a crear versiones multilingüesde la base de datos de ejemplos.

Antes de empezar

Debe tener autorización de administrador del sistema (SYSADM) o de control delsistema (SYSCTRL) para crear la base de datos, los procedimientos almacenados ylas vistas.


http://www.ibm.com

http://www.ibm.com


Utilice los scripts que se proporcionan para realizar las tareas siguientes:v Crear una base de datos denominada CGCGSDBv Crear un espacio de tabla denominado GSDBTSv Crear y cargar las tablas en los esquemas GOSALES GOSALESRT GOSALESMR

GOSALESHR GOSALESDW

Procedimiento1. Cree usuarios nuevos o utilice usuarios existentes con privilegios de selección

para las tablas en el esquema.Por ejemplo, en la configuración de los paquetes de ventas de VA se especificaun solo objeto de conexión e inicio de sesión del usuario. Esto requiere unúnico usuario con nombre con el privilegio de selección para las tablas en elesquema GOSALES.

2. Asegúrese de que no exista otra base de datos CGCGSDB ni el espacio de tablaGSDBTS en el subsistema DB2.Si la base de datos o el espacio de tablas ya existe, limpie el subsistema de basede datos descartando las tablas. De lo contrario, al crear la base de datos o elespacio de tablas encontrará errores similares a estos:THE NAME (VERSION OR VOLUME SERIAL NUMBER) OF THE OBJECT TO BE

DEFINED OR THE TARGET

v Cuando crea la base de datos, es posible que vea el siguiente mensaje:THE NAME (VERSION OR VOLUME SERIAL NUMBER) OF THE OBJECT TO BE DEFINEDOR THE TARGET OF A RENAME STATEMENT IS IDENTICAL TO THE EXISTING NAME(VERSION OR VOLUME SERIAL NUMBER) CGCGSDB OF THE OBJECT TYPE DATABASE.SQLCODE=-601, SQLSTATE=42710, DRIVER=3.57.9

v Cuando crea el espacio de tabla, es posible que vea el siguiente mensaje:THE NAME (VERSION OR VOLUME SERIAL NUMBER) OF THE OBJECT TO BE DEFINEDOR THE TARGET OF A RENAME STATEMENT IS IDENTICAL TO THE EXISTING NAME(VERSION OR VOLUME SERIAL NUMBER) CGCGSDB.GSDBTS OF THE OBJECTTYPE TABLESPACE.SQLCODE=-601, SQLSTATE=42710, DRIVER=3.57.91

3. Vaya al directorio ubicación_c10/webcontent/samples/datasources/db2zos yextraiga el archivo CGCGSDB.tar.gz.Por ejemplo, utilice el comando siguiente:tar -xfo cogbisrvr_zos64_.tar

Utilice la opción -o para asegurarse de que se utiliza la propiedad del usuarioque pasa el comando.

4. En la ubicación en la que ha extraído los archivos, vaya al directorioCGCGSDB/unix:a. Cambie los permisos de acceso del archivo setupGSDB.sh para asegurarse de

que el propietario tiene acceso de ejecución.chmod u+x setupGSDB.sh

b. Cambie la codificación del archivo setupGSDB.sh por ASCII.chtag -t -c ISO8859-1 setupGSDB.sh

5. Localice el archivo clp.properties en el subsistema DB2 donde desea instalarla base de datos de ejemplo.Por ejemplo: ../usr/lpp/db2xxx_base/samples/clp.propertiesa. Añada un alias denominado CGCSAMP al archivo clp.properties.


Si ya hay un alias para CGCSAMP, compruebe los valores siguientes:v El URL del servidor para asegurarse de que es correctov Las credenciales de inicio de sesión del servidor para asegurarse de que

el usuario tiene suficientes privilegiosSi la conexión con la base de datos falla al ejecutar el script, vaya aldirectorio ubicación_c10/logs y revise el archivo GOSALES_DB.log. Porejemplo, si ve un mensaje similar al siguiente, el usuario no tiene suficientesprivilegios:DSNC109I : An error occurred while establishing a new connection.Error code : -4214 sqlstate: 28000 sqlerr Message:[jcc][t4][2013][11249][3.57.91] Connection authorizationfailure occurred. Reason: User ID or Password invalid.ERRORCODE=-4214, SQLSTATE=28000

6. En la ubicación en la que ha extraído los archivos, vaya al directorioCGCGSDB/unix/GS_SCRIPTS y edite los archivos de script SQL para utilizar lainformación adecuada para su entorno.a. Abra el archivo GOSALES_SP.sql en un editor y cambie el valor WLM.b. Abra el archivo GOSALES_DB.sql y cambie el nombre del grupo de

almacenamiento en las sentencias create database y create tablespace.7. Ejecute el script setupGSDB.sh.

Nota: El script puede tardar mucho tiempo en ejecutarse.

Resultados

Si el script se ejecuta correctamente, se crean la base de datos GSDBTS y el espaciode tabla CGCGSDB.

Si el script no se ejecuta correctamente, vaya al directorio ubicación_c10/logs yrevise el archivo GOSALES_DB.log.

Los usuarios con autorización DBADM pueden crear la base de datos, pero no podráncrear procedimientos almacenados ni vistas. Los usuarios con autorización DBADMverán un error similar al siguiente en el registro de resultado que se crea:<USER> DOES NOT HAVE THE PRIVILEGE TO CREATE A VIEW WITHQUALIFICATION GOSALESDW. SQLCODE=-164, SQLSTATE=42502, DRIVER=3.57.91

Si se produce este error, los usuarios deben solicitar que un usuario conautorización de SYSADM o SYSCTRL edite y ejecute el script GOSALES_VIEWS_SP.sqlutilizando el mandato siguiente:db2 -td@ -f <location>/GOSALES_VIEWS_SP.sql > results.log

El "@" símbolo es obligatorio y especifica el carácter de terminación de lassentencias SQL.

Realice esta acción si no se utilizan los valores predeterminados o si debe cambiarel valor de WLM.

Informes de ejemplo para el modo de consulta dinámicaCon IBM Cognos Business Intelligence se proporcionan modelos e informes deejemplo que se han optimizado para el modo de consulta dinámica.

Apéndice C. Ejemplos de IBM Cognos BI 207

Cuando se instalen y se desplieguen, encontrará los ejemplos actualizados en lapestaña Carpetas públicas de IBM Cognos Connection, en una carpetadenominada Samples_DQ. El nombre de los informes actualizados también se hacambiado con el sufijo _DQ.

Se han modificado ligeramente los ejemplos para que aprovechen las principalesmejoras del modo de consulta dinámica. Por ejemplo, se actualizaron informespara aplicar un orden de clasificación concreto y especificar un modo deagregación.

Para acceder a los ejemplos del modo de consulta dinámica, debe modificar lasconexiones de origen de datos según dos orígenes de datos de ejemplo parahabilitar las conexiones JDBC y, a continuación, importar el archivo actualizado dedespliegue de ejemplos.

Modificación de las conexiones de origen de datos según losorígenes de datos de ejemplo

Para importar y utilizar los informes de ejemplo de consulta dinámica, debemodificar las conexiones de origen de datos existentes según dos bases de datosrelacionales de ejemplo para habilitar una conexión JDBC.

Para obtener más información acerca de la configuración de los ejemplos de IBMCognos y acerca de la creación de conexiones de origen de datos, consulte lapublicación IBM Cognos Guía de administración y seguridad.

Procedimiento1. En IBM Cognos Administration, seleccione la pestaña Configuración y pulse

Conexiones con orígenes de datos.

Nota: Para acceder a esta área de IBM Cognos Administration, debe tener lospermisos necesarios para la característica protegida Tareas de administración.

2. Pulse en el origen de datos de ejemplo great_outdoors_sales.3. En la columna Acciones, pulse el botón Establecer propiedades para la

conexión de origen de datos great_outdoors_sales.4. En la pestaña Conexión, en Cadena de conexión, pulse en el icono Editar la

cadena de conexión.5. En la pestaña JDBC, active la casilla de verificación Habilitar conexión JDBC.6. Especifique los parámetros de conexión JDBC para el origen de datos.7. Pulse Probar la conexión y, a continuación, en Probar.

En la página de resultados de la prueba de conexión, observe los resultados deJDBC en la columna Tipo / Modo de consulta.

8. Repita los pasos 1 a 6 con la conexión de origen de datos de ejemplogreat_outdoors_warehouse.

Importación del contenido de los ejemplos de consultadinámica (paquetes) al almacén de contenido

Después de haber modificado las conexiones de origen de datos para los orígenesde datos de ejemplo, debe importar el contenido de los ejemplos de consultadinámica o los paquetes del archivo de despliegue de ejemplo.

Los ejemplos de consulta dinámica se encuentran en el archivo de desplieguedenominado IBM_Cognos_Samples_DQ.zip.


Para obtener más información acerca de la configuración de los ejemplos de IBMCognos y acerca de la importación de contenido, consulte la publicación IBMCognos Guía de administración y seguridad.

Procedimiento1. Copie el archivo IBM_Cognos_Samples_DQ.zip del directorio

ubicación_c10/webcontent/samples/content en el directorio en el que se hanguardado los archivos de despliegue. La ubicación predeterminada esubicación_c10/deployment. La ubicación se establece en la herramienta deconfiguración. Para obtener información sobre el cambio de ubicación,consulte la ayuda en línea de dicha herramienta.

2. En IBM Cognos Administration, seleccione la pestaña Configuración y pulseAdministración de contenidos.

Nota: Para acceder a esta área de IBM Cognos Administration, debe tener lospermisos necesarios para la característica protegida Tareas de administración.

3. En la barra de herramientas, pulse el botón Nueva importación. Aparecerá elasistente para Nueva importación.

4. En el cuadro Archivo de despliegue, seleccione el archivoIBM_Cognos_Samples_DQ y pulse en Siguiente.

5. Escriba un nombre exclusivo y una descripción y sugerencia de pantallaopcionales para el archivo de despliegue, seleccione la carpeta donde deseeguardarlo y, a continuación, pulse Siguiente.

6. En el cuadro Contenido de carpetas públicas, seleccione la carpetaSamples_DQ.

7. Seleccione las opciones que desee, junto con la selección de resolución deconflictos para las opciones que seleccione y, a continuación, pulse Siguiente.

8. En la página Especificar las opciones generales, seleccione si desea incluirpermisos de acceso y referencias a espacios de nombres externos, así comoquién debe ser el propietario de las entradas después de importarlas.

9. Pulse Siguiente. Aparecerá la información de resumen.10. Revise la información de resumen y pulse Siguiente.11. Pulse Guardar y ejecutar una vez.12. Pulse Finalizar, especifique la hora y la fecha de la ejecución y, a

continuación, pulse Ejecutar.13. Revise la hora de ejecución y pulse Aceptar.14. Cuando haya enviado la importación, pulse Finalizar.

Resultados

Ahora ya puede utilizar el paquete de ejemplo de consulta dinámica para crearinformes y ejecutar los informes de ejemplo que están disponibles en la carpetaSamples_DQ, en la pestaña Carpetas públicas del portal.

Apéndice C. Ejemplos de IBM Cognos BI 209

Apéndice D. Resolución de un problema

La resolución de problemas es un enfoque sistemático para solucionar un problema.El objetivo de la resolución de problemas es determinar la razón por la que algo nofunciona como estaba previsto y decidir cómo resolverlo.

Revise la tabla siguiente, que tanto usted como el soporte al cliente pueden utilizarpara resolver un problema.

Tabla 68. Acciones para la resolución de problemas

Acción Descripción

Aplique todos los fixpacks, niveles deservicio o arreglos temporales de programa(PTF) conocidos.

Puede que haya un arreglo de productodisponible para solucionar el problema.

Asegúrese de que la configuración estésoportada.

Revise la página web de entornos desoftware soportados.

Busque los códigos de los mensajes de errorseleccionando el producto en IBM SupportPortal y, a continuación, escriba el códigodel mensaje de error en el cuadro Buscarsoporte en la barra de menús vertical de laderecha.

Los mensajes de error proporcionaninformación importante que ayuda aidentificar el componente que estáprovocando el problema.

Reproduzca el problema para asegurarse deque no se trata de un error aislado.

Si el producto tiene ejemplos disponibles,intente reproducir el problema utilizando losdatos de ejemplo.

Compruebe la estructura del directorio deinstalación y los permisos de archivo.

La ubicación de instalación debe contener laestructura de archivos y los permisos dearchivo adecuados.

Por ejemplo, si el producto requiere accesode escritura a los archivos de registro,asegúrese de que el directorio tenga lospermisos correctos.

Revise la documentación pertinente,incluidas las notas de la versión, las notastécnicas y la documentación de prácticasrecomendables.

Consulte las bases de conocimientos de IBMpara determinar si se trata de un problemaconocido, si tiene solución temporal, o si yaestá resuelto y documentado.

Revise los cambios recientes en el entornoinformático.

A veces, instalar un software nuevo puedegenerar problemas de compatibilidad.

Si los elementos de la lista de comprobación no le ayudan a encontrar unasolución, puede que tenga que recopilar datos de diagnóstico. El representante desoporte técnico de IBM necesitará estos datos para ayudarle a resolver el problema.También puede recopilar datos de diagnóstico y analizarlos usted mismo.

Recursos para resolver problemasLos recursos para resolver problemas son fuentes de información que puedenayudarle a resolver un problema con un producto de Cognos. Muchos de losenlaces a recursos que se ofrecen en esta sección también pueden verse en unbreve vídeo de demostración.


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


http://www.ibm.com/support/entry/portal/


Para ver la versión en vídeo, busque "Cognos troubleshooting" (o "(re)solución deproblemas de Cognos") en el motor de búsqueda Google o la comunidad de vídeosYouTube.

Support PortalIBM Support Portal es una vista unificada y centralizada de todas las herramientasde soporte técnico y de la información de todos los sistemas, software y serviciosde IBM.

IBM Support Portal permite acceder a todos los recursos de soporte de IBM desdeun único lugar. Puede adaptar las páginas para centrarse en la información y losrecursos que necesita para prevenir problemas y resolver con rapidez losproblemas que se presenten. Familiarícese con IBM Support Portal mediante losvídeos de demostración.

Busque el contenido de Cognos que necesita seleccionando los productos en IBMSupport Portal.

Búsqueda y desplazamiento por los productos de CognosEl acceso a la información sobre productos de IBM Cognos ahora puedeconfigurarse en IBM Support Portal, que permite ver todos los enlaces en una solapágina.

Las prácticas recomendadas para la búsqueda y el desplazamiento por lainformación sobre productos de Cognos están disponibles en la página IBMCognos Support Portal and Technote Search Best Practices.

Recopilación de informaciónAntes de contactar con el soporte de IBM, recopile los datos de diagnóstico(información del sistema, síntomas, archivos de registro, rastreos, etc.) que senecesitan para resolver un problema. Al recopilar esta información, podráfamiliarizarse con el proceso de resolución de problemas y ahorrará tiempo.

La información sobre qué datos se deben recopilar está disponible como notastécnicas MustGather.

Solicitudes de servicioLas solicitudes de servicio se conocen también como registros de gestión deproblemas (PMR). Existen varios métodos para enviar información de diagnósticoal soporte técnico de software de IBM.

Para abrir un PMR o intercambiar información con el soporte técnico, consulte: lapágina IBM Software Support Exchanging information with Technical Support. LosPMR también se pueden enviar directamente utilizando la herramienta desolicitudes de servicio (PMR) o el resto de los métodos soportados que se detallanen la página de intercambio de información.

Herramientas de determinación de problemasPara diagnosticar y resolver problemas habituales, hay disponibles variasherramientas de determinación de problemas de IBM Cognos.


https://www.ibm.com/blogs/SPNA/entry/the_ibm_support_portal_videos



https://www-304.ibm.com/support/docview.wss?uid=swg21373237

https://www-304.ibm.com/support/docview.wss?uid=swg21373237

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

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

http://www.ibm.com/software/support/exchangeinfo.html

http://www.ibm.com/software/support/exchangeinfo.html

http://www.ibm.com/support/entry/portal/Open_service_request/Software/Information_Management/Cognos_Business_Intelligence_and_Financial_Performance_Management

http://www.ibm.com/support/entry/portal/Open_service_request/Software/Information_Management/Cognos_Business_Intelligence_and_Financial_Performance_Management

Estas herramientas se pueden descargar desde la página de programas de utilidadde diagnóstico de Cognos. IBM Education Assistant ofrece vídeos y otros recursosformativos sobre estas herramientas de diagnóstico en el sitio web IBM EducationAssistant Problem Determination.

Centro del cliente de CognosEl centro del cliente de IBM Cognos proporciona información específica de Cognos,así como actualizaciones y recursos para resolver problemas.

Para ver la información de resolución de problemas de Cognos, acceda al centrodel cliente de Cognos y podrá consultar la información en "Contacting Support" oen "Troubleshooting Resources".

Productos y mantenimiento mediante Shop zSeriesPuede utilizar el sitio web de Shop zSeries para realizar pedidos de productos y demantenimiento (también llamado arreglos temporales de programa o PTF) desistemas principales (mainframes). El mecanismo de entrega de productos principales el soporte físico, pero también existen CBPDO (Custom-Built Product DeliveryOfferings) electrónicos.

Para obtener más información sobre cómo solicitar productos y mantenimiento, ysobre cómo registrarse, consulte la nota técnica Ordering Products andMaintenance through Shop zSeries.

Bases de conocimientosLas bases de conocimientos de IBM permiten encontrar soluciones a los problemas.

Puede utilizar la búsqueda de cabecera maestra de IBM escribiendo la cadena debúsqueda en el campo de búsqueda situado en la parte superior de cualquiera delas páginas de ibm.com.

Information Center de CognosLos Information Center de IBM Cognos incluyen documentación para cada versión.Esta documentación también está disponible a través de los menús de ayuda delproducto.

Los Information Center de Cognos, así como la documentación traducida, estándisponibles en IBM Cognos Business Intelligence y Performance Management.

Para ver los enlaces a los problemas conocidos y los APAR más recientes, acceda alas Notas de la versión disponibles en cada Information Center.

IBM RedbooksLos libros rojos (Redbooks) de IBM se desarrollan y publican por la Organizacióninternacional de soporte técnico de IBM (ITSO).

Los libros rojos (Redbooks) de IBM proporcionan una orientación completa sobretemas como instalación, configuración o implementación de soluciones.

Documentación de prácticas recomendablesLas prácticas recomendables de Cognos, creadas por expertos de Cognos a partirde experiencias reales de clientes, ofrecen información técnica verificada enentornos de tecnología específicos.

Apéndice D. Resolución de un problema 213

http://www.ibm.com/software/analytics/support/sdktabv17.html

http://www.ibm.com/software/analytics/support/sdktabv17.html

http://publib.boulder.ibm.com/infocenter/ieduasst/imv1r0/index.jsp?topic=/com.ibm.iea.cognos/cognos/8.0/ProblemDetermination.html

http://publib.boulder.ibm.com/infocenter/ieduasst/imv1r0/index.jsp?topic=/com.ibm.iea.cognos/cognos/8.0/ProblemDetermination.html





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

http://www.redbooks.ibm.com/

Las prácticas recomendables, como recurso para resolver problemas, ofrecen unacceso rápido a las diez prácticas más habituales para Business Intelligence yFinancial Performance Management, además de vídeos y otra información: CognosProven Practice documentation.

Soporte de software y entradas RSSLas entradas RSS del soporte de software de IBM son un método rápido, sencillo yligero de mantenerse al día sobre el contenido nuevo que se añade a los sitios web.

Cuando haya descargado un lector de RSS o un conector para su navegador, puedesuscribirse a las entradas de productos de IBM en IBM Software Support RSSfeeds.

Foros y comunidadesLos foros de productos de IBM Cognos son un entorno para compartir ideas ysoluciones con otros usuarios de la comunidad de IBM Cognos.

Los foros activos de Cognos están disponibles en la página sobre foros ycomunidades de Cognos.

Archivos de registroLos archivos de registro pueden ayudarle a resolver problemas al registrar lasactividades que tienen lugar cuando trabaja con un producto.

Las operaciones que se realizan en el producto se registran en diversos archivos deregistro para fines de seguimiento. Por ejemplo, si ha experimentado problemasdurante la instalación, consulte el archivo de registro de transferencia para saberqué actividades del asistente de instalación se han realizado durante latransferencia de archivos.

Antes de ver los archivos de registro, asegúrese de que contienen la informaciónque necesita. El número de archivos de registro y la información que contienen seconfigura mediante parámetros en IBM Cognos Connection y en IBM CognosConfiguration.

Utilice IBM Cognos Administration para obtener información sobre las categoríasde registro y sobre la configuración del nivel de detalle de cada categoría.

El archivo de registro de transferencia

Este archivo registra las actividades que el asistente de instalación ha realizadodurante la transferencia de archivos. El archivo de registro de transferencia seencuentra en el directorio ubicación_c10/instlog. El nombre de archivo identificael nombre del producto, la versión y el número de compilación, e incluye unaindicación de fecha y hora. A continuación se proporciona un ejemplo del formatodel nombre de archivo:

tl-BISRVR-10.2-0.0-20120901_1122.txt

El archivo de registro de resumen/errores de transferencia

Este archivo registra los componentes que ha instalado, la información de espaciode disco, las selecciones realizadas en los diálogos de transferencia y los erroresque el programa de instalación ha encontrado durante la transferencia de loscomponentes. El archivo de registro de resumen/errores de transferencia seencuentra en el directorio ubicación_c10/instlog. El nombre de archivo identifica


http://www.ibm.com/developerworks/data/library/cognos/cognosprovenpractices.html

http://www.ibm.com/developerworks/data/library/cognos/cognosprovenpractices.html

https://www-01.ibm.com/software/support/rss/

https://www-01.ibm.com/software/support/rss/

http://www.ibm.com/developerworks/data/community/#cognos

http://www.ibm.com/developerworks/data/community/#cognos

el nombre del producto, la versión y el número de compilación, e incluye unaindicación de fecha y hora. A continuación se proporciona un ejemplo del formatodel nombre de archivo:

tl-CBISRVR-10.2-0.0-20120901_1122_summary_error.txt

El archivo de configuración de inicio

En este archivo se registran sus opciones de configuración cada vez que guarda susvalores de propiedades. El nombre del archivo es cogstartup.xml. Si no puedeguardar la configuración o si tiene otros problemas con el archivo, puede revertir aun archivo de configuración guardado anteriormente. Los archivos deconfiguración de copia de seguridad se encuentran en el directorioubicación_c10/configuration. A continuación se proporciona un ejemplo delformato del nombre de archivo para los archivos de configuración de copia deseguridad:

cogstartup_201211231540.xml

El archivo de bloqueo de configuración de inicio

Este archivo se crea cada vez que se abre IBM Cognos Configuration. Esto impideque se abra más de una ventana de IBM Cognos Configuration. Si experimentaproblemas al abrir IBM Cognos Configuration, compruebe en el directorioubicación_c10/configuration si existe el archivo cogstartup.lock. Si el archivoexiste pero IBM Cognos Configuration no está abierto, significa que IBM CognosConfiguration no se cerró correctamente la última vez que lo utilizó. Puedesuprimir el archivo de bloqueo y, a continuación, abrir IBM Cognos Configuration.

El archivo de configuración de entorno local

En este archivo se registran las opciones de configuración que se realizan en IBMCognos Configuration con respecto a los entornos locales de productos ycontenido, correlación de entorno local y soporte para moneda. Si experimentaalgún problema con el soporte de idioma en la interfaz de usuario o en losinformes, use estos archivos para realizar un seguimiento de los cambios. Losarchivos de configuración de copia de seguridad se encuentran en el directorioubicación_c10/configuration. A continuación se proporciona un ejemplo delformato del nombre de archivo:

coglocale_201211231540.xml

El archivo de registro en tiempo de ejecución (cogserver.log)

El archivo de registro de IBM Cognos predeterminado denominado cogserver.log,u otros archivos de registro que configure para recibir los mensajes de registro delservidor de registro, registran información después de iniciar el servicio de IBMCognos. Se encuentran en el directorio ubicación_c10/logs. Si ha configurado otrodestino para los mensajes de registro, consulte el archivo o la base de datoscorrespondiente.

Algunos mensajes de registro indican problemas. La mayoría de los mensajessolamente proporcionan información, pero hay otros que pueden ayudarle adiagnosticar problemas en su entorno de tiempo de ejecución.


El archivo de registro de pasarela

Los errores de pasarela se registran en el archivo de registro de pasarela, que seencuentra en el directorio ubicación_c10/logs. Puede usar el archivo de registro depasarela para solucionar aquellos problemas que impidan que la pasarela puedaprocesar solicitudes o usar cifrado. Los síntomas de estos problemas son: los ID deusuario y las contraseñas no funcionan, el inicio de sesión único no funciona, elasignador está en ejecución pero los usuarios reciben el mensaje de error siguiente:

IBM Cognos BI Server no está disponible.

El archivo de registro de pasarela usa el siguiente formato de nombre, dondegateway_interface es cgi.

gwcgi.log

El archivo de registro de desinstalación

Este archivo registra las actividades que el programa de desinstalación ha realizadoal desinstalar archivos. El archivo de registro se llama cognos_uninst_log.htm y seencuentra en el directorio Temp. Puede utilizar el archivo de registro parasolucionar los problemas relacionados con la desinstalación de los componentes deIBM Cognos.

Archivos de volcado de imagen de memoriaSi recibe un mensaje de error que indica que el servidor de informes no responde,IBM Cognos escribió un archivo principal de volcado (.dmp) en el sistema dearchivos. Los archivos de volcado de imagen de memoria indican un serioproblema con el programa, como una excepción no manejada o un proceso de IBMCognos que terminó de forma anómala. Los archivos de volcado de imagen dememoria crean un volcado de memoria completo del estado actual del programacuando ocurre el problema. El archivo de imagen de memoria normalmente indicaun error que requiere una corrección de software.

Si ve el mensaje que indica que el servidor de informes no responde, compruebeinmediatamente si en el directorio ubicación_c10/bin de la instalación del servidorde IBM Cognos hay archivos de volcado de imagen de memoria.

En Windows, estos archivos se denominan ID_proceso.dmp, comoBIBusTKServerMain_seh_3524_3208.dmp. En z/OS UNIX, los archivos se denominan"core". Estos archivos binarios deben visualizarse con un programa de depuración.

Si el administrador del servidor no puede solucionar el problema, póngase encontacto con el centro de recursos de IBM Cognos y facilíteles un caso de prueba,si es posible, y los archivos de imagen de memoria. Los archivos de imagen dememoria pueden ocupar más de 300 MB, y cada vez que se produce el problemase crea uno del mismo tamaño.

Ejecución de scripts de limpieza de índices y bases de datosDurante la resolución de un problema, se le puede pedir que inicie con nuevosdatos de configuración. Puede ejecutar scripts SQL para suprimir todas las tablasde cualquiera de las bases de datos que utilizan los componentes de IBM CognosBusiness Intelligence. Al suprimir una tabla, su definición estructural y sus datosse suprimen permanentemente de la base de datos.


Puede suprimir tablas en las bases de datos siguientes utilizando scripts de SQL:v Almacén de contenidov Base de datos de entrega para notificaciones de informesv Human Tasksv Annotations

Puede ejecutar scripts SQL para suprimir todas las tablas e índices de la base dedatos de registro para los mensajes de registro.

Procedimiento1. En cada ubicación en la que está instalado Content Manager, inicie el servicio

de IBM Cognos.2. Vaya al directorio adecuado:

v Para suprimir tablas e índices de la base de datos de registro, vaya aldirectorio ubicación_c10/configuration/schemas/logging.

v Para suprimir tablas del almacén de contenido, vaya al directorioubicación_c10/configuration/schemas/content.

v Para suprimir tablas de la base de datos de notificaciones, vaya al directorioubicación_c10/configuration/schemas/delivery.

v Para suprimir tablas de la base de datos de Human Task, vaya al directorioubicación_c10/configuration/schemas/hts.

v Para suprimir tablas de la base de datos de Annotations, vaya al directorioubicación_c10/configuration/schemas/ans.

3. Vaya al directorio de base de datos que corresponda.4. Ejecute los scripts siguientes para suprimir las tablas.

La siguiente tabla contiene los nombres de script para cada base de datos.

Tabla 69. Tipo de base de datos y nombres de script

Base de datos Nombre de script

Almacén de contenido dbClean_db2zOS.sql

Notificaciones NC_DROP_DB2.sql

Registro LS_dbClean_db2zOS.sql

LS_dbCleanIndexes_db2zOS.sql

Human Tasks humanTaskService-dropScript.sql

Annotations annotationService-dropScript.sql

5. Inicie el servicio de IBM Cognos.Automáticamente se crea un nuevo conjunto de las tablas e índices de base dedatos necesarios.

Mensajes de consolaLos mensajes de instalación de IBM Cognos Business Intelligence for z/OS son unaimportante herramienta para resolver problemas.


En los temas siguientes se proporcionan las descripciones de los mensajes que haemitido el producto durante la instalación, con explicaciones y respuestas delusuario sugeridas.

Cómo interpretar los números de mensaje

El producto emite mensajes para comunicar el estado del sistema y los resultadosdel procesamiento. Los mensajes se identifican mediante números de mensajeexclusivos. El formato de un número de mensaje puede ayudarle a saber a qué seaplica el mensaje y, en algunos casos, su gravedad.

Los mensajes se identifican mediante números de mensaje exclusivos, que tienenuna longitud de entre ocho y diez caracteres. Los identificadores de mensajestienen el siguiente formato:CGC0001I

CGC Los tres primeros caracteres son CGC, que es el prefijo del componente deIBM Cognos.

209 El identificador numérico tiene entre tres y cinco caracteres de longitud ycomienza en el cuarto carácter del mensaje. El identificador numérico esexclusivo dentro del subcomponente.

I El último carácter del identificador de mensaje es el código de tipo demensaje.

La tabla siguiente describe los códigos de mensajes.

Tabla 70. Códigos de tipo de mensaje de IBM Cognos

Código de tipo demensaje Significado

E Se requiere una acción inmediata. Se ha producido un error. La tareaasociada no continuará hasta que se emprenda la acción solicitada.

W La acción puede ser necesaria de forma inmediata o en el futuro. Setrata de un mensaje de aviso. Normalmente la tarea asociada secompleta, pero se han detectado posibles problemas.

I No se requiere acción alguna. El mensaje es únicamente informativo.

Limitaciones de juego de caracteres para los mensajes en laconsola del sistema z/OS

En la consola del sistema z/OS se puede visualizar un conjunto limitado decaracteres. Por ejemplo, los caracteres alfabéticos que contienen diacríticos, como ladiéresis, se muestran como espacios en blanco.

Mensajes del registro de IBM Cognos

Los mensajes del archivo de registro de IBM Cognos no se ven afectados porque seda soporte a varios idiomas. Los mensajes se escriben en el idioma especificadopor el valor de entorno local del servidor. El entorno local del servidor estádeterminado por el idioma que se ha especificado durante la instalación en elarchivo response.ats. Puede cambiar el valor del entorno local del servidordespués de la instalación en IBM Cognos Configuration (Acciones > Editarconfiguración global).


Mensajes de consola

La consola del sistema z/OS visualiza mensajes sólo en inglés. Si el idiomaespecificado en el valor de entorno local del servidor no es el inglés, el sistemamostrará el texto en inglés correspondiente.

CGC0001IDPR-SYS-6000 El producto está preparado para utilizarse.

Explicación

Los servicios se ha iniciado correctamente y el producto está preparado paraaceptar solicitudes.

Respuesta del usuario

No se requiere acción alguna.

CGC0002IDPR-SYS-6001 El producto se está cerrando.

Explicación

Los servicios se están cerrando, y esta operación puede tardar unos minutos. Ya nose procesarán solicitudes.



CGC0003ECAM-AAA-0044 Se ha producido un error en la llamada a ldap_init. Compruebelos parámetros siguientes: %1 y %2.

Explicación

No se ha podido establecer contacto con el servidor LDAP que se utiliza paraautenticar a los usuarios y las solicitudes no se pueden procesar.


En la herramienta de configuración, verifique que el nombre de host y el puerto deLDAP sean correctos y que se hayan especificado con la sintaxis host:puerto. Para elnombre de host, utilice la dirección IP o el nombre completo correspondiente a susistema.

CGC0004ECM-SYS-5003 Content Manager no puede acceder al almacén de contenido.Verifique los parámetros de conexión de base de datos y, a continuación, póngaseen contacto con el administrador de base de datos para obtener ayuda.

Explicación

Content Manager no puede conectarse al almacén de contenido.



Compruebe que el servidor de bases de datos esté en ejecución. Verifique que laspropiedades de conexión de base de datos indicadas en la herramienta deconfiguración sean correctas y que, cuando se prueba la conexión, la prueba seacorrecta.

CGC0005ICM-SYS-5090 indica que Content Manager %1 ha iniciado %2.

Explicación

Este mensaje muestra una lista de las versiones de compilación y esquema delcomponente de Content Manager que se está iniciando.



CGC0006ICM-SYS-5094 Content Manager se ha interrumpido.

Explicación

Este mensaje muestra una lista de las versiones de compilación y esquema delcomponente de Content Manager que se está cerrando.



CGC0007IDPR-DPR-1002 Se ha registrado correctamente el asignador %1 en ContentManager.

Explicación

Cuando se inicia un asignador local o remoto, se registra en Content Manager.



CGC0008ICM-SYS-5159 Content Manager se está ejecutando en modo activo.

Explicación

Este es el Content Manager activo y procesará las solicitudes. Todos los demáscomponentes de Content Manager que se están ejecutando estarán en modo enespera.




CGC0009ICM-SYS-5160 Content Manager se está ejecutando en modo en espera. La direcciónURL de Content Manager activa es %1.

Explicación

Este Content Manager está en modo en espera y no procesará las solicitudes amenos que el Content Manager activo deje de estar disponible.



CGC0010ERSVP-SRV-0040 Se ha producido un error de aplicación. Póngase en contacto con eladministrador.

Explicación

El servidor de informes ha encontrado un error interno.


Compruebe si el error genera archivos de imagen de memoria en el directorio bindel producto o archivos CEEDUMP. Si es posible, aumente el nivel de registro en laherramienta de administración de IBM Cognos y reproduzca las condiciones quehan provocado el error.

CGC0011EDPR-ERR-2077 Error en la solicitud porque no está disponible el proceso deservicio de informes asociado con pid %1.

Explicación

Esto puede ocurrir por las siguientes razones.v Un informe incluye un objeto de gráfico que utiliza una consulta cuyo

procesamiento está establecido en solo base de datos.v La agrupación de aplicaciones se ha configurado de forma incorrecta.v Se ha establecido un valor incorrecto para el número de procesos de informe o

por lotes en IBM Cognos Configurationv Existen errores de conexión para el asignador.


Asegúrese de que se han aplicado al producto todos los servicios, arreglos yactualizaciones. Compruebe el estado del servicio de informes en la interfaz deusuario de administración para determinar si el servicio está disponible.Compruebe el estado de los procesos BIBusTKServerMain. Para obtener más


información, consulte los registros del producto en el directorio de registros y losarchivos de volcado en el directorio bin.

CGC0012ERSV-DST-0014 Se ha producido un error. Consulte los detalles del historial deejecución para obtener más información.

Explicación

No se puede finalizar la ejecución del informe planificado. El servidor de informesno puede actualizar el estado de ejecución del informe.


Asegúrese de que el servicio de eventos y el servicio de entrega se hayan iniciado.Asegúrese de que esta cuenta de usuario tiene permisos de acceso completo para lainstalación. Si utiliza WebSphere Application Server, este grupo debe incluir elusuario que inicia el servidor de aplicaciones y el usuario propietario de losarchivos de IBM Cognos. Para que sea más fácil, también puede utilizar la cuentade usuario del servidor de aplicaciones para instalar y ejecutar los componentes deIBM Cognos.

CGC0013ECNC-DS-0031 No se puede encontrar el alias con la ruta de búsqueda %1

Explicación

El informe no puede guardarse ni planificarse porque hay un problema con lospermisos de acceso de la entrada. Los permisos de acceso indican los usuarios quetienen acceso a entradas tales como informes. Las credenciales de confianza sepueden utilizar para autorizar a otros usuarios a utilizar sus credenciales cuandodichos usuarios no tienen permisos de acceso suficientes para realizar tareasespecíficas.


Compruebe la propiedad del informe y asegúrese de que la cuenta de usuariotiene permisos de acceso suficientes para realizar la tarea.

CGC0014ECM-REQ-4158 La ruta de búsqueda %1 no es válida.

Explicación

Hay un problema para acceder a un objeto en Content Manager. Puede que elobjeto contenga sintaxis no válida o un carácter no soportado, o que la cuenta deusuario del espacio de nombres no tenga suficientes privilegios.


Asegúrese de que los grupos y usuarios del espacio de nombres tienen suficientesprivilegios para visitar la entrada del directorio. Compruebe la sintaxis del objetopara asegurarse de que es correcta.


CGC0015ECM-REQ-4098 La sintaxis de la ruta de búsqueda no es correcta. El predicado de laruta de búsqueda no es válido. Falta el corchete de cierre (]).

Explicación

Hay un problema para acceder a un objeto en Content Manager. Puede que elobjeto contenga sintaxis no válida o un carácter no soportado. Por ejemplo, si hayun carácter de diéresis (ä, ö, ü) o caracteres asiáticos en la ruta a la carpeta delobjeto, podría ver este error.


Compruebe el objeto para asegurarse de que la ubicación de destino no contienecaracteres especiales.

CGC0016EUDA-SQL-0031 indica que no es posible acceder a la base de datos %1.

Explicación

El producto no puede conectar con el origen de datos.


Asegúrese de que los parámetros de conexión a la base de datos estánconfigurados correctamente. Por ejemplo, compruebe que la conexión de origen dedatos contiene la información de inicio de sesión, como la contraseña, paraconectar con la base de datos. Asegúrese de que la base de datos está disponible.

CGC0017EUDA-SQL-0107 Se ha producido una excepción general durante la operación %1.

Explicación

Se ha producido un error no especificado durante una operación de SQL.


Consulte los archivos de registro para identificar el informe que ha causado elerror. En los archivos de registro, compruebe si hay códigos de error queproporcionen información más específica sobre el problema.

CGC0018EQFS-ERR-0139 La solicitud tiene varios errores.

Explicación

Se ha producido un problema con una consulta de informe. Puede haber errores enla definición de solicitud o de detalle.



Consulte los archivos de registro para determinar el informe que ha causado elerror. En los archivos de registro, compruebe si hay códigos de error queproporcionen información más específica sobre el problema. Arregle lasdefiniciones de solicitud o de detalle en el informe. Por ejemplo, elimine losespacios finales en el nombre de la solicitud.

CGC0019ERQP-DEF-0354 La consulta contiene una o más solicitudes sin resolver.

Explicación

Se ha ejecutado un informe sin que se haya definido un valor de solicitud. Esteerror se puede producir después de actualizar.


Compruebe la definición de solicitud del informe. Ejecute el informe en CognosReport Studio para reproducir el error y compruebe la sintaxis y la definición decada solicitud.

CGC0020ERQP-DEF-0177 Se ha producido un error al realizar la operación %1 %2.

Explicación

Se ha producido un error al ejecutar una operación de SQL. Los códigos de error ylas funciones indicados en el error son internos del producto.


Examine las consultas en el informe que ha provocado el error.

CGC0021EUDA-SQL-0114 El cursor proporcionado para la operación %1 está inactivo.

Explicación

El objeto de base de datos utilizado por el producto para manipular los datos noha devuelto ningún resultado.


Compruebe que hay suficiente espacio temporal para la base de datos para realizarla consulta y que el servidor de bases de datos tiene suficiente memoria paravolcar los archivos temporales.

CGC0022ECAM-AAA-0134 No se puede recuperar información para el usuario %1.


Explicación

El usuario se ha autenticado correctamente, pero el objeto solicitado no se haencontrado.


Consulte en el proveedor de autenticación la información solicitada. Verifique lascorrelaciones de grupos y las entradas de carpetas y usuarios, y compruebe que elusuario tiene suficientes permisos.

CGC0023ECAM-AAA-0048 No se puede recuperar el CAMID para el objeto %1.

Explicación

El usuario se ha autenticado correctamente, pero el CAMID del objeto no se haencontrado. El CAMID es una representación interna del objeto; el proveedor deautenticación crea uno para cada objeto que se recupera mediante el proveedorexterno. El CAMID de los objetos en la identidad de usuario se compara con lospermisos que se han asignado al objeto. Si los permisos coinciden, los privilegiosse otorgan o se deniegan.


Consulte en el proveedor de autenticación la información solicitada. Por ejemplo,compruebe si el usuario de enlace tiene acceso suficiente para examinar eldirectorio completo, o que el DN base se configura en el nivel correcto.

CGC0024ERQP-DEF-0182 Las consultas de la operación de conjunto no son compatibles.

Explicación

Esto sucede cuando los resultados de dos consultas se unen mediante un comandoUNION y sus tipos son incompatibles. Puesto que el comando UNION combinalos resultados de dos consultas, las consultas de origen se comparan columna acolumna para generar un solo resultado. Si los tipos de datos en las columnas nocoinciden, el resultado fusionado no se puede crear. Por ejemplo, si la primeraconsulta contiene datos de "Fecha" en la primera columna y la segunda consultacontiene datos de "Caracteres" en la primera columna, no hay forma de fusionarlas.No hay ningún modo de conservar los tipos de datos de carácter y de fecha en laprimera columna del resultado.


Examine las consultas en el informe que han causado el error y asegúrese de quelas consultas son adecuadas para su unión.

CGC0025ECAM-AAA-0022 No se puede cargar el proveedor %1.


Explicación

El componente de autenticación no encuentra un archivo de biblioteca quenecesita.


Compruebe que el archivo de biblioteca compartida se encuentra en el directorioubicación_instalación/bin y que la cuenta de usuario que realiza la instalaciónpertenece a un grupo que tiene los permisos adecuados para cargar el archivo. Si elarchivo de biblioteca está en una ubicación fuera de ubicación_instalación/bin,asegúrese de que la ruta existe en la variable de entorno LIBPATH.

CGC0026ECAM-AAA-0145 No hay un espacio de nombres configurado correctamente para laautenticación.

Explicación

El acceso anónimo está inhabilitado. Sin embargo, un proveedor de autenticaciónno está configurado o hay errores en la configuración. El producto no se puedeejecutar sin un proveedor de autenticación cuando el acceso anónimo estáinhabilitado.


Asegúrese de que hay un espacio de nombres configurado para el proveedor deautenticación en la herramienta de configuración. Compruebe la conexión parasaber si hay errores de sintaxis u de otro tipo.

CGC0027ECM-SYS-5173 Error de Content Manager al procesar una transacción de la base dedatos por un bloqueo irreversible de la base de datos.

Explicación

Content Manager no puede acceder a una de las tablas de la base de datos delalmacén de contenido porque otra transacción ha bloqueado la misma tabla. Estopuede suceder cuando otro proceso de Content Manager o un programa externoestá accediendo a la base de datos del almacén de contenido.


Compruebe si hay scripts en ejecución, como puedan ser scripts de limpieza deContent Manager o scripts de IBM Cognos Software Development Kit, lo quepuede dar como resultado un gran volumen de actualizaciones en el almacén decontenido. Consulte con el administrador de base de datos qué otros programaspodrían estar actualizando la base de datos.

CGC0028ECM-CFG-5051 Content Manager no ha podido inicializar el subsistema de memoriacaché.


Explicación

Content Manager mantiene una memoria caché para los objetos de IBM Cognos, yesa memoria caché no se ha inicializado. El producto no se puede ejecutar.


Si utiliza una base de datos del almacén de contenido que requiere los archivos decontrolador JDBC, compruebe que los archivos de controlador y los archivos delicencia necesarios se copian en la ubicación de instalación de IBM Cognos(directorio webapps/p2pd/web-inf/lib). Asegúrese de que la base de datos delalmacén de contenido está configurada y disponible.

CGC0029EDPR-ERR-2074 indica que el servidor de informes con pid %1 no responde.

Explicación

El servidor de informes no responde cuando una conexión con él se cierraprematuramente y provoca que se apague.


Compruebe el estado del servicio de informes y los procesos deBIBusTKServerMain en la interfaz de administración del sistema del producto paraobtener información adicional sobre la condición de error.

CGC0030ECM-SYS-5149 Content Manager no ha podido procesar la solicitud. Se haproducido un error de datos en el subsistema de base de datos del almacén decontenido.

Explicación

Los datos de Content Manager se almacenan en diferentes campos en tablas debase de datos del almacén de contenido. Cada campo tiene una longitud máxima.Se ha intentado leer o escribir en un campo con datos, pero la longitud de datos esdemasiado grande. El tipo de datos también puede variar. El error puedeproducirse al ejecutar un informe o al importar un despliegue.


Intente determinar el informe o la acción que ha producido el error consultandolos archivos de registro del directorio ./logs.

CGC0031EDPR-ERR-2072 indica un error en la solicitud. La solicitud estaba dirigida a unservidor inaccesible.

Explicación

Puede que los valores del asignador no coincidan o no sean compatibles con elresto de los componentes de la instalación.



Asegúrese de que todos los componentes comparten la misma versión y nivel demantenimiento. Compruebe también que los valores de CAF (Cognos ApplicationFirewall) son iguales para todos los componentes instalados. Por motivos deseguridad, Cognos Application Firewall debe estar habilitado en IBM CognosConfiguration para todos los componentes de servidor.

CGC0033ECM-SYS-5195 indica que Content Manager no puede configurar la base de datosdel almacén de contenido. Revise la configuración de la base de datos del almacénde contenido en IBM Cognos Configuration.

Explicación

El producto no puede acceder a la base de datos para configurarla de modo que seutilice como almacén de contenido.


Revise y pruebe la configuración de la base de datos del almacén de contenido enla herramienta de configuración para asegurarse de que los valores son válidos.Verifique que la cuenta utilizada para acceder al almacén de contenido aún esválida; para ello, compruebe el estado de los permisos de la cuenta y la contraseña.

CGC0034ECM-CFG-5023 Content Manager no ha podido inicializar el almacén de contenidocon el archivo de inicialización %1.

Explicación

El script de SQL que está causando el error es responsable de crear la base dedatos del almacén de contenido por primera vez o para actualizar la base de datosdel almacén de contenido existente. El error se produce porque el script no sepuede ejecutar.


Revise la configuración de la base de datos del almacén de contenido en IBMCognos Configuration para asegurarse de que los valores sean correctos. Verifiqueque la cuenta utilizada para acceder al almacén de contenido aún es válida; paraello, compruebe el estado de los permisos de la cuenta y la contraseña. Asegúresede que la cuenta que utiliza Content Manager tiene permisos suficientes para crearcontenidos de archivo en la base de datos, y para conectarse a ellos e inicializarlos.

CGC0035EDPR-ERR-2068 indica un error en la solicitud de administración. No se puedeestablecer conexión con el asignador.

Explicación

Puede que el asignador esté fuera de línea.



Compruebe que el asignador está disponible en la red; para ello, copie el URL delasignador externo de la herramienta de configuración en un navegador web yrevise los resultados. Compruebe que el asignador está disponible en la red en lainterfaz de administración del sistema del producto. Si el asignador está enejecución pero hay un problema de conectividad, compruebe el estado del puertodel asignador mediante netstat u otras herramientas de diagnóstico de red.

CGC0036ECCL-BIT-0006 El mensaje HTTP es más corto de lo esperado.

Explicación

En un sistema con mucha carga, algunas conexiones pueden terminar antes de queIBM Cognos Business Intelligence acabe de procesar una solicitud. Cuando laconexión se cierra antes de que se procese la solicitud, la solicitud se pierde y elusuario debe volver a enviarla.


Si utiliza WebSphere Application Server y desea reducir la frecuencia de este error,aumente el parámetro Tiempo de espera persistente para las cadenas detransporte del contenedor web en la consola administrativa de WebSphere.Aumente el tiempo en intervalos de 10 o 15 segundos hasta que el error no seproduzca nunca o de forma muy esporádica.

CGC0037EDPR-BUS-1500 indica que el %1 cuyo pid es %2 se ha iniciado con el errorestándar %3

Explicación

%1 representa el nombre del proceso y %2 representa el ID de proceso (PID).System Management Facility (SMF) recopila los datos de utilización de recursos delsistema (IFAUSAGE) correspondientes a una aplicación. Cuando el producto IBMCognos inicia un nuevo proceso, por ejemplo BiBusTKServerMain, el proceso seregistra a sí mismo para habilitar el seguimiento de la utilización. Si el registrofalla, se visualiza un mensaje.


La acción necesaria depende del código de error que se indique.

Los códigos de error 8, 12 o 20 representan un error interno y deben notificarse aIBM Cognos.

El código de error 16 indica que IFAUSAGE no está habilitado en este sistema.Puede optar por no utilizar IFAUSAGE; en caso contrario, debe habilitarlo en elsistema.

El código de error 4 puede aparecer bajo una serie de condiciones de error.Póngase en contacto con el administrador de z/OS para asegurarse de que lainstalación está configurada para recopilar registros de tipo 89. Si está configurada,el error puede deberse a un error interno y debe notificarse a IBM Cognos.


Problemas al iniciar el productoPuede que encuentre problemas al intentar iniciar los servicios o al abrir el portalde IBM Cognos por la primera vez.

En la tabla siguiente aparecen algunos de los síntomas más habituales y sussoluciones.

Síntomas Solución

No se visualiza la pantalla de inicio delportal de IBM Cognos BI cuando inicia IBMCognos BI.

Compruebe la configuración del servidorweb.

El servicio se inicia, pero no se crean tablasen la base de datos del almacén decontenido.

Compruebe la configuración del almacén decontenido.

El servicio no se inicia. Después de iniciar el servicio, espere unosmomentos antes de enviar una solicitud.

El servidor de aplicaciones no se inicia. Compruebe los permisos de archivo y losnombres de directorio de la ubicación deinstalación del servidor de aplicaciones.

El proveedor de autenticación no se inicia. Algunos proveedores de autenticaciónnecesitan que haya bibliotecas externas alentorno de IBM Cognos disponibles. Si estasbibliotecas no están disponibles en el sistemaz/OS, el proveedor de autenticación no sepuede inicializar.

Asegúrese de que utiliza otro software que esté soportado por los componentes deIBM Cognos.

Establecimiento de las variables de entorno de JDBC para unalmacén de contenido DB2

IBM Cognos Business Intelligence for z/OS utiliza la conectividad JDBC paracomunicarse con el almacén de contenido. Debe configurar las variables de entornoadecuadas para habilitar las clases utilizadas por el controlador JDBC.


Para no tener que especificar las variables de entorno cada vez que inicie la sesión,puede establecerlas en el archivo .profile del usuario de la instalación de cognos.

En los ejemplos siguientes, se utiliza DB2_BASE. El valor de DB2_BASE es el directoriode nivel más alto en el conjunto de directorios HFS que contienen código de DB2para z/OS. Por ejemplo: DB2_BASE=/usr/lpp/db2/db2910_base El valorpredeterminado es /usr/lpp/db2910_base.

Procedimiento1. Inicie la sesión como el usuario de instalación de Cognos y utilice el ejemplo

siguiente para añadir entradas en el script .profile:


#-Set JDBCHOME to HFS directory for DB2 JDBC driverexport JDBCHOME=�/usr/lpp/db2910_jdbc�##-Classpath for DB2 JDBC#export JDBCCLASSES=${JDBCHOME)/classesexport CLASSPATH=$CLASSPATH:${JDBCCLASSES}/db2jcc_javax.jarexport CLASSPATH=$CLASSPATH:${JDBCCLASSES}/db2jcc4.jarexport CLASSPATH=$CLASSPATH:${JDBCCLASSES}/db2jcc_license_cisuz.jarexport CLASSPATH=$CLASSPATH:${JDBCCLASSES}/sqlj4.zip##-Add DB2 JDBC to Path#export PATH=${JDBCHOME}/bin:${PATH}##-Add DB2 JDBC to Libpath#export LIBPATH=${JDBCHOME}/lib:${LIBPATH}##-Add DB2 JDBC to Steplib#export STEPLIB=SYS1.DB1I.SDSNLOAD:SYS1.DB1I.TESTLIB:SYS1.DB1I.SDSNLOD2:SYS1.DB1I.SDSNEXIT

2. Establezca la variable de entorno JDBCHOME de modo que señale a laubicación del controlador JDBC que podría estar ya instalado con DB2 en elsistema.La ubicación de la instalación suele estar dentro del directorio HFS, como, porejemplo, /usr/lpp/db2910_jdbc. Por ejemplo, para DB2 Versión 9.1, elcontrolador JDBC está en la ubicación siguiente.export JDBCHOME=/usr/lpp/db2910_jdbc

Para DB2 Versión 8.1, el controlador JDBC está en la ubicación siguiente.export JDBCHOME=/usr/lpp/db2/db2810/jcc

3. Establezca la variable de entorno JDBCCLASSES de modo que señale a laubicación de los archivos necesarios para el controlador universal JDBC.Se necesitan los siguientes archivos:v db2jcc.jar

v db2jcc_license_cisuz.jar

v db2jcc_javax.jar

v sqlj.zip

El comando siguiente establece la variable de entorno JDBCCLASSES de modoque señale al directorio ${JDBCHOME)/classes.export JDBCCLASSES=${JDBCHOME)/classes

4. Modifique la variable CLASSPATH para asegurarse de que el compilador Javay la JVM saben dónde buscar los archivos de clase Java para el controladorJDBC.export CLASSPATH=$CLASSPATH:${JDBCCLASSES}/db2jcc_javax.jarexport CLASSPATH=$CLASSPATH:${JDBCCLASSES}/db2jcc4.jarexport CLASSPATH=$CLASSPATH:${JDBCCLASSES}/db2jcc_license_cisuz.jarexport CLASSPATH=$CLASSPATH:${JDBCCLASSES}/sqlj4.zip

5. Añada los controladores JDBC para DB2 a la variable PATH.export PATH=${JDBCHOME}/bin:${PATH}

6. Modifique la variable LIBPATH a fin de que incluya las bibliotecas que elcontrolador JDBC necesita.Por ejemplo:export LIBPATH=${JDBCHOME}/lib:${LIBPATH}


El servicio de IBM Cognos BI no se inicia o falla después deiniciarse

Inicia el servicio de IBM Cognos BI, pero los servicios no se inician correctamente ose inician muy lentamente.


El sistema falla poco después de que los servicios se inicien. Mientras los serviciosse están iniciando, Java utiliza el 100% del tiempo de la CPU. Puede que tambiénreciba varias veces mensajes de error como los siguientes:v DPR-DPR-1035 El asignador ha detectado un error.v CAM-CRP-1157 No es posible sincronizar el

almacén de claves simétricas comunes local con Content Manager.

Si utiliza una base de datos DB2 para el almacén de contenido, asegúrese de que laversión de la base de datos y la versión de Java sean compatibles.

Para ver una lista actualizada de los entornos soportados por los productos de IBMCognos, como sistemas operativos, parches, navegadores, servidores web,servidores de directorios, servidores de bases de datos y servidores de aplicaciones,visite el sitio web del centro del cliente de IBM Cognos (http://www.ibm.com/software/data/cognos/customercenter/).

No se ha podido iniciar el servicio de IBM Cognos porqueotro proceso está utilizando el puerto

Es posible que no pueda iniciar el servicio o proceso de IBM Cognos si otroproceso está utilizando uno de los puertos predeterminados.


Cuando cambie el puerto utilizado por el asignador local, debe cambiar el valor delas propiedades de URI de asignador. Dado que el cambio afecta a todos los URIbasados en el asignador local, debe cambiar los URI de todos los componenteslocales. De forma predeterminada, los componentes locales contienen localhost enel URI.

Por ejemplo, si instala todos los componentes en una ubicación y desea cambiar elpuerto del asignador, debe sustituir 9300 en todos los URI de asignador y ContentManager por el nuevo número de puerto.

Procedimiento1. Inicie IBM Cognos Configuration.2. En el panel Explorador, pulse el grupo o componente que corresponda:

Tabla 71. Valor de puerto de configuración y navegación al valor en IBM CognosConfiguration

Valor de puerto (URI) Navegación

URI de asignador Entorno

URI de Content Manager Entorno

servidor de registro local Entorno > Registro

Número de puerto de apagado de Tomcat Entorno > Servicios de IBM Cognos > IBMCognos




Tabla 71. Valor de puerto de configuración y navegación al valor en IBM CognosConfiguration (continuación)

Valor de puerto (URI) Navegación

Portal Services Entorno > Portal Services

3. En el panel Propiedades, pulse el cuadro Valor situado junto a la propiedadque desea cambiar y cambie el valor actual por el valor nuevo.Asegúrese de que cambia los puertos en todos los URI que contienenlocalhost:puerto.

4. Pulse Archivo > Guardar.5. Pulse Acciones > Iniciar.

Error de Content Manager al iniciar los servicios de IBMCognos

Después de iniciar IBM Cognos BI, no se inicia ningún proceso BIBUSTKSERVMA.Hay una lista de errores en los archivos pogo******.log y cogserver.log. Losusuarios reciben errores en el navegador web al conectarse al portal de IBMCognos.

En el archivo pogo******.log aparece un error relacionado con Content Manager.

En el archivo cogserver.log aparece el error siguiente:El intento de registrar el asignador en Content Manager ha fallado.Se intentará periódicamente.

Aparece el siguiente mensaje de error en el navegador:DPR-ERR-2058 El asignador no puede procesar la solicitud en este momento.El asignador aúnse está inicializando.

SoapSocketException: Conexión rechazada.

IBM Cognos Configuration utiliza un ID de usuario para enlazar con la base dedatos LDAP. Si este ID de usuario se mueve a otro grupo, IBM CognosConfiguration no podrá localizarlo.

Para corregir el problema, mueva el ID de usuario al grupo original.

Aparece el error DPR-ERR-2014 en el archivo de registro de lainstalación de Content Manager

El archivo cogserver.log puede mostrar un error DPR-ERR-2014 si el servicio degestión de eventos está inhabilitado.

Si Content Manager está instalado en una ubicación aparte y el servicio de gestiónde eventos en la instalación de Content Manager está inhabilitado, puede aparecerel siguiente mensaje de error en el archivo cogserver.log:DPR-ERR-2014 No se puede realizar el equilibrio de carga de la solicitud porqueningún nodo del clúster está disponibleo no hay nodos configurados para el servicio:eventManagementService

Para corregir el problema, utilice IBM Cognos Configuration para establecer lapropiedad de gestión de servicios de eventos habilitada en False en la instalaciónde Content Manager.


IBM Cognos Report Studio no se iniciaPuede que Cognos Report Studio no se inicie si utiliza software de bloqueo deventanas emergentes en el sistema.

Cuando inicie Cognos Report Studio, este se abre en una ventana de navegadornueva. Además, se abre una ventana de navegador nueva cuando se ejecuta uninforme y cuando se detecta un error.

Para corregir el problema, inhabilite el software de bloqueo de ventanasemergentes cuando trabaje con Report Studio.

Aparece el error DPR-ERR-2022 en el navegador web al abrirla página del portal de IBM Cognos

Después de iniciar los servicios en IBM Cognos Configuration y de intentar abrir elportal, aparece un mensaje de error.

El siguiente mensaje de error aparece cuando se abre el portal de IBM Cognosdemasiado pronto, o si hay errores en el archivo system.xml.DPR-ERR-2022 No se ha generado ninguna respuesta.Esto puede deberse a que la configuración es incorrecta, a que la instalaciónes defectuosa, o a que el asignador no ha terminado de inicializarse.

Para evitar este problema, después de iniciar los servicios en IBM CognosConfiguration y de que la herramienta de configuración muestre que los serviciosse están ejecutando, espere unos minutos para que se inicien todos los serviciosantes de abrir el portal.

El archivo system.xml puede haberse editado para cambiar las opciones deconfiguración personalizada; sustituya el archivo system.xml en el directorioubicación_c10/templates/ps/portal por el original o por la copia de seguridad, outilice un editor de XML para corregir el error.

Problemas al configurar el productoDespués de instalar los componentes de IBM Cognos, puede experimentarproblemas al guardar los cambios en IBM Cognos Configuration.

Asegúrese de configurar e iniciar los servicios en la instalación de ContentManager antes de configurar e iniciar los servicios en otras ubicaciones. Debetambién reiniciar los servicios de IBM Cognos después de realizar los cambios deconfiguración.

Error al intentar cifrar información al guardar la configuraciónAl guardar la configuración utilizando la herramienta de configuración, podría verun mensaje de error que indica que la información criptográfica no se puede cifrar.

Si se produce un error al solicitar un certificado de la entidad emisora decertificados, puede que vea el mensaje de error siguiente.La información criptográfica no se puede cifrar.¿Desea guardar la configuración como texto sin formato?

Para poder cifrar los valores de configuración, Content Manager debe estarconfigurado y en ejecución. Asegúrese de que ha copiado los archivos .jaradecuados en la ubicación de instalación de Java Runtime Environment. Asegúrese


también de que su entorno de Java está configurado correctamente, los URI soncorrectos y se ha configurado la misma contraseña de la entidad emisora decertificados para todas las instalaciones de Content Manager.

Si el entorno de Java no está configurado correctamente, puede que vea unmensaje de error similar al siguiente:java.lang.NoClassDefFoundError: javax/net/ServerSocketFactory.

Asegúrese de que la variable de entorno JAVA_HOME esté configuradacorrectamente y de que se hayan instalado los proveedores de seguridadadecuados.

El despliegue de aplicaciones de IBM Cognos BI en IBMWebSphere Application Server falla

Si el archivo de aplicación de IBM Cognos Business Intelligence que estáintentando desplegar en IBM WebSphere Application Server es demasiado grande,el despliegue podría fallar con cualquiera de los siguientes errores:Tiempo de espera del navegador excedido en la consola de administración.Error interno HTTP 500.Vuelva a la página de selección de archivos de aplicación.

Para solucionar este problema, si está utilizando el Asistente de creación deaplicaciones, desmarque la casilla de verificación Incluir archivos estáticos de lacarpeta webcontent cuando seleccione la aplicación que desea crear. De este modose reducirá el tamaño del archivo de aplicación. Si se necesita contenido estático,puede copiarlo manualmente en la ubicación de la aplicación desplegada despuésde haber desplegado correctamente IBM Cognos BI en el servidor de aplicaciones.

Problemas al crear una conexión ODBC con un origen de datos DB2en el sistema z/OS

Puede que encuentre problemas, como, por ejemplo errores de conexión en IBMCognos Administration, al configurar una conexión con orígenes de datos DB2debido a los valores de codificación de los archivos.

Las conexiones ODBC necesitan un archivo ini EBCDIC. El contenido del archivoodbcini debe ser EBCDIC, y los usuarios deben saber que el contenido es EBCDIC.

Asegúrese de que los parámetros siguientes están establecidos:v El archivo de inicialización de ODBC de DB2, odbcini, que se lee en el tiempo

de ejecución de aplicación, está codificado como EBCDIC.v La opción chtag -t está desactivada para asegurarse de que el archivo no es un

candidato a la conversión automática cuando está habilitada la conversiónautomática de conjuntos de códigos.

En el siguiente ejemplo se muestra que el archivo odbcini utiliza la codificación dearchivos EBCDIC (IBM-1047) y que no se produce la conversión automática(T=off).chtag -c IBM-1047 odbcinils -al -T odbcinim IBM-1047 T=off -rw-rw-r--


El parámetro de subsistema DB2 para z/OS IDLE THREAD TIMEOUT(IDTHTOIN) hace que se agote el tiempo de espera de las conexionesdel servidor de informes

En el sistema z/OS, las cargas de trabajo que tienen subprocesos de larga ejecuciónpueden agotar el tiempo de espera cuando IDLE THREAD TIMEOUT (IDTHTOIN)se establece en el valor predeterminado de 120. Esto puede ser más evidentecuando se reutiliza un subproceso.

Si hay largos periodos de inactividad en las conexiones que contienen recursos debase de datos, y si el tiempo de espera se ha establecido en un valor muy bajo, elservidor DB2 cancela la conexión que IBM Cognos necesita.

Para evitar este problema, puede aumentar el valor del parámetro de subsistemaDB2 IDLE THREAD TIMEOUT (IDTHTOIN), o puede restablecer el valor a 0.

Los informes fallan con errores de inicio de sesión y UDA-SQL-0114,UDA-SQL-0107, RQP-DEF-0177

Si las instancias de WebSphere Application Server no se cierran correctamente, lasregiones sirviente pueden continuar con algunos trabajos con pasos huérfanos, loque provocaría que los subprocesos de conexión de DB2 se agotaran. Los informespueden fallar de forma intermitente o de forma constante.

Para resolver este problema, asegúrese de que cierra correctamente WebSphereApplication Server en el sistema z/OS cuando el comando stop falle en UNIXSystem Services.


Avisos

Esta información se ha desarrollado para productos y servicios que se ofrecen entodo el mundo.

Puede que IBM no ofrezca en algunos países los productos, servicios ocaracterísticas que se explican en este documento. Póngase en contacto con elrepresentante local de IBM para obtener información acerca de los productos yservicios que actualmente están disponibles en su zona. Cualquier referencia hechaa un producto, programa o servicio de IBM no implica ni pretende indicar que sólopueda utilizarse ese producto, programa o servicio de IBM. En su lugar, podráutilizarse cualquier producto, programa o servicio con características equivalentesque no infrinja ningún derecho de propiedad intelectual de IBM. Sin embargo, seráresponsabilidad del usuario evaluar y verificar el funcionamiento de cualquierprograma, producto o servicio que no sea 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 posesió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 tiene aplicación en el Reino Unido ni en ningún otro paísen el que tales provisiones sean incoherentes con la legislación local:INTERNATIONAL BUSINESS MACHINES CORPORATION PROPORCIONAESTA PUBLICACIÓN "TAL CUAL", SIN GARANTÍAS DE NINGÚN TIPO, YASEAN EXPRESAS O IMPLÍCITAS, INCLUIDAS, PERO SIN LIMITARSE A, LASGARANTÍAS IMPLÍCITAS DE NO INFRACCIÓN, COMERCIALIZACIÓN OIDONEIDAD PARA UNA FINALIDAD DETERMINADA. En algunos estados noestá 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 podría realizar


mejoras y/o cambios en el producto o productos y/o programa o programas quese describen en esta publicación en cualquier momento y sin previo aviso.

Cualquier referencia hecha en esta información a sitios web que no son de IBMsólo se proporciona para su comodidad y bajo ninguna circunstancia ha deinterpretarse que IBM representa o se hace responsable del contenido de esos sitiosweb. Los materiales de esos sitios web no forman parte de los materiales de esteproducto de IBM y la utilización de esos sitios web será responsabilidad delusuario.

IBM podría utilizar o distribuir la información que se le envía de la forma queconsidere más oportuna sin incurrir por ello en ninguna obligación con elremitente de la información.

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á

Esta información podría estar disponible, de acuerdo con los términos ycondiciones aplicables, incluyendo en algunos casos el pago de una tarifa.

El programa bajo licencia que se describe en este documento y todo el materialbajo licencia disponible para éste los proporciona IBM en función de lo dispuestoen el IBM Customer Agreement, el Acuerdo Internacional de Licencia de Programade IBM o cualquier otro acuerdo equivalente celebrado entre ambas partes.

Los datos relacionados con el rendimiento que pudiera contener este documento sehan determinado en un entorno controlado. Por lo tanto, los resultados obtenidosen otros entornos operativos podrían variar significativamente. Puede que algunasmediciones se hayan obtenido en sistemas de desarrollo y no existe ningunagarantía que permita afirmar que puedan obtenerse las mismas mediciones ensistemas de disponibilidad general. Es más, puede que algunas mediciones seanestimaciones obtenidas por extrapolación. Los resultados reales podrían variar. Losusuarios de este documento deben verificar los datos que se aplican a su entornoespecífico.

La información relacionada con productos que no son de IBM se ha obtenido delos proveedores de esos productos, los anuncios que han publicado u otras fuentesde disponibilidad pública. 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 ilustrarlas de la forma máscompleta 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.

Puede que si visualiza esta información en copia software, las fotografías eilustraciones a color no aparezcan.

Marcas registradas

IBM, el logotipo de IBM e ibm.com son marcas registradas de InternationalBusiness Machines Corp., registradas en muchas jurisdicciones de todo el mundo.Otros nombres de productos y servicios pueden ser marcas registradas de IBM ode otras compañías. Hay disponible una lista actual de marcas registradas de IBMen la web en “ Información de copyright y marcas registradas ” enwww.ibm.com/legal/copytrade.shtml.

Los términos siguientes son marcas registradas de otras empresas: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 Estados Unidos y/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 o sus filiales.

Avisos 239

http://www.ibm.com/legal/copytrade.shtml

Índice

Caracteres Especiales_BPXK_AUTOCVT

problemas de conexión de origen de datos 235-displayLog

descripción de nueva característica de la versión 10.2 4

Aactualizar 21alias web

cambiar para la versión 10.2 6almacén de contenido

Cognos Content Database 29configurar Cognos Content Database 96configurar una conexión a base de datos DB2 80, 93, 102configurar una conexión a Cognos Content Database 103controladores JDBC 66crear base de datos DB2 61crear espacios de tabla 62suprimir tablas de la base de datos 217tipos de bases de datos 60

Apache TomcatVéase Tomcat

archivado de contenidodescripción de nueva característica de la versión 10.2 5visión general de configuración 156

archivo .profile 37archivo .registrar

WebSphere Application Server 86archivo .tcshrc 36archivo coglocale.xml 73archivo cogstartup.xml 73archivo de respuestas

modificar 50modificar para IBM Cognos Mobile 54

archivo httpd.conf 91archivos

crear una ubicación de archivo para un repositorio desistema de archivos 156

archivos de respuestascontenido 49instalaciones silenciosas 51, 55

archivos EARcrear mediante el Asistente de creación de aplicaciones 78

archivos JAR (Java Archive)actualizar 59

archivos temporalescifrar ubicaciones 145

archivos WAR 78arreglos

archivos de instalación del actualizador 47Shop zSeries 213

arreglos temporales de programaVéase PTF

asignadoresanular registro 89

atajos de teclado 201IBM Cognos Configuration 202programa de instalación de IBM Cognos 201

autenticaciónhabilitar 169inhabilitar inicio de sesión anónimo 169utilizar espacios de nombres 169

Bbase de datos de Human Task and Annotation

espacios de tabla en DB2 en z/OS 185base de datos de notificaciones

crear espacios de tabla 62espacios de tabla para DB2 para z/OS 129suprimir tablas 217

base de datos de registroconfigurar conexiones 155crear para mensajes 152suprimir tablas 217tablas creadas para DB2 en z/OS 153

bases de conocimientos 213bases de datos

crear para mensajes de registro 152IBM Cognos Mobile 68suprimir tablas 217

bibliotecas de destino 28bibliotecas de distribución 28buscar

configurar varios servicios de índice 108funciones de indexado 5

CCAF

Véase Cognos Application Firewallcambiar

plantilla de configuración 99características de accesibilidad 201características modificadas

versión 10.2.0 6características nuevas

instalación y configuración 1versión 10.2.0 1

CBPDO 46centro del cliente de Cognos 213CGC

códigos de mensaje 218CGC0001I

DPR-SYS-6000 219CGC0002I

mensaje DPR-SYS-6001 219CGC0003E

error CAM-AAA-0044 219CGC0004E

error CM-SYS-5003 219CGC0005I

mensaje CM-SYS-5090 220CGC0006I

mensaje CM-SYS-5094 220CGC0007I

mensaje DPR-DPR-1002 220


CGC0008Imensaje CM-SYS-5159 220

CGC0009Imensaje CM-SYS-5160 221

CGC0010Eerror RSVP-SRV-0040 221

CGC0011Eerror DPR-ERR-2077 221

CGC0012Eerror RSV-DST-0014 222

CGC0013Eerror CNC-DS-0031 222

CGC0014Eerror CM-REQ-4158 222

CGC0015Eerror CM-REQ-4098 223

CGC0016Eerror UDA-SQL-0031 223error UDA-SQL-0107 223

CGC0018Eerror QFS-ERR-0139 223

CGC0019Eerror RQP-DEF-0354 224


CGC0021Eerror UDA-SQL-0114 224

CGC0022Eerror CAM-AAA-0134 225





CGC0027Eerror CM-SYS-5173 226

CGC0028Eerror CM-CFG-5051 227





CGC0034Eerror CM-CFG-5023 228


CGC0036Eerror CCL-BIT-0006 229

CGC0037Eerror DPR-BUS-1500 229

cifradoerrores de configuración 234

cifrarubicaciones de archivos temporales 145

claves criptográficasgenerar para otras entidades emisoras de certificados 190

cliente Cognos Transformerconfigurar 118configurar preferencias de ejemplo para Windows

Vista 124

cliente Cognos Transformer (continuación)crear una ubicación de instalación de red 125desplegar para modeladores 127exportar datos de configuración 126

cliente TransformerVéase cliente Cognos Transformer

cogconfig.shopciones de línea de comandos 203

Cognos Application Firewall 143configurar 144

Cognos Connectioninstalar Cognos Insight desde 115

Cognos Content Databasealmacén de contenido 60cambiar nombre de usuario y contraseña

predeterminados 138configurar 96configurar una conexión a almacén de contenido 103crear nombre de usuario y contraseña 138crear una instancia 137utilizar como almacén de contenido 29

Cognos Framework Managerconfigurar 113configurar en Windows Vista 123instalar 112instalar documentación traducida 120instalar IBM Cognos Software Development Kit 119probar instalación 115revisar requisitos de hardware y software 111valores predeterminados 113

Cognos Insightinstalación suministrada 115instalar desde Cognos BI 115

Cognos Transformerinstalar documentación traducida 120instalar en Windows 116probar instalación del cliente 119revisar requisitos de hardware y software 111valores predeterminados 117

componentesfunciones obligatorias y opcionales 21

componentes de nivel de aplicaciónconfigurar en instalaciones distribuidas 106servidor de informes

habilitar versión de 64 bits 106servidor de informes de 64 bits

configurar 106componentes de servidor

configurar para ejecutar en WebSphere ApplicationServer 80

configurar propiedades de entorno 92componentes de Windows

desinstalar 121instalar 111instalar documentación traducida 120

conectividad de base de datosconexiones JDBC 69orígenes de datos relacionales para el modo de consulta

dinámica 69conectividad JDBC

establecer variables de entorno 230verificar 67

conectividad ODBCerrores 235

conexiones JDBC 69configuración

cambiar la plantilla 99


configuración (continuación)descripción general 73instalación básica 73proceso 129software X-Window 59supervisar cambios 73valores necesarios 73

configuraciones de aplicaciones de arrendamiento múltipledescripción de nueva característica de la versión 10.2 4descripción general 159habilitar valores de arrendamiento múltiple 162identificar información de arrendatario 161inhabilitar valores de arrendamiento múltiple 164

configurar 203Cognos Content Database 96componentes de servidor de IBM Cognos en WebSphere

Application Server 80entidad emisora de certificados de terceros 191espacio de nombres RACF 180propiedades de entorno para componentes de servidor 92servicio de entidad emisora de certificados 189servicio de IBM Cognos 99

configurar servidores web 91conjuntos de datos

convenciones de nomenclatura 28contenido estático 91Content Manager

configurar como activo 104configurar como en espera 105configurar en varias instalaciones de servidor 102iniciar en instalaciones distribuidas 106modos activo y en espera 102no se puede registrar asignadores 233

Content Manager activo 102configurar 104

Content Manager en espera 102configurar 105

controladores JDBCalmacén de contenido 66

crear mediante el Asistente de creación de aplicaciones 78cuentas de usuario

restringir el acceso al espacio de nombres de Cognos 170usuario y grupo para archivos de instalación 31verificar valores en TSO 32

Custom-Build Product Delivery OptionVéase CBPDO

DDB2

almacén de contenido 60configurar una conexión a almacén de contenido 80, 93,

102crear base de datos de Human Task and Annotation

Services 184crear base de datos del almacén de contenido 61valores iniciales 39

db2jcc.jar 66db2jcc_license_cisuz.jar 66deleteTask 159desinstalar

componentes de Windows 121documentación

información relacionada ixdocumentación en vídeo

YouTube 213DPR-DPR-1035 232

Eejemplos 208

conexiones de origen de datos 208descripción general 205importar 209restaurar archivos de base de datos 205

entidad emisora de certificadosconfigurar 189, 191herramienta de línea de comandos 189

entornos locales de productoscorrelacionar con idioma preferido 165

entornos locales del contenidocorrelacionar con entornos locales del usuario 167

error CAM-AAA-0022 226error CAM-AAA-0044 219error CAM-AAA-0048 225error CAM-AAA-0134 225error CAM-AAA-0145 226error CAM-CRP-1157 232error CCL-BIT-0006 229error CM-CFG-5023 228error CM-CFG-5051 227error CM-REQ-4098 223error CM-REQ-4158 222error CM-SYS-5003 219error CM-SYS-5149 227error CM-SYS-5160 221error CM-SYS-5173 226error CM-SYS-5195 228error CNC-DS-0031 222error DPR-BUS-1500 229error DPR-ERR-2068 228error DPR-ERR-2072 227error DPR-ERR-2074 227error DPR-ERR-2077 221error en informes

errores UDA-SQL-0114 236error QFS-ERR-0139 223error RQP-DEF-0177 224error RQP-DEF-0182 225error RQP-DEF-0354 224error RSV-DST-0014 222error UDA-SQL-0031 223error UDA-SQL-0107 223error UDA-SQL-0114 224errores

no se puede cifrar información criptográfica 234espacio de nombres de Cognos

restringir acceso de usuario 170espacio de nombres RACF

configurar 180espacio de spool

rendimiento 87espacios de nombres

autenticación 169configuraciones de pasarela 150configurar para proveedores de autenticación

personalizados 179configurar propiedades de usuario personalizadas para un

servidor LDAP 176habilitar comunicaciones seguras con servidores

LDAP 176ocultar a los usuarios durante el inicio de sesión 180suprimir 182

espacios de tablacrear para la base de datos DB2 Mobile en z/OS 68DB2 en z/OS 185

Índice 243

espacios de tabla (continuación)DB2 para z/OS 129scripts de almacén de contenido 62

espacios de trabajoestilos de informe 188

estilos de análisisen espacios de trabajo 188

estilos de consultaen espacios de trabajo 188

estilos de informeen espacios de trabajo 188

Ffixpacks

aplicar mantenimiento 199FMID

características del producto 45formatos de salida

restringir 159foros y comunidades 214Framework Manager

Véase Cognos Framework Managerfuentes

añadir fuentes nuevas 139cambiar fuentes incluidas en informes PDF 141cambiar fuentes predeterminadas en informes PDF 142especificar ubicación 140representación en informes 139sustituciones y correlaciones 140

Ggestor de carga de trabajo

Véase WLMglifos

cambiar fuentes incluidas en informes PDF 141gráficos de mapa

cambiar ubicación 135grupos de planificación de servicio preventivo

Véase PSP

HHerramienta de Informes de Subcapacidad

habilitar 70hoja de apuntes 9Human Task and Annotation Services

configurar base de datos 187configurar para IBM Cognos Workspace 184crear base de datos DB2 184

IIBM Cognos BI Supplementary Documentation

instalar documentación traducida 120IBM Cognos Business Workspace

requisitos de configuración 183IBM Cognos Configuration

iniciar 60opciones de línea de comandos 203

IBM Cognos Insightdescripción de nueva característica de la versión 10.2.0 2

IBM Cognos Mobilebase de datos 68

IBM Cognos Software Development Kitinstalar con Cognos Framework Manager 119

IBM Cognos Workspacebase de datos de Human Task and Annotation

Services 184configurar acceso 183descripción de nueva característica de la versión 10.2.0 1estilos de informe 188probar 183

IBM HTTP Serverver contenido estático 91

IBM_JAVA_ENABLE_ASCII_FILETAG 59IBM Redbooks 213idiomas

configurar para contenido de informe 166configurar sustituciones 165

IHSVéase IBM HTTP Server

informesconfigurar ubicación de salida 134ejemplos 208

informes PDFcambiar fuentes incluidas 141cambiar fuentes predeterminadas 142

iniciarservicio de IBM Cognos desde IBM Cognos

Configuration 97iniciar Cognos Insight desde Cognos BI 115inicio de sesión anónimo

inhabilitar 169inicio de sesión único

RACF 181servidor LDAP 177

instalaciónprobar componentes de servidor 97

instalación de IBM Cognos Dynamic Query Analyzerdescripción de nueva característica de la versión 10.2.0 3

instalación de IBM Dynamic Cubesdescripción de nueva característica de la versión 10.2.0 3

instalación silenciosa-startupfile ruta/nombrearchivo.xml

descripción de nueva característica de la versión 10.2 4archivo de inicio 4opción para visualizar el estado en la pantalla 4

instalaciones de 31 bitscomponentes 21



instalararchivos de respuestas 51, 55arreglos 199Cognos Cube Designer 115componentes de servidor 45crear grupo y usuario 31descripción general 19sistemas de archivos del producto 47trabajos de ejemplo 46ubicaciones de componentes 21varias instancias de componentes 101

instalar Cognos Insight desde Cognos BO 115instancia de JVM

cambiar 98WebSphere Application Server 84

IPv4 136cambiar por IPv6 136


IPv6 136habilitar al iniciar 137

JJAVA_HOME 59

establecer para WebSphere Application Server 84Java Management Extensions

configurar propiedades JMX para la supervisión remota delas métricas del sistema 196

LLDAP

configurar espacio de nombres 173configurar espacio de nombres para IBM Directory

Server 174configurar propiedades de usuario cliente 176consideraciones para instalaciones distribuidas 171correlaciones 172enlazar usuarios 172habilitar comunicaciones seguras 176propiedad Correlación de identidad externa 172

LIBPATHestablecer para WebSphere Application Server 84

lista de comprobación de instalación 9

Mmantenimiento

arreglos 199memoria

requisitos 26mensaje CM-SYS-5090 220mensaje CM-SYS-5094 220mensaje CM-SYS-5159 220mensaje CM-SYS-5160 221mensaje DPR-DPR-1002 220mensaje DPR-SYS-6000 219mensaje DPR-SYS-6001 219mensajes

Véase también especificar tipo de repositorioarchivos 151bases de datos 151códigos de error 218interpretar 218limitaciones de juegos de caracteres 218servidor de registro remoto 151

mensajes de errorDPR-ERR-2014 233error DPR-ERR-2022 234error DPR-ERR-2058 233no se puede cifrar información criptográfica 234SoapSocketException 233

mensajes de registrorepositorios 150

métricas del sistemaacceder desde fuera de IBM Cognos Administration 7supervisión remota 196

migrarVéase actualizar

modelosejemplos 208

modificación del sistema de funciónVéase FMID

modo de consulta compatiblememoria 26

modo de consulta dinámicadescripción de nueva característica 5memoria 26

montarsistema de archivos de destino 48

Nnotas técnicas

prácticas recomendadas para la búsqueda 212resolución de problemas

notas técnicas 212

Oopciones de inicio 203opciones de línea de comandos 203operación de sustitución

propiedad Correlación de identidad externa 178orígenes de datos

errores de conectividad ODBC 235

Ppaquetes

ejemplos 208paquetes de cifrado 148

clasificar 148parámetros

SYS1.PARMLIB 41pasarela

utilización de la pasarela de 64 bits 91pasarela de 64 bits 91pasarela de Cognos de 64 bits

descripción de nueva característica de la versión 10.2 2pasarela de servidor web

configurar para ejecutar en WebSphere ApplicationServer 77

pasarela de servletconfigurar 83configurar para ejecutar en WebSphere Application

Server 77pasarelas

configurar en instalaciones distribuidas 107configurar para utilizar un espacio de nombres 150

PATHestablecer para WebSphere Application Server 84

periodos de inactividadespecificar 157

personalizaciónsistemas de archivos del producto 47

planificación de la capacidad 23plantilla

cambiar el tamaño de la plantilla 99plantillas LDAP

descripción de nueva característica de la versión 10.2.0 4portal

errores al iniciar 234posteriores a la instalación

tareas 59probar

componente de servidor en sistema z/OS 97IBM Cognos Workspace 183

Índice 245

problemaserrores al cifrar información 234puertos utilizados por otro proceso 232resolución de problemas de instalación 230tiempo de espera del navegador excedido en consola de

administración de WebSphere Application Server 235Program Directory

trabajos de ejemplo 46propiedad Correlación de identidad externa

operación de sustitución 178propiedades

cambiar en la herramienta de configuración 129, 131protocolo de Internet

cambiar versiones 136habilitarIPv6 para Cognos Configuration 137versiones 136

proveedores de autenticaciónocultar a los usuarios durante el inicio de sesión 180suprimir 182

proveedores de autenticación personalizadosconfigurar espacio de nombres 179

PSPaplicar mantenimiento 199

PTFaplicar mantenimiento 199

público ixpuertos

cambiar en la herramienta de configuración 133

RRACF

configurar 180habilitar inicio de sesión único 181

registros de gestión de problemasPMR

Véase registros de gestión de problemasregistrar 212

rendimientoajustar 193espacio de spool 87

repositorio de sistema de archivoscrear una ubicación de archivo 156

requisitos del sistemacomponentes de Windows 111

resolución de problemasarreglos 213centro del cliente de Cognos 213documentación de prácticas recomendables 214foros y comunidades 214herramientas de diagnóstico 213IBM Redbooks 213identificar problemas 211información MustGather 212problemas al iniciar el producto 230puertos utilizados por otro proceso 232soporte de software y entradas RSS 214Support Portal 212tiempo de espera del navegador excedido en consola de

administración de WebSphere Application Server 235Resource Access Control Facility

Véase RACF

Sscripts

para suprimir tablas de bases de datos 217scripts de limpieza de base de datos 217scripts de SQL

para suprimir bases de datos 217SCRT

Véase Herramienta de Informes de Subcapacidadsecuencia de ordenación

almacén de contenido 60Secure Sockets Layer

Véase SSLseguridad

Cognos Application Firewall 143configurar el acceso a IBM Cognos Workspace 183SSL 142valores criptográficos 142

servicio de IBM Cognosconfigurar 99iniciar desde IBM Cognos Configuration 97

servicio que no se inicia 232servicios

iniciar y detener 101servicios criptográficos

actualizar archivos JAR 59servicios de índice

configurar varias instancias 108servidor de correo

configurar propiedades de conexión 82, 95servidor de informes

habilitar versión de 64 bits 92servidor de informes de 64 bits

configurar 92servidores de registro 151servidores web

habilitar SSL 149ver contenido estático 91

shellsz/OS UNIX System Services 35

sistema operativo de 64 bitsmemoria 26

sistemas de archivos 47SMF

registrar aplicaciones de IBM Cognos en WebSphereApplication Server 86

SMP/Econjuntos de datos de producto 28instalar componentes de servidor 45

softwareFMID 45

Software Development Kitdocumentación ix

solicitudes de firma de certificadosgenerar 190

solicitudes de servicioPMR 212

soporte de software y entradas RSS 214SSL

clasificar paquetes de cifrado 148conexiones internas y externas 146habilitar en servidores web 149paquetes de cifrado 148

Support Portal 212SYS1.PARMLIB

valores de configuración 41System Management Facility

Véase SMF


System Modification Program ExtendedVéase SMP/E

Ttablas

suprimir de base de datos 217teclas de atajo

IBM Cognos Configuration 202programa de instalación de IBM Cognos 201

tiempo de espera predeterminado de la agrupación deconexiones

conflictos entre IBM Cognos BI y algunos servidores deaplicaciones 78

tiempos de archivadoespecificar 157

tiempos de ejecución de subprocesosespecificar 158

Tomcatdescripción general del despliegue 91

trabajos de ejemplo 46

Uubicación de la instalación

cambiar para la versión 10.2 6umask 31

Vvalores

cambiar en la herramienta de configuración 131valores criptográficos

configurar 143valores de cookies 135

configurar 135

valores de URIcambiar en la herramienta de configuración 133estructura 131

valores globalesrequisitos multiculturales 164

variables de entorno 36, 39controlador JDBC 230establecer 33establecer mediante el archivo .profile de ejemplo 37JAVA_HOME 84LIBPATH 84PATH 84verificar 39verificar para WebSphere Application Server 85

verificar 39conectividad JDBC con la base de datos del almacén de

contenido 67valores de cuenta de usuario 32

WWebSphere Application Server

configurar 87configurar pasarela de servlet 83crear instancia de JVM 84

Windows Vistaconfigurar componentes de modelado 123

WLMvalores 193

Zz/OS

crear espacios de tabla para la base de datos DB2Mobile 68

Índice 247