Sunteți pe pagina 1din 395

IBM Cognos 8 Business Intelligence

PowerPlay
Versin 8.4.1

Gua de instalacin y configuracin

Informacin sobre el producto


Este documento se aplica a IBM Cognos 8 versin 8.4.1 y puede tambin aplicarse a las siguientes releases. Para comprobar las versiones nuevas
de este documento, visite los IBM Cognos Information Centers (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp).

Copyright
Materiales bajo Licencia - Propiedad de IBM
Copyright IBM Corp. 2005, 2009.
US Government Users Restricted Rights El uso, la duplicacin o la revelacin estn restringidos por el Contrato GSA ADP Schedule con IBM
Corp.
IBM, el logotipo de IBM, ibm.com y Cognos son marcas registradas o marcas comerciales registradas de International Business Machines Corp.
en muchas jurisdicciones de todo el mundo. Otros nombres de productos y servicios pueden ser marcas registradas de IBM o de otras empresas.
Hay disponible una lista de marcas registradas de IBM en la web en www.ibm.com/legal/copytrade.shtml.
Adobe, el logotipo de Adobe, PostScript y el logotipo de PostScript son marcas registradas o marcas comerciales registradas de Adobe Systems
Incorporated en los Estados Unidos o en otros pases.
Microsoft, Windows, Windows NT y el logotipo de Windows son marcas registradas de Microsoft Corporation en los Estados Unidos o en otros
pases.
Linux es una marca registrada de Linus Torvalds en los Estados Unidos o en otros pases.
UNIX es una marca registrada de The Open Group en los Estados Unidos o en otros pases.
Java y todas las marcas registradas y logotipos basados en Java son marcas registradas de Sun Microsystems, Inc. en los Estados Unidos o en
otros pases.

ndice
Introduccin

13

Seccin 1: IBM Cognos 8 PowerPlay


Captulo 1: Novedades

17

Gua de funciones nuevas 17


Compatibilidad con idiomas adicionales 17
Compatibilidad con el controlador universal DB2 para bases de datos de almacn de contenido, notificaciones y registro 18
DB2 en z/OS como almacn de contenido, registro o base de datos de notificacin 18
Asistencia para direcciones IPv6 18
Compatibilidad con servidores de aplicaciones de 64 bits 19
Cmo ocultar el espacio de nombre a los usuarios durante el inicio de sesin 19
Funciones modificadas en la versin 8.4 19
Instalacin de documentacin de idiomas suplementarios necesaria para la documentacin
traducida de productos 19
Una conexin predeterminada a un almacn de contenido IBM DB2 sustituye a Microsoft
SQL Server 19
El entorno en tiempo de ejecucin de Java (JRE) de IBM sustituye al entorno en tiempo de
ejecucin de Sun Java 20
Funciones obsoletas de la versin 8.4 20
Compatibilidad con el controlador de tipo 2 DB2 JDBC para las bases de datos de almacn
de contenido, notificaciones y registro en Linux, UNIX y Windows (db2java.zip) 20
Funciones eliminadas en la versin 8.4 20
Interfaz de usuario basada en texto para instalar y desinstalar en UNIX y Linux 20
Compatibilidad de idiomas para el texto de la interfaz de usuario de IBM Cognos 8 y
mensajes movidos desde idiomas suplementarios a la instalacin del servidor de IBM
Cognos 8 20
Captulo 2: Componentes utilizados por IBM Cognos 8 PowerPlay

23

Componentes de servidor 23
Componentes de servidor comunes 23
Componentes de servidor para IBM Cognos 8 PowerPlay 24
Componentes de migracin 25
Componente de cliente 26
Otros componentes 26
Seccin 2: Planificacin de la instalacin
Captulo 3: Opciones de distribucin de IBM Cognos 8

27

Distribucin de componentes de servidor de IBM Cognos 8 PowerPlay 27


Todos los componentes en un equipo 28
Puertas de enlace en distintos equipos 28
Componentes de nivel de aplicacin y Content Managers en distintos equipos 29
Varios productos de IBM Cognos 8 en un mismo equipo 31
Licensed Materials Property of IBM
Copyright IBM Corp. 2005, 2009.

ndice
IBM Cognos 8 PowerPlay con otros productos de IBM Cognos 32
Productos de IBM Cognos Series 7 que pueden migrarse a IBM Cognos 8 PowerPlay 32
Productos de IBM Cognos que interoperan con IBM Cognos 8 PowerPlay 33
Contenido de IBM Cognos Series 7 que se puede volver a crear en IBM Cognos 8 36
Captulo 4: Configuracin del entorno

39

Recomendacin: Revise el documento Lame antes de la instalacin 39


Revisin de entornos compatibles 40
Verificacin de los requisitos del sistema 40
Revisin de la configuracin predeterminada para IBM Cognos 8 41
Directrices para la creacin del almacn de contenido 43
Configuracin recomendada para crear el almacn de contenido en DB2 en Linux, Windows
y UNIX 43
Configuracin recomendada para crear el almacn de contenido en DB2 en z/OS 46
Configuracin recomendada para crear el almacn de contenido en Oracle 47
Configuracin recomendada para crear el almacn de contenido en Microsoft SQL Server 48
Configuracin recomendada para crear el almacn de contenido en Sybase 49
Creacin de espacios de tabla para el almacn de contenido DB2 en z/OS 50
Configuracin de los exploradores Web 51
Configuracin de una cuenta de usuario o de servicio de red para IBM Cognos 8 54
Seccin 3: Instalacin y configuracin
Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay

57

Planificacin de la actualizacin 58
Consulta de la documentacin 60
Recomendacin: evaluar las aplicaciones en el entorno de origen 61
Recomendacin: realizar una actualizacin de prueba 62
Creacin del entorno de prueba 63
Planificacin de la implementacin 64
Creacin de una especificacin de implementacin de exportacin 65
Copia de la especificacin de implementacin en el entorno de prueba 68
Inclusin de objetos de configuracin en la importacin de todo el almacn de contenido
68
Importacin al entorno de prueba 69
Prueba del contenido implementado 70
Recomendacin: probar el contenido actualizado 70
Paso al entorno de produccin 71
Actualizacin a partir de una versin anterior de IBM Cognos 8 PowerPlay 73
Actualizacin a partir de una versin anterior de IBM Cognos 8 PowerPlay 73
Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo

79

Recomendacin: instalar los componentes de servidor en modo interactivo 81


Instalacin de IBM Cognos 8 PowerPlay 81
Actualizacin del entorno Java 85
Opciones de controlador JDBC para usar bases de datos DB2 como almacn de contenido 86
Configuracin de la conectividad de la base de datos para la base de datos del almacn de
contenido 87
Inicio de IBM Cognos Configuration 88

4 PowerPlay

ndice
Configuracin de las propiedades de la conexin a la base de datos en el almacn de contenido 89
Especificacin de una cuenta de servidor de correo 92
Configuracin de las propiedades del entorno 93
Configuracin de un espacio de nombre de IBM Cognos Series 7 en IBM Cognos 8 93
Configuracin del servidor Web 95
Inicio del servicio de IBM Cognos 8 97
Prueba de los componentes del servidor PowerPlay de IBM Cognos 8 98
Prueba de IBM Cognos Connection 99
Prueba de los servicios de migracin 99
Instalacin y configuracin de la migracin en equipos de IBM Cognos Series 7 100
Instalacin de los componentes de migracin de IBM Cognos Series 7 100
Configuracin del servicio de migracin de IBM Cognos Series 7 para migraciones desde
Upfront en instalaciones de IBM Cognos Series 7 distribuidas 101
Inicio del servicio de migracin de IBM Cognos Series 7 102
Desinstalacin de IBM Cognos 8 102
Desinstalacin de IBM Cognos 8 en UNIX o Linux 103
Desinstalacin de IBM Cognos 8 en Windows 104
Desinstalacin de la base de datos de contenido de Cognos 104
Desinstalacin de los componentes de migracin 106
Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8
en una instalacin distribuida 107
Recomendacin: instalar los componentes de servidor en modo interactivo 109
Instalacin y configuracin de equipos de Content Manager 110
Instalacin de los componentes de Content Manager 111
Instalacin de la base de datos de contenido de Cognos en un servidor independiente 114
Actualizacin del entorno Java en el equipo de Content Manager 115
Configuracin de la conectividad de la base de datos para la base de datos del almacn de
contenido 115
Inicio de IBM Cognos Configuration en el equipo de Content Manager 117
Configuracin de las propiedades de la conexin a la base de datos en el almacn de contenido 118
Especificacin de una cuenta de servidor de correo 121
Configuracin de las propiedades de entorno para los equipos de Content Manager 122
Configuracin de un espacio de nombre de IBM Cognos Series 7 en IBM Cognos 8 124
Inicio del servicio IBM Cognos 8 en el equipo de Content Manager 126
Cmo probar Content Manager 127
Instalacin y configuracin de los componentes de nivel de aplicacin en el servidor PowerPlay 127
Instalacin de componentes de nivel de aplicacin en el servidor PowerPlay 128
Actualizacin del entorno Java en el servidor PowerPlay 131
Inicio de IBM Cognos Configuration en el servidor PowerPlay 131
Configuracin de las propiedades de entorno en servidores PowerPlay 132
Inicio del servicio IBM Cognos 8 en los servidores PowerPlay 133
Cmo probar el servicio de migracin de IBM Cognos 8 133
Instalacin y configuracin del componente puerta de enlace 133
Instalacin del componente Puerta de enlace 134
Configuracin del servidor Web 137

Gua de instalacin y configuracin 5

ndice
Actualizacin del entorno Java en el equipo de puerta de enlace 140
Inicio de IBM Cognos Configuration en el equipo de puerta de enlace 140
Configuracin de las propiedades de entorno para los equipos de puerta de enlace 140
Cmo probar el equipo de puerta de enlace 142
Instalacin y configuracin de la migracin en equipos de IBM Cognos Series 7 143
Instalacin de los componentes de migracin de IBM Cognos Series 7 144
Configuracin del servicio de migracin de IBM Cognos Series 7 para migraciones desde
Upfront en instalaciones de IBM Cognos Series 7 distribuidas 145
Inicio del servicio de migracin de IBM Cognos Series 7 146
Desinstalacin de IBM Cognos 8 146
Desinstalacin de IBM Cognos 8 en UNIX o Linux 146
Desinstalacin de IBM Cognos 8 en Windows 147
Desinstalacin de la base de datos de contenido de Cognos 148
Desinstalacin de los componentes de migracin 149
Captulo 8: Instalacin y configuracin de los componentes de cliente y de modelado

151

Instalacin y configuracin de IBM Cognos 8 PowerPlay Client 151


Instalacin de IBM Cognos 8 PowerPlay Client 152
Configuracin de IBM Cognos 8 PowerPlay Client 153
Prueba de la instalacin 154
Desinstalacin de IBM Cognos 8 PowerPlay Client 154
Captulo 9: Instalacin y configuracin de componentes opcionales

157

Ejemplos de PowerPlay 157


Ejemplos de IBM Cognos 8 PowerPlay 157
Instalacin de los ejemplos de IBM Cognos 8 158
Configuracin de ejemplos de IBM Cognos 8 PowerPlay 159
Instalar documentacin de producto traducida 166
Instalacin y configuracin de fuentes de idiomas adicionales 167
Configuracin de la compatibilidad para los caracteres de yen japons y won coreano 168
Seccin 4: Personalizacin de IBM Cognos 8 PowerPlay en su entorno
Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de
autenticacin 171
Deshabilitacin del acceso annimo 172
Restriccin del acceso de usuarios al espacio de nombre de Cognos 173
Configuracin de los componentes de IBM Cognos 8 para utilizar el servidor de Active Directory 174
Configuracin de un espacio de nombre de Active Directory 174
Cmo poner las propiedades de usuario personalizadas del servidor de Active Directory a
disposicin de los componentes de IBM Cognos 8 176
Habilitacin de la comunicacin segura con el servidor de Active Directory 177
Inclusin o exclusin de dominios mediante las propiedades avanzadas 177
Habilitacin del inicio de sesin nico entre el servidor de Active Directory y los componentes de IBM Cognos 8 178
Configuracin de IBM Cognos 8 para utilizar un espacio de nombre de IBM Cognos Series 7 180
Configuracin de un espacio de nombre de IBM Cognos Series 7 180
Habilitacin de la comunicacin segura con el servidor de directorio utilizado por el espacio
de nombre de IBM Cognos Series 7 182

6 PowerPlay

ndice
Habilitacin del inicio de sesin nico entre IBM Cognos Series 7 e IBM Cognos 8. 182
Espacios de nombre de IBM Cognos Series 7 y complemento de inicio de sesin de confianza
de IBM Cognos Series 7 182
Configuracin de IBM Cognos 8 para utilizar un proveedor de autenticacin personalizado 185
Configuracin de un espacio de nombre de autenticacin personalizado 185
Cmo ocultar el espacio de nombre a los usuarios durante el inicio de sesin 186
Configuracin de los componentes de IBM Cognos 8 para utilizar LDAP 186
Configuracin de un espacio de nombre de LDAP 187
Configuracin de un espacio de nombre de LDAP para el servidor de Active Directory 189
Configuracin de un espacio de nombre de LDAP para el servidor de directorio IBM 192
Configuracin de un espacio de nombre de LDAP para Novell Directory Server 194
Configuracin de un espacio de nombre de LDAP para Sun Java System Directory Server 197
Cmo poner las propiedades de usuario personalizadas para LDAP a disposicin de los
componentes de IBM Cognos 8 199
Habilitacin de la comunicacin segura con el servidor LDAP 200
Habilitacin de un inicio de sesin nico entre LDAP y los componentes de IBM Cognos 8 201
Operacin de sustitucin 202
Configuracin de los componentes de IBM Cognos 8 para utilizar eTrust SiteMinder 203
Configuracin de un espacio de nombre de Netegrity SiteMinder 204
Habilitacin de la comunicacin segura en el directorio de usuario de eTrust SiteMinder 206
Habilitacin del inicio de sesin nico entre eTrust SiteMinder e IBM Cognos 8 206
Proteccin del alias de IBM Cognos Web 206
Cmo ocultar el espacio de nombre a los usuarios durante el inicio de sesin 206
Configuracin de los componentes de IBM Cognos 8 para utilizar un espacio de nombre de
NTLM 207
Configuracin de un espacio de nombre de NTLM 207
Habilitacin del inicio de sesin nico entre NTLM y los componentes de IBM Cognos 8 208
Configuracin de IBM Cognos 8 para utilizar SAP 208
Configuracin de un espacio de nombre de SAP 210
Habilitacin del inicio de sesin nico entre SAP e IBM Cognos 8 211
Cmo probar los espacios de nombre 211
Eliminacin de un proveedor de autenticacin 211
Captulo 11: Opciones de configuracin

213

Cambio de los valores de configuracin predeterminados 213


Cambio del usuario y la contrasea predeterminados de la base de datos de contenido de
Cognos 214
Cmo cambiar la base de datos de notificaciones 216
Cambio de un URI 219
Configuracin de valores criptogrficos 221
Configuracin de componentes de IBM Cognos 8 para que utilicen IBM Cognos Application
Firewall 223
Configuracin de las propiedades de los archivos temporales 225
Configuracin de la puerta de enlace para utilizar un espacio de nombre 226
Cmo habilitar y deshabilitar servicios 226
Especificacin de recursos para el servicio IBM Cognos 8 227
Configuracin de las fuentes 228
Consideraciones sobre compatibilidad con chino simplificado 230

Gua de instalacin y configuracin 7

ndice
Actualizacin de las entradas del registro para vinculacin de fuentes de Windows 230
Cambio de la fuente predeterminada para informes PDF 231
Configuracin de las fuentes incrustadas para informes PDF 232
Salida de informe guardada 233
Cambio de los valores de configuracin del servicio de migracin de IBM Cognos Series 7 234
Asignacin de una cuenta de usuario a los servicios de migracin y PowerPlay para la migracin 235
Definicin de una cuenta de inicio de sesin de usuario para el servicio IBM Cognos 8 en varios
equipos PowerPlay 236
Creacin de un nuevo almacn de contenido mediante la base de datos de contenido de Cognos 236
Configuracin del protocolo SSL 237
Configuracin de SSL para IBM Cognos 8 237
Configuracin de la confianza compartida entre los servidores IBM Cognos y otros servidores 240
Seleccin y clasificacin de paquetes de cifrado para SSL 241
Habilitacin de SSL en el servidor Web 242
Configuracin de mensajes de registro 243
Directrices para la creacin de una base de datos de registro 245
Creacin de espacios de tabla para la base de datos de registro DB2 en z/OS 245
Configuracin de la conectividad de base de datos para una base de datos de registro 247
Destinos de los mensajes de registro 249
Especificacin del destino de los mensajes de registro 251
Cambio de la configuracin global 255
Personalizacin de la compatibilidad de idioma en la interfaz de usuario 255
Personalizacin de la compatibilidad de moneda 256
Personalizacin de la compatibilidad de configuraciones regionales de contenido 257
Asignacin de configuraciones regionales de contenido 258
Asignacin de configuraciones regionales de productos 260
Personalizacin de la zona horaria del servidor 261
Cambio de la codificacin de los mensajes de correo electrnico 262
Personalizacin de la configuracin de las cookies 263
Configuracin del enrutador para probar la disponibilidad del distribuidor 264
Cambio de la puerta de enlace 264
Configuracin de la puerta de enlace para el mdulo del servidor Web Apache de IBM
Cognos 265
Configuracin de la puerta de enlace del servlet 268
Cambio de la versin de la direccin IP 269
Actualizacin de las propiedades de ubicacin de archivo en Windows Vista 271
Captulo 12: Configuracin de Portal Services

273

Especificacin de la ubicacin del archivo Applications.xml 273


Configuracin de la seguridad para Portal Services 274
Deshabilitacin del acceso annimo a los componentes de IBM Cognos 8 275
Habilitacin del inicio de sesin nico mediante secreto compartido 275
Habilitacin del inicio de sesin nico de SAP EP con el vale de inicio de sesin de SAP 281
Habilitacin del inicio de sesin nico de SAP EP con asignacin de usuario 281
Habilitacin de comunicacin segura entre SAP EP y componentes de IBM Cognos 8 283

8 PowerPlay

ndice
Habilitacin del inicio de sesin nico para WebSphere Portal mediante el servidor de
aplicaciones 283
Habilitacin del inicio de sesin nico de BEA ALUI Portal mediante la autenticacin
bsica 283
Habilitacin del inicio de sesin nico de BEA ALUI Portal con SiteMinder 284
Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones

287

Creacin de una instancia de JVM independiente 288


Comprobacin de la configuracin de los componentes de IBM Cognos 289
Copia de seguridad de la informacin existente de IBM Cognos 289
Cmo establecer variables de entorno 291
Actualizacin del entorno Java 292
Configuracin de los componentes de IBM Cognos para que se ejecuten dentro del servidor de
aplicaciones 292
Identificacin del JDK para WebLogic 9 en AIX 295
Cambio del script de inicio del servidor de aplicaciones 295
Cambio del archivo de propiedades del distribuidor de IBM Cognos para el servidor de aplicaciones Oracle 297
Configuracin de las propiedades del servidor de aplicaciones e implementacin de los componentes de IBM Cognos 297
Cmo habilitar SSL 305
Configuracin del servidor Web 305
Cmo quitar el registro de distribuidores 306
Importacin de datos del almacn de contenido 306
Captulo 14: Opciones de configuracin avanzada

307

Cambio de la versin del entorno en tiempo de ejecucin de Java que utilizan los componentes
de IBM Cognos 8 307
Copia de seguridad de la informacin existente de IBM Cognos 308
Actualizacin del entorno de Java 309
Importacin de datos del almacn de contenido 310
Configuracin de los componentes de IBM Cognos 8 para utilizar otra entidad emisora de
certificados 310
Generacin de claves y solicitudes de firma de certificados 311
Configuracin de los componentes de IBM Cognos 8 para ejecutarlos en otra entidad
emisora de certificados 314
Captulo 15: Cmo establecer instalaciones y configuraciones sin participacin del usuario

317

Cmo establecer una instalacin sin participacin del usuario 317


Establecimiento de una configuracin sin participacin del usuario 320
Cmo establecer una desinstalacin sin participacin del usuario 322
Seccin 5: Mantenimiento
Captulo 16: Mantenimiento del rendimiento

325

Indicadores de rendimiento del sistema 325


Habilitacin de slo los servicios necesarios 325
Ajuste de un almacn de contenido DB2 329
Ajuste de la configuracin de Apache Tomcat 329
Aumento de la capacidad de gestin de solicitudes de la base de datos de contenido de Cognos 330
Gua de instalacin y configuracin 9

ndice
Reduccin del plazo de entrega de informes en una red 330
Seccin 6: Apndices
Apndice A: Configuracin manual de IBM Cognos 8

331

Configuracin manual de IBM Cognos 8 en UNIX y Linux 331


Cambio manual de los valores de configuracin predeterminados en equipos UNIX y
Linux 332
Cambio manual de la configuracin global en equipos UNIX y Linux 335
Inicio y detencin de IBM Cognos 8 en modo silencioso en equipos UNIX y Linux 337
Creacin manual de un archivo de aplicacin de IBM Cognos 338
Apndice B: Solucin de problemas

343

Archivos de registro 343


Problemas al iniciar IBM Cognos 8 345
Error CFG-ERR-0106 al iniciar el servicio IBM Cognos 8 en IBM Cognos Configuration 346
Error criptogrfico al iniciar IBM Cognos 8 347
No se puede iniciar el servicio IBM Cognos 8 porque otro proceso utiliza el puerto 348
El servicio IBM Cognos 8 no se inicia o falla tras iniciarse 349
El servidor IBM Cognos 8 no se inicia pero no aparece ningn mensaje de error 349
El servidor IBM Cognos BI no est disponible al iniciar IBM Cognos 8 349
No se puede iniciar sesin en un espacio de nombre con IBM Cognos Connection (error
PRS-CSE-1255) 354
Fallo al reiniciar los servicios IBM Cognos 8 despus de una interrupcin de la red 355
Error al descargar recursos 355
DB2 devuelve el error SQL1224N al conectarse desde AIX 355
Error de Content Manager al iniciar IBM Cognos 8 355
No se puede encontrar la pgina al iniciar IBM Cognos 8 en Windows 2003 356
No se muestra la pgina al abrir un portal despus de haber instalado IBM Cognos 8 356
Aparece el error DPR-ERR-2058 en el explorador Web al iniciar IBM Cognos 8 356
La migracin no funciona 358
Error EBA-090034 al iniciar WebLogic 8 359
Aparece el error DPR-ERR-2022 en el explorador Web al iniciar IBM Cognos 8 360
No se puede descargar el archivo cognos.xts 360
Error de script de inicio del servidor de aplicaciones 361
Error al implementar IBM Cognos 8 en un servidor de aplicaciones Oracle o IBM WebSphere 361
El tipo de informe de varias pginas de Microsoft Excel 2000 no funciona 361
No se puede anular la serializacin del atributo de contexto al implementar el archivo
p2pd.war en WebLogic 362
Los caracteres acentuados o de doble byte pueden mostrarse incorrectamente al instalar
IBM Cognos 8 en Linux 362
Problemas al configurar IBM Cognos 8 363
Ejecucin de scripts de limpieza de base de datos 363
Error al intentar codificar informacin al guardar la configuracin 365
Problemas al generar claves criptogrficas en IBM Cognos Configuration 366
Error CAM-CRP-1315 al guardar la configuracin 366
Los datos de configuracin estn bloqueados por otra instancia de IBM Cognos Configuration 367

10 PowerPlay

ndice
No se puede salir de una secuencia de tabulacin desplazndose slo con el teclado en IBM
Cognos Configuration 367
No se puede guardar la configuracin 367
Error de Java al iniciar IBM Cognos Configuration 368
Error criptogrfico al iniciar IBM Cognos Configuration 368
No se han aplicado los valores de configuracin actuales en el equipo 368
Error CM-CFG-029 al intentar guardar una configuracin que especifica un servidor de
origen de datos SQL 369
Se solicita a los usuarios credenciales de Active Directory 369
Fuente no encontrada en UNIX al iniciar IBM Cognos Configuration 370
No se puede cargar la biblioteca DB2 OLAP en Framework Manager 370
Falta una pertenencia a grupo en el espacio de nombre de Active Directory 370
Implementacin de IBM Cognos 8 en un servidor de aplicaciones Oracle o IBM WebSphere 371
Se muestran errores al realizar la implementacin en el servidor de aplicaciones Oracle
10G 372
Error de tiempo de espera CGI excedido durante la conexin a los componentes IBM
Cognos 8 a travs de un explorador Web 372
Error al cargar la clase servlet en WebLogic 373
Los iconos del escritorio o la ventana de IBM Cognos Configuration parpadean en Windows 374
Glosario
ndice

375
379

Gua de instalacin y configuracin 11

ndice

12 PowerPlay

Introduccin
Este documento se ha concebido para ser utilizado con IBM Cognos 8 PowerPlay, una solucin de
Business Intelligence basada en Web con las funciones de exploracin de datos para el contenido
de IBM Cognos Series 7 PowerPlay.
Esta gua contiene instrucciones acerca de la instalacin, la configuracin y la realizacin de pruebas
de IBM Cognos 8 PowerPlay, el cambio de servidores de aplicaciones y la configuracin de ejemplos.
Para obtener ms informacin acerca de la migracin y de las diferencias entre IBM Cognos Series
7 PowerPlay y IBM Cognos 8 PowerPlay, consulte la Gua de migracin y administracin.

Destinatarios
Para utilizar esta gua, debe estar familiarizado con

IBM Cognos Series 7 PowerPlay

La instalacin de software en ordenadores con Windows y UNIX

Su tecnologa de informacin e infraestructura de seguridad

Bases de datos, servidor de directorio y administracin de servidor de aplicaciones

Documentacin relacionada
Nuestra documentacin incluye guas de usuario, guas de inicio rpido, guas de funciones nuevas,
archivos Lame y otros materiales pensados para satisfacer las necesidades de todos nuestros
clientes. En este documento puede encontrar referencias a los siguientes documentos que contienen
informacin relacionada.
Nota: Los usuarios que consulten este documento en lnea puede que vean el mensaje La pgina no
puede mostrarse al hacer clic en determinados vnculos de la tabla siguiente. Hay documentos disponibles para instalaciones y configuraciones de idioma concretas. Si un vnculo no est disponible,
puede acceder al documento en el centro de recursos de IBM Cognos (http://www.ibm.com/software/
data/support/cognos_crc.html).

Documento

Descripcin

IBM Cognos 8 - Gua del usuario de Visualizacin, exploracin, creacin de formato y distribuPowerPlay Studio
cin de informes de PowerPlay
IBM Cognos 8 PowerPlay Gua de
migracin y administracin

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

Migracin del contenido de IBM Cognos Series 7 PowerPlay


a IBM Cognos 8 PowerPlay y administracin del entorno de
IBM Cognos 8 PowerPlay

13

Introduccin

Documento

Descripcin

IBM Cognos 8 Architecture and


Deployment Guide

Introduccin a la arquitectura de IBM Cognos 8, desarrollo


de estrategias de instalacin, incluidas cuestiones de seguridad y optimizacin del rendimiento

IBM Cognos Configuration Gua del Uso de IBM Cognos Configuration para configurar IBM
usuario
Cognos 8
IBM Cognos 8 Gua de administra- Administracin de servidores, seguridad, informes y portal
cin y seguridad
services, as como configuracin de los ejemplos, personalizacin de la interfaz de usuario y solucin de problemas
Manual del usuario de IBM Cognos Uso de IBM Cognos Connection para publicar, buscar, gesConnection
tionar, organizar y ver el contenido de IBM Cognos, como
tablas de puntuacin, informes, anlisis y agentes
IBM Cognos Supplementary Langua- Instalacin y configuracin de otros idiomas admitidos,
ges Installation and Configuration adems de ingls, francs, alemn o japons para la interfaz
Guide
de usuario de IBM Cognos 8

Bsqueda de informacin
Hay disponible documentacin sobre los productos en la ayuda en lnea, a la que puede acceder
desde el men o el botn Ayuda de los productos de IBM Cognos.
Para encontrar la documentacin de producto ms actual, incluida toda la documentacin y los
materiales de Knowledge Base traducidos, acceda al centro de recursos de IBM Cognos (http://www.
ibm.com/software/data/support/cognos_crc.html).
Asimismo, puede consultar las versiones PDF de los archivos Lame y las guas de instalacin de
los productos directamente en los CD de los productos IBM Cognos.

Uso de los Quick Tours


Los documentos Quick Tour (Visita rpida) son tutoriales cortos en lnea que muestran funciones
bsicas de los componentes de los productos IBM Cognos. Para ver uno de estos documentos, inicie
IBM Cognos Connection y haga clic en el vnculo Quick Tour, que se encuentra en la parte inferior
derecha de la pgina de bienvenida.

Obtencin de ayuda
Para obtener ms informacin sobre el uso de este producto o recibir asistencia tcnica, visite el
centro de recursos de IBM Cognos (http://www.ibm.com/software/data/support/cognos_crc.html).
Esta pgina proporciona informacin sobre la asistencia, los servicios profesionales y la educacin.

Impresin del material de copyright


Puede imprimir pginas seleccionadas, una seccin o el libro completo. Se le concede una licencia
no exclusiva e intransferible para el uso, copia y reproduccin de materiales con copyright, ya sea

14 PowerPlay

Introduccin
en formato impreso o electrnico, con el nico objetivo de hacer funcionar, mantener y proporcionar
formacin interna del software IBM Cognos.

Gua de instalacin y configuracin 15

Introduccin

16 PowerPlay

Captulo 1: Novedades
Esta seccin contiene una lista de funciones nuevas, modificadas, obsoletas y eliminadas para esta
versin. Le ayudar a planificar las estrategias de actualizacin y de implementacin de la aplicacin,
as como los requisitos de formacin de los usuarios.
Para obtener informacin sobre actualizaciones, consulte el documento IBM Cognos 8 PowerPlay
Gua de instalacin y configuracin correspondiente a su producto.
Para ver una lista actualizada de los entornos compatibles con los productos IBM Cognos, por
ejemplo, sistemas operativos, revisiones, exploradores, servidores Web, servidores de directorio,
servidores de base de datos y servidores de aplicaciones, visite el centro de servicio al cliente de IBM
Cognos (http://www.ibm.com/software/data/support/cognos_crc.html).

Gua de funciones nuevas


A continuacin encontrar las nuevas funciones incorporadas desde el lanzamiento de la ltima
versin de IBM Cognos 8 PowerPlay. Se incluyen vnculos a temas directamente relacionados.

Compatibilidad con idiomas adicionales


Adems de en japons, alemn y francs, la documentacin de instalacin y la interfaz de usuario
para el programa de instalacin e IBM Cognos Configuration estn disponibles en los siguientes
idiomas:

Chino (simplificado)

Chino (tradicional)

Coreano

Italiano

Espaol

Portugus (Brasil)

Durante la instalacin, puede seleccionar el idioma que se debe utilizar en la primera pgina del
asistente para instalacin. Esto determinar el idioma de las interfaces de usuario del asistente para
instalacin e IBM Cognos Configuration.
Sin embargo, debe configurar IBM Cognos 8 para que utilice los idiomas adicionales. Para obtener
ms informacin, consulte "Personalizacin de la compatibilidad de idioma en la interfaz de usuario" (p. 255).

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

17

Captulo 1: Novedades

Compatibilidad con el controlador universal DB2 para bases de datos de almacn


de contenido, notificaciones y registro
DB2 introdujo un controlador JDBC universal que contiene compatibilidad con los tipos 2 y 4 de
controlador JDBC. IBM Cognos 8 puede conectarse a un almacn de contenido, una base de datos
de notificaciones o una base de datos de registro DB2 mediante conectividad de tipo JDBC, pero
primero debe copiar dos archivos JAR en el directorio de instalacin de IBM Cognos 8. Si est
realizando una actualizacin, puede seguir usando el tipo 2 de conectividad JDBC sin cambiar las
propiedades de conexin para el almacn de contenido DB2.
Para obtener ms informacin sobre las propiedades de conexin del almacn de contenido, consulte
"Configuracin de las propiedades de la conexin a la base de datos en el almacn de contenido" (p. 89).
Los dos archivos JAR que debe copiar en el directorio de instalacin de IBM Cognos 8 son los
siguientes:

un archivo de licencia, por ejemplo db2jcc_license_cisuz.jar o db2jcc_license_cu.jar

un archivo de controlador, db2jcc.jar

Para obtener informacin sobre cmo copiar estos archivos, consulte "Configuracin de la conectividad de la base de datos para la base de datos del almacn de contenido" (p. 87).

DB2 en z/OS como almacn de contenido, registro o base de datos de notificacin


Puede usar DB2 en z/OS como su almacn de contenido, registro o base de datos de notificacin.
La configuracin de conexin para DB2 en z/OS son similares a los de DB2 en Linux, UNIX y
Windows. Sin embargo, es posible realizar configuraciones avanzadas adicionales.
Para obtener ms informacin sobre la configuracin, consulte "Configuracin recomendada para
crear el almacn de contenido en DB2 en z/OS" (p. 46), "Configuracin recomendada para crear
una base de datos de notificaciones DB2 en z/OS" (p. 217) y "Configuracin recomendada para
crear la base de datos de registro DB2 en z/OS" (p. 245).
Debe ejecutar secuencias de comandos para crear espacios de tabla para almacenar objetos de gran
tamao (LOB). Para obtener ms informacin, consulte "Creacin de espacios de tabla para el
almacn de contenido DB2 en z/OS" (p. 50), "Creacin de espacios de tabla para la base de datos
de registro DB2 en z/OS " (p. 245) y "Creacin de espacios de tabla para la base de datos de notificaciones DB2 en z/OS" (p. 217).

Asistencia para direcciones IPv6


IBM Cognos 8 ahora es compatible con dos protocolos de direccin IP: IPv4 e IPv6. IPv4 utiliza
direcciones IP de 32 bits e IPv6 utiliza direcciones IP de 128 bits. La opcin predeterminada es IPv4.
Para que IBM Cognos Configuration acepte direcciones IPv6 en las propiedades del URI locales,
debe iniciar IBM Cognos Configuration mediante la opcin -ipv6. Puede especificar la opcin cada
vez que abra IBM Cognos Configuration desde la lnea de comandos.
En Windows, puede establecer la opcin de forma permanente aadindola al acceso directo del
men Inicio.

18 PowerPlay

Captulo 1: Novedades
Para obtener ms informacin, consulte "Cambio de la versin de la direccin IP" (p. 269).

Compatibilidad con servidores de aplicaciones de 64 bits


Los productos IBM Cognos 8 Business Intelligence son ahora compatibles con servidores de aplicaciones de 64 bits.
Para obtener informacin sobre los servidores de aplicacin compatibles, visite el centro de recursos
de IBM Cognos (http://www.ibm.com/software/data/support/cognos_crc.html).
Para obtener informacin acerca de la configuracin, consulte Gua de instalacin y configuracin
de IBM Cognos 8.

Cmo ocultar el espacio de nombre a los usuarios durante el inicio de sesin


Ahora puede ocultar el espacio de nombre a los usuarios durante el inicio de sesin. Esto le permite
disponer de espacios de nombre de inicio de sesin de confianza sin mostrarlos en la lista de seleccin
de espacios de nombre que se presenta cuando los usuarios inician la sesin. Para obtener mas
informacin, consulte "Cmo ocultar el espacio de nombre a los usuarios durante el inicio de
sesin" (p. 186).

Funciones modificadas en la versin 8.4


A continuacin encontrar una lista de las caractersticas o funciones modificadas respecto a la
versin anterior. Se incluyen vnculos a temas directamente relacionados.

Instalacin de documentacin de idiomas suplementarios necesaria para la


documentacin traducida de productos
Debe instalar Supplementary Languages Documentation para acceder a la documentacin del producto en idiomas distintos del ingls. Para obtener ms informacin, consulte "Instalar documentacin de producto traducida" (p. 166).
De manera predeterminada, cuando instala el componente de puerta de enlace de IBM Cognos 8,
la documentacin de instalacin, que incluye la Gua de instalacin y configuracin, la Gua de
introduccin a la instalacin y el Lame, se instala en todos los idiomas compatibles. La documentacin de producto, como la gua de administracin y seguridad, solamente se instala en ingls.

Una conexin predeterminada a un almacn de contenido IBM DB2 sustituye a


Microsoft SQL Server
Cuando inicia por primera vez IBM Cognos Configuration, la conexin a IBM DB2 sustituye a
Microsoft SQL Server como almacn de contenido predeterminado.
Si no ha instalado la base de datos de contenido de IBM Cognos y desea utilizar otro servidor de
base de datos para el almacn de contenido, deber eliminar el almacn de contenido predeterminado.
Despus de la desinstalacin, si instala en la misma ubicacin que una versin anterior, se conservar
su configuracin y se utilizar el almacn de contenido existente.
Para obtener ms informacin, consulte "Configuracin de las propiedades de la conexin a la base
de datos en el almacn de contenido" (p. 89).
Gua de instalacin y configuracin 19

Captulo 1: Novedades

El entorno en tiempo de ejecucin de Java (JRE) de IBM sustituye al entorno en


tiempo de ejecucin de Sun Java
IBM Cognos 8 contiene ahora la versin de IBM del JRE como parte de las instalaciones en Windows.
Esta versin sustituye al JRE de Sun para las plataformas Windows de 32 bits.
La ubicacin de la instalacin sigue siendo la misma. Cualquier contenido codificado con JRE de
Sun se puede descodificar con el JRE de IBM.

Funciones obsoletas de la versin 8.4


Una funcin obsoleta es aquella que se sustituye por una nueva versin o una implementacin
mejor. La intencin es suspender la utilizacin de la funcin y proporcionar recomendaciones para
adaptarse a este cambio en mltiples versiones.
A continuacin, se enumeran las funciones obsoletas junto con vnculos a temas relacionados.

Compatibilidad con el controlador de tipo 2 DB2 JDBC para las bases de datos
de almacn de contenido, notificaciones y registro en Linux, UNIX y Windows
(db2java.zip)
DB2 introdujo un controlador JDBC universal que contiene compatibilidad con los tipos 2 y 4 de
controlador JDBC. Este nuevo controlador universal reemplaza al controlador de tipo 2, db2java.zip.
Puede seguir usando el tipo 2 de conectividad sin realizar ningn cambio en la configuracin. Si
elige usar el tipo 4 de conectividad, se necesita cambiar la configuracin.
Para obtener ms informacin, consulte "Configuracin de las propiedades de la conexin a la base
de datos en el almacn de contenido" (p. 89).

Funciones eliminadas en la versin 8.4


A continuacin aparecen enumeradas las funciones eliminadas desde la ltima versin. Se incluyen
vnculos a temas directamente relacionados.

Interfaz de usuario basada en texto para instalar y desinstalar en UNIX y Linux


En versiones anteriores de productos IBM Cognos 8 BI, puede ejecutar un programa de instalacin
o desinstalacin basado en texto, o modo de consola, en sistemas que no tienen XWindows. En la
versin anterior, no estn disponibles la instalacin basada en texto y los programas de desinstalacin. Los usuarios que realicen la instalacin en UNIX y Linux sin XWindows deben ejecutar una
instalacin o desinstalacin sin participacin del usuario (p. 317).

Compatibilidad de idiomas para el texto de la interfaz de usuario de IBM Cognos 8


y mensajes movidos desde idiomas suplementarios a la instalacin del servidor
de IBM Cognos 8
IBM Cognos 8 viene con un conjunto de texto de interfaz de usuario y mensajes en varios idiomas
adicionales respecto a la versin anterior. Ya no es necesario instalar idiomas suplementarios desde

20 PowerPlay

Captulo 1: Novedades
un programa de instalacin separado para mostrar la interfaz de usuario en uno de los idiomas
compatibles. Los archivos necesarios se instalan automticamente cuando instala el servidor de
IBM Cognos 8.
Sin embargo, debe usar Supplementary Languages Documentation para instalar las fuentes Andale
WT para Japn y Corea. Estas fuentes asignan el valor U+005C como un carcter de yen o won.
Para obtener ms informacin, consulte "Instalacin y configuracin de fuentes de idiomas adicionales" (p. 167).

Gua de instalacin y configuracin 21

Captulo 1: Novedades

22 PowerPlay

Captulo 2: Componentes utilizados por IBM Cognos 8 PowerPlay


IBM Cognos 8 PowerPlay es una solucin de Business Intelligence basada en Web con funciones
de creacin de informes y exploracin de datos integradas.
IBM Cognos 8 PowerPlay se integra fcilmente en la infraestructura existente mediante el uso de
los recursos que se encuentran en su entorno. Algunos de estos recursos existentes son necesarios,
como una Mquina virtual Java (Java Virtual Machine, JVM) para las instalaciones UNIX. Otros
recursos son opcionales, como el uso de una base de datos externa para el almacn de contenido o
un proveedor de seguridad para la autenticacin.
De forma predeterminada, IBM Cognos 8 PowerPlay utiliza Tomcat como servidor de aplicaciones.
Puede configurar los productos IBM Cognos 8 para que se ejecuten en los servidores de aplicaciones
compatibles que utiliza actualmente en su entorno.

Componentes de servidor
Los componentes de servidor proporcionan las interfaces de usuario para la creacin de informes
y la exploracin de datos, as como la funcin del servidor para el enrutamiento y el procesamiento
de las solicitudes del usuario.

Componentes de servidor comunes


Algunos componentes de servidor se proporcionan con todos los productos Cognos 8. Los componentes de servidor comunes incluyen las herramientas siguientes:

IBM Cognos Connection


IBM Cognos Connection es un portal Web suministrado con IBM Cognos 8, que proporciona un
punto de acceso nico a los datos corporativos disponibles para sus productos. Ofrece un nico
punto de entrada para realizar consultas, analizar, organizar y explorar los datos, as como para
crear informes y PowerCubes. Los usuarios pueden ejecutar todas las aplicaciones de IBM Cognos 8
basadas en Web a travs de IBM Cognos Connection. IBM Cognos Connection puede integrar otras
aplicaciones de Business Intelligence y direcciones URL a otras aplicaciones.

IBM Cognos Administration


IBM Cognos Administration es una interfaz de administracin central que contiene las tareas
administrativas para IBM Cognos 8 PowerPlay. Permite acceder fcilmente a la administracin
global del entorno de IBM Cognos y se puede acceder a este componente a travs de IBM Cognos
Connection. IBM Cognos Administration tambin proporciona acceso a las configuraciones del
cubo y del informe para IBM Cognos 8 PowerPlay.

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

23

Captulo 2: Componentes utilizados por IBM Cognos 8 PowerPlay

Cognos Viewer
Cognos Viewer es un portlet en el que puede ver e interactuar con cualquier tipo de contenido de
IBM Cognos publicado. Se puede acceder a este componente a travs de IBM Cognos Connection
y de cualquier portal empresarial existente.

IBM Cognos Configuration


IBM Cognos Configuration es una herramienta que se utiliza para configurar IBM Cognos 8 y para
iniciar y detener sus servicios.

Puerta de enlace
La comunicacin Web en IBM Cognos 8 se suele realizar a travs de puertas de enlace, que residen
en uno o varios servidores Web. Una puerta de enlace es una extensin de un programa de servidor
Web que transfiere informacin desde el servidor Web a otro servidor.
Las puertas de enlace suelen ser programas CGI, pero pueden seguir otros estndares, como ISAPI
(Internet Server Application Program Interface) y mdulos de Apache (apache_mod).

Content Manager
Content Manager es el servicio de IBM Cognos 8 que administra el almacenamiento de los datos
de aplicaciones del cliente, incluida la seguridad, los datos de configuracin, los modelos, los indicadores, las especificaciones de informes y las salidas de informes. Content Manager es necesario
para publicar paquetes, recuperar o almacenar especificaciones de informes, administrar informacin
de planificacin y administrar el espacio de nombres de Cognos.
Content Manager almacena la informacin en una base de datos del almacn de contenido.
En IBM Cognos 8 PowerPlay, el componente Content Manager incluye el servicio de migracin de
IBM Cognos 8.

Componentes de servidor para IBM Cognos 8 PowerPlay


Algunos componentes de servidor son especficos de IBM Cognos 8 PowerPlay. Los componentes
de servidor incluyen las herramientas siguientes:

PowerPlay Studio
PowerPlay Studio permite a los usuarios visualizar, explorar y distribuir informes mediante un
explorador Web.

Ejemplos de IBM Cognos 8


En los ejemplos de IBM Cognos 8 se ilustran las caractersticas del producto y las prcticas tcnicas
y empresariales recomendadas mediante los datos de una empresa ficticia, Viaje de Aventuras.
Asimismo, puede utilizarlos para probar y compartir tcnicas de diseo de informes y solucionar
problemas.
Los ejemplos de IBM Cognos 8 incluyen PowerCubes, modelos e informes que puede utilizar en
Cognos 8 PowerPlay para visualizar, publicar y obtener detalles de los informes, as como para
realizar una migracin de ejemplos de IBM Cognos Series 7 a IBM Cognos 8.

24 PowerPlay

Captulo 2: Componentes utilizados por IBM Cognos 8 PowerPlay

Componentes de migracin
Los componentes de migracin de IBM Cognos 8 se utilizan para migrar el contenido de IBM
Cognos Series 7 a IBM Cognos 8. Tambin sirven para migrar los informes de PowerPlay Studio a
Analysis Studio y Report Studio.
Para obtener ms informacin sobre los componentes de migracin, consulte la Gua de migracin
y administracin de IBM Cognos 8 PowerPlay.
Los componentes de migracin son los siguientes:

Ayudante para la migracin


Los administradores utilizan el ayudante para la migracin a fin de migrar el contenido de IBM
Cognos Series 7 PowerPlay desde PowerPlay Enterprise Server, Upfront e IBM Cognos Connection
a IBM Cognos 8 PowerPlay.

Servicios de migracin
Los servicios de migracin administran las operaciones de migracin cuando se migra contenido
de PowerPlay de IBM Cognos Series 7 a IBM Cognos 8 PowerPlay. Constan de un servicio IBM
Cognos 8 y un servicio IBM Cognos Series 7, que son necesarios para realizar una migracin correcta.
El servicio de migracin de IBM Cognos 8 forma parte del servicio IBM Cognos 8 y se comunica
con los componentes de servidor de IBM Cognos 8. Se instala con el componente Content Manager.
El servicio de migracin de IBM Cognos Series 7 es un servicio de Windows o UNIX y se comunica
con los componentes de IBM Cognos Series 7. Est instalado en el equipo IBM Cognos Series 7.
Tras realizar la migracin a IBM Cognos 8 PowerPlay, los componentes de migracin de IBM
Cognos Series 7 pueden desinstalarse. El servicio de migracin de IBM Cognos 8 permanece instalado,
para ofrecer migracin de informes desde PowerPlay Studio a Analysis Studio y Report Studio.

Utilidad de conversin de marcadores


La utilidad de conversin de marcadores convierte los marcadores de PowerPlay Enterprise Server
a un formato que IBM Cognos 8 PowerPlay Studio puede leer.

Macro de conversin de PPR a PPX


IBM Cognos 8 PowerPlay no abre informes en formato ppr. IBM Cognos 8 PowerPlay dispone de
una macro llamada ppr2ppx.mac que le permite convertir informes en formato ppr a formato ppx.

Macro de actualizacin de informes


Si existen archivos .ppx locales con acceso a cubos remotos, IBM Cognos 8 PowerPlay proporciona
una macro que se puede usar para cambiar la referencia al cubo del informe por una referencia al
paquete de IBM Cognos 8. Adems, la macro convierte la codificacin del informe a UTF-8.

Migracin a Analysis Studio y Report Studio


Analysis Studio y Report Studio son componentes de servidor que estn disponibles en IBM Cognos
8 Business Intelligence. Los usuarios de IBM Cognos 8 pueden abrir informes de PowerPlay y
migrarlos a Analysis Studio o Report Studio mediante la funcin Abrir con Analysis Studio o Abrir
con Report Studio. Esta funcionalidad, que el administrador de PowerPlay puede deshabilitar, utiliza
el servicio de migracin de IBM Cognos 8 para migrar los informes.
Gua de instalacin y configuracin 25

Captulo 2: Componentes utilizados por IBM Cognos 8 PowerPlay

Componente de cliente
Los componentes de cliente proporcionan funciones a los usuarios sin tener que realizar una instalacin de servidor completa y pueden depender del servidor para realizar algunas operaciones. IBM
Cognos 8 PowerPlay proporciona el siguiente cliente.

IBM Cognos 8 PowerPlay Client


PowerPlay Client permite a los usuarios visualizar, explorar, formatear y distribuir informes.

Otros componentes
Adems de las herramientas proporcionadas con IBM Cognos 8 PowerPlay, se requieren otros
componentes.

Almacn de contenido
El almacn de contenido es una base de datos relacional que contiene los datos que necesita IBM
Cognos 8 para funcionar, como especificaciones de informes, modelos publicados y los paquetes
que los contienen; informacin de conexin de orgenes de datos; informacin sobre el espacio de
nombres externo y el propio espacio de nombres de IBM Cognos. La base de datos relacional puede
ser la base de datos de contenido de Cognos u otra base de datos compatible.
Los archivos de registro no se almacenan en el almacn de contenido.
Al servicio de IBM Cognos 8 que utiliza el almacn de contenido se le llama Content Manager.

Orgenes de datos
IBM Cognos 8 PowerPlay admite orgenes de datos de PowerCube. Existen otros componentes de
IBM Cognos 8 que admiten otros tipos de orgenes de datos. Para obtener ms informacin, consulte
IBM Cognos 8 Gua de administracin y seguridad.

26 PowerPlay

Captulo 3: Opciones de distribucin de IBM Cognos 8


Antes de implementar IBM Cognos 8, decida cmo lo instalar en su entorno. Puede instalar todos
los componentes de IBM Cognos 8 PowerPlay en un equipo o distribuirlos a travs de una red. La
mejor opcin de distribucin depende de sus necesidades de creacin de informes, recursos y preferencias. Los requisitos de configuracin varan segn si instala todos los componentes en un equipo
o en ms de un equipo.
IBM Cognos 8 PowerPlay es compatible con otros productos IBM Cognos. Si su entorno incluye
otros productos IBM Cognos, debe considerar cmo se ajustar IBM Cognos 8 PowerPlay a ese
entorno.

Distribucin de componentes de servidor de IBM Cognos 8


PowerPlay
Cuando se instalan componentes de servidor de IBM Cognos 8 PowerPlay se especifica el lugar en
que se colocarn las puertas de enlace, los componentes de nivel de aplicacin y Content Manager.
Puede instalar estos componentes mediante cualquiera de las siguientes opciones:

Instalacin de todos los componentes en un equipo.


Esta opcin se suele utilizar para una demostracin o en un entorno de prueba de conceptos.

Instalacin de la puerta de enlace en otro equipo.


La puerta de enlace y el servidor Web se encuentran en un equipo, mientras que el resto de los
componentes de IBM Cognos se encuentra en otros equipos. Puede seleccionar esta opcin si
tiene servidores Web existentes disponibles para gestionar solicitudes de componentes de IBM
Cognos.

Instalacin de componentes de nivel de aplicacin y Content Manager en distintos equipos.


Seleccione esta opcin para maximizar el rendimiento, la disponibilidad, la capacidad o la
seguridad segn las caractersticas de procesamiento de su organizacin.
Si va a instalar la base de datos de contenido de IBM Cognos, puede instalarla en el mismo
equipo que Content Manager o en otro distinto. Si la instala en el mismo equipo y en la misma
ubicacin, la base de datos de contenido de IBM Cognos se configura automticamente para
su uso como almacn de contenido. Si la instala en otro equipo, asegrese de establecer las
propiedades de conexin de la base de datos de contenido de IBM Cognos en su equipo de
Content Manager.

Instalacin de componentes de servidor de IBM Cognos 8 PowerPlay en el mismo equipo que


otros productos IBM Cognos 8.

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

27

Captulo 3: Opciones de distribucin de IBM Cognos 8


A medida que instale componentes de servidor de IBM Cognos 8, debe configurarlos para que
puedan comunicarse entre s.
Adems de instalar Content Manager, componentes de nivel de aplicacin y componentes de puerta
de enlace, puede instalar Framework Manager, la aplicacin de modelado de metadatos para
Business Intelligence. Tambin puede elegir instalar Transformer, la herramienta de modelado y
creacin de PowerCubes para utilizar con IBM Cognos 8. Independientemente del plan de instalacin
de IBM Cognos que siga, puede instalar todos los componentes en ubicaciones separadas. Para
obtener ms informacin sobre cmo instalar Framework Manager o Transformer, consulte la
Gua de instalacin y configuracin de su producto de modelado.

Todos los componentes en un equipo


Puede instalar todos los componentes de IBM Cognos 8 en un equipo. Seleccione este escenario
para entornos de prueba de conceptos o de demostracin en los que la carga del usuario sea pequea.
Como la puerta de enlace se debe colocar con el servidor Web, el equipo tambin debe ejecutar un
servidor Web. Si su servidor Web ejecuta UNIX o Linux, debe instalar PowerPlay Client basado
en Windows en otro equipo que se ejecute en Windows.
En una instalacin de equipo nico, todos los componentes de servidor para IBM Cognos 8
PowerPlay se instalan en un equipo. El almacn de contenido y los orgenes de datos pueden
encontrarse en uno o ms equipo distintos.

Requisitos de configuracin
Si instala todos los componentes de servidor para IBM Cognos 8 Reporting en el mismo equipo,
debe:

Configurar su servidor Web para ver contenido de IBM Cognos

Especificar informacin de conexin al almacn de contenido

Especificar un servidor de correo y una cuenta de correo electrnico para notificaciones (si tiene
intencin de enviar informes por correo electrnico)

Puertas de enlace en distintos equipos


La puerta de enlace administra la comunicacin entre los componentes de IBM Cognos 8. Puede
encontrarse en uno o ms servidores Web.
Puede instalar la puerta de enlace y un servidor Web en un equipo, e instalar los componentes restantes de servidor de IBM Cognos 8 en otros equipos. Si tiene una granja de servidores, puede instalar una puerta de enlace en cada servidor Web. Si se utilizan varios servidores Web para administrar
las solicitudes entrantes, se proporciona un nivel de servicio superior.
Si instala slo el componente de puerta de enlace en el mismo equipo que el servidor Web, el servidor
Web administra los servicios Web principales y no procesa las solicitudes de los usuarios de IBM
Cognos 8. Esta separacin en el procesamiento puede ser necesaria si tiene un servidor de seguridad
entre el servidor Web y sus equipos de componentes de nivel de aplicacin.

28 PowerPlay

Captulo 3: Opciones de distribucin de IBM Cognos 8


En el siguiente diagrama, cada uno de los dos servidores Web tiene una puerta de enlace instalada.
Las solicitudes entrantes se transmiten a la puerta de enlace correspondiente y se reenvan al equipo
de componentes de nivel de aplicacin.

Puerta de enlace
del servidor Web

Puerta de enlace
del servidor Web

Instalacin de varias
puertas de enlace

Componentes de
nivel de aplicacin
Content Manager

Almacn de contenido

Orgenes de datos

Requisitos de configuracin
Si se instalan una o ms puertas de enlace en distintos equipos, debe asegurarse de que puede ver
el contenido de IBM Cognos y de que las puertas de enlace pueden comunicarse con otros componentes de IBM Cognos. En todos los equipos donde la puerta de enlace est instalada, usted debe:

Configurar propiedades criptogrficas

Configurar su servidor Web para ver contenido de IBM Cognos

Configurar los URI de distribuidor

Componentes de nivel de aplicacin y Content Managers en distintos equipos


Los componentes de nivel de aplicacin sirven para ejecutar procesos de servidor de informes,
equilibrar cargas, acceder a datos, realizar consultas, planificar trabajos y representar informes.
Content Manager almacena todas las especificaciones de informe, los resultados, los paquetes, las
carpetas y los trabajos en el almacn de contenido.
Puede instalar los componentes de nivel de aplicacin y Content Manager en el mismo equipo o en
distintos equipos. Si los instala en distintos equipos puede mejorar el rendimiento, la disponibilidad
y la capacidad.
Para mejorar la escalabilidad en un entorno en el que suele haber un gran volumen de solicitudes
para procesar, puede instalar los componentes de nivel de aplicacin en varios servidores PowerPlay
dedicados a procesar solicitudes entrantes. Al instalar los componentes de nivel de aplicacin en
varios equipos, se distribuyen y equilibran las cargas entre los equipos. Tambin se obtiene mejor
accesibilidad y rendimiento que en un solo equipo, as como soporte de migracin tras error.
En una instalacin con varios servidores PowerPlay, las solicitudes entrantes se enrutan a una puerta
de enlace. La puerta de enlace reenva la solicitud a uno de los servidores PowerPlay. El servidor

Gua de instalacin y configuracin 29

Captulo 3: Opciones de distribucin de IBM Cognos 8


de PowerPlay reenva la solicitud a Content Manager, que consulta el almacn de contenido para
comprobar si hay metadatos para consultar al PowerCube. Los resultados de la consulta se
devuelven al servidor de PowerPlay para procesarlos.

Requisitos de configuracin
Si se instalan uno o ms componentes de nivel de aplicacin en equipos distintos, para asegurarse
de que pueden comunicarse con otros componentes de servidor de IBM Cognos 8 debe:

Configurar propiedades criptogrficas

Especificar todos los URI de Content Manager

Especificar los URI de distribuidor

Especificar el URI de distribuidor para aplicaciones externas

Ms de un Content Manager
Puede tener tantas instalaciones de Content Manager como desee, pero slo una puede estar activa.
El resto de las instalaciones acta como un Content Manager en espera. Una pasa a estar activa
slo si falla el equipo en el que se encuentra instalado el Content Manager activo. Para poder disponer de migracin tras error, es aconsejable instalar Content Manager en dos o ms equipos.
Content Manager almacena datos necesarios para el funcionamiento de IBM Cognos 8, como
especificaciones de informes, modelos publicados y los paquetes que los contienen; informacin de
conexin de orgenes de datos; informacin sobre el espacio de nombre externo y el propio espacio
de nombre de Cognos; e informacin sobre informes de separacin y planificacin. El almacn de
contenido es un sistema de gestin de base de datos relacional (RDBMS). Slo existe un almacn
de contenido para cada instalacin de IBM Cognos.
Puede instalar Content Manager por separado de los componentes de nivel de aplicacin. Por
ejemplo, puede instalar Content Manager en el nivel de datos en lugar de en el nivel de aplicaciones.
Cuando falla un Content Manager activo, se pierden los datos de la sesin no guardados. Cuando
lo sustituye el nuevo Content Manager activo, puede que se solicite a los usuarios iniciar sesin.
En el siguiente diagrama, la puerta de enlace reenva la solicitud al equipo de Content Manager
activo predeterminado. Debido a que se ha producido un error en el equipo, la solicitud se redirecciona al equipo de Content Manager en espera, que pas a estar activo cuando se produjo un error
en el equipo de Content Manager activo predeterminado.

30 PowerPlay

Captulo 3: Opciones de distribucin de IBM Cognos 8

Componentes de nivel
de aplicacin de la
puerta de enlace
del servidor Web

Instalacin de varios
Content Manager

Content Manager
en espera
Content Manager
activo predeterminado

Almacn de contenido

Orgenes de datos

Requisitos de configuracin
En todos los equipos en los que instale Content Manager, debe:

Configurar propiedades criptogrficas

Especificar informacin de conexin al almacn de contenido

Especificar los URI de distribuidor

Especificar todos los URI de Content Manager

Especificar el URI de distribuidor para aplicaciones externas

Configurar una conexin a una cuenta de correo electrnico para notificaciones (si desea enviar
informes por correo electrnico)

Varios productos de IBM Cognos 8 en un mismo equipo


Los productos de IBM Cognos 8 estn diseados para compartir componentes, incluidos la puerta
de enlace, Content Manager, el almacn de contenido, IBM Cognos Connection e IBM Cognos
Configuration. Si instala ms de un producto de IBM Cognos 8 en un mismo equipo, le recomendamos que los instale en la misma ubicacin de instalacin. El programa de instalacin hace una
comprobacin para determinar si existen otros componentes de IBM Cognos 8 en la ubicacin de
instalacin. Si existe un componente que se puede compartir, no se vuelve a instalar.

Acceso a la documentacin del producto en un entorno integrado


La documentacin de los componentes de IBM Cognos 8 se instala con el componente de puerta
de enlace. Si se integran distintos productos de IBM Cognos 8, puede utilizar la misma puerta de
enlace o varias distintas. Si desea utilizar la misma puerta de enlace, todos los componentes de
puerta de enlace deben pertenecer a la misma versin del producto, y debe instalar el componente
de puerta de enlace de IBM Cognos 8 para cada producto en la misma ubicacin del mismo equipo.
Esto garantiza que toda la documentacin del producto est disponible para todos los usuarios. Si
desea utilizar distintas puertas de enlace para cada producto, puede instalar el componente puerta
de enlace de IBM Cognos 8 para cada producto en distintos equipos, pero la documentacin del
producto en cada puerta de enlace ser especfica para el producto de IBM Cognos 8 que haya
instalado.
Gua de instalacin y configuracin 31

Captulo 3: Opciones de distribucin de IBM Cognos 8


Si desea que los usuarios accedan a cada producto de IBM Cognos 8 a travs de distintas puertas
de enlace pero que sigan teniendo acceso a documentacin de todos los componentes, puede instalar
el componente de puerta de enlace de cada producto en la misma ubicacin que los dems componentes de puerta de enlace de IBM Cognos 8.

IBM Cognos 8 PowerPlay con otros productos de IBM Cognos


Puede instalar IBM Cognos 8 PowerPlay en un entorno que incluya otros productos de IBM Cognos.
El asistente para instalacin de IBM Cognos 8 PowerPlay reconoce directorios compatibles y
muestra una advertencia cuando ocurre algn conflicto. Despus de instalar IBM Cognos 8
PowerPlay, puede acceder a objetos creados en otro producto de IBM Cognos a travs de IBM
Cognos 8. Los requisitos de acceso dependen de cmo decida ejecutar los dos productos.

Productos de IBM Cognos Series 7 que pueden migrarse a IBM Cognos 8


PowerPlay
Puede migrar completamente aplicaciones de IBM Cognos Series 7 PowerPlay a IBM Cognos 8
PowerPlay. Para obtener ms informacin, consulte la Gua de migracin y administracin de IBM
Cognos 8 PowerPlay.
Tambin puede migrar metadatos y aplicaciones de otros productos de IBM Cognos Series 7 a IBM
Cognos 8. El contenido que puede migrarse incluye modelos Architect de Windows, catlogos e
informes de cliente Impromptu de Windows, y contenido de informes Web Impromptu.

PowerPlay Enterprise Server


Las funciones de exploracin y anlisis de datos de IBM Cognos Series 7 PowerPlay estn ahora
disponibles con IBM Cognos 8 PowerPlay. La arquitectura orientada a servicios de IBM Cognos 8
hace posible la integracin de PowerPlay Web, PowerPlay Enterprise Server Administration y el
servicio de PowerPlay Enterprise Server.
El ayudante para la migracin se utiliza para migrar contenido de IBM Cognos Series 7 PowerPlay
desde

PowerPlay Enterprise Server

Upfront

Cognos Connection (contenido publicado desde IBM Cognos Series 7 PowerPlay Enterprise
Server)

Tambin puede migrar marcadores e informes de PowerPlay Client a Cognos 8 PowerPlay. Para
obtener ms informacin sobre lo que puede migrar de IBM Cognos Series 7 PowerPlay a IBM
Cognos 8 PowerPlay, consulte la Gua de migracin y administracin de IBM Cognos 8 PowerPlay.
Para migrar contenido de IBM Cognos Series 7 a IBM Cognos 8 PowerPlay, debe instalar IBM
Cognos 8 PowerPlay Server y los componentes de migracin de IBM Cognos Series 7.

32 PowerPlay

Captulo 3: Opciones de distribucin de IBM Cognos 8

Impromptu
Puede migrar catlogos e informes Impromptu a IBM Cognos 8. Los catlogos migrados se utilizan
como origen de metadatos para Framework Manager. Despus de completar el proceso de migracin
de catlogos, puede migrar e implementar informes Impromptu.

Informes Web de Impromptu


Puede migrar el contenido de informes Web Impromptu, como planificaciones y eventos, a IBM
Cognos 8. La migracin del contenido de informes Web Impromptu se realiza con un paquete de
IBM Cognos Series 7 Deployment Manager como origen de migracin. Antes de migrar informes
Web Impromptu, debe migrar los metadatos de catlogo Impromptu utilizados por los informes.
No puede migrar archivos de definicin de consulta de Impromptu (.iqd), pero puede continuar
utilizando archivos .iqd existentes para construir cubos en IBM Cognos 8 Transformer. Para ello,
debe instalar el componente opcional Series 7 IQD Bridge que est disponible para su instalacin
con IBM Cognos 8 BI en plataformas compatibles con IBM Cognos Series 7.
No se migran PowerPrompts, pero puede implementar una funcin similar mediante la funcionalidad
incorporada de administrador o el Software Development Kit.

Architect
Puede migrar modelos Architect para utilizarlos como origen de metadatos para Framework
Manager.

Productos de IBM Cognos que interoperan con IBM Cognos 8 PowerPlay


Algunos productos de IBM Cognos ofrecen funcionalidades que no estn disponibles en IBM Cognos 8 PowerPlay. Puede utilizar estos productos en el mismo entorno que IBM Cognos 8 PowerPlay.

IBM Cognos 8 Business Intelligence Server


Para utilizar herramientas de modelado (como Framework Manager e IBM Cognos 8 Transformer)
con IBM Cognos 8 PowerPlay debe instalar IBM Cognos 8 Business Intelligence Server. Si tambin
desea utilizar Report Studio, Analysis Studio o Query Studio, necesita IBM Cognos 8 Business
Intelligence Server.
Se recomienda instalar IBM Cognos 8 Business Intelligence Server adems de IBM Cognos 8
PowerPlay antes de configurar la instalacin. Si va a instalar IBM Cognos 8 PowerPlay en un entorno
IBM Cognos 8 ya existente, realice una copia de seguridad de la configuracin de IBM Cognos 8
antes de instalar IBM Cognos 8 PowerPlay.
Para la instalacin en un solo equipo, instale los componentes de ambos productos en el mismo
directorio, como se indica a continuacin:
1. Instale IBM Cognos 8 BI Server e IBM Cognos 8 PowerPlay.
2. Configure los componentes instalados.
3. Instale los componentes de migracin de IBM Cognos Series 7 en el servidor de IBM Cognos
Series 7 PowerPlay.
Para una instalacin distribuida, instale y configure los componentes como se indica a continuacin:

Gua de instalacin y configuracin 33

Captulo 3: Opciones de distribucin de IBM Cognos 8


1. Instale y configure todos los componentes de IBM Cognos 8 BI Server: Content Manager,
componentes de nivel de aplicacin y puerta de enlace.
2. Instale y configure los componentes de nivel de aplicacin de IBM Cognos 8 PowerPlay.
3. Instale el componente PowerPlay Administration para IBM Cognos 8 PowerPlay en los mismos
equipos en los que se hayan instalado los componentes de nivel de aplicacin de IBM Cognos
8 PowerPlay e IBM Cognos 8.
4. Instale el componente de puerta de enlace de PowerPlay en el mismo servidor Web en el que
ha instalado el componente de puerta de enlace de IBM Cognos 8 BI.
5. Instale los componentes de IBM Cognos 8 PowerPlay Content Manager en el mismo equipo
que los componentes de IBM Cognos 8 Content Manager.
6. Instale los componentes de migracin de IBM Cognos Series 7 en el equipo de IBM Cognos
Series 7 PowerPlay Enterprise Server y, si fuera necesario, en el equipo de IBM Cognos Series 7
Upfront.
Para obtener instrucciones acerca de la instalacin y la configuracin de IBM Cognos 8 BI Server,
consulte la Gua de instalacin y configuracin de IBM Cognos 8 Business Intelligence.

IBM Cognos Planning - Analyst


Puede acceder a datos de plan publicados en IBM Cognos 8 mediante el asistente para Generar
modelo de Framework Manager, que requiere IBM Cognos Planning - Analyst 7.3 MR1 o posterior.
Para obtener ms informacin, consulte la gua User Guide de Analyst.

IBM Cognos Planning - Contributor


Puede acceder (en tiempo real) a cubos no publicados de Contributor en IBM Cognos 8 mediante
la instalacin personalizada del componente de servidor de datos Contributor de IBM Cognos 8
que se incluye en la versin IBM Cognos Planning - Contributor 7.3 MR1 o posterior. Puede acceder
a datos de plan publicados en IBM Cognos 8 mediante la extensin de administracin de Contributor
Generar modelo de Framework Manager, que requiere Cognos Planning - Contributor 7.3 MR1
o posterior.
Para obtener ms informacin, consulte la gua Administration Guide de Contributor.

IBM Cognos Finance


Puede acceder a cubos de IBM Cognos Finance que estn protegidos contra un espacio de nombre
de Series 7 mediante el servicio IBM Cognos Finance Network API. Tambin puede exportar datos
y metadatos de IBM Cognos Finance para utilizarlos en Framework Manager.

IBM Cognos Controller


Puede acceder a IBM Cognos 8 para crear informes estndar de IBM Cognos Controller mediante
un modelo predefinido de Framework Manager que se crea cuando se instala IBM Cognos Controller.
Tambin puede acceder a datos y estructuras publicados de Controller en Framework Manager
para informes y anlisis personalizados. Tanto IBM Cognos Controller como IBM Cognos 8 BI
deben tener la misma versin.

34 PowerPlay

Captulo 3: Opciones de distribucin de IBM Cognos 8

Transformer
Puede utilizar modelos de Transformer y PowerCubes de IBM Cognos que se hayan generado con
Transformer 7.3 o posterior directamente en IBM Cognos 8. Los cubos y modelos son compatibles
con las versiones posteriores y no requieren herramientas de migracin o actualizacin. Puede ejecutar informes y anlisis en IBM Cognos 8 contra IBM Cognos PowerCubes.
Si desea utilizar las funciones de integracin de Transformer con IBM Cognos 8, puede actualizar
modelos de IBM Cognos Series 7.x Transformer a IBM Cognos 8 BI Transformer 8.3 o posterior.
Esto le permite utilizar orgenes de datos de IBM Cognos 8 (como paquetes publicados), enumerar
informes creados en Query Studio o Report Studio, autenticar utilizando la seguridad de IBM
Cognos 8 y publicar directamente en IBM Cognos Connection.
Si el modelo se ha protegido en IBM Cognos Series 7, debe configurar el espacio de nombre de IBM
Cognos Series 7 en IBM Cognos 8 (p. 180) antes de cargar el modelo. El identificador de nombre
que se utiliza para configurar el espacio de nombre de IBM Cognos 8 debe coincidir con el nombre
utilizado en IBM Cognos Serie 7.
Para obtener ms informacin sobre la actualizacin de PowerCubes protegidos de IBM Cognos
Series 7, consulte la gua User Guide de IBM Cognos 8 Transformer.
Para los PowerCubes de IBM Cognos Series 7 que se van a utilizar en IBM Cognos 8, se recomienda
optimizar los cubos para IBM Cognos 8 mediante la utilidad pcoptimizer proporcionada con IBM
Cognos 8. De lo contrario, los PowerCubes creados con versiones anteriores de Transformer pueden
tardar mucho en abrirse en los estudios Web de IBM Cognos 8. Esta utilidad de optimizacin es
adecuada para PowerCubes antiguos cuando el modelo ya no existe o los datos utilizados para
construir el PowerCube ya no estn disponibles. No es necesario ejecutar esta utilidad de lnea de
comandos para cubos creados en IBM Cognos 8 Transformer. Para obtener ms informacin sobre
la optimizacin de PowerCubes, consulte la gua User Guide de Transformer.
Puede publicar orgenes de datos y paquetes de PowerCube individuales en IBM Cognos Connection
de forma interactiva en Transformer o en la lnea de comandos. Tambin puede publicar en modo
silencioso utilizando archivos de comandos por lotes despus de crear un PowerCube. Un usuario
que tiene privilegios para crear orgenes de datos y paquetes en IBM Cognos Connection tambin
puede publicar PowerCubes en IBM Cognos Connection. El archivo MDC debe encontrarse en una
ubicacin protegida a la que pueda acceder el distribuidor de IBM Cognos 8. Los paquetes que
utilizan varios PowerCubes o PowerCubes mezclados con otros orgenes de datos deberan publicarse
con Framework Manager.
Si se utiliza un PowerCube de IBM Cognos Series 7 como origen de datos, IBM Cognos 8 convierte
los datos del cubo de la codificacin utilizada en el sistema en que se cre el PowerCube. Para una
conversin correcta, los PowerCubes de IBM Cognos Series 7 se deben crear con una configuracin
regional del sistema establecida para coincidir con los datos en el PowerCube.

Data Manager
Data Manager sirve para crear almacenes de datos y repositorios de datos para informes, anlisis
y administracin del rendimiento. Cuando se instala Data Manager en su entorno de IBM Cognos 8,
puede utilizar el servicio de movimiento de datos para ejecutar compilaciones y flujos de trabajo
en IBM Cognos Connection. Debe instalar el motor de Data Manager en la misma ubicacin que

Gua de instalacin y configuracin 35

Captulo 3: Opciones de distribucin de IBM Cognos 8


sus componentes de nivel de aplicacin de IBM Cognos 8. Tanto Data Manager como IBM Cognos 8
BI deben pertenecer a la misma versin.

IBM Cognos 8 Go! Mobile


Con IBM Cognos 8 Go! Mobile puede acceder a informes creados con Analysis Studio, Report
Studio y Query Studio en un dispositivo mvil (como una BlackBerry). Para descargar, ver e interactuar con informes, IBM Cognos 8 Go! Mobile requiere la instalacin de un cliente enriquecido
personalizado en el dispositivo mvil, adems de los componentes de servidor de IBM Cognos 8.
Tanto IBM Cognos 8 Go! Mobile como IBM Cognos 8 BI deben pertenecer a la misma versin.

IBM Cognos 8 Go! Search


El complemento IBM Cognos 8 Go! Search proporciona una bsqueda y unas opciones de navegacin
mejoradas en IBM Cognos 8. En IBM Cognos Connection, puede utilizar bsqueda de texto completo
para localizar contenido. En Analysis Studio, Query Studio y Cognos Viewer puede utilizar bsqueda
de texto completo y navegacin automtica, que localiza contenido relacionado con el contenido
de la vista actual. El almacn de contenido de IBM Cognos 8 debe incluir contenido que se pueda
indizar. Tanto IBM Cognos 8 Go! Search como IBM Cognos 8 BI deben pertenecer a la misma
versin.

Contenido de IBM Cognos Series 7 que se puede volver a crear en IBM Cognos 8
Algunos productos de IBM Cognos no se pueden migrar por programa con las herramientas de
migracin de IBM Cognos 8. IBM Cognos 8 ofrece dos opciones para duplicar contenido o funcionalidad de los productos descritos a continuacin: utilizar el portal Upfront en el portal de IBM
Cognos 8 o duplicar consultas, visualizaciones u objetos mediante los estudios de IBM Cognos 8.

IBM Cognos Query


Puede utilizar las herramientas de migracin para identificar objetos de IBM Cognos Query en el
origen de migracin de IBM Cognos Series 7. De esta forma puede duplicar la mayora de las funciones de IBM Cognos Query en IBM Cognos 8. Cuando se mira un modelo Architect hay disponibles
consultas base en IBM Cognos 8. Tambin puede replicar manualmente consultas guardadas
mediante componentes SQL en Report Studio.

IBM Cognos Visualizer


Puede duplicar la funcionalidad mediante las opciones de grficos, diseo y formato en Report
Studio y Analysis Studio.

IBM Cognos NoticeCast


Puede duplicar la funcionalidad de alerta y notificacin mediante Event Studio y otros componentes
de IBM Cognos 8.

IBM Cognos Web Services


Puede duplicar la mayora de las funciones de IBM Cognos Web Services utilizando IBM Cognos 8
Software Development Kit.

36 PowerPlay

Captulo 3: Opciones de distribucin de IBM Cognos 8

IBM CognosScript
Puede duplicar la funcionalidad de automatizacin utilizando IBM Cognos 8 Software Development
Kit.

IBM Cognos Portal Services


Puede duplicar la mayora de las funciones de IBM Cognos Portal Services mediante IBM Cognos
Connection.

Gua de instalacin y configuracin 37

Captulo 3: Opciones de distribucin de IBM Cognos 8

38 PowerPlay

Captulo 4: Configuracin del entorno


Cuando instale el producto IBM Cognos 8, debe configurar los recursos del entorno para que los
componentes puedan funcionar. Por ejemplo, debe crear una base de datos para el almacn de
contenido y configurar los exploradores Web. Puede crear adems una cuenta de usuario o de servicio para IBM Cognos 8.
Si quiere utilizar la base de datos de contenido de Cognos como almacn de contenido, no necesitar
crear una base de datos ni configurar un cliente de base de datos. Al seleccionar la base de datos
de Cognos en el asistente de instalacin, se crea una base de datos durante la instalacin y se configura IBM Cognos 8 para que la utilice.
Debe comprobar que los exploradores Web de los equipos de usuario estn configurados para
proporcionar acceso a los componentes IBM Cognos.
Utilice la siguiente lista de comprobacin como gua durante el proceso de configuracin:

Revise el Lame.

Revise los entornos compatibles.

Compruebe que el equipo cumple los requisitos de hardware y software.

Revise la configuracin de puertos predeterminada.

Cree la base de datos para el almacn de contenido.

Configure los exploradores Web.

Configure una cuenta de usuario o de servicio para IBM Cognos 8, si es necesario.

Despus de haber completado estas tareas, debe instalar y configurar los componentes IBM Cognos
en uno (p. 79) o ms equipos (p. 107) para trabajar en su entorno.

Recomendacin: Revise el documento Lame antes de la instalacin


Antes de instalar el producto IBM Cognos es importante que tenga en cuenta todos los problemas
que pueden afectar a la estrategia de instalacin.
Pueden surgir problemas de ltima hora que se desconocan cuando se cre la gua de instalacin.
Recomendamos que revise el documento Lame antes de instalar el producto. El documento Lame
contiene informacin de ltima hora sobre problemas conocidos, as como actualizaciones de la
documentacin y avisos de componentes obsoletos. El documento Lame est disponible desde la
primera pgina del asistente de instalacin o desde el CD de producto. Las actualizaciones del
documento Lame tambin estn disponibles en el centro de recursos de IBM Cognos (http://www.
ibm.com/software/data/support/cognos_crc.html).

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

39

Captulo 4: Configuracin del entorno

Revisin de entornos compatibles


Para comprobar que su producto funciona adecuadamente, aplique todas las revisiones mnimas
necesarias del sistema operativo y utilice slo las versiones de software compatibles con un producto
de IBM Cognos.
Para ver una lista actualizada de los entornos compatibles con los productos IBM Cognos, por
ejemplo sistemas operativos, parches, exploradores, servidores Web, servidores de directorio, servidores de base de datos y servidores de aplicaciones, visite el centro de recursos de IBM Cognos
(http://www.ibm.com/software/data/support/cognos_crc.html).
Es importante tener en cuenta que el sistema operativo Linux est disponible en varios distribuidores
y que es compatible con diversas plataformas de hardware. Compruebe que la combinacin de sistema
operativo y hardware que est utilizando es una combinacin compatible.

Verificacin de los requisitos del sistema


Utilice la siguiente tabla para verificar los requisitos mnimos de hardware y software para instalar
y ejecutar componentes IBM Cognos 8 en un equipo. Es posible que se necesiten recursos adicionales
para entornos distribuidos o de produccin.

Requisito

Especificacin

Sistema operativo

Windows
UNIX
Linux
Algunos componentes IBM Cognos 8 no son compatibles con Linux.

RAM

Mnimo: 2 GB

Especificaciones del sis- Lmite del descriptor de archivos establecido en 2048 en UNIX y Linux
tema operativo
(recomendado)
Espacio en disco

Es necesario un mnimo de 2,5 GB de espacio libre para instalar el software y 4 GB de espacio libre en la unidad que contenga el directorio
temporal utilizado por los componentes de IBM Cognos.

Servidor Web

Debe haber un servidor Web instalado e iniciado.

Entorno en tiempo de El JRE de IBM se instala automticamente con IBM Cognos 8 en Winejecucin de Java (JRE) dows.
Si est utilizando un servidor de aplicaciones, utilice el JRE que se instala
con l si es compatible con IBM Cognos 8.

40 PowerPlay

Captulo 4: Configuracin del entorno

Requisito

Especificacin

Base de datos

La base de datos de contenido de Cognos se puede instalar y configurar


como base de datos predeterminada del almacn de contenido.
Si quiere utilizar otra base de datos, debe disponer de una de las siguientes
bases de datos para almacenar datos de IBM Cognos:

Oracle

DB2

Microsoft SQL Server

Sybase

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


Explorador Web

Para todos los exploradores Web, estn habilitados los siguientes componentes:

cookies

JavaScript

Slo para Microsoft Internet Explorer, estn habilitados los siguientes


componentes:

Otros

Secuencias de comandos ActiveX

Permitir META REFRESH

En Windows, Microsoft Data Access Component (MDAC) para su uso


con plantillas del producto.
Si desea enviar los informes por correo electrnico, necesita disponer de
un servidor de correo.

Revisin de la configuracin predeterminada para IBM Cognos 8


La siguiente tabla enumera los puertos predeterminados y la configuracin del URI para IBM
Cognos 8. Tras la instalacin puede utilizar la herramienta de configuracin para cambiar la configuracin (p. 219).

Opcin

Predeterminada

Descripcin

URI de Content Manager

http://localhost:9300/ p2pd/servlet

El URI hasta el Content Manager

El URI de puerta de enlace

http://localhost:80/ cognos8/cgi-bin/
cognos.cgi

El URI hasta la puerta de enlace

Gua de instalacin y configuracin 41

Captulo 4: Configuracin del entorno

Opcin

Predeterminada

Descripcin

URI de distribuidor

http://localhost:9300/ p2pd/servlet/
dispatch

El URI hasta el distribuidor

El URI de distribuidor para aplicacio- http://localhost:9300/ p2pd/servlet/


nes externas
dispatch

El URI hasta el distribuidor

Los URI de distribuidor para puerta


de enlace

http://localhost:9300/ p2pd/servlet/
dispatch/ ext

El URI hasta el distribuidor primario usado por la puerta de enlace

Puerto del servidor de registro

9362

El puerto usado por el servidor de


registro local

Escuchando nmero de puerto

1527

Puerto utilizado por la base de


datos de contenido de Cognos.

(Interno, Externo)

La siguiente tabla enumera la configuracin predeterminada usada por IBM Cognos 8 para Tomcat.
Los conectores SSL y los que no usan SSL se actualizan automticamente en el archivo server.xml
cuando utiliza IBM Cognos Configuration para cambiar el puerto del distribuidor o para habilitar
el protocolo SSL. Puede actualizar directamente el puerto de apagado mediante IBM Cognos Configuration.

Opcin

Puerto

Descripcin

Conector no SSL Coyote HTTP/ 9300


1.1

El puerto Tomcat se usa para transmitir solicitudes del servidor


Web a IBM Cognos 8

Conector SSL Coyote HTTP/1.1 9334

El puerto Tomcat se usa para escuchar conexiones seguras

Puerto de apagado

El puerto Tomcat se usa para escuchar un comando de apagado

9399

La siguiente tabla enumera la configuracin predeterminada usada en la migracin del PowerPlay


de IBM Cognos Series 7 al de IBM Cognos Series 8

Opcin

Puerto

Descripcin

Nmero de puerto del servicio de migracin

21567

El puerto usado para la comunicacin entre el servicio


de migracin de IBM Cognos Series 7 y el de IBM
Cognos Series 8

PPBOOKMARKTOOL_PORT

7777

El puerto usado para la migracin de marcadores

42 PowerPlay

Captulo 4: Configuracin del entorno

Directrices para la creacin del almacn de contenido


El almacn de contenido es una base de datos que Content Manager utiliza para almacenar datos
de configuracin globales, valores globales (como los formatos de moneda e idioma que aparecen
en la interfaz de usuario), conexiones con los orgenes de datos y contenido especfico del producto.
Los modelos de diseo y los archivos de registro no se guardan en el almacn de contenido.
Debe crear el almacn de contenido antes de poder usar IBM Cognos 8.
Si realiza una actualizacin desde ReportNet o una versin anterior de IBM Cognos 8, puede usar
el almacn de contenido actual con la nueva versin de IBM Cognos 8. Despus de la actualizacin
del almacn de contenido, no podr usarlo con la versin anterior. Si est actualizando y desea
conservar la versin actual de ReportNet o la versin anterior de IBM Cognos 8, deber crear una
nueva base de datos de almacn de contenido para su uso con IBM Cognos 8. Debe seguir el proceso
de actualizacin adecuado (p. 76) al crear la nueva base de datos de almacn de contenido.

Propiedades de la base de datos


La base de datos debe crearse utilizando una de las bases de datos que figuran en la siguiente tabla:

Base de datos

Codificacin de caracteres

Protocolo

DB2

UTF-8

TCP/IP

Oracle

AL32UTF8 o AL32UTF16

TCP/IP

SQL Server

UTF-8 o UTF-16

TCP/IP

Sybase

UTF-8

TCP/IP

Base de datos de contenido de Cognos

Preconfigurada

Preconfigurada

Si tiene planificado utilizar la base de datos de contenido de Cognos como almacn de contenido,
se crear y se preconfigurar una base de datos cuando finalice la instalacin.

Secuencia de intercalacin
Tenga en cuenta que Cognos 8 utiliza un nico orden de clasificacin que especifica las normas que
utiliza la base de datos para interpretar, recopilar, comparar y presentar datos del carcter. Por
ejemplo, un orden de clasificacin define si la letra A es menos que, igual a o mayor que la letra B;
si la intercalacin distingue maysculas y minsculas y si la intercalacin distingue entre caracteres
acentuados y no acentuados. Para obtener ms informacin acerca de la intercalacin y las
secuencias de intercalacin, consulte la documentacin de la base de datos.

Configuracin recomendada para crear el almacn de contenido en DB2 en Linux,


Windows y UNIX
La base de datos que vaya a crear como almacn de contenido deber incluir los valores de configuracin recomendados.

Gua de instalacin y configuracin 43

Captulo 4: Configuracin del entorno


Para garantizar una instalacin correcta, siga estas directrices durante la creacin del almacn de
contenido.

Archivos de biblioteca de 32 bits para DB2


IBM Cognos 8 requiere archivos de biblioteca de 32 bits. Si ha instalado la versin 9.5 de DB2, los
archivos de biblioteca de 64 bits pueden definirse en las variables de entorno. Deber cambiar los
archivos de biblioteca utilizados o bien modificar el orden en el que figuran dichos archivos, de tal
modo que IBM Cognos 8 pueda encontrar los archivos de biblioteca de 32 bits. Los archivos de
biblioteca de 32 bits deben figurar primero para IBM Cognos 8.

Directrices para crear el almacn de contenido en DB2 en Linux, UNIX o Windows


Si crea su propio almacn de contenido, utilice la siguiente lista de comprobacin a modo de ayuda
para la configuracin del almacn en DB2:

Si usa la conectividad UDBC de tipo 2, configure las variables de entorno apropiadas para DB2,
que son las siguientes.

Variable de entorno

Descripcin

DB2DIR

Directorio de nivel superior que contiene el software de


cliente de la base de datos o la instalacin completa de la
base de datos.

LD_LIBRARY_PATH

Ruta de carga de la biblioteca. Debe aadir la ubicacin del


controlador.
Por ejemplo, LD_LIBRARY_PATH= $DB2_location/sqllib/
lib32: $LD_LIBRARY_PATH
Ejemplos:
Para Solaris y Linux:
LD_LIBRARY_PATH= $DB2DIR/lib: $LD_LIBRARY_
PATH
Para AIX:
LIBPATH=$DB2DIR/lib: $LIBPATH
Para HP-UX:
SHLIB_PATH=$DB2DIR/lib: $SHLIB_PATH

DB2INSTANCE

Conexin predeterminada del servidor de la base de datos.

DB2CODEPAGE

Al establecer esta variable de entorno opcional en un valor


de 1208 se ofrece soporte a las bases de datos multilinges.
Para obtener ms informacin acerca de si debe utilizar esta
variable de entorno, vea la documentacin de DB2.

44 PowerPlay

Captulo 4: Configuracin del entorno

Utilice UTF-8 como valor del conjunto de cdigos al crear la base de datos.
Para verificar si la base de datos tiene el conjunto de cdigos correcto mediante la interfaz de
la lnea de comandos, escriba lo siguiente en la solicitud de comando:
db2 get database configuration for nombre_base_datos
El valor del conjunto de cdigos debe ser UTF-8 y el valor de la pgina de cdigos debe ser
1208.

Asegrese de establecer los siguientes parmetros de configuracin.

Propiedad

Opcin

Tamao de montn de la aplicacin

1.024 KB

(applheapsz)
Tiempo excedido (locktimeout)

240 segundos
No lo establezca como un valor de tiempo de espera
infinito.

Si el valor del tamao de montn de la aplicacin es demasiado pequeo, pueden producirse


errores de memoria insuficiente cuando haya muchos usuarios.

Cree un grupo de bferes con un tamao de pgina de 32 KB y un segundo grupo con un


tamao de pgina de 4 KB.

Cree un espacio de tabla temporal en el sistema utilizando el grupo de bferes de 32 KB que


cre en el paso anterior.

Cree un espacio de tabla de usuario temporal utilizando el grupo de bferes de 4 KB creado.


Las tablas temporales globales se crearn en el espacio de tablas temporal del usuario.

Cree un espacio de tabla de usuario normal utilizando el grupo de bferes de 4 KB creado.


Si tambin est creando una base de datos de registro, cree un espacio de tabla de usuario
normal adicional con un tamao de pgina de 8 KB.

Conceda los siguientes privilegios de base de datos para la cuenta de usuario que IBM Cognos
8 usar para acceder a la base de datos:

Conectar a la base de datos

Crear tablas

Crear esquemas de forma implcita

Sugerencia: Si quiere albergar ms de un almacn de contenido en su instancia de DB2 y va a


utilizar ambos a la vez, use una cuenta de usuario diferente para cada almacn de contenido
para asegurarse de que cada instancia de IBM Cognos 8 est completamente aislada de las
dems.

Gua de instalacin y configuracin 45

Captulo 4: Configuracin del entorno

Compruebe que la cuenta de usuario tiene privilegios de uso para el espacio de tabla de usuario
temporal y otros espacios de tabla adecuados asociados a la base de datos.

Cree un esquema para la cuenta de usuario que usar IBM Cognos 8 para acceder a la base de
datos y compruebe que el usuario haya creado, desplegado y modificado permisos para el
esquema.

Se recomienda crear un perfil que tome como origen sqllib/db2profile del directorio principal
del usuario de DB2. Por ejemplo, el contenido de su perfil ser similar al siguiente:
if [ -f /home/db2user/sqllib/db2profile ]; then
./home/db2user/sqllib/db2profile
fi

El administrador de la base de datos debe realizar una copia de seguridad de las bases de datos
de IBM Cognos 8 con regularidad, ya que contienen los datos de IBM Cognos. Para garantizar
la seguridad y la integridad de las bases de datos, protjalas frente a accesos no autorizados o
inapropiados.

Configuracin recomendada para crear el almacn de contenido en DB2 en z/OS


La base de datos que vaya a crear como almacn de contenido debe incluir algunos valores de
configuracin recomendados.
Para garantizar una instalacin correcta, siga estas directrices durante la creacin del almacn de
contenido.

Directrices para crear el almacn de contenido en DB2 en z/OS


Utilice la siguiente lista de comprobacin para configurar el almacn de contenido en DB2 en z/OS:

Cree una instancia de base de datos, un grupo de almacenamiento y una cuenta de usuario para
el almacn de contenido.
El usuario debe disponer de permisos para crear y eliminar tablas en la base de datos.
IBM Cognos 8 utiliza las credenciales de la cuenta de usuario para comunicarse con el servidor
de la base de datos.

46 PowerPlay

Asegrese de que reserva un grupo de bferes con un tamao de pgina de 32 KB y un segundo


grupo con un tamao de pgina de 4 KB para la instancia de la base de datos.

Los administradores deben ejecutar un script para crear espacios de tabla que puedan contener
objetos de gran tamao y otros datos del almacn de contenido, as como conceder derechos
a los usuarios para utilizar los espacios de tabla. Para obtener ms informacin sobre cmo
ejecutar el script, consulte "Creacin de espacios de tabla para el almacn de contenido DB2
en z/OS" (p. 50).

El administrador de la base de datos debe realizar una copia de seguridad de las bases de datos
de IBM Cognos 8 con regularidad, ya que contienen los datos de IBM Cognos. Para garantizar
la seguridad y la integridad de las bases de datos, protjalas frente a accesos no autorizados o
inapropiados.

Captulo 4: Configuracin del entorno

Configuracin recomendada para crear el almacn de contenido en Oracle


La base de datos que vaya a crear como almacn de contenido debe incluir algunos valores de
configuracin recomendados.
Para garantizar una instalacin correcta, siga estas directrices durante la creacin del almacn de
contenido.

Directrices para la creacin del almacn de contenido en Oracle


Utilice la siguiente lista de comprobacin a modo de ayuda para la configuracin del almacn de
contenido en Oracle.

Asegrese de que el parmetro del nivel de compatibilidad de la instancia de base de datos de


la base de datos del almacn de contenido est establecido en 9.0.1 o superior.
Por ejemplo, puede comprobar el ajuste del parmetro de inicializacin COMPATIBLE emitiendo
la siguiente sentencia SQL:
SELECT name, value, description FROM v$parameter WHERE name='compatible';
Para obtener informacin sobre cmo cambiar un parmetro de configuracin de la instancia,
consulte la documentacin de Oracle.

Determine si la base de datos es Unicode.


Sugerencia: Un mtodo consiste en escribir la siguiente sentencia de seleccin:
select * from NLS_DATABASE_PARAMETERS
Si el conjunto de resultados devuelve un NLS_CHARACTERSET que no es Unicode, cree una
nueva base de datos y especifique AL32UTF8 para los parmetros del conjunto de caracteres
de la base de datos.

Determine qu cuenta de usuario se utilizar para acceder a la base de datos.


Sugerencia: Si quiere albergar ms de un almacn de contenido en su instancia de Oracle y va
a utilizar ambos a la vez, utilice una cuenta de usuario diferente para cada almacn de contenido
para asegurarse de que cada instancia de Cognos 8 est completamente aislada de las dems.

Asegrese de que la cuenta de usuario que accede a la base de datos tenga permiso para hacer
lo siguiente:

Conectarse con la base de datos

Crear, modificar y colocar tablas, desencadenadores, vistas, procedimientos y secuencias

Insertar, actualizar y eliminar datos de las tablas de bases de datos

El administrador de la base de datos debe realizar una copia de seguridad de las bases de datos
de Cognos 8 con regularidad ya que contienen los datos de Cognos. Para garantizar la seguridad
y la integridad de las bases de datos, protjalas frente a accesos no autorizados o inapropiados.

Gua de instalacin y configuracin 47

Captulo 4: Configuracin del entorno

Configuracin recomendada para crear el almacn de contenido en Microsoft


SQL Server
La base de datos que vaya a crear como almacn de contenido debe incluir algunos valores de
configuracin recomendados.
Para garantizar una instalacin correcta, siga estas directrices durante la creacin del almacn de
contenido.

Configuracin recomendada para Microsoft SQL Server


Utilice la siguiente lista de comprobacin a modo de ayuda para la configuracin del almacn de
contenido en Microsoft SQL Server.

Asegrese de que la secuencia de intercalacin distingue entre maysculas y minsculas.


En una instalacin personalizada se selecciona una intercalacin, que incluye los conjuntos de
caracteres y el orden de clasificacin, durante la configuracin de SQL Server. En una instalacin
tpica, la instalacin utiliza el entorno local identificado por el programa de instalacin para
la intercalacin. Este valor no se podr cambiar ms adelante.

Al conectarse a Microsoft SQL Server Management Studio para crear la base de datos, utilice
autenticacin de SQL Server.
Si se conecta mediante la autenticacin de Windows, la base de datos que cree utilizar tambin
la autenticacin de Windows. En esta situacin, debe configurar la conexin de la base de datos
mediante un tipo de base de datos de Base de datos SQL Server (Autenticacin de Windows)
en IBM Cognos Configuration.

Para que la cuenta de usuario que se va a utilizar acceda a la base de datos, cree un nuevo inicio
de sesin en Seguridad y utilice los siguientes valores:

Seleccione Autenticacin de SQL Server.

Desactive la casilla de verificacin Exigir directivas de contrasea.

Sugerencia: Si quiere albergar ms de un almacn de contenido en su instancia de Microsoft


SQL Server y va a utilizar ambos a la vez, utilice una cuenta de usuario diferente para cada
almacn de contenido para asegurarse de que cada instancia de IBM Cognos 8 est completamente aislada de las dems.

48 PowerPlay

Para Microsoft SQL Server 2008, conceda permiso de ejecucin a la cuenta de usuario que
acceda a la base de datos.

Para la base de datos del almacn de contenido, cree una nueva base de datos en Bases de datos.

En Seguridad, cree un nuevo esquema para la nueva base de datos y asgnele un nombre.

En Seguridad, cree un nuevo usuario para la nueva base de datos con los siguientes valores:

En Nombre de inicio de sesin, especifique el nuevo nombre de inicio de sesin creado para
la cuenta de usuario.

En Esquema predeterminado, especifique el nuevo esquema.

Captulo 4: Configuracin del entorno

En Esquemas de propiedad, especifique el nuevo esquema.

En Miembros de la funcin, seleccione db_datareader, db_datawriter y db_ddladmin.

Configuracin recomendada para crear el almacn de contenido en Sybase


La base de datos que vaya a crear como almacn de contenido debe incluir algunos valores de
configuracin recomendados.
Para garantizar una instalacin correcta, siga estas directrices durante la creacin del almacn de
contenido.

Configuracin recomendada para Sybase


Utilice la siguiente lista de comprobacin a modo de ayuda para la configuracin del almacn de
contenido en Sybase.

En el servidor Sybase, cree una instancia de servidor con un tamao de pgina de servidor de
8 kB.
Para obtener instrucciones, consulte la documentacin de Sybase.

Si es necesario, instale jConnect 5.5.


Esta herramienta configura la comunicacin entre el controlador JDBC y la instancia de Sybase
Adaptive Server.
Para obtener instrucciones, consulte la documentacin de Sybase.
Si su versin de Sybase no incluye jConnect 5.5, deber descargar el instalador del sitio Web
de Sybase.

Aada el juego de caracteres UTF-8 a la instancia del servidor.

Si es necesario, convierta UTF-8 en el juego de caracteres predeterminado del servidor.

Cree un dispositivo de base de datos.


Sugerencia: Configure log_segment con un mnimo de 10 MB.

Configure el nuevo dispositivo de base de datos como predeterminado.


La informacin sobre la nueva base de datos se almacenar en el nuevo dispositivo de base de
datos. Conserve una copia de seguridad del dispositivo de la base de datos para fines de recuperacin.

Cree la base de datos.

Determine qu cuenta de usuario se utilizar para acceder a la base de datos.


Sugerencia: Si quiere albergar ms de un almacn de contenido en su instancia de Sybase y va
a utilizar ambos a la vez, utilice una cuenta de usuario diferente para cada almacn de contenido
para asegurarse de que cada instancia de IBM Cognos 8 est completamente aislada de las
dems.

Asegrese de que la cuenta de usuario tenga los siguientes privilegios para la base de datos:
crear predeterminado, crear procedimiento, crear tabla y crear vista.
Gua de instalacin y configuracin 49

Captulo 4: Configuracin del entorno

Asegrese de que la base de datos tiene los siguientes valores y de que se reinicia:

Privilegios para crear y colocar tablas para la cuenta de usuario.

La propiedad Select into est definida como True.

Creacin de espacios de tabla para el almacn de contenido


DB2 en z/OS
El administrador de la base de datos debe ejecutar un script para crear un conjunto de espacios de
tabla necesarios para la base de datos del almacn de contenido. El script debe modificarse para
sustituir los parmetros de marcador por otros que sean apropiados al entorno.
Asegrese de que utiliza las convenciones de nomenclatura para DB2 en z/OS. Por ejemplo, todos
los nombres de parmetros deben comenzar por una letra y no deben tener ms de ocho caracteres.
Para obtener ms informacin, consulte el centro de informacin DB2 de IBM.

Pasos
1. Conctese a la base de datos como un usuario con privilegios para crear y colocar espacios de
tabla y permitir la ejecucin de sentencias SQL.
2. Abra el archivo de script tablespace_db2zOS.sql y use la siguiente tabla, que le ayudar a
reemplazar los parmetros genricos por los apropiados para su entorno.
No todos los parmetros enumerados se encuentran en el script, pero se pueden aadir en el
futuro.

Nombre de parmetro

Descripcin

CMSCRIPT_CREATE_IN

Especifica la ubicacin de las tablas base.


Por ejemplo, databaseName.baseTablespaceName

CMSCRIPT_STOGROUP

Especifica el nombre del grupo de almacn.

CMSCRIPT_DATABASE

Especifica el nombre de la base de datos de almacn de


contenido.

CMSCRIPT_CS_ID

Especifica el identificador de instancia de la base de datos


del almacn de contenido.
El identificador no debe tener ms de dos caracteres.

CMSCRIPT_TABLESPACE

Especifica el nombre del espacio de tabla que contendr


todas las tablas base en el almacn de contenido.
No se incluyen las tablas auxiliares.
El nombre no puede tener ms de seis caracteres.

50 PowerPlay

Captulo 4: Configuracin del entorno

Nombre de parmetro

Descripcin

CMSCRIPT_LARGE_BP

Especifica el nombre del grupo de bferes ms grande


asignado para objetos especialmente grandes.

CMSCRIPT_REGULAR_BP

Especifica el nombre del grupo de bferes de tamao


normal asignado para los objetos normales y grandes.

CMSCRIPT_USERNAME

Especifica la cuenta de usuario que accede a la base de


datos del almacn de contenido.

3. Guarde y ejecute el script.


4. Conceda los derechos de usuario de IBM Cognos a los espacios de tabla creados al ejecutar el
archivo de script tablespace_db2zOS.sql:

En la herramienta de acceso remoto, abra el archivo de script rightsGrant_db2zOS.sql y


reemplace los parmetros de marcador por los valores apropiados para su entorno.
Sugerencia: Asegrese de que usa los mismos valores que emple al asignar recursos a los
grupos de bferes y a la cuenta de usuario.

Guarde y ejecute el archivo.

Se crear la base de datos del almacn de contenido. Ahora puede configurar una conexin de base
de datos.

Configuracin de los exploradores Web


Cognos 8 PowerPlay usa las configuraciones predeterminadas del explorador proporcionadas por
Microsoft y Firefox. Debe asegurarse de que se ha habilitado la configuracin para las cookies y
JavaScript en todos los exploradores. Se necesitan valores adicionales para el explorador.
En la tabla siguiente se muestran los valores que se deben habilitar en los exploradores Web admitidos.

Explorador

Opcin

Componente de Cognos

Internet Explorer (confi- Permitir cookies


IBM Cognos Connection
guracin para estudios y Secuencias de comandos Active IBM Cognos Administration
portales)
X
Cognos Viewer
Permitir META REFRESH
PowerPlay Studio

Gua de instalacin y configuracin 51

Captulo 4: Configuracin del entorno

Explorador

Opcin

Componente de Cognos

Firefox

Permitir cookies

IBM Cognos Connection

Permitir JavaScript

IBM Cognos Administration

Cargar imgenes

Cognos Viewer
PowerPlay Studio

Importante: Si Adblock Plus se ha instalado con Firefox, deshabiltelo con la opcin por pginas.
Adblock Plus impide que algunos recursos de Cognos Connection funcionen adecuadamente.
Cognos 8 PowerPlay usa las siguientes cookies para almacenar informacin de usuarios.

Cookie

Tipo

AS_TICKET

Temporal por Creado si Cogsesin


nos 8 PowerPlay
est configurado
para usar un
espacio de nombre de Cognos
Series 7

caf

Temporal por Contiene informasesin


cin sobre el
estado de seguridad.

Cam_passport

Temporal por Almacena una


sesin
referencia a una
sesin de usuario
almacenada en el
servidor de Content Manager.

cc_session

Temporal por Mantiene inforsesin


macin de la
sesin que es
especfica de
Cognos Connection

52 PowerPlay

Funcin

Captulo 4: Configuracin del entorno

Cookie

Tipo

cc_state

Temporal por Mantiene inforsesin


macin durante
las operaciones
de edicin, como
cortar, copiar y
pegar.

CRN

Temporal por Contiene la


sesin
informacin de
contenido y de
configuracin
regional del producto y se ha
configurado para
todos los usuarios de Cognos

pp_session

Temporal por Almacena la


sesin
informacin de la
sesin especfica
de PowerPlay
Studio.

userCapabilities

Temporal por Contiene todas


sesin
las funciones y la
firma del usuario
actual.

usersessionid

Temporal por Contiene un


sesin
identificador de
sesin de usuario
nico, vlido
para la duracin
de la sesin del
explorador.

FrameBorder

Temporal por Estas cookies


sesin
almacenan las
preferencias de
exportacin a
PDF.

PageOrientation
PageSize
PDFLayerDimension

Funcin

PDFOPTS

Gua de instalacin y configuracin 53

Captulo 4: Configuracin del entorno

Cookie

Tipo

Funcin

DimTreeToolbarVisible

Permanente

Almacena el
valor que determina si debe
mostrarse u ocultarse la barra de
herramientas del
visor de dimensiones.

cea-ssa

Temporal por Almacena el


sesin
valor que determina si la informacin de la
sesin del usuario se comparte
con otros componentes de IBM
Cognos 8.

BRes

Temporal por Almacena inforsesin


macin que sirve
para determinar
la resolucin de
pantalla que debe
utilizarse en la
representacin de
grficos.
Despus de actualizar o de instalar software nuevo, reinicie el explorador Web y aconseje a los
usuarios que borren la cach del explorador.

Configuracin de una cuenta de usuario o de servicio de red


para IBM Cognos 8
Puede configurar una cuenta de usuario o de servicio de red para IBM Cognos 8.
La cuenta de usuario o de servicio de red bajo la cual se ejecuta IBM Cognos 8 debe:

Tener acceso a todos los recursos necesarios, como las impresoras y los servidores Web.

Tener los derechos necesarios para iniciar la sesin como servicio y actuar como parte del sistema
operativo.

Adems, la cuenta de usuario debe ser miembro del grupo de administracin local.

54 PowerPlay

Captulo 4: Configuracin del entorno


Por ejemplo, para imprimir informes con una impresora en red, la cuenta debe tener acceso a la
impresora en red o se debe asignar una cuenta de acceso al servicio de IBM Cognos 8.

Configuracin de una cuenta de usuario


Para Windows, se recomienda asignar una cuenta de acceso al servicio de IBM Cognos 8. Puede
configurar el servicio de IBM Cognos 8 para que utilice una cuenta de usuario especial, si selecciona
el servicio de IBM Cognos 8 de la lista de servicios que se muestra en la ventana Servicios, en
Windows. A continuacin, puede definir las propiedades de la cuenta de usuario.
Para UNIX o Linux, se recomienda crear un nuevo grupo de UNIX o Linux denominado cognos8.
Este grupo debe contener al usuario propietario de los archivos de IBM Cognos. Cambie la propiedad
del grupo de los archivos IBM Cognos al grupo cognos8 y cambie los permisos de archivo de todos
los archivos de IBM Cognos a GROUP READABLE/WRITABLE/EXECUTABLE.
Debe configurar el servidor Web para utilizar alias. Para obtener ms informacin, consulte
"Configuracin del servidor Web" (p. 137).

Configuracin de una cuenta de servicio de red


La cuenta de servicio de red est incorporada en la cuenta NT AUTHORITY\NetworkService en
el sistema operativo. Los administradores no tienen que gestionar una contrasea ni mantener la
cuenta.
Utilice una cuenta con privilegios de administrador si va a realizar la instalacin sobre Windows
Server 2008.
Debe configurar el servidor Web para utilizar el grupo de aplicaciones. Para obtener ms informacin,
consulte "Configuracin del servidor Web" (p. 137). Tambin necesita los permisos de escritura
adecuados para instalar en el directorio.

Gua de instalacin y configuracin 55

Captulo 4: Configuracin del entorno

56 PowerPlay

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


Las nuevas versiones de IBM Cognos 8 BI PowerPlay contienen mejoras que pueden afectar a varios
componentes, como las caractersticas y funciones, el rendimiento y la escalabilidad y la usabilidad
del producto. Debido a estas mejoras, puede que la actualizacin no sea sencilla y deba considerarse
un proceso que debe realizarse por fases.
Si actualiza IBM Cognos 8 PowerPlay y otros componentes de IBM Cognos 8, consulte IBM Cognos
8 Gua de instalacin y configuracin para obtener informacin sobre la actualizacin de componentes de IBM Cognos 8 como Framework Manager.
Debe tratar la actualizacin cmo un proyecto informtico que requiere una planificacin minuciosa,
recursos y un momento propicio.
Al actualizar, se realizan dos actividades diferentes:
1. Instalacin de la nueva versin del producto.
2. Traslado de aplicaciones a la nueva versin del producto.

Instalacin de la nueva versin del producto


Puede instalar la nueva versin del producto en la misma ubicacin en la que estaba la versin
existente tras desinstalarla o puede instalarla en una nueva ubicacin.
Se recomienda instalarla primero en una nueva ubicacin; por ejemplo, en un entorno de pruebas.
Esto le permitir, al actualizar, probar sus aplicaciones tanto en el entorno antiguo como en el
nuevo para asegurarse que funcionan como esperaba. Puede comparar el aspecto y la funcionalidad
de los informes de ambos entornos para asegurarse de que sean equivalentes.

Traslado de contenido a un nuevo entorno


Como parte del proceso de actualizacin, asegrese de que sus aplicaciones funcionen como esperaba
en la nueva versin. A veces, los cambios pueden comportar resultados no esperados. Es importante
que pruebe las aplicaciones antes de trasladarlas.
En Cognos 8, cuando mueve contenido de un entorno a otro, realiza una implementacin.
En cada una de estas actividades suelen participar distintos grupos. Como parte del proyecto, evale
tanto su entorno informtico actual como las aplicaciones existentes por separado, para asegurarse
de que la infraestructura pueda dar soporte a sus objetivos empresariales.
Si tiene contenido de IBM Cognos Series 7, puede mover parte de dicho contenido a IBM Cognos 8
mediante herramientas de migracin disponibles en una instalacin aparte.
Si utiliza versiones anteriores de ReportNet, Metrics Manager, IBM Cognos 8 Go! Office o Transformer, puede actualizar el contenido a IBM Cognos 8. Tambin puede actualizar desde versiones
anteriores de IBM Cognos 8, incluidas las versiones completas y de mantenimiento (MR).

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

57

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay

Proceso de actualizacin
El siguiente diagrama muestra el enfoque recomendado para la actualizacin. El diagrama muestra
las fases del proceso de actualizacin. Antes de empezar, planifique la actualizacin, evale las
aplicaciones que desee actualizar y cree un entorno de prueba. Implemente y pruebe de forma iterativa
el contenido tanto en el entorno de origen como en el de destino antes de mover con xito las aplicaciones actualizadas a un entorno de produccin.
Flujo de trabajo del proceso de actualizacin
1
Planificacin
de la
actualizacin

Nuevo entorno
3

Entorno de origen
2
Evaluacin de las
aplicaciones

Creacin del nuevo


entorno

4
Proceso de implementacin
Planificacin

Exportacin del
contenido
existente

Copia en un
entorno
nuevo

Importacin del
contenido

Prueba

5
Prueba de las
aplicaciones
actualizadas

6
Paso al entorno de produccin
Preparacin del
entorno

Realizacin de
copias de
seguridad de
los archivos

Desinstalacin

Instalacin de
la nueva
versin

Implementacin
desde el entorno
de prueba

En algunas situaciones de actualizacin, puede que deban efectuarse otras tareas. Por ejemplo, si
utiliza aplicaciones SDK que dependan de las especificaciones del informe, deber actualizar las
aplicaciones SDK antes de actualizar las especificaciones del informe. Si actualiza desde ReportNet
1.1 MR3 o MR4, puede utilizar: Upgrade Manager para automatizar algunas tareas en la fase de
actualizacin de prueba.
Consulte los siguientes temas para obtener informacin sobre la actualizacin:

Planificacin de la actualizacin

Actualizacin a partir de una versin anterior de IBM Cognos 8 PowerPlay

Planificacin de la actualizacin
Se recomienda planificar la actualizacin para saber qu cabe esperar en cada fase del proceso. En
la fase de planificacin, puede consultar la documentacin de actualizacin para informarse sobre
el comportamiento esperado, las nuevas funciones, las funciones descartadas, la compatibilidad
entre versiones y los requisitos para preparar el entorno de produccin. Tras dicha consulta, puede
efectuar un examen del sitio para identificar la infraestructura, las aplicaciones, los informes y los
valores de configuracin personalizados de BI. Por ltimo, puede probar la actualizacin en un

58 PowerPlay

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


subconjunto de datos para poder ajustar los informes y datos antes de llevar a cabo la actualizacin
completa.
El siguiente diagrama muestra una vista de alto nivel de las fases de un proyecto de actualizacin.
Entorno de origen
Planificacin de
la actualizacin

Nuevo entorno

Evaluacin del
contenido

Creacin del
entorno de
prueba

3
Implementacin
del contenido

4
Prueba de las
aplicaciones
actualizadas

5
Paso a la
produccin

Al planificar la actualizacin, asegrese de:

Recopilar la informacin necesaria, como las entradas requeridas y las salidas previstas de cada
fase.

Evaluar las aplicaciones en el entorno de creacin de informes y agrupar los informes similares.

Instalar el nuevo software en un entorno de prueba e implementar el contenido en el entorno


de prueba.

Probar las aplicaciones actualizadas para asegurarse de que los informes se ejecuten segn lo
esperado.

El proceso de implementacin y prueba suele ser iterativo. Evaluar las posibles diferencias entre el
entorno de origen y el entorno de destino para determinar las actividades procesables. Trasldese
a su entorno de produccin cuando compruebe que las aplicaciones implementadas cumplan sus
requisitos empresariales.
Es recomendable que no cambie de proveedores de seguridad, como cambiar de un espacio de
nombre de IBM Cognos Series 7 a Active Directory como parte del proceso de actualizacin. Este
punto debe tratarse como un proyecto aparte.
Asegrese de poseer recursos internos con estas habilidades, o bien utilice recursos externos. Asimismo, piense en el hardware que necesitar antes de empezar.
Utilice la siguiente lista de comprobacin como gua durante el proceso de planificacin:

Consulte la documentacin.

Evale las aplicaciones en el entorno de origen.

Efecte una actualizacin de prueba, que incluya las siguientes tareas:

Crear el entorno de prueba.

Planificar la implementacin del contenido del entorno de origen al entorno de destino.

Crear una especificacin de implementacin de exportacin.

Copiar la especificacin de implementacin en el entorno de prueba.

Incluir objetos de configuracin para la importacin, si es necesario.

Importar la especificacin de implementacin a Cognos 8 en el entorno de prueba.

Probar el contenido actualizado.

Trasladarse al entorno de produccin.


Gua de instalacin y configuracin 59

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay

Consulta de la documentacin
Recibir documentacin de distintas procedencias para ayudarle a lograr una correcta actualizacin.
Toda la documentacin est disponible en lnea en el centro de recursos de IBM Cognos (http://
www.ibm.com/software/data/support/cognos_crc.html).

Pasos
1. Lea la seccin "Novedades" de esta gua.
Encontrar una lista con las funciones nuevas, modificadas, descartadas y eliminadas de esta
versin.
2. Lea el resto de la informacin de actualizacin de este documento.
3. Lea el tema sobre IBM Cognos 8 con otros productos IBM Cognos (p. 32).
Encontrar informacin sobre otros productos IBM Cognos que quiz tenga en el entorno y
que deben tenerse en cuenta en la actualizacin.
4. Desde el enlace Documentation del centro de recursos de IBM Cognos (http://www.ibm.com/
software/data/support/cognos_crc.html), descargue y consulte las versiones ms recientes de la
siguiente documentacin:

Documento

Descripcin

IBM Cognos 8 PowerPlay


Readme

Temas recientes que pueden afectar a una actualizacin

IBM Cognos 8 Gua de funcio- Nuevas funciones que pueden afectar al comportamiento del
nes nuevas
contenido existente
Framework Manager User
Guide

Actualizacin de modelos

Report Studio Professional


Authoring Gua del usuario

Actualizacin de informes

IBM Cognos 8 Transformer


User Guide

Actualizacin de las vistas de usuario y actualizacin de los


modelos IBM Cognos Series 7

IBM Cognos 8 Migration and Traslado de metadatos, catlogos e informes de Impromptu,


Upgrade Tools User Guide
informes de PowerPlay y contenido de Upfront de IBM Cognos
Series 7 a IBM Cognos 8
Upgrade Manager User Guide Uso de Upgrade Manager para auditar actualizaciones de
prueba de ReportNet 1.1 MR3 o MR4 a Cognos 8.2 o posterior

60 PowerPlay

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay

Documento

Descripcin

IBM Cognos 8 SDK Developer Guide

Actualizacin de aplicaciones SDK

Recomendacin: evaluar las aplicaciones en el entorno de origen


El hecho de prepararse para una actualizacin supone una oportunidad para revisar la inversin
de BI actual y limpiar el entorno de origen. Realice inventario de sus aplicaciones de BI para
detectar los puntos fuertes, los puntos dbiles y las reas que se pueden mejorar del entorno.
Por ejemplo, puede que tenga cientos de informes, paquetes, aplicaciones y carpetas pblicas en el
entorno. No obstante, a veces se descubre que varias aplicaciones no se utilizan, han dejado de
cumplir los requisitos de la compaa o no funcionan en los entornos de origen.
Le recomendamos que realice una auditora de sus aplicaciones para determinar cules deben
actualizarse. Evaluar y reducir el nmero de informes es un ejercicio til. No se fe nicamente de
los comentarios de los usuarios para determinar qu contenido debe utilizarse.
Una auditora de las aplicaciones existentes puede comportar lo siguiente:

Realice un estudio del sitio.


Un estudio le ayudar a evaluar el entorno de produccin actual y a identificar las reas que
requieren atencin durante una actualizacin. El estudio del sitio debe incluir informacin sobre
la infraestructura, las aplicaciones, los usuarios y los valores de configuracin de los productos
Cognos 8.

Evale el software que utiliza en la aplicacin de creacin de informes.


Haga una lista del software: sistemas operativos, servidores Web, seguridad, bases de datos,
etc. Compare la lista de las versiones compatibles para su versin actualizada objetivo, disponible desde los enlaces Informacin de produccin, Entornos de software del centro de servicio
al cliente de IBM Cognos (http://www.ibm.com/software/data/support/cognos_crc.html).
Determine si hay que actualizar algn componente.

Haga una lista de las aplicaciones BI, que incluya lo siguiente:

Modelos de Framework Manager

Paquetes publicados

Informes

Modelos de Transformer

Aplicaciones SDK y sus dependencias

Lleve a cabo una evaluacin minuciosa de las aplicaciones.


El uso, la antigedad, el tamao y la complejidad de las aplicaciones son factores importantes
que deben tenerse en cuenta al planificar la actualizacin. El tamao total de las aplicaciones
puede afectar el tiempo necesario para realizar la actualizacin.

Gua de instalacin y configuracin 61

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay

Haga una lista de todos los informes de la aplicacin y haga lo siguiente:

Pregunte a los miembros del equipo para saber qu cubos, vistas o informes se necesitan y
se utilizan, cules pueden consolidarse y cules eliminarse. Utilice datos de informe de
auditora para determinar el uso de informes.
Actualice solamente los informes que funcionen y que los usuarios necesiten y utilicen. Esto
reducir el nmero de aplicaciones que deber actualizar.
Para obtener ms informacin acerca de los informes de auditora, consulte la Gua de
administracin y seguridad.

Consulte la finalidad de cada informe y asigne una prioridad.


Esto identifica las aplicaciones fundamentales para el negocio y la funcionalidad necesaria
en el nuevo entorno.

Marque los informes que no se puedan ejecutar o validar en el entorno actual.


Es poco probable que se actualicen correctamente. Repare estos informes para que se
actualicen.

Considere la posibilidad de retirar los informes que no se haya utilizado o que se hayan
utilizado poco.

Agrupe los informes en categoras, como actualizar, eliminar, dejado de usar y no actualizar.

Haga una lista de la siguiente informacin sobre la configuracin:

Valores de configuracin que ha habilitado utilizando IBM Cognos Configuration


Estos valores se conservan durante la actualizacin. Se almacenan en dos archivos. En el
caso de ReportNet v1.1, los archivos son crnstartup.xml y crnlocale.xml. En el caso de
IBM Cognos 8, los archivos son cogstartup.xml y coglocale.xml.

Cambios en otros archivos de configuracin


Los cambios en otros archivos deben realizarse manualmente durante la actualizacin. Si
ha cambiado otros archivos de configuracin, debe evaluar los cambios que desee conservar
en el entorno actualizado. Esto puede incluir archivos .xml, .txt y .css en los directorios de
configuracin, plantillas, aplicaciones Web y contenido Web de la ubicacin de instalacin.
Importante: No se admiten cambios en los archivos .ini. Si ha cambiado archivos .ini,
pngase en contacto con el servicio de asistencia al cliente.

Haga una copia de seguridad de todos los informes, modelos y datos y archivos de configuracin.

Cree un plan de actualizacin.

Recomendacin: realizar una actualizacin de prueba


Los proyectos de actualizacin pilotos son ejercicios valiosos y prcticos ya que garantizan que la
actualizacin produzca el resultado previsto y requerido. Asimismo, la evaluacin del proyecto
piloto garantiza que la actualizacin sea correcta. Si se producen resultados inesperados, puede

62 PowerPlay

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


determinar si las diferencias son mejoras para su situacin o si hay que emprender alguna accin
para mitigar las diferencias.
Al actualizar, las aplicaciones suelen funcionar en el nuevo entorno con poca intervencin o sin
necesidad de ella. Ejecutando una actualizacin piloto puede validar informes seleccionados para
ver si se producen los resultados previstos.
Le recomendamos que realice una actualizacin de prueba varias semanas antes de actualizar el
sistema de produccin. La actualizacin de prueba identifica los componentes que se actualizarn
con el mnimo esfuerzo y los componentes que quiz requerirn acciones adicionales antes o despus
de la actualizacin.
Normalmente, se actualiza un conjunto de ejemplo de informes en un entorno aislado, y luego se
compara el aspecto y el comportamiento de los informes antes y despus de la actualizacin.
Asegrese de disponer de recursos capacitados para realizar las tareas de migracin, especialmente
para aplicaciones de gran importancia. Asimismo, pruebe y depure todas las aplicaciones antes de
la implementacin.

Creacin del entorno de prueba


Cree un entorno de prueba para el nuevo software como preparacin para las actualizaciones de
prueba.
Inicialmente, no es necesario que el nuevo entorno sea grande, ni que sea el mismo que el entorno
de produccin. Por ejemplo, si es aceptable, puede utilizar hardware de entornos ya existentes,
como servidores de desarrollo.
El entorno se puede escalar por fases una vez que el nuevo entorno bsico est creado y en funcionamiento.
Otra posibilidad es dejar intactos los entornos existentes. Si desea que el entorno de prueba se
convierta en el nuevo entorno de produccin, configure el sistema de prueba para que se adapte al
entorno de produccin.

Pasos
1. Asegrese de poseer toda la infraestructura.
2. Revise los entornos compatibles.
3. Instale el nuevo software en el entorno de prueba.
El hecho de tener la nueva versin del software en una ubicacin distinta a la de la versin
anterior garantiza que se ejecuten ambas versiones al mismo tiempo y confirma que las aplicaciones funcionan correctamente en ambos entornos.
Para obtener ms informacin sobre cmo realizar una instalacin bsica, consulte "Instalacin
y configuracin de IBM Cognos 8 PowerPlay en un equipo" (p. 79).
Una vez instalado el software, utilice el proceso de implementacin para actualizar el contenido.
Para obtener ms informacin, consulte la ayuda en lnea de IBM Cognos Administration Console.

Gua de instalacin y configuracin 63

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay

Planificacin de la implementacin
La implementacin supone mover aplicaciones de una instalacin a otra. En Cognos 8, se implementan paquetes, carpetas de nivel superior o todo el almacn de contenido de un entorno de origen
a un entorno de destino.
Al realizar la implementacin, debe considerar cmo gestionar la seguridad y si implementar todo
el almacn de contenido o slo determinados paquetes, carpetas y contenido de directorio seleccionados. Otros puntos que tener en cuenta estn relacionados con la base de datos utilizada para el
almacn de contenido, los informes de separacin y la propiedad de las entradas.
Para obtener ms informacin sobre cmo planificar la implementacin de contenido en un nuevo
entorno, consulte la ayuda en lnea de la consola Administration.
El siguiente diagrama resume el proceso de implementacin.
Flujo de trabajo del proceso de implementacin
4
Proceso de implementacin
Planificacin

Exportacin
del contenido
existente

Importacin
del contenido

Copia en un
entorno nuevo

Prueba

5
Prueba de las
aplicaciones
actualizadas

Seguridad
Antes de la implementacin, debe considerar los permisos de acceso y la seguridad de los archivos
de implementacin.
Para implementar las entradas de IBM Cognos Connection, debe tener los siguientes permisos:

Permisos de ejecucin para la caracterstica protegida Tareas de administracin.

Permisos de visita para la caracterstica protegida Administracin.

Tambin le recomendamos que pertenezca al grupo Administradores del sistema y que tenga acceso
de lectura y escritura al espacio de nombre de Cognos para que pueda implementar el grupo
Administradores del sistema.
Para obtener ms informacin sobre cmo implementar los grupos y los roles de IBM Cognos,
consulte la ayuda en lnea en la consola IBM Cognos Administration.

Referencias a espacios de nombre


Algunas entradas, como los grupos, los roles, las listas de distribucin, los contactos, los inicios de
sesin de orgenes de datos, as como algunas propiedades de informes, como los destinatarios de
los correos electrnicos y los contactos del informe, pueden hacer referencia a entidades en espacios
de nombre o proveedores de autenticacin. Al implementar carpetas pblicas y contenido de
directorio, puede implementar estas entradas con o sin las referencias a terceros.

Implementacin de todo el almacn de contenido


La implementacin de todo el almacn de contenido garantiza que todos los paquetes, carpetas y
contenido de directorio se copien en la nueva ubicacin. Por ejemplo, si cambia el equipo en el que

64 PowerPlay

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


est instalado el IBM Cognos 8, puede mover todo el almacn de contenido del antiguo entorno al
nuevo y conservar todos los informes y otras entradas creadas por los administradores y los usuarios.
Al importar todo un almacn de contenido, los datos de configuracin se incluyen en la exportacin,
pero quedan excluidos de la importacin de forma predeterminada. Le recomendamos que no
cambie este ajuste. Sin embargo, si tiene que importar valores de configuracin (p. 68), puede
cambiar la opcin predeterminada en Configuracin avanzada.

Implementacin de carpetas pblicas y contenido de directorio seleccionados


Si lo desea, puede realizar una implementacin parcial e implementar nicamente las carpetas
pblicas y el contenido de directorio seleccionados.
Para elegir los paquetes y las carpetas que desee implementar, examine la jerarqua de Carpetas
pblicas y seleccione un paquete o una carpeta. Una vez que haya seleccionado un paquete o una
carpeta, se implementar su contenido. No se pueden seleccionar entradas concretas en los paquetes
ni en las carpetas. Durante la exportacin, los paquetes y las carpetas principales no se exportan y
Content Manager tampoco crea ubicaciones de marcadores en el entorno de destino. Tanto durante
la exportacin como la importacin, puede especificar una nueva ubicacin de destino en la jerarqua
de Content Manager para cada carpeta y paquete implementados.
Al realizar una exportacin parcial de carpetas pblicas y contenido de directorio, debe tener los
siguientes permisos:

Permisos de lectura y visita para las entradas que exporte.

Permisos de escritura, ya que al exportar crea una especificacin de implementacin y un historial


de implementacin.

Permisos de escritura y de establecimiento de directivas para las entradas que importe.

Implementacin de paquetes
Un paquete es una entrada que contiene metadatos e informes publicados. Los paquetes se guardan
en el almacn de contenido y aparecen como entradas en IBM Cognos Connection.
Durante una implantacin parcial, puede implementar uno o varios paquetes a la vez. Un paquete
puede hacer referencia a objetos que se encuentren fuera del paquete, como objetos de seguridad,
orgenes de datos y listas de distribucin. Los objetos referenciados, sin embargo, no se implementan
con el paquete.

Creacin de una especificacin de implementacin de exportacin


Una vez planificada la implementacin, el primer paso al mover contenido de una instalacin a otra
es exportar el almacn de contenido o las entradas que desee conservar en el nuevo entorno. Para
ello, hay que crear una especificacin de implementacin de exportacin en el entorno de origen.
Las entradas se exportan a un archivo de implementacin de exportacin del entorno de origen.
Posteriormente, las entradas del archivo se importan al entorno de destino. Puede actualizar las
entradas en el entorno de destino mediante las entradas del archivo de implementacin.

Gua de instalacin y configuracin 65

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


Se recomienda detener el servicio de Cognos 8 antes de exportar e importar.

Pasos para crear una nueva especificacin de implementacin de exportacin para el


almacn de contenido
1. En IBM Cognos Administration, en la pestaa Configuracin, haga clic en Administracin de
contenido.
2. En la barra de herramientas, haga clic en el botn Nueva exportacin

y siga las instrucciones

del asistente de Nueva exportacin.


3. Para exportar todo el almacn de contenido, haga clic en Seleccionar todo el almacn de contenido y seleccione si desea incluir informacin de cuenta de usuario.
4. Haga clic en Siguiente.
5. Si desea proteger el archivo, en Codificacin, haga clic en Establecer la contrasea de codificacin, escriba una contrasea, haga clic en Aceptar y haga clic en Siguiente.
Aparecer la informacin de resumen.
6. Revise la informacin de resumen y haga clic en Siguiente.
Sugerencia: Si desea cambiar alguna informacin, haga clic en Atrs y siga las instrucciones.
7. Establezca cmo quiere ejecutar la exportacin seleccionando la accin que desee.
Despus de ejecutar la exportacin, puede mover el archivo de implementacin. Tambin puede
ver el historial de la ejecucin de la exportacin.

Pasos para crear una nueva especificacin de implementacin de exportacin para


implementaciones parciales
1. En IBM Cognos Administration, en la pestaa Configuracin, haga clic en Administracin de
contenido.
2. En la barra de herramientas, haga clic en el botn Nueva exportacin

y siga las instrucciones

del asistente de Nueva exportacin.


3. Para exportar carpetas y contenido de directorio especficos, haga clic en Seleccionar carpetas
pblicas y contenido de directorio y luego en Siguiente.
4. En la pgina Seleccionar el contenido de las carpetas pblicas, haga clic en Aadir.
5. En la pgina Seleccionar entradas, en el cuadro Entradas disponibles, seleccione los paquetes
o las carpetas que desee exportar.
Examine la jerarqua de Carpetas pblicas y elija los paquetes y las carpetas que desee. Haga
clic en el botn de la flecha derecha

para mover los elementos seleccionados al cuadro

Entradas seleccionadas y, a continuacin, haga clic en Aceptar.


6. Para cada paquete y carpeta que exporte, haga lo siguiente:

66 PowerPlay

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay

Si desea realizar algn cambio en el paquete o la carpeta en el entorno de destino, haga clic
en el icono Editar

, realice los cambios correspondientes y luego haga clic en Aceptar.

Para restringir el acceso al paquete o la carpeta y a sus entradas, seleccione la casilla de


verificacin de la columna Deshabilitar despus de importacin. Esto es til cuando quiere
probar los informes antes de hacer que estn disponibles en el entorno de destino.

7. En Opciones, seleccione si desea incluir las versiones de salida de informe, el historial de ejecucin
y las planificaciones, e indique qu hay que hacer con las entradas en caso de conflicto; a continuacin, haga clic en Siguiente.
8. En la pgina Seleccionar el contenido de directorio, seleccione si desea exportar los grupos y
los roles, las listas de distribucin y los contactos, los orgenes de datos y las conexiones de
IBM Cognos e indique qu hacer con las entradas en caso de conflictos; a continuacin, haga
clic en Siguiente.
9. En la pgina Especificar las opciones generales, seleccione si desea incluir permisos de acceso
e indique quin debe poseer las entradas una vez que stas se hayan importado al entorno de
destino.
10. Especifique el Nivel de grabacin del historial de implementacin y luego haga clic en Siguiente.
11. En la pgina Especificar un archivo de implementacin, en Archivo de implementacin, seleccione
un archivo de implementacin existente de la lista o bien escriba un nuevo nombre para crear
uno.
Si escribe un nuevo nombre para el archivo de implementacin, le recomendamos que dicho
nombre no contenga espacios en blanco. Si el nombre de la especificacin de implementacin
nueva coincide con el nombre del archivo de implementacin existente, se sobrescribir el
archivo de implementacin actual.
12. Si desea proteger el archivo, en Codificacin, haga clic en Establecer la contrasea de codificacin, escriba una contrasea y haga clic en Aceptar.
13. Haga clic en Siguiente.
Aparecer la informacin de resumen.
14. Revise la informacin de resumen y haga clic en Siguiente.
Sugerencia: Si desea cambiar alguna informacin, haga clic en Atrs y siga las instrucciones.
15. Establezca cmo quiere ejecutar la exportacin seleccionando la accin que desee.
Despus de ejecutar la exportacin, puede mover el archivo de implementacin. Tambin puede
ver el historial de la ejecucin de la exportacin.

Pasos para ejecutar una exportacin


1. En la columna Acciones, haga clic en el botn Ejecutar con opciones

2. Haga clic en Ahora para ejecutar la exportacin inmediatamente o haga clic en Ms adelante
e introduzca la hora a la que desee ejecutarla.

Gua de instalacin y configuracin 67

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


Tambin puede planificar una tarea para que se ejecute peridicamente y ver una lista de las
tareas planificadas utilizando la herramienta Administracin de planificaciones.
Ahora puede mover el archivo de implementacin.

Copia de la especificacin de implementacin en el entorno de prueba


Mueva el archivo de implementacin creado en el entorno de origen al entorno de prueba. Posteriormente, utilizar el archivo de implementacin para importar entradas al entorno de destino.
Si el entorno de origen y de prueba utilizan el mismo almacn de contenido, puede importar sin
mover el archivo de implementacin.
La ubicacin predeterminada es ubicacin_c8\deployment.
Si tiene previsto mover el archivo de implementacin a una ubicacin de una LAN, asegrese de
que haya suficiente espacio en el disco. Si no ha codificado el archivo de implementacin, le recomendamos que lo copie en una ubicacin protegida.

Pasos para copiar la especificacin de implementacin


1. Copie la especificacin de implementacin del entorno de origen en una ubicacin LAN o en
un CD.
2. Copie la especificacin de implementacin de la LAN o el CD en la ubicacin del entorno de
prueba especificada en la herramienta de configuracin.
Ahora puede incluir objetos de configuracin si importa todo un almacn de contenido o importar
al entorno de destino.

Inclusin de objetos de configuracin en la importacin de todo el almacn de


contenido
Al importar todo un almacn de contenido, puede incluir objetos de configuracin. Por ejemplo,
puede que quiera importar la configuracin porque tiene una serie de ajustes avanzados para sus
servicios que desea del entorno de origen.
De forma predeterminada, los objetos de configuracin se excluyen al importar todo un almacn
de contenido, aunque se incluyan en la exportacin. Los objetos de configuracin incluyen distribuidores y carpetas de configuracin para agrupar los distribuidores.

Pasos
1. En IBM Cognos Administration, en la pestaa Configuracin, haga clic en Distribuidores y
servicios.
2. Haga clic en el distribuidor que desee.
3. Junto a ContentManagerService, haga clic en el botn Establecer propiedades.
4. Haga clic en la pestaa Configuracin.
5. En la columna Valor, haga clic en Editar.

68 PowerPlay

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


6. Seleccione la casilla de verificacin Reemplazar la configuracin adquirida de la entrada principal.
7. En la columna Parmetro que aparecer, escriba en maysculas lo siguiente:
CM.DEPLOYMENTINCLUDECONFIGURATION
8. En la columna Valor, escriba true.
9. Haga clic en Aceptar para terminar.

Importacin al entorno de prueba


Se pueden importar entradas del archivo de implementacin al entorno de destino. Para importar
dichas entradas, debe crear una especificacin de implementacin de importacin.
Al importar, seleccione una de las entradas que se han exportado. Puede aceptar las opciones predeterminadas establecidas durante la exportacin o bien cambiarlas. Slo puede seleccionar las
opciones que se incluyeron en el archivo de implementacin durante la exportacin.
Si realiza una implementacin parcial de carpetas pblicas y contenido de directorio especficos, el
asistente de importacin muestra si los paquetes y las carpetas ya existen en el entorno de destino
y la fecha y la hora de su ltima modificacin. Esta informacin puede resultarle til a la hora de
decidir cmo resolver los conflictos. Al realizar una nueva implementacin, el asistente tambin
muestra si los paquetes y las carpetas estaban en la implementacin original.

Pasos para importar una especificacin de implementacin


1. En el entorno de destino, en IBM Cognos Administration, en la pestaa Configuracin, haga
clic en Administracin de contenido.
2. En la barra de herramientas, haga clic en el botn Nueva importacin

Aparecer el asistente para Nueva importacin.


3. En el cuadro Archivo de implementacin, haga clic en el archivo de implementacin que desee
importar.
4. Si el archivo de implementacin est codificado, escriba la contrasea y haga clic en Aceptar.
5. Haga clic en Siguiente.
6. Escriba un nombre nico y una descripcin y una sugerencia opcionales para la especificacin
de implementacin, seleccione la carpeta en la que desea guardarla y haga clic en Siguiente.
7. Seleccione el contenido que desee incluir en la importacin.
Sugerencia: Para asegurarse de que el paquete o la carpeta de destino requeridos existen en el
almacn de contenido de destino, haga clic en el botn Editar
situado junto al paquete y
compruebe la ubicacin. Si lo desea, puede cambiar ahora la ubicacin de destino.
8. Seleccione las opciones que desee, junto con la manera de resolver los conflictos para las
opciones que seleccione.

Gua de instalacin y configuracin 69

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


9. En la pgina Especificar las opciones generales, seleccione si desea incluir permisos de acceso
e indique quin debe poseer las entradas una vez que stas se hayan importado al entorno de
destino.
10. Especifique el Nivel de grabacin del historial de implementacin.
11. Haga clic en Siguiente.
Aparecer la informacin de resumen.
12. Revise la informacin de resumen y haga clic en Siguiente.
13. Establezca cmo quiere ejecutar la importacin seleccionando la accin que desee.
Despus de ejecutar la importacin, puede probar la implementacin.

Pasos para ejecutar una importacin


1. En la columna Acciones, haga clic en el botn Ejecutar con opciones

2. Haga clic en Ahora para ejecutar la importacin inmediatamente o haga clic en Ms adelante
e introduzca la hora a la que desee ejecutarla.
3. Si desea actualizar las especificaciones de informe, haga clic en Actualizar todas las especificaciones de informe a la ltima versin.
Tambin puede utilizar la herramienta Administracin de planificaciones para planificar una
tarea para que se ejecute de forma recurrente y ver una lista de las tareas planificadas.
Ahora puede probar la implementacin.

Prueba del contenido implementado


Despus de importar los paquetes del archivo de implementacin, puede comprobar que todas las
entradas se hayan implementado correctamente en el entorno de destino.
Puede probar la implementacin realizando lo siguiente:

Revise el historial de ejecucin de la implantacin.

Asegrese de que se hayan importado los paquetes y las carpetas correctos, junto con su contenido.

Ejecute informes importados y vistas de informe.

Para obtener ms informacin, consulte la ayuda en lnea de IBM Cognos Administration Console.

Recomendacin: probar el contenido actualizado


Despus de importar los paquetes del archivo de implementacin, puede comprobar que todas las
entradas se hayan implementado correctamente en el entorno de destino.
Le recomendamos que pruebe el contenido actualizado de la siguiente manera:

Pruebe los informes de la siguiente manera:

70 PowerPlay

En PowerPlay Studio, valide cada informe y anote si la validacin ha sido correcta.

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


Puede descargar Upgrade Manager del sitio Web de Cognos Software Services para que le ayude
con la prueba. Upgrade Manager es una herramienta de verificacin que comprueba que los
informes se ejecuten y produzcan los mismos resultados en el nuevo entorno.

Pruebe los modelos y los PowerCubes en Cognos 8 Transformer, si es necesario:

Abra los modelos con las opciones de seguridad adecuadas y gurdelos.

Pruebe los PowerCubes.

Pruebe los modelos en Framework Manager.


En Framework Manager para IBM Cognos 8 puede utilizar los mismos modelos y proyectos
que utiliz con la versin anterior. Al actualizar los modelos, el proceso de validacin produce
errores para cada modelo. Para actualizar un proyecto, bralo y gurdelo en la nueva versin
de Framework Manager. Para obtener ms informacin, consulte Framework Manager User
Guide.

Repare o excluya los informes y los modelos que no funcionen correctamente.

Pruebe los informes y los modelos reparados ejecutndolos de nuevo en el sistema de prueba.
Subsane los problemas que pueda haber y pngase en contacto con Cognos Software Services
para los problemas de actualizacin sin solucionar.

Revise el plan de actualizacin para incluir adaptaciones hechas durante la actualizacin de


prueba.

Para obtener ms informacin, consulte la ayuda en lnea de IBM Cognos Administration Console.

Paso al entorno de produccin


Una vez que se hayan resuelto todos los problemas hallados durante la actualizacin de prueba, ya
estar listo para empezar la actualizacin completa en el entorno de produccin. En el plan de
actualizacin encontrar informacin sobre cada uno de los pasos de la actualizacin completa.
El siguiente diagrama muestra los pasos de alto nivel del proceso de mover aplicaciones actualizadas
a un entorno de produccin. Despus de preparar el entorno de produccin y de realizar una copia
de seguridad de los archivos de datos y de configuracin, puede desinstalar la versin antigua del
software e instalar la nueva versin en la misma ubicacin. Luego, puede implementar el contenido
procedente del entorno de prueba.
6
Paso al entorno de produccin
Preparacin
del entorno

Realizacin de
copias de
seguridad de
los archivos

Desinstalacin

Instalacin
de la nueva
versin

Implementacin
desde el entorno
de prueba

Si desea aprovechar los recursos de que dispone y realizar la actualizacin en el mismo directorio,
primero deber realizar una copia de seguridad de los datos de configuracin, asegurarse de que
ha realizado una copia de seguridad de los proyectos de Framework Manager y de que stos estn

Gua de instalacin y configuracin 71

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


marcados en un sistema de control del cdigo fuente (si procede) y desinstalar la versin antigua
de IBM Cognos 8.
Utilice la siguiente lista de comprobacin como gua durante el proceso de traslado a un entorno
de produccin:

Prepare el entorno de produccin.

Realice una copia de seguridad de los archivos y los datos.


Puede que tenga archivos modificados distintos a los de la carpeta de configuracin. Se
recomienda encarecidamente realizar una copia de seguridad de todo el directorio de instalacin.
Cuando realice la copia de seguridad de los datos de configuracin, gurdela en un directorio protegido. Debe proteger el directorio de accesos no autorizados o no adecuados.

Instale el sistema de la nueva versin en el entorno de produccin.


Si instala el nuevo software del entorno de prueba en la misma ubicacin del software ya
existente, antes deber desinstalar el software ya existente.

Configure el sistema.

Configure manualmente la personalizacin.

Si edit manualmente algn archivo de configuracin, los cambios de sobrescribirn durante


la actualizacin. Deber volver a aplicar los cambios. Lleve un registro de cualquier personalizacin para asegurarse de que pueda aplicarse de nuevo tras la actualizacin. Asimismo,
realice una copia de seguridad de estos archivos para poder restaurar la versin original si
es necesario.

El servicio de presentacin de IBM Cognos 8 admite la actualizacin automtica de algunos


archivos system.xml. Si ha realizado muchos cambios de personalizacin en los archivos
system.xml, puede utilizar esta funcin de actualizacin automtica en lugar de volver a
aplicar los cambios manualmente despus de la actualizacin. Los archivos system.xml se
sobrescriben durante la instalacin de IBM Cognos 8. As pues, deber realizar una copia
de seguridad de las versiones personalizadas de dichos archivos y luego copiarlos en el
directorio tras actualizar IBM Cognos 8. La actualizacin automtica se aplicar cuando
inicie el servicio de IBM Cognos 8.

Los archivos system.xml compatibles con la actualizacin automtica se encuentran en los


siguientes directorios:
ubicacin_c8/templates/ps
ubicacin_c8/templates/ps/portal
ubicacin_c8/templates/ps/qs

72 PowerPlay

Nota: El mtodo recomendado para actualizar los archivos personalizados es volver a


aplicar los cambios manualmente despus de instalar el nuevo software. Utilice la actualizacin automtica de los archivos system.xml slo cuando haya realizado un gran nmero
de personalizaciones en dichos archivos.

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay

Implemente la aplicacin en el sistema de produccin.


Al actualizar, puede exportar todo el almacn de contenido a un archivo de implementacin
y, a continuacin, importar el archivo de implementacin a IBM Cognos 8 tras actualizar el
software.

Implemente los informes y los modelos del sistema de prueba al sistema de produccin.

Actualizacin a partir de una versin anterior de IBM Cognos 8


PowerPlay
Para pasar de una versin anterior a una nueva versin de IBM Cognos 8 PowerPlay, debe actualizar
el software. Debe actualizar todos los componentes. Los componentes de versiones distintas no son
compatibles. Si utiliza IBM Cognos Series 7 PowerCubes como origen de datos, no es necesario
actualizar Transformer, a menos que desee utilizar las funciones de la nueva versin de Transformer.
Los PowerCubes creados mediante IBM Cognos Series 7.3 Transformer (o posterior) e IBM Cognos 8.3 Transformer (o posterior) son compatibles con la creacin de informes y los indicadores
de IBM Cognos 8.
Puede ejecutar distintas versiones del software al mismo tiempo en el equipo, siempre que las instale
en directorios distintos y las configure para que cada una utilice un almacn de contenido distinto
y un conjunto de puertos y URL distintos para cada versin.
Antes de empezar a actualizar, debe planificar la estrategia de actualizacin (p. 58). Esta estrategia
depende de los datos que desee utilizar y de las posibles personalizaciones que haya realizado en la
configuracin existente.
Despus de actualizar a IBM Cognos 8 utilizando los datos existentes, es posible que deba efectuar
alguna configuracin ms si quiere utilizar nuevas funciones. Para obtener informacin sobre las
nuevas funciones de IBM Cognos 8, consulte IBM Cognos 8 Gua de funciones nuevas.

Actualizacin a partir de una versin anterior de IBM Cognos 8 PowerPlay


Puede actualizar IBM Cognos 8 Powerplay en el mismo directorio que la versin anterior o en un
directorio diferente, en funcin de en qu parte del proceso se encuentre. Por ejemplo, si va a configurar el entorno de prueba, la instalacin se realiza en un directorio nuevo. Si ha acabado de
probar las aplicaciones y desea actualizar el software en el entorno de produccin, la instalacin
se realiza en el mismo directorio.
Si desea actualizar IBM Cognos 8 en el mismo directorio, primero deber realizar una copia de
seguridad de los datos, asegurarse de que los proyectos de Framework Manager no estn marcados
en un sistema de control del cdigo fuente y desinstalar la versin antigua de IBM Cognos 8. Para
obtener instrucciones completas, consulte los pasos para la instalacin en el mismo directorio.
Si realiza la instalacin en un nuevo equipo, consulte los pasos para la instalacin en un nuevo
directorio.
Cuando realice la copia de seguridad de los datos de configuracin, gurdela en un directorio protegido. El directorio debe estar protegido de accesos no autorizados o no adecuados.

Gua de instalacin y configuracin 73

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


Otro mtodo de actualizacin sera exportar todo el almacn de contenido a un archivo de implementacin y luego importar el archivo de implementacin a IBM Cognos 8 tras la actualizacin.
Para obtener ms informacin sobre la implementacin, consulte la Gua de administracin y
seguridad. Es necesaria una actualizacin de la implementacin si desea cambiar el tipo de base de
datos utilizado para el almacn de contenido. Si utiliza el mtodo de actualizacin de la implementacin, slo difieren los pasos para exportar y restaurar los datos de configuracin. Todos los dems
pasos son iguales a los descritos en esta seccin.
Al realizar la actualizacin, el administrador del informe dejar de tener acceso a la herramienta
Administracin de contenido. El administrador del informe no podr crear definiciones de implementacin en IBM Cognos 8.

Archivos de IBM Cognos 8 personalizados


Si edit manualmente algn archivo de configuracin, los cambios de sobrescribirn durante la
actualizacin. Deber volver a aplicar los cambios. Lleve un registro de cualquier personalizacin
para asegurarse de que pueda aplicarse de nuevo tras la actualizacin. Asimismo, realice una copia
de seguridad de estos archivos para poder restaurar la versin original si es necesario.
Puede que tenga archivos modificados distintos a los de la carpeta de configuracin. Si es as, tambin
debe realizar una copia de seguridad de los archivos adicionales antes de la actualizacin.
El servicio de presentacin de IBM Cognos 8 admite la actualizacin automtica de algunos archivos
system.xml. Si ha realizado muchos cambios de personalizacin en los archivos system.xml, puede
utilizar esta funcin de actualizacin automtica en lugar de volver a aplicar los cambios manualmente despus de la actualizacin. Los archivos system.xml se sobrescriben durante la instalacin
de IBM Cognos 8. As pues, deber realizar una copia de seguridad de las versiones personalizadas
de dichos archivos y luego copiarlos en el directorio tras actualizar IBM Cognos 8. La actualizacin
automtica se aplicar cuando inicie el servicio de IBM Cognos 8.
Los archivos system.xml compatibles con la actualizacin automtica se encuentran en los
siguientes directorios:

ubicacin_c8/templates/ps

ubicacin_c8/templates/ps/portal

ubicacin_c8/templates/ps/qs

Nota: El mtodo recomendado para actualizar los archivos personalizados es volver a aplicar los
cambios manualmente despus de instalar el nuevo software. Utilice la actualizacin automtica
de los archivos system.xml slo cuando haya realizado un gran nmero de personalizaciones en
dichos archivos.

Pasos para la instalacin en el mismo directorio


1. Realice una copia de seguridad de la base de datos del almacn de contenido existente con las
herramientas de la base de datos.
Para obtener informacin sobre este tema, consulte la documentacin de la base de datos.
2. Realice una copia de seguridad de los siguientes archivos en una ubicacin protegida:

74 PowerPlay

cogstartup.xml y coglocale.xml en el directorio ubicacin_c8/configuration

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay

server.xml en el directorio ubicacin_c8/tomcat4.1.27/conf

system.xml en el directorio correspondiente, si es necesario

No olvide anotar la ruta de acceso al directorio. Por ejemplo:


ubicacin_c8/templates/ps
3. En IBM Cognos Configuration, exporte los datos de configuracin a la misma ubicacin protegida.
Para que los datos puedan utilizarse para la actualizacin, denomine el archivo cogstartup.xml.
Importante: Debido a que el archivo crnstartup.xml exportado contiene contraseas sin codificar,
asegrese de que la ubicacin est protegida.
4. Realice una copia de seguridad de cualquier archivo editado manualmente que haya en ubicacin_c8/configuration y en otros directorios y gurdela en una ubicacin protegida.
5. Detenga todos los servicios IBM Cognos.
6. Desinstale IBM Cognos 8 PowerPlay de todos los equipos IBM Cognos 8 PowerPlay.
7. Instale la versin ms reciente de IBM Cognos 8 PowerPlay en el mismo directorio que utiliz
para IBM Cognos 8 PowerPlay en todos los equipos.
8. En cuanto a los archivos que edit manualmente en versiones anteriores de IBM Cognos 8,
edite los mismos archivos en el directorio ubicacin_c8 y vuelva a aplicar los cambios que
realiz en los archivos personalizados originales.
No copie los archivos personalizados de la ubicacin de copia de seguridad en los directorios
ubicacin_c8. Las versiones anteriores de estos archivos puede que no sean compatibles.
9. Si utiliza Oracle para un origen de datos, un origen de importacin, una base de datos de
registro o la base de datos del almacn de contenido, elimine el archivo classes12.jar del directorio ubicacin_c8\webapps\p2pd\WEB-INF\lib.
Las versiones ms antiguas de IBM Cognos 8 utilizaban este archivo, que entra en conflicto
con el archivo ojdbc14.jar (o, para Oracle 11g, ojdbc5.jar) utilizado en las versiones ms
recientes.
10. En IBM Cognos Configuration, revise la configuracin y luego gurdela.
Al guardar la configuracin, aparecer un cuadro de dilogo de actualizacin en el que se le
preguntar si desea actualizar las especificaciones de informe. El ajuste predeterminado es no
actualizar las especificaciones de informe.
Importante: No actualice las especificaciones de informe si tiene aplicaciones SDK que creen,
modifiquen o guarden especificaciones de informe. Primero debe actualizar las aplicaciones
SDK para que sean compatibles con el esquema de especificaciones de informe de IBM Cognos 8.
De lo contrario, es posible que las aplicaciones SDK no puedan acceder a las especificaciones
de informe actualizadas. Asimismo, no guarde los informes hasta que se hayan actualizado las
aplicaciones SDK. Para obtener informacin sobre la actualizacin de las especificaciones de
informe, consulte IBM Cognos 8 SDK Developer Guide.

Gua de instalacin y configuracin 75

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay


11. Inicie IBM Cognos 8.
IBM Cognos 8 actualiza automticamente el almacn de contenido. Los archivos system.xml
se actualizan, si es necesario, a una versin compatible de IBM Cognos 8.
12. Si utiliza pginas creadas en versiones anteriores de IBM Cognos 8, es posible que deba volver
a configurar las siguientes propiedades:

Ttulo

Abra vnculos de acciones fuera del portal.

Para obtener ms informacin, consulte la Gua de administracin y seguridad.


13. Si utiliza SAP Enterprise Portal, actualice el iView maestro.
Los iViews de SAP antiguos no funcionarn con el nuevo componente de productor de Portal
Services. Para obtener informacin, consulte el tema sobre cmo implementar portlets de
Cognos en SAP Enterprise Portal en la Gua de administracin y seguridad.

Pasos para la instalacin en un nuevo directorio


1. Mediante las herramientas de la base de datos, copie la base de datos del almacn de contenido
existente en una nueva base de datos del almacn de contenido.
Para obtener informacin sobre este tema, consulte la documentacin de la base de datos.
2. Realice una copia de seguridad de los siguientes archivos en una ubicacin protegida:

cogstartup.xml y coglocale.xml en el directorio ubicacin_c8/configuration

server.xml en el directorio ubicacin_c8/tomcat4.1.27/conf

system.xml en el directorio correspondiente, si es necesario


No olvide anotar la ruta de acceso al directorio. Por ejemplo:
ubicacin_c8/templates/ps

En IBM Cognos Configuration, exporte los datos de configuracin a la misma ubicacin


protegida.
Para que los datos puedan utilizarse para la actualizacin, denomine el archivo cogstartup.xml.
Importante: Debido a que el archivo cogstartup.xml exportado contiene contraseas sin
codificar, asegrese de que la ubicacin est protegida.

Realice una copia de seguridad de cualquier archivo editado manualmente que haya en
ubicacin_c8/configuration y en otros directorios y gurdela en una ubicacin protegida.

3. Instale IBM Cognos 8 en un nuevo directorio.


4. Copie los archivos .xml de la ubicacin de copia de seguridad protegida en el siguiente directorio:

76 PowerPlay

Copie cogstartup.xml y coglocale.xml en ubicacin_c8/configuration.

Copie server.xml en ubicacin_c8/tomcat4.1.27/conf.

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay

En la nueva ubicacin, copie system.xml en el mismo directorio en el que estaba en la versin


anterior, si es necesario.
Por ejemplo:
ubicacin_c8/templates/ps

Si se le pregunta si desea sobrescribir los archivos existentes, haga clic en S.


5. En cuanto a los archivos que edit manualmente, edite los mismos archivos en el directorio
ubicacin_c8 y vuelva a aplicar los cambios que realiz en los archivos personalizados originales.
No copie los archivos personalizados de la ubicacin de copia de seguridad en los directorios
ubicacin_c8. Las versiones anteriores de estos archivos puede que no sean compatibles con
IBM Cognos 8.
6. Configure nuevos alias de servidor Web.
7. En IBM Cognos Configuration, configure IBM Cognos 8 para que apunte al nuevo almacn
de contenido, configure nuevos puertos y URL, utilice una ruta de acceso a cookies distinta y,
a continuacin, guarde la configuracin.
Asegrese de que los nmeros de puerto y el nombre de servicio de esta instalacin sean distintos
a los utilizados en versiones anteriores para evitar conflictos.
Asegrese de que la configuracin de autenticacin de seguridad no haya cambiado. Por ejemplo,
los espacios de nombre deben ser los mismos para las polticas, los usuarios, los roles y los
grupos para que funcionen correctamente.
Al guardar la configuracin, aparecer un cuadro de dilogo de actualizacin en el que se le
preguntar si desea actualizar las especificaciones de informe. El ajuste predeterminado es no
actualizar las especificaciones de informe.
Importante: No actualice las especificaciones de informe si tiene aplicaciones SDK que creen,
modifiquen o guarden especificaciones de informe. Primero debe actualizar las aplicaciones
SDK para que sean compatibles con el esquema de especificaciones de informe de IBM Cognos 8.
De lo contrario, es posible que las aplicaciones SDK no puedan acceder a las especificaciones
de informe actualizadas. Asimismo, no guarde los informes hasta que se hayan actualizado las
aplicaciones SDK. Para obtener informacin sobre la actualizacin de las especificaciones de
informe, consulte IBM Cognos 8 SDK Developer Guide.
8. Inicie IBM Cognos 8.
IBM Cognos 8 actualiza automticamente el nuevo almacn de contenido. Los archivos system.xml se actualizan, si es necesario, a una versin compatible de IBM Cognos 8.
9. Abra el portal de administracin y anule el registro de los distribuidores que se utilizan con
versiones anteriores de IBM Cognos 8.
Cuando abra el portal de administracin en IBM Cognos 8, es posible que vea los distribuidores
registrados para ambas versiones.
Para obtener ms informacin, consulte la Gua de administracin y seguridad.
10. Si utiliza pginas creadas en ReportNet, puede que deba volver a configurar las siguientes
propiedades:
Gua de instalacin y configuracin 77

Captulo 5: Actualizacin a IBM Cognos 8 PowerPlay

Ttulo

Abra vnculos de acciones fuera del portal.

Para obtener ms informacin, consulte la Gua de administracin y seguridad.


11. Si utiliza SAP Enterprise Portal, actualice el iView maestro.
Los iViews de SAP antiguos no funcionarn con el nuevo componente de productor de Portal
Services. Para obtener informacin, consulte el tema sobre cmo implementar portlets de
Cognos en SAP Enterprise Portal en la Gua de administracin y seguridad.
12. Cuando est listo para desinstalar la versin anterior de IBM Cognos 8, haga lo siguiente:

Detenga el servicio de IBM Cognos 8.

Desinstale IBM Cognos 8 de todos los equipos.


Para obtener instrucciones, consulte "Desinstalacin de IBM Cognos 8" (p. 102).

Cuando termine las tareas de actualizacin, IBM Cognos 8 estar totalmente configurado, salvo
las nuevas propiedades y funciones y las funciones de tablas de puntuacin.
Si utiliza caracteres chinos, japoneses o coreanos, puede que observe diferencias en algunos caracteres tras la actualizacin. Para obtener ms informacin, consulte la seccin Solucin de problemas
de Gua de administracin y seguridad.
Si utiliza una base de datos DB2 para el almacn de contenido, puede ajustar la base de datos para
que aproveche las funciones DB2. Para obtener ms informacin, consulte la Architecture and
Deployment Guide.
Para garantizar la seguridad e integridad de IBM Cognos 8, es importante proteger el directorio de
instalacin de los accesos no autorizados y no adecuados.

78 PowerPlay

Captulo 6: Instalacin y configuracin de IBM


Cognos 8 PowerPlay en un equipo
Puede instalar IBM Cognos 8 PowerPlay en un nico servidor si est configurando un entorno de
prueba o evaluacin, o para pequeos entornos de produccin. Para utilizar IBM Cognos 8
PowerPlay, debe instalar todos los componentes que estn seleccionados de forma predeterminada
en el asistente para instalacin.
Los componentes de migracin de IBM Cognos 8 se incluyen con la instalacin de IBM Cognos 8
PowerPlay. Dichos componentes admiten la migracin de contenido de PowerPlay de IBM Cognos
Series 7 a IBM Cognos 8. Adems, si instala IBM Cognos 8 PowerPlay con IBM Cognos 8, los
componentes de migracin admiten la opcin de abrir un informe de PowerPlay Studio en Analysis
Studio o Report Studio.
Los componentes de migracin de IBM Cognos Series 7 estn disponibles con IBM Cognos 8
PowerPlay. Para migrar el contenido de IBM Cognos Series 7 PowerPlay a IBM Cognos 8 PowerPlay,
debe instalar los componentes de migracin de IBM Cognos Series 7 en el equipo en el que est
instalado IBM Cognos Series 7 PowerPlay Enterprise Server. Si desea migrar contenido de PowerPlay
desde Upfront, tambin deber instalar los componentes de migracin de IBM Cognos Series 7 en
el equipo en el que se haya instalado Upfront.
Se recomienda realizar una instalacin interactiva (p. 81).
En esta seccin se incluye tambin informacin sobre la desinstalacin de IBM Cognos 8. Para
obtener ms informacin, consulte "Desinstalacin de IBM Cognos 8" (p. 102).
Puede instalar tambin los componentes de IBM Cognos 8 en equipos distintos. Para obtener ms
informacin, consulte "Instalacin y configuracin de los componentes del servidor PowerPlay de
IBM Cognos 8 en una instalacin distribuida" (p. 107).
Si desea automatizar el proceso de instalacin y configuracin, puede establecer una instalacin y
configuracin sin asistencia (p. 317).
Si desea instalar dos o ms componentes de IBM Cognos 8 en el mismo equipo, es recomendable
instalarlos en la misma ubicacin de instalacin para evitar los conflictos entre puertos y otros
valores predeterminados.
Si los modeladores desean crear paquetes relacionales o de origen mixto para trabajar con Analysis
Studio, Report Studio o Query Studio, necesitar la herramienta de modelado de IBM Cognos 8:
Framework Manager. Si los modeladores desean crear PowerCubes, necesita IBM Cognos 8
Transformer. Si los modeladores desean crear PowerCubes desde orgenes relacionales, necesita
Framework Manager e IBM Cognos 8 Transformer. Para obtener informacin sobre la instalacin
de Framework Manager e IBM Cognos 8 Transformer, consulte IBM Cognos 8 Business Intelligence
Gua de instalacin y configuracin que se suministra con los componentes de modelado.
Si est instalando IBM Cognos 8 en un entorno de servidor de aplicaciones, debe tener en cuenta
los requisitos de la instalacin. Para obtener ms informacin, consulte "Configuracin de IBM
Cognos 8 para un servidor de aplicaciones" (p. 287).
Licensed Materials Property of IBM
Copyright IBM Corp. 2005, 2009.

79

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Si desea utilizar ejemplos, debe instalarlos desde el CD IBM Cognos 8 Business Intelligence Samples.
Para obtener ms informacin, consulte "Instalacin de los ejemplos de IBM Cognos 8" (p. 158).
Para poder seguir estas instrucciones, el equipo donde desea instalar IBM Cognos 8 PowerPlay debe
tener instalado tambin el servidor Web.
Uso de la siguiente lista de comprobacin como gua durante las tareas de instalacin:

Si desea utilizar Report Studio, Analysis Studio o Query Studio, instale IBM Cognos 8 Business
Intelligence Server.
Para obtener instrucciones, consulte la publicacin IBM Cognos 8 Business Intelligence Gua
de instalacin y configuracin.

Instale IBM Cognos 8 PowerPlay.

Actualice el entorno Java.

Configure la conectividad de la base de datos para la base de datos del almacn de contenido.

Inicie IBM Cognos Configuration.

Configure las propiedades de conexin de la base de datos para el almacn de contenido.

Configure una cuenta de servidor de correo.

Configure las propiedades del entorno.

Configure un espacio de nombre de IBM Cognos Series 7 en IBM Cognos 8, si es necesario.

Configure el servidor Web.

Inicie los servicios.

Pruebe la instalacin.

Instale y configure los componentes de migracin en los equipos de IBM Series 7.

Cuando haya completado la configuracin inicial de IBM Cognos 8 PowerPlay, podr instalar IBM
Cognos 8 PowerPlay Client "Instalacin y configuracin de los componentes de cliente y de
modelado" (p. 151). Tambin puede personalizar los componentes que utilizar en su entorno cambiando otros valores de IBM Cognos Configuration (p. 213).

Administracin de PowerPlay
Para cambiar los valores de tiempo de ejecucin de IBM Cognos 8 PowerPlay, utilice IBM Cognos
Administration, al que se accede a travs del portal de IBM Cognos 8. Por ejemplo, puede habilitar
o deshabilitar distribuidores y servicios o configurar permisos para usuarios, grupos y roles. Para
obtener ms informacin, consulte la Gua de administracin y seguridad. Tambin puede configurar
las opciones de migracin y de informes y cubos de PowerPlay. Para obtener ms informacin,
consulte la Gua de migracin y administracin.

80 PowerPlay

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo

Recomendacin: instalar los componentes de servidor en modo


interactivo
Para efectuar una instalacin completa, debe instalar los componentes en su servidor y, a continuacin, configurarlos para que funcionen en su entorno.
Los programas de instalacin y configuracin de IBM Cognos se ejecutan por lo general en modo
interactivo. Esto implica que, en una interfaz de usuario grfica, el instalador le solicitar que proporcione informacin y la herramienta de configuracin le permitir modificar los valores predeterminados.
Puede instalar componentes del servidor en el modo silencioso.

Modo silencioso
Es posible automatizar la instalacin de componentes utilizando archivos de respuesta y ejecutando
el programa de instalacin en modo silencioso.
Para obtener informacin sobre instalaciones en modo silencioso, consulte "Cmo establecer instalaciones y configuraciones sin participacin del usuario" (p. 317).
Tambin es posible automatizar la configuracin de componentes exportando los valores de configuracin de un equipo a otro siempre que los componentes instalados sean los mismos. Le recomendamos que la primera vez, ejecute IBM Cognos Configuration en modo interactivo.
La otra opcin es editar el archivo cogstartup.xml haciendo uso de los valores aplicables a su entorno
y, a continuacin, ejecutar la herramienta de configuracin en modo silencioso.

Modo interactivo
A menos que tenga la intencin de realizar una instalacin en modo silencioso, se recomienda instalar el software desde una estacin de trabajo de sistema Windows X, un terminal X o un PC u
otro sistema con el software de servidor X instalado.
Para ejecutar una instalacin en modo interactivo, la consola asociada al equipo debe admitir una
interfaz grfica de usuario basada en Java.

Instalacin de IBM Cognos 8 PowerPlay


Utilice el asistente para instalacin para seleccionar los componentes del servidor que desee instalar
y la ubicacin del equipo donde desea instalarlos. Slo se copiarn del CD al equipo los componentes
que seleccione para instalar.
Si la actualizacin se efecta desde una versin anterior de IBM Cognos PowerPlay, deber seguir
los pasos de actualizacin. Para obtener ms informacin, consulte "Actualizacin a IBM Cognos 8
PowerPlay" (p. 57).
Si desea utilizar la base de datos de contenido de Cognos como almacn de contenido, deber
seleccionarla en el asistente de instalacin. Si instala componentes en varios equipos, slo necesitar
instalar una base de datos de contenido de Cognos. Si instala la base de datos de contenido de
Cognos en el mismo equipo que Content Manager y, ms adelante, decide utilizar otra base de

Gua de instalacin y configuracin 81

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


datos para el almacn de contenido, deber desinstalar la base de datos de contenido de Cognos
(p. 104).
En UNIX, para ejecutar la instalacin en modo grfico, la consola asociada al equipo de UNIX
debe admitir una interfaz grfica de usuario basada en Java.
En UNIX, IBM Cognos 8 respeta la mscara de creacin de modo de archivo (umask) de la cuenta
que ejecuta el programa de instalacin. Esto slo afecta a los directorios de instalacin. No afecta
a los permisos de archivos de los directorios. Sin embargo, los archivos generados en tiempo de
ejecucin, como los registros, respetan la mscara. Se recomienda utilizar el valor umask 022 en el
directorio de instalacin.
En Windows, asegrese de tener privilegios de administrador en el equipo de Windows en el que
est realizando la instalacin. Asegrese tambin de que el equipo disponga de una variable del
sistema TEMP que apunte al directorio en el que desea almacenar los archivos temporales. Durante
la instalacin, los archivos del CD se copian temporalmente en este directorio. Asegrese de que el
directorio tiene espacio suficiente (1 GB.
Si va a utilizar PowerCubes que estn protegidos contra espacios de nombre de IBM Cognos Series 7,
debe instalar Content Manager en un equipo que admita IBM Cognos Series 7.
Si est instalando IBM Cognos 8 PowerPlay con IBM Cognos 8 Business Intelligence Server, se
recomienda instalar y configurar antes IBM Cognos 8 Business Intelligence Server. Ambos productos
deben ser de la misma versin. Para obtener ms informacin, consulte "Productos de IBM Cognos
que interoperan con IBM Cognos 8 PowerPlay" (p. 33).
Para garantizar que los informes se imprimen correctamente en Windows, Adobe Acrobat requiere
que configure al menos una impresora en el sistema operativo en el que se encuentran instalados
los componentes de nivel de aplicacin. Todos los informes, con independencia del formato de
impresin seleccionado, se envan como archivos PDF temporales a Adobe Reader para su impresin.

Pasos para UNIX y Linux


1. Si est realizando la instalacin en un directorio que tiene otros componentes de IBM Cognos
8, detenga el servicio IBM Cognos 8.
2. Configure la variable de entorno JAVA_HOME para que apunte a la ubicacin de instalacin
de su entorno en tiempo de ejecucin de Java (JRE).
Un ejemplo de ubicacin de instalacin del entorno en tiempo de ejecucin de Java es /directorio/java/versin_java/jre.
IBM Cognos 8 requiere una JVM, como IBM Java, para ejecutarse en Linux.
3. En HP-UX, configure la variable de entorno _M_ARENA_OPTS como se indica a continuacin:
_M_ARENA_OPTS 1:4
De este modo, se aumenta la asignacin de memoria para HP-UX, a fin de que coincida lo
mximo posible con la de otras plataformas de UNIX.
4. En AIX, si usa una puerta de enlace del servlet, configure la variable de entorno AIXTHREAD_SCOPE de la siguiente manera:
AIXTHREAD_SCOPE=S

82 PowerPlay

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


De este modo, se establece el mbito de contencin de los subprocesos del usuario en todo el
sistema, lo que permite una planificacin ms eficaz de los subprocesos del usuario.
5. Monte el CD de su producto de IBM Cognos utilizando extensiones de archivo Rock Ridge.
Importante: Para montar el CD de IBM Cognos en HP-UX, siga estos pasos:

Aada el directorio pfs_mount a su ruta.


Por ejemplo:
PATH=/usr/sbin/:$PATH
export PATH

Para iniciar los daemons de NFS y ejecutar los daemons en segundo plano, escriba bg
pfs_mountd y, a continuacin, bg pfsd.

Para montar la unidad, escriba


pfs_mount -t rrip <dispositivo><dir_montaje> -o xlat=unix
Por ejemplo:
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Ahora ya puede instalar o copiar archivos como usuario distinto al usuario raz utilizando
un CD de IBM Cognos desde esta unidad.

Cuando haya completado la instalacin, escriba pfs_umount /cdrom y cancele los daemons
pfsd y pfs_mountd para desmontar el CD.

6. Para iniciar el asistente de instalacin, vaya al directorio del sistema operativo del CD o del
directorio en el que se descargaron y extrajeron los archivos de instalacin y, a continuacin,
escriba
./issetup
Nota: Si utiliza el comando issetup con XWindows, se podran daar los caracteres japoneses
en mensajes y archivos de registro. Cuando instale en japons en UNIX o Linux, deber configurar primero las variables del entorno LANG=C y LC_ALL=C (donde C es el cdigo del
idioma, por ejemplo ja_JP.PCK en Solaris), y despus iniciar el asistente de instalacin.
Si no utiliza XWindows, realice una instalacin sin participacin del usuario (p. 317).
7. Seleccione el idioma que desea utilizar en la instalacin.
El idioma que seleccione determina el idioma de la interfaz de usuario. Despus de la instalacin,
puede seleccionar el idioma de la interfaz de usuario del producto entre cualquiera de los idiomas
instalados.
8. No cambie los componentes seleccionados de forma predeterminada en la pgina Seleccin de
componentes.
Si desea utilizar la base de datos del almacn de contenido que se proporciona con IBM Cognos 8, seleccione tambin Base de datos de contenido de IBM Cognos.

Gua de instalacin y configuracin 83

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Para poder trabajar con migraciones, una vez que haya finalizado la instalacin en el equipo
de IBM Cognos 8, utilice los componentes de migracin de IBM Cognos Series 7.
9. En la pgina Varias ubicaciones de instalacin, especifique la ubicacin de IBM Cognos 8.
Si est realizando la instalacin en un equipo que contiene otros componentes de IBM Cognos
8 PowerPlay, realice la instalacin en el mismo directorio.
Instale los componentes de IBM Cognos 8 PowerPlay en un directorio que contenga slo
caracteres ASCII en el nombre de la ruta. Algunos servidores Web UNIX y Linux no admiten
caracteres no ASCII en los nombres de directorio.
10. Siga las indicaciones de las pginas Carpeta de accesos directos y Resumen de la instalacin.
11. En la pgina Finalizar, no seleccione ninguna opcin y haga clic en Finalizar.
12. Aada el directorio ubicacin_c8/bin a la variable de entorno de la ruta de biblioteca
correspondiente:

Para AIX, LIBPATH

Para HP-UX, SHLIB_PATH

Para Solaris, LD_LIBRARY_PATH

Para Linux, LD_LIBRARY_PATH

13. En Linux, configure la variable de entorno PRINTER con el nombre de la impresora.


Para garantizar la seguridad e integridad de IBM Cognos 8, es importante proteger el directorio de
instalacin de los accesos no autorizados y no adecuados.
Si desea que los usuarios puedan ver documentacin del producto en un idioma diferente al ingls,
deber instalar el componente Supplementary Languages Documentation en la misma ubicacin
que los componentes de la puerta de enlace. Para obtener ms informacin, consulte "Instalar
documentacin de producto traducida" (p. 166).

Pasos para Windows


1. Si est realizando la instalacin en un directorio que tiene otros componentes de IBM Cognos
8, detenga el servicio IBM Cognos 8.
2. Inserte el CD del producto de IBM Cognos.
Debe aparecer la pgina Bienvenido del asistente para instalacin.
Si no aparece la pgina de bienvenida en el CD, haga doble clic en el archivo issetup.exe.
3. Seleccione el idioma que desea utilizar en la instalacin.
El idioma que seleccione determina el idioma de la interfaz de usuario. Despus de la instalacin,
puede seleccionar el idioma de la interfaz de usuario del producto entre cualquiera de los idiomas
instalados.
4. En cada pgina del Contrato de licencia, seleccione Acepto y, a continuacin, haga clic en
Siguiente.

84 PowerPlay

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


5. No cambie los componentes seleccionados de forma predeterminada en la pgina Seleccin de
componentes.
Si desea utilizar la base de datos del almacn de contenido que se proporciona con IBM Cognos 8, seleccione tambin Base de datos de contenido de IBM Cognos.
6. En la pgina Varias ubicaciones de instalacin, especifique la ubicacin de IBM Cognos 8.
Si est realizando la instalacin en un equipo que contiene otros componentes de IBM Cognos
8 PowerPlay, realice la instalacin en el mismo directorio.
Si no utiliza el directorio de instalacin predeterminado, utilice un nombre de directorio que
contenga slo caracteres ASCII. Algunos servidores Web no admiten caracteres que no son
ASCII en los nombres de directorio.
7. Siga las indicaciones de las pginas Carpeta de accesos directos y Resumen de la instalacin.
8. En la pgina Finalizar, haga clic en Finalizar.
Para garantizar la seguridad e integridad de IBM Cognos 8, es importante proteger el directorio de
instalacin de los accesos no autorizados y no adecuados.
Si desea que los usuarios puedan ver documentacin del producto en un idioma diferente al ingls,
deber instalar el componente Supplementary Languages Documentation en la misma ubicacin
que los componentes de la puerta de enlace. Para obtener ms informacin, consulte "Instalar
documentacin de producto traducida" (p. 166).

Actualizacin del entorno Java


Los archivos criptogrficos de IBM Cognos 8 utilizan un archivo .jar (Java Archive), denominado
bcprov-jdknn-nnn.jar, que debe encontrarse en el entorno en tiempo de ejecucin de Java (JRE).
Este archivo proporciona rutinas de codificacin y descodificacin que no forman parte de una
instalacin predeterminada de JVM. Para garantizar la seguridad, la JVM debe cargar el archivo
de codificacin mediante el directorio de extensiones de Java.
Si desea utilizar su propio JRE y establecer la variable JAVA_HOME en esa ubicacin de Windows,
o si est realizando la instalacin en UNIX, es posible que tenga que actualizar los entornos Java
de los servicios criptogrficos.
En Windows, puede configurar JAVA_HOME como variable del sistema o variable de usuario. Si
la configura como variable del sistema, es posible que tenga que reiniciar el equipo para que surta
efecto. Si la configura como variable de usuario, hgalo de tal manera que el entorno en el que se
ejecute Tomcat pueda acceder a ella.
Si no tiene una variable JAVA_HOME ya definida en Windows, se utilizarn los archivos JRE
proporcionados con la instalacin, y no tendr que actualizar ningn archivo del entorno. Si
JAVA_HOME remite a una versin Java que no es vlida para IBM Cognos 8, deber actualizar
JAVA_HOME con la ruta correspondiente a una versin de Java vlida.

Pasos
1. Compruebe que la variable de entorno JAVA_HOME est configurada en la ubicacin del JRE.

Gua de instalacin y configuracin 85

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Por ejemplo, para configurar JAVA_HOME en los archivos JRE proporcionados con la instalacin, la ruta es ubicacin_c8/bin/jre/versin.
2. Copie el archivo bcprov-jdknn-nnn.jar del directorio ubicacin_c8/bin/jre/versin/lib/ext al
directorio ubicacin_Java/jre/lib/ext.

Opciones de controlador JDBC para usar bases de datos DB2


como almacn de contenido
IBM Cognos 8 utiliza la conectividad JDBC para acceder a la base de datos utilizada como almacn
de contenido.
Si utiliza DB2 en Windows, Linux o UNIX como almacn de contenido, debe elegir si desea utilizar
un controlador JDBC de tipo 2 o de tipo 4, segn cmo desee conectar con el almacn de contenido.
Si va a utilizar una base de datos DB2 en z/OS como almacn de contenido, deber utilizar la
conectividad JDBC de tipo 4.
Especifique el tipo de controlador que va a usar en IBM Cognos Configuration.

Opciones de configuracin para el controlador universal


DB2 introdujo un controlador JDBC universal que contiene compatibilidad con los tipos 2 y 4 de
controlador JDBC. El controlador universal, db2jcc.jar, sustituye al controlador obsoleto JDBC de
tipo 2, db2java.zip.
Si est realizando una actualizacin, puede seguir usando la conectividad JDBC de tipo 2 sin necesidad de cambiar la configuracin. Si desea usar la conectividad JDBC de tipo 4, debe cambiar la
configuracin para incluir el nombre de host y el nmero de puerto del servidor de base datos.
Para obtener ms informacin sobre los requisitos de configuracin, consulte "Configuracin de
las propiedades de la conexin a la base de datos en el almacn de contenido" (p. 89).
Sin embargo, para la conectividad JBDC tanto de tipo 2 como de tipo 4, debe copiar el nuevo
controlador universal, db2jcc.jar, y el archivo de licencia adjunto, db2jcc_license_*.jar, en la ubicacin de instalacin de IBM Cognos 8.
Para obtener ms informacin, consulte "Configuracin de la conectividad de la base de datos para
la base de datos del almacn de contenido" (p. 87).

Uso del controlador JDBC de tipo 2


Los controladores JDBC de tipo 2 estn formados por un componente de API nativa y un componente
Java.
La conexin a la base de datos DB2 se produce mediante las bibliotecas DB2 CLI, que comprenden
el componente nativo que se comunica con el servidor de base de datos.
Dado que los controladores JDBC de tipo 2 requieren un cdigo de cliente comn y dependen del
cdigo nativo del producto, debe estar instalado un producto DB2 para usar este controlador. Por
ejemplo, debe estar instalado un cliente DB2 en el equipo en que tenga instalado Content Manager.

86 PowerPlay

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo

Uso del controlador JDBC de tipo 4


Los controladores JDBC de tipo 4 son controladores Java puros que proporcionan acceso directo
a funciones de base de datos DB2 a travs de una comunicacin de red.
El controlador de tipo 4 se considera un producto independiente. No requiere que est instalado el
producto DB2. Por ejemplo, no necesita instalar el cliente DB2 en el equipo en el que tenga instalado
Content Manager.

Configuracin de la conectividad de la base de datos para la


base de datos del almacn de contenido
Si utiliza una base de datos distinta de la base de datos de contenido de Cognos como almacn de
contenido, puede que tenga que instalar el software de cliente de la base de datos o los controladores
JDBC o ambos en cada equipo en el que instale Content Manager. Al hacerlo permite que Content
Manager acceda a la base de datos del almacn de contenido.

Pasos para DB2


1. Si va a utilizar la conectividad JDBC de tipo 2, instale el software del cliente DB2 en los equipos
de Content Manager.
Si va a utilizar la conectividad JDBC de tipo 4 para DB2, no necesita instalar el software del
cliente DB2 en el equipo en el que est instalado Content Manager.
Si va a utilizar una base de datos DB2 en z/OS como almacn de contenido, deber utilizar la
conectividad JDBC de tipo 4.
Para obtener ms informacin sobre las diferencias entre los controladores de tipo 2 y de tipo
4, consulte "Opciones de controlador JDBC para usar bases de datos DB2 como almacn de
contenido" (p. 86).
2. Si va a utilizar una conectividad JDBC de tipo 2 y el almacn de contenido no est instalado
en el mismo equipo que Content Manager, configure un alias de base de datos para el almacn
de contenido.
En Windows, ejecute el DB2 Client Configuration Assistant.
En UNIX o Linux, utilice la interfaz de lnea de comandos de DB2.
Si tanto la base de datos del almacn de contenido como Content Manager se encuentran en
el mismo equipo, el nombre del almacn de contenido pasa a ser el alias automticamente.
Cuando configure los equipos de Content Manager, asegrese de que estn configurados para
utilizar el mismo almacn de contenido.
3. En Windows, detenga los servicios de DB2 y el servidor de bsqueda HTML.
4. Copie los siguientes archivos del directorio instalacin_DB2/sqllib/java en el directorio ubicacin_c8/webapps/p2pd/WEB-INF/lib.

Archivo del controlador universal: db2jcc.jar

Archivo de licencia

Gua de instalacin y configuracin 87

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Para DB2 en Linux, UNIX o Windows, db2jcc_license_cu.jar
Para DB2 en z/OS, db2jcc_license_cisuz.jar
Si conecta con DB2 en z/OS, usa la versin del controlador de Linux, UNIX o Windows versin
9.1 fix pack 5 o versin 9.5 fix pack 2.
Sugerencia: Para comprobar la versin del controlador, ejecute el comando siguiente:
java -cp ruta\db2jcc.jar com.ibm.db2.jcc.DB2Jjcc -version
5. En Windows, reinicie los servicios de DB2 y el servidor de bsqueda HTML.
6. En UNIX, si utiliza la conectividad JDBC de tipo 2, asegrese de que las bibliotecas DB2 de
32 bits se encuentren en la ruta de bsqueda de bibliotecas, que suele ser el directorio
$DB2DIR/lib o $DB2DIR/lib32.
7. Repita el procedimiento completo en todos los equipos de IBM Cognos 8 donde haya instalado
Content Manager o donde se haya enviado una notificacin a una base de datos DB2.

Pasos para Oracle


1. En el equipo en el que est instalado el cliente de Oracle, vaya al directorio ORACLE_HOME/
jdbc/lib.
2. Copie el archivo JAR correspondiente en el directorio ubicacin_c8/webapps/p2pd/WEB-INF/
lib de cada uno de los equipos donde haya instalado Content Manager y donde se haya enviado
una notificacin a una base de datos Oracle.

Si utiliza Java 1.4, copie el archivo ojdbc14.jar.

Si utiliza Java 1.5, copie el archivo ojdbc5.jar.

Si el directorio contiene el archivo classes12.jar, elimnelo antes de instalar el archivo ojdbc14.jar


o ojdbc5.jar.
El controlador est disponible desde una instalacin de servidor o un cliente de Oracle, y tambin
se puede descargar desde el sitio Web de tecnologa de Oracle (http://www.oracle.com/
technology).

Pasos para Sybase


1. En el equipo donde se haya instalado Sybase, vaya al directorio ubicacin_Sybase/jConnect-5_
5/classes.
2. Copie el archivo jconn2.jar en el directorio ubicacin_c8/webapps/p2pd/WEB-INF/lib de cada
equipo donde haya instalado Content Manager y donde se haya enviado una notificacin a
una base de datos Sybase.

Inicio de IBM Cognos Configuration


Utilice la herramienta de configuracin, IBM Cognos Configuration, para configurar IBM Cognos
8, o para iniciar y detener los servicios de IBM Cognos.

88 PowerPlay

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


En UNIX o Linux, no inicie IBM Cognos Configuration en la ltima pgina del asistente para instalacin, ya que es necesario configurar ms opciones antes de poder configurar IBM Cognos 8.
Por ejemplo, debe actualizar su entorno Java. En Windows, puede iniciar IBM Cognos Configuration
en la ltima pgina del asistente de instalacin nicamente si no es necesario configurar ms
opciones. Por ejemplo, si utiliza un servidor de base de datos distinto a Microsoft SQL o la base
de datos de contenido de Cognos para el almacn de contenido, se recomienda copiar los controladores JDBC en la ubicacin adecuada antes de iniciar la herramienta de configuracin.

Paso para iniciar IBM Cognos Configuration en un equipo de Windows

En el men Inicio, haga clic en Programas, IBM Cognos 8, IBM Cognos Configuration.

Paso para iniciar IBM Cognos Configuration en un equipo de UNIX o Linux

Vaya al directorio ubicacin_c8/bin y escriba


./cogconfig.sh

Configuracin de las propiedades de la conexin a la base de


datos en el almacn de contenido
Para cualquier instalacin que no haga uso de la base de datos de contenido de Cognos, debe
especificar la informacin de servidor de base de datos para comprobar que Content Manager se
puede conectar a la base de datos que usted utiliza para el almacn de contenido. Content Manager
utiliza el inicio de sesin de la base de datos para acceder al almacn de contenido. Una vez establecidas las propiedades de conexin de la base de datos, puede probar la conexin entre Content
Manager y el almacn de contenido.
Asegrese de haber utilizado uno de los servidores de base de datos admitidos para crear el almacn
de contenido.

Pasos para DB2


1. Inicie IBM Cognos Configuration en la ubicacin en la que haya instalado Content Manager.
2. En la ventana Explorador, en Acceso a datos, Content Manager, haga clic en Almacn de
contenido.
3. En la ventana Propiedades, para 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 sesin para especificar una contrasea y un identificador
de usuario vlidos:

Haga clic en el cuadro Valor, situado junto a la propiedad Identificador de usuario y contrasea y, a continuacin, haga clic en el botn de edicin, cuando lo vea.

Escriba los valores adecuados y haga clic en Aceptar.

5. Para usar el tipo 4 de conectividad JDBC, para la propiedad Servidor de base de datos y contrasea, escriba un valor, usando la sintaxis host:puerto.

Gua de instalacin y configuracin 89

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Si deja esta propiedad en blanco, se usa la conectividad JDBC de tipo 2.
Para obtener ms informacin sobre las diferencias entre los tipos de controlador, consulte
"Opciones de controlador JDBC para usar bases de datos DB2 como almacn de contenido" (p. 86).
6. En el men Archivo, haga clic en Guardar.
Las credenciales de inicio de sesin se codifican de inmediato.
7. Pruebe la conexin entre Content Manager y el almacn de contenido.
Sugerencia: En la ventana Explorador, haga clic con el botn derecho en la nueva base de datos
y, a continuacin, haga clic en Probar.
Content Manager se conecta a la base de datos, comprueba los permisos de la base de datos,
crea la tabla y, a continuacin, la rellena. La tabla no se elimina y se utiliza cada vez que se
repite la prueba.

Pasos para Microsoft SQL Server, Oracle y Sybase


1. Inicie IBM Cognos Configuration en el equipo en el que instal Content Manager.
2. En la ventana Explorador, en Acceso a datos, Content Manager, haga clic con el botn derecho
en Almacn de contenido y, a continuacin, haga clic en Eliminar.
As, se elimina el recurso predeterminado. Content Manager debe configurarse para acceder
slo a un almacn de contenido.
3. Haga clic con el botn derecho en Content Manager y, a continuacin, haga clic en Nuevo
recurso, Base de datos.
4. En el cuadro Nombre, escriba el nombre del recurso.
5. En el cuadro Tipo, seleccione el tipo de base de datos y haga clic en Aceptar.
Si est realizando una actualizacin y desea usar un almacn de contenido existente, asegrese
de que selecciona el tipo de base de datos que usa para la versin anterior.
Si ha instalado ms de una versin de IBM Cognos 8, deber usar un almacn de contenido
diferente para cada una. Cuando una nueva versin de IBM Cognos 8 utiliza un almacn de
contenido, ste no puede ser utilizado por una versin ms antigua.
Sugerencia: Si desea usar un par contrasea-valor Net8 de Oracle para administrar la conexin
a la base de datos, seleccione Base de datos Oracle (Avanzada).
6. En la ventana Propiedades, proporcione los valores en funcin de su tipo de base de datos:

Si utiliza una base de datos Microsoft SQL Server, introduzca los valores pertinentes para
las propiedades Servidor de base de datos con nmero de puerto o nombre de instancia y
Nombre de base de datos.
Para una base de datos de Microsoft SQL Server, puede elegir utilizar un nmero de puerto,
tal como el 1433, o una instancia con nombre como valor para la propiedad Servidor de
base de datos con nmero de puerto o nombre de instancia.

90 PowerPlay

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Para conectarse a una instancia con nombre, debe especificar el nombre de instancia como
una propiedad URL de JDBC o una propiedad de origen de datos. Por ejemplo, puede
escribir localhost\instance1. Si no se especifica una propiedad nombre de instancia, se crea
una conexin a la instancia predeterminada.
Tenga en cuenta que las propiedades especificadas para la instancia con nombre, junto con
el identificador de usuario y contrasea, y el nombre de la base de datos, se utilizan para
crear una URL de JDBC. A continuacin se incluye un ejemplo:
jdbc:JSQLConnect://localhost\\instance1/user=sa/ms propiedades segn sea necesario

Si utiliza una base de datos Oracle, escriba los valores pertinentes para las propiedades
Servidor de base de datos y nmero de puerto y Nombre de servicio.

Si usa una base de datos Oracle avanzada, introduzca el par contrasea-valor Net8 de
Oracle de la conexin para la propiedad Especificador de base de datos.
A continuacin se incluye un ejemplo:
(description=(address=(host=myhost)(protocol=tcp)(port=1521)(connect_data=(sid=(orcl)))))
Si selecciona la base de datos avanzada de Oracle, IBM Cognos 8 usar las funciones
empresariales de Oracle para seleccionar una escucha, cambiar a otra escucha si la primera
falla, volver a conectarse automticamente a la base de datos si la conexin falla, equilibrar
las solicitudes de conexin entre escuchas y equilibrar las solicitudes de conexin entre
distribuidores.

Si utiliza una base de datos Sybase, escriba los valores pertinentes para las propiedades
Servidor de base de datos y nmero de puerto y Nombre de base de datos.

7. Si desea cambiar las credenciales de inicio de sesin, especifique un identificador de usuario y


una contrasea:

Haga clic en el cuadro Valor, situado junto a la propiedad Identificador de usuario y contrasea y, a continuacin, haga clic en el botn de edicin, cuando lo vea.

Escriba los valores adecuados y haga clic en Aceptar.

8. En el men Archivo, haga clic en Guardar.


Las credenciales de inicio de sesin se codifican de inmediato.
9. Pruebe la conexin entre Content Manager y el almacn de contenido.
Sugerencia: En el men Acciones, haga clic en Prueba para probar la conexin entre Content
Manager y el almacn de contenido.
Content Manager se conecta a la base de datos, comprueba los permisos de la base de datos,
crea la tabla y, a continuacin, la rellena. La tabla no se elimina y se utiliza cada vez que se
repite la prueba.
Ahora, Content Manager puede crear las tablas necesarias en el almacn de contenido cuando se
inicie el servicio IBM Cognos 8 por primera vez. Si las propiedades de conexin no se han configurado correctamente, no puede conectarse con IBM Cognos Connection.

Gua de instalacin y configuracin 91

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Si lleva a cabo la actualizacin desde ReportNet, Content Manager puede acceder entonces a las
tablas necesarias del almacn de contenido que utiliz para la versin antigua.

Especificacin de una cuenta de servidor de correo


Si desea enviar informes por correo electrnico, debe configurar una cuenta de servidor de correo.

Pasos
1. En la ventana del Explorador, en Acceso a datos, haga clic en Notificacin.
2. En la ventana Propiedades, para la propiedad Servidor de correo SMTP, escriba el nombre del
host y el puerto del servidor de correo SMTP (saliente).
Sugerencia: Para poder abrir informes enviados por correo electrnico, debe cambiar la parte
correspondiente al nombre de host del URI de puerta de enlace de localhost a la direccin IP
del equipo o al nombre del equipo. De lo contrario, la URL del correo electrnico contendr
localhost y los usuarios remotos no podrn abrir el informe.
3. Haga clic en el cuadro Valor, situado junto a la propiedad Cuenta y contrasea y, a continuacin,
haga clic en el botn de edicin, cuando aparezca.
4. Escriba los valores apropiados en el cuadro de dilogo Valor - Cuenta y contrasea y, a continuacin, haga clic en Aceptar.
Sugerencia: Si no se necesitan las credenciales de inicio de sesin para el servidor SMTP, elimine
la informacin predeterminada para la propiedad Cuenta y contrasea. Cuando se le pida
confirmacin para dejar esta propiedad en blanco, haga clic en S. Asegrese de que se ha eliminado el nombre de usuario predeterminado. De lo contrario, se utilizar la cuenta predeterminada y las notificaciones no funcionarn correctamente.
5. En la ventana Propiedades, escriba el valor apropiado para la cuenta del remitente predeterminado.
6. Pruebe las conexiones al servidor de correo. En la ventana del Explorador, haga clic con el
botn derecho en Notificacin y, a continuacin, haga clic en Probar.
Cognos 8 prueba la conexin al servidor de correo.
Si no tiene planificado enviar informes por correo electrnico o no desea configurar inmediatamente
una cuenta de servidor de correo, no es necesario que lo haga. Sin embargo, cuando guarde la
configuracin y, posteriormente, inicie los servicios en IBM Cognos Configuration, podr ver un
mensaje de advertencia cuando se pruebe la conexin al servidor de correo. Puede ignorar la
advertencia sin peligro alguno.

92 PowerPlay

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo

Configuracin de las propiedades del entorno


Se recomienda especificar el nombre del servidor o una direccin IP en las propiedades del URI que
utiliza IBM Cognos 8. De manera predeterminada, las propiedades del URI especifican localhost.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana Propiedades, cambie la parte localhost de todas las propiedades del URI por el
nombre o la direccin IP del servidor de IBM Cognos 8, siguiendo estos pasos:

En URI de distribuidor para puerta de enlace y URI de Content Manager, haga clic en el
valor y, a continuacin, en el botn Editar. Cambie la parte localhost y haga clic en Aceptar.

Para todas las propiedades de URI restantes, haga clic en el valor y cambie la parte localhost.

4. En la ventana Explorador, en Seguridad, Criptografa, haga clic en Cognos, el proveedor criptogrfico predeterminado.
5. En el grupo de propiedades Configuracin de la entidad emisora de certificados , configure la
propiedad Contrasea.
6. En el men Archivo, haga clic en Guardar.

Configuracin de un espacio de nombre de IBM Cognos Series


7 en IBM Cognos 8
Si desea migrar la informacin de seguridad o el contenido protegido de IBM Cognos Series 7 a
IBM Cognos 8, debe configurar un espacio de nombre en IBM Cognos 8 idntico al espacio de
nombre de IBM Cognos Series 7.
Puede configurar varios espacios de nombre para la autenticacin en IBM Cognos 8. Para obtener
ms informacin, consulte "Configuracin de los componentes de IBM Cognos 8 para utilizar un
proveedor de autenticacin" (p. 171).
Nota: No puede utilizar un archivo LAE (Local Authentication Export) de IBM Cognos Series 7
para realizar la autenticacin con los componentes de IBM Cognos 8.
Se recomienda que todos los espacios de nombre de IBM Cognos Series 7 utilicen el mismo servidor
de vales primario de IBM Cognos Series 7. De lo contrario, recibir errores o se le solicitar que se
autentique ms de una vez. Para mantener el rendimiento, asegrese tambin de que el servidor de
vales est en ejecucin.
Si cambia la informacin de configuracin almacenada en el servidor de directorios utilizado para
IBM Cognos Series 7, debe reiniciar el servicio de IBM Cognos 8 antes de que se realicen los cambios
en la instalacin de IBM Cognos.

Gua de instalacin y configuracin 93

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Un usuario debe estar por lo menos en una clase de usuario de Access Manager para poder iniciar
sesin en los componentes de IBM Cognos 8.

Pasos
1. En la ventana Explorador, haga clic con el botn derecho en Autenticacin y seleccione Nuevo
recurso, Espacio de nombre.
2. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
3. En la lista Tipo, haga clic en IBM Cognos Series 7 y, a continuacin, en Aceptar.
El nuevo recurso proveedor de autenticacin aparecer en la ventana Explorador, bajo el
componente Autenticacin.
4. En la ventana Propiedades de recursos, especifique los valores obligatorios.
Algunos valores deben coincidir con los valores que utiliz al configurar el espacio de nombre
de IBM Cognos Series 7 en Configuration Manager. En Servicios, Access Manager - Tiempo
de ejecucin, Directory Server, compruebe los valores de la ventana Propiedades.

En ID de espacio de nombre, especifique un identificador nico para el espacio de nombre.

En Host y puerto, escriba el mismo valor utilizado para la propiedad Equipo en el Administrador de configuracin.
El formato debe ser idntico. Si utiliza una direccin IP en IBM Cognos Series 7, escriba
la misma direccin IP. Si utiliza un nombre de host de la red en IBM Cognos Series 7,
escriba el mismo nombre de host de la red.

En Nombre distinguido de base, escriba el mismo valor utilizado para la propiedad Nombre
distinguido de base (DN) en el Administrador de configuracin.

En Nombre del espacio de nombre, escriba el mismo valor utilizado para la propiedad
Nombre de espacio predeterminado en el Administrador de configuracin.
El valor distingue maysculas y minsculas y debe coincidir exactamente.

5. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que los
componentes de IBM Cognos 8 puedan localizar y utilizar el proveedor de autenticacin existente.
Si la versin de espacio de nombre de IBM Cognos Series 7 es 16.0, asegrese de que la propiedad
Codificacin de datos tiene asignado el valor UTF-8. Adems, los equipos donde est instalado
Content Manager deben utilizar la misma configuracin regional que los datos que estn en el
espacio de nombre de IBM Cognos Series 7.
6. Si el entorno de espacio de nombre incluye la versin 15.2 del espacio de nombre de IBM
Cognos Series 7, debe deshabilitar la configuracin de Series7NamespacesAreUnicode.

94 PowerPlay

En la ventana Propiedades, en el valor Propiedades avanzadas, haga clic en el botn Editar.

En la ventana Valor: Propiedades avanzadas, haga clic en Aadir.

En el cuadro Nombre, escriba Series7NamespacesAreUnicode.

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo

En el cuadro Valor, haga clic en Falso y, a continuacin, haga clic en Aceptar.

7. En la ventana Propiedades, en Configuracin de cookies, asegrese de que las propiedades


Ruta, Dominio e Indicador de proteccin activado coincidan con los valores configurados para
IBM Cognos Series 7.
8. En el men Archivo, haga clic en Guardar.

Configuracin del servidor Web


Para todas las instalaciones, antes de utilizar pginas Web generadas por IBM Cognos 8, debe
configurar su servidor Web. Debe crear directorios virtuales, o alias, para que los usuarios se puedan
conectar a IBM Cognos 8 en el portal. Si tiene pensado ejecutar en un mismo equipo ms de un
producto de IBM Cognos 8, o varias instancias del mismo producto, debe crear un grupo de aplicaciones distinto para cada producto o instancia y, a continuacin, asociar los alias de ese producto
o instancia al grupo de aplicaciones. Los pasos para crear un grupo de aplicaciones varan segn
el sistema operativo.
En UNIX y Linux, la cuenta en la que se ejecuta el servidor Web debe tener acceso de lectura al
archivo cogstartup.xml en el directorio ubicacin_c8/configuration. De manera predeterminada, el
archivo cogstartup.xml tiene permisos de lectura para otros usuarios. Si ejecuta su servidor Web
en un grupo especfico, puede cambiar los permisos del archivo cogstartup.xml para asegurarse de
que pertenezca al mismo grupo que el servidor Web. As, podr eliminar el permiso de lectura para
otros usuarios.
Para obtener informacin sobre cmo crear una cuenta de usuario o una cuenta de servicio de red
para IBM Cognos 8, consulte "Configuracin de una cuenta de usuario o de servicio de red para
IBM Cognos 8" (p. 54).

Pasos para crear directorios virtuales


1. Cree los siguientes directorios virtuales:

Alias

Ubicacin

Permiso

cognos8

ubicacin_c8/webcontent

Lectura

cognos8/cgi-bin

ubicacin_c8/cgi-bin

Ejecucin

Puede utilizar un nombre distinto a cognos8 en los alias. Sin embargo, debe utilizar cgi-bin
como segunda parte del alias y cambiar el directorio virtual de la propiedad URI de puerta de
enlace para que coincida con el nuevo alias de IBM Cognos. Para obtener ms informacin,
consulte "Cambio de un URI" (p. 219).
Si actualiza el equipo desde ReportNet, puede seguir utilizando los alias existentes. Si instala
los componentes de creacin de informes de IBM Cognos 8 en una ubicacin distinta de
ReportNet, cambie los alias existentes para incluir la nueva ubicacin. Si tiene ms de una
versin de ReportNet en un equipo, debe utilizar distintos nombres de alias para IBM Cognos
8.
Gua de instalacin y configuracin 95

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Para el servidor Web Apache, asegrese de definir el alias cognos8/cgi-bin antes que el alias
cognos8 del archivo httpd.conf que se encuentra en el directorio instalacin_Apache/conf. El
alias cognos8/cgi-bin debe definirse como ScriptAlias.
2. Si desea utilizar el explorador de imgenes de Report Studio, habilite Web Distributed Authoring
and Versioning (WebDAV) en su servidor Web.
Si utiliza el servidor Web Apache, especifique un directorio en el que habilitar WebDAV. Para
obtener informacin sobre cmo configurar WebDAV, consulte la documentacin de su servidor
Web.
Si utiliza Internet Information Services de Microsoft (IIS), habilite las propiedades Lectura y
Examen de directorios de la direccin URL a la que desee acceder.
3. Para la creacin de informes con IBM Cognos 8, configure la caducidad del contenido en el
directorio virtual ubicacin_c8/pat/images del servidor Web.
Cada vez que un usuario abre Report Studio, su explorador Web comprueba el servidor Web
para determinar si las imgenes son actuales. Dado que hay ms de 600 imgenes, esto puede
provocar un exceso de trfico en la red. Puede posponer esta comprobacin hasta una fecha
especfica gracias a la funcin de caducidad de contenido del servidor Web.
Para obtener informacin sobre cmo establecer la caducidad del contenido, consulte la documentacin del servidor Web.
Nota: Al actualizar, los usuarios de Report Studio debern borrar la cach del explorador Web
para obtener las imgenes ms recientes.
Si utiliza alias Web distintas a cognos8, si el servidor Web est en otro equipo o si utiliza Microsoft
Internet Application Interface (ISAPI), apache_mod o una puerta de enlace del servlet, cambie el
URI de puerta de enlace (p. 219) cuando configure los componentes de IBM Cognos.

Pasos para crear un grupo de aplicaciones


1. En el men Inicio, seleccione Panel de control, Rendimiento y mantenimiento, Herramientas
administrativas.
2. Inicie Internet Information Services (IIS) Manager.
Web Management Tools y el World Wide Web Services se habilitan.
3. Desde la raz (su nombre de sistema y usuario), seleccione Feature View.
4. En la seccin IIS, inicie ISAPI and CGI Restrictions.
5. Seleccione Edit Feature Settings y habilite Allow unspecified CGI modules y, a continuacin,
haga clic en OK.
6. Aada sus alias. Por ejemplo, ubicacin_c8 y ubicacin_c8/cgi-bin.
7. Seleccione su alias cgi-bin y asegrese de que la vista Feature View est seleccionada.
8. Haga clic con el botn derecho del ratn en Application Pools y seleccione Add.

96 PowerPlay

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


9. En el cuadro de dilogo, introduzca un alias Web y la ruta de acceso correspondiente al contenido
Web de IBM Cognos 8.
10. Repita los pasos 8 y 9 para aadir el siguiente alias Web.
11. Seleccione Default Web Site.
12. Abra Handler Mappings.
13. Seleccione CGI-cgi mappings.
14. En el panel derecho, haga clic en Revert to Inherited.
15. Expanda la aplicacin que dirige a su ubicacin de contenido Web.
16. Expanda el nodo de aplicacin cgi-bin.
17. Aada una asignacin que dirija a *.cgi y asgnele el nombre de CGI-cgi.
18. Seleccione la asignacin CGI-cgi.
19. En el panel derecho, haga clic en Revert to Inherited.
20. Reinicie el servidor IIS.
21. Busque la carpeta que contiene cgi-bin (ubicacin_c8/cgi-bin) y seleccinela con el botn derecho.
22. Seleccione la pestaa Security.
23. Aada el usuario de Servicios de red, concediendo todos los permisos excepto Full Control.
24. Haga clic con el botn derecho en Cognos8 service y seleccione Properties.
25. Haga clic en la pestaa Log On.
26. Seleccione This account e introduzca Servicios de red como el usuario.
27. Elimine los valores Password y Confirm the password.
28. Haga clic en Aceptar.

Inicio del servicio de IBM Cognos 8


Para registrar el servicio IBM Cognos 8 de manera que los usuarios puedan acceder a l a travs de
IBM Cognos Connection, debe iniciar los servicios. Antes de iniciar los servicios, pruebe la configuracin utilizando la funcin de prueba en IBM Cognos Configuration.
En Windows, el servicio IBM Cognos 8 est configurado para iniciarse automticamente de forma
predeterminada. En UNIX y Linux, para iniciar el proceso de IBM Cognos 8 automticamente,
debe configurar el proceso como un daemon. Para obtener ms informacin, consulte la documentacin del sistema operativo.
Debe instalar y configurar los componentes del servidor de IBM Cognos 8 y Framework Manager
para poder utilizar IBM Cognos 8 para crear informes.

Gua de instalacin y configuracin 97

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Nota: IBM Cognos 8 no puede acceder a los datos de creacin de informes a menos que los datos
se empaqueten antes y se publiquen desde Framework Manager.

Pasos
1. Inicie IBM Cognos Configuration.
2. Asegrese de guardar la configuracin, de lo contrario, no podr iniciar el servicio IBM Cognos
8.
3. En el men Acciones, haga clic en Probar.
IBM Cognos Configuration verifica la disponibilidad de claves simtricas comunes (CSK),
prueba la configuracin del espacio de nombre y prueba las conexiones con el almacn de
contenido y la base de datos de registro.
Sugerencia: Si la opcin Probar no se puede seleccionar, haga clic en Configuracin local en la
ventana Explorador.
4. Si la prueba falla, vuelva a configurar las propiedades afectadas y realice la prueba de nuevo.
Si la nica prueba que falla es la prueba del servidor de correo, puede iniciar el servicio. Si desea
pasar la prueba del servidor de correo, configure un servidor SMTP vlido en Acceso a datos,
Notificacin.
5. En el men Acciones, haga clic en Iniciar.
Es posible que el servicio IBM Cognos 8 tarde unos minutos en iniciarse.
Si recibe el mensaje de que se han emitido advertencias durante la fase de prueba, haga clic en
S y, a continuacin, haga clic en Continuar en el cuadro de dilogo de inicio.
Esta accin inicia todos los servicios instalados que no se estn ejecutando. Si desea iniciar un
servicio en particular, seleccione el nodo de servicio en la ventana Explorador y, a continuacin,
haga clic en Iniciar en el men Acciones.

Prueba de los componentes del servidor PowerPlay de IBM


Cognos 8
Puede probar la instalacin de IBM Cognos 8 PowerPlay comprobando los servicios de migracin,
comprobando la existencia del icono del ayudante para la migracin en IBM Cognos Administration
y abriendo un cubo en PowerPlay Studio. Si instala los ejemplos, puede utilizar el cubo de ejemplo
proporcionado con IBM Cognos 8 PowerPlay.
Tambin puede probar Framework Manager.
Uso de la siguiente lista de comprobacin para probar la configuracin:

98 PowerPlay

Pruebe la migracin.

Pruebe IBM Cognos Connection.

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo

Prueba de IBM Cognos Connection


Para probar la instalacin y la configuracin de los componentes de servidor, abra IBM Cognos
Connection.

Pasos
1. En el explorador Web, escriba la direccin URL para abrir IBM Cognos Connection:
Por ejemplo, escriba
http://nombreservidor/cognos8
2. En la pgina de bienvenida, haga clic en Contenido de IBM Cognos.
Cuando haya completado la configuracin inicial de IBM Cognos 8 PowerPlay, podr instalar IBM
Cognos 8 PowerPlay Client "Instalacin y configuracin de los componentes de cliente y de
modelado" (p. 151). Tambin puede personalizar los componentes que utilizar en su entorno cambiando otros valores de IBM Cognos Configuration (p. 213).

Administracin de PowerPlay
Para cambiar los valores de tiempo de ejecucin de IBM Cognos 8 PowerPlay, utilice IBM Cognos
Administration, al que se accede a travs del portal de IBM Cognos 8. Por ejemplo, puede habilitar
o deshabilitar distribuidores y servicios o configurar permisos para usuarios, grupos y roles. Para
obtener ms informacin, consulte la Gua de administracin y seguridad. Tambin puede configurar
las opciones de migracin y de informes y cubos de PowerPlay. Para obtener ms informacin,
consulte la Gua de migracin y administracin.

Prueba de los servicios de migracin


Puede probar la instalacin del servicio de migracin de IBM Cognos 8 comprobando que el icono
del ayudante para la migracin aparezca en IBM Cognos Administration.

Pasos
1. En IBM Cognos Connection, en la barra de herramientas, haga clic en Iniciar, IBM Cognos
Administration.
2. Haga clic en la pestaa Configuracin.
3. Haga clic en Administracin de contenido.
El botn del Ayudante para la migracin aparece en la barra de herramientas.
Antes de utilizar el ayudante para la migracin con el fin de migrar contenido de IBM Cognos
Series 7 desde PowerPlay Enterprise Server, Upfront e IBM Cognos Connection, deber instalar los
componentes de migracin con IBM Cognos Series 7. Para obtener ms informacin sobre la
migracin de contenido desde IBM Cognos Series 7, consulte la Gua de administracin y migracin
de IBM Cognos 8 PowerPlay.

Gua de instalacin y configuracin 99

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo

Instalacin y configuracin de la migracin en equipos de IBM


Cognos Series 7
Despus de instalar los componentes de IBM Cognos 8 PowerPlay, puede instalar componentes de
migracin de IBM Cognos Series 7 para poder realizar la migracin de contenido de PowerPlay
desde IBM Cognos Series 7 a IBM Cognos 8 PowerPlay. Los componentes de migracin de IBM
Cognos Series 7 estn disponibles para Windows y UNIX en el CD de IBM Cognos 8 PowerPlay
Server.
Utilice de la siguiente lista de comprobacin como gua para realizar las tareas de instalacin y
configuracin de la migracin de IBM Cognos 8.

Instale los componentes de migracin de IBM Cognos Series 7.

Configure los componentes de migracin de IBM Cognos Series 7, si es necesario.

Inicie el servicio de migracin de IBM Cognos Series 7.

Instalacin de los componentes de migracin de IBM Cognos Series 7


Asegrese de que las instalaciones de IBM Cognos Series 7 funcionan correctamente antes de instalar
los componentes de migracin de IBM Cognos Series 7. Esto implica que deben estar en ejecucin
el servicio IBM Cognos Series 7 PowerPlay Enterprise Server y los servicios de Upfront, incluidos
el servicio de administracin de IBM Cognos Upfront, el almacn de datos de IBM Cognos Upfront
y los servicios del distribuidor de IBM Cognos Upfront.
Los componentes de migracin de IBM Cognos Series 7 se instalan en los equipos de IBM Cognos
Series 7.

Para migrar contenido desde PowerPlay Enterprise Server, debe instalar componentes de
migracin de IBM Cognos Series 7 en el equipo de PowerPlay Enterprise Server. Si Upfront se
encuentra en el mismo equipo, tambin es posible migrar contenido desde Upfront. La instalacin
de componentes de migracin en el equipo de PowerPlay Enterprise Server es tambin compatible con la migracin del contenido de PowerPlay que se public en Cognos Connection.

Para migrar el contenido de Upfront, debe instalar componentes de migracin de IBM Cognos
Series 7 en el equipo de Upfront. Cuando Upfront y PowerPlay Enterprise Server se encuentran
instalados en equipos distintos, debe instalar componentes de migracin de IBM Cognos Series 7
tanto en el equipo de PowerPlay Enterprise Server como en el de Upfront. Adems, debe preparar
y configurar una ubicacin de red compartida para permitir el procesamiento de la migracin.

Pasos
1. Inserte el CD de IBM Cognos 8 PowerPlay Server indicado para su sistema operativo. En UNIX,
debe montar el CD utilizando extensiones de archivo Rock Ridge.
2. Si la pgina Bienvenido no aparece, siga estos pasos:

En Windows, en el directorio win32 del CD, haga doble clic en el archivo isseteup.exe.

En UNIX, en el directorio indicado para su sistema operativo, escriba


./issetup

100 PowerPlay

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


3. Seleccione el idioma que desea utilizar en la instalacin.
El idioma que seleccione determinar el idioma del asistente para instalacin.
4. Siga las indicaciones del asistente para instalacin.
5. En la pgina Seleccin de componentes, borre todos los componentes excepto Componentes
de migracin de IBM Cognos Series 7.
6. En la pgina Varias ubicaciones de instalacin, especifique la ubicacin de IBM Cognos Series 7
en la que desea instalar los componentes.
Debe instalar los componentes de migracin de IBM Cognos Series 7 en el mismo directorio
que IBM Cognos Series 7 versin 4 (7.4).
Si se le solicita la ubicacin de instalacin de IBM Cognos 8, puede aceptar la ubicacin predeterminada o introducir una nueva ubicacin local. Esta ubicacin se utiliza para escribir los
archivos de instalacin. No es necesario que especifique la ruta de acceso a una instalacin de
IBM Cognos 8 en un equipo diferente, y tampoco precisa disponer de componentes de IBM
Cognos 8 en el equipo con IBM Cognos Series 7.
7. En la pgina Informacin de configuracin de migracin, en Nmero de puerto del servicio de
migracin, escriba el nmero de puerto que utilizar el servicio de migracin de IBM Cognos
Series 7. El valor predeterminado es 21567.
8. En la pgina Finalizar, haga clic en Finalizar.
Al igual que otros productos de IBM Cognos, el proceso de instalacin crea archivos de registro en
los que se incluye informacin como, por ejemplo, detalles sobre archivos transferidos o errores de
instalacin. Los archivos de registro se encuentran en el directorio ubicacin_instalacin\instlog.

Configuracin del servicio de migracin de IBM Cognos Series 7 para migraciones


desde Upfront en instalaciones de IBM Cognos Series 7 distribuidas
Si ha instalado componentes de migracin de IBM Cognos Series 7 tanto en un equipo de PowerPlay
Enterprise Server como en un equipo de Upfront aparte, debe preparar y configurar una ubicacin
de red compartida. El servicio de migracin escribe archivos temporales en esta ubicacin durante
el proceso de migracin.
A la hora de migrar desde Upfront cuando PowerPlay Enterprise Server y Upfront estn en equipos
distintos, se aplican las siguientes limitaciones.

Notas

PowerPlay Enterprise Server y Upfront deben acceder a los PowerCubes utilizando la misma
ruta de acceso, como \\nombre_mquina\cubes. Si los cubos se encuentran en el mismo equipo
que PowerPlay Enterprise Server, PowerPlay Enterprise Server acceder a los cubos utilizando
una ruta local, mientras que Upfront acceder a los cubos utilizando una ruta que incluye el
nombre del equipo de PowerPlay Enterprise. La migracin desde Upfront no funcionar en esta
situacin.

Gua de instalacin y configuracin 101

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo

No se puede realizar una migracin desde Upfront si se utiliza ms de un equipo de PowerPlay


Enterprise Server para publicar contenido en Upfront.

Pasos
1. Cree una carpeta en una ubicacin de red compartida a la que se pueda acceder tanto desde el
equipo de PowerPlay Enterprise Server como desde el equipo de Upfront.
Asegrese de que los servicios de migracin de PowerPlay Enterprise Server, Upfront e IBM
Cognos Series 7 se ejecuten mediante cuentas con nombre que tengan acceso de escritura sobre
la carpeta.
2. Realice los pasos siguientes en cada equipo que tenga componentes de migracin de IBM
Cognos Series 7.

Desde ubicacin_instalacin/mig7service, abra el archivo migs7service_configuration.xml


en un editor de XML o texto.

Edite la lnea series7-shared-location description para especificar la ubicacin de red y


activar la lnea (quite las etiquetas de comentario). Por ejemplo:
<series7-shared-location description="Ruta a la carpeta compartida">\\bott93\shareT\
s7migration</ubicacin-compartida-de-series7>

Guarde y cierre el archivo.

3. Reinicie el servicio de migracin de IBM Series 7.


La configuracin para permitir la migracin desde equipos de PowerPlay Enterprise Server y Upfront
independientes ha terminado.

Inicio del servicio de migracin de IBM Cognos Series 7


Para poder migrar contenido de IBM Cognos Series 7 PowerPlay a IBM Cognos 8 PowerPlay, debe
iniciar el servicio de migracin para IBM Cognos Series 7. En Windows, el servicio de migracin
de IBM Cognos Series 7 se inicia automticamente cuando se instala por primera vez.

Paso

Inicie el servicio de migracin:

En Windows, si se detiene el servicio, reinicie el servicio de migracin utilizando la entrada


Servicio de migracin de IBM Cognos Series 7 que se encuentra en la opcin Servicios de
Herramientas administrativas.

En UNIX, vaya al directorio ubicacin_c8/migs7 e inicie el servicio escribiendo


./configure.sh --start

Desinstalacin de IBM Cognos 8


Es importante utilizar los programas de desinstalacin de IBM Cognos 8 para eliminar los productos
de IBM Cognos 8.

102 PowerPlay

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Si ejecuta IBM Cognos 8 en un entorno de servidor de aplicaciones, utilice la herramienta de
administracin del proveedor del servidor de aplicaciones para detener la aplicacin si se est ejecutando y anule la implementacin de la parte Java de los componentes de IBM Cognos 8. Muchos
servidores de aplicaciones no eliminan completamente todos los archivos o directorios de las aplicaciones implementadas durante una anulacin de implementacin, por lo que puede que tenga
que hacerlo manualmente. Despus de haber anulado la implementacin de los componentes de
IBM Cognos 8, complete los pasos para desinstalar en UNIX y en Windows, segn sea necesario.
Los componentes de migracin de IBM Cognos 8 se desinstalan al desinstalar el propio IBM Cognos
8. Sin embargo, los componentes de migracin de IBM Cognos Series 7 se pueden desinstalar por
separado de la instalacin de IBM Cognos Series 7 (p. 106).

Desinstalacin de IBM Cognos 8 en UNIX o Linux


Si ya no necesita IBM Cognos 8 o si va a realizar la actualizacin, desinstale IBM Cognos 8.
Le recomendamos que cierre todos los programas antes de desinstalar IBM Cognos 8. De lo contrario,
algunos archivos no pueden eliminarse.

Pasos
1. Si la consola adjunta a su equipo no admite una interfaz grfica de usuario basada en Java,
determine el identificador de proceso (pid) del proceso IBM Cognos 8 escribiendo el siguiente
comando:
ps -ef | grep cogbootstrapservice
2. Detenga el proceso IBM Cognos 8:

Si trabaja con XWindows, inicie IBM Cognos Configuration y en el men Acciones, haga
clic en Detener.

Si no trabaja con XWindows, escriba:


kill -TERM pid

3. Para desinstalar IBM Cognos 8, vaya al directorio ubicacin_c8/uninstall y escriba el comando


apropiado:

Si utiliza XWindows, escriba


./uninst -u

Si no utiliza XWindows, realice una desinstalacin sin participacin del usuario (p. 317).

4. Siga las instrucciones para completar la desinstalacin.


5. Elimine todos los archivos temporales de Internet.
La desinstalacin no elimina ningn archivo que haya cambiado desde la instalacin, como los
archivos de datos de usuario y configuracin. La ubicacin de la instalacin permanece en su equipo
y estos archivos se mantienen hasta que los elimine manualmente.
Importante: No elimine los archivos de configuracin y de datos si est actualizando a una nueva
versin de IBM Cognos 8 y desea utilizar los datos de configuracin con la nueva versin.

Gua de instalacin y configuracin 103

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo

Desinstalacin de IBM Cognos 8 en Windows


Si ya no necesita IBM Cognos 8 o si va a realizar la actualizacin, desinstale todos los componentes
y el servicio de IBM Cognos 8.
Si ha instalado ms de un componente o producto de IBM Cognos 8 en la misma ubicacin, el
asistente para desinstalacin le permitir seleccionar los paquetes que debe desinstalar. Se desinstalarn todos los componentes del paquete. Debe repetir el proceso de desinstalacin en cada equipo
que contenga componentes de IBM Cognos 8.
No es necesario realizar copias de seguridad de la configuracin y los archivos de datos en Windows.
Estos archivos se conservan durante la desinstalacin.
Le recomendamos que cierre todos los programas antes de desinstalar IBM Cognos 8. De lo contrario,
algunos archivos no pueden eliminarse.

Pasos
1. En el men Inicio, haga clic en Programas, IBM Cognos 8, Desinstalar IBM Cognos 8.
Aparece el asistente Desinstalar.
Sugerencia: IBM Cognos 8 es el nombre predeterminado de la carpeta de programa que se crea
durante la instalacin. Si elige otro nombre, vaya a esa carpeta para encontrar el programa.
2. Siga las instrucciones para desinstalar los componentes.
El archivo cognos_uninst_log.txt registra las actividades que realiza el asistente para desinstalacin mientras efecta la desinstalacin de archivos. Este archivo de registro se crea en el
directorio temp.
3. Elimine todos los archivos temporales de Internet.
Para obtener ms informacin, consulte la documentacin del explorador Web.
La desinstalacin no elimina ningn archivo que haya cambiado desde la instalacin, como los
archivos de datos de usuario y configuracin. La ubicacin de la instalacin permanece en su equipo
y estos archivos se mantienen hasta que los elimine por medio del Explorador de Windows.
Importante: No elimine los archivos de configuracin y de datos si est actualizando a una nueva
versin de IBM Cognos 8 y desea utilizar los datos de configuracin con la nueva versin.

Desinstalacin de la base de datos de contenido de Cognos


Si desea desinstalar slo la base de datos de contenido y conservar otros componentes de IBM
Cognos 8 en su equipo, deber utilizar el siguiente procedimiento. Despus de desinstalar la base
de datos de contenido, deber configurar un nuevo almacn de contenido antes de poder reiniciar
el servicio de IBM Cognos 8.

104 PowerPlay

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Si ha instalado slo la base de datos de contenido de Cognos, utilice otro procedimiento. Para
obtener informacin acerca de este procedimiento, consulte "Desinstalacin de IBM Cognos 8 en
UNIX o Linux" (p. 103) o "Desinstalacin de IBM Cognos 8 en Windows" (p. 104).

Pasos
1. En el equipo en el que ha instalado la base de datos de contenido de Cognos, vaya al directorio
ubicacin_c8\bin y escriba el siguiente comando:

En Windows, escriba
derby.bat uninstall
Este comando elimina el servicio de la base de datos de contenido de Cognos.

En UNIX, escriba
derby.sh stop
Este comando detiene el servicio de la base de datos de contenido de Cognos.

2. En el directorio ubicacin_c8, elimine el directorio derby10.1.2.1.


3. En el directorio ubicacin_c8\bin, elimine los siguientes archivos:

En Windows, derby.bat

En UNIX, derby.sh y derbyenv.sh

4. En Windows, en el directorio ubicacin_c8\logs, elimine el archivo derby.service.


5. En el directorio ubicacin_c8, abra el archivo cmplst.txt en un editor de texto.
6. Elimine las lneas que contengan valores de la base de datos de contenido de Cognos. Las lneas
contienen los caracteres CCD y CMDERBY. Por ejemplo:
C8BISRVRCCD_version=
C8BISRVRCCD_name=
CCD_version=
CCD_name=
CMDERBY_version=
CMDERBY_name=

Sugerencia: Tambin puede convertir las lneas en comentarios mediante la insercin de # al


comienzo de cada lnea.
7. Guarde el archivo.
8. Inicie IBM Cognos Configuration.
9. En Acceso a datos, Content Manager, haga lo siguiente:

Elimine la base de datos de contenido de Cognos.

Configure un nuevo recurso de base de datos que apunte a un nuevo almacn de contenido.

Gua de instalacin y configuracin 105

Captulo 6: Instalacin y configuracin de IBM Cognos 8 PowerPlay en un equipo


Para obtener ms informacin, consulte "Configuracin de las propiedades de la conexin a
la base de datos en el almacn de contenido" (p. 89).
10. Reinicie IBM Cognos 8.

Desinstalacin de los componentes de migracin


Los componentes de migracin de IBM Cognos 8 se desinstalan al desinstalar el propio IBM Cognos
8. No es posible desinstalar nicamente los componentes de migracin de una instalacin de IBM
Cognos 8.
Sin embargo, los componentes de migracin de IBM Series 7 se pueden desinstalar por separado
de la instalacin de IBM Cognos Series 7. Una vez terminada la migracin desde IBM Cognos
Series 7, puede optar por desinstalar los componentes de migracin de cada uno de los equipos en
los que est instalado IBM Cognos Series 7. Sin embargo, los componentes de migracin slo estn
activos durante la migracin y no afectarn a la instalacin de IBM Cognos Series 7 si decide no
desinstalar los componentes de migracin.

Paso

En los equipos IBM Cognos Series 7, desinstale el componente Migracin de informes de IBM
Cognos desde Series 7.
Para obtener ms informacin acerca de la desinstalacin de los componentes de IBM Cognos
Series 7, consulte IBM Cognos Series 7 Solution Installation Guide.

106 PowerPlay

Captulo 7: Instalacin y configuracin de los


componentes del servidor PowerPlay de IBM Cognos
8 en una instalacin distribuida
Puede instalar componentes del servidor en varios equipos. Para obtener ms informacin, consulte
"Opciones de distribucin de IBM Cognos 8" (p. 27).
Los componentes de migracin de IBM Cognos 8 se incluyen con la instalacin de IBM Cognos 8
PowerPlay. Dichos componentes admiten la migracin de contenido de PowerPlay de IBM Cognos
Series 7 a IBM Cognos 8. Adems, si instala IBM Cognos 8 PowerPlay con IBM Cognos 8, los
componentes de migracin admiten la opcin de abrir un informe de PowerPlay Studio en Analysis
Studio o Report Studio.
Los componentes de migracin de IBM Cognos Series 7 estn disponibles con IBM Cognos 8
PowerPlay. Para migrar el contenido de IBM Cognos Series 7 PowerPlay a IBM Cognos 8 PowerPlay,
debe instalar los componentes de migracin de IBM Cognos Series 7 en el equipo en el que est
instalado IBM Cognos Series 7 PowerPlay Enterprise Server. Si desea migrar contenido de PowerPlay
desde Upfront, tambin deber instalar los componentes de migracin de IBM Cognos Series 7 en
el equipo en el que se haya instalado Upfront.
Utilice el asistente para instalacin para seleccionar los componentes del servidor que desee instalar
y la ubicacin del equipo donde desea instalarlos. Slo se copiarn del CD al equipo los componentes
que seleccione para instalar.
Se recomienda realizar una instalacin interactiva (p. 109).
En este captulo se incluye tambin informacin sobre la desinstalacin de IBM Cognos 8. Para
obtener ms informacin, consulte "Desinstalacin de IBM Cognos 8" (p. 146).
Tambin puede instalar todos los componentes de IBM Cognos 8 en un equipo. Para obtener ms
informacin, consulte "Instalacin y configuracin de IBM Cognos 8 PowerPlay en un
equipo" (p. 79).
Si desea instalar una configuracin idntica en varios equipos de la red, o automatizar el proceso
de instalacin y configuracin, puede configurar una instalacin y una configuracin sin asistencia
(p. 317).
Si los modeladores desean crear paquetes relacionales o de origen mixto para trabajar con Analysis
Studio, Report Studio o Query Studio, necesitar la herramienta de modelado de IBM Cognos 8:
Framework Manager. Si los modeladores desean crear PowerCubes, necesita IBM Cognos 8
Transformer. Si los modeladores desean crear PowerCubes desde orgenes relacionales, necesita
Framework Manager e IBM Cognos 8 Transformer. Para obtener informacin sobre la instalacin
de Framework Manager e IBM Cognos 8 Transformer, consulte IBM Cognos 8 Business Intelligence
Gua de instalacin y configuracin que se suministra con los componentes de modelado.
Las siguientes restricciones se aplican a una instalacin distribuida:

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

107

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida

Si desea instalar dos o ms componentes de IBM Cognos 8 en el mismo equipo, es recomendable


instalarlos en la misma ubicacin de instalacin para evitar los conflictos entre puertos y otros
valores predeterminados.

Si desea utilizar ejemplos, debe instalarlos desde el CD IBM Cognos 8 Business Intelligence
Samples. Para obtener ms informacin, consulte "Instalacin de los ejemplos de IBM Cognos 8" (p. 158).

En UNIX, para ejecutar la instalacin en modo grfico, la consola asociada al equipo de UNIX
debe admitir una interfaz grfica de usuario basada en Java.

En UNIX, IBM Cognos 8 respeta la mscara de creacin de modo de archivo (umask) de la


cuenta que ejecuta el programa de instalacin. Esto slo afecta a los directorios de instalacin.
No afecta a los permisos de archivos de los directorios. Sin embargo, los archivos generados
en tiempo de ejecucin, como los registros, respetan la mscara. Se recomienda utilizar el valor
umask 022 en el directorio de instalacin.

Al instalar componentes de IBM Cognos 8 en ms de un equipo, debe configurar las propiedades


de entorno de manera que los componentes distribuidos se puedan comunicar entre ellos.
Tambin debe configurar las propiedades criptogrficas para asegurarse de que cada equipo utilice
los mismos valores.
En un entorno distribuido, la secuencia en la que se configuren los equipos la primera vez es
importante. Debe configurar e iniciar los servicios en, al menos, un equipo donde haya instalado
Content Manager, antes de configurar otros equipos en el entorno de IBM Cognos. Debe configurar
el equipo de la puerta de enlace en ltimo lugar, de tal manera que se compartan las claves criptogrficas y se pueda establecer una comunicacin segura entre los tres componentes. El servidor
especificado para la propiedad URI de distribuidor externo del equipo de la puerta de enlace debe
ser el ltimo en iniciarse.
Antes de empezar la instalacin, asegrese de que se cumplen los siguientes requisitos previos:

Complete las tareas descritas en la seccin "Configuracin del entorno" (p. 39).

Si est instalando IBM Cognos 8 en un entorno de servidor de aplicaciones, debe tener en cuenta
los requisitos de la instalacin. Para obtener ms informacin, consulte "Configuracin de IBM
Cognos 8 para un servidor de aplicaciones" (p. 287).

Si est instalando IBM Cognos 8 PowerPlay con IBM Cognos 8 Business Intelligence Server,
se recomienda instalar y configurar antes IBM Cognos 8 Business Intelligence Server. Ambos
productos deben ser de la misma versin. Para obtener ms informacin, consulte "Productos
de IBM Cognos que interoperan con IBM Cognos 8 PowerPlay" (p. 33).

Utilice la siguiente lista de comprobacin como gua para realizar las tareas necesarias para instalar
y configurar IBM Cognos 8 PowerPlay en ms de un equipo.

108 PowerPlay

Instale y configure Content Manager.

Instale y configure los componentes de nivel de aplicacin en el servidor PowerPlay.

Instale y configure la puerta de enlace.

Instale y configure los componentes de migracin en los equipos de IBM Cognos Series 7.

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Cuando haya completado la configuracin inicial de IBM Cognos 8 PowerPlay, podr instalar IBM
Cognos 8 PowerPlay Client "Instalacin y configuracin de los componentes de cliente y de
modelado" (p. 151). Tambin puede personalizar los componentes que utilizar en su entorno cambiando otros valores de IBM Cognos Configuration (p. 213).

Administracin de PowerPlay
Para cambiar los valores de tiempo de ejecucin de IBM Cognos 8 PowerPlay, utilice IBM Cognos
Administration, al que se accede a travs del portal de IBM Cognos 8. Por ejemplo, puede habilitar
o deshabilitar distribuidores y servicios o configurar permisos para usuarios, grupos y roles. Para
obtener ms informacin, consulte la Gua de administracin y seguridad. Tambin puede configurar
las opciones de migracin y de informes y cubos de PowerPlay. Para obtener ms informacin,
consulte la Gua de migracin y administracin de IBM Cognos 8 PowerPlay.

Recomendacin: instalar los componentes de servidor en modo


interactivo
Para efectuar una instalacin completa, debe instalar los componentes en su servidor y, a continuacin, configurarlos para que funcionen en su entorno.
Los programas de instalacin y configuracin de IBM Cognos se ejecutan por lo general en modo
interactivo. Esto implica que, en una interfaz de usuario grfica, el instalador le solicitar que proporcione informacin y la herramienta de configuracin le permitir modificar los valores predeterminados.
Puede optar por otros mtodos de instalacin de los componentes de servidor.

Modo silencioso
Es posible automatizar la instalacin de componentes utilizando archivos de respuesta y ejecutando
el programa de instalacin en modo silencioso.
Para obtener informacin sobre instalaciones en modo silencioso, consulte "Cmo establecer instalaciones y configuraciones sin participacin del usuario" (p. 317).
Tambin es posible automatizar la configuracin de componentes exportando los valores de configuracin de un equipo a otro siempre que los componentes instalados sean los mismos. Esto implica
que, la primera vez que ejecute IBM Cognos Configuration, deber hacerlo en modo interactivo.
La otra opcin es editar el archivo cogstartup.xml haciendo uso de los valores aplicables a su entorno
y, a continuacin, ejecutar la herramienta de configuracin en modo silencioso.

Modo interactivo
A menos que tenga la intencin de realizar una instalacin en modo silencioso, se recomienda instalar el software desde una estacin de trabajo de sistema Windows X, un terminal X o un PC u
otro sistema con el software de servidor X instalado.
Para ejecutar una instalacin en modo interactivo, la consola asociada al equipo debe admitir una
interfaz grfica de usuario basada en Java.

Gua de instalacin y configuracin 109

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida

Instalacin y configuracin de equipos de Content Manager


En una instalacin distribuida, al menos uno de los equipos donde instale Content Manager debe
estar configurado, en funcionamiento y accesible antes de que se configuren otros equipos en el
entorno de IBM Cognos. As, se garantiza que el servicio de la entidad emisora de certificados,
instalado con Content Manager, est disponible para emitir certificados a otros equipos de IBM
Cognos.
Los equipos de Content Manager deben conocer la ubicacin del almacn de contenido, de otros
equipos de Content Manager y de la base de datos de notificaciones que se utiliza para la informacin
sobre trabajos y planificacin.
La instalacin puede incluir ms de un Content Manager, cada uno en un equipo distinto. Un equipo
de Content Manager est activo y hay uno o varios equipos de Content Manager que se encuentran
en espera. Los equipos de Content Manager en espera se encargan de la proteccin de tipo migracin
tras error. Si el equipo de Content Manager no est disponible debido a un fallo de hardware o
software, las solicitudes se empiezan a dirigir al equipo en espera de Content Manager, que pasa a
estar activo.
Cuando falla el equipo Content Manager activo, se pierden los datos de la sesin que no se han
guardado. Cuando otro Content Manager pasa a estar activo, es posible que se solicite a los usuarios
que inicien la sesin.
El primer equipo de Content Manager que se inicie pasar a ser el Content Manager activo predeterminado. Puede designar otro equipo de Content Manager como activo de forma predeterminada,
mediante la herramienta de administracin. Para obtener ms informacin sobre cmo activar un
servicio de Content Manager, consulte la Gua de administracin y seguridad.
Para admitir la proteccin de tipo migracin tras error, debe sincronizar los relojes del sistema en
los equipos de Content Manager. Si utiliza la puerta de enlace CGI predeterminada, se recomienda
configurar IBM Cognos 8 para utilizar una puerta de enlace ISAPI en su lugar. De lo contrario, el
rendimiento se podra ver afectado despus de la migracin tras error.
Antes de configurar Content Manager, asegrese de haber creado la base de datos para el almacn
de contenido en un equipo disponible de la red.
Si desea utilizar la base de datos de contenido de Cognos como almacn de contenido, deber
seleccionarla en el asistente de instalacin. Si instala componentes en varios equipos, slo necesitar
instalar una base de datos de contenido de Cognos. Si instala la base de datos de contenido de
Cognos en el mismo equipo que Content Manager y, ms adelante, decide utilizar otra base de
datos para el almacn de contenido, debe desinstalar la base de datos de contenido de Cognos.
Utilice la siguiente lista de comprobacin como gua en las tareas de configuracin necesarias para
los equipos de Content Manager.

110 PowerPlay

Instale Content Manager.

Actualice el entorno Java.

Configure la conectividad de la base de datos del almacn de contenido.

Inicie IBM Cognos Configuration.

Configure las propiedades de conexin de la base de datos para el almacn de contenido.

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida

Especifique una cuenta de servidor de correo.

Configure las propiedades del entorno.

Configure un espacio de nombre de IBM Cognos Series 7 en IBM Cognos 8, si es necesario.

Inicie el servicio IBM Cognos 8 en Content Manager.

Pruebe la instalacin de Content Manager.

Instalacin de los componentes de Content Manager


Para instalar Content Manager, utilice el CD del sistema operativo. En el asistente de instalacin,
borre todos los componentes excepto Content Manager. Si desea usar la base de datos de contenido
de Cognos, seleccione tambin dicho componente, a menos que desee instalarlo en un servidor
independiente.
Si instala varios Content Managers, debe asegurarse de que los relojes de sistema de los equipos
Content Manager estn sincronizados para que la migracin tras error entre Content Managers sea
correcta.
Si va a utilizar PowerCubes que estn protegidos contra espacios de nombre de IBM Cognos Series 7,
debe instalar Content Manager en un equipo que admita IBM Cognos Series 7.

Pasos para UNIX y Linux


1. Si est realizando la instalacin en un directorio que tiene otros componentes de IBM Cognos
8, detenga el servicio IBM Cognos 8.
2. Configure la variable de entorno JAVA_HOME para que apunte a la ubicacin de instalacin
de su entorno en tiempo de ejecucin de Java (JRE).
Un ejemplo de ubicacin de instalacin del entorno en tiempo de ejecucin de Java es /directorio/java/versin_java/jre.
IBM Cognos 8 requiere una JVM, como IBM Java, para ejecutarse en Linux.
3. En HP-UX, configure la variable de entorno _M_ARENA_OPTS como se indica a continuacin:
_M_ARENA_OPTS 1:4
De este modo, se aumenta la asignacin de memoria para HP-UX, a fin de que coincida lo
mximo posible con la de otras plataformas de UNIX.
4. En AIX, configure la variable de entorno AIXTHREAD_SCOPE como se indica a continuacin:
AIXTHREAD_SCOPE=S
De este modo, se establece el mbito de contencin de los subprocesos del usuario en todo el
sistema, lo que permite una planificacin ms eficaz de los subprocesos del usuario.
5. Monte el CD de su producto de IBM Cognos utilizando extensiones de archivo Rock Ridge.
Importante: Para montar el CD de IBM Cognos en HP-UX, siga estos pasos:

Aada el directorio pfs_mount a su ruta.


Por ejemplo:
Gua de instalacin y configuracin 111

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
PATH=/usr/sbin/:$PATH
export PATH

Para iniciar los daemons de NFS y ejecutar los daemons en segundo plano, escriba bg
pfs_mountd y, a continuacin, bg pfsd.

Para montar la unidad, escriba


pfs_mount -t rrip <dispositivo><dir_montaje> -o xlat=unix
Por ejemplo:
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix
Ahora ya puede instalar o copiar archivos como usuario distinto al usuario raz utilizando
un CD de IBM Cognos desde esta unidad.

Cuando haya completado la instalacin, escriba pfs_umount /cdrom y cancele los daemons
pfsd y pfs_mountd para desmontar el CD.

6. Vaya al directorio del CD correspondiente a su sistema operativo.


Por ejemplo, para Solaris, vaya al directorio de Solaris.
7. Inicie el asistente para instalacin:

Si utiliza XWindows, escriba ./issetup.


Nota: Si utiliza el comando issetup con XWindows, se podran daar los caracteres japoneses en mensajes y archivos de registro. Cuando instale en japons en UNIX o Linux,
deber configurar primero las variables del entorno LANG=C y LC_ALL=C (donde C es
el cdigo del idioma, por ejemplo ja_JP.PCK en Solaris), y despus iniciar el asistente de
instalacin.

Si no utiliza XWindows, realice una instalacin sin participacin del usuario (p. 317).

8. Siga las indicaciones del asistente para la instalacin y copie los archivos necesarios en el equipo.
Instale Content Manager en un directorio que contenga slo caracteres ASCII en el nombre de
ruta. Algunos servidores Web UNIX y Linux no admiten caracteres no ASCII en los nombres
de directorio.
Si instala en un equipo que ya tiene ReportNet y desea mantener ReportNet, debe instalar IBM
Cognos 8 en un directorio diferente.
Si realiza la instalacin en un directorio que contiene otros componentes de IBM Cognos 8, se
le pedir que indique la ubicacin de un directorio para poder almacenar copias de seguridad
de los archivos que se sobrescribirn.
9. En la pgina Finalizar del asistente para instalacin, elija alguna de las siguientes opciones:

Le recomendamos que no configure IBM Cognos 8 inmediatamente, ya que debe realizar


antes otras tareas para asegurarse de que su entorno est configurado correctamente. Sin
embargo, si la consola adjunta a su equipo admite una interfaz de usuario grfica basada
en Java, puede hacer clic en Inicio de IBM Cognos Configuration.

112 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida

Si la consola adjunta a su equipo no admite una interfaz de usuario grfica basada en Java,
haga clic en Finalizar.
Puede configurar IBM Cognos 8 ms tarde mediante IBM Cognos Configuration, iniciando
cogconfig.sh en el directorio ubicacin_c8/bin, o editando cogstartup.xml en el directorio
ubicacin_c8/configuration.

10. Aada el directorio ubicacin_c8/bin a la variable de entorno de la ruta de biblioteca


correspondiente.

Para Solaris y Linux, LD_LIBRARY_PATH

Para AIX, LIBPATH

Para HP-UX, SHLIB_PATH

11. En Linux, configure la variable de entorno PRINTER con el nombre de la impresora.


Si desea instalar la base de datos de contenido de Cognos en un equipo diferente, ejecute el asistente
de instalacin en su servidor de base de datos y seleccione nicamente el componente de la base de
datos de contenido de Cognos.
Si desea que los usuarios puedan ver documentacin del producto en un idioma diferente al ingls,
deber instalar el componente Supplementary Languages Documentation en la misma ubicacin
que los componentes de la puerta de enlace. Para obtener ms informacin, consulte "Instalar
documentacin de producto traducida" (p. 166).

Pasos para Windows


1. Si est realizando la instalacin en un directorio que tiene otros componentes de IBM Cognos
8, detenga el servicio IBM Cognos 8.
2. Inserte el CD del producto de IBM Cognos.
Aparece la pgina de bienvenida del asistente para la instalacin.
3. Si no aparece la pgina Bienvenido, haga doble clic en el archivo issetup.exe del directorio
win32 del CD.
4. Seleccione el idioma que desea utilizar en la instalacin.
El idioma que seleccione determina el idioma de la interfaz de usuario. Puede cambiar el idioma
a cualquiera de los idiomas instalados despus de la instalacin.
5. Siga las indicaciones del asistente para la instalacin para copiar los archivos necesarios en el
equipo.
Instale Content Manager en un directorio que contenga slo caracteres ASCII en el nombre de
ruta. Algunos servidores Web de Windows no admiten caracteres que no son ASCII en los
nombres de directorio.
Si instala en un equipo que ya tiene ReportNet y quiere mantener ReportNet en ejecucin, debe
instalar IBM Cognos 8 en un directorio diferente.

Gua de instalacin y configuracin 113

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Si realiza la instalacin en un directorio que contiene otros componentes de IBM Cognos 8, se
le pedir que indique la ubicacin de un directorio para poder almacenar copias de seguridad
de los archivos que se sobrescribirn.
6. En la pgina Finalizar del asistente para instalacin,

Si desea configurar inmediatamente los componentes de IBM Cognos, haga clic en Inicio
de IBM Cognos Configuration.

Si desea ver la informacin de ltima hora acerca de los componentes de IBM Cognos,
haga clic en Ver Lame.

7. Haga clic en Finalizar.


Utilice el men Inicio de Windows para iniciar IBM Cognos Configuration desde la carpeta de
acceso directo.
Si desea instalar la base de datos de contenido de Cognos en un equipo diferente, ejecute el asistente
de instalacin en su servidor de base de datos y seleccione nicamente el componente de la base de
datos de contenido de Cognos.
Si desea que los usuarios puedan ver documentacin del producto en un idioma diferente al ingls,
deber instalar el componente Supplementary Languages Documentation en la misma ubicacin
que los componentes de la puerta de enlace. Para obtener ms informacin, consulte "Instalar
documentacin de producto traducida" (p. 166).

Instalacin de la base de datos de contenido de Cognos en un servidor independiente


Si desea instalar la base de datos de contenido de Cognos en un servidor independiente, deber
hacerlo antes de configurar Content Manager. En el asistente de instalacin, borre todos los componentes y seleccione nicamente la base de datos de contenido de Cognos.

Pasos
1. En el servidor de base de datos, inserte el CD de su producto de IBM Cognos.
En UNIX o Linux, monte el CD utilizando extensiones de archivo Rock Ridge.
2. Si no aparece la pgina Bienvenido, inicie el asistente de instalacin:

En UNIX o Linux, en el directorio indicado para su sistema operativo, escriba ./issetup.

En Windows, en el directorio win32 del CD, haga doble clic en issetup.exe.

3. Siga las indicaciones del asistente para la instalacin y copie los archivos necesarios en el equipo.
Haga la instalacin en un directorio que contenga slo caracteres ASCII en el nombre de ruta.
Algunos servidores Web UNIX y Linux no admiten caracteres no ASCII en los nombres de
directorio.
4. En la pgina Finalizar del asistente para la instalacin, haga clic en Finalizar.

114 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida

Actualizacin del entorno Java en el equipo de Content Manager


Los archivos criptogrficos de IBM Cognos 8 utilizan un archivo .jar (Java Archive), denominado
bcprov-jdknn-nnn.jar, que debe encontrarse en el entorno en tiempo de ejecucin de Java (JRE).
Este archivo proporciona rutinas de codificacin y descodificacin que no forman parte de una
instalacin predeterminada de JVM. Para garantizar la seguridad, la JVM debe cargar el archivo
de codificacin mediante el directorio de extensiones de Java.
Si desea utilizar su propio JRE y establecer la variable JAVA_HOME en esa ubicacin de Windows,
o si est realizando la instalacin en UNIX, es posible que tenga que actualizar los entornos Java
de los servicios criptogrficos.
En Windows, puede configurar JAVA_HOME como variable del sistema o variable de usuario. Si
la configura como variable del sistema, es posible que tenga que reiniciar el equipo para que surta
efecto. Si la configura como variable de usuario, hgalo de tal manera que el entorno en el que se
ejecute Tomcat pueda acceder a ella.
Si no tiene una variable JAVA_HOME ya definida en Windows, se utilizarn los archivos JRE
proporcionados con la instalacin, y no tendr que actualizar ningn archivo del entorno. Si
JAVA_HOME remite a una versin Java que no es vlida para IBM Cognos 8, deber actualizar
JAVA_HOME con la ruta correspondiente a una versin de Java vlida.

Pasos
1. Compruebe que la variable de entorno JAVA_HOME est configurada en la ubicacin del JRE.
Por ejemplo, para configurar JAVA_HOME en los archivos JRE proporcionados con la instalacin, la ruta es ubicacin_c8/bin/jre/versin.
2. Copie el archivo bcprov-jdknn-nnn.jar del directorio ubicacin_c8/bin/jre/versin/lib/ext en el
directorio ubicacin_Java/jre/lib/ext.

Configuracin de la conectividad de la base de datos para la base de datos del


almacn de contenido
Si utiliza una base de datos distinta de la base de datos de contenido de Cognos como almacn de
contenido, puede que tenga que instalar el software de cliente de la base de datos o los controladores
JDBC o ambos en cada equipo en el que instale Content Manager. Al hacerlo permite que Content
Manager acceda a la base de datos del almacn de contenido.

Pasos para DB2


1. Si va a utilizar la conectividad JDBC de tipo 2, instale el software del cliente DB2 en los equipos
de Content Manager.
Si va a utilizar la conectividad JDBC de tipo 4 para DB2, no necesita instalar el software del
cliente DB2 en el equipo en el que est instalado Content Manager.
Si va a utilizar una base de datos DB2 en z/OS como almacn de contenido, deber utilizar la
conectividad JDBC de tipo 4.

Gua de instalacin y configuracin 115

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Para obtener ms informacin sobre las diferencias entre los controladores de tipo 2 y de tipo
4, consulte "Opciones de controlador JDBC para usar bases de datos DB2 como almacn de
contenido" (p. 86).
2. Si va a utilizar una conectividad JDBC de tipo 2 y el almacn de contenido no est instalado
en el mismo equipo que Content Manager, configure un alias de base de datos para el almacn
de contenido.
En Windows, ejecute el DB2 Client Configuration Assistant.
En UNIX o Linux, utilice la interfaz de lnea de comandos de DB2.
Si tanto la base de datos del almacn de contenido como Content Manager se encuentran en
el mismo equipo, el nombre del almacn de contenido pasa a ser el alias automticamente.
Cuando configure los equipos de Content Manager, asegrese de que estn configurados para
utilizar el mismo almacn de contenido.
3. En Windows, detenga los servicios de DB2 y el servidor de bsqueda HTML.
4. Copie los siguientes archivos del directorio instalacin_DB2/sqllib/java en el directorio ubicacin_c8/webapps/p2pd/WEB-INF/lib.

Archivo del controlador universal: db2jcc.jar

Archivo de licencia
Para DB2 en Linux, UNIX o Windows, db2jcc_license_cu.jar
Para DB2 en z/OS, db2jcc_license_cisuz.jar

Si conecta con DB2 en z/OS, usa la versin del controlador de Linux, UNIX o Windows versin
9.1 fix pack 5 o versin 9.5 fix pack 2.
Sugerencia: Para comprobar la versin del controlador, ejecute el comando siguiente:
java -cp ruta\db2jcc.jar com.ibm.db2.jcc.DB2Jjcc -version
5. En Windows, reinicie los servicios de DB2 y el servidor de bsqueda HTML.
6. En UNIX, si utiliza la conectividad JDBC de tipo 2, asegrese de que las bibliotecas DB2 de
32 bits se encuentren en la ruta de bsqueda de bibliotecas, que suele ser el directorio
$DB2DIR/lib o $DB2DIR/lib32.
7. Repita el procedimiento completo en todos los equipos de IBM Cognos 8 donde haya instalado
Content Manager o donde se haya enviado una notificacin a una base de datos DB2.
Puede ajustar la base de datos para sacar provecho de las funciones de DB2. Para ms informacin,
consulte "Ajuste de un almacn de contenido DB2" (p. 329).

Pasos para Oracle


1. En el equipo en el que est instalado el cliente de Oracle, vaya al directorio ORACLE_HOME/
jdbc/lib.

116 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
2. Copie el archivo JAR correspondiente en el directorio ubicacin_c8/webapps/p2pd/WEB-INF/
lib de cada uno de los equipos donde haya instalado Content Manager y donde se haya enviado
una notificacin a una base de datos Oracle.

Si utiliza Java 1.4, copie el archivo ojdbc14.jar.

Si utiliza Java 1.5, copie el archivo ojdbc5.jar.

Si el directorio contiene el archivo classes12.jar, elimnelo antes de instalar el archivo ojdbc14.jar


o ojdbc5.jar.
El controlador est disponible desde una instalacin de servidor o un cliente de Oracle, y tambin
se puede descargar desde el sitio Web de tecnologa de Oracle (http://www.oracle.com/
technology).

Pasos para Sybase


1. En el equipo donde se haya instalado Sybase, vaya al directorio ubicacin_Sybase/jConnect-5_
5/classes.
2. Copie el archivo jconn2.jar en el directorio ubicacin_c8/webapps/p2pd/WEB-INF/lib de cada
equipo donde haya instalado Content Manager y donde se haya enviado una notificacin a
una base de datos Sybase.

Inicio de IBM Cognos Configuration en el equipo de Content Manager


Utilice la herramienta de configuracin, IBM Cognos Configuration, para configurar IBM Cognos
8, o para iniciar y detener los servicios de IBM Cognos.
Antes de iniciar IBM Cognos Configuration, asegrese de que el sistema operativo se haya configurado correctamente. Por ejemplo, asegrese de haber configurado todas las variables.
Si utiliza un servidor de base de datos distinto a Microsoft SQL para el almacn de contenido, se
recomienda copiar los controladores JDBC en la ubicacin adecuada antes de iniciar la herramienta
de configuracin.
Asegrese de haber configurado la cuenta de servicio o usuario. Para obtener ms informacin,
consulte la seccin "Configuracin de una cuenta de usuario o de servicio de red para IBM Cognos 8" (p. 54).

Paso para Windows

En el men Inicio, haga clic en Programas, IBM Cognos 8, IBM Cognos Configuration.

Paso para UNIX o Linux

Vaya al directorio ubicacin_c8/bin y escriba


./cogconfig.sh

Gua de instalacin y configuracin 117

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida

Configuracin de las propiedades de la conexin a la base de datos en el almacn


de contenido
Debe especificar la informacin del servidor de la base de datos para garantizar que Content
Manager se puede conectar a la base de datos utilizada para el almacn de contenido. Content
Manager utiliza el inicio de sesin de la base de datos para acceder al almacn de contenido. Una
vez establecidas las propiedades de conexin de la base de datos, puede probar la conexin entre
Content Manager y el almacn de contenido.
Si ha instalado la base de datos de contenido de Cognos en un equipo distinto al utilizado para
instalar Content Manager, deber configurar las propiedades de conexin de la base de datos de
contenido de Cognos. Si ha instalado la base de datos de contenido de Cognos en el mismo equipo
que Content Manager, Content Manager se configurar para utilizar la base de datos de contenido
de Cognos con los valores predeterminados. Si instala la base de datos de contenido de Cognos en
el mismo equipo que Content Manager y, ms adelante, decide utilizar otra base de datos para el
almacn de contenido, debe desinstalar la base de datos de contenido de Cognos.
Los componentes de IBM Cognos 8 necesitan el protocolo TCP/IP para acceder a los datos y al
almacn de contenido. Asegrese de que el servidor de base de datos tenga el protocolo establecido
en TCP/IP.
Asegrese de haber utilizado uno de los servidores de base de datos admitidos para crear el almacn
de contenido.
Asegrese de haber configurado la cuenta de servicio o usuario. Para obtener ms informacin,
consulte la seccin "Configuracin de una cuenta de usuario o de servicio de red para IBM Cognos 8" (p. 54).

Pasos para la base de datos de contenido de Cognos


1. En el equipo en el que haya instalado Content Manager, inicie IBM Cognos Configuration.
2. En la ventana Explorador, en Acceso a datos, Content Manager, haga clic en Almacn de
contenido.
3. En la ventana Propiedades, cambie las siguientes propiedades:

En Nombre, escriba cm.

En Servidor de base de datos y nmero de puerto, escriba el nombre del equipo en el que
ha instalado la base de datos de contenido de Cognos.

En Identificador de usuario y contrasea, haga clic en el botn Editar y especifique cognos


como identificador de usuario y contrasea para acceder a la base de datos de contenido
de Cognos.

Se recomienda cambiar el identificador de usuario y la contrasea predeterminados despus de


configurar el nuevo recurso. Para obtener ms informacin sobre cmo cambiar los valores
predeterminados, consulte la seccin "Cambio del usuario y la contrasea predeterminados de
la base de datos de contenido de Cognos" (p. 214).
4. En el men Archivo, haga clic en Guardar.
Las credenciales de inicio de sesin se codifican de inmediato.
118 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
5. En el men Acciones, haga clic en Prueba para probar la conexin entre Content Manager y
el almacn de contenido.
Para que la prueba se realice correctamente, deber iniciar el servicio de la base de datos de
contenido de Cognos en el equipo en el que est instalada.
Content Manager se conecta a la base de datos, comprueba los permisos de la base de datos,
crea la tabla y, a continuacin, la rellena. La tabla no se elimina y se utiliza cada vez que se
repite la prueba.

Pasos para DB2 en Linux, UNIX o Windows


1. Inicie IBM Cognos Configuration en la ubicacin en la que haya instalado Content Manager.
2. En la ventana Explorador, en Acceso a datos, Content Manager, haga clic en Almacn de
contenido.
3. En la ventana Propiedades, para 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 sesin para especificar una contrasea y un identificador
de usuario vlidos:

Haga clic en el cuadro Valor situado junto a la propiedad Identificador de usuario y contrasea y, a continuacin, haga clic en el botn Editar cuando aparezca.

Escriba los valores adecuados y haga clic en Aceptar.

5. Para usar el tipo 4 de conectividad JDBC, para la propiedad Servidor de base de datos y contrasea, escriba un valor, usando la sintaxis host:puerto.
Si deja esta propiedad en blanco, se usa la conectividad JDBC de tipo 2.
Para obtener ms informacin sobre las diferencias entre los tipos de controlador, consulte
"Opciones de controlador JDBC para usar bases de datos DB2 como almacn de contenido" (p. 86).
6. En el men Archivo, haga clic en Guardar.
Las credenciales de inicio de sesin se codifican de inmediato.
7. Pruebe la conexin entre Content Manager y el almacn de contenido.
Sugerencia: En la ventana Explorador, haga clic con el botn derecho en la nueva base de datos
y, a continuacin, haga clic en Probar.
Content Manager se conecta a la base de datos, comprueba los permisos de la base de datos,
crea la tabla y, a continuacin, la rellena. La tabla no se elimina y se utiliza cada vez que se
repite la prueba.

Pasos para Microsoft SQL Server, Oracle y Sybase


1. Inicie IBM Cognos Configuration en el equipo en el que instal Content Manager.
2. En la ventana Explorador, en Acceso a datos, Content Manager, haga clic con el botn derecho
en Almacn de contenido y, a continuacin, haga clic en Eliminar.
Gua de instalacin y configuracin 119

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
De este modo se elimina la conexin al recurso predeterminado. Content Manager debe configurarse para acceder slo a un almacn de contenido.
3. Haga clic con el botn derecho en Content Manager y, a continuacin, haga clic en Nuevo
recurso, Base de datos.
4. En el cuadro Nombre, escriba el nombre del recurso.
5. En el cuadro Tipo, seleccione el tipo de base de datos y haga clic en Aceptar.
Si est realizando una actualizacin y desea usar un almacn de contenido existente, asegrese
de que selecciona el tipo de base de datos que usa para la versin anterior.
Si ha instalado ms de una versin de IBM Cognos 8, deber usar un almacn de contenido
diferente para cada una. Cuando una nueva versin de IBM Cognos 8 utiliza un almacn de
contenido, ste no puede ser utilizado por una versin ms antigua.
Sugerencia: Si desea usar un par contrasea-valor Net8 de Oracle para administrar la conexin
a la base de datos, seleccione Base de datos Oracle (Avanzada).
6. En la ventana Propiedades, proporcione los valores en funcin de su tipo de base de datos:

Si utiliza una base de datos Microsoft SQL Server, introduzca los valores pertinentes para
las propiedades Servidor de base de datos con nmero de puerto o nombre de instancia y
Nombre de base de datos.
Para una base de datos de Microsoft SQL Server, puede elegir utilizar un nmero de puerto,
tal como el 1433, o una instancia con nombre como valor para la propiedad Servidor de
base de datos con nmero de puerto o nombre de instancia.
Para conectarse a una instancia con nombre, debe especificar el nombre de instancia como
una propiedad URL de JDBC o una propiedad de origen de datos. Por ejemplo, puede
escribir localhost\instance1. Si no se especifica una propiedad nombre de instancia, se crea
una conexin a la instancia predeterminada.
Tenga en cuenta que las propiedades especificadas para la instancia con nombre, junto con
el identificador de usuario y contrasea, y el nombre de la base de datos, se utilizan para
crear una URL de JDBC. A continuacin se incluye un ejemplo:
jdbc:JSQLConnect://localhost\\instance1/user=sa/ms propiedades segn sea necesario

Si utiliza una base de datos Oracle, escriba los valores pertinentes para las propiedades
Servidor de base de datos y nmero de puerto y Nombre de servicio.

Si usa una base de datos Oracle avanzada, introduzca el par contrasea-valor Net8 de
Oracle de la conexin para la propiedad Especificador de base de datos.
A continuacin se incluye un ejemplo:
(description=(address=(host=myhost)(protocol=tcp)(port=1521)(connect_data=(sid=(orcl)))))
Si selecciona la base de datos avanzada de Oracle, IBM Cognos 8 usar las funciones
empresariales de Oracle para seleccionar una escucha, cambiar a otra escucha si la primera
falla, volver a conectarse automticamente a la base de datos si la conexin falla, equilibrar
las solicitudes de conexin entre escuchas y equilibrar las solicitudes de conexin entre
distribuidores.

120 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida

Si utiliza una base de datos Sybase, escriba los valores pertinentes para las propiedades
Servidor de base de datos y nmero de puerto y Nombre de base de datos.

7. Si desea cambiar las credenciales de inicio de sesin, especifique un identificador de usuario y


una contrasea:

Haga clic en el cuadro Valor situado junto a la propiedad Identificador de usuario y contrasea y, a continuacin, haga clic en el botn Editar cuando aparezca.

Escriba los valores adecuados y haga clic en Aceptar.

8. En el men Archivo, haga clic en Guardar.


Las credenciales de inicio de sesin se codifican de inmediato.
9. Pruebe la conexin entre Content Manager y el almacn de contenido.
Sugerencia: En el men Acciones, haga clic en Prueba para probar la conexin entre Content
Manager y el almacn de contenido.
Content Manager se conecta a la base de datos, comprueba los permisos de la base de datos,
crea la tabla y, a continuacin, la rellena. La tabla no se elimina y se utiliza cada vez que se
repite la prueba.
Ahora, Content Manager puede crear las tablas necesarias en el almacn de contenido cuando se
inicie el servicio IBM Cognos 8 por primera vez. Si las propiedades de conexin no se especifican
correctamente, las tablas no se crean y no se puede establecer la conexin con IBM Cognos Connection.
Si lleva a cabo la actualizacin desde ReportNet, Content Manager puede acceder entonces a las
tablas necesarias del almacn de contenido que utiliz para ReportNet.

Especificacin de una cuenta de servidor de correo


Si desea enviar informes por correo electrnico, debe configurar una cuenta de servidor de correo.
Si enva los informes por correo electrnico, debe cambiar la parte correspondiente al nombre de
host del URI de puerta de enlace de localhost a la direccin IP del equipo o al nombre del equipo.
De lo contrario, la URL del correo electrnico contendr localhost y los usuarios remotos no podrn
abrir el informe.

Pasos
1. En la ventana del Explorador, en Acceso a datos, haga clic en Notificacin.
2. En la ventana Propiedades, para la propiedad Servidor de correo SMTP, escriba el nombre del
host y el puerto del servidor de correo SMTP (saliente).
Sugerencia: Para poder abrir informes enviados por correo electrnico, debe cambiar la parte
correspondiente al nombre de host del URI de puerta de enlace de localhost a la direccin IP
del equipo o al nombre del equipo. De lo contrario, la URL del correo electrnico contendr
localhost y los usuarios remotos no podrn abrir el informe.

Gua de instalacin y configuracin 121

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
3. Haga clic en el cuadro Valor, situado junto a la propiedad Cuenta y contrasea y, a continuacin,
haga clic en el botn de edicin, cuando aparezca.
4. Escriba los valores apropiados en el cuadro de dilogo Valor - Cuenta y contrasea y, a continuacin, haga clic en Aceptar.
Sugerencia: Si no se necesitan las credenciales de inicio de sesin para el servidor SMTP, elimine
la informacin predeterminada para la propiedad Cuenta y contrasea. Cuando se le pida
confirmacin para dejar esta propiedad en blanco, haga clic en S. Asegrese de que se ha eliminado el nombre de usuario predeterminado. De lo contrario, se utilizar la cuenta predeterminada y las notificaciones no funcionarn correctamente.
5. En la ventana Propiedades, escriba el valor apropiado para la cuenta del remitente predeterminado.
6. Pruebe las conexiones al servidor de correo. En la ventana del Explorador, haga clic con el
botn derecho en Notificacin y, a continuacin, haga clic en Probar.
Cognos 8 prueba la conexin al servidor de correo.
Si no tiene planificado enviar informes por correo electrnico o no desea configurar inmediatamente
una cuenta de servidor de correo, no es necesario que lo haga. Sin embargo, cuando guarde la
configuracin y, posteriormente, inicie los servicios en IBM Cognos Configuration, podr ver un
mensaje de advertencia cuando se pruebe la conexin al servidor de correo. Puede ignorar la
advertencia sin peligro alguno.

Configuracin de las propiedades de entorno para los equipos de Content Manager


Despus de instalar Content Manager en los equipos que se estn utilizando para la proteccin en
caso de migracin tras error, debe configurar Content Manager en dichos equipos. Si ha instalado
ms de un Content Manager, debe indicar todos los URI de Content Manager en cada equipo de
Content Manager. Adems, se recomienda especificar el nombre del servidor o una direccin IP en
las propiedades del URI que utiliza IBM Cognos 8. De manera predeterminada, las propiedades
del URI especifican localhost.
Cuando haya completado las tareas de configuracin necesarias, el servicio de la entidad emisora
de certificados estar disponible para emitir certificados a otros equipos de IBM Cognos. A continuacin, podr realizar las tareas de configuracin necesarias en otros equipos, como el equipo de
componentes de nivel de aplicacin y los equipos de puerta de enlace. De lo contrario, puede continuar configurando los equipos de Content Manager cambiando los valores de propiedad predeterminados (p. 213) para que se ajusten mejor al entorno. Por ejemplo, puede configurar los componentes
de IBM Cognos 8 para utilizar un proveedor de autenticacin (p. 171), habilitar y deshabilitar servicios
(p. 226) en los equipos de Content Manager o cambiar la configuracin global (p. 255).
Importante: Si cambia la configuracin global en un equipo Content Manager, debe realizar los
mismos cambios en los otros equipos Content Manager.

Pasos para el primer equipo de Content Manager


1. En el equipo de Content Manager que desee designar como Content Manager activo predeterminado, inicie IBM Cognos Configuration.

122 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Sugerencia: Se recomienda utilizar el equipo con la velocidad de procesador ms elevada para
el Content Manager activo predeterminado.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana Propiedades, cambie la parte localhost de todas las propiedades del URI por el
nombre o la direccin IP de los servidores de IBM Cognos 8, siguiendo estos pasos:

En URI de distribuidor para puerta de enlace y URI de Content Manager, haga clic en el
valor y, a continuacin, en el botn Editar. Cambie la parte localhost y haga clic en Aceptar.

Para todas las propiedades de URI restantes, haga clic en el valor y cambie la parte localhost.

4. Haga clic en el valor de URI de Content Manager y, a continuacin, en el botn Editar.


5. Especifique los URI de los equipos de Content Manager restantes:

En el cuadro de dilogo Valor - URI de Content Manager, haga clic en Aadir.

Haga clic en la fila vaca de la tabla y escriba el URI completo del equipo de Content
Manager.
No elimine el primer valor de la tabla. Este valor identifica al equipo local de Content
Manager y es obligatorio.

Repita los dos pasos previos en vietas para cada URI que se vaya a aadir.
Importante: Debe incluir todos los URI de Content Manager en la lista.

Haga clic en Aceptar.

6. En la ventana Explorador, en Seguridad, haga clic en Criptografa.


7. En la ventana Propiedades, en Configuracin CSK, marque Almacenar clave simtrica localmente
como Verdadero.
8. En el men Archivo, haga clic en Guardar.

Pasos para los equipos de Content Manager en espera


1. Asegrese de haber configurado ya las propiedades de Entorno en, al menos, un equipo de
Content Manager, y de que los componentes de IBM Cognos 8 se estn ejecutando en dicho
equipo.
2. Inicie la IBM Cognos Configuration en el equipo de Content Manager en espera.
3. En la ventana Explorador, haga clic en Entorno.
4. En la ventana Propiedades, cambie la parte localhost de todas las propiedades del URI por el
nombre o la direccin IP de los servidores de IBM Cognos 8, siguiendo estos pasos:

En URI de distribuidor para puerta de enlace y URI de Content Manager, haga clic en el
valor y, a continuacin, en el botn Editar. Cambie la parte localhost y haga clic en Aceptar.

Para todas las propiedades de URI restantes, haga clic en el valor y cambie la parte localhost.

Gua de instalacin y configuracin 123

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
5. Haga clic en el valor de URI de Content Manager y, a continuacin, en el botn Editar.
6. Especifique los URI de los equipos de Content Manager restantes:

En el cuadro de dilogo Valor - URI de Content Manager, haga clic en Aadir.

Haga clic en la fila vaca de la tabla y escriba el URI completo del equipo de Content
Manager.
No elimine el primer valor de la tabla. Este valor identifica al equipo local de Content
Manager y es obligatorio.

Repita los dos pasos previos en vietas para cada URI que se vaya a aadir.
Importante: Debe incluir todos los URI de Content Manager en la lista.

Haga clic en Aceptar.

7. En la ventana Explorador, en Seguridad, haga clic en Criptografa.


8. En la ventana Explorador, en Seguridad, Criptografa, haga clic en Cognos, el proveedor criptogrfico predeterminado.
9. En el grupo de propiedades Configuracin de la entidad emisora de certificados, establezca la
propiedad Contrasea de manera que coincida con el valor configurado en el equipo de Content
Manager activo predeterminado.
10. Asegrese de que todos los valores criptogrficos restantes coincidan con los que ha configurado
en el equipo de Content Manager activo predeterminado.
11. En la ventana Explorador, en Acceso a datos, Content Manager, haga clic en Almacn de
contenido.
12. Asegrese de que los valores de todas las propiedades coincidan con los que ha configurado en
el equipo de Content Manager activo predeterminado.
13. En el men Archivo, haga clic en Guardar.

Configuracin de un espacio de nombre de IBM Cognos Series 7 en IBM Cognos


8
Si desea migrar la informacin de seguridad o el contenido protegido de IBM Cognos Series 7 a
IBM Cognos 8, debe configurar un espacio de nombre en IBM Cognos 8 idntico al espacio de
nombre de IBM Cognos Series 7.
Puede configurar varios espacios de nombre para la autenticacin en IBM Cognos 8. Para obtener
ms informacin, consulte "Configuracin de los componentes de IBM Cognos 8 para utilizar un
proveedor de autenticacin" (p. 171).
Nota: No puede utilizar un archivo LAE (Local Authentication Export) de IBM Cognos Series 7
para realizar la autenticacin con los componentes de IBM Cognos 8.
Se recomienda que todos los espacios de nombre de IBM Cognos Series 7 utilicen el mismo servidor
de vales primario de IBM Cognos Series 7. De lo contrario, recibir errores o se le solicitar que se

124 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
autentique ms de una vez. Para mantener el rendimiento, asegrese tambin de que el servidor de
vales est en ejecucin.
Si cambia la informacin de configuracin almacenada en el servidor de directorios utilizado para
IBM Cognos Series 7, debe reiniciar el servicio de IBM Cognos 8 antes de que se realicen los cambios
en la instalacin de IBM Cognos.
Un usuario debe estar por lo menos en una clase de usuario de Access Manager para poder iniciar
sesin en los componentes de IBM Cognos 8.

Pasos
1. En la ventana Explorador, haga clic con el botn derecho en Autenticacin y seleccione Nuevo
recurso, Espacio de nombre.
2. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
3. En la lista Tipo, haga clic en IBM Cognos Series 7 y, a continuacin, en Aceptar.
El nuevo recurso proveedor de autenticacin aparecer en la ventana Explorador, bajo el
componente Autenticacin.
4. En la ventana Propiedades de recursos, especifique los valores obligatorios.
Algunos valores deben coincidir con los valores que utiliz al configurar el espacio de nombre
de IBM Cognos Series 7 en Configuration Manager. En Servicios, Access Manager - Tiempo
de ejecucin, Directory Server, compruebe los valores de la ventana Propiedades.

En ID de espacio de nombre, especifique un identificador nico para el espacio de nombre.

En Host y puerto, escriba el mismo valor utilizado para la propiedad Equipo en el Administrador de configuracin.
El formato debe ser idntico. Si utiliza una direccin IP en IBM Cognos Series 7, escriba
la misma direccin IP. Si utiliza un nombre de host de la red en IBM Cognos Series 7,
escriba el mismo nombre de host de la red.

En Nombre distinguido de base, escriba el mismo valor utilizado para la propiedad Nombre
distinguido de base (DN) en el Administrador de configuracin.

En Nombre del espacio de nombre, escriba el mismo valor utilizado para la propiedad
Nombre de espacio predeterminado en el Administrador de configuracin.
El valor distingue maysculas y minsculas y debe coincidir exactamente.

5. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que los
componentes de IBM Cognos 8 puedan localizar y utilizar el proveedor de autenticacin existente.
Si la versin de espacio de nombre de IBM Cognos Series 7 es 16.0, asegrese de que la propiedad
Codificacin de datos tiene asignado el valor UTF-8. Adems, los equipos donde est instalado
Content Manager deben utilizar la misma configuracin regional que los datos que estn en el
espacio de nombre de IBM Cognos Series 7.

Gua de instalacin y configuracin 125

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
6. Si el entorno de espacio de nombre incluye la versin 15.2 del espacio de nombre de IBM
Cognos Series 7, debe deshabilitar la configuracin de Series7NamespacesAreUnicode.

En la ventana Propiedades, en el valor Propiedades avanzadas, haga clic en el botn Editar.

En la ventana Valor: Propiedades avanzadas, haga clic en Aadir.

En el cuadro Nombre, escriba Series7NamespacesAreUnicode.

En el cuadro Valor, haga clic en Falso y, a continuacin, haga clic en Aceptar.

7. En la ventana Propiedades, en Configuracin de cookies, asegrese de que las propiedades


Ruta, Dominio e Indicador de proteccin activado coincidan con los valores configurados para
IBM Cognos Series 7.
8. En el men Archivo, haga clic en Guardar.

Inicio del servicio IBM Cognos 8 en el equipo de Content Manager


Para registrar el servicio IBM Cognos 8 de manera que los usuarios puedan acceder a l a travs de
IBM Cognos Connection, debe iniciar los servicios. Antes de iniciar los servicios, pruebe la configuracin utilizando la funcin de prueba en IBM Cognos Configuration.
En Windows, el servicio IBM Cognos 8 est configurado para iniciarse automticamente de forma
predeterminada. En UNIX y Linux, para iniciar el proceso de IBM Cognos 8 automticamente,
debe configurar el proceso como un daemon. Para obtener ms informacin, consulte la documentacin del sistema operativo.
Debe instalar y configurar los componentes del servidor de IBM Cognos 8 y Framework Manager
para poder utilizar IBM Cognos 8 para crear informes.
Nota: IBM Cognos 8 no puede acceder a los datos de creacin de informes a menos que los datos
se empaqueten antes y se publiquen desde Framework Manager.

Pasos
1. Inicie IBM Cognos Configuration.
2. Asegrese de guardar la configuracin, de lo contrario, no podr iniciar el servicio IBM Cognos
8.
3. En el men Acciones, haga clic en Probar.
IBM Cognos Configuration comprueba la disponibilidad de claves simtricas comunes (CSK)
y prueba tanto la configuracin de los espacios de nombre como las conexiones con el almacn
de contenido, el servidor de correo, la base de datos de notificaciones y la base de datos de
registro.
Sugerencia: Si la opcin Probar no se puede seleccionar, haga clic en Configuracin local en la
ventana Explorador.
4. Si la prueba falla, vuelva a configurar las propiedades afectadas y realice la prueba de nuevo.
Puede probar determinados servicios si hace clic con el botn derecho del ratn en el panel
Explorador y selecciona Probar.
126 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
No inicie el servicio hasta que no se hayan superado todas las pruebas.
5. En el men Acciones, haga clic en Iniciar.
Es posible que el servicio IBM Cognos 8 tarde unos minutos en iniciarse.
Esta accin inicia todos los servicios instalados que no estn deshabilitados.

Cmo probar Content Manager


Puede probar los valores de configuracin mediante la funcin de prueba al configurar IBM Cognos
8. Puede probar la instalacin de Content Manager con ayuda de un explorador Web.

Pasos
1. Abra un explorador Web.
2. Para probar la configuracin, escriba
http://EquipoContentManager_nombre:9300/p2pd/servlet.
Si la respuesta incluye la cadena State: Running, el distribuidor y Content Manager se han iniciado correctamente.

Instalacin y configuracin de los componentes de nivel de


aplicacin en el servidor PowerPlay
Puede instalar componentes de nivel de aplicacin en uno o varios servidores PowerPlay de su
entorno. Los componentes de nivel de aplicacin incluyen el servidor PowerPlay BI y Administracin
de PowerPlay. Ambos componentes estn seleccionados de manera predeterminada.
El equipo de componentes de nivel de aplicacin debe conocer la ubicacin de los equipos de Content
Manager y la ubicacin de la base de datos de notificaciones que se utilizar para la informacin
sobre trabajos y planificaciones.
Si ha instalado ms de un Content Manager, debe indicar todos los URI de Content Manager en
cada equipo de componentes de nivel de aplicacin.
Asegrese de que el equipo donde haya instalado el Content Manager activo est configurado y
disponible antes de configurar los equipos de componentes de nivel de aplicacin.
Si Content Manager y los componentes de nivel de aplicacin estn instalados en equipos distintos,
en el equipo de componentes de nivel de aplicacin, debe seguir estos pasos:

Instale los componentes de nivel de aplicacin.

Actualice el entorno Java.

Inicie IBM Cognos Configuration.

Configure las propiedades del entorno.

Inicie el servicio IBM Cognos 8 en los servidores PowerPlay.

Pruebe el servicio de migracin de IBM Cognos 8.

Gua de instalacin y configuracin 127

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Hay otras tareas de configuracin optativas que se pueden realizar ms adelante.

Instalacin de componentes de nivel de aplicacin en el servidor PowerPlay


Utilice el asistente para instalacin para seleccionar componentes de nivel de aplicacin y la ubicacin
del equipo donde desea realizar la instalacin. Los componentes de nivel de aplicacin incluyen el
servidor PowerPlay BI y Administracin de PowerPlay.
En UNIX, para ejecutar la instalacin en modo grfico, la consola asociada al equipo de UNIX
debe admitir una interfaz grfica de usuario basada en Java.
En UNIX, IBM Cognos 8 respeta la mscara de creacin de modo de archivo (umask) de la cuenta
que ejecuta el programa de instalacin. Esto slo afecta a los directorios de instalacin. No afecta
a los permisos de archivos de los directorios. Sin embargo, los archivos generados en tiempo de
ejecucin, como los registros, respetan la mscara. Se recomienda utilizar el valor umask 022 en el
directorio de instalacin.
En Windows, asegrese de tener privilegios de administrador en el equipo de Windows en el que
est realizando la instalacin. Asegrese tambin de que el equipo disponga de una variable del
sistema TEMP que apunte al directorio en el que desea almacenar los archivos temporales. Durante
la instalacin, los archivos del CD se copian temporalmente en este directorio.
Para garantizar que los informes se imprimen correctamente en Windows, Adobe Acrobat requiere
que configure al menos una impresora en el sistema operativo en el que se encuentran instalados
los componentes de nivel de aplicacin. Todos los informes, con independencia del formato de
impresin seleccionado, se envan como archivos PDF temporales a Adobe Reader para su impresin.

Pasos para UNIX y Linux


1. Si est realizando la instalacin en un directorio que tiene otros componentes de IBM Cognos
8, detenga el servicio IBM Cognos 8.
2. Configure la variable de entorno JAVA_HOME para que apunte a la ubicacin de instalacin
de su entorno en tiempo de ejecucin de Java (JRE).
Un ejemplo de ubicacin de instalacin del entorno en tiempo de ejecucin de Java es /directorio/java/versin_java/jre.
IBM Cognos 8 requiere una JVM, como IBM Java, para ejecutarse en Linux.
3. En HP-UX, configure la variable de entorno _M_ARENA_OPTS como se indica a continuacin:
_M_ARENA_OPTS 1:4
De este modo, se aumenta la asignacin de memoria para HP-UX, a fin de que coincida lo
mximo posible con la de otras plataformas de UNIX.
4. En AIX, configure la variable de entorno AIXTHREAD_SCOPE como se indica a continuacin:
AIXTHREAD_SCOPE=S
De este modo, se establece el mbito de contencin de los subprocesos del usuario en todo el
sistema, lo que permite una planificacin ms eficaz de los subprocesos del usuario.
5. Monte el CD de su producto de IBM Cognos utilizando extensiones de archivo Rock Ridge.

128 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
6. Vaya al directorio del CD correspondiente a su sistema operativo.
Por ejemplo, para Solaris, vaya al directorio de Solaris.
7. Inicie el asistente para instalacin:

Si utiliza XWindows, escriba


./issetup
Nota: Si utiliza el comando issetup con XWindows, se podran daar los caracteres japoneses en mensajes y archivos de registro. Cuando instale en japons en UNIX o Linux,
deber configurar primero las variables del entorno LANG=C y LC_ALL=C (donde C es
el cdigo del idioma, por ejemplo ja_JP.PCK en Solaris), y despus iniciar el asistente de
instalacin.

Si no utiliza XWindows, realice una instalacin sin participacin del usuario (p. 317).

8. Seleccione el idioma que desea utilizar en la instalacin.


El idioma que seleccione determina el idioma de la interfaz de usuario. Despus de la instalacin,
puede cambiar el idioma de la interfaz de usuario del producto a cualquiera de los idiomas
instalados.
9. En la pgina Seleccin de componentes, borre todos los componentes excepto Componentes
de nivel de aplicacin.
Importante:

La Administracin de PowerPlay debe instalarse con otro componente de IBM Cognos 8


que incluya un distribuidor, preferiblemente un servidor PowerPlay BI o componentes de
nivel de aplicacin del servidor IBM Cognos 8 Business Intelligence.

No seleccione Componentes de migracin de IBM Cognos Series 7 aunque los componentes


de IBM Cognos Series 7 estn instalados en el equipo. Estos componentes se deben instalar
siguiendo las instrucciones de la seccin "Instalacin y configuracin de la migracin en
equipos de IBM Cognos Series 7" (p. 143).

10. En la pgina Varias ubicaciones de instalacin, especifique la ubicacin de IBM Cognos 8.


Si est realizando la instalacin en un equipo que contiene otros componentes de IBM Cognos
8 PowerPlay, realice la instalacin en el mismo directorio. Por ejemplo, si la instalacin se
realiza con IBM Cognos 8 BI Server, utilice la misma ubicacin en la que ha instalado Componentes de nivel de aplicacin para IBM Cognos 8 BI Server. Se le solicitar la ubicacin de un
directorio en el que desea almacenar las copias de seguridad de los archivos que se sobrescribirn.
Instale los componentes de IBM Cognos 8 PowerPlay en un directorio que contenga slo
caracteres ASCII en el nombre de la ruta. Algunos servidores Web UNIX y Linux no admiten
caracteres no ASCII en los nombres de directorio.
11. Siga las indicaciones de las pginas Carpeta de accesos directos y Resumen de la instalacin.
12. En la pgina Finalizar, haga clic en Finalizar.

Gua de instalacin y configuracin 129

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
13. Aada el directorio ubicacin_c8/bin a la variable de entorno de la ruta de biblioteca
correspondiente.

Para Solaris y Linux, LD_LIBRARY_PATH

Para AIX, LIBPATH

Para HP-UX, SHLIB_PATH

14. En Linux, configure la variable de entorno PRINTER con el nombre de la impresora.


Si desea que los usuarios puedan ver documentacin del producto en un idioma diferente al ingls,
deber instalar el componente Supplementary Languages Documentation en la misma ubicacin
que los componentes de la puerta de enlace. Para obtener ms informacin, consulte "Instalar
documentacin de producto traducida" (p. 166).
Para garantizar la seguridad e integridad de IBM Cognos 8, es importante proteger el directorio de
instalacin de los accesos no autorizados y no adecuados.

Pasos para Windows


1. Si est realizando la instalacin en un directorio que tiene otros componentes de IBM Cognos
8, detenga el servicio IBM Cognos 8.
2. Inserte el CD del producto de IBM Cognos.
Debe aparecer la pgina Bienvenido del asistente para instalacin.
Si no aparece la pgina Bienvenido, haga doble clic en el archivo issetup.exe del directorio
win32 del CD.
3. Seleccione el idioma que desea utilizar en la instalacin.
El idioma que seleccione determina el idioma de la interfaz de usuario. Despus de la instalacin,
puede seleccionar el idioma de la interfaz de usuario del producto entre cualquiera de los idiomas
instalados.
4. En la pgina Seleccin de componentes, borre todos los componentes excepto Componentes
de nivel de aplicacin.
Importante:

Si est instalado nicamente IBM Cognos 8 PowerPlay, Administracin de PowerPlay debe


instalarse siempre con el servidor PowerPlay BI. Si est instalando IBM Cognos 8 PowerPlay
con otro producto de IBM Cognos 8 Business Intelligence, Administracin de PowerPlay
debe estar siempre instalada en los componentes de nivel de aplicacin. Administracin de
PowerPlay no puede funcionar sin uno de estos componentes de IBM Cognos 8.

No seleccione Componentes de migracin de IBM Cognos Series 7 aunque los componentes


de IBM Cognos Series 7 estn instalados en el equipo. Estos componentes se deben instalar
siguiendo las instrucciones de la seccin "Instalacin y configuracin de la migracin en
equipos de IBM Cognos Series 7" (p. 143).

5. En la pgina Varias ubicaciones de instalacin, especifique la ubicacin de IBM Cognos 8.

130 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Si est realizando la instalacin en un equipo que contiene otros componentes de IBM Cognos
8 PowerPlay, realice la instalacin en el mismo directorio. Por ejemplo, si la instalacin se
realiza con IBM Cognos 8 BI Server, utilice la misma ubicacin en la que ha instalado Componentes de nivel de aplicacin para IBM Cognos 8 BI Server. Se le solicitar la ubicacin de un
directorio en el que desea almacenar las copias de seguridad de los archivos que se sobrescribirn.
Instale los componentes de IBM Cognos 8 PowerPlay en un directorio que contenga slo
caracteres ASCII en el nombre de la ruta. Algunos servidores Web UNIX y Linux no admiten
caracteres no ASCII en los nombres de directorio.
6. Siga las indicaciones de las pginas Carpeta de accesos directos y Resumen de la instalacin.
7. En la pgina Finalizar, haga clic en Finalizar.
Si desea que los usuarios puedan ver documentacin del producto en un idioma diferente al ingls,
deber instalar el componente Supplementary Languages Documentation en la misma ubicacin
que los componentes de la puerta de enlace. Para obtener ms informacin, consulte "Instalar
documentacin de producto traducida" (p. 166).

Actualizacin del entorno Java en el servidor PowerPlay


Para poder iniciar el servicio de Cognos 8, debe configurar la variable de entorno JAVA_HOME
y copiar el archivo Cognos.jar en el directorio JRE.
Si no tiene una variable JAVA_HOME ya definida en Windows, se utilizarn los archivos JRE
proporcionados con la instalacin, y no tendr que actualizar ningn archivo del entorno. Si
JAVA_HOME remite a una versin Java que no es vlida para IBM Cognos 8, deber actualizar
JAVA_HOME con la ruta correspondiente a una versin de Java vlida.

Pasos
1. Compruebe que la variable de entorno JAVA_HOME est configurada en la ubicacin del JRE.
Por ejemplo, para configurar JAVA_HOME en los archivos JRE proporcionados con la instalacin, la ruta es ubicacin_c8/bin/jre/versin.
2. Copie el archivo bcprov-jdknn-nnn.jar del directorio ubicacin_c8/bin/jre/versin/lib/ext en el
directorio ubicacin_Java/jre/lib/ext.

Inicio de IBM Cognos Configuration en el servidor PowerPlay


Utilice IBM Cognos Configuration para configurar los componentes de IBM Cognos 8 e iniciar y
detener los servicios de IBM Cognos.

Gua de instalacin y configuracin 131

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Asegrese de haber configurado la cuenta de servicio o usuario. Para obtener ms informacin,
consulte la seccin "Configuracin de una cuenta de usuario o de servicio de red para IBM Cognos 8" (p. 54).

Paso para Windows

En el men Inicio, haga clic en Programas, IBM Cognos 8, IBM Cognos Configuration.

Paso para UNIX o Linux

Vaya al directorio ubicacin_c8/bin y escriba


./cogconfig.sh

Configuracin de las propiedades de entorno en servidores PowerPlay


Si instala el componente Componentes de nivel de aplicacin en un equipo distinto al de Content
Manager, debe configurar el servidor PowerPlay para que ste conozca la ubicacin de Content
Manager y la base de datos de notificaciones utilizada para la informacin sobre trabajos y planificaciones. As, los componentes distribuidos se podrn comunicar entre ellos.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana Propiedades, haga clic en el valor de URI de Content Manager y, a continuacin,
en el botn Editar.
4. Cambie la parte localhost del URI existente por el nombre de cualquier equipo de Content
Manager.
5. Especifique los URI de los equipos de Content Manager restantes:

En el cuadro de dilogo Valor - URI de Content Manager, haga clic en Aadir.

Haga clic en la fila vaca de la tabla y escriba el URI completo del equipo de Content
Manager.

Repita los dos pasos previos en vietas para cada URI que se vaya a aadir.
Importante: Debe incluir todos los URI de Content Manager en la lista.

Haga clic en Aceptar.

6. Cambie la parte localhost de la propiedad URI de puerta de enlace por el nombre del equipo
en el que desee instalar el componente de puerta de enlace.
7. Cambie la parte localhost de las propiedades restantes del URI por el nombre o la direccin IP
del servidor de IBM Cognos 8.
8. En la ventana Explorador, en Seguridad, Criptografa, haga clic en Cognos, el proveedor criptogrfico predeterminado.

132 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
9. En el grupo de propiedades Configuracin de la entidad emisora de certificados, establezca la
propiedad Contrasea de manera que coincida con el valor configurado en el equipo de Content
Manager activo predeterminado.
10. Asegrese de que todos los valores criptogrficos restantes coincidan con los que ha configurado
en el equipo de Content Manager activo predeterminado.
11. En el men Archivo, haga clic en Guardar.

Inicio del servicio IBM Cognos 8 en los servidores PowerPlay


Cuando haya configurado las propiedades del entorno, puede iniciar los servicios en los servidores
PowerPlay.

Paso

En el men Acciones, haga clic en Iniciar.


Es posible que el servicio IBM Cognos 8 tarde unos minutos en iniciarse.
Esta accin inicia todos los servicios instalados que no estn deshabilitados.

Cmo probar el servicio de migracin de IBM Cognos 8


Puede probar la instalacin del servicio de migracin de IBM Cognos 8 comprobando que el icono
del ayudante para la migracin aparezca en IBM Cognos Administration.

Pasos
1. En IBM Cognos Connection, en la barra de herramientas, haga clic en Iniciar, IBM Cognos
Administration.
2. Haga clic en la pestaa Configuracin.
3. Haga clic en Administracin de contenido.
El botn del ayudante para la migracin

aparece en la barra de herramientas.

Antes de poder utilizar el ayudante para la migracin con el fin de migrar contenido de IBM Cognos
Series 7 desde Upfront, PowerPlay Enterprise Server e IBM Cognos Connection, deber instalar los
componentes de migracin con IBM Cognos Series 7. Para obtener ms informacin sobre el contenido de migracin, consulte IBM Cognos 8 PowerPlay Gua de migracin y administracin.

Instalacin y configuracin del componente puerta de enlace


Puede instalar el componente puerta de enlace en uno o varios equipos, en funcin de su entorno.
El equipo de puerta de enlace debe conocer la ubicacin de, al menos, un distribuidor. Se recomienda
utilizar el distribuidor que se encuentra en los componentes de nivel de aplicacin en el servidor
PowerPlay.

Gua de instalacin y configuracin 133

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Asegrese de que el equipo donde haya instalado el Content Manager activo est configurado y
disponible antes de configurar los equipos de puerta de enlace.
Si Content Manager y el componente puerta de enlace estn instalados en equipos distintos, debe
seguir estos pasos en el equipo de puerta de enlace:

Instale el componente Puerta de enlace.

Configure el servidor Web.

Actualice el entorno Java.

Inicie IBM Cognos Configuration.

Configure las propiedades del entorno.

Pruebe el equipo de puerta de enlace.

Instalacin del componente Puerta de enlace


Puede instalar la puerta de enlace en uno o varios equipos de servidor Web. Utilice el asistente para
instalacin para seleccionar Puerta de enlace y la ubicacin del equipo donde desea realizar la instalacin.
En UNIX, para ejecutar la instalacin en modo grfico, la consola asociada al equipo de UNIX
debe admitir una interfaz grfica de usuario basada en Java.
En UNIX, IBM Cognos 8 respeta la mscara de creacin de modo de archivo (umask) de la cuenta
que ejecuta el programa de instalacin. Esto slo afecta a los directorios de instalacin. No afecta
a los permisos de archivos de los directorios. Sin embargo, los archivos generados en tiempo de
ejecucin, como los registros, respetan la mscara. Se recomienda utilizar el valor umask 022 en el
directorio de instalacin.
En Windows, asegrese de tener privilegios de administrador en el equipo de Windows en el que
est realizando la instalacin. Asegrese tambin de que el equipo disponga de una variable del
sistema TEMP que apunte al directorio en el que desea almacenar los archivos temporales. Durante
la instalacin, los archivos del CD se copian temporalmente en este directorio.

Pasos para UNIX y Linux


1. Si est realizando la instalacin en un directorio que tiene otros componentes de IBM Cognos
8, detenga el servicio IBM Cognos 8.
2. Configure la variable de entorno JAVA_HOME para que apunte a la ubicacin de instalacin
de su entorno en tiempo de ejecucin de Java (JRE).
Un ejemplo de ubicacin de instalacin del entorno en tiempo de ejecucin de Java es /directorio/java/versin_java/jre.
IBM Cognos 8 requiere una JVM, como IBM Java, para ejecutarse en Linux.
3. En HP-UX, configure la variable de entorno _M_ARENA_OPTS como se indica a continuacin:
_M_ARENA_OPTS 1:4

134 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
De este modo, se aumenta la asignacin de memoria para HP-UX, a fin de que coincida lo
mximo posible con la de otras plataformas de UNIX.
4. En AIX, configure la variable de entorno AIXTHREAD_SCOPE como se indica a continuacin:
AIXTHREAD_SCOPE=S
De este modo, se establece el mbito de contencin de los subprocesos del usuario en todo el
sistema, lo que permite una planificacin ms eficaz de los subprocesos del usuario.
5. Monte el CD de su producto de IBM Cognos utilizando extensiones de archivo Rock Ridge.
6. Vaya al directorio del CD correspondiente a su sistema operativo.
Por ejemplo, para Solaris, vaya al directorio de Solaris.
7. Inicie el asistente para instalacin:

Si utiliza XWindows, escriba


./issetup
Nota: Si utiliza el comando issetup con XWindows, se podran daar los caracteres japoneses en mensajes y archivos de registro. Cuando instale en japons en UNIX o Linux,
deber configurar primero las variables del entorno LANG=C y LC_ALL=C (donde C es
el cdigo del idioma, por ejemplo ja_JP.PCK en Solaris), y despus iniciar el asistente de
instalacin.

Si no utiliza XWindows, realice una instalacin sin participacin del usuario (p. 317).

8. Seleccione el idioma que desea utilizar en la instalacin.


El idioma que seleccione determina el idioma de la interfaz de usuario. Despus de la instalacin,
puede seleccionar el idioma de la interfaz de usuario del producto entre cualquiera de los idiomas
instalados.
9. En la pgina Seleccin de componentes, borre todos los componentes excepto Puerta de enlace.
No seleccione Componentes de migracin de IBM Cognos Series 7 aunque los componentes
de IBM Cognos Series 7 estn instalados en el equipo. Estos componentes se deben instalar
siguiendo las instrucciones de la seccin "Instalacin y configuracin de la migracin en equipos
de IBM Cognos Series 7" (p. 143).
10. En la pgina Varias ubicaciones de instalacin, especifique la ubicacin de IBM Cognos 8.
Si est realizando la instalacin en un equipo que contiene otros componentes de IBM Cognos
8 PowerPlay, realice la instalacin en el mismo directorio. Por ejemplo, si la instalacin se
realiza con IBM Cognos 8 BI Server, utilice la misma ubicacin en la que ha instalado el componente Puerta de enlace para IBM Cognos 8 BI Server. Se le solicitar la ubicacin de un
directorio en el que desea almacenar las copias de seguridad de los archivos que se sobrescribirn.
Instale los componentes de IBM Cognos 8 PowerPlay en un directorio que contenga slo
caracteres ASCII en el nombre de la ruta. Algunos servidores Web UNIX y Linux no admiten
caracteres no ASCII en los nombres de directorio.
11. Siga las indicaciones de las pginas Carpeta de accesos directos y Resumen de la instalacin.

Gua de instalacin y configuracin 135

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
12. Seleccione cmo continuar en la pgina Finalizar:

Si desea ver la informacin de ltima hora acerca de IBM Cognos 8, seleccione Ver Lame.

Haga clic en Finalizar.

13. Aada el directorio ubicacin_c8/bin a la variable de entorno de la ruta de biblioteca


correspondiente.

Para Solaris y Linux, LD_LIBRARY_PATH

Para AIX, LIBPATH

Para HP-UX, SHLIB_PATH

14. En Linux, configure la variable de entorno PRINTER con el nombre de la impresora.


Para garantizar la seguridad e integridad de IBM Cognos 8, es importante proteger el directorio de
instalacin de los accesos no autorizados y no adecuados.
Si desea que los usuarios puedan ver documentacin del producto en un idioma diferente al ingls,
deber instalar el componente Supplementary Languages Documentation en la misma ubicacin
que los componentes de la puerta de enlace. Para obtener ms informacin, consulte "Instalar
documentacin de producto traducida" (p. 166).

Pasos para Windows


1. Si est realizando la instalacin en un directorio que tiene otros componentes de IBM Cognos
8, detenga el servicio IBM Cognos 8.
2. Inserte el CD del producto de IBM Cognos.
Debe aparecer la pgina Bienvenido del asistente para instalacin.
Si no aparece la pgina Bienvenido, haga doble clic en el archivo issetup.exe del directorio
win32 del CD.
3. Seleccione el idioma que desea utilizar en la instalacin.
El idioma que seleccione determina el idioma de la interfaz de usuario. Despus de la instalacin,
puede seleccionar el idioma de la interfaz de usuario del producto entre cualquiera de los idiomas
instalados.
4. En la pgina Seleccin de componentes, borre todos los componentes excepto Puerta de enlace.
No seleccione Componentes de migracin de IBM Cognos Series 7 aunque los componentes
de IBM Cognos Series 7 estn instalados en el equipo. Estos componentes se deben instalar
siguiendo las instrucciones de la seccin "Instalacin y configuracin de la migracin en equipos
de IBM Cognos Series 7" (p. 143).
5. En la pgina Varias ubicaciones de instalacin, especifique la ubicacin de IBM Cognos 8.
Si est realizando la instalacin en un equipo que contiene otros componentes de IBM Cognos
8 PowerPlay, realice la instalacin en el mismo directorio. Por ejemplo, si la instalacin se
realiza con IBM Cognos 8 BI Server, utilice la misma ubicacin en la que ha instalado el com-

136 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
ponente Puerta de enlace para IBM Cognos 8 BI Server. Se le solicitar la ubicacin de un
directorio en el que desea almacenar las copias de seguridad de los archivos que se sobrescribirn.
Instale los componentes de IBM Cognos 8 PowerPlay en un directorio que contenga slo
caracteres ASCII en el nombre de la ruta. Algunos servidores Web UNIX y Linux no admiten
caracteres no ASCII en los nombres de directorio.
6. Siga las indicaciones de las pginas Carpeta de accesos directos y Resumen de la instalacin.
7. En la pgina Finalizar

Si no desea instalar ejemplos de IBM Cognos 8 y desea configurar de inmediato los componentes de IBM Cognos, haga clic en Inicio de IBM Cognos Configuration.

Si desea ver la informacin de ltima hora acerca de los componentes de IBM Cognos,
haga clic en Ver Lame.

8. Haga clic en Finalizar.


Utilice el men Inicio de Windows para iniciar IBM Cognos Configuration desde la carpeta de
acceso directo.
Si desea que los usuarios puedan ver documentacin del producto en un idioma diferente al ingls,
deber instalar el componente Supplementary Languages Documentation en la misma ubicacin
que los componentes de la puerta de enlace. Para obtener ms informacin, consulte "Instalar
documentacin de producto traducida" (p. 166).

Configuracin del servidor Web


Para todas las instalaciones, antes de utilizar pginas Web generadas por IBM Cognos 8, debe
configurar su servidor Web. Debe crear directorios virtuales, o alias, para que los usuarios se puedan
conectar a IBM Cognos 8 en el portal. Si tiene pensado ejecutar en un mismo equipo ms de un
producto de IBM Cognos 8, o varias instancias del mismo producto, debe crear un grupo de aplicaciones distinto para cada producto o instancia y, a continuacin, asociar los alias de ese producto
o instancia al grupo de aplicaciones. Los pasos para crear un grupo de aplicaciones varan segn
el sistema operativo.
En UNIX y Linux, la cuenta en la que se ejecuta el servidor Web debe tener acceso de lectura al
archivo cogstartup.xml en el directorio ubicacin_c8/configuration. De manera predeterminada, el
archivo cogstartup.xml tiene permisos de lectura para otros usuarios. Si ejecuta su servidor Web
en un grupo especfico, puede cambiar los permisos del archivo cogstartup.xml para asegurarse de
que pertenezca al mismo grupo que el servidor Web. As, podr eliminar el permiso de lectura para
otros usuarios.
Para obtener informacin sobre cmo crear una cuenta de usuario o una cuenta de servicio de red
para IBM Cognos 8, consulte (p. 54).

Pasos para crear directorios virtuales


1. Cree los siguientes directorios virtuales:

Gua de instalacin y configuracin 137

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida

Alias

Ubicacin

Permiso

cognos8

ubicacin_c8/webcontent

Lectura

cognos8/cgi-bin

ubicacin_c8/cgi-bin

Ejecucin

Puede utilizar un nombre distinto a cognos8 en los alias. Sin embargo, debe utilizar cgi-bin
como segunda parte del alias y cambiar el directorio virtual de la propiedad URI de puerta de
enlace para que coincida con el nuevo alias de IBM Cognos. Para obtener ms informacin,
consulte "Cambio de un URI" (p. 219).
Si actualiza el equipo desde ReportNet, puede seguir utilizando los alias existentes. Si instala
los componentes de creacin de informes de IBM Cognos 8 en una ubicacin distinta de
ReportNet, cambie los alias existentes para incluir la nueva ubicacin. Si tiene ms de una
versin de ReportNet en un equipo, debe utilizar distintos nombres de alias para IBM Cognos
8.
Para el servidor Web Apache, asegrese de definir el alias cognos8/cgi-bin antes que el alias
cognos8 del archivo httpd.conf que se encuentra en el directorio instalacin_Apache/conf. El
alias cognos8/cgi-bin debe definirse como ScriptAlias.
2. Si desea utilizar el explorador de imgenes de Report Studio, habilite Web Distributed Authoring
and Versioning (WebDAV) en su servidor Web.
Si utiliza el servidor Web Apache, especifique un directorio en el que habilitar WebDAV. Para
obtener informacin sobre cmo configurar WebDAV, consulte la documentacin de su servidor
Web.
Si utiliza Internet Information Services de Microsoft (IIS), habilite las propiedades Lectura y
Examen de directorios de la direccin URL a la que desee acceder.
3. Para la creacin de informes con IBM Cognos 8, configure la caducidad del contenido en el
directorio virtual ubicacin_c8/pat/images del servidor Web.
Cada vez que un usuario abre Report Studio, su explorador Web comprueba el servidor Web
para determinar si las imgenes son actuales. Dado que hay ms de 600 imgenes, esto puede
provocar un exceso de trfico en la red. Puede posponer esta comprobacin hasta una fecha
especfica gracias a la funcin de caducidad de contenido del servidor Web.
Para obtener informacin sobre cmo establecer la caducidad del contenido, consulte la documentacin del servidor Web.
Nota: Al actualizar, los usuarios de Report Studio debern borrar la cach del explorador Web
para obtener las imgenes ms recientes.

138 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Si utiliza alias Web distintas a cognos8, si el servidor Web est en otro equipo o si utiliza Microsoft
Internet Application Interface (ISAPI), apache_mod o una puerta de enlace del servlet, cambie el
URI de puerta de enlace (p. 219) cuando configure los componentes de IBM Cognos.

Pasos para crear un grupo de aplicaciones


1. En el men Inicio, seleccione Panel de control, Rendimiento y mantenimiento, Herramientas
administrativas.
2. Inicie Internet Information Services (IIS) Manager.
Web Management Tools y el World Wide Web Services se habilitan.
3. Desde la raz (su nombre de sistema y usuario), seleccione Feature View.
4. En la seccin IIS, inicie ISAPI and CGI Restrictions.
5. Seleccione Edit Feature Settings y habilite Allow unspecified CGI modules y, a continuacin,
haga clic en OK.
6. Aada sus alias. Por ejemplo, ubicacin_c8 y ubicacin_c8/cgi-bin.
7. Seleccione su alias cgi-bin y asegrese de que la vista Feature View est seleccionada.
8. Haga clic con el botn derecho del ratn en Application Pools y seleccione Add.
9. En el cuadro de dilogo, introduzca un alias Web y la ruta de acceso correspondiente al contenido
Web de IBM Cognos 8.
10. Repita los pasos 8 y 9 para aadir el siguiente alias Web.
11. Seleccione Default Web Site.
12. Abra Handler Mappings.
13. Seleccione CGI-cgi mappings.
14. En el panel derecho, haga clic en Revert to Inherited.
15. Expanda la aplicacin que dirige a su ubicacin de contenido Web.
16. Expanda el nodo de aplicacin cgi-bin.
17. Aada una asignacin que dirija a *.cgi y asgnele el nombre de CGI-cgi.
18. Seleccione la asignacin CGI-cgi.
19. En el panel derecho, haga clic en Revert to Inherited.
20. Reinicie el servidor IIS.
21. Busque la carpeta que contiene cgi-bin (ubicacin_c8/cgi-bin) y seleccinela con el botn derecho.
22. Seleccione la pestaa Security.
23. Aada el usuario de Servicios de red, concediendo todos los permisos excepto Full Control.
24. Haga clic con el botn derecho en Cognos8 service y seleccione Properties.
Gua de instalacin y configuracin 139

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
25. Haga clic en la pestaa Log On.
26. Seleccione This account e introduzca Servicios de red como el usuario.
27. Elimine los valores Password y Confirm the password.
28. Haga clic en Aceptar.

Actualizacin del entorno Java en el equipo de puerta de enlace


Para poder iniciar el servicio de Cognos 8, debe configurar la variable de entorno JAVA_HOME
y copiar el archivo Cognos.jar en el directorio JRE.
Si no tiene una variable JAVA_HOME ya definida en Windows, se utilizarn los archivos JRE
proporcionados con la instalacin, y no tendr que actualizar ningn archivo del entorno. Si
JAVA_HOME remite a una versin Java que no es vlida para IBM Cognos 8, deber actualizar
JAVA_HOME con la ruta correspondiente a una versin de Java vlida.

Pasos
1. Compruebe que la variable de entorno JAVA_HOME est configurada en la ubicacin del JRE.
Por ejemplo, para configurar JAVA_HOME en los archivos JRE proporcionados con la instalacin, la ruta es ubicacin_c8/bin/jre/versin.
2. Copie el archivo bcprov-jdknn-nnn.jar del directorio ubicacin_c8/bin/jre/versin/lib/ext en el
directorio ubicacin_Java/jre/lib/ext.

Inicio de IBM Cognos Configuration en el equipo de puerta de enlace


Utilice IBM Cognos Configuration para configurar los componentes de IBM Cognos 8 e iniciar y
detener los servicios de IBM Cognos.
Asegrese de haber configurado la cuenta de servicio o usuario. Para obtener ms informacin,
consulte la seccin "Configuracin de una cuenta de usuario o de servicio de red para IBM Cognos 8" (p. 54).

Paso
1. Para iniciar IBM Cognos Configuration en un equipo de Windows, desde el men Inicio, haga
clic en Programas, IBM Cognos 8, IBM Cognos Configuration.
2. Para iniciar IBM Cognos Configuration en un equipo de UNIX o Linux, vaya al directorio
ubicacin_c8/bin y escriba
./cogconfig.sh

Configuracin de las propiedades de entorno para los equipos de puerta de enlace


Si instala el componente puerta de enlace en un equipo distinto al de Content Manager o al de
componentes de nivel de aplicacin, debe configurar el equipo de puerta de enlace para que ste
conozca la ubicacin de un distribuidor. Hay un distribuidor instalado en cada equipo de Content

140 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Manager y de componentes de nivel de aplicacin. Se recomienda que la puerta de enlace utilice el
distribuidor en un equipo de componentes de nivel de aplicacin.
Para la proteccin en caso de migracin tras error, puede configurar ms de un distribuidor para
un equipo de puerta de enlace. Cuando se configuran varios distribuidores, las solicitudes se suelen
dirigir al primer distribuidor de la lista. Si este distribuidor deja de estar disponible, la puerta de
enlace determina el siguiente distribuidor activo de la lista y dirige las solicitudes a ste. La puerta
de enlace controla el estado del distribuidor principal y las solicitudes se vuelven a dirigir a este
componente cuando vuelve a entrar en servicio.
Cuando haya realizado las tareas de configuracin necesarias, el equipo de puerta de enlace podr
trabajar en su entorno.
Antes de configurar los equipos de puerta de enlace, asegrese de que los equipos donde haya instalado Content Manager estn configurados y de que el equipo de Content Manager activo predeterminado est disponible.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana Propiedades, cambie la parte localhost de todas las propiedades del URI por el
nombre o la direccin IP de los servidores de IBM Cognos 8, siguiendo estos pasos:

En URI de distribuidor para puerta de enlace y URI de Content Manager, haga clic en el
valor y, a continuacin, en el botn Editar. Cambie la parte localhost y haga clic en Aceptar.

Para todas las propiedades de URI restantes, haga clic en el valor y cambie la parte localhost.

4. En Configuracin de puerta de enlace, especifique los valores correspondientes a URI de distribuidor para puerta de enlace:

Haga clic en la columna del valor.

Haga clic en el botn Editar.

Cambie la parte localhost del URI por el nombre o la direccin IP de un equipo de componentes de nivel de aplicacin.
Sugerencia: Si desea enviar solicitudes al distribuidor desde una aplicacin SDK o una
herramienta de modelado de IBM Cognos 8 que se encuentra fuera del servidor de seguridad
de red, se recomienda conectarse a una puerta de enlace dedicada configurada para
conectarse al distribuidor mediante el URI de distribuidor interno de su entorno (por
ejemplo, http://localhost:9300/p2pd/servlet/dispatch). Por cuestiones de seguridad, el valor
predeterminado de la propiedad URI de distribuidor para puerta de enlace impide que el
distribuidor acepte solicitudes de una aplicacin SDK o una herramienta de modelado que
se encuentra fuera del servidor de seguridad. Asegrese de haber configurado la seguridad
necesaria para esta puerta de enlace dedicada, como por ejemplo, SSL (p. 237). No cambie
la puerta de enlace principal para que utilice el URI de distribuidor interno. Si lo hiciese,
se reducira la seguridad del portal y de las aplicaciones Studio de IBM Cognos 8. Para
obtener ms informacin sobre la herramienta de modelado y los servidores de seguridad

Gua de instalacin y configuracin 141

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
de red, consulte la gua de instalacin y configuracin que se incluye con la herramienta
de modelado.

Si desea aadir otro URI, haga clic en Aadir y cambie la parte localhost del nuevo URI
por el nombre o la direccin IP de otro equipo de componentes de nivel de aplicacin.
Si desea utilizar el distribuidor en un equipo de Content Manager en espera, asegrese de
aadirlo despus de aadir los equipos de componentes de nivel de aplicacin. Si aade el
distribuidor desde el equipo de Content Manager activo, asegrese de que sea el ltimo de
la lista.
Nota: Para trabajar con el registro de migracin, debe especificar el distribuidor del equipo
de Content Manager activo.

Despus de especificar todos los URI, haga clic en Aceptar.

5. En la ventana Explorador, en Seguridad, Criptografa, haga clic en Cognos, el proveedor criptogrfico predeterminado.
6. En el grupo de propiedades Configuracin de la entidad emisora de certificados, establezca la
propiedad Contrasea de manera que coincida con el valor configurado en el equipo de Content
Manager activo predeterminado.
7. Asegrese de que todos los valores criptogrficos restantes coincidan con los que ha configurado
en el equipo de Content Manager activo predeterminado.
8. Pruebe si la clave simtrica se puede recuperar. En la ventana Explorador, haga clic con el botn
derecho en Criptografa y, a continuacin, haga clic en Probar.
Los componentes de IBM Cognos 8 comprueban la disponibilidad de CSK.
9. En el men Archivo, haga clic en Guardar.

Cmo probar el equipo de puerta de enlace


Puede probar los valores de configuracin mediante la funcin de prueba al configurar IBM Cognos
8. Despus de haber finalizado la configuracin e iniciado los servicios, puede probar la puerta de
enlace; para ello, abra el portal de IBM Cognos 8.

Pasos
1. Abra un explorador Web.
2. Abra el portal de IBM Cognos 8 escribiendo alguna de las rdenes siguientes, donde cognos8
es el directorio virtual que cre al configurar el servidor Web.

Para la puerta de enlace CGI:


http://EquipoPuertaEnlace_nombre:puerto/cognos8

Para una puerta de enlace ISAPI:


http://EquipoPuertaEnlace_nombre:puerto/cognos8/isapi

142 PowerPlay

Para Apache Connector en Windows:

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
http://EquipoPuertaEnlace_nombre:puerto/cognos8/cgi-bin/mod_cognos.dll

Para Apache Connector en Solaris o AIX:


http://EquipoPuertaEnlace_nombre:puerto/cognos8/cgi-bin/mod_cognos.so

Para Apache Connector en HP-UX PA-RISC:


http://EquipoPuertaEnlace_nombre:puerto/cognos8/cgi-bin/mod_cognos.sl

Para Apache Connector en HP-UX IA:


http://EquipoPuertaEnlace_nombre:puerto/cognos8/cgi-bin/mod2_cognos.so

Para un servlet de puerta de enlace:


http://EquipoPuertaEnlace_nombre:puerto/context_root/servlet/ Gateway

Puede que la pgina Web tarde unos minutos en abrirse. Si ve la pgina de bienvenida del
portal de IBM Cognos 8, la instalacin se est realizando correctamente.
Cuando haya completado la configuracin inicial de IBM Cognos 8 PowerPlay, podr instalar IBM
Cognos 8 PowerPlay Client (p. 151). Tambin puede personalizar los componentes que utilizar en
su entorno cambiando otros valores de IBM Cognos Configuration (p. 213).

Administracin de PowerPlay
Para cambiar los valores de tiempo de ejecucin de IBM Cognos 8 PowerPlay, utilice IBM Cognos
Administration, al que se accede a travs del portal de IBM Cognos 8. Por ejemplo, puede iniciar
o detener distribuidores y servicios o configurar permisos para usuarios, grupos y roles. Para obtener
ms informacin, consulte la Gua de administracin y seguridad. Tambin puede configurar las
opciones de migracin y de informes y cubos de PowerPlay. Para obtener ms informacin, consulte
la Gua de migracin y administracin.

Instalacin y configuracin de la migracin en equipos de IBM


Cognos Series 7
Despus de instalar los componentes de IBM Cognos 8 PowerPlay, puede instalar componentes de
migracin de IBM Cognos Series 7 para poder realizar la migracin de contenido de PowerPlay
desde IBM Cognos Series 7 a IBM Cognos 8 PowerPlay. Los componentes de migracin de IBM
Cognos Series 7 estn disponibles para Windows y UNIX en el CD de IBM Cognos 8 PowerPlay
Server.
Utilice de la siguiente lista de comprobacin como gua para realizar las tareas de instalacin y
configuracin de la migracin de IBM Cognos 8.

Instale los componentes de migracin de IBM Cognos Series 7.

Configure los componentes de migracin de IBM Cognos Series 7, si es necesario.

Inicie el servicio de migracin de IBM Cognos Series 7.

Gua de instalacin y configuracin 143

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida

Instalacin de los componentes de migracin de IBM Cognos Series 7


Asegrese de que las instalaciones de IBM Cognos Series 7 funcionan correctamente antes de instalar
los componentes de migracin de IBM Cognos Series 7. Esto implica que deben estar en ejecucin
el servicio IBM Cognos Series 7 PowerPlay Enterprise Server y los servicios de Upfront, incluidos
el servicio de administracin de IBM Cognos Upfront, el almacn de datos de IBM Cognos Upfront
y los servicios del distribuidor de IBM Cognos Upfront.
Los componentes de migracin de IBM Cognos Series 7 se instalan en los equipos de IBM Cognos
Series 7.

Para migrar contenido desde PowerPlay Enterprise Server, debe instalar componentes de
migracin de IBM Cognos Series 7 en el equipo de PowerPlay Enterprise Server. Si Upfront se
encuentra en el mismo equipo, tambin es posible migrar contenido desde Upfront. La instalacin
de componentes de migracin en el equipo de PowerPlay Enterprise Server es tambin compatible con la migracin del contenido de PowerPlay que se public en Cognos Connection.

Para migrar el contenido de Upfront, debe instalar componentes de migracin de IBM Cognos
Series 7 en el equipo de Upfront. Cuando Upfront y PowerPlay Enterprise Server se encuentran
instalados en equipos distintos, debe instalar componentes de migracin de IBM Cognos Series 7
tanto en el equipo de PowerPlay Enterprise Server como en el de Upfront. Adems, debe preparar
y configurar una ubicacin de red compartida para permitir el procesamiento de la migracin.

Pasos
1. Inserte el CD de IBM Cognos 8 PowerPlay Server indicado para su sistema operativo. En UNIX,
debe montar el CD utilizando extensiones de archivo Rock Ridge.
2. Si la pgina Bienvenido no aparece, siga estos pasos:

En Windows, en el directorio win32 del CD, haga doble clic en el archivo isseteup.exe.

En UNIX, en el directorio indicado para su sistema operativo, escriba


./issetup

3. Seleccione el idioma que desea utilizar en la instalacin.


El idioma que seleccione determinar el idioma del asistente para instalacin.
4. Siga las indicaciones del asistente para instalacin.
5. En la pgina Seleccin de componentes, borre todos los componentes excepto Componentes
de migracin de IBM Cognos Series 7.
6. En la pgina Varias ubicaciones de instalacin, especifique la ubicacin de IBM Cognos Series 7
en la que desea instalar los componentes.
Debe instalar los componentes de migracin de IBM Cognos Series 7 en el mismo directorio
que IBM Cognos Series 7 versin 4 (7.4).
Si se le solicita la ubicacin de instalacin de IBM Cognos 8, puede aceptar la ubicacin predeterminada o introducir una nueva ubicacin local. Esta ubicacin se utiliza para escribir los
archivos de instalacin. No es necesario que especifique la ruta de acceso a una instalacin de

144 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
IBM Cognos 8 en un equipo diferente, y tampoco precisa disponer de componentes de IBM
Cognos 8 en el equipo con IBM Cognos Series 7.
7. En la pgina Informacin de configuracin de migracin, en Nmero de puerto del servicio de
migracin, escriba el nmero de puerto que utilizar el servicio de migracin de IBM Cognos
Series 7. El valor predeterminado es 21567.
8. En la pgina Finalizar, haga clic en Finalizar.
Al igual que otros productos de IBM Cognos, el proceso de instalacin crea archivos de registro en
los que se incluye informacin como, por ejemplo, detalles sobre archivos transferidos o errores de
instalacin. Los archivos de registro se encuentran en el directorio ubicacin_instalacin\instlog.

Configuracin del servicio de migracin de IBM Cognos Series 7 para migraciones


desde Upfront en instalaciones de IBM Cognos Series 7 distribuidas
Si ha instalado componentes de migracin de IBM Cognos Series 7 tanto en un equipo de PowerPlay
Enterprise Server como en un equipo de Upfront aparte, debe preparar y configurar una ubicacin
de red compartida. El servicio de migracin escribe archivos temporales en esta ubicacin durante
el proceso de migracin.
A la hora de migrar desde Upfront cuando PowerPlay Enterprise Server y Upfront estn en equipos
distintos, se aplican las siguientes limitaciones.

Notas

PowerPlay Enterprise Server y Upfront deben acceder a los PowerCubes utilizando la misma
ruta de acceso, como \\nombre_mquina\cubes. Si los cubos se encuentran en el mismo equipo
que PowerPlay Enterprise Server, PowerPlay Enterprise Server acceder a los cubos utilizando
una ruta local, mientras que Upfront acceder a los cubos utilizando una ruta que incluye el
nombre del equipo de PowerPlay Enterprise. La migracin desde Upfront no funcionar en esta
situacin.

No se puede realizar una migracin desde Upfront si se utiliza ms de un equipo de PowerPlay


Enterprise Server para publicar contenido en Upfront.

Pasos
1. Cree una carpeta en una ubicacin de red compartida a la que se pueda acceder tanto desde el
equipo de PowerPlay Enterprise Server como desde el equipo de Upfront.
Asegrese de que los servicios de migracin de PowerPlay Enterprise Server, Upfront e IBM
Cognos Series 7 se ejecuten mediante cuentas con nombre que tengan acceso de escritura sobre
la carpeta.
2. Realice los pasos siguientes en cada equipo que tenga componentes de migracin de IBM
Cognos Series 7.

Desde ubicacin_instalacin/mig7service, abra el archivo migs7service_configuration.xml


en un editor de XML o texto.

Gua de instalacin y configuracin 145

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida

Edite la lnea series7-shared-location description para especificar la ubicacin de red y


activar la lnea (quite las etiquetas de comentario). Por ejemplo:
<series7-shared-location description="Ruta a la carpeta compartida">\\bott93\shareT\
s7migration</ubicacin-compartida-de-series7>

Guarde y cierre el archivo.

3. Reinicie el servicio de migracin de IBM Series 7.


La configuracin para permitir la migracin desde equipos de PowerPlay Enterprise Server y Upfront
independientes ha terminado.

Inicio del servicio de migracin de IBM Cognos Series 7


Para poder migrar contenido de IBM Cognos Series 7 PowerPlay a IBM Cognos 8 PowerPlay, debe
iniciar el servicio de migracin para IBM Cognos Series 7. En Windows, el servicio de migracin
de IBM Cognos Series 7 se inicia automticamente cuando se instala por primera vez.

Paso

Inicie el servicio de migracin:

En Windows, si se detiene el servicio, reinicie el servicio de migracin utilizando la entrada


Servicio de migracin de IBM Cognos Series 7 que se encuentra en la opcin Servicios de
Herramientas administrativas.

En UNIX, vaya al directorio ubicacin_c8/migs7 e inicie el servicio escribiendo


./configure.sh --start

Desinstalacin de IBM Cognos 8


Es importante utilizar los programas de desinstalacin de IBM Cognos 8 para eliminar los productos
de IBM Cognos 8.
Si ejecuta IBM Cognos 8 en un entorno de servidor de aplicaciones, utilice la herramienta de
administracin del proveedor del servidor de aplicaciones para detener la aplicacin si se est ejecutando y anule la implementacin de la parte Java de los componentes de IBM Cognos 8. Muchos
servidores de aplicaciones no eliminan completamente todos los archivos o directorios de las aplicaciones implementadas durante una anulacin de implementacin, por lo que puede que tenga
que hacerlo manualmente. Despus de haber anulado la implementacin de los componentes de
IBM Cognos 8, complete los pasos para desinstalar en UNIX y en Windows, segn sea necesario.

Desinstalacin de IBM Cognos 8 en UNIX o Linux


Si ya no necesita IBM Cognos 8 o si va a realizar la actualizacin, desinstale IBM Cognos 8.

146 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Le recomendamos que cierre todos los programas antes de desinstalar IBM Cognos 8. De lo contrario,
algunos archivos no pueden eliminarse.

Pasos
1. Si la consola adjunta a su equipo no admite una interfaz grfica de usuario basada en Java,
determine el identificador de proceso (pid) del proceso IBM Cognos 8 escribiendo el siguiente
comando:
ps -ef | grep cogbootstrapservice
2. Detenga el proceso IBM Cognos 8:

Si trabaja con XWindows, inicie IBM Cognos Configuration y en el men Acciones, haga
clic en Detener.

Si no trabaja con XWindows, escriba:


kill -TERM pid

3. Para desinstalar IBM Cognos 8, vaya al directorio ubicacin_c8/uninstall y escriba el comando


apropiado:

Si utiliza XWindows, escriba


./uninst -u

Si no utiliza XWindows, realice una desinstalacin sin participacin del usuario (p. 317).

4. Siga las instrucciones para completar la desinstalacin.


5. Elimine todos los archivos temporales de Internet.
La desinstalacin no elimina ningn archivo que haya cambiado desde la instalacin, como los
archivos de datos de usuario y configuracin. La ubicacin de la instalacin permanece en su equipo
y estos archivos se mantienen hasta que los elimine manualmente.
Importante: No elimine los archivos de configuracin y de datos si est actualizando a una nueva
versin de IBM Cognos 8 y desea utilizar los datos de configuracin con la nueva versin.

Desinstalacin de IBM Cognos 8 en Windows


Si ya no necesita IBM Cognos 8 o si va a realizar la actualizacin, desinstale todos los componentes
y el servicio de IBM Cognos 8.
Si ha instalado ms de un componente o producto de IBM Cognos 8 en la misma ubicacin, el
asistente para desinstalacin le permitir seleccionar los paquetes que debe desinstalar. Se desinstalarn todos los componentes del paquete. Debe repetir el proceso de desinstalacin en cada equipo
que contenga componentes de IBM Cognos 8.
No es necesario realizar copias de seguridad de la configuracin y los archivos de datos en Windows.
Estos archivos se conservan durante la desinstalacin.

Gua de instalacin y configuracin 147

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
Le recomendamos que cierre todos los programas antes de desinstalar IBM Cognos 8. De lo contrario,
algunos archivos no pueden eliminarse.

Pasos
1. En el men Inicio, haga clic en Programas, IBM Cognos 8, Desinstalar IBM Cognos 8.
Aparece el asistente Desinstalar.
Sugerencia: IBM Cognos 8 es el nombre predeterminado de la carpeta de programa que se crea
durante la instalacin. Si elige otro nombre, vaya a esa carpeta para encontrar el programa.
2. Siga las instrucciones para desinstalar los componentes.
El archivo cognos_uninst_log.txt registra las actividades que realiza el asistente para desinstalacin mientras efecta la desinstalacin de archivos. Este archivo de registro se crea en el
directorio temp.
3. Elimine todos los archivos temporales de Internet.
Para obtener ms informacin, consulte la documentacin del explorador Web.
La desinstalacin no elimina ningn archivo que haya cambiado desde la instalacin, como los
archivos de datos de usuario y configuracin. La ubicacin de la instalacin permanece en su equipo
y estos archivos se mantienen hasta que los elimine por medio del Explorador de Windows.
Importante: No elimine los archivos de configuracin y de datos si est actualizando a una nueva
versin de IBM Cognos 8 y desea utilizar los datos de configuracin con la nueva versin.

Desinstalacin de la base de datos de contenido de Cognos


Si desea desinstalar slo la base de datos de contenido y conservar otros componentes de IBM
Cognos 8 en su equipo, deber utilizar el siguiente procedimiento. Despus de desinstalar la base
de datos de contenido, deber configurar un nuevo almacn de contenido antes de poder reiniciar
el servicio de IBM Cognos 8.
Si ha instalado slo la base de datos de contenido de Cognos, utilice otro procedimiento. Para
obtener informacin acerca de este procedimiento, consulte "Desinstalacin de IBM Cognos 8 en
UNIX o Linux" (p. 103) o "Desinstalacin de IBM Cognos 8 en Windows" (p. 104).

Pasos
1. En el equipo en el que ha instalado la base de datos de contenido de Cognos, vaya al directorio
ubicacin_c8\bin y escriba el siguiente comando:

En Windows, escriba
derby.bat uninstall
Este comando elimina el servicio de la base de datos de contenido de Cognos.

En UNIX, escriba
derby.sh stop
Este comando detiene el servicio de la base de datos de contenido de Cognos.

148 PowerPlay

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
2. En el directorio ubicacin_c8, elimine el directorio derby10.1.2.1.
3. En el directorio ubicacin_c8\bin, elimine los siguientes archivos:

En Windows, derby.bat

En UNIX, derby.sh y derbyenv.sh

4. En Windows, en el directorio ubicacin_c8\logs, elimine el archivo derby.service.


5. En el directorio ubicacin_c8, abra el archivo cmplst.txt en un editor de texto.
6. Elimine las lneas que contengan valores de la base de datos de contenido de Cognos. Las lneas
contienen los caracteres CCD y CMDERBY. Por ejemplo:
C8BISRVRCCD_version=
C8BISRVRCCD_name=
CCD_version=
CCD_name=
CMDERBY_version=
CMDERBY_name=

Sugerencia: Tambin puede convertir las lneas en comentarios mediante la insercin de # al


comienzo de cada lnea.
7. Guarde el archivo.
8. Inicie IBM Cognos Configuration.
9. En Acceso a datos, Content Manager, haga lo siguiente:

Elimine la base de datos de contenido de Cognos.

Configure un nuevo recurso de base de datos que apunte a un nuevo almacn de contenido.

Para obtener ms informacin, consulte "Configuracin de las propiedades de la conexin a


la base de datos en el almacn de contenido" (p. 89).
10. Reinicie IBM Cognos 8.

Desinstalacin de los componentes de migracin


Los componentes de migracin de IBM Cognos 8 se desinstalan al desinstalar el propio IBM Cognos
8. No es posible desinstalar nicamente los componentes de migracin de una instalacin de IBM
Cognos 8.
Sin embargo, los componentes de migracin de IBM Series 7 se pueden desinstalar por separado
de la instalacin de IBM Cognos Series 7. Una vez terminada la migracin desde IBM Cognos
Series 7, puede optar por desinstalar los componentes de migracin de cada uno de los equipos en
los que est instalado IBM Cognos Series 7. Sin embargo, los componentes de migracin slo estn

Gua de instalacin y configuracin 149

Captulo 7: Instalacin y configuracin de los componentes del servidor PowerPlay de IBM Cognos 8 en una instalacin distribuida
activos durante la migracin y no afectarn a la instalacin de IBM Cognos Series 7 si decide no
desinstalar los componentes de migracin.

Paso

En los equipos IBM Cognos Series 7, desinstale el componente Migracin de informes de IBM
Cognos desde Series 7.
Para obtener ms informacin acerca de la desinstalacin de los componentes de IBM Cognos
Series 7, consulte IBM Cognos Series 7 Solution Installation Guide.

150 PowerPlay

Captulo 8: Instalacin y configuracin de los


componentes de cliente y de modelado
Despus de que los componentes de servidor estn funcionando en el entorno de IBM Cognos 8,
puede aadir los componentes de cliente y de modelado. Esta seccin contiene informacin acerca
de la instalacin y la configuracin de IBM Cognos 8 Business Intelligence PowerPlay Client. Los
autores de informes pueden utilizar IBM Cognos 8 PowerPlay Client para trabajar desconectados
de la red o para hacer ms potente la creacin mediante PowerPlay.
Esta seccin tambin incluye informacin acerca de la desinstalacin de IBM Cognos 8 PowerPlay
Client. Para obtener ms informacin, consulte "Desinstalacin de IBM Cognos 8 PowerPlay
Client" (p. 154).
Si los modeladores desean crear paquetes relacionales o de origen mixto, necesita la herramienta
de modelado de IBM Cognos 8: Framework Manager. Si los modeladores desean crear PowerCubes,
necesita IBM Cognos 8 Transformer. Si los modeladores desean crear PowerCubes desde orgenes
relacionales, necesita Framework Manager e IBM Cognos 8 Transformer. Para obtener informacin
sobre la instalacin de Framework Manager e IBM Cognos 8 Transformer, consulte IBM Cognos 8
Business Intelligence Gua de instalacin y configuracin que se suministra con los componentes
de modelado.
Si va a realizar la instalacin en un equipo con Windows Vista, se recomienda no instalarlos en el
directorio Archivos de programa. Las mejoras de seguridad de Windows Vista restringen a las
aplicaciones la escritura en el directorio Archivos de programa durante el funcionamiento de los
programas.

Instalacin y configuracin de IBM Cognos 8 PowerPlay Client


En esta seccin se proporciona la informacin necesaria para instalar y configurar IBM Cognos 8
PowerPlay Client. IBM Cognos 8 PowerPlay Client le permite ver, explorar, formatear y distribuir
informes PowerPlay en el entorno de IBM Cognos 8.
Si actualiza una versin anterior de IBM Cognos 8 PowerPlay Client, desinstale primero la versin
existente antes de instalar la ltima versin. Realice una copia de seguridad de los datos del cliente
como los informes de la ubicacin de instalacin antes de proceder con la desinstalacin.
Utilice la lista de comprobacin siguiente como gua para realizar las tareas necesarias para instalar
y configurar IBM Cognos 8 PowerPlay Client:

Instalar IBM Cognos 8 PowerPlay Client

Configurar IBM Cognos 8 PowerPlay Client

Probar IBM Cognos 8 PowerPlay Client

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

151

Captulo 8: Instalacin y configuracin de los componentes de cliente y de modelado

Instalacin de IBM Cognos 8 PowerPlay Client


Utilice el asistente para la instalacin para instalar IBM Cognos 8 PowerPlay Client en un equipo
con Windows.
Si va a realizar la instalacin en un equipo con Windows Vista, se recomienda no instalarlos en el
directorio Archivos de programa. Las mejoras de seguridad de Windows Vista restringen a las
aplicaciones la escritura en el directorio Archivos de programa durante el funcionamiento de los
programas.
Puede tener IBM Cognos Series 7 PowerPlay para Windows e IBM Cognos 8 PowerPlay Client en
el mismo equipo. Esto puede ser til al migrar informes de IBM Cognos Series 7 a IBM Cognos 8.
Cuando los dos productos se instalan en el mismo equipo, las asociaciones de archivos se configuran
para iniciar el producto que se ha instalado ms recientemente cuando se accede a un archivo PPX
o MDC. Si instala IBM Cognos Series 7 PowerPlay para Windows despus de instalar IBM Cognos 8
PowerPlay Client, puede restablecer las asociaciones de archivo para que los archivos PPX y MDC
se abran en IBM Cognos 8 PowerPlay Client.

Pasos para la instalacin


1. Inserte el CD del producto.
2. Si el asistente para la instalacin no se abre automticamente, vaya al directorio win32 y haga
doble clic en issetup.exe.
3. En la pgina de bienvenida del asistente para la instalacin, seleccione uno de los idiomas disponibles y, a continuacin, haga clic en Siguiente.
El idioma que selecciona determina el idioma del asistente para la instalacin.
4. En cada pgina del Contrato de licencia, seleccione Acepto y, a continuacin, haga clic en
Siguiente.
5. En la pgina Ubicacin de instalacin, especifique la ubicacin de IBM Cognos 8.
Si otros componentes de IBM Cognos 8 PowerPlay se instalan en el equipo, especifique el mismo
directorio que los dems componentes de PowerPlay. Se le solicitar la ubicacin de un directorio en el que desea almacenar las copias de seguridad de los archivos que se sobrescribirn.
Si no se instala ningn otro componente de IBM Cognos 8 PowerPlay en el equipo, acepte la
ubicacin predeterminada o especifique una nueva ubicacin. Si va a instalar en Windows Vista,
especifique una ubicacin fuera del directorio Archivos de programa. Si especifica una nueva
ubicacin, utilice un nombre de directorio que contenga slo caracteres ASCII. Algunos servidores Web no admiten caracteres que no son ASCII en los nombres de directorio.
6. En la pgina Informacin de usuario, especifique la configuracin y haga clic en Siguiente.
7. En la pgina Seleccin de idioma del producto, seleccione el idioma para la interfaz de usuario
del producto y, a continuacin, haga clic en Siguiente.
Slo se puede seleccionar un idioma por instalacin. Se recomienda utilizar un idioma que
coincida con la configuracin regional del sistema. De lo contrario, utilice el ingls. Asimismo,
se recomienda configurar fuentes que coincidan con la configuracin regional del sistema.
Asegrese de que se instalan fuentes compatibles en el equipo cliente.
152 PowerPlay

Captulo 8: Instalacin y configuracin de los componentes de cliente y de modelado


Para obtener instrucciones acerca de la instalacin de idiomas suplementarios, consulte IBM
Cognos 8 Supplementary Languages Installation and Configuration Guide. Se aplican las restricciones siguientes para los idiomas suplementarios:

Aunque el ruso est disponible en los idiomas suplementarios, no se aplica a IBM Cognos 8
PowerPlay Client.

Si va a instalar varios productos de IBM Cognos 8 en una ubicacin, debe instalar los
idiomas suplementarios en ltimo lugar.

8. En la pgina Seleccin de componentes, acepte la configuracin predeterminada y haga clic en


Siguiente.
9. Siga las indicaciones de las pginas Carpeta de accesos directos y Resumen de la instalacin.
10. En la pgina Finalizar, realice lo siguiente:

Si desea ver informacin de ltima hora acerca de IBM Cognos 8 PowerPlay Client, seleccione Ver Lame.

Haga clic en Finalizar.

Paso para restablecer las asociaciones de archivo en IBM Cognos 8 PowerPlay Client

Si instala IBM Cognos Series 7 PowerPlay para Windows despus de instalar IBM Cognos 8
PowerPlay Client y desea que los archivos PPX y MDC se abran en IBM Cognos 8 PowerPlay
Client, ejecute el comando siguiente en el directorio ubicacin_cliente_c8\bin:
PwrPlay.exe /regserver.

Configuracin de IBM Cognos 8 PowerPlay Client


Despus de instalar IBM Cognos 8 PowerPlay Client, debe configurarlo para que funcione en su
entorno. Si instala IBM Cognos 8 PowerPlay Client para utilizarlo solamente con PowerCubes
locales, no se necesita ninguna configuracin.
La configuracin es necesaria si lo instala en un equipo distinto del servidor IBM Cognos 8
PowerPlay y desea utilizar PowerCubes remotos.
Algunas tareas de configuracin son opcionales. Se realizan para cambiar los valores de propiedad
predeterminados que utiliza IBM Cognos 8 PowerPlay Client.
Antes de configurar IBM Cognos 8 PowerPlay Client, se recomienda instalar y configurar los
componentes del servidor de IBM Cognos 8: Content Manager, componentes de nivel de aplicacin
y puerta de enlace. De este modo se garantiza que la autoridad de certificacin del ordenador de
Content Manager pueda emitir un certificado a IBM Cognos 8 PowerPlay Client y que IBM Cognos
8 PowerPlay Client pueda comunicarse con la puerta de enlace.

Pasos para configurar el acceso al servidor PowerPlay para PowerCubes remotos


1. En el equipo en el que ha instalado IBM Cognos 8 PowerPlay Client, inicie IBM Cognos Configuration.
2. En la ventana Explorador, haga clic en Entorno.
Gua de instalacin y configuracin 153

Captulo 8: Instalacin y configuracin de los componentes de cliente y de modelado


3. En la ventana Propiedades, en el cuadro URI de puerta de enlace, cambie la parte del nombre
de host de localhost a la direccin IP o al nombre de host de la red del equipo de puerta de
enlace.
4. Especifique el valor para el URI de distribuidor para aplicaciones externas.

Si el servidor Web est configurado para no permitir un acceso annimo, escriba el URI
del distribuidor en el servidor Web y asegrese de que cambia el nombre de host en el URI
de localhost.

Si el servidor Web est dentro del servidor de seguridad, escriba el URI del distribuidor en
un servidor Web fuera del servidor de seguridad y asegrese de que cambia el nombre de
host en el URI de localhost.

Si est utilizando una puerta de enlace dedicada para las comunicaciones de IBM Cognos 8
PowerPlay Client, escriba el URI del distribuidor en la puerta de enlace dedicada.

5. Si ha cambiado la contrasea predeterminada en el equipo de Content Manager, realice lo


siguiente:

En la ventana Explorador, en Criptografa, haga clic en Cognos.

En el grupo de propiedades Configuracin de la entidad emisora de certificados, para la


propiedad Contrasea, escriba la misma contrasea que ha configurado en el equipo de
Content Manager activo predeterminado.

6. En el men Archivo, haga clic en Guardar.

Prueba de la instalacin
Puede probar la instalacin de IBM Cognos 8 PowerPlay Client si abre PowerPlay.

Paso

En el men Inicio, en Programas, IBM Cognos 8, haga clic en PowerPlay 8.


Si aparece la pgina de bienvenida de PowerPlay, la instalacin es correcta.

Desinstalacin de IBM Cognos 8 PowerPlay Client


Desinstale IBM Cognos 8 PowerPlay Client si desea cambiar el idioma o si ya no lo necesita. Es
importante utilizar los programas de desinstalacin de IBM Cognos 8 para eliminar los productos
de IBM Cognos 8. No utilice las herramientas Agregar o quitar programas de Windows.
La desinstalacin no elimina ningn archivo que haya cambiado desde la instalacin, como los
archivos de datos de usuario y configuracin. La ubicacin de la instalacin permanece en su equipo
y estos archivos se mantienen hasta que los elimine manualmente.

154 PowerPlay

Captulo 8: Instalacin y configuracin de los componentes de cliente y de modelado


Se recomienda cerrar todos los programas antes de desinstalar los productos de IBM Cognos 8. De
lo contrario, algunos archivos no pueden eliminarse.

Pasos
1. En el men Inicio, haga clic en Programas, IBM Cognos 8, Desinstalar IBM Cognos 8,
Desinstalar IBM Cognos 8.
Aparece el Asistente para desinstalacin.
Sugerencia: IBM Cognos 8 es el nombre predeterminado de la carpeta que se crea durante la
instalacin. Si elige otro nombre, vaya a esa carpeta para encontrar el programa.
2. Siga las instrucciones para desinstalar los componentes.
El archivo cognos_uninst_log.txt registra las actividades que realiza el asistente para desinstalacin mientras efecta la desinstalacin de archivos. Este archivo de registro se crea en el
directorio temp.
3. Elimine todos los archivos temporales de Internet.
Para obtener ms informacin, consulte la documentacin del explorador Web.

Gua de instalacin y configuracin 155

Captulo 8: Instalacin y configuracin de los componentes de cliente y de modelado

156 PowerPlay

Captulo 9: Instalacin y configuracin de componentes opcionales


Los componentes opcionales proporcionan a los usuarios funciones ampliadas.
Despus de instalar y configurar IBM Cognos 8 PowerPlay, puede instalar los siguientes componentes
opcionales.

Ejemplos de IBM Cognos 8

Documentacin de producto traducida

Fuentes adicionales para smbolos de moneda de japons y coreano

Ejemplos de PowerPlay
IBM Cognos 8 proporciona bases de datos de ejemplo que contienen informacin financiera, de
ventas y marketing de una empresa ficticia llamada Viaje de Aventuras, que se dedica a la venta de
material deportivo.
En los ejemplos de Viaje de Aventuras se ilustran las caractersticas del producto y las prcticas
tcnicas y empresariales recomendadas. Asimismo, puede utilizarlos para probar y compartir tcnicas
de diseo de informes y solucionar problemas.
Antes de poder utilizar los ejemplos, el producto IBM Cognos 8 debe estar instalado y configurado
y debe estar ejecutndose. A continuacin, debe instalar los ejemplos de Cognos 8 y configurar los
ejemplos para que los usuarios puedan acceder a los datos.

Ejemplos de IBM Cognos 8 PowerPlay


En los ejemplos de Viaje de Aventuras se incluyen PowerCubes, modelos e informes que se pueden
utilizar en IBM Cognos 8 PowerPlay para probar las caractersticas siguientes:

Migrar informes y cubos de ejemplo de IBM Cognos Series 7 a IBM Cognos 8 PowerPlay
Para admitir la migracin, se deben copiar algunos ejemplos en los servidores de IBM Cognos
Series 7 PowerPlay.

Ver los informes publicados de IBM Cognos 8 PowerPlay en PowerPlay Studio y en PowerPlay
Client

Acceder a los detalles de un informe de IBM Cognos 8 PowerPlay en otros informes y cubos

Ubicacin de los ejemplos


Los ejemplos estn disponibles en un CD distinto y se describen en las guas de usuario relacionadas
y en la ayuda en lnea. Para utilizar los ejemplos, debe instalarlos y configurarlos o ponerse en
contacto con el administrador para saber dnde estn instalados.

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

157

Captulo 9: Instalacin y configuracin de componentes opcionales

Ejemplos existentes
Los ejemplos de IBM Cognos 8 PowerPlay son los siguientes:

PowerCubes
Hay un cubo para los datos de ejemplo de IBM Cognos Series 7, un cubo de destino para
obtener detalles del cubo de IBM Cognos Series 7 y un cubo de IBM Cognos 8 creado en IBM
Cognos 8 Transformer.
El cubo de IBM Cognos 8 utiliza datos de ejemplo actualizados con fechas de 2004 a 2007.
Los cubos de IBM Cognos Series 7 utilizan los mismos datos de ejemplo que se proporcionaron
con IBM Cognos Series 7.

Modelos
Existe un modelo de IBM Cognos 8 Transformer para los ejemplos de Viaje de Aventuras de
IBM Cognos 8. Se incluyen los orgenes de datos para el modelo. Si desea abrir el modelo, debe
instalar IBM Cognos 8 Transformer.

Informes
Hay tres conjuntos de informes idnticos. Un conjunto se conecta a un cubo remoto de IBM
Cognos Series 7, otro se conecta a un cubo local de IBM Cognos 8 Transformer y otro conjunto
se conecta a un paquete de cubos de IBM Cognos 8 Transformer.

Instalacin de los ejemplos de IBM Cognos 8


En los ejemplos de IBM Cognos 8 se utilizan datos de la empresa Viaje de Aventuras para ilustrar
las caractersticas del producto para diversos estudios. Para utilizar los ejemplos, instlelos desde
el CD de ejemplos de IBM Cognos 8 Business Intelligence. Se incluyen ejemplos para todos los
estudios admitidos.

Pasos para UNIX y Linux


1. Monte el CD mediante las extensiones de archivo Rock Ridge.
Importante: Para montar el CD de IBM Cognos en HP-UX, siga estos pasos:

Aada el directorio pfs_mount a su ruta.


Por ejemplo:
PATH=/usr/sbin/:$PATH
export PATH

Para iniciar los daemons de NFS y ejecutar los daemons en segundo plano, escriba bg
pfs_mountd y, a continuacin, bg pfsd.

Para montar la unidad, escriba


pfs_mount -t rrip <dispositivo><dir_montaje> -o xlat=unix
Por ejemplo:
pfs_mount /dev/dsk/c0t2d0 /cdrom -o xlat=unix

158 PowerPlay

Captulo 9: Instalacin y configuracin de componentes opcionales


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

Cuando haya completado la instalacin, escriba pfs_umount /cdrom y cancele los daemons
pfsd y pfs_mountd para desmontar el CD.

2. Vaya al directorio del CD correspondiente a su sistema operativo.


3. Inicie el asistente para instalacin:

Si utiliza XWindows, escriba


./issetup
Nota: Si utiliza el comando issetup con XWindows, los caracteres japoneses de mensajes
y archivos de registro podran resultar daados. Cuando instale en japons en UNIX o
Linux, deber configurar primero las variables del entorno LANG=C y LC_ALL=C (donde
C es el cdigo del idioma, por ejemplo ja_JP.PCK en Solaris), y despus iniciar el asistente
de instalacin.

Si no utiliza XWindows, realice una instalacin sin participacin del usuario.

4. Siga las indicaciones del asistente para la instalacin y copie los archivos necesarios en el equipo.
Instale los ejemplos en la misma ubicacin que los otros componentes PowerPlay. En una instalacin distribuida, instlelos en el equipo de puerta de enlace.
5. En la pgina Finalizar del asistente para la instalacin, haga clic en Finalizar.

Pasos para Windows


1. Inserte el CD.
2. Inicie el asistente para la instalacin haciendo clic en issetup.exe.
Aparece la pgina de bienvenida del asistente para la instalacin.
3. Seleccione el idioma que desea utilizar en la instalacin.
El idioma que seleccione determina el idioma de la interfaz de usuario. Puede cambiar el idioma
a cualquiera de los idiomas instalados despus de la instalacin.
4. Siga las indicaciones del asistente para la instalacin para copiar los archivos necesarios en el
equipo.
Instale los ejemplos en la misma ubicacin que los otros componentes PowerPlay. En una instalacin distribuida, instlelos en el equipo de puerta de enlace.
5. En la pgina Finalizar del asistente para la instalacin, haga clic en Finalizar.
6. En IBM Cognos Configuration, guarde e inicie IBM Cognos 8.

Configuracin de ejemplos de IBM Cognos 8 PowerPlay


Antes de poder utilizar los ejemplos de PowerPlay, debe poner los datos a disposicin de los usuarios.

Gua de instalacin y configuracin 159

Captulo 9: Instalacin y configuracin de componentes opcionales


Para preparar los datos de IBM Cognos Series 7 para la migracin y los ejemplos de obtencin de
detalles, debe copiar los PowerCubes y los informes de IBM Cognos Series 7 en IBM Cognos Series 7
PowerPlay Enterprise Server.
Utilice la lista de comprobacin siguiente como gua para realizar las tareas de configuracin de
los ejemplos.

Configure el PowerCube.

Configure los informes para utilizarlos en Cognos Viewer y en PowerPlay Studio.

Configure los informes para utilizarlos en PowerPlay Client.

Configure los PowerCubes y los informes para la migracin y los ejemplos de obtencin de
detalles.

Configuracin del PowerCube de ejemplo


Para que los datos del PowerCube estn disponibles, cree una conexin de origen de datos al
PowerCube y, a continuacin, cree un paquete que acceda al PowerCube. Pruebe la configuracin
abriendo el PowerCube.
Utilice la lista de comprobacin siguiente como gua para realizar las tareas.

Conctese al PowerCube de ejemplo y publique un paquete.

Abra el PowerCube de ejemplo en PowerPlay Studio.

Conexin al PowerCube de IBM Cognos 8 de ejemplo y publicacin de un paquete


Para que pueda abrir el PowerCube de ejemplo en PowerPlay Studio o en PowerPlay Client, debe
crear una conexin de origen de datos al PowerCube de ejemplo y, a continuacin, publicar un
paquete.
Antes de crear la conexin de origen de datos, asegrese de que:

El servicio IBM Cognos 8 se est ejecutando.

Dispone de permisos de ejecucin para la caracterstica protegida del directorio y permisos de


visita para la funcin protegida de administracin.

Ha configurado un alias para IBM Cognos 8 en el servidor Web.

Pasos
1. Conctese al portal de IBM Cognos 8 escribiendo el siguiente comando, donde cognos8 es el
directorio virtual que cre al configurar el servidor Web.
http://nombre_equipo/cognos8
2. Inicie IBM Cognos Administration:

En la pgina de bienvenida, haga clic en Administrar contenido de IBM Cognos.

En IBM Cognos Connection, en la barra de herramientas, haga clic en Iniciar, IBM Cognos
Administration.

160 PowerPlay

Captulo 9: Instalacin y configuracin de componentes opcionales


3. En IBM Cognos Administration, haga clic en la pestaa Configuracin.
4. Haga clic en el botn Nuevo origen de datos

5. En el cuadro Nombre, escriba great_outdoors_8 y, a continuacin, haga clic en Siguiente.


El nombre debe estar todo en minsculas e incluir los caracteres de subrayado.
6. En el cuadro Tipo, seleccione IBM Cognos PowerCube y, a continuacin, haga clic en Siguiente.
7. En el cuadro de ubicacin de Windows, escriba la ruta de acceso al PowerCube de great_outdoors_8:
ubicacin_c8\webcontent\samples\datasources\cubes\PowerCubes\idioma\great_outdoors_
8.mdc
8. Haga clic en Finalizar.
9. Seleccione Crear un paquete y haga clic en Aceptar.
10. En el cuadro Nombre del paquete, acepte el nombre predeterminado del paquete y haga clic
en Siguiente.
11. Haga clic en Finalizar.

Prueba del PowerCube en PowerPlay Studio


Para probar la conexin al PowerCube de ejemplo, abra el cubo en IBM Cognos 8 PowerPlay Studio.

Pasos
1. En el explorador Web, escriba la direccin URL para abrir el portal de IBM Cognos 8:
Por ejemplo, escriba
http://nombreservidor/cognos8
2. Abra PowerPlay Studio:

En la pgina Bienvenido, haga clic en Explorar mis datos.

En IBM Cognos Administration, en la barra de herramientas, haga clic en Iniciar, PowerPlay


Studio.

3. Haga clic en great_outdoors_8.


El cubo que est asociado al paquete de great_outdoors_8 se abrir en PowerPlay Studio.
Si el entorno de IBM Cognos incluye Report Studio, Analysis Studio, Metric Studio o IBM Cognos 8
Transformer, puede configurar otros ejemplos de IBM Cognos para practicar con ellos. Para obtener
informacin acerca de la configuracin de otros ejemplos de IBM Cognos 8, consulte el tema de
ejemplos en la Gua de instalacin y configuracin de los otros productos de IBM Cognos 8.

Configuracin de los informes de ejemplo para utilizarlos en Cognos Viewer y PowerPlay Studio
Para que los informes de ejemplo estn disponibles para utilizarlos en Cognos Viewer y PowerPlay
Studio, puede importar el contenido o publicar los informes.
Gua de instalacin y configuracin 161

Captulo 9: Instalacin y configuracin de componentes opcionales


Antes de importar el contenido, asegrese de configurar el PowerCube de ejemplo (p. 160).
Utilice la lista de comprobacin siguiente como gua para realizar las tareas.

Importe el contenido de PowerPlay.

Abra un informe en Cognos Viewer o en PowerPlay Studio.

Importacin del contenido de PowerPlay


Los informes de ejemplo pueden estar disponibles para utilizarlos en Cognos Viewer o PowerPlay
Studio; para ello, debe importarlos mediante un archivo de implementacin. Los datos de ejemplo
de PowerPlay se encuentran empaquetados en un archivo de implementacin para PowerPlay y la
migracin y en un archivo de implementacin para los ejemplos de obtencin de detalles. Importe
los archivos de implementacin en IBM Cognos Administration antes de que los usuarios puedan
acceder a los informes.
Otro mtodo para que los informes estn disponibles en Cognos Viewer o PowerPlay Studio consiste
en publicarlos mediante PowerPlay Client. Para obtener ms informacin, consulte "Configuracin
de los informes de ejemplo para utilizarlos en PowerPlay Client" (p. 164).

Pasos que deben realizarse para los ejemplos de PowerPlay y de migracin


1. Vaya al directorio ubicacin_c8\webcontent\samples\content.
2. Copie Cognos_PowerPlay.zip en el directorio ubicacin_c8\deployment.
3. Abra el portal de IBM Cognos 8 escribiendo el siguiente comando, donde cognos8 es el directorio virtual que cre al configurar el servidor Web.
http://nombre_equipo/cognos8
4. Inicie IBM Cognos Administration:

En la pgina de bienvenida, haga clic en Administrar contenido de IBM Cognos.

En IBM Cognos Connection, en la barra de herramientas, haga clic en Iniciar, IBM Cognos
Administration.

5. Haga clic en la pestaa Configuracin.


6. Haga clic en Administracin de contenido.
7. Haga clic en el botn Nueva importacin

8. Seleccione Cognos_PowerPlay y haga clic en Siguiente.


9. Mantenga el nombre y la ubicacin predeterminados y, a continuacin, haga clic en Siguiente.
10. Seleccione las dos carpetas y haga clic en Siguiente.
11. Mantenga las opciones predeterminadas y haga clic en Siguiente.
12. Revise el resumen y, a continuacin, haga clic en Siguiente.
13. Mantenga la configuracin predeterminada, Guardar y ejecutar una vez, y haga clic en Finalizar.

162 PowerPlay

Captulo 9: Instalacin y configuracin de componentes opcionales


14. Haga clic en Ejecutar.
15. Haga clic en Aceptar.
Aparece Cognos_PowerPlay en Administracin. Se aaden dos carpetas a las carpetas pblicas:
Migrated Content y PowerPlay 8 Report.

Pasos para ver ejemplos de obtencin de detalles


1. Vaya al directorio ubicacin_c8\webcontent\samples\content.
2. Copie Cognos_DrillThroughSamples.zip en el directorio ubicacin_c8\deployment.
3. Abra el portal de IBM Cognos 8 escribiendo el siguiente comando, donde cognos8 es el directorio virtual que cre al configurar el servidor Web.
http://nombre_equipo/cognos8
4. Inicie IBM Cognos Administration:

En la pgina de bienvenida, haga clic en Administrar contenido de IBM Cognos.

En IBM Cognos Connection, en la barra de herramientas, haga clic en Iniciar, IBM Cognos
Administration.

5. Haga clic en Configuracin.


6. Haga clic en Administracin de contenido.
7. Haga clic en el botn Nueva importacin

8. Seleccione Cognos_DrillThroughSamples y haga clic en Siguiente.


9. Mantenga el nombre y la ubicacin predeterminados y, a continuacin, haga clic en Siguiente.
10. En la pgina de contenido de carpetas pblicas, seleccione la carpeta Ejemplos y haga clic en
Siguiente.
11. Haga clic en Siguiente.
12. Revise el resumen y, a continuacin, haga clic en Siguiente.
13. Mantenga la configuracin predeterminada, Guardar y ejecutar una vez, y haga clic en Finalizar.
14. Haga clic en Ejecutar.
15. Haga clic en Aceptar.
Aparece Cognos_DrillThroughSamples en Administracin. Se aaden tres carpetas a las carpetas
pblicas: Almacn de datos VA (anlisis), Almacn de datos VA (consulta) y Ventas y marketing
(compatible). Debe tener instalado Analysis Studio o Query Studio para ver estos ejemplos de
obtencin de detalles.

Gua de instalacin y configuracin 163

Captulo 9: Instalacin y configuracin de componentes opcionales

Prueba de un informe de ejemplo en Cognos Viewer o PowerPlay Studio


Puede probar la importacin abriendo un informe de ejemplo en Cognos Viewer o PowerPlay Studio.
Cognos Viewer es el visor predeterminado cuando se abre un informe en IBM Cognos Connection.

Pasos para Cognos Viewer


1. Abra el portal de IBM Cognos 8 escribiendo el siguiente comando, donde cognos8 es el directorio virtual que cre al configurar el servidor Web.
http://nombre_equipo/cognos8
2. Inicie IBM Cognos Connection:

En la pgina de bienvenida, haga clic en Contenido de IBM Cognos.

En IBM Cognos Administration, en la barra de herramientas, haga clic en Iniciar, IBM


Cognos Connection.

3. En la lista Carpetas pblicas, seleccione Informes de ejemplo de PowerPlay 8.


4. Haga clic en great_outdoors_8.
5. Haga clic en cualquier informe de la lista.
El informe se abrir en Cognos Viewer.

Pasos para PowerPlay Studio


1. Abra el portal de IBM Cognos 8 escribiendo el siguiente comando, donde cognos8 es el directorio virtual que cre al configurar el servidor Web.
http://nombre_equipo/cognos8
2. Inicie PowerPlay Studio:

En la pgina Bienvenido, haga clic en Explorar mis datos.

En IBM Cognos Administration, en la barra de herramientas, haga clic en Iniciar, PowerPlay


Studio.

3. En la lista Carpetas pblicas, seleccione Informes de ejemplo de PowerPlay 8.


4. Haga clic en Ms junto a la entrada great_outdoors_8.
5. Haga clic en Ver contenido de paquete.
6. Haga clic en el botn Abrir con PowerPlay Studio de uno de los informes de la lista.
El informe se abrir en PowerPlay Studio.

Configuracin de los informes de ejemplo para utilizarlos en PowerPlay Client


Para que los informes de ejemplo estn disponibles en PowerPlay Client, debe copiar los informes
en el equipo PowerPlay Client o en una ubicacin accesible de la red.
Utilice la lista de comprobacin siguiente como gua para realizar las tareas.

164 PowerPlay

Copie los informes de ejemplo en los equipos PowerPlay Client.

Captulo 9: Instalacin y configuracin de componentes opcionales

Abra un informe en PowerPlay Client.

Copia de los informes de ejemplo en los equipos PowerPlay Client


Despus de instalar los ejemplos de IBM Cognos 8, los informes de ejemplo estn listos para utilizarse
en PowerPlay Client. Si PowerPlay Client est instalado en equipos distintos, debe copiar los
informes de ejemplo en los equipos PowerPlay Client.
Los usuarios de PowerPlay Client pueden abrir los informes de ejemplo que estn conectados a los
cubos locales y probar las caractersticas de IBM Cognos 8 PowerPlay. Los usuarios tambin pueden
publicar los informes de los paquetes de cubos en PowerPlay Client para utilizarlos en Cognos
Viewer o PowerPlay Studio. Para obtener ms informacin, consulte IBM Cognos 8 - Gua del
usuario de PowerPlay Client.

Pasos
1. Copie el contenido de los directorios siguientes en una ubicacin del equipo PowerPlay Client:

ubicacin_c8\webcontent\samples\powerplay_reports\powerplay_8\reports_for_local_cubes\
idioma

ubicacin_c8\webcontent\samples\powerplay_reports\powerplay_8\reports_for_cube_
packages\idioma

2. Repita el procedimiento en todos los equipos PowerPlay Client.

Prueba de un informe en PowerPlay Client


Puede probar un informe de ejemplo abrindolo en PowerPlay Client.

Pasos
1. En el men Inicio, haga clic en Programas, IBM Cognos 8, IBM PowerPlay 8.
2. En la pgina de bienvenida, haga clic en Abrir un informe existente.
3. En el cuadro de dilogo Elija un informe, haga clic en la flecha del cuadro Buscar en, busque
el directorio, haga clic en el informe y, a continuacin, haga clic en Abrir.
El informe se abre y el nombre del informe aparece en la barra de ttulo de la ventana de
PowerPlay.

Configuracin de los PowerCubes e informes de ejemplo para la migracin


Antes de que pueda realizar una migracin de ejemplos de IBM Cognos Series 7 a IBM Cognos 8
PowerPlay, debe copiar el PowerCube y los informes de ejemplo de IBM Cognos Series 7 en el
equipo PowerPlay Enterprise Server.
Despus de configurar los PowerCubes y los informes de ejemplo, puede migrar los informes. Despus
de la migracin, los usuarios pueden ver los informes en Cognos Viewer o en PowerPlay Studio.
De forma predeterminada, los informes migrados estn en formato PDF.

Gua de instalacin y configuracin 165

Captulo 9: Instalacin y configuracin de componentes opcionales


Para obtener informacin acerca de cmo ejecutar una migracin, consulte la Gua de migracin
y administracin.

Pasos
1. Vaya al directorio ubicacin_c8\webcontent\samples\powerplay_reports\powerplay_7\reports_
for_remote_cubes\idioma y copie todo el contenido en una ubicacin del equipo IBM Cognos
Series 7 en el que est instalado PowerPlay Enterprise Server.
2. Vaya al directorio ubicacin_c8\webcontent\samples\datasources\cubes\PowerCubes\idioma y
copie great_outdoors_7.mdc en una ubicacin del equipo de PowerPlay Enterprise Server.
3. Aada el cubo y los informes a PowerPlay Enterprise Server.
Para obtener ms informacin, consulte IBM Cognos Series 7 PowerPlay Enterprise Server
Guide.
4. Para actualizar la asignacin de cubos, en IBM Cognos Series 7 PowerPlay Client, abra cada
informe mediante una conexin remota con great_outdoors_7.mdc y, a continuacin, guarde
el informe.
El cubo y los informes estn ahora listos para utilizarse en IBM Cognos Series 7.

Instalar documentacin de producto traducida


Para acceder a la documentacin de usuario traducida, debe instalarla desde Supplementary Languages Documentation de IBM Cognos 8.
La documentacin del producto en ingls est instalada cuando instala el componente de puerta de
enlace de IBM Cognos 8. La Gua de instalacin y configuracin, la Gua de introduccin a la instalacin y el Lame son las excepciones y estn disponibles en todos los idiomas compatibles.
Antes de instalar Supplementary Languages Documentation, asegrese de lo siguiente:

IBM Cognos 8 est instalado y configurado correctamente.

Hay disponible suficiente espacio en disco para instalar los idiomas suplementarios.
Necesita al menos 220 MB de espacio en disco.

Su entorno de software es compatible.

Pasos
1. En la ubicacin en la que se vaya a instalar el componente de puerta de enlace, inserte el CD
de IBM Supplementary Languages Documentation o vaya al directorio en el que se hayan descargado o extrado los archivos de instalacin.
En UNIX o Linux, monte el CD utilizando extensiones de archivo Rock Ridge.
En Windows, el asistente de instalacin se inicia automticamente desde el disco del producto.
2. Para iniciar manualmente el asistente de instalacin, vaya al directorio del sistema operativo y
escriba lo siguiente:

166 PowerPlay

En Windows, si no aparece la pgina de bienvenida, haga doble clic en el archivo issetup.exe.

Captulo 9: Instalacin y configuracin de componentes opcionales

En UNIX o Linux, escriba


./issetup
Nota: Si utiliza el comando issetup con XWindows, los caracteres japoneses se podran
daar.

3. Siga las instrucciones del asistente de instalacin para copiar los archivos necesarios en la misma
ubicacin donde ha instalado los componentes de la puerta de enlace para IBM Cognos 8.
Haga la instalacin en un directorio que contenga slo caracteres ASCII en el nombre de ruta.
Algunos servidores Web no admiten caracteres que no son ASCII en los nombres de directorio.
Los componentes de la documentacin de idiomas suplementarios quedan seleccionados de
formar predeterminada.
4. En la pgina Finalizar del asistente para instalacin, elija la opcin que desee.

Instalacin y configuracin de fuentes de idiomas adicionales


Para aadir compatibilidad con los caracteres del yen japons o del won coreano, debe instalar
fuentes adicionales desde IBM Cognos 8 Supplementary Languages Documentation.
El punto de cdigo de Unicode U+005C est asignado oficialmente a la barra diagonal invertida.
Sin embargo, en Japn y en Corea, ese punto de cdigo se ha asignado histricamente a sus smbolos
de moneda y muchas personas prefieren ver un signo de yen o de won en ciertas partes de software,
por ejemplo en las rutas de los archivos. Para permitir esto, puede instalar las fuentes Andale WT
J y Andale WT K.
Antes de instalar fuentes adicionales, asegrese de lo siguiente:

IBM Cognos 8 est instalado y configurado correctamente.

Hay disponible suficiente espacio en disco para instalar las fuentes adicionales.
Necesita al menos 220 MB de espacio en disco.

Su entorno de software es compatible.

Pasos
1. En la ubicacin donde estn instalados los componentes de nivel de aplicacin, inserte el CD
de IBM Cognos 8 Supplementary Languages Documentation.
En UNIX o Linux, monte el CD utilizando extensiones de archivo Rock Ridge.
2. Vaya al directorio del CD correspondiente a su sistema operativo.
3. Inicie el asistente de instalacin escribiendo el siguiente comando:

En Windows,
issetup

En UNIX o Linux,
./issetup
Gua de instalacin y configuracin 167

Captulo 9: Instalacin y configuracin de componentes opcionales


Nota: Si utiliza el comando issetup con XWindows, los caracteres japoneses se podran
daar.
4. Siga las instrucciones del asistente de instalacin para copiar los archivos necesarios en la misma
ubicacin donde ha instalado los componentes de nivel de aplicacin.
Haga la instalacin en un directorio que contenga slo caracteres ASCII en el nombre de ruta.
Algunos servidores Web no admiten caracteres que no son ASCII en los nombres de directorio.
Cuando se le solicite seleccionar los componentes, deseleccione IBM Cognos 8 Business Intelligence Supplementary Languages Documentation, expanda Fuentes de idioma adicionales y, a
continuacin, seleccione la fuente.
Estas fuentes se copian en el directorio ubicacin_c8/bin/fonts. Esta ubicacin de fuente se
define en el valor de la propiedad Ubicaciones fsicas de fuentes de IBM Cognos Configuration
en Entorno. Si mueve las fuentes a otra ubicacin, asegrese de que la nueva ubicacin se aade
al valor de la propiedad Ubicaciones fsicas de fuentes.
Las fuentes utilizadas para visualizar datos en un informe se seleccionan mediante un proceso
de correspondencia entre las fuentes solicitadas al disear el informe y las fuentes que estn
disponibles al reproducirlo. Para salida PDF y grficos, este proceso tiene lugar en el servidor,
en el cual es posible utilizar todas las fuentes del servidor que genera el informe.
5. En la pgina Finalizar del asistente para instalacin, elija la opcin que desee.
Despus de instalar las fuentes adicionales, debe configurar la compatibilidad con ellas. Para obtener
ms informacin, consulte "Configuracin de la compatibilidad para los caracteres de yen japons
y won coreano" (p. 168).

Configuracin de la compatibilidad para los caracteres de yen japons y won


coreano
Para que los caracteres de la moneda japonesa y coreana se muestren correctamente, debe definir
las fuentes adicionales en la hoja de estilo global.
Antes de configurar estas fuentes, debe instalarlas desde el CD de IBM Cognos 8 Supplementary
Languages Documentation.

Pasos para configurar las fuentes para los caracteres de yen y won
1. Abra la hoja de estilo GlobalReportStyles.css en un editor de texto.
La hoja de estilo GlobalReportStyles.css se encuentra en el directorio ubicacin_c8\bin.
2. Habilite una de las secciones siguientes y modifquela tal como se muestra ms abajo:

/* For Japanese: */
.pg,
.pp
{
font-family: 'MS UI Gothic', 'Andale WT J' , Tahoma, arial, geneva,
helvetica, sans-serif;

168 PowerPlay

Captulo 9: Instalacin y configuracin de componentes opcionales


}

/* For Korean: */
.pg,
.pp
{
font-family: Gulim, 'Andale WT K' , Tahoma, arial, geneva, helvetica,
sans-serif;
}

El generador de PDF utiliza la primera fuente disponible en el servidor e incluye todos los
caracteres de la cadena que va a mostrarse. Si prefiere utilizar otras fuentes en el servidor, puede
insertarlas en la lista.
3. Guarde el archivo GlobalReportStyles.css.
4. Reinicie el servidor IBM Cognos 8.
Cualquier cambio que realice en la hoja de estilo se sobrescribe si actualiza IBM Cognos 8. Debe
repetir este procedimiento despus de una actualizacin.

Gua de instalacin y configuracin 169

Captulo 9: Instalacin y configuracin de componentes opcionales

170 PowerPlay

Captulo 10: Configuracin de los componentes de


IBM Cognos 8 para utilizar un proveedor de autenticacin
Los componentes de IBM Cognos 8 se ejecutan con dos niveles de inicio de sesin: annimo y
autenticado. De manera predeterminada, el acceso annimo est habilitado.
Puede utilizar ambos tipos de inicio de sesin con su instalacin. Si decide usar slo el inicio de
sesin autenticado, puede deshabilitar el acceso annimo.
Para el inicio de sesin autenticado, debe configurar los componentes de IBM Cognos 8 con un
espacio de nombre adecuado para el tipo de proveedor de autenticacin del entorno. Puede configurar varios espacios de nombre para la autenticacin y, a continuacin, seleccionar en tiempo de
ejecucin el espacio de nombre que desee utilizar. Para obtener ms informacin, consulte la Gua
de administracin y seguridad.
Si ha actualizado desde ReportNet e IBM Cognos 8 detecta un espacio de nombre configurado
previamente que ya no est configurado, el espacio de nombre no configurado aparece en la lista
de proveedores de autenticacin en el portal de administracin. Puede configurar el espacio de
nombre si todava necesita la informacin de cuenta de usuario. De lo contrario, puede eliminar el
espacio de nombre. Para obtener informacin acerca de la eliminacin del espacio de nombre,
consulte la Gua de administracin y seguridad.
Asimismo, al actualizar de una versin a otra, debe utilizar el mismo espacio de nombre de autenticacin para ambas versiones. De lo contrario, es posible que la nueva versin no contenga las
mismas directivas, usuarios, roles y grupos.
Los componentes de IBM Cognos 8 admiten los tipos siguientes de servidores como orgenes de
autenticacin:

Servidor de Active Directory

IBM Cognos Series 7

Custom Authentication Provider

LDAP

eTrust SiteMinder

NTLM

SAP

Si utiliza ms de un equipo de Content Manager, debe configurar proveedores de autenticacin en


cada uno de los equipos de Content Manager. Esto implica que tanto el tipo de proveedor de
autenticacin que seleccione como la manera de configurarlo deben ser idnticos en todos los
equipos de todas las plataformas. La configuracin debe contener informacin a la que puedan
acceder todos los equipos de Content Manager.
Licensed Materials Property of IBM
Copyright IBM Corp. 2005, 2009.

171

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
Si IBM Cognos 8 est instalado en un nico equipo Linux, o si Content Manager est instalado en
un equipo Linux, IBM Cognos 8 se puede configurar para utilizar slo proveedores personalizados
y servidores de directorio compatibles con LDAP V3 como orgenes de autenticacin.
Algunos proveedores de autenticacin necesitan que haya bibliotecas externas al entorno de IBM
Cognos 8 disponibles. Si dichas bibliotecas no estn disponibles en Linux, el proveedor de autenticacin no se puede inicializar.
Si desea configurar uno de los siguientes como orgenes de autenticacin, debe instalar Content
Manager en un equipo que no sea de Linux:

Espacio de nombre de IBM Cognos Series 7

Servidor de Active Directory

NTLM

eTrust SiteMinder

SAP BW

Si habilita la seguridad, debe configurar los valores de seguridad en cuanto complete el proceso de
instalacin y configuracin. Para obtener ms informacin, consulte la Gua de administracin y
seguridad.
Importante: Le recomendamos no deshabilitar la seguridad despus de haberla habilitado. Si elimina
un espacio de nombre, las entradas Mis pginas, Mis carpetas y Preferencias de usuario se perdern
de forma permanente. La configuracin de los permisos existentes se referir a usuarios, grupos o
roles que ya no existen. Aunque esto no afecta al comportamiento de los permisos, el usuario que
administre la configuracin de los permisos puede ver entradas "desconocidas". Dado que estas
entradas se refieren a usuarios, grupos y roles que ya no existen, puede eliminarlos de forma segura.
Cuando haya configurado un proveedor de autenticacin para los componentes de IBM Cognos 8,
podr habilitar el inicio de sesin nico entre el entorno de proveedor de autenticacin y los componentes de IBM Cognos 8. Esto significa que el usuario inicia la sesin una vez y, ms tarde, puede
cambiar a otra aplicacin sin que se le solicite que vuelva a iniciar la sesin.
Los usuarios pueden seleccionar espacios de nombres cuando inician sesin en el portal de IBM
Cognos 8. Puede ocultar a los usuarios los espacios de nombre personalizados de Java (p. 186) y los
espacios de nombre de eTrust SiteMinder(p. 206).
Para utilizar un proveedor de autenticacin y para requerir a los usuarios autenticarse:

Deshabilite el acceso annimo, si es necesario.

Configure los componentes de IBM Cognos 8 para que utilicen un proveedor de autenticacin.

Deshabilitacin del acceso annimo


De forma predeterminada, los componentes de IBM Cognos 8 no necesitan autenticacin de usuario.
Los usuarios pueden iniciar la sesin de manera annima.

172 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
Si slo desea utilizar el inicio de sesin autenticado, puede utilizar IBM Cognos Configuration para
deshabilitar el acceso annimo.

Pasos
1. Inicie Cognos Configuration en cada una de las ubicaciones en las que Content Manager est
instalado.
2. En la ventana Explorador, en Seguridad, Autenticacin, haga clic en Cognos.
El recurso IBM Cognos representa el espacio de nombre de Cognos. El espacio de nombre de
Cognos almacena informacin sobre los grupos de IBM Cognos, como Usuario annimo,
contactos y listas de distribucin, y se refiere a objetos de otros espacios de nombre de seguridad.
Para obtener ms informacin, consulte la Gua de administracin y seguridad.
3. En la ventana Propiedades, haga clic en el cuadro situado junto a la propiedad Permitir acceso
annimo y, a continuacin, haga clic en Falso.
4. En el men Archivo, haga clic en Guardar.
A partir de ahora, se solicitar a los usuarios que proporcionen sus credenciales de usuario para
acceder a los recursos de IBM Cognos.

Restriccin del acceso de usuarios al espacio de nombre de


Cognos
Se puede restringir el acceso a los usuarios que pertenecen a cualquier grupo o rol definido en el
espacio de nombre incorporado de IBM Cognos. De forma predeterminada, todos los usuarios
pertenecen a varios grupos o roles incorporados. Para restringir el acceso, debe:

Habilitar la propiedad para restringir el acceso

Eliminar el grupo Todos de los grupos y roles incorporados de IBM Cognos

Garantizar que los usuarios autorizados pertenezcan a, al menos, un grupo o rol de IBM Cognos

Pasos
1. Inicie IBM Cognos Configuration en todos los equipos Content Manager.
2. En la ventana Explorador, en Seguridad, haga clic en Autenticacin.
3. En la ventana Propiedades, cambie el valor de Restringir el acceso a los miembros del espacio
de nombre incorporado a Verdadero.
4. En el men Archivo, haga clic en Guardar.
Ahora debe utilizar el portal para eliminar el grupo Todos de los roles y grupos incorporados de
IBM Cognos y debe asegurarse de que los usuarios autorizados pertenecen como mnimo a un rol
o grupo incorporado de IBM Cognos.
Para obtener informacin sobre cmo aadir o eliminar miembros de un rol o grupo de IBM Cognos,
consulte la Gua de administracin y seguridad.

Gua de instalacin y configuracin 173

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Configuracin de los componentes de IBM Cognos 8 para utilizar


el servidor de Active Directory
Si instala Content Manager en un equipo de Windows, puede configurar Active Directory como
origen de autenticacin utilizando un espacio de nombre de Active Directory.
Si instala Content Manager en un equipo de UNIX, deber utilizar un espacio de nombre de LDAP
para configurar Active Directory como origen de autenticacin. Si instala Content Manager en
equipos de Windows y UNIX, debe utilizar un espacio de nombre de LDAP para configurar Active
Directory en todos los equipos de Content Manager. Si utiliza un espacio de nombre de LDAP para
realizar la autenticacin en el servidor de Active Directory, slo podr utilizar las funciones LDAP.
No tendr acceso a las funciones de Active Directory, como las propiedades avanzadas para los
dominios (p. 177) y el inicio de sesin nico utilizando la delegacin de Kerberos (p. 179).
Si instala Content Manager en un equipo de Linux, se aplicarn las mismas restricciones que en el
caso de UNIX. Debe utilizar un espacio de nombre de LDAP para configurar Active Directory como
origen de autenticacin.
Para obtener ms informacin, consulte "Configuracin de un espacio de nombre de LDAP para
el servidor de Active Directory" (p. 189).
Si desea utilizar Microsoft SQL Server o Microsoft Analysis Server como origen de datos y utilizar
el inicio de sesin nico para la autenticacin, debe utilizar Active Directory como origen de
autenticacin.
No puede conectarse al catlogo global de Active Directory, que se trata de un servidor de memoria
cach del servidor de Active Directory. Si la conexin utiliza el puerto 3268, debe cambiarlo. De
forma predeterminada, el servidor de Active Directory utiliza el puerto 389.
Para utilizar un espacio de nombre del servidor de Active Directory y configurar el inicio de sesin
nico, siga estos pasos:

Configure los componentes de IBM Cognos 8 para utilizar un espacio de nombre del servidor
de Active Directory.

Habilite la comunicacin segura con el servidor de Active Directory, si es necesario.

Habilite el inicio de sesin nico entre el servidor de Active Directory y los componentes de
IBM Cognos 8.

Configuracin de un espacio de nombre de Active Directory


Puede utilizar el servidor de Active Directory como proveedor de autenticacin.
Tambin tiene la opcin de poner las propiedades de usuario personalizadas del servidor de Active
Directory a disposicin de los componentes de IBM Cognos 8.
Para que IBM Cognos 8 funcione correctamente con el servidor de Active Directory, asegrese de
que el grupo de usuarios autenticados tiene privilegios de lectura para la carpeta de Active Directory
en la que se almacenan los usuarios.

174 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
Si est configurando un espacio de nombre de Active Directory para admitir un inicio de sesin
nico con un origen de datos de Microsoft SQL Server o Microsoft Analysis Server, asegrese de
la configuracin siguiente:

La puerta de enlace de IBM Cognos 8 est instalada en un servidor Web IIS que est configurado
para la autenticacin integrada en Windows.

La puerta de enlace est asignada al sitio Web de la intranet local en el explorador Web.

Content Manager est instalado en un servidor Windows 2000 o Windows 2003.

Content Manager, los componentes de nivel de aplicacin, el servidor Web IIS y el servidor de
origen de datos (Microsoft SQL Server o Microsoft Analysis Server) pertenecen al dominio de
Active Directory.

La conexin del origen de datos para Microsoft SQL Server o Microsoft Analysis Server est
configurada para el Espacio de nombre externo, que debe ser el espacio de nombre de Active
Directory.

Para obtener ms informacin acerca de los orgenes de datos, consulte la Gua de administracin
y seguridad.

Pasos
1. En cada uno de los equipos en los que haya instalado Content Manager, abra IBM Cognos
Configuration.
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
4. En la lista Tipo, haga clic en el espacio de nombre adecuado y, a continuacin, haga clic en
Aceptar.
El nuevo recurso proveedor de autenticacin aparece en la ventana Explorador, bajo el componente Autenticacin.
5. En la ventana Propiedades, especifique un identificador exclusivo para el espacio de nombre
en la propiedad ID de espacio de nombre.
6. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que los
componentes de IBM Cognos 8 puedan localizar y utilizar el proveedor de autenticacin existente.
7. Especifique los valores de la propiedad Host y puerto.
Para admitir la migracin tras error del servidor de Active Directory, puede especificar el
nombre del dominio en lugar de un controlador de dominios especfico. Por ejemplo, utilice
midominio.com:389 en lugar de dc1.midominio.com:389.
8. Si desea buscar detalles cuando falla la autenticacin, especifique el identificador de usuario y
la contrasea para la propiedad Credenciales de enlace.

Gua de instalacin y configuracin 175

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
Utilice las credenciales del usuario del servidor de Active Directory con privilegios de bsqueda
y lectura en dicho servidor.
9. En el men Archivo, haga clic en Guardar.
10. Pruebe la conexin con un nuevo espacio de nombre. En la ventana Explorador, en Autenticacin, haga clic con el botn derecho en el nuevo recurso de autenticacin y haga clic en Probar.
IBM Cognos 8 carga, inicializa y configura las bibliotecas de proveedor del espacio de nombre.

Cmo poner las propiedades de usuario personalizadas del servidor de Active


Directory a disposicin de los componentes de IBM Cognos 8
Puede utilizar atributos de usuario arbitrarios del servidor de Active Directory en los componentes
de IBM Cognos 8. Para realizar esta configuracin, debe aadir estos atributos como propiedades
personalizadas para el espacio de nombre de Active Directory.
Las propiedades personalizadas estn disponibles como parmetros de sesin a travs de Framework
Manager. Para obtener ms informacin sobre los parmetros de la sesin, consulte Framework
Manager User Guide.
Asimismo, puede utilizar las propiedades personalizadas dentro de los bloques de comandos para
configurar sesiones y conexiones de Oracle. Puede utilizar los bloques de comandos con conexiones
ligeras de Oracle y con bases de datos privadas virtuales. Para obtener ms informacin, consulte
la Gua de administracin y seguridad.

Pasos
1. En cada uno de los equipos en los que haya instalado Content Manager, abra IBM Cognos
Configuration.
2. En la ventana Explorador, en Seguridad, Autenticacin, haga clic en el espacio de nombre de
Active Directory.
3. En la ventana Propiedades, haga clic en la columna Valor de Propiedades personalizadas y en
el botn Editar.
4. En la ventana Valor: Propiedades personalizadas, haga clic en Aadir.
5. Haga clic en la columna Nombre y escriba el nombre que desea que utilicen los componentes
de IBM Cognos 8 para el parmetro de sesin.
6. Haga clic en la columna Valor y escriba el nombre del parmetro de cuenta en el servidor de
Active Directory.
7. Repita los pasos del 4 al 6 para cada parmetros personalizado.
8. Haga clic en Aceptar.
9. En el men Archivo, haga clic en Guardar.

176 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Habilitacin de la comunicacin segura con el servidor de Active Directory


Si est utilizando una conexin SSL con el servidor de Active Directory, debe copiar el certificado
del servidor de Active Directory en el equipo de Content Manager.

Pasos
1. En cada equipo de Content Manager, utilice el explorador Web para conectarse al servidor de
Active Directory y copie el certificado raz de la entidad emisora de certificados de confianza
en una ubicacin del equipo de Content Manager.
2. Aada el certificado raz de la entidad emisora de certificados de confianza al almacn de certificados que est utilizando para la sesin actual de IBM Cognos:

Si est ejecutando una sesin de IBM Cognos en una cuenta de usuario, utilice el mismo
explorador Web que en el paso 1 para importar el certificado raz de la entidad emisora
de certificados de confianza al almacn de certificados de su cuenta de usuario.
Para obtener informacin, consulte la documentacin del explorador Web.

Si est ejecutando la sesin de IBM Cognos en la cuenta del equipo local, utilice Microsoft
Management Console (MMC) para importar el certificado raz de la entidad emisora de
certificados de confianza en el almacn de certificados del equipo local.
Para obtener informacin, consulte la documentacin de MMC.

3. En IBM Cognos Configuration, reinicie el servicio:

En la ventana del Explorador, haga clic en Servicio IBM Cognos 8, IBM Cognos 8.

En el men Acciones, haga clic en Reiniciar.

Inclusin o exclusin de dominios mediante las propiedades avanzadas


Al configurar un espacio de nombre de autenticacin para IBM Cognos 8, slo los usuarios de un
dominio pueden iniciar la sesin. Si se utilizan las propiedades avanzadas del servidor de Active
Directory, los usuarios de rboles de dominios relacionados (principal-secundario) y de dominios
no relacionados del mismo bosque pueden tambin acceder.

Autenticacin en un rbol de dominios


Si establece un parmetro denominado chaseReferrals en true, los usuarios del dominio autenticado
original y todos los dominios secundarios del rbol de dominio podrn iniciar la sesin en IBM
Cognos 8. Los usuarios que se encuentran sobre el dominio autenticado o en un rbol de dominios
distinto no pueden acceder.

Gua de instalacin y configuracin 177

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Autenticacin en todos los rboles de dominio del bosque


Si establece un parmetro denominado MultiDomainTrees en true, los usuarios de todos los rboles
de dominio del bosque podrn acceder a IBM Cognos 8.

Pasos
1. En cada uno de los equipos en los que haya instalado Content Manager, abra IBM Cognos
Configuration.
2. En la ventana Explorador, en Seguridad, Autenticacin, haga clic en el espacio de nombre de
Active Directory.
3. En la ventana Propiedades, especifique la propiedad Host y puerto:

En el caso de los usuarios de un dominio, especifique el host y el puerto de un controlador


de dominio para el nico dominio.

En el caso de los usuarios de un rbol de dominio, especifique el host y puerto del controlador de nivel superior del rbol de dominios.

En el caso de los usuarios de todos los rboles de domino del bosque, especifique el host
y el puerto de alguno de los controladores de dominio del bosque.

4. Haga clic en la columna Valor de Propiedades avanzadas y en el botn Editar.


5. En la ventana Valor: Propiedades avanzadas, haga clic en Aadir.
6. Especifique dos nuevas propiedades, chaseReferrals y MultiDomainTrees, con los siguientes
valores:

Autenticacin para

chaseReferrals MultiDomainTrees

Un dominio

False

False

Un rbol de dominios

True

False

Todos los rboles de dominios del bosque

True

True

7. Haga clic en Aceptar.


8. En el men Archivo, haga clic en Guardar.

Habilitacin del inicio de sesin nico entre el servidor de Active Directory y los
componentes de IBM Cognos 8
De forma predeterminada, el proveedor de Active Directory utiliza la delegacin de Kerberos y se
integra con el servidor IIS Web para el inicio de sesin nico si la autenticacin integrada en Windows
(antes denominada NT Challenge Response) est habilitada en el servidor IIS Web.

178 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
Si la autenticacin integrada en Windows est habilitada, no se le solicitar que vuelva a especificar
la informacin de autenticacin cuando acceda al contenido de IBM Cognos protegido por el
espacio de nombre de Active Directory.
Si no desea la delegacin Kerberos, puede configurar el proveedor para acceder a la variable de
entorno REMOTE_USER para lograr un inicio de sesin nico. Debe establecer la propiedad
avanzada singleSignOnOption en el valor IdentityMapping. Tambin debe especificar credenciales
de enlace para el espacio de nombre de Active Directory. Microsoft establece de forma predeterminada REMOTE_USER cuando se habilita la autenticacin integrada en Windows. Si se omite la
autenticacin de Kerberos, no ser posible realizar el inicio de sesin en los orgenes de datos de
Microsoft OLAP (MSAS).

Pasos para el inicio de sesin nico mediante la delegacin de Kerberos


1. Configure la autenticacin integrada en Windows en el servidor IIS Web.
2. Instale Content Manager en un equipo que forme parte del dominio, para los equipos de Content
Manager activos y en espera.
3. Configure los equipos, o la cuenta de usuario donde se ejecuta Content Manager, que sern
considerados de confianza para la delegacin.
Cuando configure los equipos utilizando la herramienta de usuario de Active Directory, no
seleccione el atributo Cuenta, que es importante y no se puede delegar.

Pasos para el inicio de sesin nico mediante REMOTE_USER


1. En cada uno de los equipos en los que haya instalado Content Manager, abra IBM Cognos
Configuration.
2. En la ventana Explorador, en Seguridad, Autenticacin, haga clic en el espacio de nombre de
Active Directory.
3. Haga clic en la columna Valor de Propiedades avanzadas y, a continuacin, en el botn Editar.
4. En el cuadro de dilogo Valor: Propiedades avanzadas, haga clic en Aadir.
5. En la columna Nombre, escriba singleSignOnOption
6. En la columna Valor, escriba IdentityMapping.
7. Haga clic en Aceptar.
8. Haga clic en la columna Valor de Credenciales de enlace y, a continuacin, en el botn Editar.
9. En el cuadro de dilogo Valor: Credenciales de enlace, especifique un identificador de usuario
y una contrasea y, a continuacin, haga clic en Aceptar.
El proveedor de Active Directory utiliza ahora REMOTE_USER para el inicio de sesin nico.
Sugerencia: Para volver a cambiar a la delegacin de Kerberos, edite Propiedades avanzadas y, en
la columna Valor, escriba KerberosAuthentication.

Gua de instalacin y configuracin 179

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Configuracin de IBM Cognos 8 para utilizar un espacio de


nombre de IBM Cognos Series 7
Puede configurar los componentes de IBM Cognos 8 para utilizar un espacio de nombre de IBM
Cognos Series 7 como proveedor de autenticacin. Los usuarios se autenticarn en funcin de la
configuracin de autenticacin y de inicio de sesin del espacio de nombre de IBM Cognos Series 7.
Se requiere un espacio de nombre de IBM Cognos Series 7 si desea utilizar modelos de Transformer
y PowerCubes de IBM Cognos Series 7 en IBM Cognos 8. Debe configurar el espacio de nombre
antes de cargar los modelos de Transformer.
Si tiene pensado ejecutar productos de IBM Cognos 8 con un servidor de aplicaciones de 64 bits,
no puede configurar un espacio de nombre de IBM Cognos Series 7 como su fuente de autenticacin.
Si desea configurar un espacio de nombre de IBM Cognos Series 7 como origen de autenticacin,
debe instalar Content Manager en un equipo compatible con IBM Cognos Series 7.
Nota: No puede utilizar un archivo LAE (Local Authentication Export) de IBM Cognos Series 7
para realizar la autenticacin con los componentes de IBM Cognos 8.
Puede configurar los componentes de IBM Cognos 8 para utilizar varios proveedores de autenticacin
de IBM Cognos Series 7. Se recomienda que todos los espacios de nombre de IBM Cognos Series 7
utilicen el mismo servidor de vales primario de IBM Cognos Series 7. De lo contrario, recibir
errores o se le solicitar que se autentique ms de una vez. Para mantener el rendimiento, asegrese
tambin de que se est ejecutando el servidor de vales.
Si cambia la informacin de configuracin almacenada en el servidor de directorios utilizado para
IBM Cognos Series 7, debe reiniciar el servicio de IBM Cognos 8 antes de que se realicen los cambios
en la instalacin de IBM Cognos.
Un usuario debe estar como mnimo en una clase de usuario de Access Manager para iniciar sesin
en los componentes de IBM Cognos 8.
Para utilizar un espacio de nombre de IBM Cognos Series 7 y configurar el inicio de sesin nico,
siga estos pasos:

Configure IBM Cognos 8 para utilizar un espacio de nombre de IBM Cognos Series 7.

Habilite la comunicacin segura con el servidor de directorio utilizado por el espacio de nombre
de IBM Cognos Series 7, si es necesario.

Habilite el inicio de sesin nico entre IBM Cognos Series 7 e IBM Cognos 8.

Configuracin de un espacio de nombre de IBM Cognos Series 7


Puede configurar IBM Cognos 8 para que utilice uno o varios espacios de nombre de IBM Cognos
Series 7 para la autenticacin.

Pasos
1. En cada uno de los equipos en los que haya instalado Content Manager, abra IBM Cognos
Configuration.

180 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
4. En la lista Tipo, haga clic en el espacio de nombre adecuado y, a continuacin, haga clic en
Aceptar.
El nuevo recurso proveedor de autenticacin aparece en la ventana Explorador, bajo el componente Autenticacin.
5. En la ventana Propiedades, especifique un identificador exclusivo para el espacio de nombre
en la propiedad ID de espacio de nombre.
6. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que los
componentes de IBM Cognos 8 puedan localizar y utilizar el proveedor de autenticacin existente.
Si la versin de espacio de nombre de IBM Cognos Series 7 es 16.0, asegrese de que la propiedad
Codificacin de datos est configurada como UTF-8. Adems, los equipos donde est instalado
Content Manager deben utilizar la misma configuracin regional que los datos que estn en el
espacio de nombre de IBM Cognos Series 7.
El valor de host puede ser el nombre de un equipo o una direccin IP. Si va a publicar desde
PowerPlay Enterprise Server en IBM Cognos 8, debe usar el mismo formato de valor utilizado
en Configuration Manager de IBM Cognos Series 7 para la ubicacin del servidor de directorios.
Por ejemplo, si se utiliza el nombre del equipo en Configuration Manager de IBM Cognos
Series 7, deber utilizar tambin el nombre del equipo en IBM Cognos Configuration para IBM
Cognos 8.
7. Si el entorno de espacio de nombre incluye la versin 15.2 del espacio de nombre de IBM
Cognos Series 7, debe deshabilitar la configuracin de Series7NamespacesAreUnicode.

En la ventana Propiedades, en el valor Propiedades avanzadas, haga clic en el botn Editar.

En la ventana Valor: Propiedades avanzadas, haga clic en Aadir.

En el cuadro Nombre, escriba Series7NamespacesAreUnicode.

En el cuadro Valor, haga clic en Falso y, a continuacin, haga clic en Aceptar.

8. En la ventana Propiedades, en Configuracin de cookies, asegrese de que las propiedades


Ruta, Dominio e Indicador de proteccin activado coincidan con los valores configurados para
IBM Cognos Series 7.
9. En el men Archivo, haga clic en Guardar.
10. Pruebe la conexin con un nuevo espacio de nombre. En la ventana Explorador, en Autenticacin, haga clic con el botn derecho en el nuevo recurso de autenticacin y haga clic en Probar.

Gua de instalacin y configuracin 181

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Habilitacin de la comunicacin segura con el servidor de directorio utilizado por


el espacio de nombre de IBM Cognos Series 7
Si est utilizando una conexin SSL con el servidor de directorio utilizado por el espacio de nombre
de IBM Cognos Series 7, debe copiar el certificado del servidor de directorio en cada equipo de
Content Manager.
Para obtener ms informacin, consulte la publicacin IBM Cognos Access Manager Administrator
Guide y la documentacin del servidor de directorio.

Habilitacin del inicio de sesin nico entre IBM Cognos Series 7 e IBM Cognos
8.
Si el espacio de nombre de IBM Cognos Series 7 se ha configurado para integrarse con los mecanismos de autenticacin externos para el inicio de sesin nico, el proveedor de IBM Cognos Series 7
utilizar automticamente esta configuracin.
Si configura el inicio de sesin nico, no se le solicitar que vuelva a especificar la informacin de
autenticacin cuando acceda al contenido de IBM Cognos protegido por el espacio de nombre de
IBM Cognos Series 7.

Pasos
1. Asegrese de haber configurado los componentes de IBM Cognos 8 para que utilicen un espacio
de nombre de IBM Cognos Series 7 como proveedor de autenticacin (p. 180).
2. En IBM Cognos Series 7, inicie el Configuration Manager.
3. Haga clic en Abrir la configuracin actual.
4. En la pestaa Componentes, en la ventana Explorador, expanda Servicios, Access Manager Autenticacin Web y haga clic en Configuracin de cookies.
5. En la ventana Propiedades, asegrese de que las propiedades Ruta, Dominio e Indicador de
proteccin activado coincidan con los valores configurados para IBM Cognos 8.
6. Guarde y cierre Configuration Manager.
7. Si el espacio de nombre de IBM Cognos Series 7 utiliza el complemento de inicio de sesin de
confianza para el inicio de sesin nico, debe definir la funcin SaferAPIGetTrustedSignonWithEnv.
Ahora, puede aadir IBM Cognos Upfront Series 7 NewsBoxes a las pginas de portal de IBM
Cognos Connection.

Espacios de nombre de IBM Cognos Series 7 y complemento de inicio de sesin


de confianza de IBM Cognos Series 7
Si el espacio de nombre de IBM Cognos Series 7 utiliza el complemento de inicio de sesin de confianza para el inicio de sesin nico, debe definir la funcin SaferAPIGetTrustedSignonWithEnv en
el complemento. A continuacin, debe volver a compilar y desplegar la biblioteca para lograr el
inicio de sesin nico entre los componentes de IBM Cognos 8 y su mecanismo de autenticacin.

182 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
La funcin SaferAPIGetTrustedSignonWithEnv es una versin actualizada de la funcin SaferAPIGetTrustedSignon. Esta actualizacin es necesaria porque el inicio de sesin de IBM Cognos 8 no
se realiza en el servidor Web, como en el caso de las aplicaciones de IBM Cognos Series 7. Por lo
tanto, no es posible que el complemento realice una llamada API getenv() para recuperar las variables
de entorno del servidor Web. El complemento puede requerir que determinadas variables de entorno
se eliminen del servidor Web utilizando la funcin SaferAPIGetTrustedSignonWithEnv.
Si est ejecutando productos de IBM Cognos Series 7 e IBM Cognos 8 utilizando el mismo complemento, sern necesarias las funciones SaferAPIGetTrustedSignonWithEnv y SaferAPIGetTrustedSignon. Para obtener informacin sobre la funcin SaferAPIGetTrustedSignon, consulte la documentacin de IBM Cognos Series 7.

Funcin SaferAPIGetTrustedSignonWithEnv
Para que Access Manager pueda autenticar correctamente a los usuarios, los inicios de sesin del
SO deben existir y estar habilitados en el espacio de nombre actual.
La memoria de los valores trustedSignonName y trustedDomainName devueltos se asigna de manera
interna en esta API. Si la funcin devuelve SAFER_SUCCESS, Access Manager llama a SaferAPIFreeTrustedSignon para liberar la memoria asignada.
La memoria del valor reqEnvVarList devuelto se asigna de manera interna en esta API. Si la funcin
devuelve SAFER_INFO_REQUIRED, Access Manager llama a SaferAPIFreeBuffer() para liberar
la memoria asignada.
Debe implementar las funciones SaferAPIGetTrustedSignon y SaferAPIFreeBuffer para registrar
correctamente la biblioteca cuando se implementa SaferAPIGetTrustedSignonWithEnv. La funcin
SaferAPIGetError slo es necesaria si desea que se devuelvan desde el complemento mensajes de
error especficos.

Sintaxis
SaferAPIGetTrustedSignonWithEnv(
EnvVar

envVar[],

/*[IN]*/

char

**reqEnvVarList,

/*[OUT]*/

void

**trustedSignonName,

/*[OUT]*/

unsigned long

*trustedSignonNameLength,

/*[OUT]*/

void

**trustedDomainName,

/*[OUT]*/

unsigned long

*trustedDomainNameLength,

/*[OUT]*/

SAFER_USER_TYPE

*userType,

/*[OUT]*/

void

**implementerData);

/*[IN/OUT]*/

Parmetro

Descripcin

[in] envVar

Matriz de los valores y nombres de variables de entorno recuperados del servidor


Web. El final de la matriz se representa con una entrada con un valor envVar
Name nulo y un valor envVarValue nulo. Tenga en cuenta que la primera vez
que se llama a esta API, la matriz envVar slo contendr el final del marcador
de la matriz.

Gua de instalacin y configuracin 183

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Parmetro

Descripcin

[in] reqEnvVarList

Cadena que contiene una lista separada por comas con los nombres de variables
de entorno solicitados por el mdulo de inicio de sesin de confianza. El final
de la lista debe terminar con un carcter nulo.

[out] trustedSignonName

Secuencia de bytes que identifica al usuario actualmente autenticado. No es


necesario que este valor termine con un valor nulo. Este valor es obligatorio.

[out] trustedSignonNameLength Valor entero que indica la longitud del valor trustedSignonName. Dicha longitud
debe excluir el carcter de finalizacin nulo, si lo hay. Este valor es obligatorio.
[out] trustedDomainName

Secuencia de bytes que identifica el dominio del usuario actualmente autenticado.


Este valor no tiene por qu ser nulo. Si no hay un valor trustedDomainName,
la devolucin ser nula. Este valor es opcional.

[out] trustedDomainNameLength Valor entero que indica la longitud del valor trustedDomainName. Dicha longitud
debe excluir el carcter de finalizacin nulo, si lo hay. Este valor es obligatorio
y se debe establecer en cero si no existe un valor trustedDomainName.
[out] userType

Valor que indica el tipo de usuario que autenticar Access Manager. Este valor
es obligatorio.
Access Manager necesita los siguientes valores de retorno para autenticar
correctamente a los usuarios:
SAFER_NORMAL_USER
Usuario con nombre. En el espacio de nombre actual deben existir y estar habilitados los inicios de sesin del SO.
SAFER_GUEST_USER
Usuario invitado. En el espacio de nombre debe existir y estar habilitada una
cuenta de usuario invitado.
SAFER_ANONYMOUS_USER
Usuario annimo. En el espacio de nombre actual debe existir y estar habilitada
una cuenta de usuario annimo.

[in/out] implementerData

184 PowerPlay

Puntero utilizado para conservar los datos especficos de la implementacin


entre llamadas. Se produce una llamada cada vez que Access Manager llama al
complemento de inicio de sesin de confianza. Este valor slo es vlido si se ha
llamado al complemento del inicio de sesin de confianza y se ha establecido
un valor para l.

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Configuracin de IBM Cognos 8 para utilizar un proveedor de


autenticacin personalizado
Si ha implementado un proveedor de autenticacin Java personalizado con su infraestructura de
seguridad existente, puede configurar los componentes de IBM Cognos 8 para utilizarlo.
Puede utilizar un proveedor de autenticacin personalizado para acceder a los usuarios y autenticarlos en un origen de autenticacin alternativo. Tambin puede utilizarlo como mecanismo de
inicio de sesin nico para integrar los componentes de IBM Cognos 8 con la infraestructura de
seguridad. Puede ocultar el espacio de nombre a los usuarios durante el inicio de sesin.
Para obtener ms informacin, consulte la publicacin Custom Authentication Provider Developer
Guide.

Configuracin de un espacio de nombre de autenticacin personalizado


Puede configurar los componentes de IBM Cognos 8 para que utilicen un espacio de nombre de
autenticacin personalizado. Toda configuracin adicional para el acceso de origen de autenticacin,
el inicio de sesin nico o los atributos personalizados dependen de la implementacin del proveedor
de autenticacin personalizado.
Asegrese de que las versiones de JRE (entorno en tiempo de ejecucin de Java) y Java SDK son
compatibles entre s. Si utiliza versiones admitidas de JRE y Java SDK que no son compatibles entre
s, el proveedor de autenticacin Java personalizado que configure no aparecer en la lista de
espacios de nombre en IBM Cognos Configuration.

Pasos
1. En todos los equipos en los que se haya instalado Content Manager, abra IBM Cognos Configuration.
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
4. En la lista Tipo, haga clic en Proveedor Java personalizado y, a continuacin, en Aceptar.
El nuevo recurso proveedor de autenticacin aparece en la ventana Explorador, bajo el componente Autenticacin.
5. En la ventana Propiedades, especifique para la propiedad ID de espacio de nombre un identificador exclusivo para el espacio de nombre.
Sugerencia: No utilice los dos puntos (:) en la propiedad ID de espacio de nombre.
6. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que
IBM Cognos 8 pueda localizar y utilizar el proveedor de autenticacin existente.
7. En el men Archivo, haga clic en Guardar.
8. Pruebe la conexin con un nuevo espacio de nombre. En la ventana Explorador, en Autenticacin, haga clic con el botn derecho en el nuevo recurso de autenticacin y haga clic en Probar.

Gua de instalacin y configuracin 185

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
IBM Cognos 8 carga, inicializa y configura las bibliotecas de proveedor del espacio de nombre.

Cmo ocultar el espacio de nombre a los usuarios durante el inicio de sesin


Puede ocultar los espacios de nombres a los usuarios durante el inicio de sesin. Puede tener espacios
de nombres de inicio de sesin de confianza sin mostrarlos en la lista de seleccin de espacios de
nombres que se presenta cuando los usuarios inician la sesin.
Por ejemplo, puede que desee integrar el inicio de sesin nico en los sistemas, pero desea mantener
la capacidad de los clientes para autenticarse directamente en IBM Cognos 8 sin que se les solicite
elegir un espacio de nombre.

Pasos
1. En todos los equipos en los que haya configurado un proveedor de autenticacin Java personalizado, abra IBM Cognos Configuration.
2. En la ventana Explorador, en Seguridad, Autenticacin, haga clic en el proveedor de autenticacin Java personalizado.
3. En la ventana Propiedades, haga clic en el cuadro situado junto a Seleccionable para autenticacin y, a continuacin, haga clic en Falso.
4. En el men Archivo, haga clic en Guardar.
El espacio de nombre no se mostrar en la lista de seleccin que se presenta durante el inicio de
sesin.

Configuracin de los componentes de IBM Cognos 8 para utilizar LDAP


Puede configurar los componentes de IBM Cognos 8 para utilizar un espacio de nombre de LDAP
como proveedor de autenticacin. Puede utilizar un espacio de nombre de LDAP para los usuarios
almacenados en un directorio de usuario LDAP, servidor de Active Directory, IBM Directory Server,
Novell Directory Server o Sun Java System Directory Server.
Tambin puede utilizar la autenticacin de LDAP con los orgenes de datos DB2 y Essbase OLAP
especificando el espacio de nombre de LDAP al configurar la conexin del origen de datos. Para
obtener ms informacin, consulte la Gua de administracin y seguridad.
Tambin tiene la opcin de poner las propiedades de usuario personalizadas del espacio de nombre
de LDAP a disposicin de los componentes de IBM Cognos 8.
Para enlazar un usuario con el servidor LDAP, el proveedor de autenticacin de LDAP debe crear
el nombre distinguido (DN). Si la propiedad Utilizar identidad externa est establecida en Verdadero,
utiliza la propiedad Asignacin de identidad externa para intentar resolver el DN del usuario. Si
no encuentra la variable de entorno o el DN del servidor LDAP, trata de utilizar la propiedad Bsqueda de usuario para crear el DN.
Si los usuarios estn almacenados jerrquicamente en el servidor de directorios, puede configurar
las propiedades Bsqueda de usuarios y Asignacin de identidad externa para que utilicen los filtros
de bsqueda. Cuando el proveedor de autenticacin LDAP realiza estas bsquedas, utiliza los filtros
186 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
especificados para las propiedades Bsqueda de usuarios y Asignacin de identidad externa. Tambin
enlaza con el servidor de directorio utilizando el valor especificado para la propiedad Enlazar
nombre distinguido y contrasea de usuario o el valor annimo si no se ha especificado ningn
valor.
Cuando un espacio de nombre de LDAP se ha configurado para utilizar la propiedad Asignacin
de identidad externa para la autenticacin, el proveedor de LDAP enlaza con el servidor de directorio
utilizando Enlazar nombre distinguido y contrasea de usuario o el valor annimo si no se ha
especificado ningn valor. Todos los usuarios que inician la sesin en IBM Cognos 8 utilizando la
asignacin de identidad externa ven los mismos usuarios, grupos y carpetas que el usuario de enlace.
Si no utiliza la asignacin de identidad externa, puede especificar si desea utilizar credenciales de
enlace para buscar el servidor de directorio LDAP configurando la propiedad Utilizar credenciales
de enlace para la bsqueda. Cuando la propiedad est habilitada, las bsquedas se realizan utilizando
las credenciales del usuario de enlace o el valor annimo si no se ha especificado ningn otro valor.
Si la propiedad est deshabilitada, que es el valor predeterminado, las bsquedas se realizan utilizando
las credenciales del usuario que ha iniciado la sesin. La ventaja de utilizar credenciales de enlace
es que, en lugar de cambiar los derechos administrativos de varios usuarios, puede cambiar slo
los derechos administrativos del usuario de enlace.
Importante: Si utiliza una sintaxis de DN, como uid=${IDusuario}, ou=miempresa.com, para las
propiedades Bsqueda de usuarios, Asignacin de identidad externa o Enlazar nombre distinguido
y contrasea de usuario, debe convertir en caracteres de escape todos aquellos caracteres especiales
que se utilicen en el DN. Si utiliza una sintaxis de bsqueda, como (uid=${IDusuario}), para las
propiedades Bsqueda de usuarios o Asignacin de identidad externa, no debe convertir en caracteres de escape los caracteres especiales que se utilizan en el DN.
Para utilizar un espacio de nombre de LDAP y configurar un inicio de sesin nico, siga estos pasos:

Configure los componentes de IBM Cognos 8 para que utilicen un espacio de nombre de LDAP.

Ponga las propiedades de usuario personalizadas a disposicin de los componentes de IBM


Cognos 8, si es necesario.

Habilite la comunicacin segura con el servidor LDAP, si es necesario.

Habilite el inicio de sesin nico entre LDAP y los componentes de IBM Cognos 8, si es necesario.

Configuracin de un espacio de nombre de LDAP


Puede configurar los componentes de IBM Cognos 8 para que utilicen un espacio de nombre de
LDAP si los usuarios estn almacenados en un directorio de usuarios de LDAP. Se puede acceder
al directorio de usuarios de LDAP desde cualquier otro entorno del servidor, como el servidor de
Active Directory o eTrust SiteMinder.
Si est configurando un espacio de nombre de LDAP para un servidor de directorio distinto a LDAP,
consulte la seccin correspondiente:

Para el servidor de Active Directory, consulte la seccin Configuracin de un espacio de nombre


de LDAP para el servidor de Active Directory.

Gua de instalacin y configuracin 187

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Para IBM Directory Server, consulte la seccin Configuracin de un espacio de nombre de


LDAP para el servidor de directorio IBM.

Para Novell Directory Server, consulte la seccin Configuracin de un espacio de nombre de


LDAP para Novell Directory Server.

Para Sun Java System Directory Server, consulte la seccin Configuracin de un espacio de
nombre de LDAP para Sun Java System Directory Server

Tambin puede utilizar la autenticacin de LDAP con los orgenes de datos DB2 y Essbase OLAP
especificando el espacio de nombre de LDAP al configurar la conexin del origen de datos. Para
obtener ms informacin, consulte la Gua de administracin y seguridad.

Pasos
1. En cada uno de los equipos en los que haya instalado Content Manager, abra IBM Cognos
Configuration.
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
4. En la lista Tipo, haga clic en el espacio de nombre adecuado y, a continuacin, haga clic en
Aceptar.
El nuevo recurso proveedor de autenticacin aparece en la ventana Explorador, bajo el componente Autenticacin.
5. En la ventana Propiedades, especifique un identificador exclusivo para el espacio de nombre
en la propiedad ID de espacio de nombre.
6. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que los
componentes de IBM Cognos 8 puedan localizar y utilizar el proveedor de autenticacin existente.
7. Si desea que el proveedor de autenticacin de LDAP se enlace con el servidor de directorio
utilizando una propiedad Enlazar nombre distinguido y contrasea de usuario al realizar bsquedas, especifique estos valores.
Si no se especifican los valores, el proveedor de autenticacin de LDAP se enlaza como annimo.
Si la asignacin de identidad externa est habilitada, Enlazar nombre distinguido y contrasea
de usuario se utiliza para todo el acceso de LDAP. Si no est habilitada la asignacin de identidad
externa, Enlazar nombre distinguido y contrasea de usuario se utiliza nicamente cuando se
especifica un filtro de bsqueda para la propiedad Bsqueda de usuarios. Si es as, cuando se
establezca el DN de usuario, las posteriores solicitudes del servidor LDAP se ejecutarn en el
contexto de autenticacin del usuario final.
8. Si no utiliza la asignacin de identidad externa, utilice las credenciales de enlace para buscar
en el servidor del directorio LDAP siguiendo estos pasos:

188 PowerPlay

Asegrese de que Utilizar identidad externa se haya establecido en Falso.

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Establezca Utilizar credenciales de enlace para la bsqueda en Verdadero.

Especifique el identificador y la contrasea de usuario en Enlazar nombre distinguido y


contrasea de usuario.

Si no especifica un identificador y una contrasea de usuario, y se habilita el acceso annimo,


la bsqueda se realizar utilizando el valor annimo.
9. Revise la configuracin de la asignacin de los objetos y los atributos necesarios.
En funcin de la configuracin de LDAP, es posible que tenga que cambiar algunos de los
valores predeterminados para garantizar una comunicacin correcta entre los componentes de
IBM Cognos 8 y el servidor LDAP.
Todos los usuarios autenticados deben poder acceder a los atributos de LDAP asignados a la
propiedad Nombre en Asignaciones de carpeta, Asignaciones de grupo y Asignaciones de cuenta.
Adems, la propiedad Nombre no puede estar en blanco.
10. En el men Archivo, haga clic en Guardar.
11. Pruebe la conexin con un nuevo espacio de nombre. En la ventana Explorador, en Autenticacin, haga clic con el botn derecho en el nuevo recurso de autenticacin y haga clic en Probar.
IBM Cognos 8 carga, inicializa y configura las bibliotecas de proveedor del espacio de nombre.

Configuracin de un espacio de nombre de LDAP para el servidor de Active


Directory
Si configura un nuevo espacio de nombre de LDAP para utilizar con un servidor de Active Directory,
debe modificar la configuracin necesaria y cambiar los valores de todas las propiedades de los
objetos de Active Directory.

Pasos
1. En cada uno de los equipos en los que haya instalado Content Manager, abra IBM Cognos
Configuration.
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
4. En la lista Tipo, haga clic en el espacio de nombre adecuado y, a continuacin, haga clic en
Aceptar.
El nuevo recurso proveedor de autenticacin aparece en la ventana Explorador, bajo el componente Autenticacin.
5. En la ventana Propiedades, especifique para la propiedad ID de espacio de nombre un identificador exclusivo para el espacio de nombre.
Sugerencia: No utilice los dos puntos (:) en la propiedad ID de espacio de nombre.

Gua de instalacin y configuracin 189

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
6. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que los
componentes de IBM Cognos 8 puedan localizar y utilizar el proveedor de autenticacin existente.
A continuacin se ofrecen valores de ejemplo:

Para Bsqueda de usuarios, especifique (sAMAccountName=${userID}).

Si utiliza el inicio de sesin nico, para Utilizar identidad externa, establezca el valor en
Verdadero.

Si utiliza el inicio de sesin nico, en Asignacin de identidad externa, especifique


(sAMAccountName=${environment("REMOTE_USER")}).
Si desea eliminar el nombre de dominio de la variable REMOTE_USER, especifique
(sAMAccountName=${replace(${environment("REMOTE_USER")}, "dominio\\","")}).

Para Enlazar nombre distinguido y contrasea de usuario, especifique usuario@dominio.

Para Identificador nico, especifique objectGUID.

7. Si desea que el proveedor de autenticacin de LDAP se enlace con el servidor de directorio


utilizando una propiedad Enlazar nombre distinguido y contrasea de usuario al realizar bsquedas, especifique estos valores.
Si no se especifican los valores, el proveedor de autenticacin de LDAP se enlaza como annimo.
8. Si no utiliza la asignacin de identidad externa, utilice las credenciales de enlace para buscar
en el servidor del directorio LDAP siguiendo estos pasos:

Asegrese de que Utilizar identidad externa se haya establecido en Falso.

Establezca Utilizar credenciales de enlace para la bsqueda en Verdadero.

Especifique el identificador y la contrasea de usuario en Enlazar nombre distinguido y


contrasea de usuario.

9. Para configurar las propiedades de asignacin avanzadas de LDAP de manera que se utilicen
con los objetos del servidor de Active Directory, utilice los valores especificados en la tabla
siguiente.
Todos los usuarios autenticados deben poder acceder a los atributos de LDAP asignados a la
propiedad Nombre en Asignaciones de carpeta, Asignaciones de grupo y Asignaciones de cuenta.
Adems, la propiedad Nombre no puede estar en blanco.

190 PowerPlay

Asignaciones

Propiedad LDAP

Valor LDAP

Carpeta

Clase de objeto

organizationalUnit,organization,container

Descripcin

descripcin

Nombre

ou,o,cn

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Asignaciones

Propiedad LDAP

Valor LDAP

Grupo

Clase de objeto

group

Descripcin

descripcin

Miembro

member

Nombre

cn

Clase de objeto

user

Telfono de trabajo

telephonenumber

Cuenta

Configuracin regio- (dejar en blanco)


nal del contenido
Descripcin

descripcin

Correo electrnico

mail

Fax/Telfono

facsimiletelephonenumber

Nombre dado

givenname

Telfono privado

homephone

Telfono mvil

mobile

Nombre

displayName

Buscapersonas

pager

Contrasea

unicodePwd

Direccin postal

postaladdress

Configuracin regio- (dejar en blanco)


nal del producto
Apellidos

sn

Nombre de usuario

sAMAccountName

Gua de instalacin y configuracin 191

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
Estas propiedades de asignacin representan los cambios en funcin de una instalacin predeterminada del servidor de Active Directory. Si ha modificado el esquema, es posible que tenga
que realizar cambios adicionales en la asignacin.
10. En el men Archivo, haga clic en Guardar.
11. Pruebe la conexin con un nuevo espacio de nombre. En la ventana Explorador, en Autenticacin, haga clic con el botn derecho en el nuevo recurso de autenticacin y haga clic en Probar.
IBM Cognos 8 carga, inicializa y configura las bibliotecas de proveedor del espacio de nombre.

Configuracin de un espacio de nombre de LDAP para el servidor de directorio


IBM
Si configura un nuevo espacio de nombre de LDAP para utilizar con IBM Directory Server, debe
modificar la configuracin necesaria y cambiar los valores de todas las propiedades de los objetos
de IBM Directory.

Pasos
1. Abra Cognos Configuration en cada una de las ubicaciones en las que haya instalado Content
Manager.
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
4. En la lista Tipo, haga clic en LDAP y, a continuacin, en Aceptar.
El nuevo recurso de espacio de nombre de autenticacin aparece en la ventana Explorador,
bajo el componente Autenticacin.
5. En la ventana Propiedades, especifique para la propiedad ID de espacio de nombre un identificador exclusivo para el espacio de nombre.
Sugerencia: No utilice los dos puntos (:) en la propiedad ID de espacio de nombre.
6. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que
IBM Cognos 8 pueda localizar y utilizar el espacio de nombre de autenticacin existente.

Para Bsqueda de usuarios, especifique (cn=${userID}).

Para Enlazar nombre distinguido y contrasea de usuario, especifique cn=raz.

7. Si desea que el proveedor de autenticacin de LDAP se enlace con el servidor de directorio


utilizando una propiedad Enlazar nombre distinguido y contrasea de usuario al realizar bsquedas, especifique estos valores.
Si no se especifican los valores, el espacio de nombre de autenticacin de LDAP se enlaza como
annimo.
8. Si no utiliza la asignacin de identidad externa, utilice las credenciales de enlace para buscar
en el servidor del directorio LDAP siguiendo estos pasos:

192 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Asegrese de que Utilizar identidad externa se haya establecido en Falso.

Establezca Utilizar credenciales de enlace para la bsqueda en Verdadero.

Especifique el identificador y la contrasea de usuario en Enlazar nombre distinguido y


contrasea de usuario.

9. Para configurar las propiedades de asignacin avanzadas de LDAP de manera que se utilicen
con los objetos de IBM Directory Server, utilice los valores especificados en la tabla siguiente.
Todos los usuarios autenticados deben poder acceder a los atributos de LDAP asignados a la
propiedad Nombre en Asignaciones de carpeta, Asignaciones de grupo y Asignaciones de cuenta.
Adems, la propiedad Nombre no puede estar en blanco.

Asignaciones

Propiedad LDAP

Valor LDAP

Carpeta

Clase de objeto

organizationalunit,organization,container

Descripcin

descripcin

Nombre

ou,o,cn

Clase de objeto

groupofnames

Descripcin

descripcin

Miembro

member

Nombre

cn

Clase de objeto

inetorgperson

Telfono de trabajo

telephonenumber

Configuracin regional del contenido

(dejar en blanco)

Descripcin

descripcin

Correo electrnico

mail

Fax/Telfono

facsimiletelephonenumber

Nombre dado

givenname

Telfono privado

homephone

Telfono mvil

mobile

Grupo

Cuenta

Gua de instalacin y configuracin 193

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Asignaciones

Propiedad LDAP

Valor LDAP

Nombre

cn

Buscapersonas

pager

Contrasea

userPassword

Direccin postal

postaladdress

Configuracin regional del producto

(dejar en blanco)

Apellidos

sn

Nombre de usuario

uid

Estas propiedades de asignacin representan los cambios en funcin de una instalacin predeterminada de IBM Directory Server. Si ha modificado el esquema, es posible que tenga que
realizar cambios adicionales en la asignacin.
10. En el men Archivo, haga clic en Guardar.

Configuracin de un espacio de nombre de LDAP para Novell Directory Server


Si configura un nuevo espacio de nombre de LDAP para utilizar con Novell Directory Server, debe
modificar la configuracin necesaria y cambiar los valores de todas las propiedades de los objetos
de Novell Directory.

Pasos
1. En cada uno de los equipos en los que haya instalado Content Manager, abra IBM Cognos
Configuration.
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
4. En la lista Tipo, haga clic en LDAP y, a continuacin, en Aceptar.
El nuevo recurso de espacio de nombre de autenticacin aparece en la ventana Explorador,
bajo el componente Autenticacin.
5. En la ventana Propiedades, especifique un identificador exclusivo para el espacio de nombre
en la propiedad Identificador de espacio de nombre.
Sugerencia: No utilice los dos puntos (:) en la propiedad ID de espacio de nombre.
6. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que
IBM Cognos 8 pueda localizar y utilizar el espacio de nombre de autenticacin existente.
194 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Para Bsqueda de usuarios, especifique (cn=${userID}).

Para Enlazar nombre distinguido y contrasea de usuario, especifique el DN base para un


usuario de administracin, como cn=Admin,0=COGNOS.

7. Si desea que el proveedor de autenticacin de LDAP se enlace con el servidor de directorio


utilizando una propiedad Enlazar nombre distinguido y contrasea de usuario al realizar bsquedas, especifique estos valores.
Si no se especifican los valores, el espacio de nombre de autenticacin de LDAP se enlaza como
annimo.
8. Si no utiliza la asignacin de identidad externa, utilice las credenciales de enlace para buscar
en el servidor del directorio LDAP siguiendo estos pasos:

Asegrese de que Utilizar identidad externa se haya establecido en Falso.

Establezca Utilizar credenciales de enlace para la bsqueda en Verdadero.

Especifique el identificador y la contrasea de usuario en Enlazar nombre distinguido y


contrasea de usuario.

9. Para configurar las propiedades de asignacin avanzadas de LDAP de manera que se utilicen
con los objetos de Novell Directory Server, utilice los valores especificados en la tabla siguiente.
Todos los usuarios autenticados deben poder acceder a los atributos de LDAP asignados a la
propiedad Nombre en Asignaciones de carpeta, Asignaciones de grupo y Asignaciones de cuenta.
Adems, la propiedad Nombre no puede estar en blanco.
Para que los usuarios inicien la sesin correctamente en IBM Cognos Connection, deben tener
permiso para leer los atributos ou y o.

Asignaciones

Propiedad LDAP

Valor LDAP

Carpeta

Clase de objeto

organizationalunit,organization,container

Descripcin

descripcin

Nombre

ou,o,cn

Clase de objeto

groupofnames

Descripcin

descripcin

Miembro

member

Nombre

cn

Clase de objeto

inetOrgPerson

Telfono de trabajo

telephonenumber

Grupo

Cuenta

Gua de instalacin y configuracin 195

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Asignaciones

Propiedad LDAP

Valor LDAP

Configuracin regional del contenido

Idioma

Descripcin

descripcin

Correo electrnico

mail

Fax/Telfono

facsimiletelephonenumber

Nombre dado

givenname

Telfono privado

homephone

Telfono mvil

mobile

Nombre

cn

Buscapersonas

pager

Contrasea

(dejar en blanco)

Direccin postal

postaladdress

Configuracin regional del producto

Idioma

Apellidos

sn

Nombre de usuario

uid

Estas propiedades de asignacin representan los cambios en funcin de una instalacin predeterminada de Novell Directory Server. Si ha modificado el esquema, es posible que tenga que
realizar cambios adicionales en la asignacin.
10. En el men Archivo, haga clic en Guardar.

196 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Configuracin de un espacio de nombre de LDAP para Sun Java System Directory


Server
Si configura un nuevo espacio de nombre de LDAP para utilizar con Sun Java System Directory
Server, debe modificar la configuracin necesaria y cambiar los valores de todas las propiedades
de los objetos de Sun Java System Directory.

Pasos
1. En cada uno de los equipos en los que haya instalado Content Manager, abra IBM Cognos
Configuration.
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
4. En la lista Tipo, haga clic en LDAP y, a continuacin, en Aceptar.
El nuevo recurso de espacio de nombre de autenticacin aparece en la ventana Explorador,
bajo el componente Autenticacin.
5. En la ventana Propiedades, especifique un identificador exclusivo para el espacio de nombre
en la propiedad Identificador de espacio de nombre.
Sugerencia: No utilice los dos puntos (:) en la propiedad ID de espacio de nombre.
6. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que
IBM Cognos 8 pueda localizar y utilizar el espacio de nombre de autenticacin existente.
A continuacin se ofrecen valores de ejemplo:

Para Bsqueda de usuarios, especifique (uid=${IDusuario}).

Si utiliza el inicio de sesin nico, para Utilizar identidad externa, establezca el valor en
Verdadero.

Si utiliza el inicio de sesin nico, para Asignacin de identidad externa, especifique un


atributo, como el ID de dominio de usuario NT o el identificador de usuario:
(ntuserdomainid=$environment("REMOTE_USER")})
(uid=${environment("REMOTE_USER")})

Para Identificador nico, escriba nsuniqueid.

7. Si desea que el proveedor de autenticacin de LDAP se enlace con el servidor de directorio


utilizando una propiedad Enlazar nombre distinguido y contrasea de usuario al realizar bsquedas, especifique estos valores.
Si no se especifican los valores, el espacio de nombre de autenticacin de LDAP se enlaza como
annimo.
8. Si no utiliza la asignacin de identidad externa, utilice las credenciales de enlace para buscar
en el servidor del directorio LDAP siguiendo estos pasos:

Gua de instalacin y configuracin 197

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Asegrese de que Utilizar identidad externa se haya establecido en Falso.

Establezca Utilizar credenciales de enlace para la bsqueda en Verdadero.

Especifique el identificador y la contrasea de usuario en Enlazar nombre distinguido y


contrasea de usuario.

9. Para configurar las propiedades de asignacin avanzadas de LDAP de manera que se utilicen
con los objetos de Sun Java System Directory Server, utilice los valores especificados en la tabla
siguiente.
Todos los usuarios autenticados deben poder acceder a los atributos de LDAP asignados a la
propiedad Nombre en Asignaciones de carpeta, Asignaciones de grupo y Asignaciones de cuenta.
Adems, la propiedad Nombre no puede estar en blanco.

Asignaciones Propiedad LDAP

Valor LDAP

Carpeta

Clase de objeto

organizationalUnit,organization

Descripcin

descripcin

Nombre

ou,o

Clase de objeto

groupofuniquenames

Descripcin

descripcin

Miembro

uniquemember

Nombre

cn

Clase de objeto

inetorgperson

Telfono de trabajo

telephonenumber

Configuracin regional del contenido

preferredlanguage

Descripcin

descripcin

Correo electrnico

mail

Fax/Telfono

facsimiletelephonenumber

Nombre dado

givenname

Telfono privado

homephone

Telfono mvil

mobile

Grupo

Cuenta

198 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Asignaciones Propiedad LDAP

Valor LDAP

Nombre

cn

Buscapersonas

pager

Contrasea

userPassword

Direccin postal

postaladdress

Configuracin regional del producto

preferredlanguage

Apellidos

sn

Nombre de usuario

uid

Estas propiedades de asignacin representan los cambios en funcin de una instalacin predeterminada de Sun Java System Directory Server. Si ha modificado el esquema, es posible que
tenga que realizar cambios adicionales en la asignacin.
10. En el men Archivo, haga clic en Guardar.

Cmo poner las propiedades de usuario personalizadas para LDAP a disposicin


de los componentes de IBM Cognos 8
Puede utilizar atributos de usuario arbitrarios del proveedor de autenticacin de LDAP en los
componentes de IBM Cognos 8. Para realizar esta configuracin, debe aadir estos atributos como
propiedades personalizadas para el espacio de nombre de LDAP. Las propiedades personalizadas
estn disponibles como parmetros de sesin a travs de Framework Manager. Para obtener ms
informacin sobre los parmetros de la sesin, consulte Framework Manager User Guide.
Asimismo, puede utilizar las propiedades personalizadas dentro de los bloques de comandos para
configurar sesiones y conexiones de Oracle. Puede utilizar los bloques de comandos con conexiones
ligeras de Oracle y con bases de datos privadas virtuales. Para obtener ms informacin, consulte
la Gua de administracin y seguridad.

Pasos
1. Abra Cognos Configuration en cada una de las ubicaciones en las que haya instalado Content
Manager.
2. En la ventana Explorador, en Seguridad, Autenticacin, haga clic en el espacio de nombre de
LDAP.
3. En la ventana Propiedades, haga clic en la columna Valor de Propiedades personalizadas y en
el botn Editar.
4. En la ventana Valor: Propiedades personalizadas, haga clic en Aadir.

Gua de instalacin y configuracin 199

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
5. Haga clic en la columna Nombre y escriba el nombre que desea que utilicen los componentes
de IBM Cognos 8 para el parmetro de sesin.
6. Haga clic en la columna Valor y escriba el nombre del parmetro de cuenta en el proveedor de
autenticacin de LDAP.
7. Repita los dos pasos anteriores para cada parmetro personalizado.
8. Haga clic en Aceptar.
9. En el men Archivo, haga clic en Guardar.

Habilitacin de la comunicacin segura con el servidor LDAP


El protocolo LDAP seguro (LDAPS) cifra la comunicacin entre el componente Access Manager
de Content Manager y el servidor de directorio. LDAPS evita que la informacin importante del
servidor de directorio y las credenciales LDAP se enven como texto claro.
Para habilitar LDAPS, instale un certificado de servidor firmado por una entidad emisora de certificados en el servidor de directorio. A continuacin, cree una base de datos de certificados que
contenga los certificados. Por ltimo, configure el servidor de directorio y el espacio de nombre de
LDAP de IBM Cognos 8 para que utilicen LDAPS.
El certificado de servidor debe ser una copia de uno de los siguientes:

El certificado raz de confianza y todos los dems certificados que componen la cadena de
confianza para el certificado de servidor de directorios.
El certificado raz de confianza es el certificado de la entidad emisora de certificados raz que
ha firmado el certificado del servidor de directorio.

Slo el certificado del servidor de directorios.

Los certificados deben ser de tipo Base64 codificados en formato ASCII (PEM). Ningn certificado,
salvo el certificado raz de confianza, debe tener firma personal.
IBM Cognos 8 funciona con las versiones cert8.db y cert7.db de la base de datos de certificados de
cliente. Debe utilizar la herramienta certutil, de la herramienta NSS_3_11_4_RTM de Netscape
OpenSource para crear la base de datos de certificados. IBM Cognos 8 no acepta otras versiones
de archivos cert8.db, incluidos los de la herramienta certutil que se proporciona con Microsoft
Active Directory. La herramienta certutil adecuada se encuentra disponible en ftp://ftp.mozilla.org/
pub/mozilla.org/security/nss/releases/NSS_3_11_4_RTM.
Tambin debe utilizar la biblioteca NSPR, que est disponible en ftp://ftp.mozilla.org/pub/mozilla.
org/nspr/releases/v4.6.7.

Pasos
1. 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.

200 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
Este comando crea un archivo cert8.db y un archivo key3.db en el nuevo directorio.
3. Aada el certificado de la entidad emisora de certificados (CA) o el certificado del servidor de
directorios a la base de datos de certificados, escribiendo el comando correspondiente al tipo
de certificado:

Para un certificado CA, escriba


certutil -A -n nombre_certificado -d directorio_certificados -i CA.cert -t C,C,C

Para un certificado de servidor de directorios, escriba


certutil -A -n nombre_certificado -d directorio_certificados -i certificado_servidor.cert -t
P

donde nombre_certificado es un alias que se asigna, como el nombre de CA o el nombre de


host; y certificado_servidor es el prefijo del archivo de certificados del servidor de directorios.
4. Copie el directorio de la base de datos de certificados en el directorio ubicacin_c8/configuration
en cada uno de los equipos donde est instalado Content Manager.
5. Configure el servidor de directorios para que utilice LDAPS y reinicie el servidor de directorios.
Si desea obtener ms informacin, consulte la documentacin del servidor de directorios.
6. Inicie Cognos Configuration en cada una de las ubicaciones de Content Manager en las que
haya configurado el espacio de nombre de LDAP para utilizar el servidor de directorios.
7. En la ventana Explorador, en Seguridad, Autenticacin, haga clic en el espacio de nombre de
LDAP.
8. En la ventana Propiedades, para la propiedad Host y puerto, cambie el puerto por el puerto
LDAPS seguro.
Para la propiedad Base de datos de certificados SSL, especifique la ruta de acceso al archivo
cert7.db.
9. En la ventana Explorador, haga clic con el botn derecho en el nombre de espacio de LDAP y
haga clic en Probar.
Si la prueba falla, revise las propiedades, asegurndose de utilizar el certificado correcto.
10. En el men Archivo, haga clic en Guardar.
11. En el men Acciones, haga clic en Reiniciar.
12. Repita los pasos del 6 al 11 en cada uno de los equipos donde haya instalado Content Manager.

Habilitacin de un inicio de sesin nico entre LDAP y los componentes de IBM


Cognos 8
El inicio de sesin nico para los componentes de IBM Cognos 8 se obtiene al configurar la propiedad
Asignacin de identidad externa.
La asignacin de identidad externa puede hacer referencia a una variable de entorno CGI o a una
variable de encabezado HTTP. En caso de una puerta de enlace de servidor de aplicaciones o entrada
Gua de instalacin y configuracin 201

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
de distribuidor que seale a los componentes de IBM Cognos 8, la asignacin de identidad externa
puede hacer referencia a la variable de sesin userPrincipalName. El valor resuelto de la propiedad
Asignacin de identidad externa durante el tiempo de ejecucin debe ser un DN de usuario vlido.
Cuando un espacio de nombre de LDAP se configura para utilizar la propiedad Asignacin de
identidad externa para la autenticacin, el proveedor de LDAP enlaza con el servidor de directorio
utilizando Enlazar nombre distinguido y contrasea de usuario o el valor annimo si no se ha
especificado ningn valor. Todos los usuarios que inician la sesin en IBM Cognos 8 utilizando la
asignacin de identidad externa ven los mismos usuarios, grupos y carpetas que el usuario de enlace.
Si desea que los componentes de IBM Cognos 8 funcionen con aplicaciones que utilicen la seguridad
de Java o del servidor de aplicaciones, puede configurar la propiedad Asignacin de identidad
externa para obtener el identificador de usuario del objeto principal de usuario de Java. Incluya la
marca ${environment("USER_PRINCIPAL")} en el valor de la propiedad. Para obtener ms informacin, consulte la ayuda en lnea de IBM Cognos Configuration.
Puede aplicar una edicin de expresin limitada a la propiedad Asignacin de identidad externa
utilizando la operacin de sustitucin.

Operacin de sustitucin
La operacin de sustitucin devuelve una copia de la cadena con todas las repeticiones de la antigua
subcadena sustituida por la nueva subcadena.
Se aplican las siguientes reglas:

El carcter \ indica caracteres de escape en los parmetros de funcin. Es necesario escapar los
caracteres como \ y ".

No se admiten las llamadas a funciones anidadas.

No se admiten caracteres especiales.

Sintaxis
${replace(str , old , new)}

Parmetro

Descripcin

str

Cadena de la bsqueda.

old

Subcadena que se va a sustituir por la nueva subcadena.

new

Subcadena que sustituye a la antigua subcadena.

Ejemplos
${replace(${environment("REMOTE_USER")},"NAMERICA\\",)}
${replace(${environment("REMOTE_USER")},"NAMERICA\\","")}

202 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Configuracin de los componentes de IBM Cognos 8 para utilizar


eTrust SiteMinder
Puede configurar los componentes de IBM Cognos 8 para que utilicen un espacio de nombre de
Netegrity SiteMinder como origen de autenticacin, siempre que haya instalado Content Manager
en un equipo que no sea de Linux.
Para configurar un origen de autenticacin en un entorno de eTrust SiteMinder, configure un
espacio de nombre de LDAP, NTLM o Netegrity SiteMinder, en funcin de su configuracin de
eTrust SiteMinder. Las configuraciones admitidas de eTrust SiteMinder son LDAP, servidor de
Active Directory y directorios de usuario de NTLM.
Nota: El proveedor de autenticacin utiliza un SDK eTrust SiteMinder para implementar un agente
personalizado. La implementacin del agente personalizado requiere que establezca las propiedades
del agente en la consola de administracin del servidor de directivas de eTrust SiteMinder para
admitir agentes 4.x.
Si tiene pensado ejecutar productos de IBM Cognos 8 con un servidor de aplicaciones de 64 bits,
no puede configurar un espacio de nombre de Netegrity SiteMinder como su fuente de autenticacin.

Si eTrust SiteMinder se ha configurado para ms de un directorio de usuario


Si ha configurado eTrust SiteMinder para ms de un directorio de usuario, debe utilizar el espacio
de nombre de Netegrity SiteMinder. Tras configurar el espacio de nombre de Netegrity SiteMinder
en IBM Cognos 8, debe aadir tambin el LDAP correspondiente, el servidor de Active Directory
o el espacio de nombre de NTLM a IBM Cognos Configuration para cada directorio de usuario
definido en eTrust SiteMinder.
Cuando configure un espacio de nombre de LDAP correspondiente, asegrese de que la propiedad
Asignacin de identidad externa est habilitada y que incluye la marca REMOTE_USER en el valor
de la propiedad. Esto no significa que deba configurar eTrust SiteMinder para definir
REMOTE_USER. El espacio de nombre de IBM Cognos Netegrity SiteMinder pasa de manera
interna la informacin de usuario al espacio de nombre de LDAP correspondiente cuando recibe
una identificacin de usuario correcta del entorno de eTrust SiteMinder.
Al configurar un espacio de nombre de Active Directory correspondiente, asegrese de que la propiedad singleSignOnOption est establecida en IdentityMapping. El espacio de nombre de IBM
Cognos Netegrity SiteMinder pasa de manera interna la informacin de usuario al espacio de
nombre de LDAP correspondiente, mediante la variable de entorno REMOTE_USER, cuando recibe
una identificacin de usuario correcta del entorno de eTrust SiteMinder. Para obtener ms informacin, consulte "Habilitacin del inicio de sesin nico entre el servidor de Active Directory y los
componentes de IBM Cognos 8" (p. 178).

Si eTrust SiteMinder se ha configurado con slo un directorio de usuario


Si eTrust SiteMinder se ha configurado con slo un directorio de usuario, no es necesario el espacio
de nombre de Netegrity SiteMinder. Puede utilizar el directorio de usuario como origen de autenticacin si configura el espacio de nombre adecuado o bien puede configurar el proveedor de eTrust
SiteMinder con un directorio de usuario. Por ejemplo, si el directorio de usuario de eTrust SiteMinder
es NTML, puede configurar los componentes de IBM Cognos 8 con un espacio de nombre de NTLM

Gua de instalacin y configuracin 203

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
o configurar los componentes de IBM Cognos 8 con un espacio de nombre de Netegrity SiteMinder,
haciendo referencia a un directorio de usuario que es un espacio de nombre de NTLM.
Si el directorio de usuario de eTrust SiteMinder es Active Directory, puede utilizar un espacio de
nombre de Active Directory o un espacio de nombre de LDAP configurado para utilizarse con
Active Directory.
Si desea utilizar el directorio de usuario directamente como origen de autenticacin en lugar de
configurar un espacio de nombre de Netegrity SiteMinder, configure el espacio de nombre de LDAP
(p. 187), Active Directory (p. 189) o NTLM (p. 207) correspondiente. En este caso, verifique las propiedades del objeto de configuracin del agente en el servidor de directivas de eTrust SiteMinder.
Asegrese de haber activado SetRemoteUser.
Cuando configure el espacio de nombre de LDAP en este caso, asegrese de que la propiedad
Asignacin de identidad externa est habilitada y que incluye la marca REMOTE_USER en el valor
de la propiedad.
Al configurar el espacio de nombre de Active Directory en este caso, asegrese de que la propiedad
singleSignOnOption est establecida en IdentityMapping. Para obtener ms informacin, consulte
"Habilitacin del inicio de sesin nico entre el servidor de Active Directory y los componentes de
IBM Cognos 8" (p. 178).
Para utilizar un espacio de nombre de eTrust SiteMinder y configurar el inicio de sesin nico, siga
estos pasos:

Configure los componentes de IBM Cognos 8 para que utilicen un espacio de nombre de
Netegrity SiteMinder.

Habilite la comunicacin segura con el servidor de usuario de eTrust SiteMinder, si es necesario.

Habilite el inicio de sesin nico entre eTrust SiteMinder e IBM Cognos 8.

Proteja el alias de IBM Cognos Web.

Puede ocultar el espacio de nombre a los usuarios durante el inicio de sesin (p. 186).

Configuracin de un espacio de nombre de Netegrity SiteMinder


Si ha configurado eTrust SiteMinder para ms de un directorio de usuario, debe utilizar el espacio
de nombre de Netegrity SiteMinder. Despus de aadir el espacio de nombre de Netegrity SiteMinder,
debe aadir tambin el espacio de nombre de LDAP o NTLM correspondiente a cada directorio de
usuario.
Tambin puede configurar un espacio de nombre de Netegrity SiteMinder si los usuarios estn
almacenados en:

Un servidor LDAP

Un servidor NTLM

Un servidor de Active Directory

Pasos
1. En el equipo en el que haya instalado Content Manager, abra IBM Cognos Configuration.

204 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
4. En la lista Tipo, haga clic en el espacio de nombre de Netegrity SiteMinder adecuado y, a
continuacin, haga clic en Aceptar.
El nuevo recurso proveedor de autenticacin aparece en la ventana Explorador, bajo el componente Autenticacin.
5. En la ventana Propiedades, especifique para la propiedad ID de espacio de nombre un identificador exclusivo para el espacio de nombre.
Sugerencia: No utilice los dos puntos (:) en la propiedad ID de espacio de nombre.
6. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que los
componentes de IBM Cognos 8 puedan localizar y utilizar el proveedor de autenticacin existente.
7. En la ventana Explorador, en Seguridad, Autenticacin, haga clic con el botn derecho en el
espacio de nombre y haga clic en Nuevo recurso, Servidor de directivas de SiteMinder.
8. En el cuadro Nombre, escriba el nombre del servidor de directivas y haga clic en Aceptar.
9. En la ventana Propiedades, especifique la propiedad Host y cualquier otro valor de propiedad
que desee cambiar.
10. En la ventana del Explorador, haga clic con el botn derecho en el nuevo servidor de directivas
de SiteMinder y haga clic en Nuevo recurso, Directorio de usuario.
Sugerencia: Configure un directorio de usuario para cada directorio de usuario del servidor de
directivas de SiteMinder.
11. En el cuadro Nombre, escriba el nombre del directorio de usuario y haga clic en Aceptar.
Importante: El nombre del directorio de usuario debe coincidir con el nombre que aparece en
el servidor de directivas.
12. En la ventana Propiedades, escriba un valor para la propiedad Referencia de ID de espacio de
nombre.
13. En el men Archivo, haga clic en Guardar.
14. Pruebe la conexin con un nuevo espacio de nombre. En la ventana Explorador, en Autenticacin, haga clic con el botn derecho en el nuevo recurso de autenticacin y haga clic en Probar.
15. Configure el espacio de nombre de LDAP, Active Directory o NTLM correspondiente para
cada directorio de usuario de LDAP, Active Directory o NTLM.
Importante: Asegrese de utilizar el mismo valor para la propiedad ID de espacio de nombre
que para la propiedad ID de espacio de nombre del espacio de nombre de Netegrity SiteMinder.

Gua de instalacin y configuracin 205

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Habilitacin de la comunicacin segura en el directorio de usuario de eTrust


SiteMinder
Si utiliza una conexin SSL para conectarse con el servidor de directorios, deber configurar
correctamente el espacio de nombre de Cognos para el directorio de usuario.
Para obtener ms informacin, consulte "Configuracin de un espacio de nombre de LDAP" (p. 187).

Habilitacin del inicio de sesin nico entre eTrust SiteMinder e IBM Cognos 8
Si configura el inicio de sesin nico, no se le solicitar que vuelva a especificar la informacin de
autenticacin.
Los componentes de IBM Cognos 8 se refieren automticamente a la cookie de la sesin de eTrust
SiteMinder para los datos de la sesin del usuario.
Si el directorio de usuario de eTrust SiteMinder es LDAP o Active Directory, debe configurar el
directorio de usuario de eTrust SiteMinder para que utilice la asignacin de identidad externa a la
variable de entorno de REMOTE_USER.
Si el directorio de usuario de eTrust SiteMinder es NTLM, la autenticacin integrada de Windows
se utiliza para el inicio de sesin nico y no se necesita una configuracin adicional.

Proteccin del alias de IBM Cognos Web


Asegrese de que eTrust SiteMinder est configurado correctamente para proteger los alias Web
de IBM Cognos.
Utilice la herramienta de prueba proporcionada con eTrust SiteMinder para verificar que el recurso
est protegido, autenticado y autorizado. Para obtener ms informacin, consulte la documentacin
de eTrust SiteMinder.

Cmo ocultar el espacio de nombre a los usuarios durante el inicio de sesin


Puede ocultar los espacios de nombres a los usuarios durante el inicio de sesin. Puede tener espacios
de nombres de inicio de sesin de confianza sin mostrarlos en la lista de seleccin de espacios de
nombres que se presenta cuando los usuarios inician la sesin.
Por ejemplo, puede que desee integrar el inicio de sesin nico en los sistemas, pero desea mantener
la capacidad de los clientes para autenticarse directamente en IBM Cognos 8 sin que se les solicite
elegir un espacio de nombre.

Pasos
1. En todos los equipos en los que haya configurado un proveedor de autenticacin eTrust SiteMinder personalizado, abra IBM Cognos Configuration.
2. En la ventana Explorador, en Seguridad, Autenticacin, haga clic en el proveedor de autenticacin Netegrity Siteminder.
3. En la ventana Propiedades, haga clic en el cuadro situado junto a Seleccionable para autenticacin y, a continuacin, haga clic en Falso.
4. En el men Archivo, haga clic en Guardar.
206 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
El espacio de nombre no se mostrar en la lista de seleccin que se presenta durante el inicio de
sesin.

Configuracin de los componentes de IBM Cognos 8 para utilizar un espacio de nombre de NTLM
Puede configurar los componentes de IBM Cognos 8 para que utilicen la seguridad nativa de Windows, NT LAN Manager (NTLM), como origen de autenticacin.
Si no est utilizando NTLM en el entorno IS, no puede utilizar un espacio de nombre de NTLM.
Si desea utilizar un directorio de usuario NTLM como origen de autenticacin con eTrust SiteMinder,
debe verificar las propiedades del objeto de configuracin del agente del servidor de directivas de
eTrust SiteMinder. Asegrese de haber activado SetRemoteUser.
Para utilizar NTLM y configurar un inicio de sesin nico, siga estos pasos:

Configure un espacio de nombre de NTLM.

Habilite el inicio de sesin nico entre NTLM y los componentes de IBM Cognos 8.

Configuracin de un espacio de nombre de NTLM


Puede configurar los componentes de IBM Cognos 8 para que utilicen un espacio de nombre de
NTLM si los usuarios estn almacenados en un directorio de usuarios de NTLM. Tambin se puede
acceder al directorio de usuario de NTLM utilizando un proveedor de autenticacin de eTrust
SiteMinder.

Pasos
1. En el equipo en el que haya instalado Content Manager, abra IBM Cognos Configuration.
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
4. En la lista Tipo, haga clic en NTLM y, a continuacin, en Aceptar.
El nuevo recurso proveedor de autenticacin aparece en la ventana Explorador, bajo el componente Autenticacin.
5. En la ventana Propiedades, especifique para la propiedad ID de espacio de nombre un identificador exclusivo para el espacio de nombre.
Sugerencia: No utilice los dos puntos (:) en la propiedad ID de espacio de nombre.
6. Especifique los valores de todas las propiedades necesarias restantes para asegurarse de que los
componentes de IBM Cognos 8 puedan localizar y utilizar el proveedor de autenticacin existente.
7. En el men Archivo, haga clic en Guardar.

Gua de instalacin y configuracin 207

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
8. Pruebe la conexin con un nuevo espacio de nombre. En la ventana Explorador, en Autenticacin, haga clic con el botn derecho en el nuevo recurso de autenticacin y haga clic en Probar.
IBM Cognos 8 carga, inicializa y configura las bibliotecas de proveedor del espacio de nombre.

Habilitacin del inicio de sesin nico entre NTLM y los componentes de IBM
Cognos 8
De forma predeterminada, el proveedor NTLM de IBM Cognos se integra con el servidor IIS Web
para el inicio de sesin nico si la autenticacin integrada en Windows (antes denominada NT
Challenge Response) est habilitada en el servidor IIS Web.
Si la autenticacin integrada en Windows est habilitada, no se le solicitar que vuelva a especificar
la informacin de autenticacin cuando acceda al contenido de IBM Cognos protegido por el
espacio de nombre de NTLM.

Pasos
1. Configure la autenticacin integrada en Windows en el servidor IIS Web.
2. Instale Content Manager en un equipo que forme parte del dominio, para los equipos de Content
Manager activos y en espera.
3. Configure los equipos, o la cuenta de usuario donde se ejecuta Content Manager, que sern
considerados de confianza para la delegacin.
4. Pruebe la conexin con un nuevo espacio de nombre. En la ventana Explorador, en Autenticacin, haga clic con el botn derecho en el nuevo recurso de autenticacin y haga clic en Probar.
IBM Cognos 8 carga, inicializa y configura las bibliotecas de proveedor del espacio de nombre.

Configuracin de IBM Cognos 8 para utilizar SAP


Para utilizar un servidor SAP como proveedor de autenticacin, debe utilizar una versin compatible
de SAP BW. Para ver una lista actualizada de los entornos compatibles con los productos IBM
Cognos, por ejemplo sistemas operativos, revisiones, exploradores, servidores Web, servidores de
directorio, servidores de base de datos y servidores de aplicaciones, visite el centro de recursos de
IBM Cognos (http://www.ibm.com/software/data/support/cognos_crc.html). Adems, Content
Manager debe estar instalado en un equipo que no sea de Linux.
En SAP BW, puede asignar usuarios a grupos de usuarios o roles, o a ambos. El proveedor de
autenticacin de SAP utiliza slo los roles.
Los derechos de autorizacin que necesita el usuario de SAP dependen de quin utilice los componentes de IBM Cognos 8, usuarios o administradores.

Configuracin de autorizacin de SAP para usuarios de IBM Cognos 8


Los siguientes objetos de autorizacin son necesarios para cualquier usuario de IBM Cognos.
Algunos de los valores mostrados, como *, son valores predeterminados que es posible que desee
modificar en el entorno.

208 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

Objeto de autorizacin

Campo

S_RFC

Actividad

Valor

Comprobacin de autorizacin para el acceso de


RFC
Nombre del RFC RFC1 RS_UNIFICATION, SDTX,
que se va a proteger SH3A, SU_USER, SYST, SUSO

S_USER_GRP

Tipo del RFC que


se va a proteger

FUGR

Actividad

03

Mantenimiento de usuario maestro: grupos de


usuarios
Nombre del grupo *
de usuarios

Configuracin de autorizacin de SAP para los administradores de IBM Cognos


Si los usuarios van a realizar tareas administrativas y bsquedas de usuarios y roles, se deben aadir
los siguientes valores al objeto de autorizacin S_RFC, adems de los valores mencionados antes
para los usuarios de IBM Cognos 8. Algunos de los valores mostrados, como *, son valores predeterminados que es posible que desee modificar en el entorno.

Objeto de autorizacin

Campo

Valor

S_RFC

Actividad

16

RFC_NAME

PRGN_J2EE, SHSS, SOA3

Comprobacin de autorizacin para el acceso de


RFC

Tipo del objeto RFC que se va a FUGR


proteger

Conectividad entre SAP BW e IBM Cognos 8 en UNIX


Para configurar la conectividad entre SAP BW y los componentes de IBM Cognos 8 en un sistema
operativo de UNIX, asegrese de instalar el archivo de biblioteca compartido de SAP (proporcionado
por SAP) y de aadirlo a la variable de entorno de la ruta de biblioteca, como se indica a continuacin:

Solaris
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<librfccm.so_directory>
Gua de instalacin y configuracin 209

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin

HP-UX
SHLIB_PATH=$SHLIB_PATH:<librfccm.sl_directory>

AIX
LIBPATH=$LIBPATH:<librfc.a_directory>

Para utilizar SAP y configurar un inicio de sesin nico, siga estos pasos:

Configure los componentes de IBM Cognos 8 para que utilicen un espacio de nombre de SAP.

Habilite el inicio de sesin nico entre SAP y los componentes de IBM Cognos 8.

Configuracin de un espacio de nombre de SAP


Puede configurar los componentes de IBM Cognos 8 para utilizar un servidor SAP como origen de
autenticacin.

Pasos
1. En el equipo en el que haya instalado Content Manager, abra IBM Cognos Configuration.
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba un nombre para el espacio de nombre de autenticacin.
4. En la lista Tipo, haga clic en SAP y, a continuacin, en Aceptar.
El nuevo recurso proveedor de autenticacin aparece en la ventana Explorador, bajo el componente Autenticacin.
5. En la ventana Propiedades, especifique para la propiedad ID de espacio de nombre un identificador exclusivo para el espacio de nombre.
Sugerencia: No utilice los dos puntos (:) en la propiedad ID de espacio de nombre.
6. Especifique los valores de todas las propiedades necesarias para asegurarse de que los componentes de IBM Cognos 8 puedan localizar y utilizar el proveedor de autenticacin existente.
En funcin del entorno, es posible que para la propiedad Host tenga que aadir la cadena del
enrutador SAP al nombre de host de SAP.
7. Si el sistema SAP codifica el contenido de las cookies, habilite la funcin para descodificar vales:

En la ventana Propiedades para Propiedades avanzadas, haga clic en el Valor y, a continuacin, en el botn de edicin.

Haga clic en Aadir.

Introduzca el nombre URLDecodeTickets y el valor true.

Haga clic en Aceptar.

El espacio de nombre de SAP descodificar todos los vales de inicio de sesin de SAP antes de
establecer una conexin.

210 PowerPlay

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
8. En el men Archivo, haga clic en Guardar.
9. Pruebe la conexin con un nuevo espacio de nombre. En la ventana Explorador, en Autenticacin, haga clic con el botn derecho en el nuevo recurso de autenticacin y haga clic en Probar.

Habilitacin del inicio de sesin nico entre SAP e IBM Cognos 8


Puede habilitar el inicio de sesin nico entre SAP Enterprise Portal y los componentes de IBM
Cognos 8, adems de al utilizar la funcin del espacio de nombre externo de las conexiones de
orgenes de datos SAP BW. Para hacerlo, asegrese de establecer los siguientes parmetros del sistema
en el servidor SAP BW.

login/accept_sso2_ticket = 1

login/create_sso2_ticket = 1

login/ticket_expiration_time = 200

Cmo probar los espacios de nombre


Despus de configurar uno o varios espacios de nombre nuevos para los componentes de IBM
Cognos 8, puede probar los espacios de nombre. La prueba se puede producir antes o despus de
iniciar el servicio de IBM Cognos 8. Puede probar todos los espacios de nombre al mismo tiempo,
o de manera individual.

Paso para probar todos los espacios de nombre

En la ventana Explorador, haga clic con el botn derecho en Autenticacin y haga clic en Probar.
Los componentes de IBM Cognos 8 cargan, inicializan y configurar las bibliotecas del proveedor
de un espacio de nombre antes de probar el siguiente espacio de nombre.
Sugerencia: Para cancelar una prueba de espacio de nombre, haga clic en Cancelar. La prueba
se detiene cuando la prueba del espacio de nombre actual finaliza.

Paso para probar un espacio de nombre nico

En la ventana Explorador, en Autenticacin, haga clic con el botn derecho en el nuevo recurso
de autenticacin y haga clic en Probar.
Los componentes de IBM Cognos 8 cargan, inicializan y configuran las bibliotecas del proveedor
del espacio de nombre.

Eliminacin de un proveedor de autenticacin


Puede eliminar los espacios de nombres que ha aadido y ya no necesite o quitar la configuracin
de los espacios de nombres detectados por los componentes de IBM Cognos 8.
No debe eliminar el espacio de nombre de Cognos. Contiene datos de autenticacin que pertenecen
a todos los usuarios y es necesario para guardar la configuracin.

Gua de instalacin y configuracin 211

Captulo 10: Configuracin de los componentes de IBM Cognos 8 para utilizar un proveedor de autenticacin
Si elimina un espacio de nombre, no podr volver a iniciar sesin en l. Los datos de seguridad del
espacio de nombre se mantienen en Content Manager hasta que se eliminan de manera permanente
en el portal. Para obtener ms informacin, consulte la Gua de administracin y seguridad.

Pasos
1. Abra Cognos Configuration en cada una de las ubicaciones en las que haya instalado Content
Manager.
2. En la ventana Explorador, en Seguridad, Autenticacin, haga clic con el botn derecho en el
espacio de nombre y haga clic en Eliminar.
3. Haga clic en S para confirmar.
El espacio de nombre desaparece de la ventana Explorador y no se puede volver a iniciar la
sesin en el espacio de nombre de dicho equipo.
4. En el men Archivo, haga clic en Guardar.
5. Repita los pasos del 1 al 4 para cada uno de los equipos donde haya instalado Content Manager.
Ahora, debe iniciar la sesin en el portal y eliminar de manera permanente los datos del espacio
de nombre. Para obtener ms informacin, consulte la Gua de administracin y seguridad.
Despus de eliminar un espacio de nombre, aparecer como Inactivo en el portal.

212 PowerPlay

Captulo 11: Opciones de configuracin


Despus de configurar IBM Cognos 8 PowerPlay para utilizar uno o varios proveedores de autenticacin, puede personalizarlo ms en su entorno.
Para cambiar los valores de tiempo de ejecucin de IBM Cognos 8 PowerPlay, utilice IBM Cognos
Administration, al que se accede a travs del portal de IBM Cognos 8. Por ejemplo, puede habilitar
o deshabilitar distribuidores y servicios o configurar permisos para usuarios, grupos y roles. Para
obtener ms informacin, consulte la Gua de administracin y seguridad. Tambin puede configurar
las opciones de migracin y de informes y cubos de PowerPlay. Para obtener ms informacin,
consulte la Gua de migracin y administracin.
Utilice la lista de comprobacin siguiente como gua para realizar las tareas para personalizar IBM
Cognos 8 PowerPlay.

Cambiar la configuracin predeterminada

Cambiar la configuracin del servicio de migracin de IBM Cognos Series 7

Asignar una cuenta de usuario a los servicios de migracin y PowerPlay para la migracin

Definir una cuenta de inicio de sesin de usuario para el servicio IBM Cognos 8 en varios
equipos

Crear un nuevo almacn de contenido mediante la base de datos de contenido de Cognos.

Aadir seguridad a sus comunicaciones con el protocolo Secure Sockets Layer (SSL)

Aadir destinos a mensajes de registro

Realizar cambios de forma global para el idioma, las fuentes, la moneda, las zonas horarias,
la codificacin del correo electrnico y el dominio de cookies

Configurar el enrutador para probar si un distribuidor est disponible, en caso de que sea
necesario

Cambiar a una puerta de enlace ISAPI, Apache o servlet para el servidor Web

Cambiar el protocolo de la direccin IP

Cambio de los valores de configuracin predeterminados


Al instalar componentes de IBM Cognos 8, en la instalacin se utilizan los valores de configuracin
predeterminados. Si por alguna razn no desea utilizar estos valores predeterminados, por ejemplo
porque otro proceso utiliza un puerto, utilice IBM Cognos Configuration para cambiar el valor.
Si cambia el valor de una propiedad, debe guardar la configuracin y reiniciar el servicio IBM
Cognos 8 para aplicar la nueva configuracin en su equipo.

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

213

Captulo 11: Opciones de configuracin


En instalaciones distribuidas, asegrese de que ha configurado todos los equipos en los que instal
Content Manager antes de cambiar los valores de configuracin predeterminados en otros equipos
IBM Cognos. Por ejemplo, puede:

Cambiar el usuario y la contrasea predeterminados de la base de datos de contenido de Cognos.

Cambiar la base de datos de notificaciones.

Cambiar un URI.

Configurar valores criptogrficos.

Configurar los componentes de IBM Cognos 8 para que utilicen IBM Cognos Application
Firewall.

Configurar las propiedades de archivos temporales.

Configurar la puerta de enlace para utilizar un espacio de nombre.

Habilitar y deshabilitar servicios.

Especificar la cantidad de recursos que utiliza el servicio IBM Cognos 8.

Configurar fuentes.

Configurar la compatibilidad con chino simplificado.

Cambiar la fuente predeterminada de los informes.

Configurar fuentes incrustadas para informes PDF.

Guardar la salida del informe en un sistema de archivos.

Cambio del usuario y la contrasea predeterminados de la base de datos de contenido de Cognos


Si instala la base de datos de contenido de Cognos, se asigna un identificador de usuario y una
contrasea a la base de datos predeterminada que se crea. Se recomienda cambiar este identificador
de usuario y esta contrasea.
Las tareas de administracin de la base de datos de contenido de Cognos se realizan con una utilidad
llamada ij. Para obtener informacin acerca de esta utilidad, consulte la documentacin de Apache
Derby. La documentacin est disponible en el directorio ubicacin_c8\derby10.1.2.1\docs en el
que ha instalado la base de datos de contenido de Cognos.

Pasos para cambiar la contrasea de usuario predeterminada


1. En el equipo en el que ha instalado la base de datos de contenido de Cognos, vaya al directorio
ubicacin_c8\derby10.1.2.1\bin.
2. Inicie la utilidad ij mediante el archivo de script ij.bat o ij.ksh.
La utilidad ij es una utilidad de lnea de comandos que sirve para crear y administrar la base
de datos de contenido de Cognos.
3. Conctese a la base de datos predeterminada escribiendo el comando de la utilidad ij siguiente:
214 PowerPlay

Captulo 11: Opciones de configuracin


connect 'jdbc:derby://localhost:1527/cm;user=cognos;password=cognos';
Si ha cambiado el nmero de puerto predeterminado 1527, utilice el nmero de puerto correcto
para la base de datos de contenido de Cognos.
La base de datos predeterminada se llama cm. El nombre de la base de datos distingue entre
maysculas y minsculas.
4. Cambie la contrasea predeterminada para el usuario cognos escribiendo el comando de la
utilidad ij siguiente:
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.user.cognos', 'NewPassword');
La nueva contrasea debe utilizarse para la siguiente conexin a la base de datos.
5. Cierre la utilidad ij escribiendo el comando siguiente:
disconnect;

Pasos para crear un usuario y una contrasea nuevos


1. En el equipo en el que ha instalado la base de datos de contenido de Cognos, vaya al directorio
ubicacin_c8\derby10.1.2.1\bin.
2. Inicie la utilidad ij mediante el archivo de script ij.bat o ij.ksh.
3. Conctese a la base de datos predeterminada escribiendo el comando de la utilidad ij siguiente:
connect 'jdbc:derby://localhost:1527/cm;user=cognos;password=cognos';
Si ha cambiado el nmero de puerto predeterminado 1527, utilice el nmero de puerto correcto
para la base de datos de contenido de Cognos.
La base de datos predeterminada se llama cm. El nombre de la base de datos distingue entre
maysculas y minsculas.
4. Cree un nuevo usuario escribiendo el comando de la utilidad ij siguiente:
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.user.NewUser', 'NewUserPassword');
5. Proporcione un acceso completo a la base de datos al nuevo usuario escribiendo el comando
de la utilidad ij siguiente:
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY ('derby.database.fullAccessUsers','cognos, NewUser');
La propiedad que est cambiando, la lista de usuarios, es un campo delimitado por comas. En
este paso, va a incluir el nuevo usuario en la lista de usuarios con acceso completo. El usuario
predeterminado, cognos, sigue formando parte de la lista de usuarios con acceso completo.
Puede eliminar el usuario cognos.
6. Cierre la utilidad ij escribiendo el comando siguiente:

Gua de instalacin y configuracin 215

Captulo 11: Opciones de configuracin


disconnect;

Pasos para eliminar un usuario


1. En el equipo en el que ha instalado la base de datos de contenido de Cognos, vaya al directorio
ubicacin_c8\derby10.1.2.1\bin.
2. Inicie la utilidad ij mediante el archivo de script ij.bat o ij.ksh.
3. Conctese a la base de datos predeterminada escribiendo el comando de la utilidad ij siguiente:
connect 'jdbc:derby://localhost:1527/cm;user=NewUser; password=NewUserPassword';
4. Seleccione la clase de usuario que desea eliminar:

Para eliminar un usuario de la lista de usuarios con acceso completo, escriba el comando
de la utilidad ij siguiente:
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY ('derby.database.fullAccessUsers', 'NewUser');
Se omite el nombre de usuario de la lista de usuarios con acceso completo. Por ejemplo, el
comando anterior elimina el usuario cognos predeterminado y mantiene el nuevo usuario
que acaba de crear.

Para eliminar un usuario de la base de datos, escriba el comando de la utilidad ij siguiente


y omita la contrasea de usuario:
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY('derby.user.cognos', '');
Este comando elimina la contrasea del usuario cognos predeterminado y elimina tambin
el usuario de la base de datos.

5. Cierre la utilidad ij escribiendo el comando siguiente:


disconnect;

Cmo cambiar la base de datos de notificaciones


De manera predeterminada, el servidor de notificaciones utiliza la misma base de datos que Content
Manager utiliza para el almacn de contenido. Puede utilizar una base de datos independiente para
las notificaciones en situaciones en las que se ejecutan grandes volmenes de informes por lotes y
correo electrnico.
Utilizar una base de datos independiente para las notificaciones implica las siguientes tareas:

Cree una base de datos de notificaciones.


Para DB2, Oracle, Microsoft SQL Server o Sybase, utilice el mismo procedimiento que se utiliz
para crear la base de datos del almacn de contenido, "Directrices para la creacin del almacn
de contenido" (p. 43).
Para DB2 en z/OS, siga las instrucciones de "Configuracin recomendada para crear una base
de datos de notificaciones DB2 en z/OS" (p. 217).

216 PowerPlay

Captulo 11: Opciones de configuracin

Configure la conectividad de la base de datos. Puede utilizar el mismo procedimiento que para
configurar la conectividad de la base de datos del almacn de contenido, "Configuracin de la
conectividad de la base de datos para la base de datos del almacn de contenido" (p. 87).

Cambie las propiedades de conexin de la base de datos de notificaciones.

Configuracin recomendada para crear una base de datos de notificaciones DB2 en z/OS
La base de datos que vaya a crear para la base de datos de notificaciones debe incluir algunos
valores de configuracin recomendados.
Para garantizar una instalacin correcta, siga estas directrices durante la creacin de la base de
datos de notificaciones.
Utilice la siguiente lista de comprobacin para configurar la base de datos de notificaciones en DB2
en z/OS.

Cree una instancia de base de datos, un grupo de almacenamiento y una cuenta de usuario para
la base de datos de notificaciones.
El usuario debe disponer de permisos para crear y eliminar tablas en la base de datos.
IBM Cognos 8 utiliza las credenciales de la cuenta de usuario para comunicarse con el servidor
de la base de datos.

Asegrese de que reserva un grupo de bferes con un tamao de pgina de 32 kB y un segundo


grupo con un tamao de pgina de 4 kB para la instancia de la base de datos.

Los administradores deben ejecutar un script para crear espacios de tabla que puedan contener
objetos de gran tamao y otros datos para que la base de datos de notificaciones utilice los
espacios de tabla. Para obtener ms informacin sobre cmo ejecutar el script, consulte
"Creacin de espacios de tabla para la base de datos de notificaciones DB2 en z/OS" (p. 217).

El administrador de la base de datos debe realizar una copia de seguridad de las bases de datos
de IBM Cognos 8 con regularidad, ya que contienen los datos de IBM Cognos. Para garantizar
la seguridad y la integridad de las bases de datos, protjalas frente a accesos no autorizados o
inapropiados.

Creacin de espacios de tabla para la base de datos de notificaciones DB2 en z/OS


El administrador de la base de datos debe ejecutar un script para crear un conjunto de espacios de
tabla necesarios en la base de datos de notificaciones. El script debe modificarse para sustituir los
parmetros de marcador por otros que sean apropiados al entorno.
Asegrese de que utiliza las convenciones de nomenclatura para DB2 en z/OS. Por ejemplo, todos
los nombres de parmetros deben comenzar por una letra y no deben tener ms de ocho caracteres.
Para obtener ms informacin, consulte el centro de informacin DB2 de IBM.

Pasos
1. Mediante una herramienta de acceso remoto, establezca conexin con la base de datos como
un usuario con privilegios para crear y descartar espacios de tabla y permitir la ejecucin de
las sentencias SQL.

Gua de instalacin y configuracin 217

Captulo 11: Opciones de configuracin


2. Abra el archivo de script NC_TABLESPACES.sql y use la siguiente tabla, que le ayudar a
reemplazar los parmetros de marcador por los valores apropiados para el entorno.
No todos los parmetros enumerados se encuentran en el script, pero se pueden aadir en el
futuro.

Nombre de parmetro Descripcin


NCCOG

Especifica el nombre de la base de datos de notificaciones.

DSN8G810

Especifica el nombre del grupo de almacn.

BP32K

Especifica el nombre del grupo de bferes.

3. Guarde y ejecute el script en la herramienta de acceso remoto.


Se crear la base de datos de notificaciones. Ahora puede modificar la base de datos de notificaciones
en IBM Cognos Configuration (p. 218).

Cambio de las propiedades de conexin de la base de datos de notificaciones


Despus de crear una base de datos independiente para las notificaciones, debe configurar IBM
Cognos 8 de tal modo que utilice la nueva base de datos.
Debe configurar todos los Content Manager y los componentes de nivel de aplicacin de tal modo
que utilicen la misma base de datos de notificaciones.

Pasos
1. Inicie IBM Cognos Configuration en cada una de las ubicaciones en las que Content Manager
o los componentes de nivel de aplicacin estn instalados.
2. En la ventana del Explorador, en Acceso a datos, haga clic en Notificacin.
3. Identificacin de la base de datos que se usa para las notificaciones:

En la ventana Explorador, haga clic con el botn derecho en Notificacin y seleccione


Nuevo recurso, Base de datos.

Escriba un nombre para el recurso de base de datos.

Seleccione el tipo de base de datos desde el men desplegable.

Haga clic en Aceptar.

4. En la ventana Propiedades, introduzca los valores para el recurso de base de datos de notificaciones.
5. En el men Archivo, haga clic en Guardar.
6. Pruebe la notificacin. En la ventana del Explorador, haga clic con el botn derecho en Notificacin y, a continuacin, haga clic en Probar.
Cognos 8 prueba la conexin con la base de datos y con el servidor de correo.
218 PowerPlay

Captulo 11: Opciones de configuracin


Si ha estado utilizando la base de datos de contenido para las notificaciones, las planificaciones
se replicarn en las tablas de la nueva base de datos de notificaciones.
Importante: Asegrese de que los valores utilizados para identificar el recurso de la base de datos
de notificaciones sean los mismos en todos los equipos de Content Manager y de componentes de
nivel de aplicacin. Para utilizar la base de datos predeterminada de notificaciones, no es necesario
que edite los valores de la ventana Propiedades.

Cambio de un URI
Puede cambiar ciertos elementos de un URI en funcin de su entorno. Un URI de IBM Cognos
contiene los elementos siguientes:

En un URI de Content Manager, URI de distribuidor para aplicaciones externas o URI de distribuidor
protocolo://nombre_host_o_IP:puerto/raz_contexto/ruta_alias

En un URI de puerta de enlace o un URI de contenido Web


protocolo://nombre_host_o_IP:puerto/directorio_virtual/aplicacin_puerta_enlace
O BIEN
protocolo://nombre_host_o_IP:puerto/raz_contexto/ruta_alias

Elemento Ejemplos

Descripcin

protocolo

http o https

Especifica el protocolo utilizado para solicitar y transmitir


informacin; puede ser protocolo de transferencia de hipertexto (HTTP) o protocolo seguro de transferencia de hipertexto (HTTPS).

nombre de
host o IP

localhost o
192.168.0.1

Especifica la identidad del host en la red. Puede utilizar una


direccin IP, un nombre de equipo o un nombre de dominio
completo.
En una instalacin distribuida, debe cambiar el elemento
localhost de un URI.
En un entorno mixto de servidores UNIX y Windows, asegrese de que todos los servidores del entorno pueden resolver
los nombres de host en direcciones IP.

puerto

9300 u 80

Especifica el puerto en el que el sistema host atiende las solicitudes.


El puerto predeterminado para Tomcat es 9300. El puerto
predeterminado para un servidor Web es 80.

Gua de instalacin y configuracin 219

Captulo 11: Opciones de configuracin

Elemento Ejemplos

Descripcin

raz de con- p2pd


texto

Tomcat o un servidor de aplicaciones la utilizan para determinar el contexto de la aplicacin para que la solicitud pueda
enrutarse a la aplicacin Web correcta para su procesamiento.

ruta de
acceso del
alias

servlet/dispatch

El servidor de aplicaciones la utiliza para enrutar una solicitud


al componente correcto de una aplicacin Web.

directorio
virtual

cognos8/

La ruta de acceso del alias no debe modificarse, ya que sino


los componentes de IBM Cognos 8 no funcionarn adecuadamente.
El servidor Web lo utiliza para asignar un alias o un directorio
virtual a una ubicacin fsica.
Por ejemplo, en el URI de puerta de enlace predeterminado
de http://localhost:80/cognos8/cgi-bin/cognos.cgi, el directorio
virtual es cognos8/cgi-bin.

aplicacin cognos.cgi
de la puerta
de enlace

Especifica el nombre de la aplicacin de la puerta de enlace


de IBM Cognos que se utiliza.
Por ejemplo, si va a acceder a los componentes de IBM Cognos
8 mediante una interfaz de puerta de enlace comn (CGI), la
aplicacin predeterminada de la puerta de enlace ser cognos.
cgi.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, haga clic en el grupo o el componente pertinente:

Para cambiar un elemento para el distribuidor, haga clic en Entorno.

Para cambiar un elemento para el servidor de registro local, en Entorno, haga clic en
Registro.

3. En la ventana Propiedades, haga clic en el cuadro Valor que se encuentra junto a la propiedad
de URI que desea cambiar.
4. Seleccione el elemento e introduzca la nueva informacin.
Sugerencia: Para cambiar el puerto utilizado por el distribuidor local, cambie el valor de la
propiedad de URI del distribuidor interno. Dado que el cambio afecta a todos los URI basados
en el distribuidor local, debe cambiar los URI de todos los componentes locales.
Sugerencia: Si cambia el puerto del distribuidor en el URI de distribuidor, asegrese de especificar el nuevo nmero de puerto al configurar equipos remotos que utilizan el distribuidor,
Content Manager o servicios SDK en este sistema.

220 PowerPlay

Captulo 11: Opciones de configuracin


5. En el men Archivo, haga clic en Guardar.

Configuracin de valores criptogrficos


Los componentes de IBM Cognos 8 requieren un proveedor criptogrfico; de lo contrario, no se
ejecutarn. Si elimina el proveedor criptogrfico predeterminado, debe configurar otro proveedor
para sustituirlo.
Puede configurar valores del proveedor criptogrfico, como los siguientes:

Algoritmos avanzados
Entre los algoritmos avanzados se incluyen los algoritmos de firma y de compendio.

Propiedades del almacn de claves simtricas comunes (CSK)


IBM Cognos 8 utiliza la clave CSK para codificar y descodificar datos.

Propiedades del almacn de claves de firma


El par de claves de firma incluye la clave privada utilizada para generar la firma digital y la
clave pblica utilizada para verificar la autenticidad.

Propiedades del almacn de claves de codificacin


El par de claves de codificacin incluye la clave privada utilizada para codificar datos y la clave
pblica utilizada para descodificar datos.

El proveedor criptogrfico predeterminado utiliza claves con una longitud de hasta 56 bits para la
codificacin de datos y el protocolo Secure Sockets Layer (SSL). Puede configurar otros proveedores
criptogrficos que utilicen tamaos de clave superiores a 56 bits, como el mdulo Enhanced
Encryption Module para OpenSSL, disponible si se solicita. Para obtener ms informacin, consulte
Enhanced Encryption Module for OpenSSL Installation and Configuration Guide.
Importante: En una instalacin distribuida, los equipos IBM Cognos se comunican con Content
Manager para determinar la confianza y obtener algunas claves criptogrficas de Content Manager.
Si cambia las claves criptogrficas de Content Manager, por ejemplo cambiando los servidores de
aplicaciones o volviendo a instalar Content Manager, debe eliminar las claves criptogrficas de los
otros equipos IBM Cognos. A continuacin, debe guardar la configuracin en todos los equipos
para que obtengan las nuevas claves criptogrficas de Content Manager. Adems, todos los componentes de IBM Cognos 8 que se encuentran en una instalacin distribuida deben configurarse con
los mismos valores de proveedor criptogrfico.
Asimismo, en un entorno distribuido, la clave simtrica slo debe almacenarse en equipos en los
que se haya instalado Content Manager.

Pasos para la configuracin de valores criptogrficos


1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, en Seguridad, haga clic en Criptografa.
3. En la ventana Propiedades, cambie los valores predeterminados haciendo clic en el cuadro Valor
y seleccionando el valor adecuado:

Gua de instalacin y configuracin 221

Captulo 11: Opciones de configuracin

En equipos que no tienen Content Manager, si no desea almacenar las claves CSK localmente, vaya a Configuracin CSK y cambie Almacenar clave simtrica localmente a Falso.
Si Almacenar clave simtrica localmente es Falso, la clave se recupera de Content Manager
cuando es necesario. Se ignora la propiedad Ubicacin del almacn de claves simtricas
comunes.

Si desea que los equipos a cada extremo de una transmisin prueben su identidad, en
Configuracin de SSL, cambie Utilizar autenticacin mutua a Verdadero.
Se recomienda no cambiar la configuracin Utilizar confidencialidad.

Si desea cambiar el algoritmo de compendio, seleccione otro valor para la propiedad


Algoritmo de compendio.

4. En el men Archivo, haga clic en Guardar.


5. Pruebe el proveedor criptogrfico slo en un equipo de puerta de enlace. En la ventana Explorador, haga clic con el botn derecho en Criptografa y, a continuacin, haga clic en Probar.
Los componentes de IBM Cognos 8 comprueban la disponibilidad de la clave simtrica.
Tras configurar el proveedor criptogrfico, se codifican las contraseas de su configuracin y todos
los datos que cree.

Pasos para el proveedor criptogrfico


1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, en Seguridad, Criptografa, haga clic en Cognos.

Si desea cambiar la ubicacin de las claves de firma, en Configuracin de claves de firma,


cambie la propiedad Ubicacin del almacn de claves de firma a la nueva ubicacin.

Si desea cambiar la ubicacin de las claves de codificacin, en Configuracin de claves de


codificacin, cambie Ubicacin del almacn de claves de codificacin a la nueva ubicacin.

Si desea utilizar una entidad emisora de certificados de terceros, en Configuracin de la


entidad emisora de certificados, cambie Utilizar entidad emisora de certificados de terceros
a Verdadero.
Tambin debe asegurarse de que utiliza para el parmetro -k los mismos valores que ha
utilizado para las propiedades Ubicacin del almacn de claves de firma y Ubicacin del
almacn de claves de codificacin.
Para obtener ms informacin, consulte "Configuracin de los componentes de IBM Cognos
8 para utilizar otra entidad emisora de certificados" (p. 310).

Importante: El valor del Algoritmo de confidencialidad determina el modo en el que los componentes de IBM Cognos 8 codifican los datos. Por ejemplo, las contraseas de las bases de
datos introducidas en IBM Cognos Configuration se codifican al guardar la configuracin. El
algoritmo seleccionado en el momento en el que se codifican los datos tambin debe estar disponible para que los datos puedan descodificarse posteriormente.

222 PowerPlay

Captulo 11: Opciones de configuracin


La disponibilidad de los algoritmos de confidencialidad puede cambiar si se realizan modificaciones en su entorno. Por ejemplo, si ha cambiado el entorno en tiempo de ejecucin de Java
(JRE) o si ha instalado software criptogrfico en el equipo. Si ha realizado cambios en un
equipo, como la actualizacin del JRE o la instalacin de software que ha actualizado el JRE,
la disponibilidad de los algoritmos de confidencialidad puede verse afectada. Debe asegurarse
de que el Algoritmo de confidencialidad que se seleccion cuando se codificaron los datos
tambin est disponible cuando desea acceder a los datos.
3. En el men Archivo, haga clic en Guardar.
Si utiliza un servidor de entidad emisora de certificados (CA) de terceros, debe configurar ahora
los componentes de IBM Cognos 8 para que utilicen la CA.

Configuracin de componentes de IBM Cognos 8 para que utilicen IBM Cognos


Application Firewall
IBM Cognos Application Firewall analiza y valida solicitudes HTTP y XML antes de que los servidores IBM Cognos las procesen. IBM Cognos Application Firewall puede modificar estas solicitudes
HTTP y XML.
IBM Cognos Application Firewall protege los productos Web de IBM Cognos frente a datos
malintencionados. Las formas ms comunes de datos malintencionados son los desbordamientos
del bfer y los ataques cross-site scripting (XSS), ya sea a travs de la insercin de scripts en pginas
vlidas o la redireccin a otro sitio Web.
Mediante IBM Cognos Configuration, puede cambiar la configuracin para la compatibilidad con
la herramienta XSS de terceros y puede aadir nombres de host y de dominio a la lista de nombres
vlidos de IBM Cognos.
Puede realizar un seguimiento de la actividad del servidor de seguridad consultando el archivo de
registro, que contiene las solicitudes rechazadas. De forma predeterminada, los mensajes de registro
se almacenan en el archivo ubicacin_c8\logs\cogserver.log.
Importante: La configuracin CAF debe coincidir para todos los equipos en los que los componentes
de nivel de aplicacin de IBM Cognos 8 estn instalados en un entorno distribuido. Por ejemplo,
si CAF est deshabilitado en algunos equipos y habilitado en otros, es posible que se produzca un
comportamiento inesperado y errores del producto.
La validacin CAF acepta los tipos de URL siguientes:

URL completas (absolutas)


En el formato protocolo://host:puerto/ruta, donde protocolo es http o https y host se valida
respecto a la lista de dominios vlidos.

URL relativas al directorio de instalacin Web


En el formato /raz_instalacin_Web/.* donde raz_instalacin_Web es el directorio Web de
puerta de enlace, basado en el alias cognos8 que ha configurado en el servidor Web.
Por ejemplo:
/cognos8/ps/portal/images/action_delete.gif

Gua de instalacin y configuracin 223

Captulo 11: Opciones de configuracin

URL especficas permitidas, como las siguientes (ninguna distingue entre maysculas y minsculas)
about:blank
JavaScript:window.close( )
JavaScript:parent.close( )
JavaScript:history.back( )
parent.cancelErrorPage( )
doCancel( )

Pasos
1. En todos los equipos en los que se hayan instalado componentes de nivel de aplicacin de IBM
Cognos 8, inicie IBM Cognos Configuration.
2. En la ventana Explorador, bajo Seguridad, haga clic en IBM Cognos Application Firewall.
3. En la ventana Propiedades, defina los valores adecuados para la propiedad Habilitar validacin
CAF?.
IBM Cognos Application Firewall est habilitado de forma predeterminada.
Importante: IBM Cognos Application Firewall es un componente esencial de la seguridad de
IBM Cognos y ofrece proteccin frente a las vulnerabilidades de penetracin. Si deshabilita
IBM Cognos Application Firewall, eliminar esta proteccin. En circunstancias normales, se
recomienda no deshabilitar IBM Cognos Application Firewall.
4. Si utiliza una herramienta XSS de terceros que busca caracteres especficos en los parmetros
de solicitud GET, realice lo siguiente en la ventana Propiedades:

Para la propiedad Comprobacin de XSS de terceros habilitada?, cambie el valor a Verdadero.

Para la propiedad Caracteres de XSS de terceros, aada cualquier carcter adicional que
est prohibido por la herramienta XSS de terceros. Los caracteres predeterminados son >,
< y .

5. Aada nombres de host y de dominio a la lista de nombres vlidos de IBM Cognos:

Para la propiedad Dominios o hosts vlidos, haga clic en el valor y, a continuacin, en el


botn Editar.

En el cuadro de dilogo Valor: Dominios o hosts vlidos, haga clic en Aadir.


Debe incluir los dominios de todos los hipervnculos que se han aadido en IBM Cognos
Connection. Para obtener ms informacin, consulte el tema acerca de la creacin de una
URL en la Gua de administracin y seguridad.
Sugerencias

224 PowerPlay

Captulo 11: Opciones de configuracin


Si utiliza la obtencin de detalles de IBM Cognos Series 7 en los informes de IBM Cognos
8, aada los nombres de host de los servidores de puerta de enlace de IBM Cognos Series
7 a la lista.
Aada los nombres de host de todos los equipos en una instalacin distribuida.
Si utiliza un nombre de dominio completo, como por ejemplo www.miempresa.us.com,
IBM Cognos Application Firewall rechazar las solicitudes que vayan al dominio principal,
como www.miempresa.com, salvo que se haya especificado el dominio principal.

Haga clic en la fila en blanco de la tabla e introduzca el nombre de host o de dominio.

Repita los dos pasos enumerados anteriormente para cada nombre que desee aadir.

Haga clic en Aceptar.

IBM Cognos Application Firewall valida nombres de dominio y de host para proteger las URL
que se crean. De forma predeterminada, IBM Cognos Application Firewall considera que los
nombres de dominio derivados de las propiedades de configuracin del entorno son nombres
de dominio seguros. Es til aadir nombres a la lista de nombres y hosts vlidos cuando debe
redirigir solicitudes a equipos que no son IBM Cognos mediante las funciones Atrs o Cancelar
o cuando utiliza la obtencin de detalles en diferentes instalaciones de productos IBM Cognos.
6. Guarde la configuracin.
7. Reinicie los servicios.

Configuracin de las propiedades de los archivos temporales


Puede cambiar la ubicacin en la que los componentes de IBM Cognos 8 almacenan los informes
que se han visualizado recientemente y puede optar por codificar su contenido. De forma predeterminada, los componentes de IBM Cognos 8 almacenan los archivos temporales en el directorio
ubicacin_c8\temp y los archivos no estn codificados.
Se recomienda denegar cualquier acceso al directorio temp, excepto para la cuenta de servicio que
se utiliza para iniciar el servicio IBM Cognos 8. La cuenta de servicio necesita permisos de lectura
y de escritura.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana Propiedades, especifique la nueva ubicacin para la propiedad Ubicacin de
archivos temporales.
4. Si necesita que se codifique el contenido de los archivos temporales, establezca la propiedad
Codificar archivos temporales en Verdadero.
5. Asegrese de que la cuenta de usuario en la que se ejecutan los componentes de IBM Cognos
8 tiene los privilegios adecuados para la ubicacin de archivos temporales. Por ejemplo:

En Windows, privilegios de control total

Gua de instalacin y configuracin 225

Captulo 11: Opciones de configuracin

En UNIX o Linux, privilegios de lectura/escritura

Configuracin de la puerta de enlace para utilizar un espacio de nombre


Si los componentes de IBM Cognos 8 utilizan varios espacios de nombres o si se ha habilitado el
acceso annimo y los componentes de IBM Cognos 8 utilizan un espacio de nombre, puede configurar la puerta de enlace para que se conecte a un espacio de nombre. A los usuarios que han iniciado
la sesin en el servidor Web en el que se encuentra la puerta de enlace no se les pide que elijan un
origen de autenticacin.
Por ejemplo, si tiene dos servidores Web, puede configurar cada servidor Web para que utilice un
espacio de nombre distinto.

Pasos
1. Inicie IBM Cognos Configuration en el equipo en el que se encuentra la puerta de enlace.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana Propiedades, en el cuadro Valor que se encuentra junto a la propiedad Espacio
de nombre de la puerta de enlace, introduzca el ID de espacio de nombre que desea utilizar.
4. En el men Archivo, haga clic en Guardar.
5. Reinicie el servidor Web.

Cmo habilitar y deshabilitar servicios


En una instalacin distribuida, puede enviar ciertos tipos de solicitudes a equipos especficos habilitando o deshabilitando los servicios instalados.
Por ejemplo, para que un equipo ejecute y distribuya informes, puede deshabilitar los servicios en
un equipo servidor PowerPlay.
Nota: Los valores predeterminados del servicio de distribuidor y de presentacin son falsos en los
equipos que slo tienen instalado Content Manager. En los otros tipos de instalaciones, los valores
predeterminados son verdaderos.
Si ha instalado todos los componentes en varios equipos, puede deshabilitar los servicios apropiados
en cada equipo para obtener la configuracin distribuida que necesita. Las solicitudes slo se envan
a los distribuidores en los que se ha habilitado un determinado servicio.
Al deshabilitar un servicio, se evita que el servicio se cargue en la memoria. Cuando estn deshabilitados, los servicios no se inician y, por lo tanto, no consumen recursos. El servicio no se ejecuta
hasta que lo habilita y reinicia el servicio IBM Cognos 8.
Si deshabilita el servicio de distribuidor, se deshabilitarn los servicios relacionados. Slo los servicios
de distribuidor que estn habilitados pueden procesar solicitudes.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, en Entorno, haga clic en Servicio IBM Cognos 8.

226 PowerPlay

Captulo 11: Opciones de configuracin


3. En la ventana Propiedades, haga clic en el Valor que se encuentra junto al servicio que desea
deshabilitar o habilitar.
De forma predeterminada, todos los servicios estn habilitados.
4. Haga clic en el estado adecuado de los servicios:

Para deshabilitar el servicio, haga clic en Falso.

Para habilitar el servicio, haga clic en Verdadero.

5. En el men Archivo, haga clic en Guardar.


6. En el men Acciones, haga clic en Reiniciar.

Especificacin de recursos para el servicio IBM Cognos 8


Para mejorar el rendimiento en un entorno distribuido, puede cambiar la cantidad de recursos que
utiliza el servicio IBM Cognos 8 seleccionando una plantilla de configuracin.
De forma predeterminada, el servicio IBM Cognos 8 est configurado para que utilice el mnimo
de recursos de memoria para optimizar el tiempo de inicio.
Los valores de la plantilla de configuracin slo se aplican a Tomcat, el servidor de aplicaciones
que IBM Cognos 8 utiliza de forma predeterminada. Si desea configurar IBM Cognos 8 para que
se ejecute en otro servidor de aplicaciones, no utilice IBM Cognos Configuration para configurar
los recursos. En su lugar, configure los recursos en el entorno de este servidor de aplicaciones. Para
obtener ms informacin, consulte "Configuracin de IBM Cognos 8 para un servidor de aplicaciones" (p. 287).
El servicio IBM Cognos 8 slo est disponible en los equipos en los que ha instalado Content
Manager o los componentes de nivel de aplicacin.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, en Entorno, Servicio IBM Cognos 8, haga clic con el botn derecho
en IBM Cognos 8 y, a continuacin, haga clic en Eliminar.
De este modo, se elimina la plantilla de configuracin predeterminada del servicio.
3. Haga clic con el botn derecho en Servicio IBM Cognos 8 y, a continuacin, haga clic en Nuevo
recurso, Configuracin.
4. Escriba el nombre del servicio.
En Windows, el nombre que elija se utilizar para registrar el servicio. Ver este nombre en la
lista de servicios que se ejecutan en el equipo.
5. En el cuadro Tipo, haga clic en la plantilla de configuracin que desea utilizar:

Si ha cambiado anteriormente la configuracin predeterminada, y ahora desea reducir el


tiempo de inicio, el espacio de memoria y los recursos utilizados, haga clic en Configuracin
pequea.

Gua de instalacin y configuracin 227

Captulo 11: Opciones de configuracin

Si desea equilibrar el tiempo de inicio rpido y las velocidades de funcionamiento rpidas,


haga clic en Configuracin media.

Si desea maximizar las velocidades de funcionamiento, el rendimiento es ms importante


que un tiempo de inicio rpido y su equipo tiene muchos recursos, haga clic en Configuracin
grande.

6. En la ventana Propiedades, edite las propiedades para que sean adecuadas para su entorno.
7. En el men Archivo, haga clic en Guardar.

Configuracin de las fuentes


Los componentes de IBM Cognos 8 utilizan fuentes para representar informes PDF en el servidor
de IBM Cognos. Asimismo, los componentes de IBM Cognos 8 utilizan fuentes para representar
los grficos que se utilizan en informes PDF y HTML.
Para mostrar la salida correctamente, las fuentes deben estar disponibles en el lugar en el que se
representa el informe o el grfico. En el caso de grficos e informes PDF, las fuentes deben estar
instaladas en el servidor de IBM Cognos. Si una fuente solicitada no est disponible, los componentes
de IBM Cognos 8 la sustituyen por una fuente diferente.
Dado que los informes HTML se representan en un explorador, las fuentes necesarias deben estar
instaladas en el equipo de todos los usuarios de IBM Cognos que leern el informe HTML. Si una
fuente solicitada no est disponible, el explorador la sustituye por una fuente distinta.
Si desea utilizar una nueva fuente en los informes, debe:

Aadir la fuente a la lista de fuentes admitidas

Especificar la ubicacin de archivo de la nueva fuente

Asignar la nueva fuente al nombre de fuente fsica si es necesario

Adicin de fuentes al entorno de IBM Cognos


Puede aadir fuentes a la lista de fuentes admitidas en su entorno de IBM Cognos si desea generar
informes que utilicen fuentes que no estn disponibles actualmente. Asimismo, puede eliminar
fuentes.
De forma predeterminada, los componentes de IBM Cognos 8 utilizan un conjunto de fuentes globales, que estn disponibles en todos los equipos servidores IBM Cognos.

Pasos
1. Inicie IBM Cognos Configuration en todos los equipos Content Manager.
2. En el men Acciones, haga clic en Editar la configuracin global.
3. Haga clic en la pestaa Fuentes.
4. Haga clic en Aadir.
Sugerencia: Para eliminar una fuente de la lista de fuentes admitidas, haga clic en el cuadro que
se encuentra junto al nombre de fuente y, a continuacin, haga clic en Eliminar.
228 PowerPlay

Captulo 11: Opciones de configuracin


5. En el cuadro Nombre de fuente compatible, escriba el nombre de la fuente y haga clic en
Aceptar.
6. En el men Archivo, haga clic en Guardar.
Todas las fuentes globales, incluidas las fuentes nuevas que aada, deben estar instaladas en
todos los equipos IBM Cognos de su entorno.
Si una fuente global no est instalada en todos los equipos IBM Cognos, debe asignar la fuente
global a una fuente fsica instalada.

Especificacin de la ubicacin de las fuentes disponibles


Debe especificar la ubicacin de instalacin de todas las fuentes, incluidas las fuentes que aade a
la lista de fuentes admitidas.
De forma predeterminada, la lista de fuentes contiene las fuentes instaladas en el directorio ubicacin_c8\bin\fonts del equipo IBM Cognos. Si los componentes de IBM Cognos 8 estn instalados
en un equipo con Windows, tambin utilizarn las fuentes instaladas en el directorio de fuentes de
Windows.
Debe especificar la ubicacin de las fuentes en todos los equipos en los que se han instalado los
componentes de nivel de aplicacin.

Pasos
1. Inicie IBM Cognos Configuration en todos los equipos con componentes de nivel de aplicacin.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana Propiedades, para la propiedad Ubicaciones fsicas de fuentes, especifique la
ubicacin de las fuentes.
Si existen varias rutas de acceso a las fuentes, separe cada ruta de acceso con un punto y coma
(;).
Si utiliza un servidor de aplicaciones distinto a Tomcat, introduzca la ruta de acceso completa
de la ubicacin de las fuentes. Por ejemplo: ubicacin_c8/bin/fonts.
4. En el men Archivo, haga clic en Guardar.

Asignacin de fuentes admitidas a fuentes instaladas


Puede sustituir fuentes globales, que no estn instaladas en el equipo, por fuentes fsicas.
Asigne fuentes en todos los equipos en los que el servidor de informes est instalado.
Por ejemplo, aade una fuente que no est instalada en el equipo IBM Cognos a la lista de fuentes
admitidas. Puede especificar qu fuente debe utilizarse como sustituta.
Si desea imprimir informes de un modo ms rpido utilizando las fuentes PDF incorporadas, puede
asignar una fuente global como Arial a una de las fuentes PDF incorporadas, como Helvetica-PDF;
para ello, siga los pasos que figuran a continuacin. Asimismo, puede seleccionar una de las fuentes
PDF incorporadas para un objeto de texto en Report Studio o Query Studio. Para obtener ms
informacin, consulte Query Studio Gua del usuario o Report Studio Professional Authoring Gua
del usuario.
Gua de instalacin y configuracin 229

Captulo 11: Opciones de configuracin


No es necesario realizar ninguna asignacin si aade una fuente a la lista de fuentes admitidas que
est instalada en los equipos IBM Cognos. Sin embargo, debe especificar la ubicacin de la fuente.

Pasos
1. Inicie IBM Cognos Configuration en todos los equipos con componentes de nivel de aplicacin.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana Propiedades, haga clic en el cuadro Valor que se encuentra junto a la propiedad
Asignacin de fuentes fsicas y, a continuacin, haga clic en el botn Editar.
Aparecer el cuadro de dilogo Valor: Asignacin de fuentes fsicas.
4. Haga clic en Aadir.
Sugerencia: Para eliminar una fuente, seleccione la casilla de verificacin situada al lado de la
fuente y haga clic en Eliminar.
5. En el cuadro Nombre de fuente global, escriba el nombre de la fuente que ha aadido a la lista
de fuentes admitidas.
6. Haga clic en el cuadro Nombre de fuente fsica.
7. Si conoce el nombre de la fuente fsica, escrbalo. De lo contrario, haga clic en el botn Editar.
En el cuadro de dilogo Nombre de fuente fsica, haga clic en Buscar ahora y, a continuacin,
en un nombre de fuente que aparece en los resultados.
8. Repita los pasos del 4 al 7 para cada fuente global que requiere una asignacin.
9. Haga clic en Aceptar.
10. En el men Archivo, haga clic en Guardar.
Ahora, si es necesario, debe especificar la ubicacin de instalacin de las fuentes.

Consideraciones sobre compatibilidad con chino simplificado


Los productos IBM Cognos 8 son compatibles con el juego de caracteres GB18030-2000, el cual
se usa en la codificacin de las configuraciones regionales del chino simplificado. Si instala en
Windows, la compatibilidad viene proporcionada por el juego de caracteres GB18030-2000 en la
fuente NSimSun-18030 que Microsoft proporciona. Si instala en otros sistemas operativos, o si usa
Internet Explorer 6 en Windows, se necesitan tareas de instalacin adicionales:

En sistemas operativos distintos de Windows, debe instalar una fuente compatible con GB180302000.

Si usa Internet Explorer 6 en Windows, debe actualizar las entradas del registro para las fuentes
que hagan referencia a SimSun.

Actualizacin de las entradas del registro para vinculacin de fuentes de Windows


El juego de caracteres GB18030-2000 incluye caracteres CJK Unified Ideographs Extension A.
Cuando estos caracteres estn codificados como UTF-8 en Internet Explorer 6, puede que no apa-

230 PowerPlay

Captulo 11: Opciones de configuracin


rezcan correctamente en las pginas Web. Para asegurarse de que estos caracteres aparecen correctamente, debe agregar SimSun-18030 a todas las entradas del registro de vnculos de fuentes que
especifiquen SimSun.

Pasos
1. En el men Inicio, seleccione Ejecutar.
2. En el cuadro de dilogo Ejecutar, escriba regedit.
3. Abra el directorio HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\
CurrentVersion\FontLink\SystemLink.
4. En Editor del Registro, haga clic con el botn derecho en una fuente que contenga SimSun en
el campo Datos y seleccione Modificar.
5. En el cuadro de dilogo Edit Multi-String, en Informacin del valor, haga clic en las cadenas
seleccionadas y escriba la siguiente cadena:
SimSun18030.ttc,SimSun-18030
6. Haga clic en Aceptar.
7. Repita los pasos 4 a 6 con cada fuente que contenga SimSun.
8. Cuando haya terminado, cierre el Editor del Registro.

Cambio de la fuente predeterminada para informes PDF


Puede cambiar la fuente predeterminada que utilizan los componentes de IBM Cognos 8 para los
informes PDF. Puede ver esta fuente predeterminada al abrir un informe.
La fuente predeterminada se cambia en el equipo en el que est instalado Content Manager. Una
vez realizado el cambio, la fuente se convierte en la predeterminada para todos los equipos de su
instalacin. Puede cambiar la fuente que se utiliza para los informes PDF mediante IBM Cognos
Configuration.
Asegrese de que la fuente predeterminada est instalada en todos los equipos de su instalacin
IBM Cognos.

Pasos
1. Inicie IBM Cognos Configuration en todos los equipos Content Manager.
2. En el men Acciones, haga clic en Editar la configuracin global.
3. Haga clic en la pestaa General.
4. En el cuadro Valor, para Fuente predeterminada, introduzca la fuente que desea utilizar como
predeterminada para los informes.
5. Haga clic en Aceptar.
6. En el men Archivo, haga clic en Guardar.

Gua de instalacin y configuracin 231

Captulo 11: Opciones de configuracin


7. En todos los equipos con componentes de nivel de aplicacin, asegrese de que la ubicacin de
instalacin de la fuente predeterminada est especificada en la propiedad Ubicaciones fsicas
de fuentes (en Entorno, en la ventana Explorador) o de que la fuente se encuentra en el directorio
de fuentes de Windows.

Configuracin de las fuentes incrustadas para informes PDF


Si un informe PDF se abre en Adobe Reader, todas las fuentes utilizadas en dicho informe deben
estar disponibles. Las fuentes deben estar incrustadas en el informe o instaladas en el equipo del
usuario. Si una fuente no est disponible en ninguno de estos dos sitios, Adobe Reader intentar
reemplazarla por una fuente adecuada. Esta sustitucin puede provocar cambios en la presentacin
del informe o puede que algunos caracteres no se muestren.
Para garantizar que los informes PDF se muestran correctamente en Adobe Reader, IBM Cognos 8
incrusta las fuentes necesarias en los informes de forma predeterminada. Para reducir al mximo
el tamao del archivo, IBM Cognos 8 nicamente incrusta los caracteres (tambin denominados
glifos) que se utilizan en el informe, en lugar de incrustar los caracteres del conjunto de fuente. IBM
Cognos 8 nicamente incrusta las fuentes si cuentan con licencia para incrustarse. La informacin
de licencia est almacenada en la propia fuente y la lee IBM Cognos 8.
Si est seguro de que las fuentes empleadas en los informes estn disponibles en el equipo de los
usuarios, puede limitar o eliminar las fuentes incrustadas para reducir el tamao de los informes
PDF. Al limitar las fuentes, se especifica si una fuente est incrustada siempre o no est incrustada
nunca mediante una lista de fuentes incrustadas en IBM Cognos Configuration.

Pasos
1. Inicie IBM Cognos Configuration en el equipo Content Manager.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana Propiedades, en Configuracin de fuente, haga clic en el valor Incrustar fuentes
(servicio de informes por lotes) o Incrustar fuentes (servicio de informes) y, a continuacin,
haga clic en el botn Editar.
4. Si no utiliza el directorio de fuentes predeterminadas o si desea aadir una ruta de acceso a un
directorio adicional, especifique la nueva ruta de acceso en el cuadro de rutas de acceso de
fuentes en el cuadro de dilogo Incrustar fuentes en informes PDF.
Sugerencia: Haga clic en Buscar ahora para obtener una lista de las fuentes disponibles en la
ruta o las rutas de acceso especificadas.
5. Para una fuente que estar siempre disponible en el equipo del usuario, desplcese hasta el
nombre de la fuente y haga clic en la casilla de verificacin Nunca.
IBM Cognos 8 no incrusta la fuente con ningn informe. Al abrir el informe, Adobe Reader
selecciona la fuente del equipo del usuario.
6. Para una fuente que es posible que no siempre est disponible en el equipo del usuario, desplcese
hasta el nombre de la fuente y haga clic en la casilla de verificacin Siempre.

232 PowerPlay

Captulo 11: Opciones de configuracin


IBM Cognos 8 incrusta la fuente con todos los informes que la utilizan. Adobe Reader utiliza
la fuente incrustada cuando se abre el informe.
7. Haga clic en Aceptar.

Salida de informe guardada


De forma predeterminada, los archivos de salida de informe se guardan en el almacn de contenido.
Tiene la opcin de guardar una copia de la salida de informe en otra ubicacin de archivo que se
encuentre fuera o dentro de IBM Cognos 8. Si utiliza esta opcin, tambin se guarda un archivo
descriptor con la extensin _descr. IBM Cognos 8 no administra los archivos guardados.

Cmo guardar la salida de informe fuera de IBM Cognos 8


Si configura una ubicacin de sistema de archivos que se encuentra fuera de IBM Cognos 8, puede
compartir la salida de informe con aplicaciones o usuarios externos que no dispongan de IBM
Cognos 8. ste es el modo en el que se guardan la mayora de los archivos de salida de informe.
Para utilizar esta funcin, debe configurar primero un directorio raz en IBM Cognos Configuration.
A continuacin, un administrador debe definir la ubicacin de archivo en IBM Cognos Administration. Para obtener ms informacin, consulte el tema acerca de la configuracin de una ubicacin
de archivo para una salida de informe guardada fuera de IBM Cognos 8 en la Gua de administracin
y seguridad.

Pasos
1. Cree un directorio para el sistema de archivos.
Sugerencia: Asegrese de que los usuarios pueden acceder al directorio y de que ste es distinto
al directorio de instalacin. Por ejemplo, en una instalacin distribuida, podra utilizarse una
carpeta de archivos como \\nombre del servidor\directorio.
2. Inicie IBM Cognos Configuration en el equipo Content Manager.
3. En el men Acciones, haga clic en Editar la configuracin global.
4. En la ventana Configuracin global, haga clic en la pestaa General.
5. En Raz del sistema de archivos de la ubicacin 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. Pueden utilizarse nombres UNC de Windows,
como \\nombre de servidor\directorio. Si es as, el URI debe tener el formato siguiente:
file://\\nombre de servidor\directorio
6. Para confirmar que se utilizar la ubicacin correcta, haga clic en Probar.
7. Haga clic en Aceptar.
8. En el men Archivo, haga clic en Guardar.

Gua de instalacin y configuracin 233

Captulo 11: Opciones de configuracin


Ahora el administrador debe configurar la ubicacin de archivo. Para obtener ms informacin,
consulte el tema acerca de la configuracin de una ubicacin de archivo para una salida de informe
guardada fuera de IBM Cognos 8 en la Gua de administracin y seguridad.

Cmo guardar la salida de informe dentro de IBM Cognos 8


Si configura una ubicacin de sistema de archivos que se encuentra dentro de IBM Cognos 8, puede
volver utilizar la salida de informe posteriormente. Esto tambin puede ser til para archivar dado
que los archivos que se guardan en el almacn de contenido pueden eliminarse con regularidad
debido a reglas de conservacin.
Para utilizar esta funcin, debe habilitar primero la propiedad Guardar las salidas de informes en
un sistema de archivos? en IBM Cognos Configuration. A continuacin, un administrador debe
configurar la ubicacin de archivo mediante el parmetro CM.OutPutLocation en IBM Cognos
Administration. Para obtener ms informacin, consulte el tema acerca de la configuracin de una
ubicacin de archivo para una salida de informe guardada dentro de IBM Cognos 8 en la Gua de
administracin y seguridad.

Pasos
1. Cree un directorio para el sistema de archivos.
Sugerencia: Asegrese de que slo los usuarios autorizados pueden acceder al directorio.
2. Inicie IBM Cognos Configuration en el equipo Content Manager.
3. En la ventana Explorador, haga clic en Acceso a datos, Content Manager.
4. Para la propiedad Guardar las salidas de informes en un sistema de archivos?, haga clic en
Verdadero.
5. Para probar la conexin con el directorio de salida de informe, en el men Acciones, haga clic
en Probar.
6. En el men Archivo, haga clic en Guardar.
Ahora el administrador debe configurar la ubicacin de archivo mediante el parmetro CM.OutPutLocation. Para obtener ms informacin, consulte el tema acerca de la configuracin de una
ubicacin de archivo para una salida de informe guardada dentro de IBM Cognos 8 en la Gua de
administracin y seguridad.

Cambio de los valores de configuracin del servicio de migracin


de IBM Cognos Series 7
Si es necesario, puede cambiar el nmero de puerto del servicio utilizado por el servicio de migracin
de IBM Cognos Series 7.

Pasos
1. Vaya al directorio ubicacin_s7\migs7.

234 PowerPlay

Captulo 11: Opciones de configuracin


2. Localice el archivo migs7service_configuration.xml y elimine el atributo de slo lectura de las
propiedades del archivo.
3. Abra el archivo en un editor XML o en un editor de texto sin formato como Bloc de notas.
4. Cambie la configuracin del archivo para ajustarla a su entorno.
5. Guarde el archivo.
6. Reinicie el servicio de migracin:

En Windows, reinicie el servicio de migracin mediante la entrada Servicio de migracin


de IBM Cognos Series 7 de la lista Servicios que se encuentra en Herramientas administrativas.

En UNIX, detenga e inicie el servicio de migracin introduciendo los comandos siguientes


en el directorio migs7service:
./configure.sh --stop
./configure.sh --start

Asignacin de una cuenta de usuario a los servicios de migracin


y PowerPlay para la migracin
De forma predeterminada, el servicio IBM Cognos PowerPlay Enterprise Server y el servicio de
migracin utilizan una cuenta de sistema. Si varios servidores PowerPlay compartirn ubicaciones
de datos durante la migracin, debe asignar primero una cuenta de usuario a los servicios.
La cuenta de usuario debe configurarse en todos los equipos con Windows en los que se hayan
instalado los componentes de migracin de Series 7 o el componente PowerPlay.
Antes de asignar la cuenta de usuario a los servicios, asegrese de que se ha configurado una cuenta
de usuario con una contrasea que no caduca nunca.

Pasos
1. En el Panel de control de Windows, en Herramientas administrativas, haga clic en Servicios.
2. Haga clic en el servicio IBM Cognos PowerPlay Enterprise Server y seleccione Inicio.
3. En el panel Iniciar sesin como, haga clic en Esta cuenta.
4. Seleccione en la lista la cuenta de usuario que ha configurado para el servicio.
5. Introduzca la contrasea para la cuenta en los cuadros de texto Contrasea y Confirmar contrasea.
6. Haga clic en Aceptar.
7. Repita los pasos del 2 al 5 para el servicio de migracin de Series 7.

Gua de instalacin y configuracin 235

Captulo 11: Opciones de configuracin

Definicin de una cuenta de inicio de sesin de usuario para el


servicio IBM Cognos 8 en varios equipos PowerPlay
De forma predeterminada, el servicio IBM Cognos 8 est instalado como inicio de sesin de cuenta
de sistema. Para que varios equipos PowerPlay compartan ubicaciones de datos en una red, debe
asignar una cuenta de inicio de sesin de usuario al servicio IBM Cognos 8 en todos los equipos
con Windows.
Primero debe crear una cuenta de usuario especial cuya contrasea no caduque nunca.

Pasos
1. En el Panel de control de Windows, en Herramientas administrativas, haga clic en Servicios.
2. Haga clic con el botn derecho del ratn en el servicio IBM Cognos 8 y seleccione Propiedades.
3. En la pestaa Iniciar sesin, seleccione Esta cuenta y, a continuacin, haga clic en Examinar.
4. En el cuadro de dilogo Seleccionar usuario, haga clic en la cuenta de usuario especial que ha
creado. En el cuadro Contrasea, introduzca la contrasea de esta cuenta.
5. En el cuadro Confirmar contrasea, vuelva a introducir la contrasea.
6. Haga clic en Aceptar.

Creacin de un nuevo almacn de contenido mediante la base


de datos de contenido de Cognos
Siga los pasos que figuran a continuacin para crear otra base de datos de almacn de contenido
mediante la base de datos de contenido de Cognos. Puede que esta operacin sea necesaria si instala
ms de una instancia del producto IBM Cognos 8 en una ubicacin y desea ejecutar las instancias
por separado.
Antes de crear el nuevo almacn de contenido, realice lo siguiente:

Instale la instancia adicional del producto IBM Cognos 8 en un directorio aparte del mismo
equipo.
Asegrese de que selecciona Base de datos de contenido de Cognos en la pgina Seleccin de
componentes del asistente de instalacin.

Cree un nuevo usuario y una nueva contrasea para la base de datos del nuevo almacn de
contenido.

Pasos
1. En la ubicacin en la que ha instalado la nueva instancia de la base de datos de contenido de
Cognos, en el directorio ubicacin_c8\derby10.1.2.1\bin, utilice los scripts ij.bat o ij.ksh para
crear una nueva base de datos.
Utilice la misma sintaxis:

236 PowerPlay

Captulo 11: Opciones de configuracin


connect 'jdbc:derby://host:puerto/nombre_bd;create=true;user=nombre_usuario; password=contrasea';
Asegrese de que utiliza un nombre, un usuario y una contrasea diferentes para el nuevo
almacn de contenido.
Por ejemplo, para crear una base de datos denominada contentstore2 en el nmero de puerto
1527 del equipo localhost, como usuario denominado cognos2 y con la contrasea cognos2,
tendra que escribir
connect 'jdbc:derby://localhost:1527/contentstore2;create=true;user=cognos2;
password=cognos2';
El nombre de la base de datos distingue entre maysculas y minsculas.
Los archivos de la base de datos se encuentran en el directorio ubicacin_c8\contentstore.
2. Una vez que haya finalizado con la utilidad ij, proceda a la desconexin utilizando el siguiente
comando:
disconnect;

Configuracin del protocolo SSL


El protocolo Secure Sockets Layer (SSL) se utiliza para permitir una comunicacin segura entre los
componentes de IBM Cognos instalados en el mismo equipo o en equipos diferentes.
Adems, puede configurar conexiones SSL entre componentes de IBM Cognos y otros servidores.
Debe asegurarse de que SSL est configurado para los otros servidores y debe configurar una confianza compartida entre los componentes de IBM Cognos y los otros servidores.
Utilice la siguiente lista de comprobacin para configurar el protocolo SSL:

Configure SSL para los componentes de IBM Cognos (p. 237).

Configure la confianza compartida entre los componentes de IBM Cognos y otros servidores,
si es necesario (p. 240).

Seleccione y clasifique paquetes de cifrado para utilizarlos en una conexin SSL si es necesario
(p. 241).

Habilite SSL en el servidor Web (p. 242).

Despus de configurar el protocolo SSL, puede seleccionar y clasificar paquetes de cifrado, que
controlan la calidad de la proteccin utilizada en la conexin SSL.

Configuracin de SSL para IBM Cognos 8


Puede configurar los componentes de IBM Cognos para que utilicen el protocolo SSL para

Conexiones internas nicamente

Conexiones externas nicamente

Conexiones internas y externas

Gua de instalacin y configuracin 237

Captulo 11: Opciones de configuracin

Conexiones a servidores de registro locales y remotos

Si configura SSL slo para conexiones internas, los componentes de IBM Cognos del equipo local
se comunicarn mediante este protocolo. El distribuidor atiende las conexiones seguras en un puerto
distinto al de las solicitudes http remotas. Por lo tanto, debe configurar dos URI de distribuidor.
Si configura SSL slo para conexiones externas, las comunicaciones de los componentes de IBM
Cognos remotos con el equipo local utilizarn el protocolo SSL. Debe configurar el distribuidor
para que atienda las solicitudes remotas seguras en un puerto distinto al de las solicitudes HTTP
locales. Asimismo, debe configurar los URI de Content Manager y el URI de distribuidor para que
las aplicaciones externas utilicen el mismo protocolo y puerto que el distribuidor externo.
Si configura SSL para todas las conexiones, el distribuidor puede utilizar el mismo puerto para las
conexiones internas y externas. Del mismo modo, si no utiliza SSL para la comunicacin local o
remota, el distribuidor puede utilizar el mismo puerto para todas las comunicaciones.
Asimismo, debe actualizar los URI de Content Manager, el URI de distribuidor para las aplicaciones
externas y el URI de puerta de enlace para utilizar SSL, si es necesario.

Conectores de Tomcat
Si el URI de distribuidor interno tiene el prefijo http pero el URI de distribuidor externo tiene el
prefijo https o viceversa, tanto los conectores no SSL Coyote HTTP/1.1 como los SSL Coyote
HTTP/1.1 estn habilitados en el archivo server.xml.
Si los URI de distribuidor interno y externo utilizan protocolos o puertos distintos, slo los componentes del equipo local pueden acceder al puerto de distribuidor interno. El URI de distribuidor
interno tambin debe especificar localhost.

Instalaciones en un nico equipo


En las instalaciones en un nico equipo, si ejecuta IBM Cognos 8 sin SSL, debe detener el servicio
antes de aadir SSL a su configuracin. Despus de guardar la configuracin con los valores SSL,
puede reiniciar el servicio.

Instalaciones distribuidas
En las instalaciones distribuidas, si utiliza el servicio de la entidad emisora de certificados de IBM
Cognos, debe configurar primero todos los equipos IBM Cognos para que utilicen el protocolo no
seguro (http) antes de configurar los componentes de IBM Cognos para que utilicen el protocolo
SSL. Esto es necesario porque no puede configurar el protocolo SSL antes de haber establecido la
confianza.
Asimismo, asegrese de que sigue el orden necesario de configuracin de los equipos en un entorno
distribuido. Esto significa que primero debe configurar el equipo en el que se ha instalado Content
Manager activo predeterminado y, a continuacin, debe iniciar los servicios en este equipo antes
de configurar otros equipos o de iniciar servicios en otros equipos. Al configurar primero el equipo
Content Manager activo predeterminado e iniciar los servicios, se asegura de que el servicio de la
entidad emisora de certificados del equipo Content Manager activo predeterminado puede emitir
certificados a otros equipos en el entorno de IBM Cognos.
Despus de configurar todos los equipos en la instalacin distribuida para que utilicen el protocolo
no seguro predeterminado, se recomienda probar la instalacin para asegurarse de que los compo238 PowerPlay

Captulo 11: Opciones de configuracin


nentes de IBM Cognos funcionan correctamente. Tras probar la instalacin, puede configurar el
protocolo SSL.
Al configurar IBM Cognos 8 para que utilice el protocolo SSL, asegrese de que configura primero
el equipo Content Manager activo predeterminado para que utilice el protocolo y de que inicia los
servicios en el equipo Content Manager activo predeterminado. Tras realizar esto, puede configurar
el protocolo SSL en otros equipos IBM Cognos de su entorno.

Adicin de un equipo a una instalacin


Si aade un equipo en un entorno con SSL habilitado, se le pedir que acepte temporalmente la
confianza de un certificado al guardar la configuracin. Al aceptar el certificado temporal, se permite
que se establezca una confianza permanente con el equipo Content Manager.

Adicin de un componente a un equipo


Posteriormente puede aadir un componente en la misma ubicacin que otros componentes de IBM
Cognos. Si aade el componente en una ubicacin diferente de la que se encuentran los otros componentes de IBM Cognos en el mismo equipo, se le pedir que acepte temporalmente la confianza
de un certificado al guardar la configuracin. Al aceptar el certificado temporal, se permite que se
establezca una confianza permanente entre el nuevo componente y el equipo Content Manager.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana Propiedades, escriba los valores pertinentes para URI de distribuidor interno y
URI de distribuidor externo:

Para configurar SSL slo para conexiones internas, para la propiedad URI de distribuidor
interno, escriba https e introduzca un puerto para la comunicacin SSL. Para la propiedad
URI de distribuidor externo, escriba http y utilice el puerto predeterminado u otro disponible.
Si utiliza Tomcat, la propiedad URI de distribuidor interno tambin debe especificar
localhost.
Los puertos de los dos URI de distribuidor deben ser diferentes.

Para configurar SSL slo para conexiones externas, para la propiedad URI de distribuidor
externo, escriba https e introduzca un puerto seguro. Para la propiedad URI de distribuidor
interno, escriba http y utilice el puerto predeterminado u otro disponible.
Si utiliza Tomcat, la propiedad URI de distribuidor interno tambin debe especificar
localhost.
Los puertos de los dos URI de distribuidor deben ser diferentes.

Para configurar SSL para todas las conexiones, introduzca el mismo URI para las propiedades URI de distribuidor interno y URI de distribuidor externo. Introduzca https y un
puerto seguro, como 9343.

Gua de instalacin y configuracin 239

Captulo 11: Opciones de configuracin


Nota: No tiene que utilizar el puerto 9343, el puerto SSL predeterminado. Puede seleccionar
cualquier puerto disponible.
4. Configure el protocolo SSL para los otros URI de entorno, como los URI de Content Manager,
el URI de distribuidor para aplicaciones externas y el URI de puerta de enlace.

Para configurarlo slo para las conexiones internas, introduzca https en los URI que contienen localhost.

Para configurarlo slo para las conexiones externas, introduzca https en los URI que no
contienen localhost.

Para configurarlo para todas las conexiones, introduzca https en todos los URI.

5. En la ventana Explorador, haga clic en Seguridad, Criptografa.


6. Para utilizar el protocolo SSL, debe especificar las contraseas para los almacenes de claves de
codificacin de IBM Cognos 8. Hay ms valores de configuracin en Seguridad, Criptografa,
Cognos.
7. En el men Archivo, haga clic en Guardar.

Configuracin de la confianza compartida entre los servidores IBM Cognos y otros


servidores
Si desea utilizar la entidad emisora de certificados predeterminada de IBM Cognos y desea utilizar
SSL para las conexiones de otros servidores a los servidores IBM Cognos, debe aadir el certificado
de IBM Cognos al almacn de confianza de los otros servidores.
Nota: Si utiliza exploradores para conectarse a los componentes de IBM Cognos, los exploradores
solicitan automticamente a los usuarios que actualicen sus almacenes de confianza.
Si desea que la conexin entre los servidores IBM Cognos y el otro servidor se autentique mutuamente, tambin debe copiar el certificado de su entidad emisora de certificados en el almacn de
confianza de los servidores IBM Cognos.
Si ha configurado los componentes de IBM Cognos para que utilicen otra entidad emisora de certificados (CA), no debe configurar la confianza compartida entre el servidor IBM Cognos y otros
servidores.

Pasos para copiar el certificado de IBM Cognos en otro servidor


1. Vaya al directorio ubicacin_c8\bin.
2. Extraiga el certificado de IBM Cognos introduciendo el comando siguiente:

En UNIX o Linux, escriba


ThirdPartyCertificateTool.sh -E -T -r archivo_destino -k ubicacin_c8/configuration/
signkeypair/jCAKeystore -p contrasea

En Windows, escriba
ThirdPartyCertificateTool.bat -E -T -r archivo_destino -k ubicacin_c8\configuration\
signkeypair\jCAKeystore -p contrasea

240 PowerPlay

Captulo 11: Opciones de configuracin


3. Importe el certificado al almacn de confianza del servidor.
Para obtener informacin sobre cmo actualizar el almacn de confianza del servidor, consulte
la documentacin del servidor.

Pasos para copiar el certificado de la entidad emisora de certificados en servidores IBM


Cognos
1. Copie el certificado de la entidad emisora de certificados en una ubicacin segura en el servidor
IBM Cognos.
Asegrese de que el certificado de la entidad emisora de certificados tiene el formato X.509
codificado en Base-64.
2. Importe el certificado de la entidad emisora de certificados introduciendo el comando siguiente:

En UNIX o Linux, escriba


ThirdPartyCertificateTool.sh -T -i -r archivo_certificado_CA -k ubicacin_c8/configuration/
signkeypair/jCAKeystore -p contrasea

En Windows, escriba
ThirdPartyCertificateTool.bat -T -i -r archivo_certificado_CA -k ubicacin_c8\
configuration\signkeypair\jCAKeystore -p contrasea

Seleccin y clasificacin de paquetes de cifrado para SSL


Una conexin SSL empieza con una negociacin en la que el cliente y el servidor presentan una lista
de paquetes de cifrado admitidos en orden de prioridad. El paquete de cifrado proporciona la calidad
de proteccin para la conexin. Contiene algoritmos criptogrficos, de autenticacin, hash y de
intercambio de claves. El protocolo SSL selecciona el paquete con prioridad mxima que admite el
cliente y el servidor.
Se ofrece una lista de paquetes de cifrado compatibles con SSL. Puede eliminar paquetes de cifrado
que no cumplen sus requisitos y asignar una prioridad o preferencia a los paquetes de cifrado restantes. Los paquetes de cifrado seleccionados se presentan en orden de prioridad para ambas partes
de la negociacin, cliente y servidor. Debe coincidir como mnimo uno de los paquetes de cifrado
seleccionados entre las plataformas cliente y servidor.
La lista de paquetes de cifrado admitidos se genera de forma dinmica en cada equipo y depende
del entorno en tiempo de ejecucin de Java (JRE) o de si ha instalado otro software criptogrfico
en el equipo. Si ha realizado cambios en un equipo, como la actualizacin del JRE o la instalacin
de software que ha actualizado el JRE, los paquetes de cifrado admitidos disponibles en ese equipo
pueden verse afectados. Si ya no tiene un paquete de cifrado admitido que coincida con los otros
equipos de su entorno, es posible que deba cambiar el JRE del equipo para que coincida con los
otros equipos de su entorno.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, haga clic en Criptografa, Cognos.

Gua de instalacin y configuracin 241

Captulo 11: Opciones de configuracin


3. En la ventana Propiedades, haga clic en la columna Valor de la propiedad Paquetes de cifrado
admitidos.
4. Haga clic en el botn Editar.

Para mover un paquete de cifrado a la lista Valores actuales, haga clic en la casilla de
verificacin de la lista Valores disponibles y, a continuacin, en Aadir.

Para subir o bajar un paquete de cifrado de la lista Valores actuales, haga clic en la casilla
de verificacin y, a continuacin, en las flechas hacia arriba o hacia abajo.

Para eliminar un paquete de cifrado de la lista Valores actuales, haga clic en la casilla de
verificacin y, a continuacin, en Eliminar.

5. Haga clic en Aceptar.


6. En el men Archivo, haga clic en Guardar.

Habilitacin de SSL en el servidor Web


Habilite Secure Sockets Layer (SSL) para codificar la comunicacin del usuario con el servidor Web.
Para habilitar SSL en el servidor Web, debe obtener un certificado de servidor Web firmado por
una entidad emisora de certificados e instalarlo en el servidor Web. El certificado no debe tener
firma personal, ya que los componentes de IBM Cognos no confiarn en los certificados con firma
personal.
Para habilitar los componentes de IBM Cognos con el fin de que utilicen un servidor Web habilitado
para SSL, debe tener copias del certificado raz de confianza (el certificado de la entidad emisora
de certificados que ha firmado el certificado del servidor Web) y de todos los certificados restantes
que forman parte de la cadena de confianza del certificado del servidor Web. Estos certificados
deben estar codificados en Base64 en formato ASCII (PEM) o DER y no deben tener firma personal.
Los certificados deben instalarse en cada equipo donde haya instalado los componentes de nivel de
aplicacin.
Para obtener ms informacin sobre cmo instalar certificados en el servidor Web, consulte la
documentacin del servidor Web.

Pasos
1. Configure el servidor Web para SSL e incielo.
Para obtener ms informacin, consulte la documentacin del servidor Web.
2. En cada equipo en el que estn instalados los componentes de nivel de aplicacin el cual apunte
a la puerta de enlace del servidor Web, en IBM Cognos Configuration, cambie el URI de la
puerta de enlace de HTTP a HTTPS y guarde la configuracin.
Importante: No inicie todava el servicio IBM Cognos 8.
3. En cada equipo servidor de planificacin que apunte a la puerta de enlace, en IBM Cognos
Configuration, cambie el URI de la puerta de enlace de HTTP a HTTPS y guarde la configuracin.

242 PowerPlay

Captulo 11: Opciones de configuracin


Importante: No inicie todava el servicio IBM Cognos 8.
4. En cada equipo de componentes de nivel de aplicacin, vaya al directorio ubicacin_c8/bin e
importe todos los certificados que componen la cadena de confianza, en orden, empezando por
el de la entidad emisora de certificados raz, en el almacn de confianza de IBM Cognos.
Importe los certificados introduciendo el comando siguiente:
En UNIX o Linux, escriba
ThirdPartyCertificateTool.sh -T -i -r nombreArchivo_certificado -D ../configuration/signkeypair
-p contrasea
En Windows, escriba
ThirdPartyCertificateTool.bat -T -i -r nombreArchivo_certificado -D ../configuration/signkeypair
-p contrasea
Nota: La contrasea debe haberse establecido con anterioridad. Si no es as, la contrasea
predeterminada ser NoPassWordSet.
5. En cada equipo servidor de planificacin, vaya al directorio ubicacin_c8/bin e importe todos
los certificados que componen la cadena de confianza, en orden, empezando por el de la entidad
emisora de certificados raz, en el almacn de confianza de IBM Cognos.
Importe los certificados introduciendo el comando siguiente:
ThirdPartyCertificateTool.bat -T -i -r nombreArchivo_certificado -D ../configuration/signkeypair
-p contrasea
Nota: La contrasea debe haberse establecido con anterioridad. Si no es as, la contrasea
predeterminada ser NoPassWordSet.
6. En cada equipo de componentes de nivel de aplicacin, en IBM Cognos Configuration, inicie
el servicio IBM Cognos 8.
7. En cada equipo servidor de planificacin, en IBM Cognos Configuration, inicie el servicio de
IBM Cognos 8.
Para comprobar la confianza puede crear y ejecutar un informe en PDF que contenga imgenes que
no estn almacenadas de manera local, sino que la puerta de enlace obtenga de un equipo remoto.
Si las imgenes aparecen, la confianza se ha establecido.
Para evitar que aparezca una alerta de seguridad para cada nueva sesin, instale el certificado en
uno de los almacenes de certificados del explorador Web.
Adems, puede configurar conexiones SSL entre componentes de IBM Cognos y otros servidores.
Debe asegurarse de que SSL est configurado para los otros servidores y debe configurar una confianza compartida entre los componentes de IBM Cognos y los otros servidores. Para obtener ms
informacin, consulte "Configuracin del protocolo SSL" (p. 237).

Configuracin de mensajes de registro


Los mensajes de registro son herramientas importantes de diagnstico para estudiar el comportamiento de IBM Cognos 8. Adems de los mensajes de error, los mensajes de registro ofrecen infor-

Gua de instalacin y configuracin 243

Captulo 11: Opciones de configuracin


macin sobre el estado de los componentes y una visin de alto nivel de eventos importantes. Por
ejemplo, los mensajes de registro pueden proporcionar informacin sobre los intentos de inicio y
detencin de servicios, la finalizacin de solicitudes de procesamiento y los indicadores de errores
graves. Los registros de auditora, disponibles a partir de una base de datos de registro, ofrecen
informacin sobre la actividad de informe y usuario.
Los servicios de IBM Cognos 8 de cada ordenador envan informacin sobre errores y eventos al
servidor de registro local. Se instala un servidor local en la carpeta ubicacin_c8/logs en cada
ordenador de IBM Cognos 8 que contenga Content Manager o componentes de nivel de aplicacin.
Puesto que el servidor de registro usa un puerto distinto al de los otros componentes de IBM Cognos
8, seguir procesando eventos incluso si se han deshabilitado otros servicios del ordenador local,
por ejemplo el distribuidor.
El siguiente flujo de trabajo muestra las tareas necesarias para preparar el registro.
Planificacin
del procesamiento
de mensajes de registro

Planificacin
del procesamiento
de mensajes de registro

Planificacin
del procesamiento
de mensajes de registro

244 PowerPlay

Configuracin del registro

Definicin del registro

Configuracin del registro


Definicin del registro

Definicin del registro


Configuracin del registro

Durante la planificacin determine cul es la configuracin de registro adecuada para su entorno.


Por ejemplo, evale los destinos de diversos mensajes de registro como los servidores y archivos
remotos de registro, como el syslog de UNIX o Linux o el registro de eventos de Windows NT,
adems del archivo de registro local. Tambin puede enviar solamente informacin de registro
de auditora a una base de datos. Tenga en cuenta la seguridad, por ejemplo, los mtodos disponibles para proteger los archivos de registro contra errores de sistema o modificaciones de
otros usuarios. Para obtener ms informacin sobre la planificacin consulte Architecture and
Deployment Guide.

Durante la configuracin, defina las propiedades de inicio del registro, como por ejemplo, la
configuracin de conexin de las bases de datos. Si desea recopilar los registros de auditora,
deber crear tambin una base de datos de registro. Si hay que proteger la comunicacin entre
un servidor de registro local y otro remoto, implemente los cambios necesarios en la configuracin de los dos equipos IBM Cognos 8. Para obtener ms informacin sobre la configuracin
del registro, consulte la Gua de instalacin y configuracin.

Cuando est configurando el registro, especifique el nivel de detalle que se va a registrar; de


este modo los mensajes se centrarn en la informacin que es relevante en su organizacin. Los
informes de auditora tambin pueden configurarse para hacer un seguimiento de la actividad

Captulo 11: Opciones de configuracin


de informes y usuarios. Para obtener ms informacin sobre la configuracin del registro,
consulte Gua de administracin y seguridad.
Para obtener ms informacin sobre el uso de los mensajes de registro para resolver problemas y
sobre la resolucin de problemas relacionados con el registro, consulte la seccin sobre solucin
de problemas de la Gua de administracin y seguridad.

Directrices para la creacin de una base de datos de registro


Puede crear una base de datos para almacenar mensajes de registro. La creacin de una base de
datos de registro conlleva las siguientes tareas:

Crear una base de datos de registro.


Para DB2, Oracle, Microsoft SQL Server o Sybase, utilice el mismo procedimiento que se utiliz
para crear la base de datos del almacn de contenido (p. 43).
Para DB2 en z/OS, siga las instrucciones de "Configuracin recomendada para crear la base
de datos de registro DB2 en z/OS" (p. 245).

Configurar la conectividad de la base de datos.

Especificar el destino de los mensajes de registro.

Configuracin recomendada para crear la base de datos de registro DB2 en z/OS


La base de datos que vaya a crear debe incluir algunos valores de configuracin recomendados.
Utilice la siguiente lista de comprobacin a modo de ayuda para configurar la base de datos de
registro en DB2.

Inicie sesin en el sistema z/OS como usuario con privilegios de administrador en DB2 en z/OS.

Cree una instancia de base de datos, un grupo de almacenamiento y una cuenta de usuario para
el almacn de contenido. IBM Cognos 8 utiliza las credenciales de la cuenta de usuario para
comunicarse con el servidor de la base de datos.

Asegrese de que asigna un grupo de bferes con un tamao de pgina de 8 kB a la instancia


de la base de datos.

Cuando se crea una base de datos de registro en DB2 en z/OS, los administradores deben ejecutar
un script para crear espacios de tabla para objetos de gran tamao y otros datos y, a
continuacin, conceder derechos para la tabla. Para obtener ms informacin sobre cmo
ejecutar el script de espacios de tabla, consulte "Creacin de espacios de tabla para la base de
datos de registro DB2 en z/OS " (p. 245).

Creacin de espacios de tabla para la base de datos de registro DB2 en z/OS


El administrador de la base de datos debe ejecutar un script para crear un conjunto de espacios de
tabla necesarios en la base de datos de registro. El script debe modificarse para sustituir los parmetros de marcador por otros que sean apropiados al entorno.

Gua de instalacin y configuracin 245

Captulo 11: Opciones de configuracin


Asegrese de que sigue la convencin de nomenclatura definida para DB2 en z/OS. Por ejemplo,
todos los nombres de parmetros deben comenzar por una letra y no deben tener ms de ocho
caracteres. Para obtener ms informacin, consulte el centro de informacin DB2 de IBM.

Pasos
1. Mediante una herramienta de acceso remoto, establezca conexin con la base de datos como
un usuario con privilegios para crear y descartar espacios de tabla y permitir la ejecucin de
las sentencias SQL.
2. Abra el archivo de script LS_tablespace_db2zOS.sql y use la siguiente tabla que le ayudar a
reemplazar los parmetros genricos por los valores apropiados al entorno.
No todos los parmetros enumerados se encuentran en el script, pero se pueden aadir en el
futuro.

Nombre de parmetro

Descripcin

IPFSCRIPT_DATABASE

Especifica el nombre de la base de datos de


registro.

IPFSCRIPT_STOGROUP

Especifica el nombre del grupo de almacn.

IPFSCRIPT_TABLESPACE

Especifica el nombre del espacio de tabla que


contiene las tablas base de la base de datos de
registro.
Este espacio de tabla no es para las tablas
auxiliares.

IPFSCRIPT_LOB_TABLESPACE

Especifica el nombre del espacio de tabla que


se asigna a las tablas auxiliares.

IPFSCRIPT_BP

Especifica el nombre del grupo de bferes de


8 kB que se asigna a los objetos normales.

IPFSCRIPT_USERNAME

Especifica la cuenta de usuario que accede a


la base de datos de registro.

3. Guarde y ejecute el script en la herramienta de acceso remoto.


4. Conceda los derechos de usuario de IBM Cognos a los espacios de tabla creados al ejecutar el
archivo de script LS_tablespace_db2zOS.sql:

246 PowerPlay

En la herramienta de acceso remoto, abra el archivo de script LS_rightsGrant_db2zOS.sql,


que se encuentra en el directorio ubicacin_c8\configuration\schemas\logging\db2zOS.

Sustituya los valores de los parmetros por valores apropiados para el entorno.

Captulo 11: Opciones de configuracin


Sugerencia: Asegrese de que usa los mismos valores que us al crear los grupos de bferes
y la cuenta de usuario.

Guarde y ejecute el script LS_rightsGrant_db2zOS.sql en la herramienta de acceso remoto.

Se crea la base de datos de registro.

Configuracin de la conectividad de base de datos para una base de datos de


registro
Despus de crear una base de datos para registros de auditora, son necesarios pasos adicionales
para configurar el cliente de base de datos si utiliza Oracle, DB2 o Sybase como servidor de base
de datos.
No puede utilizar la base de datos de contenido de Cognos como base de datos de registro.
Nota: En un entorno distribuido, el servidor de registro local de un equipo de Componentes de
nivel de aplicacin puede enviar mensajes de registro a un servidor de registro remoto, el cual enva
luego mensajes a la base de datos de registro. En Oracle, Sybase y DB2, el controlador JDBC y el
software de cliente de la base de datos (slo DB2) adecuados slo son necesarios en el equipo de
Componentes de nivel de aplicacin con el servidor de registro remoto que se conecta a la base de
datos de registro.

Base de datos Microsoft SQL Server


Si utiliza una base de datos de Microsoft SQL Server, el archivo JSQLConnect.jar est instalado en
la ubicacin adecuada de manera predeterminada. El nico paso adicional que debe realizar es
asegurarse de que Microsoft SQL Server utiliza la conectividad TCP/IP.

Base de datos Oracle o Sybase


Si utiliza una base de datos Oracle o Sybase, debe configurar el controlador JDBC en todos los
equipos de Componentes de nivel de aplicacin con una conexin a la base de datos de registro.
Tambin debe configurar el controlador JDBC en el equipo Content Manager, a no ser que est
utilizando el mismo tipo de base de datos para los mensajes de registro que utiliza para el almacn
de contenido.

Base de datos DB2


IBM Cognos 8 utiliza la conectividad JDBC para acceder a la base de datos utilizada en la base de
datos de registro.
Si utiliza una base de datos DB2, debe configurar el software de cliente de base de datos y el controlador JDBC en todos los equipos de componentes de nivel de aplicacin con una conexin a la
base de datos de registro. Tambin debe configurar el software de cliente de base de datos y el
controlador JDBC en el equipo Content Manager, a no ser que est utilizando el mismo tipo de
base de datos para los mensajes de registro que utiliza para el almacn de contenido.
Si utiliza DB2 en Windows, Linux o UNIX como base de datos de registro, debe seleccionar si desea
utilizar un controlador JDBC de tipo 2 o de tipo 4, segn cmo desee conectarse a la base de datos
de registro.

Gua de instalacin y configuracin 247

Captulo 11: Opciones de configuracin


Si va a utilizar una base de datos DB2 en z/OS como base de datos de registro, deber utilizar la
conectividad JDBC de tipo 4.
Para obtener ms informacin sobre las opciones del controlador JDBC para una base de datos
DB2, consulte "Opciones de controlador JDBC para usar bases de datos DB2 como almacn de
contenido" (p. 86).

Pasos para Oracle


1. En el equipo en el que est instalado Oracle, vaya al directorio ORACLE_HOME/jdbc/lib.
2. Copie el archivo ojdbc14.jar en el directorio ubicacin_c8/webapps/p2pd/WEB-INF/lib de los
equipos Content Manager o de Componentes de nivel de aplicacin adecuados. Para Oracle
11 g, copie el archivo ojdbc5.jar en el directorio ubicacin_c8/webapps/p2pd/WEB-INF/lib de
los equipos Content Manager o de Componentes de nivel de aplicacin adecuados.
Si el directorio contiene el archivo classes12.jar, elimnelo antes de instalar el archivo ojdbc14.jar
o ojdbc5.jar.

Pasos para DB2 en Linux, UNIX y Windows


1. Si va a utilizar la conectividad JDBC de tipo 2, instale el software del cliente DB2 en los equipos
de Content Manager.
Si va a utilizar la conectividad JDBC de tipo 4 para DB2, no necesita instalar el software del
cliente DB2 en el equipo en el que est instalado Content Manager.
Para obtener ms informacin sobre las diferencias entre los controladores de tipo 2 y de tipo
4, consulte "Opciones de controlador JDBC para usar bases de datos DB2 como almacn de
contenido" (p. 86).
2. Si va a utilizar una conectividad JDBC de tipo 2 y la base de datos de registro no est instalada
en el mismo equipo que el servidor de registro, configure un alias de base de datos para la base
de datos de registro.

En Windows, ejecute el DB2 Client Configuration Assistant.

En UNIX o Linux, utilice la interfaz de lnea de comandos de DB2.

Nota: Si la base de datos de registro y el servidor de registro estn en el mismo equipo, el


nombre de la base de datos de registro se convierte automticamente en el alias.
3. En Windows, detenga los servicios de DB2 y el servidor de bsqueda HTML.
4. Copie los siguientes archivos del directorio instalacin_DB2/sqllib/java en el directorio ubicacin_c8/webapps/p2pd/WEB-INF/lib.

Archivo del controlador universal: db2jcc.jar

Archivo de licencia
Para DB2 en Linux, UNIX o Windows, db2jcc_license_cu.jar
Para DB2 en z/OS, db2jcc_license_cisuz.jar

248 PowerPlay

Captulo 11: Opciones de configuracin


Sugerencia: Para comprobar la versin del controlador, ejecute el comando java -cp
ruta\db2jcc.jar com.ibm.db2.jcc.DB2Jjcc -version.
5. En Windows, reinicie los servicios de DB2 y el servidor de bsqueda HTML.
6. Repita el procedimiento completo en los equipos de IBM Cognos 8 en los que se deba instalar
el software.

Pasos para DB2 en z/OS


1. Vaya al directorio instalacin_DB2/sqllib/java.
2. Copie los siguientes archivos en los directorios ubicacin_c8/webapps/p2pd/WEB-INF/lib y
ubicacin_c8/bin.

Archivo del controlador universal: db2jcc.jar

Archivo de licencia, por ejemplo, db2jcc_license_cisuz.jar

Si va a utilizar una base de datos DB2 en z/OS como base de datos de registro, deber utilizar la
conectividad JDBC de tipo 4.
La versin del controlador debe ser, como mnimo, JCC 3.7 de Linux, UNIX o Windows versin
9.1 fixpack o JCC 3.42 de Linux, UNIX o Windows versin 9.5 fixpack 2.

Pasos para Sybase


1. En el equipo en el que est instalado Sybase, habilite el controlador JDBC mediante el siguiente
script:
ubicacin_Sybase/jConnect-5_5/sp/sql_server12.5.sql
2. Vaya al directorio ubicacin_Sybase/jConnect-5_5/classes.
3. Copie el archivo jconn2.jar en el directorio ubicacin_c8/webapps/p2pd/WEB-INF/lib de los
equipos Content Manager o de Componentes de nivel de aplicacin adecuados.

Destinos de los mensajes de registro


Al instalar Content Manager o los componentes de nivel de aplicacin, se instala automticamente
un servidor de registro local. Puede especificar uno o varios destinos en los que el servidor de
registro local enva mensajes de registro:

servidor de registro remoto

archivo

database

Syslog de UNIX o Linux o el registro de eventos de Windows NT

Para obtener informacin acerca de los mensajes de registro, consulte Architecture and Deployment
Guide.

Gua de instalacin y configuracin 249

Captulo 11: Opciones de configuracin

Servidor de registro remoto


En una instalacin distribuida, puede configurar el servidor de registro en cada equipo IBM Cognos
8 para que enve los mensajes de registro a un nico servidor de registro remoto, que acta como
servidor de registro comn. A continuacin, puede configurar el servidor de registro comn para
que enve los mensajes de registro a una base de datos o a un archivo local del mismo equipo o de
un equipo diferente.
Si el servidor de registro remoto no est disponible, los mensajes de registro se redirigen a archivos
de recuperacin del equipo local en el directorio ubicacin_c8\logs\recovery\remote. Estos archivos
de recuperacin tienen informacin de marca de hora en el nombre y no pueden leerse como archivos
de registro normales. Cuando el servidor de registro remoto vuelve a estar disponible, un proceso
de recuperacin automtico mueve toda la informacin de registro al servidor de registro remoto
y borra los archivos de registro local.

Archivo
El servidor de registro est configurado de forma predeterminada para enviar los mensajes de
registro al archivo ubicacin_c8/logs/cogserver.log. Si el archivo de registro predeterminado no
existe cuando se inicia el servicio IBM Cognos 8, se crea automticamente.
Puede configurar el servidor de registro para que enve los mensajes de registro a un archivo diferente.
Si configura un archivo de registro distinto, IBM Cognos 8 intenta crear automticamente este
archivo durante el inicio, adems del archivo de registro predeterminado. Si la ubicacin del archivo
de registro configurado no es el directorio ubicacin_c8/logs, debe asegurarse de que existe la ruta
de acceso al archivo de registro antes de iniciar el servicio IBM Cognos 8. Por ejemplo, si configura
el servidor de registro para que enve los mensajes al archivo c:/log_files/cognos.log, IBM Cognos
8 intenta crear automticamente el archivo cognos.log en la carpeta c:/log_files. Si esta carpeta no
existe, IBM Cognos 8 no crea el archivo cognos.log y no se puede registrar ningn mensaje de
registro en dicho archivo. Tenga en cuenta que estos mensajes de registro no se registran en el
archivo de registro predeterminado. A pesar de que IBM Cognos 8 crea automticamente el archivo
de registro predeterminado aunque se haya configurado otro archivo de registro, el archivo de
registro predeterminado no se utiliza como copia de seguridad.

Base de datos
El servidor de registro tambin puede enviar registros de auditora a una base de datos del mismo
equipo o de otro equipo. Los registros de auditora ofrecen informacin sobre la actividad de
usuario y de informe.
La base de datos de registro tiene la misma configuracin y los mismos requisitos de cuenta de
usuario que la base de datos del almacn de contenido. Despus de configurar los componentes de
IBM Cognos 8 para que enven mensajes a una base de datos de registro, y de reiniciar el servicio
de IBM Cognos 8, los componentes de IBM Cognos 8 crean las tablas y los campos de tabla necesarios. Puede probar la conexin a la base de datos de registro antes de reiniciar el servicio de IBM
Cognos 8.

250 PowerPlay

Captulo 11: Opciones de configuracin

Especificacin del destino de los mensajes de registro


Puede configurar un tipo de destino para los mensajes de registro y, a continuacin, configurar las
propiedades para el destino especfico. Asimismo, puede configurar ms de un destino para los
mensajes de registro.
Antes de especificar una base de datos como destino, asegrese de que

se haya creado la base de datos de registro

Configura el cliente de la base de datos.

Pasos para DB2, Linux y Windows


1. En el equipo en el que ha instalado Content Manager o los componentes de nivel de aplicacin,
inicie IBM Cognos Configuration.
2. En la ventana Explorador, en Entorno, haga clic en Registro.
3. En la ventana Propiedades, utilice la siguiente tabla a modo de ayuda para configurar las propiedades del servidor de registro.

Tarea

Accin

Utilice TCP entre los compo- Establezca la propiedad Habilitar TCP en Verdadero.
nentes de IBM Cognos 8 en
UDP proporciona una comunicacin ms rpida con un menor
un equipo y su servidor de
riesgo de perder conexiones que TCP. Sin embargo, el riesgo de
registro local.
perder una conexin TCP local es bajo. TCP siempre se utiliza
para la comunicacin entre un servidor de registro local y un
servidor de registro remoto.
Cambie el nmero de subprocesos disponibles en el
servidor de registro local.

Escriba el valor de la propiedad Subprocesos de trabajo del servidor de registro local.


Establezca un valor entre 1 y 20. Se recomienda el valor predeterminado de 10.
Sin embargo, si tiene un elevado nmero de mensajes de registro,
puede asignar ms subprocesos para mejorar el rendimiento.

Aplique la codificacin
Establezca la propiedad Usar codificacin UTF8? en Verdadero.
UTF-8 a los mensajes escriSi el componente IBM Cognos 8 utiliza una codificacin de varios
tos en un archivo.
bytes, debe establecer esta propiedad en Verdadero y utilizar un
editor UTF-8 para ver el archivo de registro. De lo contrario, es
posible que el archivo de registro contenga caracteres que no
puedan leerse.

4. En la ventana Explorador, en Entorno, haga clic con el botn derecho en Registro y, a continuacin, haga clic en Nuevo recurso, Destino.

Gua de instalacin y configuracin 251

Captulo 11: Opciones de configuracin


5. En el cuadro Nombre, introduzca el nombre del destino.
6. En la lista Tipo, haga clic en el tipo de destino y, a continuacin, haga clic en Aceptar.
7. Si el destino es un archivo, introduzca los valores adecuados para las propiedades obligatorias
y opcionales en la ventana Propiedades.
8. Si el destino es un servidor de registro remoto, introduzca los valores adecuados para las propiedades obligatorias y opcionales en la ventana Propiedades.
Si el URI de distribuidor interno del equipo de destino de IBM Cognos 8 est configurado para
que utilice SSL, en la ventana Propiedades, establezca la propiedad Habilitar SSL en Verdadero.
A continuacin, debe especificar el destino de los mensajes de registro cuando configure el
servidor de registro remoto.
9. Si el destino es una base de datos, en la ventana del Explorador, en Registro, especifique el tipo
de base de datos y sus propiedades de la manera siguiente:

Haga clic con el botn derecho en el nombre de la base de datos y haga clic Nuevo recurso,
Base de datos.

En el cuadro Nombre, introduzca el nombre del destino.

En la lista Tipo, haga clic en el tipo de base de datos y, a continuacin, haga clic en Aceptar.

En la ventana Propiedades, escriba los valores apropiados para las propiedades obligatorias
y opcionales.
Para una base de datos de Microsoft SQL Server, puede elegir utilizar un nmero de puerto,
tal como el 1433, o una instancia con nombre como valor para la propiedad Servidor de
base de datos con nmero de puerto o nombre de instancia.
Para conectarse a una instancia con nombre, debe especificar el nombre de instancia como
una propiedad URL de JDBC o una propiedad de origen de datos. Por ejemplo, puede
escribir localhost\instance1. Si no se especifica una propiedad nombre de instancia, se crea
una conexin a la instancia predeterminada.
Tenga en cuenta que las propiedades especificadas para la instancia con nombre, junto con
el identificador de usuario y contrasea, y el nombre de la base de datos, se utilizan para
crear una URL de JDBC. A continuacin se incluye un ejemplo:
jdbc:JSQLConnect://localhost\\instance1/user=sa/ms propiedades segn sea necesario

Pruebe la conexin con la nueva base de datos. En la ventana Explorador, en Entorno,


haga clic con el botn derecho en Registro y, a continuacin, haga clic en Probar.
Los componentes de IBM Cognos 8 se conectan a la base de datos. Si ha configurado ms
de una base de datos para los mensajes de registro, los componentes de IBM Cognos 8
prueban todas las bases de datos.

10. Repita los pasos del 4 al 9 para cada destino al que desea que el servidor de registro enve los
mensajes.
11. En el men Archivo, haga clic en Guardar.

252 PowerPlay

Captulo 11: Opciones de configuracin


12. En la ventana Explorador, haga clic en Servicio IBM Cognos 8, IBM Cognos 8.
13. En el men Archivo, haga clic en Reiniciar.
Si ha seleccionado una base de datos como destino, los componentes de IBM Cognos 8 crean
las tablas y los campos necesarios en la base de datos que ha creado.
Si el destino era un servidor de registro remoto, configure e inicie el servidor de registro remoto. A
continuacin, reinicie el servicio IBM Cognos 8 en el equipo local.
Si el destino era una base de datos, puede utilizar los componentes de IBM Cognos 8 para ejecutar
los informes de registro desde la base de datos.
Tambin puede establecer el nivel de registro, que controla la cantidad de detalles y el tipo de
mensajes que se envan a un archivo de registro o a una base de datos. Para obtener instrucciones,
consulte la Gua de administracin y seguridad.

Pasos para DB2 en z/OS


1. En el equipo en el que ha instalado Content Manager o los componentes de nivel de aplicacin,
inicie IBM Cognos Configuration.
2. En la ventana Explorador, en Entorno, haga clic en Registro.
3. En la ventana Propiedades, utilice la siguiente tabla a modo de ayuda para configurar las propiedades del servidor de registro.

Tarea

Accin

Utilice TCP entre los compo- Establezca la propiedad Habilitar TCP en Verdadero.
nentes de IBM Cognos 8 en
UDP proporciona una comunicacin ms rpida con un menor
un equipo y su servidor de
riesgo de perder conexiones que TCP.
registro local.
TCP se utiliza para la comunicacin entre un servidor de registro
local y un servidor de registro remoto.
Cambie el nmero de subpro- Escriba el valor de la propiedad Subprocesos de trabajo del
cesos disponibles en el servi- servidor de registro local.
dor de registro local.
Establezca un valor entre 1 y 20. Se recomienda el valor predeterminado de 10. Sin embargo, si tiene un elevado nmero de
mensajes de registro, puede asignar ms subprocesos para
mejorar el rendimiento.
Aplique la codificacin UTF- Establezca la propiedad Usar codificacin UTF8? en Verda8 a los mensajes escritos en dero.
un archivo.
Si el componente IBM Cognos 8 utiliza una codificacin de
varios bytes, debe establecer esta propiedad en Verdadero y
utilizar un editor UTF-8 para ver el archivo de registro. De lo
contrario, es posible que el archivo de registro contenga caracteres que no puedan leerse.

Gua de instalacin y configuracin 253

Captulo 11: Opciones de configuracin


4. En la ventana Explorador, en Entorno, haga clic con el botn derecho en Registro y, a continuacin, haga clic en Nuevo recurso, Destino.
5. En el cuadro Nombre, introduzca el nombre del destino.
6. En la lista Tipo, haga clic en Base de datos y, a continuacin, haga clic en Aceptar.
7. En la ventana Explorador, en Registro, haga clic con el botn derecho en el nombre de la base
de datos y, a continuacin, haga clic en Nuevo recurso, Base de datos.
8. En el cuadro Nombre, introduzca el nombre del destino.
9. En la lista Tipo, haga clic en Base de datos DB2 y, a continuacin, haga clic en Aceptar.
10. En la ventana Propiedades, escriba los valores de Servidor de base de datos y nmero de puerto,
Identificador de usuario y contrasea y Nombre de base de datos de z/OS.
Asegrese de que el identificador de usuario es el mismo que el especificado para el parmetro
IPFSCRIPT_USERNAME en el archivo de script LS_tablespace_db2zOS.sql, (p. 245).
11. En la ventana Explorador , haga clic en Configuracin local.
12. En la ventana Propiedades, junto a Propiedades avanzadas, haga clic en el interior del cuadro
Valor y, a continuacin, haga clic en el botn Editar.
13. Haga clic en Aadir y, a continuacin, aada los siguientes nombres y valores de parmetros
de configuracin:

Nombre de parmetro

Valor

IPFSCRIPT_CREATE_IN

Ubicacin de las tablas base


Por ejemplo, databaseName.baseTablespaceName

IPFSCRIPT_STOGROUP

Nombre del grupo de almacn

IPFSCRIPT_DATABASE

Nombre de la base de datos de registro

IPFSCRIPT_LOB_TABLESPACE

Nombre del espacio de tabla reservado para las


tablas auxiliares en la base de datos de registro

14. En el men Archivo, haga clic en Guardar.


15. Pruebe la conexin con la nueva base de datos. En la ventana Explorador, en Entorno, haga
clic con el botn derecho en Registro y, a continuacin, haga clic en Probar.
Los componentes de IBM Cognos 8 se conectan a la base de datos. Si ha configurado ms de
una base de datos para los mensajes de registro, los componentes de IBM Cognos 8 prueban
todas las bases de datos.

254 PowerPlay

Captulo 11: Opciones de configuracin

Cambio de la configuracin global


Puede cambiar la configuracin global

Para personalizar la compatibilidad de idioma para la interfaz de usuario

Para personalizar la compatibilidad de moneda

Para personalizar la compatibilidad de configuraciones regionales de contenido

Para asignar configuraciones regionales de contenido

Para asignar el idioma utilizado en la interfaz de usuario del producto

Para aadir fuentes a su entorno IBM Cognos

Para personalizar la zona horaria predeterminada

Para cambiar la codificacin de los mensajes de correo electrnico

Para personalizar la configuracin de cookies

De forma predeterminada, los componentes de IBM Cognos 8 garantizan que todas las configuraciones regionales, que pueden provenir de diferentes orgenes y en diversos formatos, utilizan una
forma normalizada. Esto significa que todas las configuraciones regionales ampliadas se ajustan a
una configuracin de idioma y cdigo regional.
Cada equipo tiene una configuracin regional del sistema predeterminada y una configuracin
regional del usuario por usuario. Las configuraciones regionales del usuario pueden ser distintas
de la configuracin regional del sistema predeterminada.
Importante: Si cambia la configuracin global en un equipo Content Manager, debe realizar los
mismos cambios en los otros equipos Content Manager.

Personalizacin de la compatibilidad de idioma en la interfaz de usuario


Utilice la tabla Configuraciones regionales de productos para aadir o eliminar la compatibilidad
de idioma de la interfaz de usuario. Por ejemplo, si no necesita una interfaz de usuario en alemn,
puede eliminar este idioma de la lista.
Si cambia el idioma de la interfaz de usuario del producto, los datos no se ven afectados.
Los archivos de idioma se instalan con el producto IBM Cognos 8 para todos los idiomas admitidos
de la interfaz de usuario. Si desea que los usuarios puedan ver documentacin del producto en un
idioma diferente al ingls, debe instalar el componente Supplementary Languages Documentation.
Para obtener ms informacin, consulte "Instalar documentacin de producto traducida" (p. 166).
Asegrese de que instala las fuentes adecuadas que admitan los conjuntos de caracteres y de los
smbolos de moneda que utiliza. Para que los smbolos de moneda en japons y coreano aparezcan
correctamente, debe instalar las fuentes adicionales del CD de Supplementary Languages Documen-

Gua de instalacin y configuracin 255

Captulo 11: Opciones de configuracin


tation. Para obtener ms informacin, consulte "Instalacin y configuracin de fuentes de idiomas
adicionales" (p. 167).

Pasos
1. Inicie IBM Cognos Configuration en todos los equipos Content Manager.
2. En el men Acciones, haga clic en Editar la configuracin global.
3. Haga clic en la pestaa Configuraciones regionales de productos.
4. Haga clic en Aadir.
Sugerencia: Para eliminar una compatibilidad, seleccione la casilla de verificacin que se
encuentra al lado de Configuracin regional compatible y, a continuacin, haga clic en Eliminar.
5. En la segunda columna, introduzca la parte de idioma de una configuracin regional.
6. Repita los pasos del 4 al 5 para cada compatibilidad de idioma que desee aadir.
7. Haga clic en Aceptar.
8. En el men Archivo, haga clic en Guardar.

Personalizacin de la compatibilidad de moneda


Si necesita monedas adicionales o desea eliminar algunas de la interfaz de usuario, puede actualizar
la lista de monedas compatibles de la tabla Monedas. Si utiliza monedas japonesas o coreanas, debe
configurar la compatibilidad para que los caracteres de yen japons y won coreano se muestren
correctamente.

Adicin de monedas a IBM Cognos 8


Puede aadir monedas admitidas o no admitidas a la interfaz de usuario. Las monedas admitidas
se aaden en IBM Cognos Configuration. Las monedas no admitidas se aaden al archivo
i18n_res.xml que se proporciona en IBM Cognos 8.
De forma predeterminada, los componentes de IBM Cognos 8 slo muestran un subconjunto de
las monedas admitidas en la interfaz de usuario. Las monedas se identifican mediante el cdigo de
moneda ISO 4217. La lista completa de monedas admitidas que pueden aadirse se encuentra en
el archivo i18n_res.xml, situado en el directorio ubicacin_c8\bin.
Si aade un cdigo de moneda que no es compatible, debe aadirlo manualmente en el archivo
i18n_res.xml del directorio ubicacin_c8\bin. Copie este archivo en todos los equipos de IBM
Cognos de su instalacin.
El hecho de aadir monedas al entorno IBM Cognos no garantiza que su equipo disponga de una
fuente con los caracteres necesarios para mostrar la moneda. Asegrese de que instala las fuentes
adecuadas para que los smbolos de moneda que utiliza estn admitidos. Por ejemplo, para mostrar
correctamente el smbolo de moneda de la India (rupia), debe ejecutar un sistema operativo japons
o instalar el idioma japons. Adems, para que los smbolos de moneda en japons y coreano aparezcan correctamente, debe instalar las fuentes adicionales del CD de Supplementary Languages

256 PowerPlay

Captulo 11: Opciones de configuracin


Documentation. Para obtener ms informacin, consulte "Instalacin y configuracin de fuentes
de idiomas adicionales" (p. 167).

Pasos
1. Inicie IBM Cognos Configuration en todos los equipos Content Manager.
2. En el men Acciones, haga clic en Editar la configuracin global.
3. Haga clic en la pestaa Monedas.
4. Haga clic en Aadir.
Sugerencia: Para eliminar la compatibilidad, seleccione la casilla de verificacin que se
encuentra junto al elemento compatible y, a continuacin, haga clic en Eliminar.
5. En la segunda columna, introduzca un valor adecuado.
El valor que aade debe cumplir con los cdigos ISO 4217 de representacin de monedas y
formatos. El valor que se aade suele ser un cdigo alfabtico de tres letras. Los dos primeros
caracteres son letras que representan el cdigo de pas ISO 3166 correspondiente al pas de
origen de la moneda. La letra adicional representa la primera letra de la moneda.
6. Repita los pasos del 4 al 5 para cada tipo de compatibilidad que desea aadir.
7. En el men Archivo, haga clic en Guardar.

Personalizacin de la compatibilidad de configuraciones regionales de contenido


Para asegurarse de que los usuarios ven los informes, los datos o los metadatos en el idioma que
prefieren o en el idioma especfico de su regin, puede aadir configuraciones regionales parciales
(idioma) o completas (idioma-regin) a la tabla Configuraciones regionales de contenido. De este
modo, si el contenido est disponible en varios idiomas o en distintas configuraciones regionales,
se presenta a los usuarios segn su configuracin regional de usuario. De forma predeterminada,
la configuracin regional de contenido reemplaza la configuracin regional de producto en el portal
para parte del contenido.
Si visualiza los informes en tailands, no se admiten dgitos.
Si existe una configuracin regional que no es necesaria, puede eliminarla de la lista. Debe dejar al
menos una configuracin regional de contenido en la lista para que funcione el servidor de informes.
El hecho de aadir configuraciones regionales incompletas (idiomas) a su entorno IBM Cognos no
garantiza que su equipo tenga una fuente que pueda mostrar pginas Web en sus idiomas preferidos.
Asegrese de que instala las fuentes adecuadas que admitan los conjuntos de caracteres y de los
smbolos de moneda que utiliza. Para que los smbolos de moneda en japons y coreano aparezcan
correctamente, debe instalar las fuentes adicionales del CD de Supplementary Languages Documentation. Para obtener ms informacin, consulte "Instalacin y configuracin de fuentes de idiomas
adicionales" (p. 167).

Pasos
1. Inicie IBM Cognos Configuration en todos los equipos Content Manager.

Gua de instalacin y configuracin 257

Captulo 11: Opciones de configuracin


2. En el men Acciones, haga clic en Editar la configuracin global.
3. Haga clic en la pestaa Configuraciones regionales de contenido.
4. Haga clic en Aadir.
Sugerencia: Para eliminar la compatibilidad, seleccione la casilla de verificacin que se
encuentra junto al elemento compatible y, a continuacin, haga clic en Eliminar.
5. En la segunda columna, introduzca un valor adecuado.

Para aadir compatibilidad de idioma para los datos y metadatos de informes, introduzca
una configuracin regional parcial (idioma).

Para aadir compatibilidad especfica de una regin, introduzca una configuracin regional
completa (idioma-regin).

6. Repita los pasos del 3 al 5 para cada configuracin regional adicional que desee admitir.
7. En el men Archivo, haga clic en Guardar.

Asignacin de configuraciones regionales de contenido


Utilice la tabla Asignaciones de configuracin regional de contenido para asignar configuraciones
regionales de usuario a una configuracin regional completa (idioma-regin) o parcial (idioma).
Asimismo, puede asignar el idioma preferido de un usuario a otro idioma si el contenido no est
disponible en el idioma preferido del usuario.
Por ejemplo, si un informe o una tabla de puntuacin no estn disponibles en un idioma preferido,
por ejemplo el vietnamita, pero estn disponibles en francs y alemn, puede utilizar la tabla de
asignaciones de contenido para asignar el idioma preferido (vietnamita) a otro idioma (francs o
alemn). De este modo, el informe o la tabla de puntuacin se visualizan en el idioma asignado.
De forma predeterminada, la tabla Asignaciones de configuracin regional de contenido incluye
configuraciones regionales que no contienen la regin. Esto le permite utilizar slo la parte de idioma
de la configuracin regional cuando especifica configuraciones regionales y garantiza que siempre
visualiza la informacin correcta. Por ejemplo, en una base de datos multilinge, los datos suelen
estar disponibles en varios idiomas, como francs (fr), espaol (es) e ingls (en), en lugar de estar
disponibles en distintas configuraciones regionales, como ingls de Canad (en-ca), ingls de Estados
Unidos (en-us) o francs de Francia (fr-fr).
En los ejemplos siguientes se muestra el mtodo que utilizan los componentes de IBM Cognos 8
para determinar qu informe o tabla de puntuacin visualiza el usuario si hay disponibles versiones
en distintos idiomas.

Ejemplo 1
Un informe est disponible en Content Manager en dos configuraciones regionales, como en-us
(ingls-Estados Unidos) y fr-fr (francs-Francia), pero la configuracin regional del usuario est
definida como fr-ca (francs-Canad). IBM Cognos 8 utiliza la asignacin de configuracin regional
para determinar qu informe visualiza el usuario.

258 PowerPlay

Captulo 11: Opciones de configuracin


En primer lugar, IBM Cognos 8 comprueba si el informe est disponible en Content Manager, en
la configuracin regional del usuario. Si no est disponible en la configuracin regional del usuario,
IBM Cognos 8 asigna la configuracin regional del usuario a una configuracin regional normalizada
configurada en la pestaa Asignaciones de configuracin regional de contenido. Dado que la configuracin regional del usuario es fr-ca, est asignada a fr., IBM Cognos 8 utiliza el valor asignado
para ver si el informe est disponible en fr. En este caso, el informe est disponible en en-us y fr-fr,
no en fr.
A continuacin, IBM Cognos 8 asigna todos los informes disponibles a una configuracin regional
normalizada. Por lo tanto, en-us pasa a ser en y fr-fr se convierte en fr.
Dado que el informe y la configuracin regional del usuario se asignan a fr, el usuario con la configuracin regional de usuario fr-ca ver el informe guardado con la configuracin regional fr-fr.

Ejemplo 2
La configuracin regional del usuario y la configuracin regional del informe se asignan al mismo
idioma. IBM Cognos 8 selecciona qu configuracin regional se debe utilizar. Por ejemplo, si la
configuracin regional de un usuario es en-ca (ingls-Canad) y los informes estn disponibles en
en-us (ingls-Estados Unidos) y en-gb (ingls-Reino Unido), todas las configuraciones regionales se
asignarn a en. El usuario ver el informe en la configuracin regional que elija el producto IBM
Cognos 8.

Ejemplo 3
La configuracin regional del informe y la del usuario no se asignan a un idioma comn. El producto
IBM Cognos 8 elige el idioma. En este caso, es posible que desee configurar una asignacin. Por
ejemplo, si un informe est disponible en en-us (ingls-Estados Unidos) y fr-fr (francs-Francia)
pero la configuracin regional del usuario es es-es (espaol-Espaa), el producto IBM Cognos 8
selecciona el idioma.

Pasos
1. Inicie IBM Cognos Configuration en todos los equipos Content Manager.
2. En el men Acciones, haga clic en Editar la configuracin global.
3. Haga clic en la pestaa Asignaciones de configuracin regional de contenido.
4. Haga clic en Aadir.
5. En el cuadro Clave, introduzca la configuracin regional del usuario:

Para asegurarse de que todas las regiones de una configuracin regional de usuario ven el
contenido en un idioma especfico, introduzca la parte de idioma de la configuracin
regional, seguida de un guin (-) y un asterisco (*).
Por ejemplo, introduzca fr-*.

Para asegurarse de que una configuracin regional de usuario (idioma-regin) ve el contenido


en un idioma especfico, introduzca la configuracin regional completa.
Por ejemplo, introduzca fr-ch.

Gua de instalacin y configuracin 259

Captulo 11: Opciones de configuracin

Para asignar un idioma preferido a otro idioma, introduzca la parte de idioma preferido
de la configuracin regional.
Por ejemplo, introduzca zh.

Sugerencia: Para especificar la configuracin regional que se debe utilizar para un rango de
claves, utilice el carcter comodn (*) con el valor Clave y, a continuacin, en el cuadro Asignacin de configuracin regional, introduzca la configuracin regional. Por ejemplo, si desea que
todas las claves del alemn utilicen la configuracin regional alemana, introduzca de* en el
cuadro Clave y de en el cuadro Asignacin de configuracin regional.
6. En el cuadro Asignacin de configuracin regional, introduzca la parte de idioma de la configuracin regional.
Las configuraciones regionales de usuario especificadas en el cuadro Clave vern el contenido
en este idioma.
7. Repita los pasos del 3 al 5 para otras asignaciones que desee realizar.
8. Haga clic en Aceptar.
9. En el men Archivo, haga clic en Guardar.

Asignacin de configuraciones regionales de productos


Utilice la tabla Asignaciones de configuracin regional de productos para especificar el idioma utilizado en la interfaz de usuario cuando el idioma especificado en la configuracin regional del
usuario no est disponible.
Puede asegurarse de que todas las regiones de una configuracin regional utilizan el mismo idioma
o de que una configuracin regional completa especfica (idioma-regin) utiliza un idioma concreto.
De forma predeterminada, el usuario ve la interfaz del producto en el idioma que coincide con la
configuracin de idioma de la configuracin regional de usuario.

Pasos
1. Inicie IBM Cognos Configuration en todos los equipos Content Manager.
2. En el men Acciones, haga clic en Editar la configuracin global.
3. Haga clic en la pestaa Asignaciones de configuracin regional de productos.
4. Haga clic en Aadir.
5. En el cuadro Clave, introduzca la configuracin regional del usuario:

Para asegurarse de que todas las regiones de una configuracin regional ven la interfaz de
usuario en un idioma especfico, introduzca la parte de idioma de la configuracin regional,
seguida de un guin (-) y un asterisco (*).
Por ejemplo, introduzca es-*.

260 PowerPlay

Para asegurarse de que una configuracin regional completa (idioma-regin) ve la interfaz


de usuario en un idioma especfico, introduzca la configuracin regional completa.

Captulo 11: Opciones de configuracin


Por ejemplo, introduzca es-es.

Para asignar un idioma preferido a otro idioma, introduzca la parte de idioma preferido
de la configuracin regional.
Por ejemplo, introduzca zh.

Sugerencia: Para especificar la configuracin regional que se debe utilizar como predeterminada,
utilice el carcter comodn (*) para el valor Clave y, a continuacin, en el cuadro Asignacin
de configuracin regional, introduzca la configuracin regional.
6. En el cuadro Asignacin de configuracin regional, introduzca la parte de idioma de la configuracin regional.
Las configuraciones regionales de usuario especificadas en el cuadro Clave vern el contenido
en este idioma.
7. Repita los pasos del 3 al 5 para otras asignaciones que desee realizar.
8. Haga clic en Aceptar.
9. En el men Archivo, haga clic en Guardar.

Personalizacin de la zona horaria del servidor


Puede personalizar la zona horaria utilizada por Content Manager seleccionando una zona horaria
del servidor distinta en IBM Cognos Configuration.
Para las instalaciones UNIX que no admiten una interfaz grfica de usuario basada en Java, puede
visualizar la lista de zonas horarias aceptadas abriendo IBM Cognos Configuration en el equipo
con Windows en el que se ha instalado Framework Manager.
Content Manager est configurado para utilizar de forma predeterminada la zona horaria de su
sistema operativo. Todas las actividades planificadas en IBM Cognos 8 se establecen con esta zona
horaria. Adems, los usuarios de IBM Cognos Connection utilizan esta zona horaria si configuran
sus preferencias para la zona horaria predeterminada. Para obtener ms informacin acerca de la
configuracin de preferencias de usuario en IBM Cognos Connection, consulte la Gua de administracin y seguridad.

Pasos
1. Inicie IBM Cognos Configuration.
2. En el men Acciones, haga clic en Editar la configuracin global.
3. En la ventana Configuracin global, haga clic en la pestaa General.
4. Haga clic en la columna Valor correspondiente a Zona horaria del servidor y seleccione otra
zona horaria de la lista.
5. En el men Archivo, haga clic en Guardar.

Gua de instalacin y configuracin 261

Captulo 11: Opciones de configuracin

Cambio de la codificacin de los mensajes de correo electrnico


De forma predeterminada, los componentes de IBM Cognos 8 utilizan la codificacin UTF-8 en los
correos electrnicos. Este valor define la codificacin predeterminada que utiliza el servicio de
entrega en esta instancia para todos los mensajes de correo electrnico. Es posible que tenga clientes
de correo electrnico antiguos o que enve correos electrnicos desde IBM Cognos 8 a telfonos
mviles y PDA que no reconocen UTF-8. Si es as, puede cambiar la codificacin del correo electrnico por un valor que funcione en todos los clientes de correo electrnico (por ejemplo, ISO-88591, Shift-JIS). Deben cambiarse todas las instancias de IBM Cognos 8 que tienen un servicio de
entrega disponible.
La codificacin especificada afecta a todo el mensaje, incluido el asunto, los archivos adjuntos, el
nombre de los archivos adjuntos y el texto del cuerpo sin formato o HTML.

Juego de caracteres

Valor de codificacin admitido

UTF-8

utf-8

Europeo Occidental (ISO 8859-1)

iso-8859-1

Europeo Occidental (ISO 8859-15)

iso-8859-15

Europeo Occidental (Windows-1252)

windows-1252

Europeo Central y Oriental (ISO 8859-2)

iso-8859-2

Europeo Central y Oriental (Windows-1250)

windows-1250

Cirlico (ISO 8859-5)

iso-8859-5

Cirlico (Windows-1251)

windows-1251

Turco (ISO 8859-9)

iso-8859-9

Turco (Windows-1254)

windows-1254

Griego (ISO 8859-7)

iso-8859-7

Griego (Windows-1253)

windows-1253

Japons (EUC-JP)

euc-jp

Japons (ISO-2022-JP)

iso-2202-jp

Japons (Shift-JIS)

shift_jis

Chino tradicional (Big5)

big5

262 PowerPlay

Captulo 11: Opciones de configuracin

Juego de caracteres

Valor de codificacin admitido

Chino simplificado (GB-2312)

gb2312

Coreano (EUC-KR)

euc-kr

Coreano (ISO 2022-KR)

ISO 2022-KR

Coreano (KSC-5601)

ksc_5601

Tailands (Windows-874)

windows-874

Tailands (TIS-620)

tis-620

Pasos
1. Inicie IBM Cognos Configuration.
2. En el men Acciones, haga clic en Editar la configuracin global.
3. En la ventana Configuracin global, haga clic en la pestaa General.
4. Haga clic en la columna Valor correspondiente a la propiedad Codificacin del correo electrnico.
5. Desplcese hasta la configuracin que desea y seleccinela.
6. En el men Archivo, haga clic en Guardar.

Personalizacin de la configuracin de las cookies


Segn los requisitos de su entorno IBM Cognos, puede necesitar modificar la configuracin que
utilizan los componentes de IBM Cognos 8 para crear cookies. Puede utilizar IBM Cognos Configuration para personalizar el dominio, la ruta de acceso y el indicador de proteccin de las cookies.
Los componentes de IBM Cognos 8 determinan el dominio de las cookies a partir de la solicitud
HTTP enviada por el cliente, que suele ser un explorador Web. En la mayora de las configuraciones
de red, las solicitudes HTTP pasan por intermediarios como servidores proxy y servidores de
seguridad mientras se transmiten desde el explorador a los componentes de IBM Cognos 8. Algunos
intermediarios modifican la informacin que los componentes de IBM Cognos 8 utilizan para
calcular el dominio de las cookies, y los componentes de IBM Cognos 8 no pueden configurar las
cookies posteriormente. El sntoma habitual de este problema es que se solicita repetidamente a los
usuarios que inicien sesin. Para evitar este problema, configure el dominio de las cookies.
Para definir el valor correcto para el dominio de las cookies, utilice el formato y el valor que
representan la mxima cobertura para el host.

Host

Formato para el dominio

Ejemplo

Equipo o servidor

Nombre del equipo o del servidor (sin puntos) miempresa


Gua de instalacin y configuracin 263

Captulo 11: Opciones de configuracin

Host

Formato para el dominio

Ejemplo

El sufijo es .com, .edu, .nombre.sufijo


.gov, .int, .mil, .net u . (dos puntos)
org.

.miempresa.com

Otros

.travelinfo.co.nz

.nombre1.nombre2.sufijo
(tres puntos)

Pasos
1. Inicie IBM Cognos Configuration en todos los equipos Content Manager.
2. En el men Acciones, haga clic en Editar la configuracin global.
3. Haga clic en la pestaa General.
4. Haga clic en la columna Valor que se encuentra en Configuracin de cookies para cada propiedad
que desea cambiar y especifique el valor nuevo.
Si deja la propiedad Dominio en blanco, el distribuidor deriva el dominio a partir del nombre
de host de la solicitud.
5. Haga clic en Aceptar.

Configuracin del enrutador para probar la disponibilidad del


distribuidor
Si utiliza un enrutador para distribuir las solicitudes a los distribuidores de IBM Cognos 8 y el
enrutador puede probar la disponibilidad de un servidor mediante una URL de prueba, puede
configurar el enrutador para que pruebe la disponibilidad de un distribuidor de IBM Cognos 8.

Paso

Configure el enrutador para que utilice una URL con la ruta /p2pd/servlet/ping.
Si el distribuidor no est preparado, obtendr la respuesta siguiente:
503 Servicio no disponible
Si el distribuidor est preparado, obtendr la respuesta siguiente:
200 OK

Cambio de la puerta de enlace


Para mejorar el rendimiento del servidor Web, puede configurar IBM Cognos 8 para que utilice
puertas de enlace alternativas que sustituyan el programa CGI predeterminado. Puede utilizar una
de las puertas de enlace siguientes:

264 PowerPlay

Captulo 11: Opciones de configuracin

Microsoft Internet Application Programming Interface (ISAPI) para los Servicios de Internet
Information Server de Microsoft en Windows

El mdulo del servidor Web Apache

La aplicacin Servlet Gateway Java para los servidores de aplicaciones

No es necesaria ninguna configuracin adicional del servidor Web para utilizar ISAPI. Para acceder
a los componentes de IBM Cognos 8 mediante ISAPI, en IBM Cognos Configuration, cambie la
parte cognos.cgi de la propiedad URI de puerta de enlace por cognosisapi.dll.
Antes de cambiar la puerta de enlace, le recomendamos que se asegure de que la puerta de enlace
CGI predeterminada y su configuracin funcionan en su entorno.

Configuracin de la puerta de enlace para el mdulo del servidor Web Apache de


IBM Cognos
IBM Cognos 8 proporciona tres mdulos Apache. El mdulo Apache de IBM Cognos necesita el
servidor Apache 1.3.x y el mdulo Apache 2 de IBM Cognos necesita el servidor Apache 2.0.x. El
mdulo Apache 2.2 de IBM Cognos necesita el servidor Apache 2.2.x.

Pasos
1. Detenga el servidor Web Apache.
2. Aada el directorio ubicacin_c8/cgi-bin a la variable de entorno adecuada:

En Solaris o Linux, LD_LIBRARY_PATH

En HP-UX,
Para Apache 1.3, SHLIB_PATH
Para Apache 2.0 y Apache 2.2.x, SHLIB_PATH y LD_LIBRARY_PATH

En AIX, LIBPATH

3. En HP-UX PA-RISC, realice lo siguiente:

Asegrese de que la variable de entorno LD_PRELOAD contiene /usr/lib/libcl.2.

Para Apache 1.3, establezca la variable de entorno COG_CGIBIN_DIR en ubicacin_c8/cgi-bin.

4. Vaya al directorio instalacin_Apache/conf.


5. Abra el archivo httpd.conf en un editor.
6. Aada lo siguiente al final de la lista de mdulos de carga:
LoadModule cognos_module "ubicacin_c8/cgi-bin/mdulo.sufijo"
donde mdulo es:

Gua de instalacin y configuracin 265

Captulo 11: Opciones de configuracin

Versin

Mdulo

Apache 1,3

mod_cognos

Apache 2,0

mod2_cognos

Apache 2.2

mod2_2_cognos

y el sufijo es:

Sistema operativo

Sufijo

Windows

dll

Solaris y AIX

so

HP-UX PA-RISC

sl

HP-UX IA y Linux

so

7. Para Apache 1.3, aada lo siguiente al final de la lista de mdulos de adicin:


AddModule mod_cognos.cpp
8. Aada lo siguiente a la seccin de alias:
ScriptAlias /cognos8/cgi-bin "ubicacin_c8/cgi-bin"
Alias /cognos8 "ubicacin_c8/webcontent"
<Directory "ubicacin_c8/webcontent">
Options Indexes MultiViews
</Directory>

La directiva <Directory> es opcional.


Sugerencia: Asegrese de que define el alias cognos8/cgi-bin antes que el alias cognos8.
9. Para Apache 2.2, aada las reglas de seguridad siguientes:
ScriptAlias /cognos8/cgi-bin "ubicacin_c8/cgi-bin"
Alias /cognos8 "ubicacin_c8/webcontent"
<Directory "ubicacinc8/webcontent">
Options Indexes MultiViews
AllowOverride None
Options None
Order allow,deny
Allow from all

266 PowerPlay

Captulo 11: Opciones de configuracin


</Directory>
<Directory "ubicacinc8/cgi-bin">
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>

10. Para Apache 1.3 y Apache 2.0, aada lo siguiente a la seccin de informes de estado del servidor:
<Location /cognos8/cgi-bin/cognos_module>
SetHandler cognos-handler
</Location>

Para Apache 2.2.x, aada lo siguiente a la seccin de informes de estado del servidor:
<Location /cognos8/cgi-bin/cognos_module>
SetHandler cognos-handler
Order allow,deny
Allow from all
</Location>

Introduzca el cdigo exactamente como se especifica. La cadena "mdulo_cognos" hace referencia al mdulo que ha cargado en el paso 6.
11. Para Apache 1.3 y Apache 2.0, para habilitar la pgina de diagnstico de la puerta de enlace,
aada lo siguiente a la seccin de informes de estado del servidor:
<Location /cognos8/cgi-bin/diag_cognos_module>
SetHandler cognos-handler
</Location>

Para Apache 2.2.x, aada lo siguiente a la seccin de informes de estado del servidor:
<Location /cognos8/cgi-bin/cognos_module>
SetHandler cognos-handler
Order allow,deny
Allow from all
</Location>

Introduzca el cdigo exactamente como se especifica. La cadena diag_ es necesaria y la cadena


"mdulo_cognos" hace referencia al mdulo que ha cargado en el paso 6.
12. Para Apache 1.3, en Windows, Solaris y AIX, aada lo siguiente a la seccin de directorios del
usuario:
<IfModule mod_cognos.cpp>
CGIBinDir "ubicacin_c8/cgi-bin"
</IfModule>

13. Para Apache 2.0, aada lo siguiente a la seccin de directorios del usuario:
<IfModule mod_cognos.c>

Gua de instalacin y configuracin 267

Captulo 11: Opciones de configuracin


CGIBinDir "ubicacin_c8/cgi-bin"
</IfModule>

Para Apache 2.2.x, aada lo siguiente a la seccin de directorios del usuario:


<IfModule mod2_2_cognos.c.c>
CGIBinDir "ubicacin_c8/cgi-bin"
</IfModule>

14. Guarde y cierre el archivo.


15. Para Apache 2.0, en HP-UX, habilite la bsqueda de LD_LIBRARY_PATH ejecutando el
comando siguiente en el directorio instalacin_Apache/bin:
chatr +s enable +b enable httpd
16. Inicie el servidor Web Apache.
17. En IBM Cognos Configuration, configure la propiedad URI de puerta de enlace para utilizar
la puerta de enlace apache_mod:
http://nombre_host:puerto/cognos8/cgi-bin/mdulo.sufijo
donde mdulo y sufijo coinciden con los valores mostrados previamente.
18. Los usuarios deben a continuacin especificar el URI del mdulo Apache en el explorador de
la siguiente forma
http://nombre_host/cognos8/mdulo.sufijo
donde mdulo y sufijo coinciden con los valores que ha configurado para el URI de puerta de
enlace en IBM Cognos Configuration.

Configuracin de la puerta de enlace del servlet


Si configura la puerta de enlace del servlet de IBM Cognos para que se ejecute en un servidor de
aplicaciones compatible, su entorno no necesita un servidor Web. El servidor de aplicaciones y la
puerta de enlace del servlet de IBM Cognos sustituyen las funciones proporcionadas por un servidor
Web y otras puertas de enlace de IBM Cognos.
Antes de crear e implementar la puerta de enlace del servlet de IBM Cognos, asegrese de lo siguiente:

El servidor de aplicaciones est instalado y se ejecuta en todos los equipos en los que va a instalarse la puerta de enlace del servlet.

Los componentes de la puerta de enlace de IBM Cognos 8 estn instalados (p. 134) en el mismo
sistema que el servidor de aplicaciones.

El distribuidor de IBM Cognos 8 y los componentes de Content Manager estn instalados y se


ejecutan en el entorno.

La cuenta de usuario del servidor de aplicaciones tiene permisos de acceso completo para la
instalacin de IBM Cognos.
Se recomienda crear un nuevo grupo UNIX o Linux llamado cognos8. Este grupo debe incluir
el usuario que inicia el servidor de aplicaciones y el usuario que tiene los archivos de IBM

268 PowerPlay

Captulo 11: Opciones de configuracin


Cognos. Cambie la propiedad del grupo de los archivos de IBM Cognos al grupo cognos8 y
cambie los permisos de archivo de todos los archivos de IBM Cognos a GROUP READABLE/
WRITABLE/EXECUTABLE. Para que sea ms fcil, tambin puede utilizar la cuenta de usuario
del servidor de aplicaciones para instalar y ejecutar los componentes de IBM Cognos.
Para configurar la puerta de enlace del servlet de IBM Cognos para que se ejecute en su servidor
de aplicaciones, realice lo siguiente:

Cree una instancia JVM independiente si es necesario.


Si tiene previsto ejecutar IBM Cognos 8 y la puerta de enlace del servlet de IBM Cognos en el
mismo servidor de aplicaciones, la puerta de enlace del servlet debe implementarse en una instancia JVM independiente.

Compruebe que los componentes de IBM Cognos estn configurados correctamente.

Configure las variables de entorno.

Actualice el entorno de Java.

Configure la puerta de enlace del servlet de IBM Cognos para que se ejecute en el servidor de
aplicaciones.

Cambie el script de inicio del servidor de aplicaciones si es necesario.

Cambie el archivo de propiedades del distribuidor de IBM Cognos si utiliza el servidor de


aplicaciones Oracle.

Configure las propiedades del servidor de aplicaciones e implemente la puerta de enlace del
servlet de IBM Cognos.

Habilite SSL si es necesario.

Configure el servidor Web.

A continuacin, puede acceder a los componentes de IBM Cognos 8 mediante la puerta de enlace
del servlet de IBM Cognos; para ello, debe introducir el URI de puerta de enlace. Por ejemplo:
http[s]:nombre_host:puerto/ServletGateway
El URI de puerta de enlace del servlet de IBM Cognos distingue entre maysculas y minsculas.

Cambio de la versin de la direccin IP


IBM Cognos 8 es compatible con dos versiones de direccin IP: IPv4 e IPv6. IPv4 utiliza direcciones
IP de 32 bits e IPv6 utiliza direcciones IP de 128 bits. Por ejemplo:

IPv4: 192.168.0.1:80

IPv6: [2001:0db8:0000:0000:0000:148:57ab]:80

En IBM Cognos Configuration, puede seleccionar IPv4 o IPv6 para la comunicacin de IBM Cognos 8
mediante la propiedad Versin de IP para la resolucin del nombre de host. Se utiliza IPv4 de forma
predeterminada.

Gua de instalacin y configuracin 269

Captulo 11: Opciones de configuracin


La configuracin slo se aplica al equipo en el que est definida. Si selecciona Preferencia: pila IPv4,
todas las conexiones de salida de IBM Cognos 8 en este equipo se establecern mediante IPv4, y el
distribuidor slo aceptar conexiones IPv4 de entrada. Si selecciona Preferencia: direcciones IPv6,
todas las conexiones de salida de IBM Cognos 8 en este equipo se establecern mediante IPv6, y el
distribuidor aceptar conexiones tanto IPv4 como IPv6 de entrada.
Los equipos cliente IPv4 pueden comunicarse con los equipos de distribuidor que estn configurados
para IPv6.
Los nombres de host especificados dentro de un URI se resuelven en funcin del valor de la propiedad
Configuracin de red. Sin embargo, si un URI se ha especificado con una direccin numrica, tiene
prioridad respecto a esta configuracin, y la comunicacin se realiza mediante IPv4.
La configuracin slo se aplica al equipo en el que est definida. Si selecciona Utilizacin de direcciones IPv4, todas las conexiones de salida de IBM Cognos 8 en este equipo se establecern mediante
IPv4, y el distribuidor slo aceptar conexiones IPv4 de entrada. Si selecciona Utilizacin de direcciones IPv6, todas las conexiones de salida de IBM Cognos 8 en este equipo se establecern mediante
IPv6, y el distribuidor aceptar conexiones tanto IPv4 como IPv6 de entrada.
Los equipos cliente IPv4 pueden comunicarse con los equipos de distribuidor que estn configurados
para IPv6.
Los nombres de host especificados dentro de un URI se resuelven en funcin del valor de la propiedad
Versin de IP para la resolucin del nombre de host. Sin embargo, si un URI se ha especificado con
una direccin numrica, tiene prioridad respecto a esta configuracin, y la comunicacin se realiza
mediante IPv4.
Para que IBM Cognos Configuration acepte direcciones IPv6 en las propiedades del URI locales,
debe iniciar IBM Cognos Configuration mediante la opcin -ipv6. Puede especificar la opcin cada
vez que abra IBM Cognos Configuration desde la lnea de comandos.
En Windows, puede establecer la opcin de forma permanente aadindola al acceso directo del
men Inicio.

Pasos para establecer la versin de IP


1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, haga clic en Entorno.
3. Haga clic en el cuadro Valor de Versin de IP para la resolucin del nombre de host y haga
clic en Utilizacin de direcciones IPv4 o Utilizacin de direcciones IPv6.
4. En el men Archivo, haga clic en Guardar.
5. Cierre IBM Cognos Configuration.

Pasos para habilitar manualmente la opcin IPv6 al abrir IBM Cognos Configuration
1. Vaya al directorio ubicacin_c8\bin.
2. Inicie IBM Cognos Configuration incluida la opcin IPv6 en el comando de la siguiente manera:

270 PowerPlay

En Windows, escriba

Captulo 11: Opciones de configuracin


cogconfig.bat -ipv6

En UNIX o Linux, escriba


./cogconfig.sh -ipv6

3. Edite las propiedades del URI que utilizan formato IPv6, especifique los valores y, a continuacin,
en el men Archivo, haga clic en Guardar.

Pasos para abrir siempre IBM Cognos Configuration con la opcin IPv6 en Windows
1. En el men Inicio, seleccione Programas, IBM Cognos 8 y, a continuacin, haga clic con el
botn derecho del ratn en IBM Cognos Configuration, Propiedades.
2. En la pestaa Acceso directo, en el cuadro Destino, escriba
"ubicacin_c8\bin\cogconfigw.exe -ipv6"
3. Haga clic en Aceptar.

Actualizacin de las propiedades de ubicacin de archivo en


Windows Vista
Si instala componentes de cliente de IBM Cognos 8 en un entorno que incluye Windows Vista, debe
cambiar las propiedades de ubicacin de archivo en IBM Cognos Configuration, de manera que
IBM Cognos 8 pueda utilizar una ubicacin de datos nica para todos los usuarios. Los cambios
deben realizarse en todos los equipos en los que hay instalados componentes de cliente de IBM
Cognos 8.
Windows Vista tiene una mejora de seguridad que impide a mltiples usuarios compartir ubicaciones
de datos. Puede definir variables de entorno y utilizarlas en IBM Cognos Configuration al especificar
ubicaciones de archivo. Esto le permite enviar archivos aplicables a un rea accesible para los
usuarios de IBM Cognos 8. En Windows, hay dos variables de entorno predeterminadas para
usuarios: una para todos los usuarios y otra para el usuario especfico.
Dado que las variables de entorno representan ubicaciones de la raz del sistema, le recomendamos
que tambin incluya el nombre del directorio raz de la ubicacin de instalacin cuando especifique
las ubicaciones de archivo en IBM Cognos Configuration. El directorio raz predeterminado para
IBM Cognos 8 es c8.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana Propiedades haga clic en Ubicacin de archivos de implementacin.
4. Sustituya el elemento de ruta de acceso relativa, "..", por la variable de entorno y el directorio
raz adecuados:

Para una ubicacin de archivo nica por usuario, %LOCALAPPDATA%

Gua de instalacin y configuracin 271

Captulo 11: Opciones de configuracin

Para una ubicacin de archivo nica para todos los usuarios del equipo, %PUBLIC%

Por ejemplo:
Para establecer una ubicacin de archivo nica por usuario, especifique la ruta de acceso
%LOCALAPPDATA%/c8/deployment.
5. Repita el paso 4 para las siguientes propiedades:

En Entorno,
- Ubicacin de archivos de datos
- Ubicacin de archivos de mapa
- Ubicacin de archivos temporales

En Entorno, Registro, Archivo,


- Ubicacin del archivo de registro

En Criptografa,
- Ubicacin del almacn de claves simtricas comunes

En Criptografa, Cognos,
- Ubicacin de certificado
- Ubicacin del almacn de claves de firma
- Ubicacin del almacn de claves de codificacin

6. En el men Archivo, haga clic en Guardar.


Las variables de entorno se resuelven cuando se accede a las ubicaciones de archivo durante las
actividades de sistema.

272 PowerPlay

Captulo 12: Configuracin de Portal Services


Portal Services proporciona un conjunto de portlets de Cognos que puede utilizar en IBM Cognos
Connection y en otros portales. Puede utilizar los portlets para explorar, buscar y ver informes de
IBM Cognos en el entorno de trabajo. Otros usuarios pueden ver la informacin de IBM Cognos
sin necesidad de saber utilizar los productos de IBM Cognos.
Para obtener ms informacin, consulte la Gua de administracin y seguridad.
Portal Services se instala de manera automtica con los componentes de IBM Cognos 8. En un
entorno distribuido, est incluido con los componentes de nivel de aplicacin. La instalacin incluye
los archivos de implementacin para:

SAP Enterprise Portal (SAP EP)

IBM WebSphere Portal

BEA Aqualogic User Interaction (BEA ALUI) Portal

SharePoint Portal

Para algunas implementaciones de Portal Services, debe modificar la configuracin de propiedad


de Portal Services y preparar el entorno de IBM Cognos para admitir el portal.
Al utilizarse en un portal de terceros, Portal Services puede autenticar usuarios en un solo espacio
de nombre. Si los componentes de IBM Cognos 8 se configuran con ms de un espacio de nombre,
debe instalar una puerta de enlace distinta para cada espacio de nombre que se utilizar para
autenticar usuarios del portal. Debe configurar cada puerta de enlace para utilizar el espacio de
nombre apropiado (p. 226) y despus configurar los portlets implementados para utilizar esa puerta
de enlace.
Despus de configurar las propiedades necesarias, debe implementar los portlets de Cognos para
el portal de terceros. Para obtener ms informacin, consulte la Gua de administracin y seguridad.
Para utilizar Portal Services con los componentes de IBM Cognos 8, haga lo siguiente:

Especifique la ubicacin del archivo applications.xml, si es necesario.

Instale y pruebe los portlets en el portal de terceros.


Para obtener ms informacin, consulte la Gua de administracin y seguridad.

Configure la seguridad del entorno del portal de terceros.

Especificacin de la ubicacin del archivo Applications.xml


Si utiliza el archivo applications.xml como parte de un portlet de aplicaciones personalizado, todos
los equipos de componentes de nivel de aplicacin de un entorno distribuido deben hacer referencia
al mismo archivo applications.xml. Si tiene varias instancias del archivo applications.xml, stas
deben ser idnticas.
Licensed Materials Property of IBM
Copyright IBM Corp. 2005, 2009.

273

Captulo 12: Configuracin de Portal Services


Nota: Los pasos solo son necesarios si desea utilizar el portlet Aplicaciones ampliadas, que se incluye
con el IBM Cognos 8 Software Development Kit.

Pasos
1. Inicie IBM Cognos Configuration en el equipo en el que ha instalado el servidor de informes.
2. En la ventana Explorador, en Entorno, haga clic en Portal Services.
3. En la ventana Propiedades, haga clic en Valor junto a Ubicacin de 'applications.xml'.
4. Sustituya localhost por un nombre de host o direccin IP vlidos y, si es necesario, sustituya el
nmero de puerto predeterminado.
5. En el men Archivo, haga clic en Guardar.
Ahora puede implementar los portlets de Cognos en el servidor del portal. Para obtener instrucciones,
consulte la Gua de administracin y seguridad.

Configuracin de la seguridad para Portal Services


Al utilizar Portal Services en un portal distinto a IBM Cognos Connection, debe habilitar el inicio
de sesin nico para proporcionar una integracin perfecta entre ese portal y los componentes de
IBM Cognos 8.
Portal Services utiliza inicio de sesin nico para autenticar a los usuarios. Esto significa que los
usuarios no necesitan iniciar sesin en otras aplicaciones del portal por separado.
Debe configurar un URI en los componentes de IBM Cognos 8 para cada portlet de Portal Services.
Para habilitar la seguridad entre los componentes de IBM Cognos 8 y un portal distinto a IBM
Cognos Connection, haga lo siguiente:

Deshabilite el acceso annimo a los componentes de IBM Cognos 8.


Si debido a su infraestructura de seguridad necesita utilizar otro mtodo para el inicio de sesin
nico, utilice uno de los siguientes mtodos:

Habilite el inicio de sesin nico para el portal mediante secreto compartido.


Si debido a su infraestructura de seguridad necesita utilizar otro mtodo para el inicio de sesin
nico, utilice uno de los siguientes mtodos:

274 PowerPlay

"Habilitacin del inicio de sesin nico para WebSphere Portal mediante el servidor de
aplicaciones" (p. 283)

"Habilitacin del inicio de sesin nico de BEA ALUI Portal mediante la autenticacin
bsica" (p. 283)

"Habilitacin del inicio de sesin nico de BEA ALUI Portal con SiteMinder" (p. 284)

Configure los componentes de IBM Cognos 8 para acceso SSL, si es necesario.

Captulo 12: Configuracin de Portal Services

Deshabilitacin del acceso annimo a los componentes de IBM Cognos 8


Portal Services utiliza el inicio de sesin nico para la autenticacin. Si est habilitado el inicio de
sesin annimo en los componentes de IBM Cognos 8, Portal Services registra a todos los usuarios
del portal como annimos. Debe asegurarse de que el acceso annimo est deshabilitado en los
componentes de IBM Cognos 8 para que se realice correctamente el inicio de sesin nico en Portal
Services. Sin embargo, puede probar las conexiones de Portal Services utilizando el inicio de sesin
annimo para asegurarse de que los portlets estn funcionando en el portal de terceros.
Si Portal Services no puede autenticar un usuario, el usuario recibe un mensaje de error en el portal
de terceros.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, en Seguridad, Autenticacin, haga clic en IBM Cognos.
3. En la ventana Propiedades, asegrese de que Permitir acceso annimo est establecido como
Falso.
4. En el men Archivo, haga clic en Guardar.
5. Repita de los pasos 1 a 4 en todos los servidores donde ha instalado componentes de IBM
Cognos 8.

Habilitacin del inicio de sesin nico mediante secreto compartido


Puede utilizar el secreto compartido para el inicio de sesin nico entre portlets de Cognos y componentes de IBM Cognos 8. Los portlets de Cognos envan un mensaje que contiene una versin
codificada del identificador de usuario del portal. La clave de codificacin est determinada por el
valor de una cadena de caracteres secreta compartida entre los portlets y el proveedor de seguridad
Java personalizado en el servidor de IBM Cognos.
Puede utilizar el secreto compartido para un portal distinto a IBM Cognos Connection slo si los
identificadores de usuario del portal se pueden buscar en un espacio de nombre de autenticacin
de NTLM, LDAP o IBM Cognos Series 7 compartido por los componentes de IBM Cognos 8.
Los componentes de IBM Cognos 8 deben tener acceso a un servidor de directorios que contenga
identificadores de usuario para todos los usuarios del portal. Con IBM Cognos Configuration, debe
configurar un espacio de nombre de autenticacin para que el portal y los componentes de IBM
Cognos 8 compartan el mismo origen de autenticacin.
Tambin debe crear un espacio de nombre de proveedor Java personalizado para registrar el proveedor Java de secreto compartido proporcionado con los componentes de IBM Cognos 8. En los
portlets o iViews, debe vincular los portlets o iViews al espacio de nombre de proveedor Java personalizado en el portal correspondiente:

iViews de Cognos (SAP EP)

Cognos Portlet Application (WebSphere Portal)

Servidor remoto (BEA ALUI Portal)

Gua de instalacin y configuracin 275

Captulo 12: Configuracin de Portal Services

Cognos WebPart (SharePoint Portal)

No es necesario que configure el acceso al contenido Web de Portal Services. Sin embargo, si
implementa los portlets en un portal distinto a IBM Cognos Connection, puede configurar el acceso
a un URI alternativo para imgenes y contenido Web de Portal Services.

Pasos para configurar los espacios de nombre necesarios


1. En IBM Cognos Configuration, configure un espacio de nombre para autenticar usuarios del
portal.
Para obtener instrucciones acerca de la configuracin de proveedores de autenticacin de LDAP,
NTLM o IBM Cognos Series 7, consulte "Configuracin de los componentes de IBM Cognos 8
para utilizar un proveedor de autenticacin" (p. 171).
2. Para un espacio de nombre de LDAP, configure las siguientes propiedades:

En la propiedad Utilizar identidad externa, cambie el valor a Verdadero.

En la propiedad Asignacin de identidad externa, establezca el valor


(uid=${environment("REMOTE_USER")})
En el caso de SharePoint Portal, si SharePoint se encuentra en una mquina diferente a la
del servidor LDAP, establezca el valor Asignacin de identidad externa en
(uid=${replace(${environment("REMOTE_USER")},"SharePoint_Server\\","")})

3. Para un espacio de nombre de IBM Cognos Series 7, asigne los identificadores de usuario del
portal a los identificadores de usuario de IBM Cognos Series 7 mediante inicios de sesin del
SO.
Para obtener ms informacin, consulte la documentacin de IBM Cognos Series 7.
4. En IBM Cognos Configuration, cree y configure un espacio de nombre de proveedor Java personalizado.

En el caso de la propiedad ID de espacio de nombre, especifique los identificadores nuevos.


Por ejemplo, cpstrusted.
Este nuevo identificador debe utilizarse en los valores de configuracin del portlet.

En la propiedad Nombre de clase Java, escriba


com.cognos.cps.auth.CPSTrustedSignon
Los nombres de clase Java distinguen entre maysculas y minsculas.

5. En IBM Cognos Configuration, en Entorno, Portal Services, configure las siguientes propiedades:

En Identificador de espacio de nombre de inicio de sesin de confianza escriba el ID de


espacio de nombre del espacio de nombre de LDAP, NTLM o IBM Cognos Series 7 que
ha configurado en el paso 1.
Sugerencia: El espacio de nombre de inicio de sesin de confianza acta como intermediario
y debe estar asociado a un espacio de nombre basado en directorios real de tipo LDAP,
NTLM o IBM Cognos Series 7.

276 PowerPlay

Captulo 12: Configuracin de Portal Services

En Secreto compartido, escriba la clave que se utilizar para el inicio de sesin nico.
Este parmetro representa el secreto de autorizacin que debe compartirse entre los portlets
de Cognos y el servidor de IBM Cognos. Considrelo una contrasea secreta. Debe utilizar
la misma cadena de caracteres cuando configure la aplicacin del portlet. Debe utilizar una
sola palabra como clave.
Por razones de seguridad, se recomienda especificar un valor no nulo.

6. En Entorno, en Configuracin de puerta de enlace, establezca el valor de la propiedad Permitir


reemplazo de espacio de nombre en true.
7. En el men Archivo, haga clic en Guardar.
8. Reinicie el servicio de IBM Cognos 8.

Pasos para configurar el acceso al contenido Web de Portal Services


1. En el equipo en el que ha instalado los componentes de nivel de aplicacin, inicie IBM Cognos
Configuration.
2. En la ventana Explorador, en Entorno, haga clic en Portal Services.
3. En la ventana Propiedades, haga clic en el cuadro Valor, situado junto a URI de contenido
Web.
4. Especifique el nombre de host o la direccin IP de la puerta de enlace y un nmero de puerto
utilizando el formato:
host_o_direccin_IP:puerto
5. En el men Archivo, haga clic en Guardar.

Pasos para configurar los iViews de Cognos en SAP EP


1. Abra el editor de iView para cada iView de Cognos.
2. En el cuadro Property Category, seleccione Show All.
3. En la propiedad cpsauthsecret: CPS Authorization Secret, introduzca la cadena de caracteres
secreta que utiliz en la propiedad Secreto compartido al configurar el espacio de nombre de
proveedor Java personalizado.
4. En la propiedad cps: authentication namespace ID, introduzca el ID de espacio de nombre de
proveedor Java personalizado.
5. En la propiedad cpsserver: CPS Connection Server, introduzca la ruta URL para acceder a
componentes de Portal Services a travs de la puerta de enlace.
El formato de la URL es el siguiente:

Para portlets de contenido de Cognos:


URI_puerta_enlace/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl
Ejemplo para una puerta de enlace CGI:

Gua de instalacin y configuracin 277

Captulo 12: Configuracin de Portal Services


http://miservidor/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/nav?wsdl&b_action=cps.
wsdl
Ejemplo para una puerta de enlace del servlet:
http://172.0.16.1:9500/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl

Para las Aplicaciones ampliadas de Cognos:


URI_puerta_enlace/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl
Ejemplo para una puerta de enlace CGI:
http://miservidor/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.
wsdl
Ejemplo para una puerta de enlace del servlet:
http://172.0.16.1:9500/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl

Para portlets de lista de supervisin de IBM Cognos Metrics Manager:


URI_puerta_enlace/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl
Ejemplo para una puerta de enlace CGI:
http://miservidor/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.
wsdl
Ejemplo para una puerta de enlace del servlet:
http://172.0.16.1:9500/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl

Pasos para configurar los portlets de Cognos en WebSphere Portal


1. Para cada aplicacin de portlet de Cognos, haga clic en Modify Parameters.
2. En la propiedad cps_auth_secret, introduzca la cadena de caracteres secreta que ha utilizado
en la propiedad Secreto compartido al configurar el espacio de nombre de proveedor Java
personalizado.
3. En la propiedad cps_auth_namespace, introduzca el ID de espacio de nombre de proveedor
Java personalizado.
4. En la propiedad CPS Endpoint, introduzca la ruta URL para acceder a componentes de Portal
Services a travs de la puerta de enlace.
El formato de la URL es el siguiente:

Para portlets de contenido de Cognos:


URI_puerta_enlace/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl
Ejemplo para una puerta de enlace CGI:
http://miservidor/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/nav?wsdl&b_action=cps.
wsdl
Ejemplo para una puerta de enlace del servlet:
http://172.0.16.1:9500/wsrp/cps4/portlets/nav?wsdl&b_action=cps.wsdl

278 PowerPlay

Captulo 12: Configuracin de Portal Services

Para las Aplicaciones ampliadas de Cognos:


URI_puerta_enlace/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl
Ejemplo para una puerta de enlace CGI:
http://miservidor/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.
wsdl
Ejemplo para una puerta de enlace del servlet:
http://172.0.16.1:9500/wsrp/cps4/portlets/sdk?wsdl&b_action=cps.wsdl

Para portlets de lista de supervisin de Metrics Manager:


URI_puerta_enlace/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl
Ejemplo para una puerta de enlace CGI:
http://miservidor/cognos8/cgi-bin/cognos.cgi/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.
wsdl
Ejemplo para una puerta de enlace del servlet:
http://172.0.16.1:9500/wsrp/cps4/portlets/cmm?wsdl&b_action=cps.wsdl

Pasos para configurar el servidor remoto en BEA Aqualogic User Interaction (BEA ALUI)
Portal
1. Con un editor ASCII sin formato, como el Bloc de notas, edite el archivo cpspt.properties del
directorio ubicacin_c8/cps/bea_aqualogic/webapps/gadgets/WEB-INF/classes.
2. Configure los siguientes valores:

Parmetro

Valor

cps_endpoint La URL para conectar al servidor de informes y extraer la informacin del


WSDL.
Especifique el URI a la puerta de enlace.
Para un servlet o una puerta de enlace ISAPI, sustituya la parte localhost/
cognos8/cgi-bin/cognos.cgi con los valores para hacer referencia a la puerta
de enlace.
Por ejemplo:
http://nombre_host/cognos8/cgi-bin/cognos.isapi/wsrp/cps4/portlets/
[package]?wsdl&b_action=cps.wsdl
forward_coo- Los nombres de la cookie que deben enviarse al servidor de informes para el
kies=
inicio de sesin nico.
Dejar en blanco.

Gua de instalacin y configuracin 279

Captulo 12: Configuracin de Portal Services

Parmetro

Valor

cps_auth_
secret

El cdigo de secreto compartido que IBM Cognos 8 utiliza para codificar una
variable de encabezado HTTP que contiene la identidad del usuario.
Este parmetro representa el secreto de autorizacin que debe compartirse
entre los portlets de Cognos y el servidor de IBM Cognos 8. Considrelo una
contrasea secreta. Utilice el mismo valor que ha utilizado para Secreto compartido en IBM Cognos Configuration.
Por razones de seguridad, se recomienda especificar un valor no nulo.

cps_auth_
namespace

El ID de espacio de nombre para el proveedor Java personalizado.

3. Vaya al directorio ubicacin_c8/cps/bea_aqualogic y ejecute el siguiente archivo de creacin:

En UNIX o Linux, build.sh

En Windows, build.bat

Esto crea un archivo cps-alui.war en el directorio ubicacin_c8/cps/bea_aqualogic/gadgets.


4. Si los componentes de IBM Cognos 8 se estn ejecutando con Tomcat:

Detenga IBM Cognos 8.

Copie el archivo cps-alui.war en el directorio ubicacin_c8/webapps.


Tomcat expande automticamente el archivo WAR e inicia el servidor remoto.

Inicie IBM Cognos 8.

5. Si los componentes de IBM Cognos 8 se estn ejecutando en otro tipo de servidor de aplicaciones,
copie el archivo cps-alui.war en el servidor de aplicaciones.
Para obtener instrucciones, consulte la gua de administracin del servidor de aplicaciones.
El inicio de sesin nico est configurado.

Pasos para configurar las propiedades de Cognos WebPart en SharePoint Portal


1. Con un editor ASCII sin formato, como el Bloc de notas, edite el archivo web.config del directorio unidad\Archivos de programa\Common Files\Microsoft Shared\web server extensions\12\
CONFIG .
2. Busque la siguiente cadena:
<SSO cps_auth_namespace="" cps_auth_secret="" />

3. Establezca cps_auth_namespace en el ID de espacio de nombre del espacio de nombre de proveedor Java personalizado.
4. Establezca cps_auth_secret en el valor que ha utilizado para Secreto compartido en IBM Cognos
Configuration.
280 PowerPlay

Captulo 12: Configuracin de Portal Services

Habilitacin del inicio de sesin nico de SAP EP con el vale de inicio de sesin
de SAP
Si habilita el inicio de sesin nico con el vale de inicio de sesin de SAP, debe configurar los componentes de IBM Cognos 8 con un espacio de nombre de SAP que vincule con un servidor SAP BW.
Despus debe copiar el certificado generado durante la instalacin de SAP EP en el entorno de
seguridad personal SAP BW.
Los usuarios deben tener el mismo identificador de usuario en todos los sistemas SAP a los que se
accede a travs del inicio de sesin nico.
Antes de empezar, asegrese de:

Haber configurado los componentes de IBM Cognos 8 para utilizar un origen de autenticacin
de SAP.

Haber habilitado el inicio de sesin nico entre los componentes de IBM Cognos 8 y SAP BW.

Haber instalado los ltimos paquetes de servicios en el servidor SAP BW.


Los paquetes de servicios se pueden descargar de SAPNET.

Haber instalado los ltimos parches en el portal SAP.

Haber instalado el complemento de Enterprise Portal correspondiente a la versin de SAP EP


o al servidor SAP BW.
Para versiones de SAP anteriores a 6.2, descargue EP50_PLUG-IN de Basis 620 (SAPKINE32A)
en SAPNET. Con la transaccin SAINT, instale SAPKINE32A.

Haber instalado la biblioteca de seguridad de SAP en los servidores SAP BW.


Desde sapservX, en /general/misc/security/SAPSECU/platform, descargue sapsecin y sepsecu.dll
y coloque ambos archivos en el directorio /run del servidor SAP BW.

Para habilitar SSO en SAP EP, complete los procedimientos para inicio de sesin nico con vales
de inicio de sesin de SAP de la publicacin SAP Enterprise Portal Security Guide.
Ya puede utilizar los iViews de Cognos en SAP Enterprise Portal. Para obtener ms informacin,
consulte la Gua de administracin y seguridad.

Habilitacin del inicio de sesin nico de SAP EP con asignacin de usuario


Si habilita el inicio de sesin nico con asignacin de usuario, define un origen de datos de IBM
Cognos en SAP EP. Los usuarios individuales o un administrador pueden introducir los identificadores de usuario y contraseas para componentes de IBM Cognos 8 en el origen de datos. Debe
asignar las credenciales de inicio de sesin de los usuarios del origen de datos a un espacio de
nombre de LDAP, IBM Cognos Series 7 o NTLM. Los iViews de Portal Services transmiten las
credenciales de inicio de sesin a los componentes de IBM Cognos 8 mediante la autenticacin
bsica HTTP.

Pasos para preparar el entorno


1. Configure el URI de puerta de enlace que utilizar Portal Services para solicitar la autenticacin
mediante la autenticacin bsica HTTP.
Gua de instalacin y configuracin 281

Captulo 12: Configuracin de Portal Services


Para obtener informacin sobre cmo configurar una URL para utilizar la autenticacin bsica
HTTP, consulte la documentacin de la puerta de enlace o del servidor Web.
2. Ajuste la configuracin de iView para acceder a la URL segura.
Para obtener informacin, consulte la documentacin del servidor Web.
3. En IBM Cognos Configuration, configure un espacio de nombre para autenticar usuarios del
portal.
4. Si utiliza un espacio de nombre de LDAP, configure las siguientes propiedades:

En la propiedad Utilizar identidad externa, cambie el valor a Verdadero.

En la propiedad Asignacin de identidad externa, establezca el valor


(uid=${environment("REMOTE_USER")})

Pasos para crear el origen de datos y asignar los usuarios


1. En el portal SAP, asegrese de que las siguientes propiedades estn configuradas para el origen
de datos del directorio /PortalContent/other_vendors/every_user/com.cognos.pct.c8/systems/
Cognos 8:

Logon Method = UIDPW

server name = el nombre del servidor de IBM Cognos

port number = nmero de puerto de la puerta de enlace

Protocol of Target system = HTTP

User Mapping Type = admin, usuario

system alias (Crear un alias del sistema)

Para obtener ms informacin, consulte la publicacin SAP Enterprise Portal Administration


Guide.
2. En cada iView de Cognos, habilite la asignacin de usuario para el origen de datos introduciendo
el nombre del alias del sistema en el nivel iView, en un atributo denominado CPS: User Mapping
Datasource.
Para obtener ms informacin, consulte la publicacin SAP Enterprise Portal Administration
Guide.
3. En cada iView de Cognos, configure la propiedad CPS: Authentication Namespace ID con el
espacio de nombre que desee utilizar para la autenticacin.
4. Registre las credenciales de IBM Cognos para los usuarios del portal.
Los usuarios pueden introducir sus propios identificadores de usuario y contraseas.
Para obtener ms informacin, consulte la publicacin SAP Enterprise Portal Administration
Guide.
Se recomienda habilitar una comunicacin segura entre SAP EP e IBM Cognos 8.

282 PowerPlay

Captulo 12: Configuracin de Portal Services


Ya puede utilizar los iViews de Cognos en SAP Enterprise Portal. Para obtener ms informacin,
consulte la Gua de administracin y seguridad.

Habilitacin de comunicacin segura entre SAP EP y componentes de IBM Cognos


8
Entre SAP EP y componentes de IBM Cognos 8 no se necesita una conexin segura con SSL. Es
ms importante si ha habilitado el inicio de sesin nico con asignacin de usuario.
La seguridad de SSL admitida por SAP utiliza codificacin por encima de 56 bits. De manera predeterminada, los componentes de IBM Cognos 8 utilizan un algoritmo de codificacin hasta 56
bits. IBM Cognos proporciona un mdulo de codificacin mejorada como producto complementario.
Para habilitar SSL, debe adquirir e instalar el Enhanced Encryption Module de OpenSSL encima
de los componentes de IBM Cognos 8. Para obtener ms informacin, consulte la publicacin IBM
Cognos Enhanced Encryption Module for OpenSSL Installation and Configuration Guide.
Para habilitar SSL entre SAP EP y componentes de IBM Cognos 8, consulte la documentacin de
seguridad de SAP EP.
Despus de habilitar SSL, edite las propiedades de todos los iViews para que la propiedad cpsserver:
CPS Connection Server utilice https en lugar de http.
Ya puede utilizar los portlets de Cognos en SAP Enterprise Portal. Para obtener ms informacin,
consulte la Gua de administracin y seguridad.

Habilitacin del inicio de sesin nico para WebSphere Portal mediante el servidor
de aplicaciones
Los portlets de Portal Services pueden utilizar los objetos de credenciales activas proporcionados
por WebSphere Portal para conectarse a componentes de IBM Cognos 8. Portal Services admite los
siguientes objetos de credenciales activas: HttpBasicAuth, LtpaToken, SiteMinderToken y WebSealToken.
Las credenciales del usuario del portal se transmiten a la puerta de enlace con este objeto. Para
obtener ms informacin sobre objetos de credenciales activas, consulte la documentacin de IBM
WebSphere Portal.
Para utilizar el inicio de sesin nico de servidor de aplicaciones, consulte la documentacin del
servidor de aplicaciones IBM WebSphere.
Para obtener informacin acerca de SSL para componentes de IBM Cognos 8 en un servidor de
aplicaciones WebSphere, consulte "Configuracin de SSL para IBM Cognos 8" (p. 237).
Despus de configurar el inicio de sesin nico, puede utilizar los portlets de Cognos en WebSphere
Portal. Para obtener ms informacin, consulte la Gua de administracin y seguridad.

Habilitacin del inicio de sesin nico de BEA ALUI Portal mediante la autenticacin bsica
Puede configurar un portlet en BEA ALUI Portal para enviar el nombre de usuario y contrasea
como encabezado de autenticacin bsica HTTP. El encabezado se puede utilizar con un espacio

Gua de instalacin y configuracin 283

Captulo 12: Configuracin de Portal Services


de nombre de autenticacin de NTLM, LDAP o IBM Cognos Series 7 para proporcionar inicio de
sesin nico.

Pasos
1. En IBM Cognos Configuration, configure un espacio de nombre para autenticar usuarios del
portal.
2. Instale una puerta de enlace del servlet, CGI o ISAPI alternativa en IBM Cognos 8.
3. Configure la nueva puerta de enlace.
Para obtener instrucciones, consulte "Configuracin de las propiedades de entorno para los
equipos de puerta de enlace" (p. 140)
4. En la consola de administracin del servidor Web, configure los directorios virtuales para
acceder a la puerta de enlace.
Para obtener ms informacin, consulte "Configuracin del servidor Web" (p. 137).
5. Configure el servidor remoto de BEA ALUI para acceder a IBM Cognos 8:

Edite el archivo cpspt.properties del directorio ubicacin_c8/cps/bea_aqualogic/webapps/


gadgets/WEB-INF/classes.

Cambie la propiedad cps_endpoint para indicar la URL de la puerta de enlace.


En una puerta de enlace CGI, puede utilizar la configuracin predeterminada si la puerta
de enlace y el servidor remoto se encuentran en el mismo equipo. De lo contrario, sustituya
la parte localhost por nombre_host:puerto
Para un servlet o una puerta de enlace ISAPI, sustituya la parte localhost/cognos8/cgi-bin/
cognos.cgi con los valores para hacer referencia a la puerta de enlace.
Por ejemplo:
http://nombre_host:puerto/cognos8/cgi-bin/cognos.isapi/wsrp/cps4/portlets/
[package]?wsdl&b_action=cps.wsdl

Establezca la propiedad cps_auth_namespace con el espacio de nombre que desee utilizar


para la autenticacin.

Habilitacin del inicio de sesin nico de BEA ALUI Portal con SiteMinder
Si utiliza eTrust SiteMinder para proporcionar inicio de sesin nico en la infraestructura de seguridad, tambin puede utilizarlo para inicio de sesin nico con BEA ALUI Portal.
Debe configurar un espacio de nombre de autenticacin de SiteMinder en IBM Cognos 8. BEA
ALUI Portal enva la marca de autenticacin activa de SiteMinder al servidor remoto, que enva la
marca a la puerta de enlace de IBM Cognos 8.

Pasos
1. En IBM Cognos Configuration, configure un espacio de nombre de autenticacin de SiteMinder.

284 PowerPlay

Captulo 12: Configuracin de Portal Services


Para obtener ms instrucciones, consulte "Configuracin de los componentes de IBM Cognos
8 para utilizar eTrust SiteMinder" (p. 203).
2. Configure el servidor remoto para reenviar la marca de autenticacin:

Edite el archivo cpspt.properties del directorio ubicacin_c8/cps/bea_aqualogic/webapps/


gadgets/WEB-INF/classes.

Cambie la propiedad forward_cookies para incluir el nombre de la marca de autenticacin


activa que proporciona SiteMinder.

Cambie la propiedad cps_endpoint para indicar la URL de la puerta de enlace.


En una puerta de enlace CGI, puede utilizar la configuracin predeterminada si la puerta
de enlace y el servidor remoto se encuentran en el mismo equipo. De lo contrario, sustituya
la parte localhost por nombre_host:puerto.
Para un servlet o una puerta de enlace ISAPI, sustituya la parte localhost/cognos8/cgi-bin/
cognos.cgi con los valores para hacer referencia a la puerta de enlace.
Por ejemplo:
http://nombre_host:puerto/cognos8/cgi-bin/cognos.isapi/wsrp/cps4/portlets/
[package]?wsdl&b_action=cps.wsdl

Cambie la propiedad cps_auth_namespace al espacio de nombre que desee utilizar para la


autenticacin.

Gua de instalacin y configuracin 285

Captulo 12: Configuracin de Portal Services

286 PowerPlay

Captulo 13: Configuracin de IBM Cognos 8 para


un servidor de aplicaciones
IBM Cognos 8 instala y utiliza Tomcat como servidor de aplicaciones de forma predeterminada.
Si lo prefiere, puede ejecutar IBM Cognos 8 dentro de uno de los siguientes servidores de aplicaciones
compatibles:

Servidor BEA WebLogic

Servidor de aplicaciones IBM WebSphere

Servidor de aplicaciones Oracle

Red Hat JBoss

SAP NetWeaver

Servidor de aplicaciones Sun Java Systems (slo para sistemas operativos Windows, Linux y
Solaris)

Para comprobar que su producto funciona adecuadamente, aplique todas las revisiones mnimas
necesarias del sistema operativo y utilice slo las versiones de software compatibles con un producto
de IBM Cognos.
Para ver una lista actualizada de los entornos compatibles con los productos IBM Cognos, por
ejemplo sistemas operativos, parches, exploradores, servidores Web, servidores de directorio, servidores de base de datos y servidores de aplicaciones, visite el centro de recursos de IBM Cognos
(http://www.ibm.com/software/data/support/cognos_crc.html).
Si lo desea, puede ejecutar la puerta de enlace del servlet de IBM Cognos en un servidor de aplicaciones compatible en lugar de utilizar un servidor Web (p. 268). Si utiliza la puerta de enlace del
servlet, su entorno no necesita ningn servidor Web. El servidor de aplicaciones y la puerta de
enlace del servlet sustituyen las funciones proporcionadas por el servidor Web y las otras puertas
de enlace de IBM Cognos. IBM Cognos 8 debe estar instalado y en funcionamiento para poder
configurar e implementar la puerta de enlace del servlet de IBM Cognos.
Para obtener ms informacin sobre cmo configurar una instalacin distribuida multiservidor de
IBM Cognos 8 en un entorno de servidor de aplicaciones, visite el centro de recursos de IBM Cognos
(http://www.ibm.com/software/data/support/cognos_crc.html).
Para configurar IBM Cognos 8 para que se ejecute en su servidor de aplicaciones, haga lo siguiente:

Cree una instancia JVM independiente si es necesario.

Compruebe que los componentes de IBM Cognos estn configurados correctamente.

Realice una copia de seguridad de los posibles datos y claves de codificacin de IBM Cognos
existentes, si es necesario.

Configure las variables de entorno.

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

287

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones

Actualice el entorno de Java.

Configure los componentes de IBM Cognos para que se ejecuten dentro del servidor de aplicaciones.

Identifique el JDK para WebLogic 9 en AIX, si es necesario.

Cambie el script de inicio del servidor de aplicaciones si es necesario.

Cambie el archivo de propiedades del distribuidor de IBM Cognos si utiliza el servidor de


aplicaciones Oracle.

Configure las propiedades del servidor de aplicaciones e implemente IBM Cognos 8.

Habilite SSL si es necesario.

Configure el servidor Web.

Anule el registro de los distribuidores que ya no se utilicen.

Importe los datos de almacn de contenido con copia de seguridad que haya.

Despus de configurar IBM Cognos 8 para que se ejecute en su servidor de aplicaciones, puede
efectuar tareas de configuracin adicionales para personalizar el comportamiento de los componentes
de IBM Cognos a fin de que se ajusten mejor a su entorno de creacin de informes (p. 213).
Sugerencia: No utilice rutas de acceso de instalacin que contengan espacios en blanco para el servidor de aplicaciones ni para IBM Cognos 8. Dichos espacios afectan a los parmetros de comandos
y scripts internos. Si debe utilizar una ruta de acceso de instalacin que incluya espacios, utilice la
convencin de nomenclatura 8.3 DOS al hacer referencia a esas ubicaciones.

Creacin de una instancia de JVM independiente


Para eliminar posibles conflictos de clase Java o de recursos del sistema, IBM Cognos 8 debe ejecutarse en una instancia de Mquina virtual Java (Java Virtual Machine, JVM) aislada del resto de
aplicaciones existentes. Con ello, se garantiza que IBM Cognos 8 no afecte a ninguna aplicacin
de cliente existente. Siempre que sea posible, IBM Cognos 8 debe instalarse en una instancia de
JVM independiente de los procesos administrativos del servidor de aplicaciones para aislar tanto
IBM Cognos 8 como las funciones administrativas del servidor de aplicaciones.
Se puede establecer una instancia de JVM aislada realizando alguna de las siguientes acciones:

288 PowerPlay

Crear un servidor gestionado independiente en BEA WebLogic

Crear una instancia de servidor independiente en IBM WebSphere

Crear una instancia de OC4J independiente en el servidor de aplicaciones Oracle 10g

Crear una instancia de servidor independiente para Red Hat JBoss

Crear una instancia de Java independiente para SAP NetWeaver

Crear una instancia de servidor independiente para el servidor de aplicaciones Sun Java System

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


Si utiliza la puerta de enlace del servlet de IBM Cognos, debe ejecutarse en una instancia independiente de IBM Cognos 8.

Comprobacin de la configuracin de los componentes de IBM


Cognos
Antes de configurar los componentes de IBM Cognos para que se ejecuten en el servidor de aplicaciones, asegrese de que:

Los componentes de IBM Cognos estn instalados (p. 107).

Antes de iniciar IBM Cognos 8, se ha configurado la base de datos del almacn de contenido.
Instale y configure los clientes de la base de datos si es necesario y, a continuacin, compruebe
la conectividad de la base de datos.

El servidor de aplicaciones est instalado y operativo en todos los equipos donde estn instalados
los componentes de IBM Cognos.
Para obtener ms informacin sobre la instalacin, consulte la documentacin de su servidor
de aplicaciones.

La ubicacin de instalacin completa de todas las fuentes est especificada en todos los equipos
de los componentes de nivel de aplicacin. Esta ubicacin se especifica en IBM Cognos Configuration (p. 229). De manera predeterminada, la ubicacin de instalacin no utiliza una ruta de
acceso completa.

La cuenta de usuario del servidor de aplicaciones tiene permisos de acceso completo para la
instalacin de IBM Cognos.
Sugerencia: Se recomienda crear un nuevo grupo UNIX o Linux llamado cognos8. Este grupo
debe incluir el usuario que inicia el servidor de aplicaciones y el usuario que tiene los archivos
de IBM Cognos. Cambie la propiedad del grupo de los archivos IBM Cognos al grupo cognos8
y cambie los permisos de archivo de todos los archivos de IBM Cognos a GROUP READABLE/
WRITABLE/EXECUTABLE. Para que sea ms fcil, tambin puede utilizar la cuenta de usuario
del servidor de aplicaciones para instalar y ejecutar los componentes de IBM Cognos.

Copia de seguridad de la informacin existente de IBM Cognos


Realice una copia de seguridad de la informacin existente de IBM Cognos si los componentes de
IBM Cognos 8 se estn ejecutando

En un servidor de aplicaciones (incluido Tomcat) y va a pasarse a un servidor de aplicaciones


que viene con su propia JVM.

Con una JVM de un proveedor y va a pasarse a otro proveedor de JVM.

Nota: Debe realizar una copia de seguridad de la informacin existente de IBM Cognos dentro del
entorno de trabajo antes de la actualizacin.
Antes de configurar los componentes de IBM Cognos 8 para que se ejecuten en el nuevo servidor
de aplicaciones o JVM, debe realizar una copia de seguridad de los siguientes elementos:
Gua de instalacin y configuracin 289

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones

Los datos del almacn de contenido, mediante la creacin de una exportacin de implementacin.

La informacin de configuracin, mediante su exportacin. Los datos codificados se descodificarn durante la exportacin.

Las claves criptogrficas, para lo cual deber guardarlas en una ubicacin alternativa. Las
nuevas claves criptogrficas deben crearse utilizando la misma JVM que utiliza el servidor de
aplicaciones. Como estas claves slo se pueden crear si se han eliminado las claves anteriores,
es importante realizar una copia de seguridad de las claves anteriores.

Para garantizar la seguridad e integridad de sus datos de IBM Cognos, realice una copia de seguridad
del almacn de contenido, la informacin de configuracin y las claves criptogrficas en un directorio
que est protegido de accesos no autorizados o no adecuados.
Sugerencia: Para comprobar si existe alguna clave criptogrfica, bsquela en el directorio ubicacin_c8/configuration. Si dicho directorio contiene los subdirectorios csk, encryptkeypair o
signkeypair, significa que existen claves criptogrficas.

Pasos
1. Si hay datos en el almacn de contenido, inicie el servicio de IBM Cognos 8 y exporte todo el
almacn de contenido mediante la herramienta de implementacin.
Para obtener ms informacin, consulte el tema sobre cmo crear una especificacin de
implementacin de exportacin en la Gua de administracin y seguridad.
2. En IBM Cognos Configuration, vaya al men Archivo, haga clic en Exportar como y guarde
la informacin de configuracin en un formato descodificado. Para asignarle un nombre al
archivo, utilice un nombre como "descodificado.xml".
Exporte los datos a un directorio que est protegido de accesos no autorizados o no adecuados,
ya que las contraseas estn guardadas en texto sin formato. Se le solicitar que confirme que
la exportacin no es una operacin segura.
3. Detenga el servicio IBM Cognos 8:

Si utiliza Tomcat, detenga el servicio IBM Cognos 8 y cierre IBM Cognos Configuration.

Si utiliza un servidor de aplicaciones distinto a Tomcat, cierre IBM Cognos 8 en su entorno.

4. Realice una copia de seguridad de las claves criptogrficas existentes, para lo cual deber
guardar los archivos y directorios correspondientes en una ubicacin alternativa protegida.
Los archivos son:

ubicacin_c8/configuration/cogstartup.xml

ubicacin_c8/configuration/caSerial

ubicacin_c8/configuration/cogconfig.prefs

ubicacin_c8/configuration/coglocale.xml

Los directorios son:

290 PowerPlay

ubicacin_c8/configuration/csk

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones

ubicacin_c8/configuration/encryptkeypair

ubicacin_c8/configuration/signkeypair

5. Elimine los archivos caSerial y cogconfig.prefs, adems de los tres directorios (csk, encryptkeypair
y signkeypair).
6. Sustituya el archivo ubicacin_c8/configuration/cogstartup.xml por el archivo que contenga
los datos exportados de IBM Cognos Configuration (por ejemplo, "descodificado.xml").
Importante: En el directorio ubicacin_c8/configuration, el archivo debe utilizar el nombre
"cogstartup.xml".
La informacin de este archivo se volver a codificar automticamente mediante nuevas claves
criptogrficas cuando guarde la configuracin en IBM Cognos Configuration.

Cmo establecer variables de entorno


Debe establecer variables de entorno para identificar la ubicacin del entorno JVM y la ruta de
acceso a la biblioteca. Puede establecer variables de entorno mediante cualquiera de los siguientes
mtodos:

En Windows, establezca una variable de usuario o del sistema, o bien edite el script de inicio
del servidor de aplicaciones.
Si establece una variable de usuario, asegrese de establecerla para la cuenta de usuario que
ejecutar el servidor de aplicaciones, o la consola de administracin.

En UNIX y Linux, establezca una variable de entorno en el perfil de usuario, o bien edite el
script de inicio del servidor de aplicaciones.

Para obtener informacin sobre cmo editar el script de inicio de un servidor de aplicaciones, consulte
"Cambio del script de inicio del servidor de aplicaciones" (p. 295).
Sugerencia: La mayora de las versiones de servidores de aplicaciones vienen con un script especialmente creado para establecer variables de entorno. Por ejemplo, algunas versiones de WebSphere
vienen con setupCmdLine.bat o setupCmdLine.sh, WebLogic viene con setEnv.cmd o setEnv.sh y
Oracle viene con iasenv.bat o iasenv.sh. Estos scripts se pueden modificar para establecer valores
adecuados para su uso con componentes de IBM Cognos. La mayora de estos scripts establecen la
variable de entorno JAVA_HOME de manera predeterminada.

Pasos
1. Establezca la variable de entorno JAVA_HOME para que apunte a la JVM utilizada por el
servidor de aplicaciones.
Sugerencia: Si el servidor de aplicaciones viene con una JVM, la variable de entorno
JAVA_HOME debe establecerse para que haga referencia a ella.
IBM Cognos Configuration utiliza esta variable para crear claves de codificacin para los
componentes de IBM Cognos compatibles con la JVM utilizada por el servidor de aplicaciones.
Por ejemplo, para WebLogic en Windows, la JVM utilizada por el servidor de aplicaciones se
especifica como:
Gua de instalacin y configuracin 291

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


unidad:/ubicacin_WebLogic/jdk142_04
2. Aada ubicacin_c8/bin a la variable de entorno correspondiente.
Esta variable se utiliza para localizar los archivos de bibliotecas de IBM Cognos.

Sistema operativo

Variable de entorno

Windows

PATH

AIX

LIBPATH

Solaris y Linux

LD_LIBRARY_PATH

HP-UX

SHLIB_PATH

Sugerencia: Para instalar varias instancias de IBM Cognos 8 en un solo servidor, establezca la
variable PATH, LIBPATH, LD_LIBRARY_PATH o SHLIB_PATH dentro del mbito de la
instancia del servidor de aplicaciones y no como variable global a fin de garantizar que cada
instancia tenga un valor nico.
Nota: Las variables CRN_ROOT y COG_ROOT ya no son necesarias en un entorno no reagrupado
y deben eliminarse si se utilizaron en una instalacin anterior.

Actualizacin del entorno Java


Los servicios criptogrficos de IBM Cognos 8 utilizan un archivo .jar (Java Archive) especfico,
denominado bcprov-jdknn-nnn, que debe encontrarse en el entorno JVM utilizado por su servidor
de aplicaciones. Este archivo proporciona rutinas de codificacin y descodificacin adicionales no
incluidas con una instalacin de JVM predeterminada. Para garantizar la seguridad, la JVM debe
cargar el archivo de codificacin mediante el directorio de extensiones de Java.

Pasos
1. Compruebe que la variable de entorno JAVA_HOME est configurada en la ubicacin del JRE.
Por ejemplo, para configurar JAVA_HOME en los archivos JRE proporcionados con la instalacin, la ruta es ubicacin_c8/bin/jre/versin.
2. Copie el archivo bcprov-jdknn-nnn.jar del directorio ubicacin_c8/bin/jre/versin/lib/ext al
directorio ubicacin_Java/jre/lib/ext.

Configuracin de los componentes de IBM Cognos para que se


ejecuten dentro del servidor de aplicaciones
IBM Cognos 8 debe configurarse con la informacin de configuracin del servidor de aplicaciones,
y la configuracin debe guardarse para crear nuevas claves criptogrficas. IBM Cognos Configuration
utiliza la JVM definida por la variable de entorno JAVA_HOME.

292 PowerPlay

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


Importante: Establezca la variable de entorno JAVA_HOME en la JVM proporcionada o utilizada
por el servidor de aplicaciones y luego copie los archivos del proveedor de seguridad antes de ejecutar
IBM Cognos Configuration para asegurarse de que se generen claves de codificacin vlidas.

Pasos
1. Desde el directorio ubicacin_c8/bin, inicie IBM Cognos Configuration:

En Windows, escriba cogconfig.bat en una ventana de comando o seleccione IBM Cognos


Configuration en el men Inicio.

En UNIX o Linux, escriba cogconfig.sh.

Si tiene claves de codificacin incompatibles, se le solicitar que genere claves nuevas automticamente en este momento.
Sugerencia: Antes de continuar, asegrese de realizar una copia de seguridad de las claves
existentes en una ubicacin protegida. Despus de generar las nuevas claves, la opcin de deshacer no est disponible.
2. Utilice el Asistente de aplicacin de creacin para crear el archivo de aplicacin que se implementar en el servidor de aplicaciones. Para iniciar el Asistente de aplicacin de creacin desde
IBM Cognos Configuration, vaya a Acciones y haga clic en Crear archivos de aplicacin. El
asistente le permitir seleccionar el tipo de aplicacin que debe crearse y la raz de contexto
utilizada para acceder a la aplicacin.
Cree el archivo de aplicacin en el mismo equipo en el que implementar el archivo.
El valor de la raz de contexto introducido en el asistente debe ser el mismo que el introducido
en la pestaa Entorno y utilizado para la implementacin en el servidor de aplicaciones. Para
IBM Cognos 8, el nombre predeterminado del directorio de aplicacin y de la raz de contexto
es p2pd, y puede utilizarse en la mayora de los casos. Para la puerta de enlace del servlet de
IBM Cognos, el nombre predeterminado del directorio de aplicacin y de la raz de contexto
es ServletGateway. Otros valores predeterminados de implementacin de la aplicacin, como
el nombre de la aplicacin, se pueden cambiar segn las necesidades de su entorno.
Sugerencia: No es necesario volver a crear ni volver a implementar el archivo al realizar cambios
de configuracin, ya que la informacin de configuracin se almacena de forma externa a la
aplicacin.
Para WebLogic y JBoss, puede utilizar el Asistente de aplicacin de creacin de IBM Cognos
Configuration para crear la aplicacin en un directorio expandido.
Por ejemplo, para WebLogic, la aplicacin se instala en C:\bea\user_projects\domains\apps\
p2pd, donde p2pd es el nombre de la aplicacin. En tal caso, al implementar la aplicacin desde
WebLogic Administration Console, seleccionara el directorio p2pd.
Importante: Para JBoss, si utiliza la opcin de expandir archivos en una carpeta, debe incluir
la extensin .war en el nombre de la carpeta en la que el asistente crear la aplicacin p2pd.
Cuando el asistente solicite la ubicacin de la carpeta, vaya a ubicacin_JBoss/server/nombre_instancia/deploy y cree una carpeta llamada p2pd.war.

Gua de instalacin y configuracin 293

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


Para obtener informacin sobre qu tipo de archivo de aplicacin (WAR, EAR o directorio
expandido) es compatible en su entorno, consulte la documentacin de su servidor de aplicaciones.
3. En la ventana Explorador de IBM Cognos Configuration, expanda Entorno y, a continuacin,
cambie las siguientes propiedades para utilizar el nmero de puerto y el nombre de host o la
direccin IP del servidor donde estn instalados el servidor de aplicaciones y el componente de
IBM Cognos 8.

Todos los URI del distribuidor, incluidos:


Los URI de distribuidor para puerta de enlace
El URI de distribuidor externo
URI de distribuidor interno
El URI de distribuidor para aplicaciones externas

El URI de puerta de enlace

URI de Content Manager

El servidor de aplicaciones debe configurarse para que escuche en el nombre de host o la


direccin IP introducidos en el URI. Para obtener ms informacin, consulte la documentacin
de su servidor de aplicaciones.
Si cambia el valor predeterminado de la raz de contexto (p2pd), tambin deber cambiar la
parte de la raz de contexto del URI.
4. En Entorno, Servicio IBM Cognos 8, haga clic con el botn derecho en IBM Cognos 8 y, a
continuacin, haga clic en Eliminar.
La entrada del servicio IBM Cognos 8 se utiliza para configurar los ajustes de entorno para
ejecutarse en Tomcat. Esta entrada no es necesaria si se utiliza un servidor de aplicaciones distinto.
5. Lleve a cabo otros cambios de configuracin necesario, como los que se indican a continuacin:

Especificar las propiedades de la base de datos de Content Manager.

Introducir identificadores de usuario y contraseas.

Si utiliz los ajustes predeterminados para la instalacin de IBM Cognos, es posible que slo
deba realizar pequeos cambios en los ajustes de configuracin predeterminados (p. 213). Puede
revisar la configuracin para instalaciones de un solo equipo (p. 79) o para instalaciones distribuidas (p. 107) a fin de determinar si es necesario algn cambio adicional.
6. Guarde la configuracin.
Se crean nuevas claves criptogrficas mediante la JVM definida por la variable JAVA_HOME.
7. Cierre IBM Cognos Configuration.

294 PowerPlay

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones

Identificacin del JDK para WebLogic 9 en AIX


WebLogic 9 requiere JDK 1.5. Si utiliza WebLogic Server 9 en AIX, deber actualizar las opciones
de Java en el archivo commEnv.sh para especificar el identificador nico (UID) de la versin de
serie correspondiente. Si no realiza esta actualizacin, se producir una incompatibilidad de UID
de versin de serie al utilizar WebLogic Server 9 con IBM Java 5.

Pasos
1. Abra el archivo ubicacin_WebLogic9/common/bin/commEnv.sh.
2. Modifique el archivo para incluir el siguiente comando:
JAVA_OPTIONS="${JAVA_OPTIONS} -Dcom.sun.xml.namespace.QName.
useCompatibleSerialVersionUID=1.0" export JAVA_OPTIONS

3. Guarde y cierre el archivo commEnv.sh.

Cambio del script de inicio del servidor de aplicaciones


Algunos servidores de aplicaciones tienen requisitos especficos de obligado cumplimiento para
poder ejecutar IBM Cognos 8. En funcin del servidor de aplicaciones, es posible que deba definir
variables de entorno, copiar archivos y aadir o cambiar cdigo en archivos.
Si est utilizando BEA WebLogic Server 8.1 o Red Hat JBoss, debe realizar cambios en el script de
inicio del servidor de aplicaciones. El script de inicio debe modificarse para especificar los ajustes
de la JVM. Para JBoss, tambin debe especificar un argumento log4j. Para WebLogic 9, se recomienda
el uso de Administration Console para modificar el entorno WebLogic.
Si utiliza el servidor de aplicaciones IBM WebSphere, SAP NetWeaver 6.40 o el servidor de aplicaciones Oracle, no es necesario ningn cambio en sus scripts de inicio, a menos que desee aadir
cambios en la variable de entorno. Si decide realizar cambios, puede utilizar Administrative Console.
Para Red Hat JBoss, se recomienda crear una copia de la instancia de servidor predeterminada para
que pueda utilizar la instancia de servidor predeterminada original como copia de seguridad. Asigne
un nombre que no contenga espacios a la copia; por ejemplo, cognos.
Si su entorno contiene un JRE que utiliza para otros productos, puede que la carpeta JRE contenga
archivos .jar no compatibles con los archivos .jar incluidos con IBM Cognos 8. Esto puede provocar
un error al iniciar IBM Cognos 8 en el servidor de aplicaciones. En este caso, le recomendamos que
indique a IBM Cognos 8 que utilice los archivos .jar aprobados mediante la inclusin del siguiente
parmetro en la lnea de comandos Java:
-Djava.endorsed.dirs=${cognos8_home}/tomcat[version]/common/endorsed

Pasos para WebLogic


1. Cree un dominio WebLogic Server (WLS) para IBM Cognos 8.
Si configura la puerta de enlace del servlet de IBM Cognos, cree un segundo dominio para esta
aplicacin.
Para obtener informacin sobre la creacin de dominios, consulte la documentacin de
WebLogic.

Gua de instalacin y configuracin 295

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


2. Vaya al directorio correspondiente y abra el script de inicio del servidor de aplicaciones en un
editor. Los posibles directorios son:

ubicacin_WebLogic8.1/user_projects/domains/nombre_dominio

ubicacin_WebLogic9/user_projects/domains/nombre_dominio/bin

El nombre del script de inicio puede variar en funcin del tipo de instalacin de WebLogic llevada
a cabo. Por ejemplo, en una instalacin de servidor gestionado, el nombre del script de inicio
es startManagedWebLogic.sh (UNIX) o startManagedWebLogic.cmd (Windows).
3. Para versiones distintas a IBM JRE, seleccione el modo de ejecucin de JVM y cambie el ajuste
predeterminado de JAVA_VM= a JAVA_VM=-server
4. Modifique las JAVA_OPTIONS para establecer el analizador de XML adecuado para IBM
Cognos 8. Aada la tercera lnea, tal como se muestra en este ejemplo:
JAVA_OPTIONS=
-Dweblogic.security.SSL.trustedCAKeyStore=%WL_HOME%\server\lib\cacerts-Dorg.
xml.sax.driver=org.apache.xerces.parsers.SAXParser

5. Establezca la memoria mnima y mxima utilizada por la JVM.


Normalmente, la memoria se establece utilizando dos parmetros de JVM: -Xms y -Xmx. Se
recomienda un mnimo de 256 MB y un mximo de 768 MB como valores iniciales. Puede
cambiar estos valores para adaptarlos a su entorno.
Para WebLogic 9, tambin hay que establecer el parmetro MaxPermSize. A continuacin se
incluye un ejemplo:
-XX:MaxPermSize=128m

Para obtener informacin sobre los parmetros de la JVM, consulte la documentacin de la


JVM o del servidor de aplicaciones.
6. Asegrese de que el modo de produccin est habilitado.
Para WebLogic 8 y 9, cambie PRODUCTION_MODE= a PRODUCTION_MODE=true
7. Guarde y cierre el archivo.

Pasos para JBoss


1. Vaya al directorio ubicacin_JBoss/bin y abra el script de inicio del servidor de aplicaciones en
un editor. Realice una de las siguientes acciones:

Para Windows, abra run.bat.

Para UNIX o Linux, abra run.sh.

2. Vaya a la variable JAVA_OPTS y aumente la memoria utilizada por la JVM.


Normalmente, la memoria se establece utilizando dos parmetros de JVM: -Xms y -Xmx. Se
recomienda un mnimo de 256 MB y un mximo de 768 MB como valores iniciales. Puede
cambiar estos valores para adaptarlos a su entorno.
A continuacin se incluye un ejemplo:

296 PowerPlay

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


rem Sun JVM memory allocation pool parameters. Modify as appropriate. set
JAVA_OPTS=%JAVA_OPTS% -Xms192m -Xmx 768m - Dsun.rmi.dgc.client.
gcInterval=3600000 - Dsun.rmi.dgc.client.gcInterval=3600000 -

Para obtener informacin sobre estos parmetros, consulte la documentacin de la JVM o del
servidor de aplicaciones.
3. Aada un argumento log4j, tal como se muestra en el siguiente ejemplo:
rem Sun JVM memory allocation pool parameters. Modify as appropriate. set
JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx512m - Dsun.rmi.dgc.client.
gcInterval=3600000 - Dsun.rmi.dgc.client.gcInterval=3600000 DLog4j.defaultInitOverride=true

Para obtener informacin sobre estos parmetros, consulte la documentacin de la JVM o del
servidor de aplicaciones.
4. Guarde y cierre el archivo.

Cambio del archivo de propiedades del distribuidor de IBM


Cognos para el servidor de aplicaciones Oracle
Si utiliza el servidor de aplicaciones Oracle, debe quitar la marca de una entrada en el archivo de
propiedades del distribuidor de IBM Cognos. Haga este cambio antes de implementar los componentes de IBM Cognos o surgirn problemas al ejecutar las aplicaciones de IBM Cognos.

Pasos
1. En un editor de texto, abra el archivo ubicacin_c8/webapps/WEB-INF/p2pd_deploy_defaults.
properties.
2. Localice las siguientes entradas:
#set this to true to wrap the input stream so that Oracle Application Server
will parse the XML properly #wrap_input_stream=true

3. Quite la marca de la segunda entrada eliminando el smbolo de almohadilla (#), tal como se
muestra a continuacin:
wrap_input_stream=true

4. Guarde y cierre el archivo.

Configuracin de las propiedades del servidor de aplicaciones


e implementacin de los componentes de IBM Cognos
Debe configurar las propiedades del servidor de aplicaciones e implementar los componentes de
IBM Cognos.

Pasos para WebSphere


1. Inicie el servidor de aplicaciones WebSphere y luego acceda a WebSphere Administrative
Console.

Gua de instalacin y configuracin 297

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


2. Cree una nueva instancia de servidor en la que se implementar la aplicacin IBM Cognos 8,
si esta opcin est disponible en la versin que utiliza.
Si implementa la puerta de enlace del servlet de IBM Cognos, cree una segunda instancia de
servidor independiente.
3. Instale una nueva aplicacin de Enterprise utilizando el archivo de aplicacin creado por IBM
Cognos Configuration.
Para IBM Cognos 8, la raz de contexto predeterminada es p2pd, y puede utilizarse en la
mayora de los casos. Para la puerta de enlace del servlet de IBM Cognos, la raz de contexto
predeterminada es ServletGateway. Otros valores predeterminados de implementacin de la
aplicacin, como el nombre de la aplicacin, se pueden cambiar segn las necesidades de su
entorno. El valor de la raz de contexto utilizado para implementar la aplicacin debe ser el
mismo que el valor de la raz de contexto especificado en IBM Cognos Configuration al ejecutar
el Asistente de aplicacin de creacin.
4. Establezca la memoria utilizada por la JVM.
Normalmente, la memoria se establece aadiendo o cambiando el tamao de montn Java
inicial y mximo. Para obtener informacin sobre estos parmetros, consulte la documentacin
de la JVM o del servidor de aplicaciones.
Sugerencia: Se recomienda un mnimo de 256 MB y un mximo de 768 MB como valores iniciales. Puede cambiar estos valores para adaptarlos a su entorno.
5. En las propiedades del servidor, aada una variable de entorno, tal como se muestra en la
siguiente tabla, que haga referencia al directorio ubicacin_instalacin/bin.

Sistema operativo

Variable de entorno

Windows

PATH

AIX

LIBPATH

Solaris

LD_LIBRARY_PATH

HP-UX

SHLIB_PATH

6. Detenga y luego reinicie la instancia del servidor de aplicaciones WebSphere utilizada para los
componentes de IBM Cognos.
7. Compruebe que los componentes de IBM Cognos se estn ejecutando; para ello, busque el
siguiente mensaje en la consola de administracin del servidor de aplicaciones o en el archivo
de registro del servidor de aplicaciones:

298 PowerPlay

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


El distribuidor est listo para procesar solicitudes.

Pasos para WebLogic


1. Si utiliz la opcin de directorio expandido al crear la aplicacin en IBM Cognos Configuration,
vaya al paso 2. Si cre un archivo WAR, expanda la aplicacin manualmente:

Cree un directorio en una ubicacin a la que el servidor de aplicaciones pueda acceder, y


asigne el mismo nombre al directorio que a la raz de contexto.
Para IBM Cognos 8, el nombre predeterminado del directorio de aplicacin y de la raz de
contexto es p2pd, y puede utilizarse en la mayora de los casos. Para la puerta de enlace
del servlet de IBM Cognos, la raz de contexto predeterminada es ServletGateway. Otros
valores predeterminados de implementacin de la aplicacin, como el nombre de la aplicacin, se pueden cambiar segn las necesidades de su entorno. El valor de la raz de contexto
utilizado para implementar la aplicacin debe ser el mismo que el valor de la raz de contexto
especificado en IBM Cognos Configuration.

Desde el directorio que acaba de crear, extraiga el archivo WAR de aplicacin a la instalacin de WebLogic utilizando el siguiente comando desde una solicitud de comando:
ubicacin_WebLogic/versin_jdk/bin/jar xvfm "ubicacin_instalacin/application.war"
.
Importante: Al final del comando es necesario un espacio en blanco y seguido de un punto.
En este comando, el punto no hace referencia al directorio actual.

2. Inicie el servidor de administracin WebLogic y el servidor gestionado WebLogic asociados al


dominio de IBM Cognos.
Hay que iniciar Node Manager antes de poder iniciar y detener las instancias del servidor gestionado utilizando Administration Console.
3. Para WebLogic 9, debe modificar el entorno en WebLogic Administration Console antes de
implementar IBM Cognos 8. Inicie sesin en Administration Console y vaya hasta la instancia
del servidor gestionado que albergar la aplicacin IBM Cognos 8. Seleccione la pestaa Inicio
del servidor de la instancia del servidor gestionado y habilite el modo de edicin.
4. En el cuadro Java Home, introduzca la ruta de acceso de la JVM. Este valor debe ser el mismo
que el utilizado para IBM Cognos 8. Debe utilizar la JVM incluida en la instalacin de
WebLogic.
5. Establezca los argumentos de Java.
Los argumentos de Java incluyen todos los ajustes de la JVM, como los ajustes de memoria,
que se especifican mediante dos parmetros de la JVM: -Xms y -Xmx. Para WebLogic 9, tambin
hay que establecer MaxPermSize. Asimismo, hay que establecer el analizador de XML adecuado
para IBM Cognos 8.
Por ejemplo, en el cuadro Argumentos, escriba
-Xms768m -Xmx768m -XX:MaxPermSize=128m -Dorg.xml.sax.driver=org.apache.xerces.
parsers.SAXParser

Gua de instalacin y configuracin 299

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


Si utiliza WebLogic Server 9 en AIX, tambin debe especificar el UID de la versin de serie
correspondiente en los argumentos de Java. Si no realiza esta actualizacin, se producir una
incompatibilidad de UID de versin de serie al utilizar WebLogic Server 9 con IBM Java 5, ya
que WebLogic 9 requiere JDK 1.5.
Por ejemplo, en el cuadro Argumentos, escriba
-Xms768m -Xmx768m -XX:MaxPermSize=128m -Dorg.xml.sax.driver=org.apache.xerces.
parsers.SAXParser -Dcom.sun.xml.namespace.QName.useCompatibleSerialVersionUID=1.0
Para obtener informacin sobre los parmetros de la JVM, consulte la documentacin de la
JVM o del servidor de aplicaciones.
6. Guarde y aplique los cambios.
Ahora ya puede iniciar y detener la instancia del servidor gestionado desde la pestaa Control.
7. Inicie la instancia del servidor. Hay que iniciar la instancia del servidor antes de implementar
IBM Cognos 8 o la puerta de enlace del servlet de IBM Cognos.
8. Implemente la aplicacin de la puerta de enlace del servlet de IBM Cognos o IBM Cognos 8 en
la consola WebLogic utilizando una nueva aplicacin Web de la siguiente forma:

Establezca el nombre de la aplicacin.


Por ejemplo, cognos8

Establezca la ruta de acceso al directorio en el que se encuentran los archivos de aplicacin


expandidos.
Nota: IBM Cognos 8 utiliza un cargador personalizado. Utilice la opcin de directorio
expandido al realizar la implementacin.

Seleccione la instancia del servidor de destino.


Se recomienda que el servidor de administracin slo se utilice para tareas de administracin
de WebLogic y que la aplicacin IBM Cognos 8 se implemente en su propia instancia del
servidor gestionado.

9. Una vez que se haya efectuado correctamente la implementacin, establezca el perodo de


recarga de la aplicacin Web en -1 para mejorar el rendimiento. Esto evitar que WebLogic
busque archivos de aplicacin actualizados que slo se utilizan en un entorno de desarrollo.
10. Detenga y luego reinicie el servidor gestionado WebLogic asociado al dominio de IBM Cognos
para activar los cambios.
11. Compruebe que los componentes de IBM Cognos se estn ejecutando; para ello, busque el
siguiente mensaje en la ventana de la consola del servidor de aplicaciones o en el archivo de
registro del servidor de aplicaciones:
El distribuidor est listo para procesar solicitudes.

Pasos para SAP NetWeaver 6.40 en Windows


1. Abra la herramienta de configuracin escribiendo

300 PowerPlay

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


unidad:\usr\sap\idsap\JCxx\j2ee\configtool\configtool.bat
Por ejemplo, si el identificador de SAP es J2E y la instalacin est en la unidad D, debera
escribir
D:\usr\sap\J2E\JC00\j2ee\configtool\configtool.bat
2. Cuando se le solicite que utilice la configuracin predeterminada de la base de datos, haga clic
en Yes.
3. En cluster-data, instance_IDxxxxxxx, Dispatcher_IDxxxxxxx, services, donde xxxxxxx es el
nmero de identificador de su instalacin, resalte http.
4. En Global Properties, resalte KeepAliveTimeout y escriba un nmero ms alto; luego, haga clic
en Set.
Sugerencia: Se recomienda que el nmero de KeepAliveTimeout inicial sea como mnimo 60.
5. En cluster-data, instance_IDxxxxxxx, resalte Server_IDxxxxxxx.
6. Establezca la memoria utilizada por la JVM.
Siga las recomendaciones de SAP. Para obtener ms informacin, consulte la Nota SAP 723909
en SAP Support Portal.
Si su equipo tiene menos de 1,5 GB de memoria, es posible que tenga problemas al ejecutar
SAP NetWeaver. Se recomienda un mnimo de 768 MB.
7. En el cuadro de parmetros de Java, configure el analizador de XML de la siguiente forma:
-Dorg.xml.sax.driver=org.apache.xerces.parsers.SAXParser
8. Para entornos de IBM Cognos 8 que utilizan Report Studio, en cluster-data, instance_IDxxxxxxx,
resalte Server_IDxxxxxxx, services y resalte http.
9. En Global Properties, resalte CompressedOthers, escriba false y luego haga clic en Set.
10. Guarde los cambios.
Se le solicitar que reinicie el servidor.
11. Reinicie el servidor utilizando SAP Management Console o reiniciando los servicios en Servicios.
12. Utilice la herramienta de implementacin para crear un nuevo proyecto.
13. Cargue el archivo de aplicacin de IBM Cognos que cre utilizando IBM Cognos Configuration.
De manera predeterminada, el archivo se llama p2pd.ear para IBM Cognos 8 y ServletGateway.ear para la puerta de enlace del servlet de IBM Cognos.
14. Mediante la herramienta de implementacin, conctese a la herramienta de administracin e
implemente el archivo de aplicacin.
15. Cuando se le solicite que inicie la aplicacin, haga clic en Yes.

Gua de instalacin y configuracin 301

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


16. Guarde el proyecto.

Pasos para el servidor de aplicaciones Oracle versin 2


1. Cree una instancia de OC4J para que los componentes de IBM Cognos se ejecuten dentro de
ella.
2. Establezca la memoria utilizada por la JVM.
Normalmente, la memoria se establece aadiendo o cambiando dos parmetros de la JVM: Xms y -Xmx. Se recomienda un mnimo de 256 MB y un mximo de 768 MB como valores
iniciales. Puede cambiar estos valores para adaptarlos a su entorno. Para obtener informacin
sobre estos parmetros, consulte la documentacin de la JVM o del servidor de aplicaciones.
3. En las propiedades del servidor, aada "-userThreads" a las Opciones de OC4J.
4. En las propiedades del servidor, aada una variable de entorno, tal como se muestra en la
siguiente tabla, que haga referencia al directorio ubicacin_instalacin/bin.

Sistema operativo

Variable de entorno

Windows

PATH

AIX

LIBPATH

Solaris

LD_LIBRARY_PATH

HP-UX

SHLIB_PATH

5. Implemente el archivo de aplicacin de IBM Cognos (denominado de forma predeterminada


p2pd.ear para IBM Cognos 8 y ServletGateway.ear para la puerta de enlace del servlet de IBM
Cognos) creado por IBM Cognos Configuration.
El valor del parmetro Map to URL debe ser el mismo que el valor de la raz de contexto
introducido en IBM Cognos Configuration.
6. Inicie la instancia de OC4J que ha creado para los componentes de IBM Cognos.
7. Compruebe que los componentes de IBM Cognos se estn ejecutando; para ello, busque el
siguiente mensaje en la ventana de la consola del servidor de aplicaciones o en el archivo de
registro del servidor de aplicaciones:
El distribuidor est listo para procesar solicitudes.

Pasos para el servidor de aplicaciones Oracle versin 3


1. Cree una instancia de OC4J para que los componentes de IBM Cognos se ejecuten dentro de
ella.
2. Slo en Windows, seale como comentario las siguientes entradas en el archivo ubicacin_Oracle\j2ee\instancia_OC4J_Cognos\config\global-web-application.xml:

302 PowerPlay

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


<welcome-file-list> <welcome-file>index.html</welcome-file> <welcomefile>default.jsp</welcome-file> <welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>

3. Abra el archivo ubicacin_Oracle/opmn/conf/opmn.xml.


4. Aada una variable de entorno que haga referencia al directorio ubicacin_instalacin/bin y
establezca variables para los orgenes de datos.
A continuacin, se muestra un ejemplo para Windows y DB2:
<environment> <variable id="PATH" value="c8_location/bin"
append="true"/>
<variable id="DB2DIR" value=" location"/> <variable id="DB2INSTANCE value="
instance_name"/> <variable id="INSTHOME value=" location"/> </environment>

Esta tabla muestra las variables de entorno para cada sistema operativo que deben hacer referencia al directorio ubicacin_c8/bin.

Sistema operativo

Variable de entorno

Windows

PATH

AIX

LIBPATH

Solaris

LD_LIBRARY_PATH

HP-UX

SHLIB_PATH

5. Establezca la memoria utilizada por la JVM.


Se recomienda un mnimo de 256 MB y un mximo de 768 MB como valores iniciales. Puede
cambiar estos valores para adaptarlos a su entorno. Para obtener informacin sobre estos
parmetros, consulte la documentacin de la JVM o del servidor de aplicaciones.
A continuacin se incluye un ejemplo:
<data id="java-options" value="-server -Xmx768m -XX:MaxNewSize=384m
-XX:NewSize=192m -XX:MaxPermSize=128m -classpath c8_location\bin;c8_location\
webapps\p2pd\WEB-INF\lib -

6. Defina el ajuste userThreads de OC4J.


A continuacin se incluye un ejemplo:
<data id="oc4j-options" value="-properties -userThreads"/>

7. Guarde y cierre el archivo ubicacin_Oracle/opmn/conf/opmn.xml.


8. Implemente el archivo de aplicacin de IBM Cognos (denominado de forma predeterminada
p2pd.ear para IBM Cognos 8 y ServletGateway.ear para la puerta de enlace del servlet de IBM
Cognos) creado por IBM Cognos Configuration.
El valor del parmetro Map to URL debe ser el mismo que el valor de la raz de contexto
introducido en IBM Cognos Configuration.
9. Inicie la instancia de OC4J que ha creado para los componentes de IBM Cognos.

Gua de instalacin y configuracin 303

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


10. Compruebe que los componentes de IBM Cognos se estn ejecutando; para ello, busque el
siguiente mensaje en la ventana de la consola del servidor de aplicaciones o en el archivo de
registro del servidor de aplicaciones:
El distribuidor est listo para procesar solicitudes.

Pasos para JBoss


1. Si no desea utilizar el puerto 8080, que es el predeterminado, abra el archivo ubicacin_JBoss/server/nombre_instancia/deploy/jbossweb-tomcat55.sar/server.xml.
2. En el archivo server.xml, cambie el nmero de puerto predeterminado (8080) que utiliza la
instancia del servidor por el puerto especificado en IBM Cognos Configuration. Por ejemplo:
<Service name="jboss.web" className="org.jboss.web.tomcat.tc5.
StandardService"> <!-- A HTTP/1.1 Connector on port 8080 --> <Connector
port="8080" address="${jboss.bind.address}" maxThreads="250" strategy="ms"
maxHttpHeaderSize="8192" emptySessionPath="true" enableLookups="false"
redirectPort="8443" acceptCount="100" connectionTimeout="20000"
disableUploadTimeout="true"/>

3. Guarde y cierre el archivo server.xml.


4. Ponga la aplicacin p2pd en la carpeta ubicacin_JBoss/server/nombre_instancia/deploy, si es
que no est ya en dicha ubicacin.
5. Inicie el servidor de aplicaciones.
El servidor de aplicaciones detectar e iniciar automticamente la aplicacin p2pd.
6. Compruebe que los componentes de IBM Cognos se estn ejecutando; para ello, busque el
siguiente mensaje en la ventana de la consola del servidor de aplicaciones o en el archivo de
registro del servidor de aplicaciones:
The dispatcher is ready to process requests.

Pasos para el servidor de aplicaciones Sun Java System


1. Utilice la consola de administracin del servidor de aplicaciones Sun Java System para aadir
una nueva opcin de JVM a fin de establecer el analizador de XML que la aplicacin de IBM
Cognos utilizar. Por ejemplo:
"-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.
DocumentBuilderFactoryImpl"

2. Aada una opcin de JVM para establecer el tamao de montn Java mximo a fin de limitar
la cantidad mxima de memoria que puede utilizar el proceso Java.
Normalmente, la memoria se establece aadiendo o cambiando el tamao de montn Java
inicial y mximo. Para obtener informacin sobre estos parmetros, consulte la documentacin
de la JVM o del servidor de aplicaciones.
Por ejemplo, aada "-Xmx768M" para establecer 768 MB de memoria como valor mximo para
el proceso Java.
Sugerencia: Se recomienda un mnimo de 256 MB y un mximo de 768 MB como valores iniciales. Puede cambiar estos valores para adaptarlos a su entorno.

304 PowerPlay

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


3. Aumente el valor predeterminado de "Maximum number of request processing threads" (5) a
un valor adecuado para su entorno.
Sugerencia: Empiece con un valor de 250. Si el valor es demasiado bajo, habr inestabilidad
en el sistema y errores en los procesos. Si el valor es demasiado alto, se reservarn recursos del
sistema de forma innecesaria.
4. Copie el archivo ubicacin_c8 \webapps\p2pd\WEB-INF\lib\xercesImpl.jar en ubicacin_SJSAS\domains\<nombre de dominio>\lib\ext.

Cmo habilitar SSL


Si utiliza Secure Socket Layer (SSL) para los componentes de IBM Cognos, tambin deber habilitar
SSL en el entorno del servidor de aplicaciones. A continuacin, identifique el certificado del servidor
SSL en los componentes de IBM Cognos.

Pasos
1. Configure el servidor de aplicaciones para que utilice SSL.
Una entidad emisora de certificados (CA) de terceros genera un certificado del servidor SSL.
Tambin se proporciona el certificado de la CA que gener el certificado del servidor SSL.
Para obtener ms informacin sobre cmo configurar el servidor de aplicaciones para que use
SSL, consulte la documentacin del servidor de aplicaciones. Para obtener informacin sobre
cmo utilizar certificados de CA en su servidor de aplicaciones, consulte la documentacin de
la CA.
2. Copie el certificado de CA en el directorio ubicacin_instalacin/bin y cambie el nombre del
archivo a ca.cer.
Este archivo debe estar en formato X.509 con codificacin base-64.
3. Desde el directorio ubicacin_instalacin/bin:

En Windows, escriba:
ThirdPartyCertificateTool.bat -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystore
-p contrasea

En UNIX o Linux, escriba:


ThirdPartyCertificateTool.sh -T -i -r ca.cer -k ../configuration/signkeypair/jCAKeystore
-p contrasea

Importante: Escriba jCAKeystore como nombre del almacn de claves de CA.

Configuracin del servidor Web


Si utiliza un servidor Web en su entorno, configrelo ahora. Para obtener ms informacin, consulte
"Configuracin del servidor Web" (p. 137).

Gua de instalacin y configuracin 305

Captulo 13: Configuracin de IBM Cognos 8 para un servidor de aplicaciones


Para obtener ms informacin sobre cmo configurar el complemento del servidor Web WebSphere,
visite el centro de recursos de IBM Cognos (http://www.ibm.com/software/data/support/cognos_
crc.html).

Cmo quitar el registro de distribuidores


Despus de iniciar el servidor de aplicaciones y la aplicacin de IBM Cognos, quite el registro de
cualquier distribuidor de IBM Cognos que se hubiera registrado anteriormente y que ahora ya no
se utilice. Por ejemplo, quite el registro de cualquier distribuidor de Tomcat que ahora se ejecute
en el servidor de aplicaciones.
Para eliminar los distribuidores, utilice IBM Cognos Administration. Para acceder a esta herramienta,
debe tener permisos de ejecucin en relacin con la funcin protegida de administracin.

Pasos
1. Abra IBM Cognos Connection conectndose al portal de IBM Cognos 8 y haga clic en Contenido
de IBM Cognos en la pgina de bienvenida.
2. En la esquina superior derecha, haga clic en Iniciar, IBM Cognos Administration.
3. En la pestaa Configuracin, haga clic en Distribuidores y servicios.
4. Para el distribuidor cuyo registro desee quitar, vaya a la columna Acciones y haga clic en Ms.
5. Haga clic en Anular registro.
6. En el cuadro de dilogo de confirmacin, haga clic en Aceptar.
La informacin del distribuidor se eliminar de Content Manager.

Importacin de datos del almacn de contenido


Si export el almacn de contenido antes de configurar los componentes de IBM Cognos para que
se ejecutaran en su servidor de aplicaciones (p. 289), importe la implementacin para restaurar y
codificar los datos utilizando las nuevas claves de codificacin.

Paso
1. Inicie IBM Cognos 8.
2. Importe todo el almacn de contenido con la herramienta de implementacin.
Para obtener ms informacin, consulte el tema relativo a la importacin a un entorno destino
en la Gua de administracin y seguridad.

306 PowerPlay

Captulo 14: Opciones de configuracin avanzada


Las opciones de configuracin avanzada son cambios que se realizan tras la instalacin en las propiedades de configuracin de los recursos que utilizan los componentes de IBM Cognos 8. No puede
utilizar IBM Cognos Configuration para realizar estos cambios. Las opciones de configuracin
avanzada aumentan la seguridad, mejoran el rendimiento o cambian el comportamiento predeterminado de los componentes de IBM Cognos 8.

Cambio de la versin del entorno en tiempo de ejecucin de


Java que utilizan los componentes de IBM Cognos 8
Los componentes de IBM Cognos 8 requieren el entorno en tiempo de ejecucin de Java (JRE) para
funcionar. La versin actual proporcionada con IBM Cognos 8 es JRE 1.5.0. Para obtener ms
informacin sobre las versiones JRE compatibles, visite el centro de recursos de IBM Cognos (http:
//www.ibm.com/software/data/support/cognos_crc.html).
IBM Cognos Configuration y otros componentes de IBM Cognos 8 utilizan el JRE al que hace
referencia la variable de entorno JAVA_HOME. En Windows, si no se ha configurado JAVA_HOME,
se utiliza de forma predeterminada el JRE empaquetado con los componentes de IBM Cognos 8.
Si desea cambiar el JRE actual, son necesarios algunos cambios de configuracin. El cambio puede
ser adecuado en las situaciones siguientes:

Desea utilizar componentes de IBM Cognos 8 con un servidor de aplicaciones que requiere una
versin de JRE especfica.

Ya utiliza una versin de JRE con otras aplicaciones.

Si est utilizando componentes de IBM Cognos 8 en un entorno de servidor de aplicaciones, siga


el proceso que se describe en "Configuracin de IBM Cognos 8 para un servidor de aplicaciones" (p. 287). En el proceso se incluyen los pasos necesarios para actualizar el entorno de Java.
Antes de empezar, asegrese de que los componentes de IBM Cognos 8 estn instalados y que el
JRE que desea utilizar est instalado.
Para cambiar las versiones de JRE, realice lo siguiente:

Realice una copia de seguridad de los datos y las claves de codificacin existentes de IBM
Cognos si es necesario.

Actualice el entorno de Java.

Importe los datos al almacn de contenido si es necesario.

Las tareas de esta seccin son para una instalacin de IBM Cognos que utilice Tomcat.

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

307

Captulo 14: Opciones de configuracin avanzada

Copia de seguridad de la informacin existente de IBM Cognos


Realice una copia de seguridad de la informacin existente de IBM Cognos si los componentes de
IBM Cognos 8 se estn ejecutando

En un servidor de aplicaciones (incluido Tomcat) y va a pasarse a un servidor de aplicaciones


que viene con su propia JVM.

Con una JVM de un proveedor y va a pasarse a otro proveedor de JVM.

Nota: Debe realizar una copia de seguridad de la informacin existente de IBM Cognos dentro del
entorno de trabajo antes de la actualizacin.
Antes de configurar los componentes de IBM Cognos 8 para que se ejecuten en el nuevo servidor
de aplicaciones o JVM, debe realizar una copia de seguridad de los siguientes elementos:

Los datos del almacn de contenido, mediante la creacin de una exportacin de implementacin.

La informacin de configuracin, mediante su exportacin. Los datos codificados se descodificarn durante la exportacin.

Las claves criptogrficas, para lo cual deber guardarlas en una ubicacin alternativa. Las
nuevas claves criptogrficas deben crearse utilizando la misma JVM que utiliza el servidor de
aplicaciones. Como estas claves slo se pueden crear si se han eliminado las claves anteriores,
es importante realizar una copia de seguridad de las claves anteriores.

Para garantizar la seguridad e integridad de sus datos de IBM Cognos, realice una copia de seguridad
del almacn de contenido, la informacin de configuracin y las claves criptogrficas en un directorio
que est protegido de accesos no autorizados o no adecuados.
Sugerencia: Para comprobar si existe alguna clave criptogrfica, bsquela en el directorio ubicacin_c8/configuration. Si dicho directorio contiene los subdirectorios csk, encryptkeypair o
signkeypair, significa que existen claves criptogrficas.

Pasos
1. Si hay datos en el almacn de contenido, inicie el servicio de IBM Cognos 8 y exporte todo el
almacn de contenido mediante la herramienta de implementacin.
Para obtener ms informacin, consulte el tema sobre cmo crear una especificacin de
implementacin de exportacin en la Gua de administracin y seguridad.
2. En IBM Cognos Configuration, vaya al men Archivo, haga clic en Exportar como y guarde
la informacin de configuracin en un formato descodificado. Para asignarle un nombre al
archivo, utilice un nombre como "descodificado.xml".
Exporte los datos a un directorio que est protegido de accesos no autorizados o no adecuados,
ya que las contraseas estn guardadas en texto sin formato. Se le solicitar que confirme que
la exportacin no es una operacin segura.
3. Detenga el servicio IBM Cognos 8:

308 PowerPlay

Si utiliza Tomcat, detenga el servicio IBM Cognos 8 y cierre IBM Cognos Configuration.

Si utiliza un servidor de aplicaciones distinto a Tomcat, cierre IBM Cognos 8 en su entorno.

Captulo 14: Opciones de configuracin avanzada


4. Realice una copia de seguridad de las claves criptogrficas existentes, para lo cual deber
guardar los archivos y directorios correspondientes en una ubicacin alternativa protegida.
Los archivos son:

ubicacin_c8/configuration/cogstartup.xml

ubicacin_c8/configuration/caSerial

ubicacin_c8/configuration/cogconfig.prefs

ubicacin_c8/configuration/coglocale.xml

Los directorios son:

ubicacin_c8/configuration/csk

ubicacin_c8/configuration/encryptkeypair

ubicacin_c8/configuration/signkeypair

5. Elimine los archivos caSerial y cogconfig.prefs, adems de los tres directorios (csk, encryptkeypair
y signkeypair).
6. Sustituya el archivo ubicacin_c8/configuration/cogstartup.xml por el archivo que contenga
los datos exportados de IBM Cognos Configuration (por ejemplo, "descodificado.xml").
Importante: En el directorio ubicacin_c8/configuration, el archivo debe utilizar el nombre
"cogstartup.xml".
La informacin de este archivo se volver a codificar automticamente mediante nuevas claves
criptogrficas cuando guarde la configuracin en IBM Cognos Configuration.

Actualizacin del entorno de Java


Los archivos del proveedor de seguridad de IBM Cognos deben estar ubicados en el entorno de la
JVM para la nueva versin de Java.
Los archivos criptogrficos de IBM Cognos 8 utilizan un archivo .jar (Java Archive), denominado
bcprov-jdknn-nnn.jar, que debe encontrarse en el entorno en tiempo de ejecucin de Java (JRE).
Este archivo proporciona rutinas de codificacin y descodificacin que no forman parte de una
instalacin predeterminada de JVM. Para garantizar la seguridad, la JVM debe cargar el archivo
de codificacin mediante el directorio de extensiones de Java.
Si desea utilizar su propio JRE y establecer la variable JAVA_HOME en esa ubicacin de Windows,
o si est realizando la instalacin en UNIX, es posible que tenga que actualizar los entornos Java
de los servicios criptogrficos.
En Windows, puede configurar JAVA_HOME como variable del sistema o variable de usuario. Si
la configura como variable del sistema, es posible que tenga que reiniciar el equipo para que surta
efecto. Si la configura como variable de usuario, hgalo de tal manera que el entorno en el que se
ejecute Tomcat pueda acceder a ella.
Si no tiene una variable JAVA_HOME ya definida en Windows, se utilizarn los archivos JRE
proporcionados con la instalacin, y no tendr que actualizar ningn archivo del entorno. Si

Gua de instalacin y configuracin 309

Captulo 14: Opciones de configuracin avanzada


JAVA_HOME remite a una versin Java que no es vlida para IBM Cognos 8, deber actualizar
JAVA_HOME con la ruta correspondiente a una versin de Java vlida.

Pasos
1. Compruebe que la variable de entorno JAVA_HOME est configurada en la ubicacin del JRE.
Por ejemplo, para configurar JAVA_HOME en los archivos JRE proporcionados con la instalacin, la ruta es ubicacin_c8/bin/jre/versin.
2. Copie el archivo bcprov-jdknn-nnn.jar del directorio ubicacin_c8/bin/jre/versin/lib/ext en el
directorio ubicacin_Java/lib/ext.
3. Inicie IBM Cognos Configuration.
4. Guarde la configuracin.
IBM Cognos Configuration genera nuevas claves y codifica los datos.

Importacin de datos del almacn de contenido


Si ha exportado el almacn de contenido antes de cambiar la JVM, importe la implementacin para
restaurar y codificar los datos mediante las nuevas claves de codificacin.

Paso

Para importar los datos del almacn de contenido, inicie el servicio IBM Cognos 8 e importe
todo el almacn de contenido mediante la herramienta de implementacin. Para obtener ms
informacin, consulte el tema relativo a la importacin a un entorno destino en la Gua de
administracin y seguridad.

Configuracin de los componentes de IBM Cognos 8 para utilizar


otra entidad emisora de certificados
De forma predeterminada, los componentes de IBM Cognos 8 utilizan su propio servicio de entidad
emisora de certificados (CA) para establecer la raz de confianza de la infraestructura de seguridad
de IBM Cognos. Puede configurar los componentes de IBM Cognos 8 para que utilicen otra entidad
emisora de certificados si ya tiene una, como iPlanet o Microsoft, en el entorno de creacin de
informes.
Al configurar los componentes de IBM Cognos 8 para que utilicen otra entidad emisora de certificados, compruebe que especifica la misma informacin en la herramienta de la utilidad de lnea de
comandos y en IBM Cognos Configuration.
Para configurar los componentes de IBM Cognos 8 para que utilicen otra entidad emisora de certificados debe:

310 PowerPlay

Generar claves de seguridad y solicitudes de firma de certificados de IBM Cognos para utilizarlas
con su entidad emisora de certificados

Enviar los certificados y las claves de seguridad de IBM Cognos a su entidad emisora de certificados

Captulo 14: Opciones de configuracin avanzada

Configurar los componentes de IBM Cognos 8 para que utilicen su entidad emisora de certificados

Generacin de claves y solicitudes de firma de certificados


Utilice la utilidad de lnea de comandos para generar todas las claves para los almacenes de claves
de IBM Cognos y para generar las solicitudes de firma de certificados (CSR).
En la tabla siguiente se enumeran las opciones para la herramienta de la lnea de comandos que se
utilizan para generar claves y solicitudes de firma.

Comando

Descripcin

Modo de operacin principal


-c

Crear una nueva CSR

-i

Importar un certificado

Modificadores de operacin
-s

Trabajar con la identidad de la firma

-e

Trabajar con la identidad de la codificacin

-T

Trabajar con el almacn de confianza (slo con -i)

Indicadores de informacin
-d

DN que se debe utilizar para el certificado

-r

CSR o ubicacin del archivo del certificado (depende del modo)

-t

Archivo del certificado de la entidad emisora de certificados (slo con -i)

-p

Contrasea del almacn de claves (se debe proporcionar)

-a

Algoritmo de par de claves. RSA o DSA


Valor predeterminado: RSA

-D

Ubicacin del directorio


Se utilizan los valores de ejemplo siguientes:

Propiedad

Valor

DN del certificado de firma

CN=SignCert,O=MiEmpresa,C=CA
Gua de instalacin y configuracin 311

Captulo 14: Opciones de configuracin avanzada

Propiedad

Valor

DN del certificado de codificacin

CN=EncryptCert,O=MiEmpresa,C=CA

Contrasea del almacn de claves

Contrasea

Pasos
1. En el directorio ubicacin_c8\configuration, realice una copia de seguridad del archivo
cogstartup.xml en una ubicacin segura.
2. Realice una copia de seguridad del contenido de los directorios siguientes en una ubicacin
segura:

ubicacin_c8\configuration\signkeypair

ubicacin_c8\configuration\encryptkeypair

3. Con IBM Cognos Configuration, exporte la configuracin en texto en claro; para ello, realice
lo siguiente:

Abra IBM Cognos Configuration.

En el men Archivo, haga clic en Exportar como.

Cuando se le solicite si desea exportar el contenido descodificado, haga clic en S.

En el cuadro de dilogo Exportar como, seleccione cogstartup.xml y, a continuacin, haga


clic en Guardar.

Cuando se le solicite si desea reemplazar el archivo existente, haga clic en S.

Cuando se hayan realizado las tareas, cierre el cuadro de dilogo de IBM Cognos Configuration.

Guarde la configuracin.

Cierre IBM Cognos Configuration.

4. Vaya al directorio ubicacin_c8\bin.


5. Cree la solicitud de firma del certificado para las claves de firma escribiendo el comando
siguiente:
En UNIX o Linux, escriba
ThirdPartyCertificateTool.sh -c -s -d "CN=SignCert,O=MiEmpresa,C=CA" -r signRequest.csr
-D ../configuration/signkeypair -p contrasea
En Windows, escriba
ThirdPartyCertificateTool.bat c -s -d "CN=SignCert,O=MiEmpresa,C=CA" -r signRequest.csr
-D ../configuration/signkeypair -p contrasea

312 PowerPlay

Captulo 14: Opciones de configuracin avanzada


Sugerencia: Los nombres de archivos de UNIX o Linux distinguen entre maysculas y minsculas, por lo que deben introducirse exactamente como se muestra.
Puede ignorar de forma segura cualquier advertencia acerca del registro.
El comando crea el archivo jSignKeystore en el directorio signkeypair, configura la contrasea
especificada, crea un nuevo par de claves, lo almacena en el almacn de claves y exporta el
archivo signRequest.csr al directorio ubicacin_c8\bin.
6. Cree la solicitud de firma del certificado para las claves de codificacin escribiendo el comando
siguiente:
En UNIX o Linux, escriba
ThirdPartyCertificateTool.sh -c -e -d "CN=EncryptCert,O=MiEmpresa,C=CA" -r
encryptRequest.csr -D ../configuration/encryptkeypair -p contrasea
En Windows, escriba
ThirdPartyCertificateTool.bat -c -e -d "CN=EncryptCert,O=MiEmpresa,C=CA" -r
encryptRequest.csr -D ../configuration/encryptkeypair -p contrasea
Puede ignorar de forma segura cualquier advertencia acerca del registro.
El comando crea el archivo jEncKeystore en el directorio encryptkeypair, configura la contrasea
especificada, crea un nuevo par de claves, lo almacena en el almacn de claves y exporta el
archivo encryptRequest.csr al directorio ubicacin_c8\bin.
7. Copie los archivos signRequest.csr y encryptRequest.csr generados en los pasos 5 y 6 en un
directorio al que pueda acceder su entidad emisora de certificados de terceros.
8. Introduzca los archivos signRequest.csr y encryptRequest.csr en su entidad emisora de certificados.
La entidad emisora de certificados produce un certificado de firma y un certificado de codificacin.
Para obtener ms informacin, consulte la documentacin de la entidad emisora de certificados.
9. Copie el contenido del certificado de firma en un archivo denominado signCertificate.cer.
10. Copie el contenido del certificado de codificacin en un archivo denominado encryptCertificate.
cer.
11. Busque el certificado de la entidad emisora de certificados raz para la entidad emisora de certificados y copie el contenido en un archivo denominado ca.cer.
12. Copie ca.cer, signCertificate.cer y encryptCertificate.cer en ubicacin_c8/bin.
Estos archivos deben tener formato PEM (ASCII codificado en Base-64).
13. Importe el certificado de firma del paso 10 al almacn de claves de firma de IBM Cognos
escribiendo el comando siguiente:
En UNIX o Linux, escriba
ThirdPartyCertificateTool.sh -i -s -r signCertificate.cer -D ../configuration/signkeypair -p
contrasea -t ca.cer
Gua de instalacin y configuracin 313

Captulo 14: Opciones de configuracin avanzada


En Windows, escriba
ThirdPartyCertificateTool.bat-i -s -r signCertificate.cer -D ../configuration/signkeypair -p
contrasea -t ca.cer
Puede ignorar de forma segura cualquier advertencia acerca del registro.
El comando lee los archivos signCertificate.cer y ca.cer del directorio ubicacin_c8\bin e importa
los certificados de ambos archivos al archivo jSignKeystore del directorio signkeypair mediante
la contrasea especificada.
14. Importe el certificado de codificacin del paso 11 al almacn de claves de codificacin de IBM
Cognos escribiendo el comando siguiente:
En UNIX o Linux, escriba
ThirdPartyCertificateTool.sh -i -e -r encryptCertificate.cer -D ../configuration/encryptkeypair
-p contrasea -t ca.cer
En Windows, escriba
ThirdPartyCertificateTool.bat -i -e -r encryptCertificate.cer -D ../configuration/encryptkeypair
-p contrasea -t cacert.cer
Puede ignorar de forma segura cualquier advertencia acerca del registro.
El comando lee los archivos encryptCertificate.cer y ca.cer del directorio ubicacin_c8\bin e
importa los certificados de ambos archivos al archivo jEncKeystore del directorio encryptkeypair
mediante la contrasea especificada.
15. Importe el certificado de la entidad emisora de certificados del paso 12 al almacn de confianza
de IBM Cognos escribiendo el comando siguiente:
En UNIX o Linux, escriba
ThirdPartyCertificateTool.sh -i -T -r ca.cer -D ../configuration/signkeypair -p contrasea
En Windows, escriba
ThirdPartyCertificateTool.bat -i -T -r ca.cer -D ../configuration/signkeypair -p contrasea
El comando lee el archivo ca.cer e importa el contenido al archivo jCAKeystore del directorio
signkeypair mediante la contrasea especificada.
Ahora, los certificados estn listos para configurarse para IBM Cognos 8.

Configuracin de los componentes de IBM Cognos 8 para ejecutarlos en otra


entidad emisora de certificados
Debe configurar cada equipo de IBM Cognos para utilizar una entidad emisora de certificados
externa; para ello, configure la propiedad adecuada en IBM Cognos Configuration.
Al configurar esta propiedad, los componentes de IBM Cognos 8 asumen que la entidad emisora
de certificados externa ha generado y ha examinado todas las claves necesarias.

314 PowerPlay

Captulo 14: Opciones de configuracin avanzada


Asegrese de que las ubicaciones del almacn de claves y la contrasea de IBM Cognos Configuration
coinciden con las que ha escrito en la herramienta de la lnea de comandos.

Pasos
1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, en Seguridad, Criptografa, haga clic en Cognos.
3. En la ventana Propiedades, en el grupo de propiedades Configuracin de la entidad emisora
de certificados, haga clic en el cuadro Valor junto a la propiedad Utilizar entidad emisora de
certificados de terceros y, a continuacin, haga clic en Verdadero.
Nota: Al configurar esta propiedad como verdadera, se ignoran todas las propiedades de la
entidad emisora de certificados y el nombre de identidad.
4. Configure las propiedades siguientes para que coincidan con las que ha escrito en la utilidad
de lnea de comandos:

Ubicacin del almacn de claves de firma

Contrasea del almacn de claves de firma

Ubicacin del almacn de claves de codificacin

Contrasea del almacn de claves de codificacin

Contrasea del almacn de claves de la entidad emisora de certificados

5. En el men Archivo, haga clic en Guardar.


6. Si desea iniciar el servicio IBM Cognos 8, en el men Acciones, haga clic en Iniciar.
Esta accin inicia todos los servicios instalados que no se estn ejecutando. Si desea iniciar un
servicio en particular, seleccione el nodo de servicio en la ventana Explorador y, a continuacin,
haga clic en Iniciar en el men Acciones.

Gua de instalacin y configuracin 315

Captulo 14: Opciones de configuracin avanzada

316 PowerPlay

Captulo 15: Cmo establecer instalaciones y configuraciones sin participacin del usuario
Establezca una instalacin y una configuracin sin participacin del usuario para:

Instalar una configuracin idntica en varios equipos de la red.

Automatizar el proceso de instalacin y configuracin mediante la especificacin de opciones


y valores para los usuarios.

Antes de establecer una instalacin y una configuracin sin participacin del usuario, asegrese de
que se cumplen todos los requisitos y los requisitos previos del sistema, y de que todos los productos
necesarios estn instalados y configurados.
Para establecer una instalacin y una configuracin sin participacin del usuario:

Configure un archivo de especificacin de transferencia (.ats) para especificar las opciones de


instalacin.

Ejecute la herramienta de instalacin en modo silencioso.

Utilice un archivo de configuracin preconfigurado de otro equipo.

Ejecute la herramienta de configuracin en modo silencioso.

Despus de completar estas tareas, asegrese de que el directorio de instalacin de IBM Cognos 8
en todos los equipos est protegido frente a accesos no autorizados o inapropiados. A continuacin
estar listo para utilizar IBM Cognos 8.

Cmo establecer una instalacin sin participacin del usuario


Utilice un archivo de especificacin de transferencia (.ats) para copiar componentes de IBM Cognos 8,
incluidos Framework Manager o Metric Designer, en el equipo sin que se le solicite informacin.
De forma predeterminada, cada vez que instala componentes de IBM Cognos 8 mediante el asistente
para instalacin, las opciones que seleccione se grabarn en un archivo de especificacin de transferencia. Por lo tanto, si ya ha instalado componentes de IBM Cognos 8 en un equipo de ejemplo,
puede utilizar el archivo de especificacin de transferencia generado como plantilla para instalaciones
sin participacin del usuario en distintos equipos.
Si no utiliza el asistente para instalacin para instalar componentes, puede utilizar el archivo de
especificacin de transferencia predeterminado denominado response.ats que est disponible en el
CD. Debe modificar el archivo response.ats para su entorno antes de poder utilizarlo para una
instalacin sin participacin del usuario.

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

317

Captulo 15: Cmo establecer instalaciones y configuraciones sin participacin del usuario
Puede ver si la instalacin sin participacin del usuario se ha realizado correctamente comprobando
el estado de retorno. Un valor de cero (0) indica que se ha realizado correctamente y todos los
dems valores indican que se ha producido un error.

Pasos para utilizar un archivo generado por una instalacin en otro equipo
1. Utilice el asistente para instalacin para instalar componentes de IBM Cognos 8 en el equipo.
2. Vaya a ubicacin_c8/instlog.
3. Busque el archivo de especificacin de transferencia (.ats) que se ha generado:

Si ha instalado el servidor de PowerPlay BI, el nombre del archivo es ts-C8PPES-versin-aaaammdd_hhmm.ats.

Si ha instalado PowerPlay Client, el nombre del archivo es ts-C8PPCLIENT-versin-aaaammdd_hhmm.ats.

Si ha instalado los ejemplos de IBM Cognos 8, el nombre del archivo es ts-C8BISAMPLES-versin-aaaammdd_hhmm.ats.

4. Copie el archivo de especificacin de transferencia en el equipo donde tiene previsto instalar


IBM Cognos 8 PowerPlay.
5. En el equipo en que tenga previsto instalar el software, inserte el CD apropiado y copie los
contenidos del CD en el equipo.
6. Abra el archivo de especificacin de transferencia que ha copiado en el editor de texto.
7. En los cuadros de dilogo del Contrato de licencia, cambie la propiedad Acepto a y.
8. Guarde el archivo de especificacin de transferencia en el directorio en el que ha copiado el
contenido del CD de instalacin.
9. Instale IBM Cognos 8:

En Windows, abra una ventana de Smbolo del sistema y cambie al directorio win32 donde
ha copiado el contenido del CD, y despus escriba el siguiente comando, el archivo de
especificacin de transferencia, donde la ubicacin es el directorio en el que ha copiado el
nombre de archivo:
issetup -s ubicacin/nombre del archivo.ats

En UNIX o Linux, cambie al directorio donde ha copiado el contenido del CD y en el


directorio del sistema operativo escriba el siguiente comando, el archivo de especificacin
de transferencia, donde la ubicacin es donde ha copiado el nombre de archivo:
issetup -s ubicacin/nombre del archivo.ats

Si se devuelve un estado de retorno distinto a cero (0), compruebe si hay mensajes de error en los
archivos de registro. Los errores se graban en el siguiente archivo de registro del directorio de instalacin:

318 PowerPlay

Para el servidor de PowerPlay BI, el nombre del archivo es tl-C8PPES-versin-aaaammdd_hhmm_summary-error.txt.

Captulo 15: Cmo establecer instalaciones y configuraciones sin participacin del usuario

Para PowerPlay Client, el nombre del archivo es tl-C8PPCLIENT-versin-aaaammdd_hhmm_summary-error.txt.

Para los ejemplos de IBM Cognos 8, el nombre del archivo es tl-C8BISAMPLES-versin-aaaammdd_hhmm_summary-error.txt.

Si sucede algn error antes de que se produzca suficiente inicializacin, los mensajes de registro se
envan a uno de los siguientes archivos de registro del directorio Temp:

Para el servidor de PowerPlay BI, el nombre del archivo es tl-C8PPES-versin-aaaammdd-hhmm.txt.

Para PowerPlay Client, el nombre del archivo es tl-C8PPCLIENT-versin-aaaammdd-hhmm.txt.

Para los ejemplos de IBM Cognos 8, el nombre del archivo es tl-C8BISAMPLES-versin-aaaammdd-hhmm.txt.

Asegrese tambin de que el directorio de instalacin est protegido frente a accesos no autorizados
o no adecuados.
Despus de resolver todos los errores, puede establecer una configuracin sin participacin del
usuario.

Pasos que se deben seguir si se utiliza el archivo response.ats


1. En el equipo de destino, inserte el CD y copie el contenido en el equipo.
2. Vaya al directorio win32 y abra el archivo response.ats en un editor de texto.
Cada seccin del archivo response.ats corresponde a un cuadro de dilogo del asistente para
instalacin.
3. En los cuadros de dilogo del Contrato de licencia, cambie la propiedad Acepto a y.
4. Escriba la ubicacin de instalacin de los archivos de programa de IBM Cognos 8 en APPDIR=ubicacin.
No debe haber ningn espacio a los lados del signo igual (=).
5. Para los componentes del servidor de IBM Cognos 8 PowerPlay, en la seccin denominada
[Lista de componentes], junto a cada componente:

Para instalar el componente, escriba 1.

Para no instalar el componente, escriba 0.

6. Para una instalacin de Windows, para la propiedad APPFOLDER=, escriba el nombre de la


carpeta del men Inicio que contenga sus accesos directos al programa.
Para asegurarse de que la carpeta de accesos directos es visible para todos los usuarios, escriba
1 en la propiedad ALLUSERS_FLAG=.
7. Para la informacin de instalacin en la seccin [Condiciones de instalacin]:

Para especificar que la condicin es true, escriba 1.

Para especificar que la condicin es false, escriba 0.


Gua de instalacin y configuracin 319

Captulo 15: Cmo establecer instalaciones y configuraciones sin participacin del usuario
8. Guarde el archivo response.ats en un directorio local despus de hacer los cambios necesarios.
9. Vaya al directorio win32.
10. En el smbolo del sistema escriba el siguiente comando, donde ubicacin es el directorio en el
que ha copiado response.ats:

En Windows,
issetup -s ubicacin/response.ats

En UNIX o Linux,
./issetup -s ubicacin/response.ats

Si se devuelve un estado de retorno distinto a cero (0), compruebe si hay mensajes de error en los
archivos de registro. Los errores se graban en el siguiente archivo de registro del directorio de instalacin:

Para el servidor de PowerPlay BI, el nombre del archivo es tl-C8PPES-versin-aaaammdd_hhmm_summary-error.txt.

Para PowerPlay Client, el nombre del archivo es tl-C8PPCLIENT-versin-aaaammdd_hhmm_summary-error.txt.

Para los ejemplos de IBM Cognos 8, el nombre del archivo es tl-C8BISAMPLES-versin-aaaammdd_hhmm_summary-error.txt.

Si sucede algn error antes de que se produzca suficiente inicializacin, los mensajes de registro se
envan a uno de los siguientes archivos de registro del directorio Temp:

Para el servidor de PowerPlay BI, el nombre del archivo es tl-C8PPES-versin-aaaammdd-hhmm.txt.

Para PowerPlay Client, el nombre del archivo es tl-C8PPCLIENT-versin-aaaammdd-hhmm.txt.

Para los ejemplos de IBM Cognos 8, el nombre del archivo es tl-C8BISAMPLES-versin-aaaammdd-hhmm.txt.

Asegrese tambin de que el directorio de instalacin est protegido frente a accesos no autorizados
o no adecuados.
Despus de resolver todos los errores, puede establecer una configuracin sin participacin del
usuario.

Establecimiento de una configuracin sin participacin del


usuario
Antes de establecer una configuracin sin participacin del usuario, debe exportar una configuracin
de otro equipo que tenga los mismos componentes de IBM Cognos 8 instalados. Entonces podr
ejecutar IBM Cognos Configuration en modo silencioso.
La configuracin exportada contiene las propiedades de los componentes de IBM Cognos 8 que ha
instalado en el equipo de origen. Si ha realizado cambios en la configuracin global, tambin deber

320 PowerPlay

Captulo 15: Cmo establecer instalaciones y configuraciones sin participacin del usuario
copiar el archivo de la configuracin global del equipo de origen al equipo donde tiene previsto
ejecutar una configuracin sin participacin del usuario. La configuracin global incluye valores
como configuracin regional del contenido, configuracin regional del producto, monedas, fuentes
y configuracin de cookies. Para obtener ms informacin, consulte "Cambio de la configuracin
global" (p. 255).
Asegrese de que los valores de configuracin del equipo local son adecuados para utilizarlos en
la configuracin de otro equipo de IBM Cognos 8 con los mismos componentes instalados. Por
ejemplo, si en la parte de la propiedad del URI de la puerta de enlace que corresponde al nombre
del host, se ha sustituido el host local por una direccin IP o un nombre de equipo, asegrese de
que dichos valores sean adecuados para la configuracin del nuevo equipo.
Puede ver si la configuracin sin participacin del usuario se ha realizado correctamente comprobando el estado de retorno. Un valor de cero (0) indica que se ha realizado correctamente y todos
los dems valores indican que se ha producido un error.

Pasos
1. En IBM Cognos Configuration, haga clic en Exportar como en el men Archivo.
2. Si desea exportar la configuracin actual a una carpeta distinta, busque y abra la carpeta en el
cuadro Buscar en.
Asegrese de que la carpeta est protegida frente a accesos no autorizados o no adecuados.
3. En el cuadro Nombre de archivo, escriba un nombre para el archivo de configuracin.
4. Haga clic en Guardar.
5. Copie el archivo de la configuracin exportada del equipo de origen o ubicacin de red al
directorio ubicacin_c8/configuration del equipo donde tiene previsto realizar una configuracin
sin participacin del usuario.
6. Cambie el nombre del archivo por cogstartup.xml.
7. Si ha cambiado la configuracin global del equipo de origen, copie el archivo coglocale.xml
del equipo de origen al directorio ubicacin_c8/configuration del equipo donde tiene previsto
realizar una configuracin sin participacin del usuario.
8. Vaya a ubicacin_c8/bin.
9. Escriba el comando de configuracin:

En UNIX o Linux, escriba


./cogconfig.sh -s

En Windows, escriba
cogconfig.bat -s

Sugerencia: Para ver los mensajes de registro generados durante una configuracin sin participacin del usuario, consulte el archivo cogconfig_response.csv en el directorio ubicacin_c8/logs.

Gua de instalacin y configuracin 321

Captulo 15: Cmo establecer instalaciones y configuraciones sin participacin del usuario
IBM Cognos Configuration aplica la configuracin especificada en la copia local de cogstartup.xml,
codifica credenciales, genera certificados digitales y, si corresponde, inicia el servicio o el proceso
de IBM Cognos 8.

Cmo establecer una desinstalacin sin participacin del usuario


Establezca una instalacin y una configuracin sin participacin del usuario para:

Automatizar la eliminacin de componentes de varios equipos que tengan los mismos componentes.

Eliminar componentes en un entorno UNIX o Linux que no tenga XWindows.

Pasos
1. Vaya a ubicacin_c8/instlog.
2. Abra el archivo de especificacin de transferencia .ats del producto con un editor de texto:
El formato del nombre del archivo de especificacin de transferencia .ats es ts-cdigo_producto-versin-aaaammdd_hhmm.ats
donde cdigo_producto es:

Cdigo_producto

Producto

C8BISRVR

Servidor de IBM Cognos 8 BI

C8BIMODEL

Framework Manager

CMMSRVR

IBM Cognos Metrics Manager

C8BIMEMOD

Metric Designer

C8BISAMPLES

Ejemplos

LP

Supplementary Languages Documentation

Si tiene ms de un archivo .ats para un producto, solamente necesita editar uno de los archivos
.ats.
3. En la seccin denominada [Lista de componentes], especifique los componentes que se van a
eliminar.

Para eliminar el componente, escriba 1.

Para dejar el componente instalado, escriba 0.

4. Guarde y cierre el archivo.


5. Vaya al directorio del sistema operativo.

322 PowerPlay

Captulo 15: Cmo establecer instalaciones y configuraciones sin participacin del usuario
6. En el smbolo del sistema, escriba el siguiente comando, donde nombre de archivo es el nombre
del archivo de especificacin de transferencia .ats que ha editado:

En Windows,
uninst -u -s ubicacin_c8/instlog/nombre de archivo.ats

En UNIX o Linux,
./uninst -u -s ubicacin_c8/instlog/nombre de archivo.ats

7. Repita todo el procedimiento por cada producto que desee desinstalar.

Gua de instalacin y configuracin 323

Captulo 15: Cmo establecer instalaciones y configuraciones sin participacin del usuario

324 PowerPlay

Captulo 16: Mantenimiento del rendimiento


Esta seccin incluye temas sobre el uso de productos IBM Cognos con herramientas e indicadores
que ayudan a mantener el rendimiento del entorno de IBM Cognos 8.

Indicadores de rendimiento del sistema


IBM Cognos 8 proporciona indicadores de sistema que puede utilizar para controlar el mantenimiento
de todo el sistema y de cada servidor, distribuidor y servicio. Asimismo, puede establecer los
umbrales para las puntuaciones de los indicadores. Algunos ejemplos de indicadores de rendimiento
del sistema son el nmero de sesiones del sistema, cunto tiempo est un informe en una cola,
cunto tiempo ha estado funcionando una Mquina virtual Java (Java Virtual Machine, JVM) y el
nmero de solicitudes y procesos del sistema.
Los indicadores de rendimiento del sistema estn disponibles en IBM Cognos Administration, a los
que puede acceder desde IBM Cognos Connection. Para obtener ms informacin acerca de la utilizacin de los indicadores de rendimiento del sistema, consulte la Gua de administracin y seguridad.
Dispone de una funcin adicional: puede tomar una instantnea de los indicadores actuales del
sistema de modo que puede realizar un seguimiento de las tendencias a lo largo del tiempo o revisar
los detalles sobre el estado del sistema en un momento determinado. Para obtener ms informacin,
consulte el tema sobre el archivo dump de indicadores en el captulo de solucin de problemas de
la Gua de administracin y seguridad.

Habilitacin de slo los servicios necesarios


Si algunos servicios de IBM Cognos 8 no son necesarios en su entorno, puede deshabilitarlos para
mejorar el rendimiento de otros servicios.
Por ejemplo, para que un equipo ejecute y distribuya informes, puede deshabilitar el servicio de
presentacin en un equipo servidor de informes. Al deshabilitar el servicio de presentacin, el rendimiento del servidor de informes mejorar.
Notas

El servicio de presentacin debe permanecer habilitado en un equipo del entorno IBM Cognos 8
como mnimo.

Si desea utilizar Query Studio, debe habilitar el servicio de presentacin.

Si desea utilizar Analysis Studio, debe habilitar el servicio de informes.

Si algunos componentes de IBM Cognos 8 no estn instalados en un equipo, debe deshabilitar


los servicios asociados con los componentes que faltan. De lo contrario, los componentes de
IBM Cognos 8 fallarn de forma aleatoria.

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

325

Captulo 16: Mantenimiento del rendimiento

Servicios de IBM Cognos 8


Despus de instalar y configurar IBM Cognos 8 habr un distribuidor en cada equipo de forma
predeterminada. Cada distribuidor tiene una serie de servicios asociados, los cuales se enumeran
en la siguiente tabla.

326 PowerPlay

Servicio

Funcin

Servicio del agente

Ejecuta agentes. Si las condiciones de un


agente se cumplen al ejecutarlo, el servicio
del agente pide al servicio del monitor que
ejecute las tareas.

Servicio de informe por lotes

Gestiona las peticiones de segundo plano


de ejecutar informes y ofrece salida en
nombre del servicio de control.

Servicio de Content Manager

Desempea funciones de manipulacin


de objetos en el almacn de contenido,
como aadir, consultar, actualizar,
borrar, mover y copiar.

Realiza funciones de gestin del almacn de contenido, como importar y


exportar.

Servicio de movimiento de datos

Gestiona la ejecucin de tareas de movimientos de datos en IBM Cognos 8. Las tareas


de movimiento de datos, como Builds y Job
Streams, se crean en Data Manager Designer y se publican en IBM Cognos 8.

Servicio de entrega

Enva correos electrnicos a un servidor


SMTP externo en nombre de otros servicios,
como los servicios de informe, trabajos,
agentes o integracin de datos.

Servicio de administracin de eventos

Crea, planifica y gestiona objetos de eventos


que representan informes, trabajos, agentes,
mantenimiento del almacn de contenido,
importacin y exportacin de implementaciones e indicadores

Captulo 16: Mantenimiento del rendimiento

Servicio

Funcin

Servicio de trabajos

Ejecuta trabajos indicando al servicio de


control que ejecute los pasos del trabajo en
segundo plano. Los pasos incluyen informes, otros trabajos, importaciones, exportaciones, etc.

Servicio de registro

Graba los mensajes de registro generados


por el distribuidor y otros servicios. El servicio de registro puede configurarse para
grabar informacin de registro en un
archivo, una base de datos, un servidor de
registro remoto, Windows Event Viewer o
un sistema de registro UNIX. Los clientes
o Cognos Software Services pueden entonces analizar la informacin de registro,
como la que se indica a continuacin:

Eventos de seguridad

Informacin de error del sistema y de


la aplicacin

Informacin de diagnstico seleccionada

Servicio Metric Studio

Proporciona la interfaz de usuario Metric


Studio para controlar e introducir informacin sobre el rendimiento.

Servicio de migracin

Gestiona la migracin de IBM Cognos


Series 7 a IBM Cognos 8.

Gua de instalacin y configuracin 327

Captulo 16: Mantenimiento del rendimiento

Servicio

Funcin

Servicio de control

Gestiona el control y la ejecucin de


tareas programadas, enviadas para su
ejecucin posterior o ejecutadas como
tareas de segundo plano.

Asigna un servicio de destino para que


se haga cargo de una tarea programada.
Por ejemplo, el servicio de control
puede pedir al servicio de informe por
lotes que ejecute un informe, al servicio
de trabajos que ejecute un trabajo o al
servicio de agentes que ejecute un
agente.

Crea objetos de historial en Content


Manager y gestiona la migracin tras
error y la recuperacin de entradas de
ejecucin.

Transforma las respuestas genricas


XML de otro servicio en formatos de
salida como HTML o PDF.

Ofrece funciones de visualizacin,


navegacin y administracin en IBM
Cognos Connection.

Servicio de presentacin

328 PowerPlay

Servicio de datos de informes

Gestiona la transferencia de datos de informes entre IBM Cognos 8 y las aplicaciones


que consumen los datos, como IBM Cognos
8 Go! Office o IBM Cognos 8 Go! Mobile.

Servicio de informe

Se encarga de las peticiones interactivas de


ejecucin de informes y ofrece salidas a los
usuarios de IBM Cognos Connection o de
una aplicacin Studio.

Servicio del sistema

Define el servicio Business Intelligence


compatible con Bus API empleado para
obtener los parmetros de configuracin de
toda la aplicacin IBM Cognos 8. Tambin
ofrece mtodos para normalizar y validar
cadenas regionales y asignar cadenas a
regiones admitidas por su aplicacin.

Captulo 16: Mantenimiento del rendimiento

Ajuste de un almacn de contenido DB2


Si utiliza una base de datos DB2 para el almacn de contenido (p. 43), puede tomar medidas para
mejorar la velocidad con la que se procesan las solicitudes.
De forma predeterminada, DB2 asigna tablas que contienen objetos de gran tamao (LOB) a un
espacio de tabla administrado por la base de datos. Como resultado, los LOB no se administran
por parte de los conjuntos de bferes de DB2. Esto da lugar a solicitudes de E/S directas en los LOB,
lo cual afecta al rendimiento. Si se vuelven a asignar las tablas que contienen LOB a un espacio de
tabla administrado por el sistema, se reduce el nmero de solicitudes de E/S directas.
Antes de cambiar un almacn de contenido DB2, asigne espacio de registro suficiente para reestructurar la base de datos.
Para volver a configurar el almacn de contenido DB2, realice lo siguiente:

Exporte los datos de las tablas que contienen al menos un objeto de gran tamao (LOB).

Cree las tablas en un espacio de tabla administrado por el sistema.

Importe los datos a las tablas.

Ajuste de la configuracin de Apache Tomcat


Si utiliza Apache Tomcat, puede editar la configuracin para mejorar el rendimiento.
Puede editar las configuraciones maxProcessor y acceptCount en el archivo server.xml.

Pasos
1. Abra el archivo server.xml.
2. Edite los valores de configuracin que aparecen despus del comentario siguiente:
<!-- Define a non-SSL Coyote HTTP/1.1 Connector on port 8080 -->

Busque la lnea siguiente:


maxProcessors="75"

y cmbiela por el texto siguiente:


maxProcessors="1000"

3. Busque la lnea siguiente:


acceptCount="100"

y cmbiela por el texto siguiente:


acceptCount="500"

4. Guarde el archivo server.xml actualizado.

Gua de instalacin y configuracin 329

Captulo 16: Mantenimiento del rendimiento

Aumento de la capacidad de gestin de solicitudes de la base


de datos de contenido de Cognos
La base de datos de contenido de Cognos est configurada para utilizarla con un sistema pequeo.
Si la utiliza en un sistema grande en el que el nmero de solicitudes simultneas es superior a diez,
debe ajustar la configuracin de la memoria JVM predeterminada y aumentar el tamao de la cach
de pgina para Derby.

Pasos
1. En el directorio ubicacin_c8\bin, abra el archivo derby.sh.
2. Busque la lnea siguiente:
MEM_SETTINGS=-Xmx256m

y cmbiela por el texto siguiente:


MEM_SETTINGS="-Xmx1152m -XX:MaxPermSize=128M -XX:MaxNewSize=576m
-XX:NewSize=288m"

3. En el directorio ubicacin_c8\configuration, cambie el nombre de derby.properties.sample por


derby.properties.
4. En el mismo directorio, abra el archivo derby.properties.
5. Marque como comentario la lnea siguiente:
derby.storage.pageCacheSize=15000

Reduccin del plazo de entrega de informes en una red


Los informes que se distribuyen de forma global tardan ms en abrirse en ubicaciones remotas que
si se abren de forma local. Adems, los informes HTML tardan ms en abrirse que los informes
PDF porque se procesan ms solicitudes para informes HTML.
Puede reducir la cantidad de tiempo necesario para abrir los informes en ubicaciones remotas de
dos modos. Puede reducir el nmero de solicitudes entre el explorador y el servidor ejecutando el
informe en formato PDF. Si se necesitan informes HTML, puede acelerar la entrega del informe
configurando puertas de enlace adicionales en algunas de las ubicaciones remotas. El contenido
esttico, como grficos y hojas de estilo, se entregar con mayor rapidez.

330 PowerPlay

Apndice A: Configuracin manual de IBM Cognos


8
Es posible que la consola conectada al equipo UNIX o Linux en el que est instalando IBM Cognos
8 no admita una interfaz grfica de usuario basada en Java. Debe realizar las siguientes tareas
manualmente.

Cambiar manualmente los valores de configuracin predeterminados editando el archivo


cogstartup.xml, ubicado en el directorio ubicacin_c8/configuration

Cambiar manualmente la compatibilidad de idioma o moneda o la asignacin de configuracin


regional editando el archivo coglocale.xml, ubicado en el directorio ubicacin_c8/configuration

Aplicar la configuracin y la configuracin regional en su equipo iniciando los servicios de IBM


Cognos 8 en modo silencioso

Implementar IBM Cognos 8 en un entorno de servidor de aplicaciones creando manualmente


un archivo de aplicacin de IBM Cognos

Para todas las instalaciones, son necesarias algunas tareas de configuracin para que IBM Cognos
8 funcione en su entorno. Si distribuye los componentes de IBM Cognos 8 en diversos equipos, el
orden en el que configura e inicia los equipos es importante.
Otras tareas de configuracin son opcionales y dependen del entorno de creacin de informes. Puede
cambiar el comportamiento predeterminado de IBM Cognos 8 editando el archivo cogstartup.xml
para cambiar los valores de propiedad. Asimismo, puede utilizar archivos de ejemplo que permitan
que IBM Cognos 8 utilice los recursos que ya existen en su entorno.

Configuracin manual de IBM Cognos 8 en UNIX y Linux


Es posible que la consola conectada al equipo UNIX o Linux en el que est instalando IBM Cognos
8 no admita una interfaz grfica de usuario basada en Java. Debe realizar lo siguiente:

Cambiar manualmente los valores de configuracin predeterminados editando el archivo


cogstartup.xml, ubicado en el directorio ubicacin_c8/configuration

Cambiar manualmente la compatibilidad de idioma o moneda o la asignacin de configuracin


regional editando el archivo coglocale.xml, ubicado en el directorio ubicacin_c8/configuration

Aplicar la configuracin y la configuracin regional en su equipo ejecutando IBM Cognos


Configuration en modo silencioso

Para todas las instalaciones, son necesarias algunas tareas de configuracin para que IBM Cognos
8 funcione en su entorno. Si distribuye los componentes de IBM Cognos 8 en diversos equipos, el
orden en el que configura e inicia los equipos es importante.
Otras tareas de configuracin son opcionales y dependen del entorno de creacin de informes. Puede
cambiar el comportamiento predeterminado de IBM Cognos 8 editando el archivo cogstartup.xml
Licensed Materials Property of IBM
Copyright IBM Corp. 2005, 2009.

331

Apndice A: Configuracin manual de IBM Cognos 8


para cambiar los valores de propiedad. Asimismo, puede utilizar archivos de ejemplo que permitan
que IBM Cognos 8 utilice los recursos que ya existen en su entorno.

Cambio manual de los valores de configuracin predeterminados en equipos UNIX


y Linux
Si la consola conectada al equipo UNIX o Linux no admite una interfaz grfica de usuario basada
en Java, debe editar el archivo cogstartup.xml para configurar IBM Cognos 8 para que funcione
en su entorno.
Nota: Algunos valores de configuracin no se guardan en el archivo cogstartup.xml a menos que
utilice la interfaz grfica de usuario. Por ejemplo, la zona horaria del servidor no se configura para
los componentes de IBM Cognos cuando modifica el archivo cogstartup.xml directamente y, a
continuacin, ejecuta IBM Cognos Configuration en modo silencioso. En este caso, es posible que
otras configuraciones de usuario que dependen de la zona horaria del servidor no funcionen como
cabe esperar.
Si desea que IBM Cognos 8 utilice un recurso, como un proveedor de autenticacin que ya existe
en el entorno, puede aadir un componente a la configuracin. Para ello, copie el cdigo XML
necesario de los archivos de ejemplo en el archivo cogstartup.xml y, a continuacin, edite los valores
para que se adapten a su entorno.
Importante: De forma predeterminada, el archivo cogstartup.xml est codificado con UTF-8. Al
guardar el archivo cogstartup.xml, asegrese de que cambia la codificacin de la configuracin
regional de usuario para que coincida con la codificacin que se utiliza. Las variables de entorno
definen la codificacin de la configuracin regional.
Al editar el archivo cogstartup.xml, recuerde que XML distingue entre maysculas y minsculas.
Las maysculas y las minsculas son importantes en todos los usos de texto, incluidas las etiquetas
de elemento y atributo, los elementos y los valores.
Antes de editar el archivo cogstartup.xml, asegrese de que:

Realiza una copia de seguridad.

Crea el almacn de contenido en un equipo disponible de la red.

Revisa los requisitos de configuracin para el tipo de instalacin.

Pasos
1. Vaya al directorio ubicacin_c8/configuration.
2. Abra el archivo cogstartup.xml en un editor.
3. Busque el valor de configuracin que desea cambiar; para ello, consulte los comentarios de la
ayuda y la descripcin que aparecen antes de la etiqueta inicial de los elementos
<crn:parameter> .
4. Cambie el valor del elemento <crn:value> para que se adapte a su entorno.
Sugerencia: Utilice el atributo type para determinar el tipo de datos para la propiedad de
configuracin.

332 PowerPlay

Apndice A: Configuracin manual de IBM Cognos 8


5. Repita los pasos del 3 al 4 hasta que los valores de configuracin sean los adecuados para su
entorno.
6. Guarde y cierre el archivo.
Ahora debe utilizar un editor XML de validacin para validar los cambios respecto a las reglas del
archivo cogstartup.xsd, ubicado en ubicacin_c8/configuration.

Adicin de un componente a la configuracin


El archivo cogstartup.xml contiene los valores de configuracin que utilizan IBM Cognos 8 y los
componentes de terceros predeterminados. Puede cambiar los componentes que utiliza IBM Cognos
8 copiando los elementos XML de los archivos de ejemplo en el archivo cogstartup.xml. A continuacin, puede editar los valores de configuracin para que se adapten a su entorno.
Por ejemplo, para utilizar una base de datos Oracle en el almacn de contenido, puede utilizar el
archivo de ejemplo ContentManager_cdigo de idioma.xml para sustituir la informacin de conexin
de la base de datos predeterminada.
IBM Cognos 8 slo puede utilizar una instancia de los elementos siguientes a la vez:

La base de datos para el almacn de contenido

Un proveedor criptogrfico

Una plantilla de configuracin para el servicio IBM Cognos 8

Debe estar familiarizado con la estructura de los archivos XML antes de empezar a editarlos.

Pasos
1. Vaya al directorio ubicacin_c8/configuration/samples.
2. Elija un archivo de ejemplo que desea abrir en un editor:

Para utilizar Oracle, DB2 o Sybase para el almacn de contenido, abra el archivo ContentManager_cdigo_idioma.xml.

Para utilizar un proveedor de autenticacin, abra el archivo Authentication_cdigo_idioma.xml.

Para utilizar un proveedor criptogrfico de terceros, abra el archivo Cryptography_cdigo_idioma.xml.

Para enviar mensajes de registro a un lugar distinto de un archivo, abra el archivo Logging_cdigo_idioma.xml.

Para utilizar una plantilla mediana o grande para la cantidad de recursos que utiliza el
proceso de IBM Cognos 8, abra el archivo CognosService_cdigo_idioma.xml.

3. Copie los elementos que necesite.


Sugerencia: Asegrese de que copia el cdigo que incluye las etiquetas iniciales y finales para
el elemento <crn:instance>.
Por ejemplo, busque los comentarios (Inicio de) y (Fin de):

Gua de instalacin y configuracin 333

Apndice A: Configuracin manual de IBM Cognos 8


<!-- =============================================== (Begin of) DB2 template
--> <crn:instance ...> ... </crn:instance> <!-- End of) DB2 template
=============================================== -->

4. Vaya al directorio ubicacin_c8/configuration.


5. Abra el archivo cogstartup.xml en un editor.
6. Pegue el cdigo del archivo de ejemplo en el archivo cogstartup.xml y sustituya el elemento
<crn:instance> adecuado.
7. Cambie los valores de estos nuevos elementos para adaptarlos a su entorno.
Para el elemento <crn:instance>, no cambie el atributo de clase. Puede cambiar el atributo
de nombre para adaptarlo a su entorno.
Por ejemplo, si utiliza una base de datos Oracle para el almacn de contenido, cambie slo el
atributo de nombre para adaptarlo a su entorno.
<crn:instance class="Oracle" name="MyContentStore">

8. Guarde y cierre el archivo.


9. Ejecute IBM Cognos Configuration en modo silencioso escribiendo el comando siguiente:
./cogconfig.sh -s
De este modo, se garantiza que el archivo es vlido y que las contraseas estn codificadas.

Cambio manual de la configuracin codificada


Puede cambiar manualmente la configuracin codificada, como contraseas y credenciales de
usuario, en el archivo cogstartup.xml.
Para que IBM Cognos Configuration guarde una configuracin codificada, cambie el valor y, a
continuacin, establezca el indicador de codificacin en falso.

Pasos
1. Vaya al directorio ubicacin_c8/configuration.
2. Abra el archivo cogstartup.xml en un editor.
3. Busque la configuracin codificada que desea cambiar; para ello, consulte los comentarios de
la ayuda y la descripcin que aparecen antes de la etiqueta inicial de los elementos
<crn:parameter>.
4. Cambie el valor del elemento <crn:value> para que se adapte a su entorno.
Sugerencia: Utilice el atributo type para determinar el tipo de datos para la propiedad de configuracin.
5. Cambie el valor de codificacin a falso.
Por ejemplo:
<crn:value encrypted="false">

334 PowerPlay

Apndice A: Configuracin manual de IBM Cognos 8


6. Repita los pasos del 3 al 5 hasta que los valores de configuracin sean los adecuados para su
entorno.
7. Guarde y cierre el archivo.
8. Escriba el comando de configuracin siguiente:
./cogconfig.sh -s
La nueva configuracin se guarda y se codifica.

Cambio manual de la configuracin global en equipos UNIX y Linux


Si la consola conectada al equipo UNIX o Linux no admite una interfaz grfica de usuario basada
en Java, debe editar manualmente el archivo coglocale.xml ubicado en el directorio ubicacin_c8/configuration.
Puede cambiar la configuracin global

Para especificar el idioma utilizado en la interfaz de usuario cuando el idioma de la configuracin


regional del usuario no est disponible

Para especificar la configuracin regional utilizada en los informes cuando la configuracin


regional del usuario no est disponible

Para aadir la compatibilidad de configuracin regional o moneda a los datos y metadatos de


informes

Para aadir la compatibilidad de idioma a la interfaz de usuario

De forma predeterminada, los componentes de IBM Cognos 8 garantizan que todas las configuraciones regionales, que pueden provenir de diferentes orgenes y en diversos formatos, utilizan una
forma normalizada. Esto significa que todas las configuraciones regionales ampliadas se ajustan a
una configuracin de idioma y cdigo regional.
Antes de que pueda aadir la compatibilidad de idioma a la interfaz de usuario, debe instalar los
archivos de idioma en todos los equipos de la instalacin distribuida. Para obtener ms informacin,
pngase en contacto con Cognos Software Services.

Ejemplo 1
Un informe est disponible en Content Manager en dos configuraciones regionales, como en-us
(ingls-Estados Unidos) y fr-fr (francs-Francia), pero la configuracin regional del usuario est
definida como fr-ca (francs-Canad). IBM Cognos 8 utiliza la asignacin de configuracin regional
para determinar qu informe visualiza el usuario.
En primer lugar, IBM Cognos 8 comprueba si el informe est disponible en Content Manager, en
la configuracin regional del usuario. Si no est disponible en la configuracin regional del usuario,
IBM Cognos 8 asigna la configuracin regional del usuario a una configuracin regional normalizada
configurada en la pestaa Asignaciones de configuracin regional de contenido. Dado que la configuracin regional del usuario es fr-ca, est asignada a fr., IBM Cognos 8 utiliza el valor asignado
para ver si el informe est disponible en fr. En este caso, el informe est disponible en en-us y fr-fr,
no en fr.

Gua de instalacin y configuracin 335

Apndice A: Configuracin manual de IBM Cognos 8


A continuacin, IBM Cognos 8 asigna todos los informes disponibles a una configuracin regional
normalizada. Por lo tanto, en-us pasa a ser en y fr-fr se convierte en fr.
Dado que el informe y la configuracin regional del usuario se asignan a fr, el usuario con la configuracin regional de usuario fr-ca ver el informe guardado con la configuracin regional fr-fr.

Ejemplo 2
La configuracin regional del usuario y la configuracin regional del informe se asignan al mismo
idioma. IBM Cognos 8 selecciona qu configuracin regional se debe utilizar. Por ejemplo, si la
configuracin regional de un usuario es en-ca (ingls-Canad) y los informes estn disponibles en
en-us (ingls-Estados Unidos) y en-gb (ingls-Reino Unido), todas las configuraciones regionales se
asignarn a en. El usuario ver el informe en la configuracin regional que elija el producto IBM
Cognos 8.

Ejemplo 3
La configuracin regional del informe y la del usuario no se asignan a un idioma comn. El producto
IBM Cognos 8 elige el idioma. En este caso, es posible que desee configurar una asignacin. Por
ejemplo, si un informe est disponible en en-us (ingls-Estados Unidos) y fr-fr (francs-Francia)
pero la configuracin regional del usuario es es-es (espaol-Espaa), el producto IBM Cognos 8
selecciona el idioma.

Pasos
1. En todos los equipos en los que ha instalado Content Manager, vaya al directorio ubicacin_c8/configuration.
2. Abra el archivo coglocale.xml en un editor.
3. Aada o modifique el elemento y el atributo necesarios entre las etiquetas iniciales y finales
adecuadas.

336 PowerPlay

Tipo de elemento

Etiqueta inicial

Etiqueta final

Idioma

<supportedProductLocales>

</supportedProductLocales>

Configuraciones regio- <supportedContentLocales>


nales de contenido

</supportedContentLocales>

Moneda

</supportedCurrencies>

<supportedCurrencies>

Asignacin de configu- <productLocaleMap>


racin regional de productos

</productLocaleMap>

Asignacin de configu- <contentLocaleMap>


racin regional de contenido

</contentLocaleMap>

Apndice A: Configuracin manual de IBM Cognos 8

Tipo de elemento

Etiqueta inicial

Etiqueta final

Fuentes

<supportedFonts>

</supportedFonts>

Configuracin de coo- <parameter name="configurakies, ubicacin de


cin">
archivo para los informes

</parameter>

Sugerencia: Para eliminar la compatibilidad, elimine el elemento.


4. Guarde y cierre el archivo.
Sugerencia: Se recomienda utilizar un editor XML de validacin para validar los cambios respecto
a las reglas del archivo cogstartup.xsd, ubicado en ubicacin_c8/configuration.
Si aade un cdigo de moneda que no es compatible con IBM Cognos, debe aadirlo manualmente
en el archivo i18n_res.xml del directorio ubicacin_c8/bin/. Copie este archivo en todos los equipos
de IBM Cognos de su instalacin.

Inicio y detencin de IBM Cognos 8 en modo silencioso en equipos UNIX y Linux


IBM Cognos Configuration se ejecuta en modo silencioso para aplicar los valores de configuracin
e iniciar los servicios en equipos UNIX o Linux que no son compatibles con una interfaz grfica
de usuario basada en Java.
Antes de ejecutar la herramienta de configuracin en modo silencioso, debe asegurarse de que el
archivo cogstartup.xml es vlido segn las reglas definidas en el archivo cogstartup.xsd. El archivo
cogstartup.xsd se encuentra en el directorio ubicacin_c8/configuration.

Pasos para el inicio de IBM Cognos 8


1. Asegrese de que el archivo cogstartup.xml, ubicado en el directorio ubicacin_c8/configuration,
se ha modificado para su entorno.
Para obtener ms informacin, consulte "Cambio manual de los valores de configuracin predeterminados en equipos UNIX y Linux" (p. 332).
2. Vaya al directorio ubicacin_c8/bin.
3. Escriba el comando siguiente:
./cogconfig.sh -s
Sugerencia: Para ver los mensajes de registro generados durante una configuracin sin participacin del usuario, consulte el archivo cogconfig_response.csv en el directorio ubicacin_c8/logs.

Gua de instalacin y configuracin 337

Apndice A: Configuracin manual de IBM Cognos 8


IBM Cognos Configuration aplica los valores de configuracin especificados en el archivo cogstartup.xml, codifica las credenciales, genera certificados digitales y, si corresponde, inicia el servicio
o el proceso de IBM Cognos 8.

Pasos para la detencin de IBM Cognos 8


1. Vaya al directorio ubicacin_c8/bin.
2. Escriba el comando siguiente:
./cogconfig.sh -stop

Creacin manual de un archivo de aplicacin de IBM Cognos


IBM Cognos 8 y la puerta de enlace del servlet deben estar empaquetados en un archivo de aplicacin
para su implementacin en los servidores de aplicaciones compatibles (p. 295), (p. 268). IBM Cognos 8
proporciona un asistente de aplicacin de creacin que puede utilizar para crear el archivo de aplicacin.
Puede crear un archivo Web (.war), un archivo Enterprise (.ear) o un directorio expandido que
incluya todos los archivos necesarios para la aplicacin. Para obtener informacin sobre los archivos
WAR y EAR o los directorios expandidos y para determinar la compatibilidad con su servidor de
aplicaciones, consulte la documentacin suministrada con el servidor de aplicaciones.
Si decide no utilizar el asistente de aplicacin de creacin, debe realizar los pasos siguientes para
crear el archivo de aplicacin.
Si el servidor de aplicaciones no se est utilizando como servidor Web, no es necesario incluir el
contenido esttico de IBM Cognos (pginas html, imgenes, etc.) en el archivo de aplicacin. La
exclusin del contenido esttico al crear el archivo de aplicacin reduce el tamao del archivo.

Pasos para la creacin de un archivo de aplicacin de IBM Cognos 8


1. Vaya al directorio ubicacin_c8/war/p2pd.
2. Ejecute el script de creacin utilizando la sintaxis de comando siguiente:

Para Windows,
build.bat opcin_tipo_de_archivo

Para UNIX o Linux,


build.sh opcin_tipo_de_archivo

donde opcin_tipo_de_archivo puede ser uno de los siguientes:

338 PowerPlay

Valor

Descripcin

war

Archivo WAR con contenido esttico

war_without_webcontent

Archivo WAR sin contenido esttico

Apndice A: Configuracin manual de IBM Cognos 8

Valor

Descripcin

war_without_docsamples

Archivo WAR con contenido esttico y sin documentacin ni archivos de ejemplo

ear

Archivo EAR con contenido esttico

ear_without_webcontent

Archivo EAR sin contenido esttico

ear_without_docsamples

Archivo EAR con contenido esttico y sin documentacin ni archivos de ejemplo

expand

Directorio que contiene la aplicacin con contenido


esttico

expand_without_webcontent

Directorio que contiene la aplicacin sin contenido


esttico

expand_without_docsamples

Directorio que contiene la aplicacin con contenido


esttico y sin documentacin ni archivos de ejemplo

y donde opcin puede ser uno o varios de los siguientes:

Opcin

Valor

Descripcin

-Dappserver_type=valor

jboss

Realiza acciones para un


servidor de aplicaciones
JBoss.

otro (predeterminado)

Realiza acciones para un


servidor de aplicaciones
que no es JBoss.
-Dcontext_root=valor

p2pd (predeterminado)

-Dwar_name=valor

ruta/nombre de archivo

-Dear_name=valor

ruta/nombre de archivo

Predefine un valor raz de


contexto para la aplicacin.

Ruta y nombre del archivo


El valor predeterminado WAR que se va a crear.
es ../../p2pd.war.
Ruta y nombre del archivo
El valor predeterminado EAR que se va a crear.
es ../../p2pd.ear.

Gua de instalacin y configuracin 339

Apndice A: Configuracin manual de IBM Cognos 8

Opcin

Valor

-Dexpand_location=valor

ruta/directorio

(para tipos de archivos expandidos)

Descripcin

Ruta al directorio en el
El valor predeterminado que se van a expandir los
archivos de aplicacin.
es ../../temp/expand.

Pasos para la creacin de un archivo de aplicacin de la puerta de enlace del servlet


1. Vaya al directorio ubicacin_c8/war/gateway.
2. Ejecute el script de creacin utilizando la sintaxis de comando siguiente:

Para Windows,
build.bat opcin_tipo_de_archivo

Para UNIX o Linux,


build.sh opcin_tipo_de_archivo

donde opcin_tipo_de_archivo puede ser uno de los siguientes:

Valor

Descripcin

gateway_war

Archivo WAR con contenido esttico

gateway_war_without_docsamples

Archivo WAR con contenido esttico y sin


documentacin ni archivos de ejemplo

gateway_ear

Archivo EAR con contenido esttico

gateway_ear_without_docsamples

Archivo EAR con contenido esttico y sin


documentacin ni archivos de ejemplo

expand

Directorio que contiene la aplicacin con


contenido esttico

expand_without_docsamples

Directorio que contiene la aplicacin con


contenido esttico y sin documentacin ni
archivos de ejemplo

y donde opcin puede ser uno o varios de los siguientes:

340 PowerPlay

Apndice A: Configuracin manual de IBM Cognos 8

Opcin

Valor

Descripcin

-Dappserver_type=valor

jboss

Realiza acciones para un


servidor de aplicaciones
JBoss.

otro (predeterminado)

Realiza acciones para un


servidor de aplicaciones
que no es JBoss.
-Dcontext_root=valor

ServletGateway (predeterminado) Predefine un valor raz de


contexto para la aplicacin.

-Dwar_name=valor

ruta/nombre de archivo
El valor predeterminado es ../../
ServletGateway.war.

-Dear_name=valor

ruta/nombre de archivo
El valor predeterminado es ../../
ServletGateway.ear.

-Dexpand_location=valor

ruta/directorio
El valor predeterminado es
../../temp/expand.

Ruta y nombre del archivo


WAR que se va a crear.

Ruta y nombre del archivo


EAR que se va a crear.

Ruta al directorio en el
que se van a expandir los
archivos de aplicacin.

Gua de instalacin y configuracin 341

Apndice A: Configuracin manual de IBM Cognos 8

342 PowerPlay

Apndice B: Solucin de problemas


Utilice esta informacin de referencia para solucionar problemas a modo de recurso para problemas
especficos que puede encontrar durante o despus de la instalacin de los componentes de IBM
Cognos 8 PowerPlay.
Los problemas se caracterizan por sus sntomas. Cada sntoma permite rastrear una o ms causas
mediante las herramientas y tcnicas especficas para solucionar problemas. Una vez identificado,
cada problema se puede solucionar con la ejecucin de una serie de acciones.
Al solucionar problemas, pueden serle de ayuda los archivos de registro. Otra valiosa herramienta
para solucionar problemas es la Knowledge Base, que est disponible en el centro de recursos de
IBM Cognos (http://www.ibm.com/software/data/support/cognos_crc.html). La Knowlegde Base
es una base de datos de problemas y soluciones para todos los productos de IBM Cognos.
Si no puede resolver un problema, el ltimo recurso es acudir a su representante de asistencia tcnica
de IBM Cognos. Para analizar un problema, su representante de asistencia tcnica precisa informacin
sobre la situacin y los sntomas que est experimentando. Para poder aislar el problema, recopile
los datos necesarios antes de ponerse en contacto con su representante.

Archivos de registro
Los archivos de registro pueden ayudarle a resolver problemas al registrar las actividades que tienen
lugar cuando trabaja con un producto. Las operaciones realizadas en IBM Cognos 8 se registran
en varios archivos de registro con la finalidad de poder llevar a cabo un seguimiento. Por ejemplo,
si ha experimentado problemas durante la instalacin de IBM Cognos 8, consulte el archivo de
registro de transferencia para conocer las actividades realizadas por el asistente para instalacin
durante la transferencia de archivos.
Antes de ver los archivos de registro, asegrese de que contienen la informacin que necesita. El
nmero de archivos de registro y la informacin que contienen se configura mediante parmetros
en IBM Cognos Connection e IBM Cognos Configuration.
Utilice IBM Cognos Administration para obtener ms informacin sobre las categoras de registro
y sobre cmo configurar el nivel de detalle de cada categora.
Para obtener ms informacin, consulte IBM Cognos 8 Gua de administracin y seguridad.
Use IBM Cognos Configuration para especificar el tamao, nmero y ubicacin de los archivos de
registro, y para configurar las propiedades del servidor de registro. Para obtener ms informacin,
consulte IBM Cognos Configuration Gua del usuario.
Cuando necesite solucionar un problema, pueden serle de ayuda los siguientes archivos:

El archivo de registro de transferencia


Este archivo registra las actividades que el asistente para instalacin ha realizado durante la transferencia de archivos. El archivo de registro de transferencia se encuentra en el directorio ubicacin_c8\instlog. El nombre del archivo identifica el nombre del producto, la versin y el nmero
Licensed Materials Property of IBM
Copyright IBM Corp. 2005, 2009.

343

Apndice B: Solucin de problemas


de sta, e incluye adems una marca de hora. A continuacin, se incluye un ejemplo del formato
de nombre de archivo:
tl-C8BISRVR-8.1-0.0-20080901_1122.txt

El archivo de registro de resumen/errores de transferencia


En este archivo se registran los componentes que ha instalado, la informacin sobre el espacio en
disco, las selecciones realizadas en los dilogos de transferencia y cualquier error encontrado por
el asistente para instalacin durante la transferencia de los componentes. El archivo de registro de
resumen/errores de transferencia se encuentra en el directorio ubicacin_c8/instlog. El nombre del
archivo identifica el nombre del producto, la versin y el nmero de sta, e incluye adems una
marca de hora. A continuacin, se incluye un ejemplo del formato de nombre de archivo:
tl-C8BISRVR-8.1-0.0-20080901_1122_summary_error.txt

El archivo de configuracin de inicio


En este archivo se registran sus opciones de configuracin cada vez que guarda su configuracin
de propiedades. El archivo se llama cogstartup.xml. Si no puede guardar su configuracin, o si tiene
problemas, puede volver a un archivo de configuracin guardado anteriormente. Las copias de
seguridad de los archivos de configuracin se encuentran en el directorio ubicacin_c8/configuration.
A continuacin, se incluye un ejemplo del formato de nombre de archivo para las copias de seguridad
de los archivos de configuracin:
cogstartup_200811231540.xml

El archivo de bloqueo de configuracin de inicio


Este archivo se crea cada vez que se abre IBM Cognos Configuration, e impide que se abra ms de
una ventana de IBM Cognos Configuration. Si experimenta algn problema al abrir IBM Cognos
Configuration, puede comprobar el directorio ubicacin_c8/configuration para ver si est el archivo
cogstartup.lock. Si existe el archivo e IBM Cognos Configuration no est abierto, significa que IBM
Cognos Configuration no se apag correctamente la ltima vez que lo us. Puede eliminar el archivo
de bloqueo y despus abrir IBM Cognos Configuration.

El archivo de configuracin regional


En este archivo se registran las opciones de configuracin que se realizan en IBM Cognos Configuration con respecto a las configuraciones regionales de productos y contenidos, asignacin de configuracin regional y compatibilidad con moneda. Si experimenta algn problema con la compatibilidad de idioma en la interfaz de usuario o en los informes, use estos archivos para realizar un
seguimiento de los cambios. Las copias de seguridad de los archivos de configuracin se encuentran
en el directorio ubicacin_c8/configuration. A continuacin, se incluye un ejemplo del formato de
nombre de archivo:
coglocale_200811231540.xml

El archivo de registro de tiempo de ejecucin


En el archivo de registro predeterminado de IBM Cognos llamado cogserver.log, o en otros archivos
de registro que se configuran para recibir mensajes de registro del servidor de registro, se registra
informacin despus de iniciar el servicio IBM Cognos 8. Estos archivos estn ubicados en el
344 PowerPlay

Apndice B: Solucin de problemas


directorio ubicacin_c8/logs. Si ha configurado otro destino para los mensajes de registro, consulte
el archivo o la base de datos correspondiente.
Algunos mensajes de registro indican problemas. La mayora de los mensajes proporcionan exclusivamente informacin, pero otros pueden ayudarle a diagnosticar problemas en el entorno de
tiempo de ejecucin.

El archivo de registro de puerta de enlace


Las puertas de enlace registran los errores en el archivo de registro de puerta de enlace, que est
ubicado en el directorio ubicacin_c8/logs. Puede usar el archivo de registro de puerta de enlace
para solucionar aquellos problemas que impidan que la puerta de enlace pueda procesar solicitudes
o usar codificacin. Los sntomas de estos problemas son identificadores de usuario y contraseas
que no funcionan, inicios de sesin nicos que no funcionan o que el distribuidor se ejecuta pero
los usuarios reciben el siguiente mensaje de error: The IBM Cognos BI server is not available.
El archivo de registro de puerta de enlace usa el siguiente formato de nombre, donde interfaz_gateway
es cgi, mod (mdulo Apache 1.3), mod2 (mdulo Apache 2.0) o isapi.
gwinterfaz_puertadeenlace.log (por ejemplo, gwcgi.log)

El archivo de registro de desinstalacin


En este archivo se registran las actividades que el asistente para desinstalacin ha realizado durante
la desinstalacin de los archivos. El archivo de registro se llama cognos_uninst_log.htm y est ubicado
en el directorio Temp. Puede usar el archivo de registro para solucionar problemas relacionados
con la desinstalacin de componentes de IBM Cognos 8.

El archivo de registro de modo silencioso


En este archivo se registran las actividades que IBM Cognos Configuration ha realizado mientras
funcionaba en modo silencioso. Este archivo de registro se llama cogconfig_response.csv y est
ubicado en el directorio ubicacin_c8/logs.

Archivo de actualizacin de ReportNet(R) a IBM Cognos 8


Este archivo contiene un resumen de los resultados de una actualizacin de ReportNet a IBM
Cognos 8. El archivo de registro se llama upgradeLog.xml y est ubicado en el directorio ubicacin_c8/logs. El archivo se encuentra en formato XML y hace referencia a una hoja de estilo XSLT.
Puede hacer doble clic en el archivo para que aparezca en el explorador.

Problemas al iniciar IBM Cognos 8


Puede haber problemas al intentar:

Iniciar el servicio IBM Cognos 8

Abrir por primera vez la pgina Bienvenido en el portal de IBM Cognos 8

Iniciar un servidor de aplicaciones como WebLogic o WebSphere

Gua de instalacin y configuracin 345

Apndice B: Solucin de problemas

Sntomas

Solucin

No visualiza la pantalla de inicio del portal de


IBM Cognos cuando inicia IBM Cognos 8.

Compruebe la configuracin del servidor Web.

El servicio se inicia, pero no se crean tablas en la Compruebe la configuracin del almacn de contenido.
base de datos del almacn de contenido.
El servicio no se inicia.

Espere unos segundos antes de enviar una solicitud.

El servidor de aplicaciones no se inicia.

Compruebe los permisos de archivo y los nombres de directorio


de la ubicacin de instalacin del servidor de aplicaciones.

Asegrese de que utiliza software compatible con los componentes de IBM Cognos. Encontrar
una lista actualizada de entornos, por ejemplo, sistemas operativos, revisiones, exploradores, servidores Web, servidores de directorios y servidores de base de datos, en el centro de recursos de IBM
Cognos (http://www.ibm.com/software/data/support/cognos_crc.html).

Error CFG-ERR-0106 al iniciar el servicio IBM Cognos 8 en IBM Cognos Configuration


Al iniciar el servicio IBM Cognos 8, es posible que aparezca el mensaje de error siguiente:
CFG-ERR-0106 IBM Cognos Configuration no ha recibido ninguna respuesta del servicio IBM
Cognos 8 en el tiempo asignado. Compruebe que el servicio IBM Cognos 8 est disponible y
correctamente configurado.
Este problema tiene dos posibles causas:

El servicio IBM Cognos 8 necesita ms tiempo para iniciarse.

Es posible que la configuracin de un equipo de Content Manager en espera sea incorrecta.

El servicio IBM Cognos 8 necesita ms tiempo


De forma predeterminada, IBM Cognos Configuration comprueba el progreso de la solicitud de
inicio cada medio segundo durante tres minutos. Si IBM Cognos Configuration no recibe ninguna
respuesta durante este tiempo, aparece el mensaje de error.
Para evitar este error, puede cambiar el intervalo de tiempo que IBM Cognos Configuration espera
para recibir una respuesta del servicio IBM Cognos 8. Para ello, configure las propiedades ServiceWaitInterval y ServiceMaxTries en el archivo ubicacin_c8/configuration/cogconfig.prefs.
La propiedad ServiceWaitInterval representa el intervalo de tiempo, en milisegundos, en el que IBM
Cognos Configuration comprueba el progreso de la solicitud de inicio. El valor predeterminado es
500, que equivale a medio segundo.
La propiedad ServiceMaxTries representa el nmero de veces que IBM Cognos Configuration
comprueba el progreso de la solicitud de inicio. El valor predeterminado es 360.

346 PowerPlay

Apndice B: Solucin de problemas

Content Manager est configurado incorrectamente


Si el mensaje de error aparece en un equipo de Content Manager en espera, es posible que la configuracin para el almacenamiento de claves simtricas sea incorrecta.
Para evitar este problema, configure el equipo de Content Manager en espera para almacenar claves
simtricas de forma local.

Pasos para cambiar el tiempo de espera


1. Mediante IBM Cognos Configuration, detenga el servicio IBM Cognos 8.
2. Abra el archivo ubicacin_c8/configuration/cogconfig.prefs en un editor.
Este archivo se crea automticamente cuando abre IBM Cognos Configuration por primera
vez.
3. Aada el cdigo siguiente al archivo:
ServiceWaitInterval=nmero de milisegundos
ServiceMaxTries=nmero de veces
Sugerencia: Aada los valores numricos que correspondan a sus necesidades de configuracin.
4. Guarde el archivo.
5. Mediante IBM Cognos Configuration, inicie el servicio IBM Cognos 8.

Pasos para almacenar claves simtricas de forma local


1. Inicie IBM Cognos Configuration en el equipo de Content Manager en espera.
2. En la ventana Explorador, en Seguridad, haga clic en Criptografa.
3. En la ventana Propiedades, en Configuracin CSK, marque Almacenar clave simtrica localmente
como Verdadero.
4. En el men Archivo, haga clic en Guardar.
5. En el men Acciones, haga clic en Iniciar.
Esta accin inicia todos los servicios instalados que no se estn ejecutando. Si desea iniciar un
servicio en particular, seleccione el nodo de servicio en la ventana Explorador y, a continuacin,
haga clic en Iniciar en el men Acciones.

Error criptogrfico al iniciar IBM Cognos 8


Se detect el siguiente error cuando intent iniciar el servicio IBM Cognos 8 tras instalar componentes de cliente o de servidor:
[Criptografa]
1. [ERROR] java.lang.NoClassDefFoundError:
javax/net/ServerSocketFactory:

Gua de instalacin y configuracin 347

Apndice B: Solucin de problemas


En el entorno en tiempo de ejecucin de Java (JRE) faltan las rutinas de codificacin y descodificacin
que necesita IBM Cognos 8. Debe copiar el archivo Java Archive (.jar) que IBM Cognos proporciona
en el directorio JRE.

Paso

Copie el archivo bcprov-jdknn-nnn.jar del directorio ubicacin_c8/bin/jre/versin/lib/ext al


directorio ubicacin_Java/jre/lib/ext.

No se puede iniciar el servicio IBM Cognos 8 porque otro proceso utiliza el puerto
Es posible que no pueda iniciar el proceso o el servicio IBM Cognos 8 si otro proceso utiliza uno
de los puertos predeterminados.
Sugerencia: Para ver las conexiones de red TCP/IP de la red actual, utilice el comando netstat.
Utilice IBM Cognos Configuration para cambiar el puerto predeterminado que utiliza IBM Cognos
8.
Cuando modifica el puerto que utiliza el distribuidor local, debe cambiar el valor de las propiedades
del URI de distribuidor. Dado que el cambio afecta a todos los URI basados en el distribuidor local,
debe cambiar los URI de todos los componentes locales. De forma predeterminada, los componentes
locales contienen localhost en el URI.
Por ejemplo, si instala todos los componentes en un equipo y desea cambiar el puerto del distribuidor,
sustituya 9300 en todos los URI de distribuidor y Content Manager por el nuevo nmero de puerto.

Pasos para cambiar el puerto predeterminado


1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, haga clic en el grupo o el componente pertinente:

Para acceder al nmero de puerto de los URI del distribuidor y de Content Manager, haga
clic en Entorno.

Para acceder al nmero de puerto del servidor de registro local, vaya a Entorno y haga clic
en Registro.

Para acceder al nmero de puerto de apagado, vaya a Entorno, haga clic en Servicio IBM
Cognos 8, IBM Cognos 8.

Para acceder al nmero de puerto de la ubicacin del archivo de aplicaciones .xml usado
por Portal Services, en Entorno, haga clic en Portal Services.

3. En la ventana Propiedades, haga clic en el cuadro Valor situado junto a la propiedad que desea
cambiar.
4. Cambie el valor 9300 por otro nuevo.
Asegrese de que cambia los puertos en todos los URI que contienen localhost:9300.
5. En el men Archivo, haga clic en Guardar.
6. En el men Acciones, haga clic en Iniciar.

348 PowerPlay

Apndice B: Solucin de problemas

El servicio IBM Cognos 8 no se inicia o falla tras iniciarse


El servicio IBM Cognos 8 se inicia, pero los servicios no se inician correctamente o tardan mucho
en iniciarse. Una vez que se inician los servicios, el sistema falla poco tiempo despus. Mientras los
servicios se estn iniciando, Java utiliza el 100% del tiempo de la CPU. Asimismo, pueden aparecer
varias veces mensajes de error como los siguientes:

DPR-DPR-1035 El distribuidor ha detectado un error.

CAM-CRP-1157 No se puede sincronizar el almacn de claves simtricas comunes locales con


Content Manager.

Si utiliza una base de datos DB2 para el almacn de contenido, asegrese de que la versin de la
base de datos y la versin de Java son compatibles. Para la versin 8.2 de DB2, no se admite Java
1.5. Para la versin 9 de DB2, se admite Java 1.5 en todos los sistemas operativos salvo HPUX y
Solaris.
Para ver una lista actualizada de los entornos compatibles con los productos IBM Cognos, por
ejemplo sistemas operativos, parches, exploradores, servidores Web, servidores de directorio, servidores de base de datos y servidores de aplicaciones, visite el centro de recursos de IBM Cognos
(http://www.ibm.com/software/data/support/cognos_crc.html).

El servidor IBM Cognos 8 no se inicia pero no aparece ningn mensaje de error


Es posible que un servidor IBM Cognos 8 no se inicie sin que aparezca ningn mensaje de error.
Esto se puede producir cuando un servidor IBM Cognos 8 se ha configurado para utilizar una gran
cantidad de memoria.
Si el servidor en el que se ha instalado IBM Cognos 8 contiene la versin 1.0 de la actualizacin de
seguridad de Microsoft 921883, se puede producir un problema cuando una aplicacin solicita una
gran cantidad de memoria contigua.
Se trata de un problema conocido en la versin 1.0 de la revisin de seguridad de Microsoft 921883.
Microsoft ha distribuido una segunda versin de la revisin para solucionar el problema. Para
solucionar el problema, desinstale la primera revisin de seguridad o instale la versin 2.0 de la
revisin. Tambin puede configurar el servidor IBM Cognos 8 para que utilice menos memoria.
Para obtener ms informacin, consulte el artculo de Microsoft Knowledge Base sobre errores de
programas debidos a la utilizacin de una gran cantidad de memoria contigua, que se encuentra en
la pgina http://support.microsoft.com.

El servidor IBM Cognos BI no est disponible al iniciar IBM Cognos 8


Tras configurar los componentes de IBM Cognos e iniciar los servicios de IBM Cognos 8, al
conectarse al portal de IBM Cognos 8, puede aparecer el siguiente mensaje de error:
IBM Cognos Gateway no puede conectar con el servidor IBM Cognos BI.
Puede que el servidor no est disponible o que la puerta de enlace no est configurada correctamente.
Para obtener ms informacin, consulte el archivo de registro del servidor de IBM Cognos. De
forma predeterminada, el archivo cogserver.log se encuentra en el directorio ubicacin_c8/logs. Si

Gua de instalacin y configuracin 349

Apndice B: Solucin de problemas


ha configurado otro destino para los mensajes de registro, consulte el archivo o la base de datos
correspondiente.
Es posible que Content Manager no pueda conectarse al almacn de contenido si ste no se ha
configurado correctamente. Esto puede suceder si:

El almacn de contenido utiliza una codificacin de caracteres no admitida.

El almacn de contenido utiliza una secuencia de intercalacin de base de datos que distingue
maysculas y minsculas.

Los valores de configuracin que ha especificado en IBM Cognos Configuration no son vlidos.

Codificacin de caracteres no admitida


Si en el archivo de registro aparecen los siguientes mensajes, significa que la base de datos que ha
creado para el almacn de contenido no utiliza una codificacin de caracteres admitida:

Para Oracle:
CM-CFG-5063 Se ha detectado un error de configuracin de Content Manager al conectar al
almacn de contenido.
CM-SYS-5121 Content Manager no se ha podido iniciar porque el juego de caracteres de la
base de datos del almacn de contenido no es vlido.
CM-SYS-5126 El servidor de la base de datos del almacn de contenido utiliza el juego de
caracteres US7ASCII.
CM-SYS-5125 El cliente de la base de datos del almacn de contenido utiliza el juego de
caracteres US7ASCII.

Para DB2 UDB:


CM-CFG-5063 Se ha detectado un error de configuracin de Content Manager al conectar al
almacn de contenido.
CM-SYS-5121 Content Manager no se ha podido iniciar porque el juego de caracteres de la
base de datos del almacn de contenido no es vlido.
CM-SYS-5124 El servidor de base de datos del almacn de contenido usa la pgina de cdigos
1252.

Para Sybase:
CM-CFG-5063 Se ha detectado un error de configuracin de Content Manager al conectar al
almacn de contenido.
CM-SYS-5121 Content Manager no se ha podido iniciar porque el juego de caracteres de la
base de datos del almacn de contenido no es vlido.

Para que Content Manager se conecte al almacn de contenido, ste debe utilizar la codificacin
de caracteres adecuada.

350 PowerPlay

Apndice B: Solucin de problemas

Base de datos

Codificacin de caracteres

Oracle 9i

AL32UTF8
AL32UTF16

DB2 UDB

Conjunto de cdigos UTF-8

Sybase ASE

UTF-8

Microsoft SQL Server

UTF8
UTF16

Para solucionar este problema, debe volver a crear la base de datos del almacn de contenido utilizando la codificacin de caracteres correcta, o convertir la codificacin de caracteres. Para obtener
ms informacin, consulte la documentacin del proveedor de la base de datos.

Secuencia de intercalacin con distincin de maysculas y minsculas


Si en el archivo de registro aparecen los siguientes mensajes, significa que la base de datos que ha
creado para el almacn de contenido utiliza una secuencia de intercalacin de base de datos que
distingue maysculas y minsculas:
CM-CFG-5063 Se ha detectado un error de configuracin de Content Manager al conectar al
almacn de contenido.
CM-SYS-5122 La base de datos del almacn de contenido tiene una intercalacin predeterminada
que distingue maysculas y minsculas. Content Manager necesita un almacn de contenido con
una intercalacin que distinga maysculas y minsculas.
CM-SYS-5123 El servidor de la base de datos del almacn de contenido utiliza la intercalacin
<parmetro>.
CM-SYS-5007 No se ha podido iniciar el build de Content Manager @cm_build_version@! Revise
los archivos de registro de Content Manager y pngase en contacto con el administrador del sistema
o con el servicio de asistencia al cliente.
Para solucionar este problema, debe volver a crear la base de datos del almacn de contenido utilizando una secuencia de intercalacin de base de datos que no distinga maysculas y minsculas.
Para obtener ms informacin, consulte la documentacin del proveedor de la base de datos.

Valores de configuracin no vlidos


Si en el archivo de registro aparecen los siguientes mensajes o similares, significa que no ha configurado correctamente el almacn de contenido en IBM Cognos Configuration.

Para Microsoft SQL Server:


CM-CFG-5063 Se ha detectado un error de configuracin de Content Manager al conectar al
almacn de contenido.
CM-CFG-5036 Content Manager no ha podido establecer conexin con el almacn de contenido.
La cadena de conexin es "jdbc:JSQLConnect://localhost:1433/cm".
Gua de instalacin y configuracin 351

Apndice B: Solucin de problemas


No se pudo iniciar sesin:com.jnetdirect.jsql.x: No se puede abrir la base de datos solicitada
al conectarse a 'cm'. Error de inicio de sesin. url:jdbc:JSQLConnect://localhost:1433/cm.

Para DB2:
CM-CFG-5063 Se ha detectado un error de configuracin de Content Manager al conectar al
almacn de contenido.
CM-SYS-5003 Content Manager no puede acceder al almacn de contenido. Compruebe los
parmetros de conexin de la base de datos y pngase en contacto con el administrador de la
base de datos.
[IBM][CLI Driver] SQL1013N No se ha podido encontrar el alias o el nombre de la base de
datos "CM123".

Para Oracle:
CM-CFG-5063 Se ha detectado un error de configuracin de Content Manager al conectar al
almacn de contenido.
CM-CFG-5036 Content Manager no ha podido establecer conexin con el almacn de contenido.
La cadena de conexin es "jdbc:oracle:thin:@localhost:1521:pb1".
ORA-01017: nombre de usuario o contrasea no vlidos; acceso denegado.

Para Sybase:
CM-CFG-5063 Se ha detectado un error de configuracin de Content Manager al conectar al
almacn de contenido.
CM-CFG-5036 Content Manager no ha podido establecer conexin con el almacn de contenido.
La cadena de conexin es "jdbc:sybase:Tds:localhost:5000/cm".
JZ006: Detectada IOException: java.net.ConnectException: Conexin rechazada: conectar.

Si est utilizando una base de datos Oracle, no emplee caracteres no permitidos, por ejemplo, el
carcter de subrayado en IBM Cognos Configuration, para la propiedad Nombre de servicio. Si el
nombre de servicio incluye caracteres no permitidos, no se crearn tablas en la base de datos del
almacn de contenido cuando se inicie el servicio IBM Cognos 8.

Pasos para Microsoft SQL Server


1. En la ventana Explorador, en Acceso a datos, Content Manager, haga clic en Almacn de
contenido.
2. Si ha creado la base de datos utilizando la autenticacin de Windows, debe eliminar el contenido
existente y crear uno nuevo siguiendo estos pasos:

Haga clic con el botn derecho en Almacn de contenido y a continuacin en Eliminar.

Haga clic con el botn derecho en Content Manager y, a continuacin, haga clic en Nuevo
recurso, Base de datos.

En el cuadro Nombre, escriba el nombre del recurso.

En el cuadro Tipo, seleccione Base de datos SQL Server (Autenticacin de Windows) y


haga clic en Aceptar.

352 PowerPlay

Apndice B: Solucin de problemas


3. En la ventana Propiedades, escriba los valores pertinentes para las propiedades Servidor de
base de datos con nmero de puerto o nombre de instancia y Nombre de base de datos.
Para una base de datos de Microsoft SQL Server, puede elegir utilizar un nmero de puerto,
tal como el 1433, o una instancia con nombre como valor para la propiedad Servidor de base
de datos con nmero de puerto o nombre de instancia.
Para conectarse a una instancia con nombre, debe especificar el nombre de instancia como una
propiedad URL de JDBC o una propiedad de origen de datos. Por ejemplo, puede escribir
localhost\instance1. Si no se especifica una propiedad nombre de instancia, se crea una conexin
a la instancia predeterminada.
Tenga en cuenta que las propiedades especificadas para la instancia con nombre, junto con el
identificador de usuario y contrasea, y el nombre de la base de datos, se utilizan para crear
una URL de JDBC. A continuacin se incluye un ejemplo:
jdbc:JSQLConnect://localhost\\instance1/user=sa/ms propiedades segn sea necesario
4. Si desea cambiar las credenciales de inicio de sesin, especifique un identificador de usuario y
una contrasea:

Haga clic en el cuadro Valor situado junto a la propiedad Identificador de usuario y contrasea y, a continuacin, haga clic en el botn Editar cuando aparezca.

Escriba los valores adecuados y haga clic en Aceptar.

5. En el men Archivo, haga clic en Guardar.


Las credenciales de inicio de sesin se codifican de inmediato.
6. Pruebe la conexin entre Content Manager y el almacn de contenido.
Sugerencia: En la ventana Explorador, haga clic con el botn derecho en la nueva base de datos
y, a continuacin, haga clic en Probar.
Content Manager se conecta a la base de datos, comprueba los permisos de la base de datos,
crea la tabla y, a continuacin, la rellena. La tabla no se elimina y se utiliza cada vez que se
repite la prueba.

Pasos para Oracle, DB2 y Sybase


1. En la ventana Explorador, en Acceso a datos, Content Manager, haga clic con el botn derecho
en Almacn de contenido y, a continuacin, haga clic en Eliminar.
As, se elimina el recurso predeterminado. Content Manager debe configurarse para acceder
slo a un almacn de contenido.
2. Haga clic con el botn derecho en Content Manager y, a continuacin, haga clic en Nuevo
recurso, Base de datos.
3. En el cuadro Nombre, escriba el nombre del recurso.
4. En el cuadro Tipo, seleccione el tipo de base de datos y haga clic en Aceptar.

Gua de instalacin y configuracin 353

Apndice B: Solucin de problemas


Si ha instalado ms de una versin de IBM Cognos 8, deber usar un almacn de contenido
diferente para cada una. Cuando una nueva versin de IBM Cognos 8 utiliza un almacn de
contenido, ste no puede ser utilizado por una versin ms antigua.
Sugerencia: Si desea usar un par contrasea-valor Net8 de Oracle para administrar la conexin
a la base de datos, seleccione Base de datos Oracle (Avanzada).
5. En la ventana Propiedades, proporcione los valores en funcin de su tipo de base de datos:

Si utiliza una base de datos DB2, escriba el alias de la base de datos en la propiedad
Nombre de base de datos.

Si utiliza una base de datos Oracle, escriba los valores pertinentes para las propiedades
Servidor de base de datos y nmero de puerto y Nombre de servicio.

Si usa una base de datos Oracle avanzada, introduzca el par contrasea-valor Net8 de
Oracle de la conexin para la propiedad Especificador de base de datos.
A continuacin se incluye un ejemplo:
(description=(address=(host=myhost)(protocol=tcp)(port=1521)(connect_data=(sid=(orcl)))))

Si utiliza una base de datos Sybase, escriba los valores pertinentes para las propiedades
Servidor de base de datos y nmero de puerto y Nombre de base de datos.

6. Si desea cambiar las credenciales de inicio de sesin, especifique un identificador de usuario y


una contrasea:

Haga clic en el cuadro Valor situado junto a la propiedad Identificador de usuario y contrasea y, a continuacin, haga clic en el botn Editar cuando aparezca.

Escriba los valores adecuados y haga clic en Aceptar.

7. En el men Archivo, haga clic en Guardar.


Las credenciales de inicio de sesin se codifican de inmediato.
8. Pruebe la conexin entre Content Manager y el almacn de contenido.
Sugerencia: En la ventana Explorador, haga clic con el botn derecho en la nueva base de datos
y, a continuacin, haga clic en Probar.
Content Manager se conecta a la base de datos, comprueba los permisos de la base de datos,
crea la tabla y, a continuacin, la rellena. La tabla no se elimina y se utiliza cada vez que se
repite la prueba.

No se puede iniciar sesin en un espacio de nombre con IBM Cognos Connection


(error PRS-CSE-1255)
Se abre IBM Cognos 8 a travs de IBM Cognos Connection. Sin embargo, cuando intenta crear un
recurso de datos e iniciar una sesin en un espacio de nombre, aparece el siguiente mensaje de error:

354 PowerPlay

PRS-CSE-1255 Se ha encontrado un error de excepcin en la descodificacin de datos.

Apndice B: Solucin de problemas

CAM-CRP-1064 No se pueden procesar los datos PKCS #7 debido a un error interno. Motivo:
java.lang.IndexOutOfBoundsException.

Este problema puede darse si no posee los permisos necesarios sobre los siguientes directorios:

c8\configuration

c8\configuration\csk

c8\configuration\encryptkeypair

c8\configuration\signkeypair

La solucin es habilitar en los directorios mencionados los permisos de lectura y ejecucin para
todo el que deba iniciar el servicio IBM Cognos 8.

Fallo al reiniciar los servicios IBM Cognos 8 despus de una interrupcin de la


red
El servicio IBM Cognos Bootstrap reinicia los servicios de IBM Cognos 8 despus de una interrupcin
de la red para las instalaciones de Tomcat que tengan una direccin IP de red especificada en el
URI del distribuidor interno. Durante el reinicio puede ocurrir que los servicios IBM Cognos 8 no
se inicien correctamente, en cuyo caso sera necesario reiniciarlos manualmente cuando se haya
recuperado la red.
Para resolver el problema, configure la propiedad URI del distribuidor interno en IBM Cognos
Configuration para utilizar localhost o el nombre de host de la red.

Error al descargar recursos


Al iniciar Report Studio en Internet Explorer, aparece el siguiente mensaje de error:
Error al descargar el recurso especificado.
El origen del problema puede estar en actualizaciones recientes de Microsoft XMLHTTP si no se
ha establecido ninguna preferencia de idioma en Internet Explorer.
Para resolver el problema, especifique una preferencia de idioma en Internet Explorer.

DB2 devuelve el error SQL1224N al conectarse desde AIX


Si el almacn de contenido es una base de datos DB2 y recibe un error SQL1224N en AIX, revise
el archivo db2diag.log para obtener ms informacin sobre el error.
Si el error tiene un cdigo de motivo 18, puede ser necesario que cambie la configuracin de DB2
para que acepte ms conexiones. Para obtener ms informacin, consulte las pginas de asistencia
de IBM BD2 sobre el error SQL1224N.

Error de Content Manager al iniciar IBM Cognos 8


Al iniciar IBM Cognos 8 no se inicia ningn proceso PPESBusServer. Hay una lista de errores en
los archivos pogo******.log y cogserver.log. Los usuarios experimentan errores en el explorador
al conectarse al portal de IBM Cognos 8.

Gua de instalacin y configuracin 355

Apndice B: Solucin de problemas


En el archivo pogo******.log aparece un error relacionado con Content Manager.
En el archivo cogserver.log aparece el siguiente error:
El intento de registrar el distribuidor en Content Manager ha fallado. Se intentar peridicamente.
Al conectarse a http://nombre de equipo/cognos8 aparece el siguiente mensaje de error en el
explorador:

DPR-ERR-2058 El distribuidor no puede procesar la solicitud en este momento. El distribuidor


todava se est inicializando.

SoapSocketException: Conexin rechazada

IBM Cognos Configuration utiliza un identificador de usuario para conectarse a la base de datos
LDAP. Si se traslada este identificador de usuario a otro grupo, IBM Cognos Configuration no
podr localizarlo.
Para resolver el problema, vuelva a colocar el identificador de usuario en su grupo original.

No se puede encontrar la pgina al iniciar IBM Cognos 8 en Windows 2003


Despus de instalar IBM Cognos 8 en Windows 2003, puede aparecer el siguiente mensaje cuando
intente iniciar IBM Cognos 8:
No se puede encontrar la pgina. Puede ser que la pgina que busca haya sido eliminada, que su
nombre haya cambiado o que no est disponible temporalmente. Error HTTP 404: Archivo o
directorio no encontrado.
Este error est causado por una caracterstica de seguridad de los servicios Internet Information
Services (IIS) de Windows 2003. Esta caracterstica de seguridad no permite extensiones cgi de
archivo desconocidas.
Para resolver este problema, aada una extensin de archivo nueva en ISS para el archivo cognos.cgi.
Para obtener ms informacin, consulte la documentacin de IIS.

No se muestra la pgina al abrir un portal despus de haber instalado IBM Cognos


8
Despus de instalar y configurar IBM Cognos 8, no es posible conectarse al portal de IBM Cognos 8.
La causa del problema puede ser que el servidor Web no est configurado correctamente. Por
ejemplo, puede ser que los directorios virtuales necesarios para IBM Cognos 8 no existan o que no
conduzcan a las carpetas fsicas correctas.
Para obtener informacin sobre la configuracin del servidor Web, consulte la Gua de instalacin
y configuracin.

Aparece el error DPR-ERR-2058 en el explorador Web al iniciar IBM Cognos 8


Despus de iniciar los servicios de IBM Cognos Configuration e intentar abrir el portal, puede
aparecer un mensaje parecido a alguno de los siguientes:
DPR-ERR-2058 El distribuidor ha encontrado un error al procesar una solicitud. Se debe inicializar
el controlador XTS antes de invocarlo.

356 PowerPlay

Apndice B: Solucin de problemas


DPR-ERR-2058 El distribuidor no puede procesar la solicitud en este momento. El distribuidor
todava se est inicializando. Intntelo de nuevo o pngase en contacto con su administrador.
Estos mensajes de error normalmente se muestran cuando el distribuidor no puede comunicarse
con Content Manager. Para determinar la causa especfica, consulte el archivo cogserver.log del
directorio ubicacin_c8/logs. A continuacin se presentan las causas ms frecuentes y las soluciones
correspondientes.

Los servicios de IBM Cognos no han terminado de inicializar


Despus de iniciar los servicios de IBM Cognos Configuration y de que la herramienta de configuracin muestre que los servicios estn ejecutndose, espere unos minutos para que se inicien todos
los servicios antes de abrir el portal.

Content Manager no disponible


En una instalacin distribuida, asegrese de que Content Manager est instalado, configurado y
en ejecucin. Compruebe tambin que los dems equipos de IBM Cognos estn configurados con
el URI de Content Manager correcto.

El almacn de contenido no est disponible o no est configurado correctamente


Asegrese de que la base de datos del almacn de contenido haya sido creada y est correctamente
configurada en IBM Cognos Configuration.

No se crean tablas en el almacn de contenido


Compruebe que est utilizando una versin de DB2, Microsoft SQL Server, Oracle o Sybase admitida
por los componentes de IBM Cognos.

Las credenciales de inicio de sesin del almacn de contenido no son correctas


Compruebe si la informacin ha cambiado. Por ejemplo, DB2 lee la informacin de la administracin
de usuario de NT. Si la contrasea de la cuenta NT ha cambiado, deber cambiar tambin las credenciales de inicio de sesin del almacn de contenido en IBM Cognos Configuration.
Compruebe si hay caracteres especiales en la contrasea de inicio de sesin. En ocasiones, el controlador JDBC no acepta caracteres reservados para xml, como %, !, < y >.

El usuario no tiene los permisos adecuados


Compruebe si el usuario tiene los permisos adecuados.

Memoria insuficiente en HP-UX


Si est utilizando Tomcat, el problema est relacionado con la configuracin del servidor HP-UX.
Puede haber sobrepasado el nmero mximo esperado de subprocesos activos simultneamente
por proceso.

Pasos para controlar si hay problemas de configuracin de HP-UX


1. En el archivo /bin/startup.sh, busque
../tomcat4.1.27/bin/catalina.sh start "$@"

Gua de instalacin y configuracin 357

Apndice B: Solucin de problemas


2. Cmbielo por:
../tomcat4.1.27/bin/catalina.sh run "$@"
El comando de ejecucin provoca que la salida de Tomcat aparezca en la ventana de la consola
de IBM Cognos 8.
3. Detenga y reinicie IBM Cognos 8 mediante los comandos ./shutdown.sh y ./startup.sh.
Si en alguno de los servidores de la aplicacin aparece el siguiente mensaje de error en la ventana
de la consola, el problema est relacionado con la configuracin de HP-UX:
OutofMemoryException error: No se puede crear un nuevo subproceso nativo en HP-UX.
El problema es que los valores predeterminados de HP-UX 11.0 y 11i son demasiado bajos
para la mayora de las aplicaciones de Java.
Sugerencia: Puede comprobar el nmero de subprocesos que tiene su proceso con la opcin eprof disponible en JDK 1.1.8 y sin analiza el archivo Java.eprof con HPjmeter, mediante la
seleccin del indicador de subprocesos.

Pasos para aumentar el nmero mximo de subprocesos por proceso


1. Pida a su administrador de sistema que cambie el parmetro Kernel de la siguiente manera:

max_thread_proc = 512

nkthread = 1024

2. Asegrese de que los valores de ulimit son ilimitados.

Content Manager no puede conectar con el almacn de contenido de Oracle


Si est utilizando una base de datos Oracle como almacn de contenido, se puede producir el error
DPR-ERR-2058 al iniciar sesin en el portal http://nombre_host/cognos8. Se crean todas las tablas
en la base de datos.
Tambin pueden mostrarse los siguientes mensajes de error:

CM-CFG-5036 Content Manager no ha podido establecer conexin con el almacn de contenido.

ORA-01017: nombre de usuario o contrasea no vlidos; acceso denegado

Pasos para configurar el nombre de servidor de la base de datos Oracle


1. En la ventana Explorador, haga clic en Acceso a datos, Content Manager, Almacn de contenido.
2. Cambie el nombre del servidor de la base de datos Oracle por un nombre completo, como
nombre_host.nombreempresa:1534, para que coincida con el nombre existente en el archivo
tnsnames.ora.

La migracin no funciona
Una vez instalado y configurado IBM Cognos 8 PowerPlay, no encuentra el ayudante para la
migracin o bien no sucede nada al ejecutar una migracin.
Para resolver el problema, compruebe lo siguiente:
358 PowerPlay

Apndice B: Solucin de problemas

Los componentes Servidor PowerPlay BI y Administracin de PowerPlay estn instalados en el


servidor IBM Cognos 8 PowerPlay (p. 128).

Si instala IBM Cognos 8 PowerPlay con IBM Cognos 8, instale el componente IBM Cognos 8
PowerPlay Content Manager en el mismo equipo que el componente IBM Cognos 8 Content
Manager.

En el equipo en el que se haya instalado Content Manager, desde IBM Cognos Configuration,
en Entorno, Servicio IBM Cognos 8, asegrese de que la propiedad Servicio de migracin
habilitado est establecida en Verdadero.

Los componentes de migracin de IBM Cognos Series 7 estn instalados en su equipo de servidor
IBM Cognos Series 7 PowerPlay.

El servicio de migracin de IBM Cognos Series 7 se inicia en el equipo de servidor IBM Cognos
Series 7 PowerPlay.

Los usuarios pueden ejecutar una tarea de migracin. Para obtener ms informacin, consulte
la Gua de migracin y administracin de IBM Cognos 8 PowerPlay.
Asimismo, asegrese de que los usuarios que van a ejecutar las tareas de migracin disponen
de los permisos necesarios para crearlas. En IBM Cognos Administration:

Haga clic en Configuracin, Administracin de contenido.

Haga clic en el botn Establecer propiedades - Administracin

Haga clic en la pestaa Permisos.

Asegrese de que los usuarios que van a ejecutar tareas de migracin tienen los permisos

Lectura, Escritura, Ejecutar y Recorrer.

Error EBA-090034 al iniciar WebLogic 8


Despus de configurar WebLogic 8 para que utilice SSL, ha utilizado el comando startManagedWebLogic.cmd para iniciar el servidor de aplicaciones. El servidor de aplicaciones no se ha iniciado y
ha aparecido el siguiente mensaje de error:
EBA-0990034 No se escucha SSL
El problema se produce porque WebLogic 8 tiene una funcin que es incompatible con el archivo
IBM Cognos 8 bcprov-jdk14.134.jar.
Para resolverlo deber aadir una nueva versin del archivo de BouncyCastle bcprov .jar al directorio de extensiones de Java de WebLogic.

Pasos
1. Desde el sitio Web de BouncyCastle, http://www.bouncycastle.org/download/, descargue un
archivo bcprov .jar de BouncyCastle compatible, por ejemplo bcprov-jdk14-137.jar.
2. Copie el archivo .jar descargado en el directorio de extensiones de Java de WebLogic, ubicacin_WebLogic\jdk142_nn\jre\lib\ext.

Gua de instalacin y configuracin 359

Apndice B: Solucin de problemas


3. En el directorio ubicacin_WebLogic\jdk142_nn\jre\lib\security, edite el arhivo java.security y
aada la siguiente lnea en la lista de proveedores:
security.provider.6=org.bouncycastle.jce.provider.BouncyCastleProvider

Aparece el error DPR-ERR-2022 en el explorador Web al iniciar IBM Cognos 8


Despus de iniciar los servicios de IBM Cognos Configuration e intentar abrir el portal, puede
aparecer un mensaje parecido al siguiente:
DPR-ERR-2022 No se ha generado ninguna respuesta. Esto puede deberse a que la configuracin
es incorrecta, la instalacin es defectuosa o el distribuidor no ha terminado de inicializarse.

Se est abriendo el portal antes de tiempo


Este problema puede surgir si intenta abrir el portal antes de que los servicios IBM Cognos se hayan
inicializado.
Para evitarlo, despus de iniciar los servicios de IBM Cognos Configuration y de que la herramienta
de configuracin muestre que los servicios estn ejecutndose, espere unos minutos para que se
inicien todos los servicios antes de abrir el portal.

El archivo system.xml contiene errores


Es posible que el archivo system.xml se haya editado.
Sustituya el archivo system.xml del directorio ubicacin_c8\templates\ps\portal por una copia que
provenga de una copia de seguridad o utilice un editor de XML para editarlo.

No se puede descargar el archivo cognos.xts


Despus de instalar IBM Cognos 8, se le pedir que descargue el archivo cognos.xts al conectarse
al portal de IBM Cognos 8. Puede aparecer el siguiente mensaje de error:
Ha elegido descargar un archivo de esta ubicacin. cognos.xts de nombreservidor
Este problema surge cuando los permisos sobre los directorios virtuales no estn correctamente
configurados. Deber otorgar permisos de ejecucin al directorio virtual cgi-bin del servicio
Microsoft Internet Information Service (IIS).
Para resolver este problema, vuelva a crear los directorios virtuales de IIS con los permisos que se
indican a continuacin.

360 PowerPlay

Alias

Ruta

Permisos

cognos8

ubicacin_c8\Program Files\Cognos\c8\webcontent

Lectura

cognos8\ cgi-bin

ubicacin_c8\Program Files\Cognos\c8\cgi-bin

Lectura Ejecutar

cognos8\help

ubicacin_c8\Program Files\Cognos\c8\webcontent\
documentation

Lectura

Apndice B: Solucin de problemas

Error de script de inicio del servidor de aplicaciones


Puede haber problemas al ejecutar los scripts de inicio de un servidor de aplicaciones para que
implemente la aplicacin IBM Cognos si los componentes de IBM Cognos 8 estn instalados en un
directorio cuyo nombre contiene espacios.
Para resolver este problema, cambie el nombre del directorio y no incluya espacios en el nuevo
nombre. Si los scripts de inicio no gestionan con facilidad esta solucin, intente poner el nombre
del directorio que contenga espacios entre comillas o utilice la convencin de nomenclatura 8.3 de
DOS.

Error al implementar IBM Cognos 8 en un servidor de aplicaciones Oracle o IBM


WebSphere
Al implementar IBM Cognos 8 en un servidor de aplicaciones Oracle o IBM WebSphere, puede
producirse alguno de los siguientes errores:

Tiempo de espera del explorador excedido en la consola de administracin

Mensaje de error: Error interno HTTP 500

Mensaje de error: Error de implementacin: Excepcin de base: java.rmi.RemoteException


(Oracle)

Vuelva a la pgina de seleccin de archivos de la aplicacin (IBM WebSphere)

Estos errores pueden producirse porque el archivo de aplicacin que intenta implementar es demasiado grande.
Para resolver este problema haga lo siguiente:

Si est utilizando el Asistente de aplicacin de creacin, anule la seleccin de la casilla de verificacin Incluir archivos estticos de la carpeta Webcontent al seleccionar la aplicacin que
desea crear.
De este modo se reducir el tamao del archivo de la aplicacin. Si es necesario contenido
esttico, puede copiarlo manualmente en la ubicacin de la aplicacin implementada despus
de haber implementado correctamente IBM Cognos 8 en el servidor de aplicaciones.

Si va a implementar el archivo de la aplicacin manualmente en un servidor de aplicaciones


Oracle, introduzca el siguiente comando:
dcmctl deployapplication -f ruta_y_nombre_de_archivo_ear -a nombre_aplicacin -co nombre_
instancia_OC4J
La versin 3 de Oracle no admite este comando.

Para obtener ms informacin sobre la implementacin de IBM Cognos 8 en un servidor de aplicaciones, consulte la Gua de instalacin y configuracin.

El tipo de informe de varias pginas de Microsoft Excel 2000 no funciona


Para asegurarse de que las URL de los informes no puedan cambiarse al pasar de un explorador
del cliente al servidor de informes, IBM Cognos 8 aplica firmas a las URL que genera. No obstante,

Gua de instalacin y configuracin 361

Apndice B: Solucin de problemas


la opcin de varias pginas de Excel 2000 (XLS) no admite direcciones URL firmadas. Para utilizar
el tipo de informe pgina de varias pginas de Excel 2000, deber deshabilitar la firma digital de
URL mediante los siguientes pasos:

Pasos para deshabilitar direcciones URL firmadas


1. Detenga el distribuidor.
2. En el directorio ubicacin_c8/configuration, cambie el nombre del archivo cafconfig.xml.sample
por cafconfig.xml.
3. Abra el archivo cafconfig.xml y busque la siguiente seccin:
<!--Should we reject unsigned requests for /gd/ urls. (e.g. multipage excel
reports)
Default: true-->
<crn:parameter name="caf_signedReportUrls">
<crn:value xsi:type="xsd:boolean">true</crn:value>
</crn:parameter>

4. Cambie ="xsd:boolean">true</crn:value> por ="xsd:boolean">false</crn:value>.


5. Reinicie el distribuidor.
6. Repita los pasos anteriores para cada distribuidor del entorno, o copie el archivo cafconfig.xml
en cada directorio ubicacin_c8/configuration y reinicie los distribuidores.

No se puede anular la serializacin del atributo de contexto al implementar el


archivo p2pd.war en WebLogic
Al implementar el archivo p2pd.war en WebLogic, puede aparecer el siguiente mensaje de error:
Error [contexto]No se ha podido anular la serializacin del atributo de contexto
java.io.NotSerializableException: com.cognos.logserver.LogService
Este error no afecta a la implementacin del archivo p2pd.war.
Para evitar el problema, aada al menos una preferencia de idioma en Internet Explorer.

Los caracteres acentuados o de doble byte pueden mostrarse incorrectamente al


instalar IBM Cognos 8 en Linux
Si est utilizando issetup en una configuracin regional UTF-8, puede ocurrir que los caracteres
acentuados o de doble byte no se muestren correctamente.
Para resolver este problema cuando haga la instalacin en alemn o francs, utilice una configuracin
regional que no sea UTF-8 e inicie a continuacin issetup para instalar IBM Cognos 8.
Para resolver este problema cuando haga la instalacin en japons, cambie la configuracin de la
codificacin de X Terminal a Shift-JIS y, a continuacin, instale IBM Cognos 8 sin participacin
del usuario (p. 317).

362 PowerPlay

Apndice B: Solucin de problemas

Problemas al configurar IBM Cognos 8


Despus de instalar los componentes de IBM Cognos 8, puede tener problemas para guardar los
cambios de IBM Cognos Configuration.
Asegrese de

Configurar e iniciar los servicios en el equipo en que est Content Manager antes de configurar
otros componentes

Reiniciar el servicio IBM Cognos 8 despus de realizar cambios en la configuracin

Ejecucin de scripts de limpieza de base de datos


Durante la resolucin de un problema, se le puede pedir que inicie con nuevos datos de configuracin.
Puede ejecutar un script SQL para eliminar todas las tablas de cualquiera de las siguientes bases de
datos utilizadas por los componentes de IBM Cognos 8:

Almacn de contenido para datos que IBM Cognos 8 necesita para funcionar correctamente

Base de datos de entrega para notificaciones de informes

Base de datos de registro para mensajes de registro

Almacn de indicadores para contenido de paquetes de indicadores y preferencias de usuario


de Metric Studio

Al eliminar una tabla, su definicin estructural y sus datos se borran permanentemente de la base
de datos. En el almacn de indicadores, los objetos de la base de datos tambin pueden borrarse.
Al reiniciar el servicio IBM Cognos 8, se crea automticamente un nuevo conjunto de tablas de
bases de datos en la ubicacin especificada por los valores de configuracin.

Pasos
1. Detenga el servicio IBM Cognos 8 en todos los equipos que tengan instalado Content Manager.
2. Vaya al directorio que corresponda:

Para eliminar tablas de la base de datos de registro, vaya a ubicacin_c8\configuration\


schemas\logging.

Para eliminar tablas del almacn de contenido, vaya a ubicacin_c8\configuration\schemas\


content.

Para eliminar tablas de la base de datos de notificaciones, vaya a ubicacin_c8\configuration\


schemas\delivery.

Para eliminar tablas del almacn de indicadores, vaya a ubicacin_c8\configuration\schemas\


cmm.

3. Vaya al directorio de base de datos que corresponda.


4. En funcin de la base de datos y el tipo de base de datos, ejecute uno de los siguientes scripts
con la herramienta de base de datos correspondiente para eliminar las tablas.
Gua de instalacin y configuracin 363

Apndice B: Solucin de problemas

Base de datos Tipo de base Nombre de script


de datos
Almacn de
contenido

Notificacin

Registro

Almacn de
indicadores

DB2

dbClean_db2.sql

Derby

dbClean_derby.sql

Microsoft
SQL Server

dbClean_mssqlserver.sql

Oracle

dbClean_oracle.sql

Sybase

dbClean_sybase.sql

DB2

NC_DROP_DB2.sql

Derby

NC_DROP_Derby.sql

Microsoft
SQL Server

NC_DROP_MS.sql

Oracle

NC_DROP_ORA.sql

Sybase

NC_DROP_SYBASE.sql

DB2

LS_dbClean_db2.sql

Derby

LS_dbClean_derby.sql

Microsoft
SQL Server

LS_dbClean_mssql.sql

Oracle

LS_dbClean_oracle.sql

Sybase

LS_dbClean_sybase.sql

DB2

cmm_purge_deleted_data dbalias nombre de usuario contrasea


Especifique el alias de la base de datos solamente si ya hay
catalogada una base de datos con el mismo nombre.

Microsoft
SQL

364 PowerPlay

cmm_purge_deleted_data nombre_almacn_indicadores
nombre_base de datos nombre_usuario_admin contrasea

Apndice B: Solucin de problemas

Base de datos Tipo de base Nombre de script


de datos
Oracle

cmm_purge_deleted_data nombre_base de datos nombre_


ususario_base de datos contrasea
Sustituya nombre_base_de_datos por el nombre del archivo
tnsnames.ora que hace referencia al SID de base de datos de
Metric Studio

5. Inicie el servicio IBM Cognos 8.

Error al intentar codificar informacin al guardar la configuracin


Al guardar la configuracin con la herramienta de configuracin, puede aparecer un mensaje de
error avisando de que la informacin criptogrfica no puede codificarse. Ha habido un error al
solicitar un certificado a la entidad emisora de certificados.
La informacin criptogrfica no se puede codificar. Desea guardar la configuracin como texto
sin formato?
Para poder codificar los valores de configuracin, el equipo en que est instalado Content Manager
debe estar configurado y en ejecucin. En UNIX, asegrese de haber copiado los archivos .jar
necesarios en la ubicacin de instalacin del entorno en tiempo de ejecucin de Java. Asegrese
adems de que el entorno de Java est configurado correctamente, los URI son correctos y de que
se haya establecido la misma contrasea de entidad emisora de certificados en todos los equipos de
Content Manager.
En Linux, asegrese de haber copiado los archivos .jar necesarios en la ubicacin de instalacin del
entorno en tiempo de ejecucin de Java.
Adems, puede aparecer un mensaje de error como el siguiente:
java.lang.NoClassDefFoundError: javax/net/ServerSocketFactory.
El error criptogrfico normalmente indica que el entorno de Java no est bien configurado. Asegrese
de que la variable del entorno JAVA_HOME est configurada correctamente y de que se hayan
instalado los proveedores de seguridad adecuados, por ejemplo, JSSE para JRE 1.31.

Pasos para comprobar la configuracin


1. Inicie IBM Cognos Configuration en el equipo con Content Manager.
2. En la ventana Explorador, haga clic en Entorno.
3. En la ventana de Propiedades, verifique estas propiedades:

En Configuracin de puerta de enlace, URI de puerta de enlace

En Configuracin de distribuidor, URI de distribuidor externo y URI de distribuidor interno

En Otra configuracin de URI, URI de distribuidor para aplicaciones externas y URI de


Content Manager

Gua de instalacin y configuracin 365

Apndice B: Solucin de problemas


4. En la ventana Explorador, haga clic en Seguridad, Criptografa, Cognos.
5. En la ventana Propiedades, en Configuracin de la entidad emisora de certificados, haga clic
en el valor de la Contrasea.
Asegrese de que se usa la misma contrasea en todos los equipos de Content Manager.
6. Guarde la configuracin y reinicie IBM Cognos 8.

Problemas al generar claves criptogrficas en IBM Cognos Configuration


Al desinstalar IBM Cognos 8, algunas carpetas temporales se quedan en el equipo. Si se reinstala
el producto en la misma ubicacin sin antes eliminar las carpetas temporales, puede haber problemas
al generar claves criptogrficas en IBM Cognos Configuration.
Para resolver este problema, desinstale IBM Cognos 8, elimine la carpeta ubicacin_c8/temp/cam
y vuelva a instalar IBM Cognos 8.

Error CAM-CRP-1315 al guardar la configuracin


Cuando guarde la configuracin, puede mostrarse el siguiente mensaje de error:
CAM-CRP-1315 La configuracin actual apunta a un dominio de confianza distinto al configurado
originalmente.
Este error surge cuando se han realizado cambios en el dominio de confianza del entorno. El
dominio de confianza est controlado por la entidad emisora de certificados asociada al almacn
de contenido. Este error puede surgir si se ha eliminado el almacn de contenido utilizado originalmente o si, despus de haber guardado la configuracin original, se ha modificado la configuracin
para utilizar un Content Manager asociado a un almacn de contenido diferente.
Para resolver este problema, cambie la configuracin para utilizar el almacn de contenido original
o regenere las claves criptogrficas.

Pasos para regenerar claves criptogrficas


1. En el equipo de Content Manager, haga una copia de seguridad de las claves criptogrficas
existentes, y guarde los siguientes directorios en otra ubicacin que sea segura:

ubicacin_c8/configuration/csk

ubicacin_c8/configuration/encryptkeypair

ubicacin_c8/configuration/signkeypair

2. Elimine los directorios csk, encryptkeypair y signkeypair.


3. En IBM Cognos Configuration, guarde la configuracin y reinicie los servicios.
4. Repita los pasos del 1 al 3 en todos los equipos que tengan instalados componentes de IBM
Cognos 8.

366 PowerPlay

Apndice B: Solucin de problemas

Los datos de configuracin estn bloqueados por otra instancia de IBM Cognos
Configuration
Puede aparecer un mensaje de error que indique que los datos de configuracin estn bloqueados
por otra instancia de IBM Cognos Configuration.
Cuando se inicia IBM Cognos Configuration, se comprueba que el archivo cogstartup.lock existe
en ubicacin_c8/configuration. El archivo puede existir si no se cerr correctamente una instancia
anterior o si hay otra instancia de IBM Cognos Configuration en ejecucin.
Si otra instancia de IBM Cognos Configuration est siendo ejecutada, debera abandonar dicha
instancia. De lo contrario, los cambios que realice en la configuracin local podran provocar
errores.
Si no se est ejecutando otra instancia de IBM Cognos Configuration, elimine el archivo cogstartup.lock de ubicacin_c8/configuration.
Si se ha detenido el servicio IBM Cognos 8, haga clic en Inicio.

No se puede salir de una secuencia de tabulacin desplazndose slo con el teclado


en IBM Cognos Configuration
Si utiliza la tecla de tabulacin para desplazarse en IBM Cognos Configuration, puede tener problemas para salir de una secuencia de tabulacin. Por ejemplo, en la ventana de propiedades puede
pulsar la tecla de tabulacin para moverse de una propiedad a otra.
No obstante, puesto que IBM Cognos Configuration es una aplicacin de Java, cuando desee cerrar
la ventana de propiedades, deber presionar Ctrl+tabulador.

No se puede guardar la configuracin


Puede ocurrir que la configuracin no se pueda guardar porque falte algn recurso. Por ejemplo,
si elimina algn recurso como el espacio de nombre de IBM Cognos, un proveedor criptogrfico o
el almacn de contenido. Puede sustituir el tipo de base de datos predeterminado por el almacn de
contenido con Oracle, DB2 o Sybase. No puede sustituir el espacio de nombre de IBM Cognos.
Puede volver a crearlo, pero entonces deber volver a crear tambin los grupos y roles de IBM
Cognos.
Para obtener ms informacin sobre la creacin de grupos y roles en IBM Cognos Connection,
consulte la Gua de administracin y seguridad.

Pasos para volver a crear el espacio de nombre de IBM Cognos


1. Inicie IBM Cognos Configuration.
2. En la ventana Explorador, en Seguridad, haga clic con el botn derecho en Autenticacin y, a
continuacin, haga clic en Nuevo recurso, Espacio de nombre.
3. En el cuadro Nombre, escriba el nombre del recurso.
4. En el cuadro Tipo, haga clic en IBM Cognos y, a continuacin, en Aceptar.
El espacio de nombre de IBM Cognos aparecer en la ventana Explorador.

Gua de instalacin y configuracin 367

Apndice B: Solucin de problemas


5. En el men Archivo, haga clic en Guardar.

Error de Java al iniciar IBM Cognos Configuration


Al iniciar IBM Cognos Configuration, puede aparecer un mensaje de error que indica que el entorno
en tiempo de ejecucin de Java (JRE) ha cambiado y que la informacin criptogrfica actual no es
compatible con el nuevo JRE. Puede ser que se le pida que regenere la informacin criptogrfica
para el nuevo JRE o que salga y vuelva al JRE anterior.
Este error puede surgir por alguna de estas razones:

Los datos de configuracin se codificaron utilizando un JRE diferente al que estn utilizando
los componentes de IBM Cognos 8.

La informacin criptogrfica puede estar daada.

Si hace clic en Regenerar en el dilogo de error, el servicio de IBM Cognos 8 se detiene y la informacin criptogrfica se regenera.
Si hace clic en Salir en el cuadro de dilogo de error, debe establecer la variable de entorno
JAVA_HOME para que seale al JRE usado para guardar la configuracin.
En Windows, si desea que los componentes de IBM Cognos 8 utilicen el JRE instalado de forma
predeterminada, desactive JAVA_HOME o establezca JAVA_HOME en ubicacin_c8/bin/jre.
Nota: Si desea cambiar de un JRE a otro, consulte el tema sobre cmo cambiar la versin de JVM
utilizada por los componentes de IBM Cognos 8. Para obtener ms informacin, consulte Gua de
instalacin y configuracin.

Error criptogrfico al iniciar IBM Cognos Configuration


Al iniciar IBM Cognos Configuration, puede aparecer el siguiente mensaje de error:
La informacin criptogrfica puede haberse daado o el archivo cogstartup.xml no es vlido. Es
posible que deba reparar el archivo o eliminarlo del disco. Para obtener ms informacin, consulte
la Gua de instalacin y configuracin.
Este error surge cuando los componentes de IBM Cognos 8 detectan un error en el archivo cogstartup.xml. Esto puede ocurrir si el archivo cogstartup.xml se edita manualmente y hay un error en
el texto cambiado.
Para resolver el problema, sustituya el archivo cogstartup.xml por una copia de su ubicacin de
copia de seguridad.

No se han aplicado los valores de configuracin actuales en el equipo


Ha cambiado los valores predeterminados de las propiedades o ha aadido algn recurso a la instalacin en IBM Cognos Configuration. Despus de guardar la configuracin actual, es posible que
no vea los cambios o no sea capaz de utilizar el recurso en el entorno de tiempo de ejecucin.
Para aplicar la nueva configuracin en el equipo, deber reiniciar el servicio IBM Cognos 8.

Pasos para reiniciar el servicio IBM Cognos 8


1. Inicie IBM Cognos Configuration.
368 PowerPlay

Apndice B: Solucin de problemas


2. En el men de Acciones, haga clic en el comando adecuado:

Si el servicio IBM Cognos 8 est en ejecucin, haga clic en Reiniciar.


Esta accin inicia todos los servicios instalados que no se estn ejecutando y reinicia
aqullos que si estn en ejecucin. Si desea reiniciar un servicio en particular, seleccione el
nodo de servicio en la ventana Explorador y, a continuacin, haga clic en Reiniciar en el
men Acciones.

Si se ha detenido el servicio IBM Cognos 8, haga clic en Inicio.


Esta accin inicia todos los servicios instalados que no se estn ejecutando. Si desea iniciar
un servicio en particular, seleccione el nodo de servicio en la ventana Explorador y, a continuacin, haga clic en Iniciar en el men Acciones.

Error CM-CFG-029 al intentar guardar una configuracin que especifica un servidor de origen de datos SQL
Al intentar guardar una configuracin en IBM Cognos Configuration, aparece el siguiente mensaje
de error en el archivo cogserver.log:
CM-CFG-029 Content Manager no puede determinar si el almacn de contenido se ha inicializado.
Permiso de ejecucin denegado sobre el objeto "sp_tables", base de datos "maestra", propietario
"dbo'.
Esto indica que no tiene el permiso necesario para inicializar un almacn de contenido ni para crear
una tabla en la base de datos.
La solucin es asegurarse de que el usuario del almacn de contenido tiene permiso para utilizar el
procedimiento sp_tables almacenado en la base de datos maestra.

Se solicita a los usuarios credenciales de Active Directory


El mecanismo de inicio de sesin nico no funciona si IBM Cognos 8 est configurado como se
indica a continuacin:

Microsoft Internet Explorer se ejecuta en un equipo Windows NT.

El espacio de nombre de autenticacin est configurado con el proveedor de Active Directory.

Microsoft Internet Explorer en un servidor Windows 2000 o Windows 2003 est configurado
para la autenticacin integrada de Windows.

En consecuencia, se pide a los usuarios que proporcionen sus credenciales de Active Directory.
Este problema ocurre porque el proveedor de Active Directory de IBM Cognos 8 utiliza el protocolo
ADSI y la delegacin de Kerberos para la autenticacin en un entorno de inicio de sesin nico.
Cuando Microsoft Internet Explorer se ejecuta en Windows NT, no puede autenticarse en el servidor
IIS con la delegacin de Kerberos.
Si el sistema est configurado para la autenticacin integrada de Windows, deber hacer lo siguiente
para que el inicio de sesin nico funcione con IIS:

Gua de instalacin y configuracin 369

Apndice B: Solucin de problemas

Configure IBM Cognos 8 para que se comunique con el servidor Active Directory utilizando
el proveedor LDAP.

Configure la propiedad de asignacin de identidad externa para que lea la variable de entorno
REMOTE_USER.

Fuente no encontrada en UNIX al iniciar IBM Cognos Configuration


Al iniciar IBM Cognos Configuration, puede aparecer el siguiente mensaje de error:
No se encuentra la fuente especificada en font.properties...
Se trata de un problema conocido de UNIX. Significa que la mquina virtual Java (JVM) est
intentando utilizar una o ms fuentes que no estn instaladas en su equipo. No obstante, la JVM
debera utilizar el valor predeterminado del sistema e IBM Cognos Configuration debera iniciarse
y ejecutarse con normalidad.
Para evitar estos errores, aada las fuentes que faltan en el entorno en tiempo de ejecucin de Java,
para lo cual debe editar los archivos font.properties. Con Java SDK, se instalan varios archivos
font.properties que contienen informacin sobre el entorno de fuentes estndar. Estos archivos se
encuentran en el directorio ubicacin_JRE/lib.
Para obtener ms informacin, consulte la documentacin de Java.

No se puede cargar la biblioteca DB2 OLAP en Framework Manager


Ha instalado el cliente DB2 OLAP 8.1 y no puede cargar la biblioteca DB2 OLAP en Framework
Manager. Aparecer el siguiente mensaje:
DB2-ERR-0028 No se puede cargar la siguiente biblioteca DB2 OLAP: "C:\ibm\db2olap\bin\essapin.
dll"
IBM Cognos 8 est configurado para utilizar la biblioteca DB2 OLAP para la versin 8.2. Para
solucionar este problema, debe editar el archivo qfs_config.xml y cambiar el nombre de la biblioteca
para la versin 8.1.

Pasos
1. En el directorio ubicacin_c8\configuration, edite el archivo qfs_config.xml.
2. Busque el siguiente cdigo:
<provider name="DB2OlapODP" libraryName="doodp82" connectionCode="DO"/>

3. Cambie el nombre de la biblioteca de doodp82 a doodp81 y guarde los cambios.

Falta una pertenencia a grupo en el espacio de nombre de Active Directory


Si un espacio de nombre de Active Directory est configurado para el mismo bosque y un usuario
se autentica utilizando una credencial, faltar la pertenencia a grupo.
La identidad del proceso de IBM Cognos 8 deber tener uno de los siguientes privilegios al ejecutarse
como cuenta de sistema o usuario de dominio local:

370 PowerPlay

Representar a un cliente despus de la autenticacin

Apndice B: Solucin de problemas

Actuar como parte de un sistema operativo

Si falta el privilegio, el usuario autenticado no pertenecer al grupo.


Para resolver este problema siga estos pasos:

Pasos
1. Desde el men Inicio, haga clic en Configuracin, Panel de control.
2. Haga clic en Herramientas administrativas y, despus, doble clic en Directiva de seguridad
local.
3. En el rbol de la consola, haga clic en Configuracin de seguridad, Directivas locales.
4. Haga clic en Asignacin de derechos de usuario.
5. Aada la identidad del proceso de IBM Cognos 8 a una de las siguientes directivas:

Representar a un cliente despus de la autenticacin


El valor predeterminado es Administradores, Servicio.
Para obtener ms informacin, consulte http://technet2.microsoft.com/WindowsServer/en/
Library/fe1fb475-4bc8-484b-9828-a096262b54ca1033.mspx

Actuar como parte de un sistema operativo


El valor predeterminado es el sistema local.
Para obtener ms informacin, consulte http://technet2.microsoft.com/WindowsServer/en/
Library/ec4fd2bf-8f91-4122-8968-2213f96a95dc1033.mspx

Ambos privilegios pueden permitir a una cuenta actuar como otro usuario.
El privilegio de representar a otro cliente despus de la autenticacin es parecido al de actuar
como parte de un sistema operativo, excepto por que el primero solamente permitir a un
proceso representar a otro despus de la autenticacin, mientras que el segundo permite al
proceso representar a otro antes de la autenticacin.
Para obtener ms informacin, consulte http://www.microsoft.com/technet/prodtechnol/
windowsserver2003/technologies/security/tkerbdel.mspx

Implementacin de IBM Cognos 8 en un servidor de aplicaciones Oracle o IBM


WebSphere
Al implementar IBM Cognos 8 en un servidor de aplicaciones Oracle o IBM WebSphere aparecen
los siguientes errores:

Tiempo de espera del explorador excedido en la consola de administracin

Mensaje de error: Error interno HTTP 500

Mensaje de error: Error de implementacin: Excepcin de base: java.rmi.RemoteException


(Oracle)

Vuelva a la pgina de seleccin de archivos de la aplicacin (IBM WebSphere)

Gua de instalacin y configuracin 371

Apndice B: Solucin de problemas


Este error puede producirse porque el archivo de aplicacin que intenta implementar es demasiado
grande.
Para resolverlo, en un servidor de aplicaciones Oracle, puede implementar el archivo de aplicacin
manualmente mediante el siguiente comando:
dcmctl deployapplication -f <ruta y nombre de archivo ear> -a <nombre de la aplicacin> -co
<nombre de instancia OC4J>
Para servidores de aplicaciones IBM WebSphere u Oracle, desactive la opcin Incluir archivos
estticos de la carpeta Webcontent cuando use el Asistente de aplicacin de creacin. Si no incluye
el contenido esttico, reducir el tamao del archivo de aplicacin. Si se es necesario contenido
esttico, puede copiarlo manualmente en la ubicacin de la aplicacin implementada despus de
haber implementado correctamente IBM Cognos 8 en el servidor de aplicaciones. Para obtener ms
informacin sobre cmo implementar IBM Cognos 8 en un servidor de aplicaciones, consulte la
Gua de instalacin y configuracin.

Se muestran errores al realizar la implementacin en el servidor de aplicaciones


Oracle 10G
Al implementar IBM Cognos 8 en un servidor de aplicaciones Oracle 10G, aparecen los siguientes
mensajes de error:
CMM-APP-3254 Error al inicializar el almacn de indicadores. DIS-ERR-3115 Error de ejecucin
de tareas.
MDS-RUN-3213 No se puede encontrar la utilidad de carga de gran volumen de base de datos.
Instale la herramienta de base de datos necesaria para esta plataforma ('bcp' para SQL Server,
'sqlldr' para Oracle)
Esto ocurre porque las utilidades de carga de gran volumen (SQL Loader en Oracle) no estn
incluidas en el archivo de implementacin creado por IBM Cognos Configuration.
Para resolver el error, deber usar el software del cliente de Oracle en el equipo en que est instalado
el servidor de aplicaciones Oracle 10G para instalar los componentes ausentes. Asegrese de que
instala SQL Loader.

Error de tiempo de espera CGI excedido durante la conexin a los componentes


IBM Cognos 8 a travs de un explorador Web
Al realizar operaciones a travs del explorador Web aparece este mensaje de error:
Tiempo de espera CGI excedido, el proceso se eliminar del servidor.
El error surge cuando utiliza los servicios Windows Internet Information Services (IIS) como
explorador Web y la puerta de enlace est configurada para utilizar CGI. IIS tiene un tiempo de
espera predeterminado para las aplicaciones CGI.

372 PowerPlay

Apndice B: Solucin de problemas


Para resolver este problema, puede configurar la puerta de enlace de modo que emplee ISAPI. IIS
no tiene un tiempo de espera predeterminado para las aplicaciones ISAPI. Si desea seguir utilizando
la puerta de enlace CGI, puede aumentar el tiempo de espera de CGI en IIS.

Pasos para cambiar la puerta de enlace a ISAPI


1. En el equipo de la puerta de enlace, inicie IBM Cognos Configuration.
2. En Entorno, en la propiedad URI de puerta de enlace, cambie la parte cognos.cgi del URI a
cognosisapi.dll
3. En el explorador Web, especifique el URI de ISAPI:
http://nombre_equipo/cognos8/isapi

Pasos para aumentar el tiempo de espera de CGI


1. En las herramientas administrativas de Windows, abra Internet Information Services.
2. En el nodo local del equipo haga clic con el botn derecho en Sitios web y seleccione Propiedades.
3. En la pestaa de Directorio principal, haga clic en Configuracin.
4. En la pestaa de Opciones de proceso, aumente el tiempo de espera del script CGI.

Error al cargar la clase servlet en WebLogic


Puede tener problemas al configurar una instalacin de servidor distribuido y emplear WebLogic
como el servidor de aplicaciones con IBM Cognos 8.
Al implementar el p2pd.war en el equipo de componentes de nivel de aplicacin, puede recibir
excepciones de servlet y puede ocurrir que el distribuidor no se inicie. Tampoco se crea el cogserver.log.
El siguiente mensaje de error aparece en la consola del servidor de WebLogic:
<Jul 9, 2004 3:47:37 PM EDT> <Error> <HTTP><BEA-101249> <[ServletContext
(id=19023494,name=p2pd,context-path=/p2pd)]:Servlet class com.cognos.pogo.isolation.ServletWrapper for servletcfgss could not be loaded because the requested class was not found
in the classpath /host2/bea812/user_projects/domains/c8/applications/p2pd/WEB-INF/classes.
java.lang.ClassNotFoundException: com.cognos.pogo.isolation.ServletWrapper.>
<Jul 9, 2004 3:47:37 PM EDT> <Error> <HTTP> <BEA-101216> <Servlet: "cfgss" error al precargar durante el inicio en la aplicacin Web: "p2pd".
javax.servlet.ServletException: [HTTP:101249][ServletContext(id=19023494,name=p2pd,contextpath=/p2pd)]: Servlet class com.cognos.pogo.isolation.ServletWrapperfor servlet cfgss could not be
loaded because the requested class was not found in the classpath /host2/bea812/user_projects/
domains/c8/applications/p2pd/WEB-INF/classes.java.lang.ClassNotFoundException: com.cognos.pogo.isolation.ServletWrapper. at weblogic.servlet.internal.ServletStubImpl.prepareServlet
(ServletStubImpl.java:799)
en weblogic.servlet.internal.WebAppServletContext.preload Servlet(WebAppServletContext.java:3252)

Gua de instalacin y configuracin 373

Apndice B: Solucin de problemas


Para evitar este problema, no implemente la aplicacin p2pd desde el directorio de aplicaciones
WebLogic. Cree el directorio p2pd en otra ubicacin e implemente p2pd desde ah.

Pasos
1. Abra IBM Cognos Configuration y configure el equipo de componentes de nivel de aplicacin.
2. Reinicie el equipo de Content Manager.
3. Cree un directorio p2pd en una ubicacin accesible para el servidor WebLogic, pero que no
est en el directorio de aplicaciones de WebLogic.
Por ejemplo, cree un directorio llamado p2pd en la siguiente ubicacin:
ubicacin_WebLogic/user_projects/nombre_dominio
4. Cree el archivo p2pd.war.
5. En el directorio p2pd, extraiga el archivo p2pd.war a la instalacin WebLogic mediante el
siguiente comando:
%JAVA_HOME%/bin/jar xvfm "ubicacin_c8/p2pd.war" .
6. Inicie WebLogic.
7. En la consola del servidor WebLogic, implemente la aplicacin p2pd.

Los iconos del escritorio o la ventana de IBM Cognos Configuration parpadean


en Windows
Al ejecutar IBM Cognos Configuration en Windows, es posible que note que los iconos del escritorio
o la ventana de IBM Cognos Configuration parpadean.
Para resolver este problema, inicie IBM Cognos Configuration utilizando la opcin de lnea de
comando -noddraw.

374 PowerPlay

Glosario
acceso annimo
Tipo de acceso que permite a los usuarios y a los servidores acceder a un servidor sin autenticarse
antes.

alias
Nombre secundario de una tabla de base de datos. Los alias se utilizan para crear una referencia
distinta a la tabla del modelo, de tal forma que se puedan crear comparaciones de filas dentro de
la misma tabla y se puedan resolver las rutas de consulta ambiguas.
En la tecnologa de informacin de mapas, un nombre secundario de una funcin de un mapa. Los
alias se utilizan para crear una referencia entre nombres de caractersticas de mapas personalizados
y nombres de caractersticas en bases de datos.

almacn de contenido
Base de datos que contiene los datos necesarios para trabajar como, por ejemplo, especificaciones
de informe, modelos publicados y derechos de seguridad.

almacn de mtricas
Base de datos que incluye contenido para paquetes de mtricas. Un almacn de mtricas tambin
contiene la configuracin de Metric Studio, como por ejemplo las preferencias del usuario.

archivo de implementacin
Archivo utilizado para la implementacin. Este archivo contiene los datos del almacn de contenido
que se est moviendo.

archivo de respuesta
Archivo ASCII que se puede personalizar con los datos de configuracin que automatizan una instalacin. Durante una instalacin interactiva, sera necesario introducir los datos de configuracin.
Sin embargo, con un archivo de respuesta, la instalacin puede continuar sin ninguna intervencin.

autenticacin
Proceso de validacin de la identidad de un usuario o un servidor.

certificado
En seguridad informtica, documento digital que vincula una clave pblica a la identidad del propietario del certificado, lo que permite autenticar al propietario del certificado. Un certificado est
expedido por una entidad emisora de certificados y cuenta con la firma digital de dicha entidad.

componente de nivel de aplicacin


En la instalacin, el conjunto de procesadores que acceden a las bases de datos de consultas para
reunir informacin y luego presentar los resultados como informes e indicadores en PDF y HTML.
Licensed Materials Property of IBM
Copyright IBM Corp. 2005, 2009.

375

Glosario
Los componentes de nivel de aplicacin tambin pasan solicitudes a Content Manager y presentan
los resultados que Content Manager recupera del almacn de contenido.

conexin
Informacin con nombre que define el tipo del origen de datos, su ubicacin fsica y los requisitos
de inicio de sesin, si los hubiese. Un origen de datos puede tener ms de una conexin.

configuracin regional
Valor que identifica el idioma o la geografa, y determina las convenciones de formato, como
intercalacin, conversin de maysculas/minsculas, clasificacin de caracteres, idioma de los
mensajes, representacin de fecha y hora, y representacin numrica.

configuracin regional de contenido


Cdigo que se utiliza para establecer el idioma o el dialecto empleado para los exploradores, el
texto del informe y las preferencias regionales como, por ejemplo, formatos de hora, fecha, dinero,
expresiones de dinero y hora del da.

configuracin regional de productos


Cdigo o configuracin que especifica el idioma o la configuracin regional que debe utilizarse en
algunas partes de la interfaz del producto, como los comandos de men.

Content Manager
Servicio que recupera informacin del almacn de contenido y guarda informacin en ese almacn.

credenciales
Informacin almacenada sobre la identidad de un usuario de IBM Cognos, normalmente un nombre
de usuario y una contrasea. Puede asignar sus credenciales a ms personas, para que as stas
puedan utilizar los recursos que usted est autorizado a utilizar.
Las credenciales se crean para los componentes de IBM Cognos. Si un usuario planifica o programa
una accin, las credenciales debern almacenarse en el almacn de contenido.

espacio de nombre
En XML y XQuery, identificador universal de recursos (URI) que proporciona un nombre nico
al que asociar las definiciones de elemento, atributo y tipo en un esquema XML o los nombres de
elementos, atributos, tipos, funciones y errores en expresiones de XQuery.

glifo
Forma real (patrn de bits, contorno) de la imagen de un carcter. Por ejemplo, una A en cursiva
y una A latina son dos tipos distintos de glifos que representan el mismo carcter subyacente. En
sentido estricto, dos imgenes cualesquiera con formas diferentes constituyen dos glifos diferentes.
En este sentido, glifo es sinnimo de imagen de carcter o sencillamente de imagen (estndar Unicode,
versin 1.0).

grupo
Conjunto de usuarios que pueden compartir autorizaciones de acceso a recursos protegidos.
376 PowerPlay

Glosario

HTTPS
Versin segura del protocolo de transferencia de hipertexto HTTP que incorpora Secure Sockets
Layer (SSL).
Los productos de IBM Cognos utilizan HTTPS y SSL para codificar y transmitir contraseas de
manera segura por Internet.

interfaz de puerta de enlace comn


Estndar de Internet para definir secuencias de comandos que transmiten informacin desde un
servidor Web a un programa de aplicacin, a travs de una solicitud HTTP, y viceversa.

origen de datos
El propio origen de los datos, por ejemplo, una base de datos o un archivo XML, as como la
informacin de conexin necesaria para acceder a ellos.

paquete de cifrado
Combinacin de autenticacin, algoritmo de intercambio de claves y la especificacin de cifrado
de Secure Sockets Layer (SSL) que se utiliza para el intercambio seguro de datos.

pasaporte
Informacin basada en la sesin, almacenada y codificada en la memoria de Content Manager,
referente a usuarios autenticados. El pasaporte se crea la primera vez que un usuario accede a
Cognos 8 y se mantiene hasta que finaliza la sesin, cuando el usuario cierra la sesin o una vez
transcurrido un perodo de inactividad especificado.

paso de trabajo
Parte ms pequea de un trabajo que se puede ejecutar por separado. Un paso de trabajo puede ser
un informe u otro trabajo.

permisos de acceso
Reglas que definen los derechos de acceso a los recursos. Se pueden obtener permisos de acceso
para cualquier combinacin de espacios de nombres, grupos o usuarios. Ejemplos de recursos son
los informes y las carpetas.

portlet
Componente Web que proporciona servicios o informacin especficos a usuarios y que se ha diseado especficamente para agregarse a otros portlets en el contexto de una pgina o un portal
compuesto.

proveedor de autenticacin
Mecanismo de comunicacin con una fuente de autenticacin externa. A travs de los proveedores
de autenticacin, estn disponibles funcionalidades, como autenticacin de usuarios, pertenencia
a grupos y bsquedas en espacios de nombres.

Gua de instalacin y configuracin 377

Glosario

proveedor de seguridad
Consulte proveedor de autenticacin.

puerta de enlace
Extensin de un programa de servidor Web que transfiere informacin desde el servidor Web a
otro servidor. Las puertas de enlace suelen ser programas CGI, pero pueden seguir otros estndares,
como ISAPI y mdulos de Apache.

solicitud
Elemento de informe que pide valores de los parmetros antes de la ejecucin del informe.

trabajo
Grupo de objetos ejecutables, como informes, agentes y otros trabajos, que el usuario ejecuta y
planifica como un lote.

usuario
Persona, organizacin, proceso, dispositivo, programa, protocolo o sistema que utiliza los servicios
de un sistema informtico.

378 PowerPlay

ndice
A
abrir con Analysis Studio
descripcin de los componentes, 25
abrir con Report Studio
descripcin de los componentes, 25
acceptCount
aumentar para Apache Tomcat, 329
acceso
configurar el acceso seguro al portal, 93, 124
acceso a la red
compartir ubicaciones de datos, 235
acceso annimo
definicin, 375
deshabilitar, 93, 124, 275
activar secuencias de comandos
habilitar en exploradores Web, 51
actualizacin de prueba, 62
planificar el paso al entorno de produccin, 71
actualizar
crear entorno de prueba, 63
de otros productos de IBM Cognos a IBM Cognos
8, 32
desde Metrics Manager, 57
desde ReportNet, 57
desde Series 7, 57
entorno de Java, 85, 115, 131, 140, 292, 309
IBM Cognos 8, 73
planificar y pasar del entorno de prueba al de produccin, 71
preparacin, 58
problemas con claves criptogrficas, 366
proceso, 58
recursos, 60
ReportNet, 73
administracin
valores del tiempo de ejecucin, 80, 99, 109, 143
administracin del tiempo de ejecucin, 80, 99, 109,
143
administracin de PowerPlay, 358

Licensed Materials Property of IBM


Copyright IBM Corp. 2005, 2009.

AIX
error al conectar con la base de datos DB2, 355
variables de entorno para instalar IBM Cognos
8, 82, 111, 128, 134
ajustar
almacn de contenido DB2, 329
configuracin de Apache Tomcat, 329
algoritmo de confidencialidad, 222
alias
configurar en el servidor Web Apache, 265
configurar en servidores Web, 95, 137
definicin, 375
alias Web
IBM Cognos 8, 95, 137
almacn de contenido
compatibilidad para DB2 en z/OS para la versin
8.4, 18
configuracin no vlida, 349
controladores DB2 JDBC, 18, 86
crear, 43, 79, 236
crear en Oracle, 47
descripcin de los componentes, 26
eliminar tablas de la base de datos, 363
gestin de conexiones, 89, 118
implementar, 64
importar datos, 306, 310
novedad predeterminada en la versin 8.4, 19
realizar copia de seguridad, 289, 308
requisitos para cambiar el servidor de aplicaciones, 289
versiones compatibles de DB2 y Java, 349
y otras ubicaciones para almacenar la salida de
informe, 233
almacn de contenido DB2, 329
almacn de indicadores
error, 372
almacenes de contenido
definicin, 375
almacenes de mtricas
definicin, 375

379

ndice
Apache Tomcat
ajustar, 329
aparecen barras invertidas en lugar de la moneda, 168
archivar
salida de informe, 234
archivo cogstartup.lock, 344
archivo cogstartup.xml, 332, 337
archivo no vlido, 368
cambiar las propiedades manualmente, 334
archivo cogstartup.xml no vlido, 368
archivo de propiedades
para distribuidor, 297
archivo jar, 85, 115, 131, 140
error al iniciar la configuracin, 368
archivo p2pd.war de WebLogic, 362
archivo response.ats, 317
archivos
no encontrados, 356
archivos chase_referral, 177
archivos de configuracin
applications.xml para Portal Services, 273
coglocale.xml, 335
cogstartup.xml, 332
exportar, 320
archivos de implementacin
definicin, 375
mover, 68
archivos del proveedor de seguridad
copiar a la JVM del servidor de aplicaciones, 85,
115, 131, 140, 292, 309
archivos de registro, 343
configuracin de inicio, 344
configuracin regional, 344
desinstalacin, 345
modo silencioso, 345
para errores de puerta de enlace, 345
resumen de transferencias, 344
tiempo de ejecucin, 344
transferencia, 343
archivos de respuestas
definicin, 375
archivos EAR, 338
archivos Enterprise
implementar IBM Cognos 8, 338
archivos Java Archive, 85, 115, 131
archivos WAR, 338
380 PowerPlay

archivos Web
implementar IBM Cognos 8, 338
auditora
registros, 243
autenticacin
rboles de dominio para el servidor de Active
Directory, 177
complementos de inicio de sesin de confianza para
IBM Cognos Series 7, 182
configurar el espacio de nombre de IBM Cognos
Series 7, 180
definicin, 375
deshabilitar inicio de sesin annimo, 172
eliminar espacios de nombre, 211
eTrust Siteminder, 203, 204, 206
funcin SaferAPIGetTrustedSignon, 183
inicio de sesin nico mediante el espacio de nombre
de IBM Cognos Series 7, 182
inicio de sesin nico mediante el servidor de Active
Directory, 178
inicio de sesin nico mediante eTrust SiteMinder, 206
inicio de sesin nico mediante LDAP, 201
inicio de sesin nico mediante SAP, 211
inicio de sesin nico para el portal Plumtree
mediante la autenticacin bsica HTTP, 283
inicio de sesin nico para NTLM, 208
LDAP, 186, 187
LDAP mediante el servidor de Active Directory, 189
LDAP mediante IBM Directory Server, 192
LDAP mediante Novell Directory Server, 194
LDAP mediante Sun Java System Directory Server, 197
NTLM, 207
Portal Services, 274
probar espacios de nombre, 211
propiedades de usuario personalizadas para
LDAP, 199
propiedades personalizadas para el servidor de
Active Directory, 176
proveedores de autenticacin personalizados, 185
requisitos para el inicio de sesin nico con Microsoft Analysis Server o Microsoft SQL Server, 174
SAP, 208
servidor de Active Directory, 174
SSL mediante LDAP, 200

ndice
SSL para eTrust Siteminder, 206
utilizar espacios de nombre, 171
autenticacin bsica HTTP
para inicio de sesin nico con el portal Plumtree, 283
autenticacin integrada de Windows
problemas, 369
autenticacin integrada en Windows, 178
ayudante para la migracin
descripcin de los componentes, 25
no funciona, 358

B
base de datos de contenido de Cognos
cambiar usuarios y contraseas, 214
desinstalar, 104, 148
instalar en un servidor independiente, 114
mejorar el rendimiento, 330
base de datos de notificacin
compatibilidad para DB2 en z/OS para la versin
8.4, 18
base de datos de notificaciones, 121
configuracin para DB2 en z/OS, 217
configurar, 218
crear, 216
eliminar tablas, 363
espacios de tabla para DB2 en z/OS, 217
base de datos de registro
compatibilidad para DB2 en z/OS para la versin
8.4, 18
eliminar tablas, 363
bases de datos
almacn de contenido, 43, 236
eliminar tablas, 363
notificacin, 92, 121
registrar cliente de base de datos, 247
registro, 250
utilidad de carga de gran volumen ausente, 372
bases de datos de consultas, 26
bases de datos de registro
crear, 43
BEA WebLogic, 287
BMTScriptPlayer
disponibilidad en Linux, 40
buscar contenido de IBM Cognos 8 BI, 36

C
CA, 310
cadenas de conexin con la base de datos
Microsoft SQL Server, 89, 118
Oracle, 89, 118
Sybase, 89
cadenas de conexiones con la base de datos
IBM DB2, 89, 118
caducidad del contenido
directorio de imgenes, 95, 137
calidad de proteccin en conexiones SSL, 241
cambiar
codificacin del correo electrnico, 262
plantilla de configuracin, 227
puerta de enlace de IBM Cognos 8, 264
URI, 219
valores de configuracin predeterminados, 213
versiones de Java, 307
carcter de won, 168
fuentes necesarias, 167
carcter de yen, 168
fuentes necesarias, 167
caracteres
codificacin no admitida, 349
caracteres acentuados
no se muestran correctamente, 362
caracteres de doble byte
no se muestran correctamente, 362
caracteres especiales
en propiedades de espacio de nombre de LDAP, 186
caracteres no admitidos, 349
carpetas
implementar pblicas, 65
carpetas pblicas
implementar, 65
catlogos e informes Impromptu
migracin a IBM Cognos 8, 33
centro de recursos de IBM Cognos, 14
certificados
definicin, 375
Chino simplificado
requisitos en caso de usar Internet Explorer 6, 230
claves criptogrficas
generar para entidades emisoras de certificados de
terceros, 311
realizar copia de seguridad y eliminar, 289, 308
Gua de instalacin y configuracin 381

ndice
regenerar, 366
clave simtrica comn, 221
cliente de base de datos
configurar para una base de datos de registro, 247
codificacin
cambiar la configuracin en una configuracin sin
participacin del usuario, 334
errores de configuracin, 365
codificacin tailandesa de correo electrnico
requisitos JRE, 262
Cognos Viewer
descripcin de componentes, 24
compatibilidad de idiomas, 19
compilaciones
ejecutar en IBM Cognos Connection mediante el
Servicio de movimiento de datos, 35
componente de cliente, 26
componentes, 23
abrir con Analysis Studio, 25
abrir con Report Studio, 25
almacn de contenido, 26
ayudante para la migracin, 25
Cognos Viewer, 24
componentes de nivel de aplicacin, 29, 30
Content Manager, 24, 30, 81
de terceros, 23
ejemplos de IBM Cognos 8, 24
IBM Cognos Administration, 23
IBM Cognos Configuration, 24
IBM Cognos Connection, 23
instalar, 81
instalar en un equipo, 28
orgenes de datos, 26
PowerPlay Studio, 24
puertas de enlace, 24, 28, 81
servicio de migracin, 25
utilidad de conversin de marcadores, 25
componentes de migracin, 25
componentes de nivel de aplicacin
configurar, 127
definicin, 375
instalar en otro equipo, 29
requisitos de configuracin, 30
servidor de registro, 243
componentes de servidor, 23
componentes de terceros, 26
382 PowerPlay

comunicacin LDAP segura, 200


conectividad de la base de datos
almacn de contenido, 87
conexiones
definicin, 376
conexiones con orgenes de datos
configurar, 89, 118
conexiones de bases de datos, 89, 118
confianza compartida
configurar entre IBM Cognos 8 y otros servidores, 240
configuracin
aadir recursos, 332
archivo de bloqueo, 344
automatizar, 317
cambiar la plantilla, 227
cambiar valores predeterminados, 213
configuracin de Tomcat, 41
configuracin global, 255
Content Manager, 30
datos bloqueados, 367
ejecutar desde la lnea de comandos, 337
error al codificar la informacin, 365
la informacin criptogrfica no se puede codificar, 365
manual, 331
no se ha aplicado la configuracin, 368
no se puede abrir IBM Cognos Configuration, 344
no se puede guardar, 367
opciones avanzadas, 307
puntos que tener en cuenta al actualizar, 73
realizar copia de seguridad, 289, 308
requisitos para el inicio de sesin nico con Microsoft Analysis Server o Microsoft SQL Server, 174
sin participacin del usuario, 317, 320
valores de IBM Cognos 8, 41, 213
valores predeterminados, 213
configuracin del cubo, 80, 99, 109, 143
configuracin del informe, 80, 99, 109, 143
configuraciones regionales
definicin, 376
configuraciones regionales de contenido
asignar a configuracin regional de usuario, 258
personalizar, 257
configuraciones regionales de productos
asignar para interfaz de usuario, 260

ndice
configuraciones silenciosas, 317
configuraciones sin participacin del usuario
configurar, 317
configuracin no vlida
almacn de contenido, 349
IBM Cognos Configuration, 349
configuracin regional del contenido
definicin, 376
configuracin regional del producto
definicin, 376
configuracin regional de usuario
asignar a configuracin regional de contenido, 258
configuracin sin participacin del usuario
cambiar propiedades, 334
configurar
bases de datos de notificaciones, 218
componentes de nivel de aplicacin, 127
conexiones con orgenes de datos, 89
confianza compartida con otros servidores, 240
Content Manager en espera, 122
destino para mensajes de registro, 243
enrutadores, 264
equipos de Content Manager, 110
espacio de nombre de Active Directory, 174
espacio de nombre de eTrust SiteMinder, 204
espacio de nombre de LDAP, 187
espacio de nombre de LDAP para el servidor de
Active Directory, 189
espacio de nombre de LDAP para IBM Directory
Server, 192
espacio de nombre de NTLM, 207
espacio de nombre de SAP, 210
exploradores Web, 51
fuentes, 228
IBM Cognos 8, 54
IBM Cognos 8 para servidores de aplicaciones, 292
inicio de sesin para el servicio IBM Cognos 8 en
varios equipos PowerPlay, 236
instalaciones distribuidas, 107
Portal Services, 273
propiedades de entorno para los componentes de
nivel de aplicacin, 132
propiedades del servidor de aplicaciones, 297
propiedades en una configuracin sin participacin
del usuario, 334
protocolo SSL, 237

proveedores de autenticacin personalizados, 185


puertas de enlace, 140
servicio de entidad emisora de certificados, 310
servicio IBM Cognos 8, 227
servidor de correo, 92, 121
servidor Web, 95, 137
sin participacin del usuario, 320
tareas necesarias, 107
transferir archivos de especificacin (.ats), 317
ubicacin de archivos temporales, 225
zona horaria predeterminada, 261
Content Manager
activo como valor predeterminado, 110
cambiar zonas horarias, 261
componente, 30
configuracin, 30
configurar, 110
configurar en varios equipos, 122
configurar un almacn de contenido, 43, 236
definicin, 376
descripcin de componentes, 24
en espera, 30
instalar, 81
intento de registrar el distribuidor, 355
opciones de instalacin, 30
proteccin de migracin tras error, 30
requisitos para cambiar el servidor de aplicaciones, 289
requisitos si se utiliza IBM Cognos 8 Transformer
con el espacio de nombre de Series 7, 81, 180
servidor de registro, 243
Content Manager en espera, 30
configurar, 122
contraseas
cambiar en una configuracin sin participacin del
usuario, 334
cambiar para la base de datos de contenido de
Cognos, 214
controladores JDBC, 18, 86
configurar bases de datos Oracle, 248
db2java.zip obsoleto en la versin 8.4, 20
conversin
de informes ppr a informes ppx, 25
de marcadores de IBM Cognos Series 7 a IBM Cognos 8 PowerPlay, 25

Gua de instalacin y configuracin 383

ndice
conversin de informes
de formato ppr a ppx, 25
cookies
configuracin, 263
habilitar en exploradores Web, 51
personalizar, 263
cookies HTML, 263
crear
almacn de contenido, 79
credenciales
definicin, 376
credenciales de usuario
cambiar en una configuracin sin participacin del
usuario, 334
cubos, 159

D
Data Manager
utilizar en IBM Cognos 8 BI, 35
datos
bloqueados por IBM Cognos Configuration, 367
compartir ubicaciones de datos en una red, 235
importar, 69
DB2
controladores JDBC, 18, 86
versiones de Java admitidas, 349
DB2-ERR-0028, 370
db2java.zip
obsoleto en la versin 8.4, 20
DB2 OLAP
no se puede cargar la biblioteca, 370
Derby
tamao de la cach de pgina, 330
descripcin del producto, 13
deshabilitar
acceso annimo, 93, 124, 275
desinstalacin
sin participacin del usuario, 322
desinstalacin silenciosa, 322
desinstalar
base de datos de contenido de Cognos, 104, 148
Framework Manager, 104, 147
IBM Cognos 8, 102, 104, 146, 147, 154
Metric Designer, 104, 147
Transformer, 104, 147
destinatarios del documento, 13
384 PowerPlay

destinos de los registros


tipos de, 243
detener el servicio IBM Cognos 8
desde la lnea de comandos, 337
diagnsticos, 243
diferencias
entre IBM Cognos Series 7 PowerPlay e IBM Cognos
8 PowerPlay, 13
directorio de instalacin
requisitos, 107
directorio raz
para guardar la salida de informe fuera de IBM
Cognos 8, 233
directorios
implementar contenido, 65
directorios temporales
eliminar antes de reinstalar, 366
directorios virtuales
IBM Cognos 8, 95, 137
dispositivos mviles
utilizar para acceder a informes, 36
distribucin de informes
en una red, 330
distribuidor
cambiar archivo de propiedades, 297
no se inicia en el equipo de componentes de nivel de
aplicacin, 373
quitar el registro, 306
distribuidores
importar, 68
indicadores de sistema, 325
dividir revisiones en porciones
servidores de aplicaciones, 289
documentacin
archivos traducidos, 19
documento Lame
revisar antes de la instalacin, 39
dominios
rboles de dominio del servidor de Active Directory, 177
configurar para cookies, 263

E
ejemplos, 24
instalar, 158
Viaje de Aventuras, 157

ndice
ejemplos de IBM Cognos 8, 24
ejemplos de Viaje de Aventuras, 24, 157
instalar, 158
enlazar nombre distinguido y contrasea de usuario
caracteres especiales para el espacio de nombre de
LDAP, 186
enrutadores
configurar, 264
entidad emisora de certificados
configurar el servicio, 310
entidad emisora de certificados de terceros
configurar, 310
Entorno en tiempo de ejecucin de Java
IBM JRE sustituye al entorno en tiempo de ejecucin
de Sun Java, 20
entornos
compatibles, 40
entornos compatibles, 40
entrega
reducir el tiempo para abrir los informes, 330
Entrono en tiempo de ejecucin de Sun Java
sustituido por IBM JRE, 20
equilibrio de carga
configuracin, 29
configurar valores del servidor de correo, 92, 121
habilitar y deshabilitar servicios, 226
equilibro de carga, 54
error al descargar recursos, 355
error CAM-CRP-1157, 349
error criptogrfico, 368
archivo cogstartup.xml no vlido, 368
error JRE, 368
problemas despus de actualizar, 366
error de contexto, 362
error de directorio no encontrado, 356
error de dominio de confianza
al guardar la configuracin, 366
error de Java al iniciar la configuracin, 368
error de pgina no encontrada
iniciar IBM Cognos 8 en Windows 2003, 356
error de tiempo de espera CGI excedido, 372
error DPR-DPR-1035, 349
error EBA-090034
en WebLogic 8, 359
errores
DB2-ERR-0028, 370

error HTTP 404, 356


espacio de nombre
falta una pertenencia a grupo en el servidor Active
Directory, 370
no se puede iniciar la sesin, 354
espacios de nombre
autenticacin, 171
configurar proveedores de autenticacin personalizados, 185
eliminar, 211
IBM Cognos Series 7, 93
probar, 211
requisitos para Content Manager si se utiliza
Transformer con el espacio de nombre Series
7, 81, 180
espacios de nombre de IBM Cognos
volver a crear, 367
espacios de nombres
configurar para una puerta de enlace, 226
definicin, 376
ocultar durante el inicio de sesin, 186, 206
volver a crear, 367
espacios de tabla, 329
base de datos de notificaciones DB2 en z/OS, 217
eTrust SiteMinder
configurar espacios de nombre, 204
habilitar inicio de sesin nico, 206
proteger el alias de IBM Cognos 8 Web, 206
SSL, 206
usar para la autenticacin, 203
verificacin de scripts insertados en sitios Web en
IBM Cognos Application Firewall, 223
Excel
el tipo de informe de varias pginas no funciona, 361
exploradores Web
configuracin de seguridad, 40
configurar, 51
errores al iniciar al portal Web, 360
errores al iniciar el portal Web, 356
exportar
archivos de configuracin, 320
crear una especificacin, 65

F
Firefox
configuracin del explorador, 51
Gua de instalacin y configuracin 385

ndice
flujos de trabajo
ejecutar en IBM Cognos Connection mediante el
servicio de movimiento de datos, 35
Framework Manager
desinstalar, 104, 147
error criptogrfico, 347
no se puede cargar la biblioteca DB2 OLAP, 370
fuentes
cambiar las predeterminadas, 231
cambiar para informes PDF, 231
configurar, 228
lista de fuentes incrustadas para informes PDF, 232
no se encuentran al iniciar IBM Cognos Configuration en UNIX, 370
requisitos de compatibilidad, 230
fuentes adicionales
instalar, 167
fuentes incrustadas, 232
fuentes PDF
asignar a fuentes PDF incorporadas para una
impresin de informes ms rpida, 229
funcin SaferAPIGetTrustedSignon
usar para la autenticacin, 183

G
glifos
definicin, 376
grupos
definicin, 376
falta una pertenencia en el servidor Active Directory, 370
grupos de aplicaciones, 95, 137

H
habilitar
IBM Cognos Application Firewall, 223
servicios, 226
SSL para un servidor de aplicaciones, 305
historiales
implementacin, 70
HP-UX
variables de entorno para instalar IBM Cognos
8, 82, 111, 128, 134
HTTPS
definicin, 376

386 PowerPlay

I
IBM Cognos 8
cambiar servidores de aplicaciones, 287
compartir componentes en un mismo equipo, 31
componentes, 23
configuracin predeterminada, 79
configurar, 54
desinstalar, 102, 146, 154
distribuidores, 328
el servicio no se inicia, 349
implementar, 297
instalar la herramienta de migracin en Windows, 100, 144
opciones de instalacin, 27
requisitos del sistema, 40
servicios, 328
IBM Cognos 8 Go! Search
utilizar para buscar contenido de IBM Cognos 8
BI, 36
IBM Cognos 8 PowerPlay
instalaciones para solucionar problemas, 343
instalar, 81
IBM Cognos Administration
descripcin de los componentes, 23
IBM Cognos Application Firewall
configurar, 223
IBM Cognos Configuration
configuracin no vlida, 349
descripcin de los componentes, 24
error de fuente no encontrada en UNIX, 370
iniciar, 88, 117, 131, 140
modo sin participacin del usuario, 320
no se puede iniciar, 367
problema al generar claves criptogrficas despus
de la instalacin, 366
problemas al desplazarse con el teclado, 367
problemas al guardar una configuracin, 363
problemas de apertura, 344
IBM Cognos Connection
descripcin de los componentes, 23
no se puede abrir, 356
IBM Cognos Controller
acceso a datos en IBM Cognos 8, 34
IBM Cognos Finance
acceso a datos en IBM Cognos 8, 34

ndice
IBM Cognos Go! Mobile
informes mviles, 36
IBM Cognos Metrics Manager
actualizar a IBM Cognos 8, 73
IBM Cognos NoticeCast
duplicacin de funcionalidad en IBM Cognos 8, 36
IBM Cognos Planning - Analyst
acceso a datos en IBM Cognos 8, 34
IBM Cognos Planning - Contributor
acceso a datos en IBM Cognos 8, 34
IBM Cognos Portal Services
descripcin general de migracin, 37
IBM Cognos Query
duplicacin de funcionalidad en IBM Cognos 8, 36
IBM CognosScript
descripcin general de migracin, 37
IBM Cognos Series 7
complementos de inicio de sesin de confianza, 182
habilitar inicio de sesin nico, 182
habilitar SSL, 182
migracin a IBM Cognos 8, 32
usar para la autenticacin, 180
IBM Cognos Series 7 PowerCubes
requisitos para cambio correcto de idioma, 35
IBM Cognos Visualizer
duplicacin de funcionalidad en IBM Cognos 8, 36
IBM Cognos Web Services
descripcin general de migracin, 36
IBM DB2
crear cadenas de conexin, 89, 118
IBM Directory Server
con un espacio de nombre de LDAP, 192
IBM WebSphere, 287
idioma
personalizar compatibilidad de configuraciones
regionales de contenido, 257
personalizar para la interfaz de usuario, 255
idiomas
interfaz de usuario y archivos de mensajes, 20
nueva compatibilidad en la versin 8.4, 17
imgenes
caducidad del contenido, 95, 137
cargar en Report Studio, 95, 137
implementacin
permisos, 64
planificacin, 64

implementaciones
crear una especificacin de exportacin, 65
implementar
almacn de contenido, 64
carpetas pblicas, 65
contenido de directorio, 65
error en el servidor de aplicaciones Oracle o
WebSphere, 361
exportar, 65
IBM Cognos 8, 371
implementacin parcial, 65
importar, 69
mover archivos, 68
objetos de configuracin, 68
paquetes, 65
probar, 70
implementar IBM Cognos 8, 297
importar
configuraciones, 68
datos a un entorno de destino, 69
indicador de proteccin
configurar para cookies, 263
indicadores
para servidores, distribuidores y servicios, 325
informes
cambiar la fuente predeterminada, 231
personalizar la compatibilidad de idioma, 257
probar antes de una actualizacin, 62
reducir el plazo de entrega, 330
informes Web Impromptu
migracin a IBM Cognos 8, 33
iniciar
el servicio de IBM Cognos 8 desde IBM Cognos
Configuration, 97
IBM Cognos Configuration, 88, 117, 131, 140
iniciar el servicio IBM Cognos 8
desde la lnea de comandos, 337
iniciar sesin
ocultar espacios de nombre durante, 186, 206
inicio
archivo de bloqueo de configuracin, 344
DB2 devuelve el error SQL1224N al conectarse
desde AIX, 355
error al descargar recursos, 355
error de script, 361
fallo sin error, 349
Gua de instalacin y configuracin 387

ndice
no se encuentra la pgina, 356
no se puede abrir IBM Cognos Connection, 356
no se puede descargar cognos.xts, 360
no se puede iniciar el servicio, 348
problemas, 345
servicio IBM Cognos 8, 368
inicio de sesin annimo
deshabilitar, 172
deshabilitar para Portal Services, 275
inicio de sesin nico
directorio de usuario de eTrust SiteMinder, 206
espacio de nombre de Active Directory, 178
espacio de nombre de LDAP, 201
espacio de nombre de NTLM, 208
espacio de nombre de SAP, 211
para el portal Plumtree con SiteMinder, 284
para el portal Plumtree mediante la autenticacin
bsica HTTP, 283
para WebSphere Portal mediante el servidor de
aplicaciones, 283
problemas con la autenticacin integrada de Windows, 369
usar el espacio de nombre de IBM Cognos Series
7, 182
utilizar secreto compartido para Portal Services, 275
inicios de sesin de usuario
configurar el acceso seguro al portal, 93, 124
instalacin
lista de comprobacin, 79
modos, 81, 109
opciones para Content Manager, 30
sin participacin del usuario, 317
instalacin distribuida
configurar inicio de sesin de usuario para el servicio
IBM Cognos 8 en varios equipos, 236
instalaciones distribuidas
configurar, 107
escenarios, 27
instalaciones silenciosas, 317
instalaciones sin participacin del usuario
configurar, 317
instalacin sin participacin del usuario, 322
instalar
base de datos de contenido de Cognos por separado, 114
ejemplos de Viaje de Aventuras, 158
388 PowerPlay

fuentes adicionales, 167


IBM Cognos 8, 79, 317
IBM Cognos 8 en Linux, 362
IBM Cognos 8 PowerPlay, 81
instalacin sin participacin del usuario, 317, 318
Supplementary Languages Documentation, 166
utilizar archivo de especificacin de transferencia
(.ats), 317
utilizar archivos de especificacin de transferencia
(.ats), 318
interfaz
personalizar la compatibilidad de idioma, 255
interfaz de puerta de enlace comn
sustituir, 264
interfaz de puerta de enlace comn (CGI)
definicin, 377
interfaz de usuario
asignar para configuracin regional de producto, 260
personalizar la compatibilidad de idioma, 255
Internet Explorer
configuracin del explorador, 51
requisitos de compatibilidad con chino simplificado, 230
interrupcin de la red
fallo al iniciar los servicios, 355
IPv4, 269
IPv6, 269
ISAPI
acceder a IBM Cognos 8, 264
cundo utilizar una puerta de enlace, 372

J
Java
actualizar entornos en tiempo de ejecucin, 85, 115,
131, 140, 292, 309
cambiar versiones, 307
configurar puerta de enlace del servlet para servidores Web compatibles con Java, 268
utiliza toda la CPU, 349
versiones admitidas para el almacn de contenido
DB2, 349
JAVA_HOME
configuracin, 368
java.lang.NoClassDefFoundError, 347

ndice
Java scripts
habilitar en exploradores Web, 51
JDBC
conectividad de la base de datos para el almacn de
contenido, 87
JRE
actualizar, 85, 115, 131, 140, 292, 309
JVM
cambiar, 289, 307, 308
configuracin de la memoria para la base de datos
de contenido de Cognos, 330
copiar archivos del proveedor de seguridad, 85, 115,
131, 140, 292, 309

L
la informacin criptogrfica no se puede codificar, 365
latencia
mejorar, 330
LDAP
configurar un espacio de nombre, 187
editar la propiedad Asignacin de identidad
externa, 202
habilitar inicio de sesin nico, 201
habilitar SSL, 200
IBM Directory Server, 192
Novell Directory Server, 194
propiedades personalizadas, 199
servidor de Active Directory, 189
Sun Java System Directory Server, 197
usar para la autenticacin, 186
Linux
funciones y componentes no compatibles, 40
iniciar y detener el servicio IBM Cognos 8, 337
instalacin de modo consola obsoleta, 20
los caracteres no se muestran correctamente, 362
mensajes de registro, 250
requisitos del sistema, 79
variables de entorno para IBM Cognos 8, 82, 111,
128, 134
listas de incrustacin de fuentes, 232
los caracteres no se muestran correctamente, 362

M
macro
convertir informes ppr a informes ppx, 25

mantenimiento
mejorar el rendimiento del sistema, 325
maxProcessor
aumentar para Apache Tomcat, 329
mensajes de correo electrnico
cambiar la codificacin, 262
mensajes de error
CAM-CRP-1064, 354
CAM-CRP-1315 La configuracin actual apunta a
un dominio de confianza distinto, 366
CFG-ERR-0106 IBM Cognos Configuration no ha
recibido ninguna respuesta, 346
CM-CFG-029 Content Manager no puede determinar, 369
CMM-APP-3254 Error al inicializar el almacn de
indicadores, 372
DIS-ERR-3115 Error de ejecucin de tarea, 372
DPR-ERR-2022 No se ha generado ninguna respuesta, 360
DPR-ERR-2058, 355, 356
entorno en tiempo de ejecucin de Java, 368
error al cargar clase de servlet en WebLogic, 373
error al descargar recurso especificado, 355
error HTTP 404, 356
ha elegido descargar un archivo, 360
informacin criptogrfica daada, 368
la informacin criptogrfica no se puede codificar, 365
MDS-RUN-3213 No se puede encontrar la utilidad
de carga de gran volumen de base de datos, 372
no se encuentra la pgina, 356
no se ha podido anular la serializacin del atributo
de contexto, 362
PRS-CSE-1255, 354
SoapSocketException, 355
SQL1224N, 355
tiempo de espera CGI excedido, 372
mensajes de registro, 243
destinos de los registros, 243
habilitar para IBM Cognos Application Firewall, 223
servidor de registro remoto, 243
Metric Designer
desinstalar, 104, 147
Microsoft
la actualizacin de seguridad afecta a la memoria, 349
Gua de instalacin y configuracin 389

ndice
Microsoft Analysis Server
requisito del espacio de nombre, 174
Microsoft Analysis Services
inicio de sesin nico en orgenes de datos
MSAS, 178
Microsoft Office
servicio de datos de informes, 328
Microsoft Office Excel
el tipo de informe pgina mltiple no funciona, 361
Microsoft SQL Server
crear cadenas de conexin, 89, 118
requisito del espacio de nombre, 174
migracin
de otros productos de IBM Cognos a IBM Cognos
8, 32
no se ejecuta, 358
requisitos de autenticacin, 93
modelos Architect
migracin a IBM Cognos 8, 33
modo de consola
para instalar en UNIX y Linux, 20
modo silencioso, 317
modo sin participacin del usuario, 317
moneda
fuentes necesarias para el carcter del yen o
won, 167
personalizar compatibilidad, 256
won, 168
yen, 168
moneda coreana, 168
moneda japonesa, 168
mover
archivos de implementacin, 68
multi_domain_tree, 177

N
Netegrity SiteMinder, 203
Netscape
configuracin del explorador, 51
no se ha generado ninguna respuesta, 360
no se puede abrir IBM Cognos Configuration, 344
no se puede anular la serializacin del atributo de contexto, 362
Novell Directory Server
con un espacio de nombre de LDAP, 194

390 PowerPlay

NTLM, 207
configurar, 207
habilitar inicio de sesin nico, 208
NTLM, 207

O
Oracle
controladores JDBC de base de datos, 248
crear cadenas de conexin, 89, 118
errores de implementacin, 372
servidor de aplicaciones, 302
orgenes de datos
definicin, 377
descripcin de los componentes, 26
orgenes de datos OLAP
miembros ausentes o inaccesibles, 370
orgenes de datos relacionales
miembros ausentes o inaccesibles, 370

P
paquetes
implementar, 65
paquetes de cifrado
configurar una prioridad para conexiones SSL, 241
definicin, 377
parpadeo, 374
parpadeo de pantalla, 374
pasaportes
definicin, 377
pasar de la actualizacin de prueba al entorno de produccin, 71
pasos de trabajo
definicin, 377
permisos
implementacin, 64
para usuarios, grupos y roles, 80, 99, 109, 143
permisos de acceso
definicin, 377
planificar una actualizacin, 58
plantilla
cambiar el tamao de la plantilla, 227
portal
configurar el acceso seguro para los usuarios, 93,
124
errores al iniciar, 356, 360

ndice
portal Plumtree
inicio de sesin nico con SiteMinder, 284
inicio de sesin nico mediante la autenticacin
bsica HTTP, 283
Portal Services, 273
deshabilitar el inicio de sesin annimo en IBM
Cognos 8, 275
disponibilidad en Linux, 40
especificar el archivo applications.xml, 273
portlets
definicin, 377
PowerCube de ejemplo
configurar, 159
PowerCubes
acceso en IBM Cognos 8, 35
configuracin, 80, 99, 109, 143
configurar el ejemplo para IBM Cognos 8 PowerPlay, 159
requisitos para cambio correcto de idioma, 35
PowerPlay para componente de Windows, 26
PowerPlay Studio
descripcin de los componentes, 24
probar
implementacin, 70
problemas con el portal
no se puede abrir, 356
problemas de apertura de IBM Cognos Configuration, 344
problemas de configuracin, 363
problemas de instalacin y configuracin
no se puede cargar la biblioteca DB2 OLAP, 370
procesar mensajes de registro, 243
producto
cambios de nombre, 19
propiedad de asignacin de identidad externa
caracteres especiales para el espacio de nombre de
LDAP, 186
editar un espacio de nombre de LDAP, 202
propiedad de bsqueda de usuarios
caracteres especiales para el espacio de nombre de
LDAP, 186
propiedades
cambiar en una configuracin sin participacin del
usuario, 334
configurar para el servidor de aplicaciones, 297
ubicacin de archivos temporales, 225

propiedades de usuario personalizadas


LDAP, 199
servidor de Active Directory, 176
propsito del documento, 13
proteccin de migracin tras error, 30
proteccin en caso de migracin tras error
puerta de enlace ISAPI necesaria para la instalacin
de varios Content Manager, 110
protocolo
direccin IP, 269
protocolo SSL
configurar, 237
proveedores de autenticacin
definicin, 377
proveedores de autenticacin personalizados, 185
proveedores de seguridad
definicin, 377
puerta de enlace
archivo de registro, 345
configuracin recomendada para Microsoft IIS, 372
cundo utilizar ISAPI, 372
puerta de enlace CGI
limitaciones con varios equipos de Content Manager, 110
puerta de enlace del servlet
configurar, 268
puerta de enlace ISAPI
necesaria con varios equipos de Content Manager, 110
puertas de enlace
aadir en una red para reducir los plazos de
entrega, 330
configurar, 140
configurar para IBM Cognos 8, 264
configurar para utilizar un espacio de nombre, 226
definicin, 378
descripcin de componentes, 24
instalar, 81
instalar en otro equipo, 28
requisitos de configuracin, 29
puertas de enlace Apache
configurar, 265
puertos
cambiar, 219
valores de configuracin predeterminados, 41
puertos ya utilizados, 348
Gua de instalacin y configuracin 391

ndice

Q
quick tours
utilizar, 14
quitar el registro de distribuidores, 306

R
realizar copia de seguridad
informacin de IBM Cognos 8, 289, 308
recursos
aadir, 332
registro
base de datos, 250
cliente de base de datos, 247
configurar, 251
servidores de registro remotos, 250
utilizar archivos, 250
registro de eventos de Windows
destino para mensajes de registro, 250
registros
procesamiento de mensajes, 243
servicio, 327
registros de auditora, 243
destinos de los registros, 243
registros de eventos, 250
rendimiento
mejorar para Apache Tomcat, 329
ReportNet
actualizar, 73
actualizar a IBM Cognos 8, 73
archivo de actualizacin a IBM Cognos 8, 345
Report Studio
cargar imgenes, 95, 137
requisitos del sistema, 40
revisar el documento Lame antes de la instalacin, 39
rutas de acceso
configurar para cookies, 263

S
salida de informe
compartir con usuarios fuera de Cognos 8, 233
guardar en un sistema de archivos, 233
volver a utilizar, 234
SAP
habilitar inicio de sesin nico, 211
servidor de aplicaciones, 287
usar para la autenticacin, 208
392 PowerPlay

SAP BW
conectividad, 210
configuracin de autorizacin para los administradores de IBM Cognos 8, 210
configuracin de autorizacin para los usuarios de
IBM Cognos 8, 208
scripts
para eliminar tablas de bases de datos, 363
scripts de inicio, 295
secreto compartido
inicio de sesin nico para Portal Services, 275
secuencia de intercalacin, 43
secuencias de intercalacin
distincin entre maysculas y minsculas, 349
Secure Sockets Layer, 237
seguridad
configuracin para los exploradores Web, 40
configurar el acceso seguro al portal, 93, 124
Portal Services, 274
problemas con la autenticacin integrada de Windows, 369
Seguridad nativa de Windows (NTLM)
habilitar inicio de sesin nico, 208
utilizar para la autenticacin, 207
Series 7 PowerCubes
requisitos para cambio correcto de idioma, 35
servicio de administracin de eventos, 326
servicio de Content Manager, 326
servicio de control, 328
servicio de datos de informes, 328
servicio de entrega, 326
servicio de IBM Cognos 8
iniciar desde IBM Cognos Configuration, 97
servicio de informe por lotes, 326
servicio de informes
lista de fuentes incrustadas para informes PDF, 232
requisitos, 325
servicio de informes por lotes
lista de fuentes incrustadas para informes PDF, 232
servicio de integracin de datos, 326
servicio del agente, 326
servicio del sistema, 328
servicio de migracin, 327
descripcin de los componentes, 25
Servicio de movimiento de datos
utilizar en IBM Cognos Connection, 35

ndice
servicio de presentacin, 328
requisitos, 325
servicio de trabajos, 327
servicio IBM Cognos 8
configurar, 227
detener desde la lnea de comandos, 337
el servidor no est disponible, 349
iniciar, 88, 117, 131, 140, 368
iniciar desde la lnea de comandos, 337
servicio Metrics Manager, 327
servicios
administracin de eventos, 326
agente, 326
ajustar para mejorar el rendimiento, 325
configurar la cuenta de usuario para el acceso compartido a la red, 235
Content Manager, 326
control, 328
datos de informes, 328
desinstalar, 102, 146, 154
detener desde la lnea de comandos, 337
el servicio de migracin no funciona, 358
entrega, 326
fallo al iniciar despus de una interrupcin de la
red, 355
habilitar y deshabilitar, 226
IBM Cognos 8, 328
indicadores de sistema, 325
informe, 325, 328
informe por lotes, 326
iniciar, 88, 117, 131, 140
iniciar desde la lnea de comandos, 337
integracin de datos, 326
Metrics Manager, 327
migracin, 327
no se pueden iniciar, 348
presentacin, 325, 328
registro, 327
sistema, 328
trabajos, 327
servicios de informe, 328
servidor Active Directory
falta una pertenencia a grupo, 370
servidor de Active Directory
autenticar en varios dominios, 177
habilitar inicio de sesin nico, 178

habilitar SSL, 177


propiedades avanzadas, 177
Servidor de Active Directory
con un espacio de nombre de LDAP, 189
utilizar para la autenticacin, 174
servidor de aplicaciones Oracle, 287
error de implementacin de IBM Cognos 8, 361
implementar IBM Cognos 8, 371
servidor de aplicaciones WebSphere
error de implementacin de IBM Cognos 8, 361
implementar IBM Cognos 8, 371
servidor de correo
configurar, 92, 121
servidores
indicadores de sistema, 325
servidores de aplicaciones
cambiar la configuracin predeterminada, 287
configurar, 297
error al cargar clase de servlet en WebLogic, 373
error de script de inicio, 361
inicio de sesin nico para WebSphere Portal, 283
puertas de enlace del servlet, 268
scripts de inicio, 295
scripts de inicio para el servidor de aplicaciones
Oracle, 302
scripts de inicio para el servidor de aplicaciones Sun
Java System, 304
servidores de aplicaciones WebSphere
error de script de inicio, 361
servidores de registro remotos, 250
configurar, 251
servidores IIS Web
inicio de sesin nico mediante Active Directory, 178
servidores virtuales
configurar para IBM Cognos 8, 95, 137
servidores Web
configurar, 95, 137
configurar el tiempo de carga de Report Studio, 95,
137
habilitar SSL, 242
inicio de sesin nico mediante Active Directory y
servidor IIS Web, 178
puertas de enlace del servlet, 268
servidores Web Apache
configurar alias, 95, 137
Gua de instalacin y configuracin 393

ndice
configurar como puertas de enlace, 265
servidores Web Microsoft IIS
configuracin recomendada para puerta de
enlace, 372
servidor IBM Cognos 8
no se inicia, 349
servidor PowerPlay BI, 358
servidor Web de Java System
configurar alias, 95, 137
sistema de archivos
para guardar copias de salidas de informe, 233
SiteMinder
inicio de sesin nico para el portal Plumtree, 284
Solaris
variables de entorno para instalar IBM Cognos
8, 82, 111, 128, 134
solicitudes
definicin, 378
solicitudes de firma de certificados
generar, 311
solucionar problemas, 343
registro, 243
SSL
calidad de proteccin, 241
configurar la confianza compartida con otros servidores, 240
directorio de usuario de eTrust SiteMinder, 206
espacio de nombre de LDAP, 200
habilitar en servidores Web, 242
habilitar para un servidor de aplicaciones, 305
pasos adicionales para configurar WebLogic 8, 359
servidor de Active Directory, 177
usar el espacio de nombre de IBM Cognos Series
7, 182
Sun Java System
servidor de aplicaciones, 304
Sun Java System Directory Server
con un espacio de nombre de LDAP, 197
Supplementary Languages Documentation
instalar, 166
nuevo en la versin 8.4, 19
Sybase
controladores de la base de datos, 88, 117
crear cadenas de conexin, 89
syslog
destino para mensajes de registro, 250
394 PowerPlay

T
tablas
eliminar de base de datos, 363
tamao de la cach de pgina
Derby, 330
tareas necesarias
configurar, 107
tecla de tabulacin
problemas con IBM Cognos Configuration, 367
teclado
problemas de desplazamiento, 367
Tomcat
ajustar, 329
valores de configuracin predeterminados, 41
trabajos
definicin, 378
transferir archivos de especificacin (.ats)
configuracin, 317
Transformer
acceso a datos en IBM Cognos 8, 35
desinstalar, 104, 147
requisitos para Content Manager si se utiliza el
espacio de nombre de Series 7, 81, 180

U
ubicacin de archivos de datos
configurar para Windows Vista, 271
ubicacin de archivos de implementacin
configurar para Windows Vista, 271
ubicacin de archivos de mapa
configurar para Windows Vista, 271
ubicacin de archivos temporales
configurar, 225
configurar para Windows Vista, 271
propiedades, 225
ubicaciones de archivo
requisitos en Windows Vista, 271
UNIX
error de fuente no encontrada, 370
iniciar y detener el servicio IBM Cognos 8, 337
instalacin de modo consola obsoleta, 20
mensajes de registro, 250
requisitos del sistema, 79
variables de entorno para IBM Cognos 8, 82, 111,
128, 134

ndice
URI
cambiar, 219
valores de configuracin predeterminados, 41
URI de Content Manager, 122, 132
usuarios
cambiar para la base de datos de contenido de
Cognos, 214
definicin, 378
UTF-8
codificar para mensajes de correo electrnico, 262
utilidad de conversin de marcadores, 25

Windows IIS
configuracin recomendada para puerta de
enlace, 372
Windows Vista
requisitos para ubicaciones de archivo, 271
won coreano
fuentes necesarias, 167

Y
yen japons
fuentes necesarias, 167

variables de entorno
almacn de contenido, 43
configurar para los componentes de nivel de aplicacin, 132
configurar servidores de aplicaciones, 291
para instalar IBM Cognos 8 en UNIX o Linux, 82,
111, 128, 134
requisitos en Windows Vista, 271
verificacin de scripts insertados en sitios web
configurar en IBM Cognos Application Firewall, 223
versin de direccin IP, 269
versiones
actualizaciones de ReportNet admitidas, 73
volver a crear espacio de nombre de IBM Cognos, 367

zonas horarias
cambiar, 261
zonas horarias del servidor
cambiar, 261

W
WebLogic
error al cargar clase de servlet, 373
error de script de inicio, 361
no se ha podido anular la serializacin del atributo
de contexto, 362
script de inicio, 295
servidor de aplicaciones, 299, 304
WebLogic 8
problema al configurar SSL, 359
WebSphere
inicio de sesin nico mediante el servidor de aplicaciones, 283
servidor de aplicaciones, 297
Windows
instalar la herramienta de migracin de IBM Cognos
8, 100, 144
requisitos del sistema, 79
Gua de instalacin y configuracin 395

S-ar putea să vă placă și